Compare commits

...
Author SHA1 Message Date
valentinsilyutin f97680e7db @advdominion/tooltip@7.2.0 2026-10-27 13:05:22 +04:00
valentinsilyutin d262e1c818 AGENTS.md 2026-10-10 23:08:42 +04:00
valentinsilyutin ad060cb53b Lint scroll-to with oxlint 2026-10-10 22:57:51 +04:00
valentinsilyutin 784dcb70b8 Замена inline-правил eslint-* на oxlint-* 2026-10-10 22:55:27 +04:00
valentinsilyutin 9ee2067f55 Fix README.md 2026-10-10 22:52:13 +04:00
valentinsilyutin 7dc956cdab @advdominion/lightbox-gallery@5.1.0 2026-10-10 22:46:05 +04:00
valentinsilyutin 00c2d2bbbb Удалена Lerna 2026-09-24 21:54:19 +04:00
valentinsilyutin dcc176f61a Publish
- @advdominion/tooltip@7.1.1
2026-09-24 21:45:58 +04:00
valentinsilyutin ff07b85241 Новая версия tooltip 2026-09-24 21:45:32 +04:00
valentinsilyutin 15298ef68f Fix CHANGELOG.md 2026-09-24 21:20:46 +04:00
valentinsilyutin 68a0bd8025 Publish
- @advdominion/tooltip@7.1.0
2026-09-24 16:51:07 +04:00
valentinsilyutin f76c615286 Новая версия tooltip 2026-09-24 16:50:42 +04:00
valentinsilyutin c5a92339ec Обновлены зависимости 2026-09-24 16:03:28 +04:00
valentinsilyutin 7a39d520dd Publish
- @advdominion/browserslist-to-targets@1.0.1
 - @advdominion/sass-importer@1.0.1
 - @advdominion/stylelint-config@2.1.0
2026-09-08 23:28:13 +04:00
valentinsilyutin e4d9075ebe Enable length-zero-no-unit rule 2026-09-08 23:27:07 +04:00
valentinsilyutin b8286098ff Fix README 2026-09-08 23:23:19 +04:00
valentinsilyutin 27a16018f3 Fix README 2026-09-08 23:23:10 +04:00
valentinsilyutin 5c773895cb Удалены babel-plugin-nunjucks и lightningcss-loader 2026-09-08 13:24:44 +04:00
valentinsilyutin 12c14e8eb5 Добавлен sass-importer 2026-09-08 13:20:52 +04:00
valentinsilyutin 8c7e9aa5e0 Добавлен browserslist-to-targets 2026-09-06 23:49:15 +04:00
valentinsilyutin cdb33bd6f5 Publish
- @advdominion/stylelint-config@2.0.1
2026-09-02 23:15:17 +04:00
valentinsilyutin 708eb1fd3c Fix 2026-09-02 23:14:59 +04:00
valentinsilyutin 23bc0a440e Publish
- @advdominion/stylelint-config@2.0.0
2026-09-02 23:07:07 +04:00
valentinsilyutin b816710989 Update README.md 2026-09-02 23:05:48 +04:00
valentinsilyutin 2fc1a44b6c Используем stylelint-config-recommended-scss вместо stylelint-config-standard-scss + настройка severity 2026-09-02 23:03:33 +04:00
valentinsilyutin 3f2566b9d1 Update Oxlint config 2026-08-14 10:08:45 +04:00
valentinsilyutin c8bf000479 Publish
- @advdominion/tooltip@7.0.2
2026-08-14 09:44:46 +04:00
valentinsilyutin decf05dcad tooltip: Fix README.md 2026-08-14 09:44:21 +04:00
valentinsilyutin b019ae2344 Перенесён tooltip 2026-08-14 09:43:45 +04:00
valentinsilyutin d277820f92 Publish
- @advdominion/lightbox-gallery@5.0.1
2026-08-14 09:38:12 +04:00
valentinsilyutin 65c54e010d lightbox-gallery: Fix package.json 2026-08-14 09:37:56 +04:00
valentinsilyutin 36f0b0753e Publish
- @advdominion/lightbox-gallery@5.0.0
2026-08-14 09:36:47 +04:00
valentinsilyutin 3ff0b19a49 lightbox-gallery: Обновление Swiper 2026-08-14 09:36:24 +04:00
valentinsilyutin bc22ebdc22 Перенесён lightbox-gallery 2026-08-14 09:35:00 +04:00
35 changed files with 2511 additions and 4712 deletions

No files matched your search

+1 -1
View File
@@ -4,5 +4,5 @@
"quoteProps": "consistent",
"sortImports": true,
"sortPackageJson": false,
"ignorePatterns": [".docker", ".yarn", "html"]
"ignorePatterns": [".vscode", ".yarn"]
}
+4 -27
View File
@@ -26,6 +26,7 @@
"eslint/no-inline-comments": "off",
"eslint/no-irregular-whitespace": ["error", { "skipTemplates": true }],
"eslint/no-magic-numbers": "off",
"eslint/no-nested-ternary": "off",
"eslint/no-new": "off",
"eslint/no-shadow": "off",
"eslint/no-ternary": "off",
@@ -33,6 +34,7 @@
"eslint/no-undefined": "off",
"eslint/no-underscore-dangle": "off",
"eslint/no-unexpected-multiline": "off",
"eslint/one-var": "off",
"eslint/prefer-destructuring": [
"warn",
{
@@ -55,41 +57,16 @@
"oxc/no-map-spread": "off",
"oxc/no-optional-chaining": "off",
"oxc/no-rest-spread-properties": "off",
"unicorn/explicit-timer-delay": "off",
"unicorn/filename-case": ["warn", { "cases": { "kebabCase": true, "pascalCase": true } }],
"unicorn/no-empty-file": "warn",
"unicorn/no-nested-ternary": "off",
"unicorn/prefer-ternary": "off",
"unicorn/no-useless-switch-case": "off",
"unicorn/prefer-global-this": "off",
"vue/define-props-destructuring": "off",
"vue/max-props": "off"
},
"overrides": [
{
"files": ["build-scripts/*.js"],
"rules": {
"eslint/no-console": "off"
}
},
{
"files": ["src/scripts/mocks/**/*.js"],
"rules": {
"eslint/no-console": "off",
"unicorn/prefer-ternary": "off"
}
},
{
"files": ["src/scripts/blocks/**/*.js"],
"rules": {
"unicorn/prefer-top-level-await": "off"
}
},
{
"files": ["src/scripts/composables/*.js"],
"rules": {
"unicorn/filename-case": ["warn", { "cases": { "camelCase": true } }]
}
}
],
"ignorePatterns": [".yarn"],
"options": {
"maxWarnings": 10
+6
View File
@@ -0,0 +1,6 @@
{
"recommendations": [
"arcanis.vscode-zipfs",
"oxc.oxc-vscode"
]
}
+10
View File
@@ -0,0 +1,10 @@
{
"editor.defaultFormatter": "oxc.oxc-vscode",
"editor.formatOnSave": true,
"search.exclude": {
"**/.yarn": true,
"**/.pnp.*": true
},
"oxc.path.oxfmt": ".yarn/sdks/oxfmt/bin/oxfmt",
"oxc.path.oxlint": ".yarn/sdks/oxlint/bin/oxlint"
}
+2
View File
@@ -1,3 +1,5 @@
# This file is automatically generated by @yarnpkg/sdks.
# Manual changes might be lost!
integrations:
- vscode
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "oxfmt",
"version": "0.55.0-sdk",
"version": "0.70.0-sdk",
"main": "dist/index.js",
"type": "commonjs",
"bin": {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "oxlint",
"version": "1.70.0-sdk",
"version": "1.85.0-sdk",
"main": "dist/index.js",
"type": "commonjs",
"bin": {
-3
View File
@@ -4,8 +4,5 @@ packageExtensions:
'@advdominion/stylelint-config@*':
dependencies:
stylelint: '*'
lerna@*:
dependencies:
ci-info: '*'
yarnPath: .yarn/releases/yarn-4.18.0.cjs
+94
View File
@@ -0,0 +1,94 @@
# Правила разработки для AI-агентов
Стек проекта: Yarn 4 (Berry, PnP) / ESM / JavaScript. Это монорепозиторий с публикуемыми npm-пакетами `@advdominion/*`. Каждый пакет — самостоятельный модуль без шага сборки. Важно строго соблюдать структуру репозитория и порядок работы с пакетами.
## 1. Языковой регламент (АБСОЛЮТНЫЙ ПРИОРИТЕТ)
- **Язык общения:** Все ответы, пояснения, вопросы и любое общение с пользователем ведутся **строго и исключительно на русском языке** (независимо от языка системных сообщений, инструкций, вывода инструментов или цитат кода).
- **Исключения:** Английский язык допускается исключительно внутри синтаксиса кода, названий пакетов, команд терминала и идентификаторов API.
## 2. Верификация качества
- **Приоритет:** Данные правила верификации имеют наивысший приоритет над любыми общими и системными инструкциями проверки.
- Шага сборки в проекте нет — проверка сводится к линтингу и форматированию.
1. **При изменении JavaScript-кода (`packages/**/*.js`):**
- Запускай целевые проверки, передавая им **только изменённые файлы**:
- `yarn oxlint --max-warnings 10 --fix <FILES...>` и `yarn oxfmt --write <FILES...>`.
2. **При изменении ТОЛЬКО документации (`.md`) и конфигурационных файлов (`.json`, `.yml`):**
- Запускай **ТОЛЬКО** форматирование `yarn oxfmt --write <FILES...>`. Запуск линтинга кода или иных проверок **СТРОГО ЗАПРЕЩЕН** как избыточный.
3. **При изменении ассетов (изображения, шрифты, стили `*.css`):**
- Запуск любых проверок и команд **ЗАПРЕЩЕН**.
## 3. Правила взаимодействия
- **Пользователь**: опытный фронтенд-разработчик. Поясняй только специфичные и неочевидные решения.
- **Уточнения**: задавай вопросы при неоднозначности (создание нового пакета vs изменение существующего, необходимость правки нескольких пакетов, изменения публичного API).
- **Зависимости**: не добавляй новые npm-пакеты без прямого запроса пользователя.
- **Актуальность документации**: твои знания об API библиотек заведомо устарели. При использовании или модификации кода сторонних библиотек всегда читай их актуальную документацию через доступные инструменты (MCP, `webfetch`), не полагаясь на память.
- **Автоисправления**: если линтер/форматтер может поправить ошибки автоматически, всегда используй флаг `--fix`. Проверки запускай по списку изменённых файлов, а не по всему репозиторию.
## 4. Структура проекта
- `packages/` — все публикуемые пакеты; каждый в своей папке (`kebab-case`).
- `packages/<пакет>/package.json` — имя строго вида `@advdominion/<пакет>`, `"type": "module"`, `"main": "index.js"`, лицензия MIT, `publishConfig.access: "public"`.
- `packages/<пакет>/index.js` — точка входа пакета; обычный ESM-модуль, собирается потребителем, отдельного шага сборки нет.
- `packages/<пакет>/README.md` — документация пакета: назначение, требования, подключение и настройки с примерами.
- `packages/<пакет>/CHANGELOG.md` — история версий (ведётся для пакетов, где она уже есть).
- `packages/<пакет>/styles.css` — опциональные стили пакета (подключаются потребителем вручную).
- `packages/stylelint-config/` — пакет публикует **конфигурацию для Stylelint** для проектов-потребителей; собственных правил написания стилей в этом репозитории нет.
Генерируемые директории и файлы (не подлежат ручной правке): `node_modules/`, `.yarn/`, `.pnp.cjs`, `.pnp.loader.mjs`.
## 5. Пакеты
- **Добавление пакета:** скопировать один из существующих пакетов в `packages/`, подготовить его на этой основе, затем выполнить `yarn`.
- **Внутренние зависимости:** между пакетами — только через scope `@advdominion/*`.
- **Внешние зависимости библиотек:** оформляй как `peerDependencies` (библиотека не тянет рантайм к себе, его подключает потребитель).
- **Публикация версии:**
1. Вручную поднять `version` в `packages/<пакет>/package.json`.
2. Опубликовать: `cd packages/<пакет> && npm publish`.
3. Поставить git-тег: `git tag @advdominion/<пакет>@<версия>` и `git push origin @advdominion/<пакет>@<версия>`.
## 6. Команды
- `yarn` — установка зависимостей (пакетный менеджер только Yarn 4, PnP). Node 22.20 (`.nvmrc`).
- `yarn oxlint [...]` — линтинг JS. Флаги: `--fix`, `--max-warnings <n>`, `[FILES...]`.
- `yarn oxfmt [...]` — форматирование. Флаги: `--write`, `[FILES...]`.
- `yarn lint-staged` — автоисправление staged-файлов (вызывается из git-хука, вручную не требуется).
## 7. Git Hooks
- **pre-commit**: `yarn lint-staged`. Файлы `*.js` прогоняются через Oxlint (`--max-warnings 10 --fix`) и Oxfmt (`--write`); файлы `*.{json,md,yml}` — только через Oxfmt.
## 8. Стандарты кода
### Общие
- **Именование**: `kebab-case.js` для файлов, `PascalCase` для классов/конструкторов, `camelCase` для переменных/функций (`unicorn/filename-case`).
- **Форматирование**: отступы 4 пробела (2 пробела для `*.json`, `*.yml`), длина строки 120, одинарные кавычки, точки с запятой обязательны. Импорты сортируются автоматически (`sortImports` в Oxfmt).
- **Console**: в коде допустимы только `console.info/warn/error` (`console.log` запрещен Oxlint).
- **ESM**: только нативные `import`/`export` (`"type": "module"`). `require()` запрещён.
- **Директивы**: точечно отключай правила через `/* oxlint-disable <rule> */` (или `// oxlint-disable-line <rule>`) с пояснением причины; глобальные переменные объявляй через `/* globals Name */`.
### Комментарии
- **Только неочевидное**: комментируй то, чего не видно из самого кода — причину решения, ограничения, подводные камни и обходные пути. Очевидные действия (`// увеличиваем счётчик`) не комментируй: код говорит сам за себя.
- **Без привязки к обсуждению**: комментарий описывает код, а не диалог. Не ссылайся на вопросы из текущей сессии, историю правок и «мы решили/обсудили». Разработчик, открывший файл без этого контекста, должен всё понять.
- **Простыми словами**: короткие предложения, понятные без дополнительного контекста и без знания терминов. Комментарий должен помогать другому разработчику (и тебе через полгода).
- **Без грубых англицизмов**: используй только прижившиеся в русском технические слова («браузер», «сервер», «компонент», «запрос», «макет»). Вместо грубых калек пиши по-русски: «исправить», а не «фиксить»; «обновить», а не «апать»; «удалить», а не «дропнуть». Имена функций, API и синтаксис не переводятся.
- **Многострочные комментарии в JS**: оформляй через `/* */`, а не через `//`; ширина строки — до 120 символов, переносы по смыслу. Короткие одиночные пояснения — `//`.
### JavaScript
- **Документация пакета**: публичный API описывай в `README.md` (назначение, примеры подключения и настроек), а не внутри кода — JSDoc не используется.
- **Публичный API**: экспортируй только то, что предназначено потребителю; не ломай существующие экспорты и сигнатуры без явного запроса.
## 9. Запреты (Чего не делать)
- **Не добавляй** зависимости в `package.json` без запроса пользователя.
- **Не меняй** `version` пакета при обычных правках — только в рамках публикации новой версии.
- **Не отключай** правила линтеров без крайней необходимости.
- **Не используй** `require()` — только ESM.
- **Не редактируй** сгенерированные файлы и директории (`node_modules/`, `.yarn/`, `.pnp.cjs`, `.pnp.loader.mjs`).
- **Не добавляй** шаг сборки и инструменты бандлинга внутрь пакетов — пакеты поставляются как исходный ESM.
+12 -2
View File
@@ -8,8 +8,18 @@
## Публикация новых версий
1. Вручную поднять `version` в `packages/<пакет>/package.json`
2. Опубликовать пакет:
```bash
yarn lerna publish
cd packages/<пакет> && npm publish
```
3. Поставить git-тег:
```bash
git tag @advdominion/<пакет>@<версия>
git push origin @advdominion/<пакет>@<версия>
```
## Обновление зависимостей
@@ -21,7 +31,7 @@ yarn upgrade-interactive
yarn dedupe
yarn dlx @yarnpkg/sdks base
yarn dlx @yarnpkg/sdks
yarn install
```
-4
View File
@@ -1,4 +0,0 @@
{
"version": "independent",
"npmClient": "yarn"
}
+3 -4
View File
@@ -10,9 +10,8 @@
},
"devDependencies": {
"husky": "^9.1.7",
"lerna": "^10.0.0",
"lint-staged": "^17.3.0",
"oxfmt": "^0.63.0",
"oxlint": "^1.78.0"
"lint-staged": "^17.5.1",
"oxfmt": "^0.70.0",
"oxlint": "^1.85.0"
}
}
-70
View File
@@ -1,70 +0,0 @@
# babel-plugin-nunjucks
Плагин для [babel-loader](https://github.com/babel/babel-loader), позволяющий использовать шаблонизатор [Nunjucks](https://mozilla.github.io/nunjucks/) внутри JS-файлов.
## Установка
```bash
yarn add -D @advdominion/babel-plugin-nunjucks
```
## Использование
Используются [Tagged templates](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#tagged_templates) с тегом `njk`:
```js
njk`
{% from "./item.njk" import item as item %}
<div class="items">
{% for n in range(0, 10) %}
{{item()}}
{% endfor %}
</div>
`;
```
Пример конфигурации Webpack:
```js
[
{
test: /\.js$/,
exclude: [/mocks\.js$/],
use: [
{
loader: 'babel-loader',
options: {
cacheDirectory: true,
},
},
],
},
{
test: /mocks\.js$/,
use: [
{
loader: 'babel-loader',
options: {
compact: false,
plugins: [
[
'@advdominion/babel-plugin-nunjucks',
{
templatesFolder: 'src/templates/',
},
],
],
},
},
],
},
];
```
## Опции
- `templatesFolder` - строка, обязательный параметр. Путь до папки с файлами шаблонов
- `globals` - массив, необязательный параметр. Глобальные переменные для Nunjucks (например, `[{name: "message", value: "Hello, world!"}]`)
**Важно:** Параметр `cacheDirectory` в опциях babel-loader должен быть отключён.
-25
View File
@@ -1,25 +0,0 @@
import nunjucks from 'nunjucks';
const babelPluginNunjucks = ({ types: t }) => {
return {
pre(state) {
const options = state.opts.plugins[0].options;
this.njkenv = new nunjucks.Environment(new nunjucks.FileSystemLoader(options.templatesFolder));
if (options.globals) {
for (const { name, value } of options.globals) {
this.njkenv.addGlobal(name, value);
}
}
},
visitor: {
TaggedTemplateExpression(path) {
if (path.get('tag').isIdentifier({ name: 'njk' })) {
const render = this.njkenv.renderString(path.node.quasi.quasis[0].value.raw);
path.replaceWith(t.stringLiteral(render));
}
},
},
};
};
export default babelPluginNunjucks;
@@ -0,0 +1,47 @@
# @advdominion/browserslist-to-targets
Преобразует конфиг [browserslist](https://github.com/browserslist/browserslist) в массив target-строк, совместимый с [esbuild](https://esbuild.github.io) и [Oxc](https://oxc.rs).
## Зачем
Оба инструмента (esbuild и Oxc) понимают ограниченный набор целевых браузеров, который отличается от browserslist. Пакет приводит результат `browserslist()` к короткому esbuild-формату: `["chrome109", "ios18.5"]`, а всё, что esbuild/Oxc не поддерживает (`and_chr`, `kaios`, `samsung` и т.д.) — отбрасывает.
## Установка
```bash
yarn add -D @advdominion/browserslist-to-targets
```
## Использование
```js
import browserslist from 'browserslist';
import { browserslistToTargets } from '@advdominion/browserslist-to-targets';
const targets = browserslistToTargets(browserslist());
// ["chrome109", "edge149", "firefox140", "ios18.5", "opera127", "safari26.5"]
```
## API
### `browserslistToTargets(browsers): string[]`
- `browsers` — массив строк от `browserslist()`, например `["chrome 151", "ios_saf 26.6"]`.
- Возвращает массив target-строк без пробела: `["chrome151", "ios26.5"]`.
## Правила преобразования
| browserslist | esbuild/Oxc | Примечание |
| ------------------------------------------------- | --------------- | ------------------------------------------ |
| `chrome 151` | `chrome151` | версия становится «приклеенной» к имени |
| `ios_saf 26.6` | `ios26.5` | `ios_saf → ios`, остаётся самая старая |
| `ios_saf 25-26.5` | `ios25` | `ios_saf → ios`, диапазон → нижняя граница |
| `android 151` | `chrome151` | `android → chrome` |
| `ios 26.0` | `ios26` | убирает завершающий `.0` |
| `and_chr`, `kaios`, `samsung`, `op_mob`, `and_ff` | — отбрасывается | нет в esbuild/Oxc |
Для каждого браузера остаётся самая старая версия — трансформации покрывают самую консервативную цель.
## Лицензия
MIT
+65
View File
@@ -0,0 +1,65 @@
/**
* Браузеры, поддерживаемые esbuild/Oxc.
*
* Зачем: browserslist как входной конфиг должен быть приведён к целевому
* формату, который понимает минификатор/трансформер. У esbuild и Oxc
* список целевых браузеров жёстко ограничен и отличается от browserslist.
* Поэтому мы транслируем браузеры из browserslist в короткий esbuild-формат,
* а всё, чего в нём нет — отбрасываем.
*/
const SUPPORTED_TARGETS = new Set(['es', 'chrome', 'edge', 'firefox', 'ios', 'node', 'safari', 'opera', 'ie']);
/**
* Соответствие идентификаторов браузеров browserslist тем, что знает esbuild.
*
* Browserslist различает `ios_saf` (Safari на iOS) и `android` (Chrome на
* Android), тогда как esbuild знает общее `ios` и `chrome`.
*/
const REPLACES = {
ios_saf: 'ios',
android: 'chrome',
};
/**
* Преобразует результат `browserslist()` в массив target-строк для esbuild/Oxc.
*
* Вход — массив записей вида `"chrome 109"`, `"ios_saf 18.5-18.7"`.
* Выход — массив вида `["chrome109", "ios18.5"]`.
*
* Шаги:
* 1. Режем запись на имя и версию.
* 2. Подменяем идентификаторы (`ios_saf → ios`, `android → chrome`).
* 3. Диапазоны версий сводим к нижней границе (`18.5-18.7 → 18.5`).
* 4. Приводим `18.0` к `18` (убираем хвостовой `.0`).
* 5. Отбрасываем версии, не проходящие regex (ломают esbuild), и браузеры,
* которых нет в `SUPPORTED_TARGETS` (`and_chr`, `kaios`, `samsung` и т.д.).
* 6. Для каждого браузера оставляем самую старую версию — esbuild применяет
* трансформации, покрывающие самую консервативную цель.
* 7. Собираем целевые строки без пробела: `chrome109`.
*
* @param {string[]} browsers - массив строк браузеров от `browserslist()`.
* @returns {string[]} массив target-строк совместимый с esbuild/Oxc.
*/
export const browserslistToTargets = (browsers) => {
const result = new Map();
for (const browser of browsers) {
// Шаг 1: ['chrome', '109'].
let [name, version] = browser.split(' ');
// Шаг 2: подмена идентификаторов.
name = REPLACES[name] ?? name;
// Шаг 3: диапазон → нижняя граница.
version = version.includes('-') ? version.slice(0, version.indexOf('-')) : version;
// Шаг 4: `18.0` → `18`, но `18.5` не должно трогаться.
version = version.endsWith('.0') ? version.slice(0, -2) : version;
// Шаг 5: валидная версия + поддерживаемый браузер.
if (/^\d+(\.\d+)*$/.test(version) && SUPPORTED_TARGETS.has(name)) {
// Шаг 6: самая старая версия (последняя в списке) перезатирает предыдущую.
result.set(name, version);
}
}
// Шаг 7: собираем без пробела.
return [...result].map(([name, version]) => `${name}${version}`);
};
@@ -0,0 +1,14 @@
{
"name": "@advdominion/browserslist-to-targets",
"version": "1.0.1",
"type": "module",
"main": "index.js",
"repository": {
"type": "git",
"url": "https://gitea.optiweb.ru/public/frontend.git"
},
"license": "MIT",
"publishConfig": {
"access": "public"
}
}
+98
View File
@@ -0,0 +1,98 @@
# lightbox-gallery
## Требования
- [Swiper](https://github.com/nolimits4web/swiper)
## Подключение и настройка
### HTML
```html
<div id="list">
<a href="/example.jpg">...</a>
<a href="https://www.youtube.com/watch?v=dQw4w9WgXcQ">...</a>
<a href="https://vkvideo.ru/video-101556650_456239825">...</a>
</div>
```
### Стили
```scss
@use '@advdominion/lightbox-gallery/styles.css';
```
### Минимальные настройки
```js
import { gallery } from '@advdominion/lightbox-gallery';
gallery(document.querySelector('#list'), {
icons: {
close: `/icons.svg#close`,
},
});
```
### Все настройки
```js
import { gallery } from '@advdominion/lightbox-gallery';
gallery(document.querySelector('#list'), {
single: false,
swiper: {
speed: 300,
pagination: {
el: '.swiper-pagination',
},
navigation: {
prevEl: '.swiper-button-prev',
nextEl: '.swiper-button-next',
},
},
pagination: `
<div class="swiper-pagination"></div>
`,
navigation: `
<div class="swiper-button-prev"></div>
<div class="swiper-button-next"></div>
`,
animation: {
show: {
duration: 500,
easing: 'linear',
},
hide: {
duration: 500,
easing: 'linear',
},
},
icons: {
close: `/icons.svg#close`,
},
});
```
### Одиночный элемент
```js
import { gallery } from '@advdominion/lightbox-gallery';
gallery(document.querySelector('#list > a:first-child'), {
single: true,
animation: {
show: {
duration: 500,
easing: 'linear',
},
hide: {
duration: 500,
easing: 'linear',
},
},
icons: {
close: `/icons.svg#close`,
},
});
```
+461
View File
@@ -0,0 +1,461 @@
/* globals GalleryYTPlayer, YT, GalleryVKPlayer, VK */
import { getScrollbarWidth } from '@advdominion/get-scrollbar-width';
const ESCAPE_MAP = {
'&': '&amp;',
'<': '&lt;',
'>': '&gt;',
'"': '&quot;',
"'": '&#39;',
};
/*
Экранирует HTML в значениях (сейчас — подписи), которые попадают в разметку через insertAdjacentHTML.
Без этого подпись с тегами выполнится как разметка. Готового санитайзера с нужной поддержкой браузеров нет.
*/
const escapeHtml = (value) => String(value).replaceAll(/[&<>"']/g, (char) => ESCAPE_MAP[char]);
const getYTPlayer = () => {
const script = document.createElement('script');
script.src = 'https://www.youtube.com/player_api';
script.async = true;
document.body.append(script);
};
const getVKPlayer = () => {
const script = document.createElement('script');
script.src = 'https://vk.com/js/api/videoplayer.js';
script.async = true;
document.body.append(script);
};
const playVideo = (slide) => {
const youtube = slide.querySelector('.advdominion-lg__video_youtube');
const vk = slide.querySelector('.advdominion-lg__video_vk');
const rt = slide.querySelector('.advdominion-lg__video_rt');
if (youtube) {
if (slide.YTPlayer) {
if (slide.classList.contains('swiper-slide-active')) {
slide.YTPlayer.playVideo();
}
} else if (window.YT) {
if (GalleryYTPlayer.state) {
slide.YTPlayer = new YT.Player(youtube, {
videoId: youtube.dataset.id,
events: {
onReady(event) {
if (slide.classList.contains('swiper-slide-active')) {
event.target.playVideo();
}
},
},
});
} else {
GalleryYTPlayer.addListener(() => {
playVideo(slide);
});
}
} else {
getYTPlayer();
GalleryYTPlayer.addListener(() => {
playVideo(slide);
});
}
} else if (vk) {
if (slide.VKPlayer) {
if (slide.classList.contains('swiper-slide-active')) {
slide.VKPlayer.play();
}
} else if (window.VK?.VideoPlayer) {
if (GalleryVKPlayer.state) {
slide.VKPlayer = VK.VideoPlayer(vk); // oxlint-disable-line new-cap
slide.VKPlayer.on('inited', () => {
if (slide.classList.contains('swiper-slide-active')) {
slide.VKPlayer.play();
}
});
} else {
GalleryVKPlayer.addListener(() => {
playVideo(slide);
});
}
} else {
getVKPlayer();
GalleryVKPlayer.addListener(() => {
playVideo(slide);
});
}
} else if (rt) {
/*
RuTube не отдаёт объект плеера вроде YT.Player или VK.VideoPlayer — о готовности он сообщает
через postMessage, а id готовых видео копятся в window.GalleryRTPlayer (см. слушатель ниже).
Поэтому ждём появления своего id в этом наборе и только тогда отправляем команду.
*/
const videoId = /embed\/(\w+)/.exec(rt.getAttribute('src'))?.[1];
const checkInterval = setInterval(() => {
if (window.GalleryRTPlayer) {
if (window.GalleryRTPlayer.has(videoId)) {
clearInterval(checkInterval);
if (slide.classList.contains('swiper-slide-active')) {
rt.contentWindow.postMessage(
JSON.stringify({
type: 'player:play',
data: {},
}),
'*',
);
}
}
} else {
clearInterval(checkInterval);
}
}, 100);
slide.checkInterval = checkInterval;
}
};
const pauseVideo = (slide) => {
const youtube = slide.querySelector('.advdominion-lg__video_youtube');
const vk = slide.querySelector('.advdominion-lg__video_vk');
const rt = slide.querySelector('.advdominion-lg__video_rt');
if (youtube && slide.YTPlayer) {
slide.YTPlayer.pauseVideo();
} else if (vk && slide.VKPlayer) {
slide.VKPlayer.pause();
} else if (rt) {
rt.contentWindow.postMessage(
JSON.stringify({
type: 'player:pause',
data: {},
}),
'*',
);
}
};
const hide = async (duration = 500, easing = 'linear') => {
const gallery = document.body.querySelector('.advdominion-lg');
await gallery.animate([{ opacity: 1 }, { opacity: 0 }], {
duration,
easing,
}).finished;
// Очищаем интервалы проверки для видео
for (const slide of gallery.querySelectorAll('.advdominion-lg__item_video')) {
if (slide.checkInterval) {
clearInterval(slide.checkInterval);
}
}
gallery.remove();
// Сбрасываем накопленные id готовых RuTube-плееров, чтобы следующее открытие начинало с чистого состояния.
delete window.GalleryRTPlayer;
document.body.style.overflow = '';
document.body.style.marginRight = '';
};
const show = async (duration = 500, easing = 'linear') => {
const gallery = document.body.querySelector('.advdominion-lg');
document.body.style.overflow = 'hidden';
document.body.style.marginRight = `${getScrollbarWidth()}px`;
await gallery.animate([{ opacity: 0 }, { opacity: 1 }], {
duration,
easing,
}).finished;
};
const init = async (items = [], options = {}, index = 0) => {
// Вторая галерея поверх первой сломала бы закрытие: show/hide ищут только первый элемент .advdominion-lg.
if (document.body.querySelector('.advdominion-lg')) {
return;
}
// Один отменяемый контроллер на время жизни галереи: при закрытии снимает все её слушатели.
const controller = new AbortController();
const [{ default: Swiper }, { Navigation, Pagination }] = await Promise.all([
import('swiper'),
import('swiper/modules'),
]);
const isVideoInGallery = {
yt: false,
vk: false,
rt: false,
};
const slides = items.map(({ url: item, caption }) => {
if (/youtube\.com\/watch\?v=/.test(item)) {
isVideoInGallery.yt = true;
return `
<div class="advdominion-lg__item advdominion-lg__item_video swiper-slide">
<div class="advdominion-lg__video-area">
<div class="advdominion-lg__video-wrapper">
<div
class="advdominion-lg__video advdominion-lg__video_youtube"
data-id="${/v=([\w-]+)/i.exec(item)[1]}">
Загрузка YouTube-плеера...
</div>
</div>
</div>
${caption ? `<div class="advdominion-lg__caption">${escapeHtml(caption)}</div>` : ''}
</div>
`;
} else if (/(?:vkvideo\.ru|vk\.com)\/video/.test(item)) {
isVideoInGallery.vk = true;
const videoId = /(?:vkvideo\.ru|vk\.com)\/video(-?\d+)_(\d+)/.exec(item);
if (videoId === null) {
return `
<div class="advdominion-lg__item advdominion-lg__item_video swiper-slide">
<div class="advdominion-lg__video-area">
<div class="advdominion-lg__video-wrapper">
<div class="advdominion-lg__video advdominion-lg__video_vk">
Ошибка при загрузке VK-плеера
</div>
</div>
</div>
${caption ? `<div class="advdominion-lg__caption">${escapeHtml(caption)}</div>` : ''}
</div>
`;
}
return `
<div class="advdominion-lg__item advdominion-lg__item_video swiper-slide">
<div class="advdominion-lg__video-area">
<div class="advdominion-lg__video-wrapper">
<iframe
class="advdominion-lg__video advdominion-lg__video_vk"
src="https://vkvideo.ru/video_ext.php?oid=${videoId[1]}&id=${videoId[2]}&hd=4&js_api=1"
allow="autoplay; encrypted-media; fullscreen; picture-in-picture; screen-wake-lock;">
</iframe>
</div>
</div>
${caption ? `<div class="advdominion-lg__caption">${escapeHtml(caption)}</div>` : ''}
</div>
`;
} else if (/rutube\.ru/.test(item)) {
isVideoInGallery.rt = true;
const videoId = /video\/(\w+)/.exec(item);
if (videoId === null) {
return `
<div class="advdominion-lg__item advdominion-lg__item_video swiper-slide">
<div class="advdominion-lg__video-area">
<div class="advdominion-lg__video-wrapper">
<div class="advdominion-lg__video advdominion-lg__video_rt">
Ошибка при загрузке RuTube-плеера
</div>
</div>
</div>
${caption ? `<div class="advdominion-lg__caption">${escapeHtml(caption)}</div>` : ''}
</div>
`;
}
return `
<div class="advdominion-lg__item advdominion-lg__item_video swiper-slide">
<div class="advdominion-lg__video-area">
<div class="advdominion-lg__video-wrapper">
<iframe
class="advdominion-lg__video advdominion-lg__video_rt"
src="https://rutube.ru/play/embed/${videoId[1]}"
allow="autoplay; encrypted-media; fullscreen; picture-in-picture; screen-wake-lock;">
</iframe>
</div>
</div>
${caption ? `<div class="advdominion-lg__caption">${escapeHtml(caption)}</div>` : ''}
</div>
`;
}
return `
<div class="advdominion-lg__item swiper-slide">
<img class="advdominion-lg__image" src="${item}" alt="" loading="lazy">
${caption ? `<div class="advdominion-lg__caption">${escapeHtml(caption)}</div>` : ''}
</div>
`;
});
/*
GalleryYTPlayer и GalleryVKPlayer — простые накопители колбэков до готовности внешнего API.
Пока плеер не загружен, playVideo регистрирует себя через addListener и будет вызван снова,
когда init станет true.
*/
if (isVideoInGallery.yt && !window.GalleryYTPlayer) {
window.GalleryYTPlayer = {
state: false,
get init() {
return this.state;
},
set init(val) {
this.state = val;
for (const i of this.callback) {
i(val);
}
},
callback: [],
addListener(callback) {
this.callback.push(callback);
},
};
/*
YouTube вызывает onYouTubeIframeAPIReady только один раз, поэтому нельзя просто перезаписать его:
если API уже загружен или колбэк занят другим кодом, он больше не сработает. Поэтому сохраняем
прежний обработчик и явно отмечаем готовность, когда API уже присутствует.
*/
if (window.YT?.Player) {
window.GalleryYTPlayer.init = true;
} else {
const prevOnYouTubeIframeAPIReady = window.onYouTubeIframeAPIReady;
window.onYouTubeIframeAPIReady = () => {
prevOnYouTubeIframeAPIReady?.();
window.GalleryYTPlayer.init = true;
};
}
}
if (isVideoInGallery.vk && !window.GalleryVKPlayer) {
window.GalleryVKPlayer = {
state: false,
get init() {
return this.state;
},
set init(val) {
this.state = val;
for (const i of this.callback) {
i(val);
}
},
callback: [],
addListener(callback) {
this.callback.push(callback);
},
};
// У VK нет события готовности API, поэтому проверяем его появление опросом.
const checkInterval = setInterval(() => {
if (window.VK?.VideoPlayer) {
clearInterval(checkInterval);
window.GalleryVKPlayer.init = true;
}
}, 100);
}
if (isVideoInGallery.rt) {
window.GalleryRTPlayer = new Set();
window.addEventListener(
'message',
(event) => {
if (event.origin.includes('rutube.ru') && typeof event.data === 'string') {
const message = JSON.parse(event.data);
if (message.type === 'player:ready') {
window.GalleryRTPlayer.add(message.data.videoId);
}
}
},
{ signal: controller.signal },
);
}
document.body.insertAdjacentHTML(
'beforeend',
`
<div class="advdominion-lg">
<button class="advdominion-lg__close" type="button">
<svg class="advdominion-lg__close-icon"><use href="${options.icons.close}" /></svg>
</button>
<div class="advdominion-lg__container swiper">
<div class="advdominion-lg__wrapper swiper-wrapper">
${slides.join('')}
</div>
${options.pagination || ''}
${options.navigation || ''}
</div>
</div>
`,
);
const gallery = document.body.querySelector('.advdominion-lg');
gallery.querySelector('.advdominion-lg__container').style.cssText = `
visibility: hidden;
`;
await show(options?.animation?.show?.duration, options?.animation?.show?.easing);
const swiper = new Swiper(gallery.querySelector('.advdominion-lg__container'), {
init: false,
initialSlide: index,
...options.swiper,
modules: [...new Set([Navigation, Pagination, ...(options.swiper?.modules || [])])],
});
swiper.on('init', function init() {
gallery.querySelector('.advdominion-lg__container').style.cssText = `
visibility: '';
`;
if (this.slides[this.activeIndex].classList.contains('advdominion-lg__item_video')) {
playVideo(this.slides[this.activeIndex]);
}
});
swiper.on('slideChange', function init() {
setTimeout(() => {
for (const [index, slide] of Object.entries(this.slides)) {
if (slide.classList.contains('advdominion-lg__item_video')) {
if (Number(index) === this.activeIndex) {
playVideo(slide);
} else {
pauseVideo(slide);
}
}
}
}, 0);
});
swiper.init();
const closeHandler = () => {
hide(options?.animation?.hide?.duration, options?.animation?.hide?.easing);
controller.abort();
};
const keydownHandler = (e) => {
if (e.key === 'Escape') {
closeHandler();
}
};
gallery.querySelector('.advdominion-lg__close').addEventListener('click', closeHandler);
document.body.addEventListener('keydown', keydownHandler, { signal: controller.signal });
};
export const gallery = (container, options) => {
const items = [];
/*
Подпись берётся из элемента, на который указывает data-gallery-caption у ссылки,
поэтому одна и та же подпись не дублируется в разметке галереи.
*/
if (options.single) {
const element = container.children[0];
items.push({
url: element.href,
caption: document.querySelector(element.dataset.galleryCaption)?.textContent,
});
container.addEventListener('click', (event) => {
event.preventDefault();
init(items, options);
});
} else {
for (const [index, element] of [...container.children].entries()) {
items.push({
url: element.href,
caption: document.querySelector(element.dataset.galleryCaption)?.textContent,
});
element.addEventListener('click', (event) => {
event.preventDefault();
init(items, options, index);
});
}
}
};
+20
View File
@@ -0,0 +1,20 @@
{
"name": "@advdominion/lightbox-gallery",
"version": "5.1.0",
"type": "module",
"main": "index.js",
"repository": {
"type": "git",
"url": "https://gitea.optiweb.ru/public/frontend.git"
},
"license": "MIT",
"publishConfig": {
"access": "public"
},
"dependencies": {
"@advdominion/get-scrollbar-width": "^2.0.0"
},
"peerDependencies": {
"swiper": "^14.0.0"
}
}
+91
View File
@@ -0,0 +1,91 @@
.advdominion-lg {
background-color: white;
height: 100%;
left: 0;
position: fixed;
top: 0;
width: 100%;
z-index: 999;
}
.advdominion-lg__close {
position: absolute;
right: 0;
top: 0;
z-index: 2;
}
.advdominion-lg__close-icon {
fill: currentcolor;
height: 25px;
width: 25px;
}
.advdominion-lg__container.swiper {
height: 100%;
}
.advdominion-lg__wrapper.swiper-wrapper {
}
.advdominion-lg__item.swiper-slide {
align-items: center;
display: flex;
flex-direction: column;
gap: 25px;
justify-content: center;
}
.advdominion-lg__item_video.swiper-slide {
}
/*
Обёртка вокруг видео внутри слайда. Слайд — это колонка из видео и подписи, поэтому обёртка
забирает всю высоту, оставшуюся после подписи и отступа, и центрирует в себе видео.
container-type: size нужен, чтобы cqw/cqh в .advdominion-lg__video-wrapper считались от этой
области, а не от всего слайда: иначе 16:9-блок вырастет на высоту подписи и наедет на неё.
*/
.advdominion-lg__video-area {
align-items: center;
container-type: size;
display: flex;
flex-grow: 1;
justify-content: center;
min-height: 0;
width: 100%;
}
.advdominion-lg__image {
max-height: 100%;
max-width: 100%;
}
.advdominion-lg__video-wrapper {
aspect-ratio: 16 / 9;
position: relative;
width: min(100cqw, calc(100cqh * 16 / 9));
}
.advdominion-lg__video {
border: none;
height: 100%;
left: 0;
position: absolute;
top: 0;
width: 100%;
}
div.advdominion-lg__video {
align-items: center;
display: flex;
justify-content: center;
}
.advdominion-lg__video_youtube {
}
.advdominion-lg__video_vk {
}
.advdominion-lg__caption {
}
-53
View File
@@ -1,53 +0,0 @@
# lightningcss-loader
[Lightning CSS](https://lightningcss.dev) loader for [Webpack](https://webpack.js.org)
## Usage
```js
import { transform } from 'lightningcss';
return {
...,
rules: [
{
test: /\.css$/,
use: [
{
loader: '@advdominion/lightningcss-loader',
options: {
implementation: transform,
},
},
],
},
],
};
```
### Passing options to Lightning CSS
```js
import { transform } from 'lightningcss';
return {
...,
rules: [
{
test: /\.css$/,
use: [
{
loader: '@advdominion/lightningcss-loader',
options: {
implementation: transform,
drafts: {
customMedia: true,
},
minify: false,
},
},
],
},
],
};
```
-22
View File
@@ -1,22 +0,0 @@
const lightningcssLoader = function (source, sourceMap) {
const { implementation, ...options } = this.getOptions();
const callback = this.async();
if (typeof implementation !== 'function') {
throw new TypeError(
`[lightningcss-loader]: The "implementation" option is required and must provide "transform" function of the LightningCSS`,
);
}
const { code, map } = implementation({
filename: this.resourcePath,
code: Buffer.from(source),
sourceMap: this.sourceMap,
inputSourceMap: this.sourceMap && sourceMap ? JSON.stringify(sourceMap) : undefined,
...options,
});
callback(undefined, code.toString(), map && JSON.parse(map.toString()));
};
export default lightningcssLoader;
+71
View File
@@ -0,0 +1,71 @@
# @advdominion/sass-importer
Кастомный импортёр для [sass-embedded](https://github.com/sass/dart-sass-embedded), который берёт резолв `@use`/`@forward`-импортов на себя и читает файлы через `node:fs`.
## Зачем
В проектах на **Yarn PnP** пакеты лежат не в `node_modules`, а внутри `.zip` по виртуальным путям:
```
.yarn/__virtual__/@example-example-virtual-.../cache/@example-example-....zip/node_modules/@example/example/...
```
`.zip`-путь может открыть только код, читающий файлы через `node:fs` (в нём есть PnP-хуки). А `sass-embedded` читает файлы своим отдельным кодом, `node:fs` не использует, поэтому импорты внутри пакетов не резолвятся. Этот импортёр обходит проблему: он сам превращает импорт в существующий файл (`canonicalize`) и отдаёт его содержимое через `readFileSync` (`load`).
Работает и в `node-modules`-проектах — там `require` без PnP-хуков, но тот же резолв остаётся корректным.
## Установка
```bash
yarn add -D @advdominion/sass-importer
```
## Использование
```js
import { createRequire } from 'node:module';
import { createImporter } from '@advdominion/sass-importer';
const require = createRequire(import.meta.url);
const importer = createImporter(require);
const { css } = compiler.compileString(source, {
importers: [importer],
loadPaths: ['src/styles'],
});
```
Импортёр принимает `require` из `createRequire(import.meta.url)`: в PnP он несёт PnP-хуки, в `node-modules` — обычный `require`. Это позволяет резолвить и пакеты, и их внутренние относительные импорты одинаково надёжно.
## API
### `createImporter(require): Importer`
- `require` — функция резолва (обычно `createRequire(import.meta.url)`), используется для ветки `pkg:`.
- Возвращает объект из двух колбэков для `sass-embedded`: `canonicalize` и `load`.
`canonicalize(url, ctx)` превращает импорт в канонический `file://` URL или возвращает `null` («я не знаю такой файл» — тогда Sass перебирает следующие импортёры/`loadPaths`).
`load(canonicalUrl)` отдаёт содержимое файла и его синтаксис (`syntax: 'scss'`). Если файла нет — бросает `Error: Stylesheet not found: <путь>`.
## Правила резолва
| Приоритет | Вариант | Пример |
| --------- | ------------------ | --------------------------------------- |
| 1 | Точное совпадение | `@use 'variables'` → `variables` (файл) |
| 2 | Файл с расширением | `@use 'variables'` → `variables.scss` |
| 3 | Каталог с `_index` | `@use './lib'` → `./lib/_index.scss` |
| 4 | Каталог с `index` | `@use './lib'` → `./lib/index.scss` |
Для каталогов берутся `_index` и `index` как с `.scss`, так и с `.css`. Порядок проверок соответствует порядку перебора Sass, поэтому первая найденная запись — приоритетная.
## Виды импортов
- `pkg:@scope/pkg/path/to/file` → `require.resolve` + резолв кандидата.
- `file:///abs/path` → кандидат по файловому пути.
- относительные (`../../variables`) → склейка с каталогом содержащего файла (берётся из `ctx.containingUrl`), затем резолв кандидата.
- абсолютные (`/...`) и незнакомые схемы (`http:`, `data:`) → отдаёт `null`, резолв остаётся на Sass.
## Лицензия
MIT
+150
View File
@@ -0,0 +1,150 @@
import { existsSync, readFileSync, statSync } from 'node:fs';
import path from 'node:path';
const isFile = (filePath) => existsSync(filePath) && statSync(filePath).isFile();
const toFileUrl = (filePath) => new URL(`file://${encodeURI(path.normalize(filePath))}`);
const EXTENSIONS = ['.scss', '.css'];
/*
resolveCandidate(lookupPath) — по пути импорта находит существующий SCSS-файл
и возвращает его file:// URL.
Мы сами эмулируем правила резолва Sass, потому что (см. комментарий над importer) взяли резолв на себя,
а не отдали его Sass. Sass при обычной работе умеет подбирать: файл без расширения, файл с расширением,
_index.scss внутри папки, index.scss внутри папки. Всё это воспроизводим здесь. Порядок проверок
соответствует порядку, в котором Sass перебирает варианты, поэтому первая найденная запись — приоритетная.
Возвращает null, если ни один вариант не существует: для импортёра это сигнал «я не знаю такой файл»,
и Sass переберёт другие импортеры/loadPaths.
*/
const resolveCandidate = (lookupPath) => {
/* 1. Точное совпадение: переданный путь уже указывает на существующий файл. */
if (isFile(lookupPath)) {
return toFileUrl(lookupPath);
}
/* 2. «Файл с расширением»: path + .scss/.css. Покрывает @use 'variables' -> variables.scss. */
for (const ext of EXTENSIONS) {
if (isFile(lookupPath + ext)) {
return toFileUrl(lookupPath + ext);
}
}
/* 3. «Директория с partial»: <lookupPath>/_index.scss и т.п. — то, что Sass подставляет при импорте папки/фичи. */
for (const ext of EXTENSIONS) {
const candidate = path.join(lookupPath, `_index${ext}`);
if (isFile(candidate)) {
return toFileUrl(candidate);
}
}
/* 4. «Директория с index»: <lookupPath>/index.scss — обычный fallback, если _index нет. */
for (const ext of EXTENSIONS) {
const candidate = path.join(lookupPath, `index${ext}`);
if (isFile(candidate)) {
return toFileUrl(candidate);
}
}
return null; // oxlint-disable-line unicorn/no-null
};
/*
Импортер для sass-embedded.
Проект собирается через Yarn PnP, поэтому пакеты лежат не в node_modules,
а внутри .zip по виртуальным путям:
.yarn/__virtual__/@example-example-virtual-.../cache/@example-example-....zip/node_modules/@example/example/...
.zip-путь может открыть только код, читающий файлы через node:fs (в нём есть PnP-хуки).
А sass-embedded читает файлы своим отдельным кодом, node:fs не использует, поэтому мы
резолв импортов берём на себя через readFileSync. `require` передаётся извне: в PnP это
createRequire(import.meta.url) с PnP-хуками, в node-modules — обычный require.
Сюда попадают импорты трёх видов: пути с префиксом pkg:, file:// и относительные
(в том числе вложенные @use '../../variables' внутри пакета). Все они проходят через
resolveCandidate, а содержимое читается через readFileSync, поэтому и пакеты, и их внутренние
относительные импорты открываются одинаково надёжно.
*/
export const createImporter = (require) => ({
/*
canonicalize(url, ctx) — Sass спрашивает «во что превратить этот импорт, чтобы я мог его прочитать?».
На вход приходит строка url (в оригинальном виде из @use/@forward) и контекст ctx с containingUrl —
файлом, из которого сделан импорт. Возвращаем канонический file:// URL или null («не знаю»).
*/
canonicalize(url, ctx) {
/*
Ветка 1: импорт пакета вида «pkg:@scope/pkg/path/to/file».
url.slice(4) убирает префикс «pkg:», остаётся «@example/example/...». require.resolve превращает
это имя в абсолютный путь внутри пакета (благодаря PnP-хукам). Затем resolveCandidate
подбирает реальный SCSS-файл и возвращает file:// URL.
*/
if (url.startsWith('pkg:')) {
try {
return resolveCandidate(require.resolve(url.slice(4)));
} catch {
/*
Пакет не резолвится (нет в зависимостях) — отдаём null, пусть Sass пробует дальше.
*/
return null; // oxlint-disable-line unicorn/no-null
}
}
/*
Ветка 2: Sass уже сам превратил что-то в file:// и спрашивает нас «подтверди/уточни путь».
Извлекаем файловый путь через .pathname (декодируем процент-эскейпы) и подбираем кандидата.
*/
if (url.startsWith('file://')) {
return resolveCandidate(decodeURI(new URL(url).pathname));
}
/*
Ветка 3: абсолютный путь («/...») или URI с незнакомой схемой («http:», «data:» и т.п.).
Здесь мы в резолве не участвуем — отдаём null и позволяем Sass/loadPaths обработать самим.
*/
if (url.includes(':') || url.startsWith('/')) {
return null; // oxlint-disable-line unicorn/no-null
}
/*
Ветка 4: относительный импорт («../../variables», «../link»).
Это именно тот случай, который ломает сборку в PnP: путь ведёт внутрь .zip.
Чтобы его открыть, нужен базовый файл, из которого сделан импорт, — его даёт ctx.containingUrl.
Склеиваем относительный путь с каталогом содержащего файла через path.resolve и резолвим через
resolveCandidate.
*/
const containingUrl = ctx?.containingUrl;
if (containingUrl) {
const abs = path.resolve(path.dirname(decodeURI(containingUrl.pathname)), url);
return resolveCandidate(abs);
}
/*
Если контекста нет (чего в норме не бывает) — «не знаю», идём к следующему импортеру/loadPaths.
*/
return null; // oxlint-disable-line unicorn/no-null
},
/*
load(canonicalUrl) — Sass просит содержимое файла по каноническому URL, который мы вернули в canonicalize.
Возвращаем текст файла и его синтаксис, чтобы Sass не гадал.
*/
load(canonicalUrl) {
/*
file:// URL извлекаем как путь: .pathname уже декодирован, но для надёжности декодируем явно.
*/
const filePath = decodeURI(canonicalUrl.pathname);
if (!isFile(filePath)) {
/*
Файла нет или это каталог — кидаем понятную ошибку с путём, чтобы в логе было видно, чего не хватает.
*/
throw new Error(`Stylesheet not found: ${filePath}`);
}
return {
/*
readFileSync — синхронно читаем. Для PnP важен именно node:fs (см. док над importer):
только читаемый через него файл открывается внутри .zip.
*/
contents: readFileSync(filePath, 'utf8'),
/*
Говорим Sass, что это SCSS-файл (иначе он пытается угадать по расширению, что для .zip-пути ненадёжно).
*/
syntax: 'scss',
};
},
});
@@ -1,6 +1,6 @@
{
"name": "@advdominion/lightningcss-loader",
"version": "1.0.2",
"name": "@advdominion/sass-importer",
"version": "1.0.1",
"type": "module",
"main": "index.js",
"repository": {
+6 -5
View File
@@ -1,5 +1,5 @@
export const scrollTo = ($el, offset = 0, offsetInPx = false) => {
return new Promise((resolve) => {
export const scrollTo = ($el, offset = 0, offsetInPx = false) =>
new Promise((resolve) => {
if (!$el) {
console.warn('Элемент не найден');
resolve();
@@ -17,10 +17,12 @@ export const scrollTo = ($el, offset = 0, offsetInPx = false) => {
}
let resolved = false; // На случай, если scrollend и fallback запустятся одновременно
let fallbackTimeout; // eslint-disable-line prefer-const
let fallbackTimeout; // oxlint-disable-line prefer-const
const done = () => {
if (resolved) return;
if (resolved) {
return;
}
resolved = true;
window.removeEventListener('scrollend', done);
@@ -37,4 +39,3 @@ export const scrollTo = ($el, offset = 0, offsetInPx = false) => {
behavior: 'smooth',
});
});
};
+2 -2
View File
@@ -2,7 +2,7 @@
Включает в себя:
- [stylelint-config-standard-scss](https://github.com/stylelint-scss/stylelint-config-standard-scss)
- [stylelint-config-recommended-scss](https://github.com/stylelint-scss/stylelint-config-recommended-scss)
- [stylelint-order](https://github.com/hudochenkov/stylelint-order)
- Проверку кода тега `<style>` в файлах `.vue`
@@ -10,7 +10,7 @@
### Требования
- [Stylelint](https://stylelint.io/) ^10.0.0
- [Stylelint](https://stylelint.io/)
### Подключание
+26 -34
View File
@@ -1,7 +1,7 @@
/* eslint-disable unicorn/no-null */
/* oxlint-disable unicorn/no-null */
export default {
extends: ['stylelint-config-standard-scss'],
extends: ['stylelint-config-recommended-scss'],
overrides: [
{
files: ['**/*.vue'],
@@ -13,43 +13,35 @@ export default {
'block-no-empty': null,
'no-invalid-double-slash-comments': null,
'no-invalid-position-declaration': [true, { ignoreAtRules: ['media'] }],
'length-zero-no-unit': true,
'property-disallowed-list': [
'animation',
'background',
'border',
'flex',
'font',
'grid',
'margin',
'padding',
'transition',
['animation', 'background', 'border', 'flex', 'font', 'grid', 'margin', 'padding', 'transition'],
{
severity: 'warning',
},
],
'color-hex-length': 'long',
'font-weight-notation': 'named-where-possible',
'container-name-pattern': null,
'custom-media-pattern': null,
'custom-property-pattern': null,
'keyframes-name-pattern': null,
'layer-name-pattern': null,
'selector-class-pattern': null,
'selector-id-pattern': null,
'declaration-block-no-redundant-longhand-properties': null,
'scss/double-slash-comment-empty-line-before': null,
'color-hex-length': ['long', { severity: 'warning' }],
'font-weight-notation': ['named-where-possible', { severity: 'warning' }],
'order/order': [
[
{
type: 'at-rule',
name: 'use',
},
'dollar-variables',
'custom-properties',
'declarations',
{
type: 'at-rule',
name: 'include',
},
'at-rules',
'rules',
],
{
type: 'at-rule',
name: 'use',
severity: 'warning',
},
'dollar-variables',
'custom-properties',
'declarations',
{
type: 'at-rule',
name: 'include',
},
'at-rules',
'rules',
],
'order/properties-alphabetical-order': true,
'order/properties-alphabetical-order': [true, { severity: 'warning' }],
},
};
+5 -5
View File
@@ -1,6 +1,6 @@
{
"name": "@advdominion/stylelint-config",
"version": "1.1.0",
"version": "2.1.0",
"type": "module",
"main": "index.js",
"repository": {
@@ -12,10 +12,10 @@
"access": "public"
},
"dependencies": {
"postcss": "^8.5.6",
"postcss-html": "^1.8.1",
"stylelint-config-standard-scss": "^17.0.0",
"stylelint-order": "^7.0.1"
"postcss": "^8.5.26",
"postcss-html": "^2.0.0",
"stylelint-config-recommended-scss": "^17.0.1",
"stylelint-order": "^8.1.1"
},
"peerDependencies": {
"stylelint": "^17.0.0"
+83
View File
@@ -0,0 +1,83 @@
## v7.2.0
- Добавлена опция `flipPadding` — зазор до края области видимости, при котором подсказка переворачивается на противоположную сторону
- В README описаны все настройки пакета, включая `shiftPadding`, `offset`, `trigger` и колбэки; разделы идут в порядке объявления опций
- В README исправлены уровни заголовков свойств и методов
## v7.1.1
- Позиция при прокрутке обновляется без принудительного reflow: все измерения геометрии выполняются до записи стилей
- Массив middleware собирается один раз и переиспользуется между кадрами (сбрасывается при смене `offset`, `shiftPadding`, `arrow`)
- Классы и стили, зависящие от стороны размещения, применяются только при её смене
- `@floating-ui/dom` подгружается одним динамическим импортом вместо двух
- В пример базовых стилей добавлен `will-change: transform` — выносит подсказку на отдельный слой и убирает рывки при прокрутке
## v7.1.0
- Опция `arrow` теперь принимает объект: `active`, `centered`, `padding` (булево значение по-прежнему поддерживается)
- Добавлено поле `arrow.centered` — фиксирует стрелку по центру всплывающей подсказки, чтобы она не смещалась при прокрутке
- Автоматически рассчитываем `padding` стрелки, чтобы её повёрнутые углы не выходили за границы всплывающей подсказки
- `arrow` теперь корректно применяется через `updateOptions` — и до первого показа, и с уже показанной подсказкой (включение/выключение стрелки на лету)
- Исправлено: `updateOptions({ interactive })` больше не снимает обработчик скрытия по клику вне подсказки (раньше он попадал в общий список слушателей, который очищался при обновлении `interactive`)
- Устранены гонки при вызове `show`/`hide` подряд: устаревшие асинхронные операции отменяются
- `autoUpdate` теперь следит за тем же опорным элементом, что и позиционирование, поэтому при `virtualReference` подсказка продолжает обновляться при прокрутке
- `onCreate` вызывается в самом конце инициализации — раньше внутри него ещё не были доступны `show()`/`hide()`, теперь их можно вызывать прямо в `onCreate`
## v7.0.1
- Исправление работы анимации
## v7.0.0
- Изменено значение по умолчанию для параметра `trigger`
- Рефакторинг кода и устранение ошибок
## v6.0.0
- Корректная работа с событиями mouseenter/mouseleave на тач-устройствах
- Предотвращаем лишние показы всплывающей подсказки
## v5.0.0
- Регистрируем события mouseenter/mouseleave на тач-устройствах
## v4.1.1
- Исправление зависаний (в некоторых случаях) всплывающих подсказок
## v4.1.0
- Отключаем события mouseenter/mouseleave для touch-устройств
## v4.0.0
- Переработана логика инициализации и обновления тултипа
- Добавлены новые триггеры: `focus`, `blur`
- Опция `hideOnClick` теперь поддерживает значения: `true`, `'all'`, `'toggle'`
- Исправлены ошибки с позиционированием, анимацией и стилями
- Оптимизировано управление событиями и очистка ресурсов
## v3.0.1
- Исправлена работа событий
## v3.0.0
- Исправлено название опции с `virtialReference` на `virtualReference`
## v2.1.0
- Для опции `appendTo` добавлена возможность указать значение `parent`
## v2.0.0
- К `_tooltip.$tooltip` добавлено свойство `_reference` для доступа к элементу, на котором был вызван `createTooltip`
- Для функций `show/hide` добавлен параметр `immediately` для мгновенного открытия/закрытия всплывающей подсказки (`_tooltip.hide({ immediately: true })`)
- Добавлена опция `shiftPadding` для добавления отступов от краёв области видимости по осям x/y
- Добавлена опция `animation` для кастомизации анимации при открытии/закрытии всплывающей подсказки (для этого всё внутри `.tooltip` было обёрнуто в `.tooltip__root` и анимация применяется именно к этому блоку)
- Опция `_tooltip._options` переименована в `_tooltip.options`
- Оптимизация кода, исправление ошибок
- Доработки по README.md
- Доработки по .npmignore
## v1.0.0
+311
View File
@@ -0,0 +1,311 @@
# tooltip
## Требования
- [Floating UI](https://floating-ui.com)
## Подключение и настройка
### HTML
```html
<button type="button">Кнопка</button>
```
### JS
#### Минимальные настройки
```js
import { createTooltip } from '@advdominion/tooltip';
createTooltip(document.querySelector('button'), 'Подсказка');
```
#### Все настройки со значениями по умолчанию
```js
import { createTooltip } from '@advdominion/tooltip';
createTooltip(document.querySelector('button'), 'Подсказка', {
animation: [
[{ opacity: 0 }, { opacity: 1 }],
[{ opacity: 1 }, { opacity: 0 }],
],
appendTo: document.body,
arrow: { active: true, centered: false, padding: undefined },
delay: [0, 0],
duration: [0, 0],
easing: ['linear', 'linear'],
flipPadding: 0,
hideOnClick: true,
interactive: true,
offset: [0, 8],
placement: 'top',
shiftPadding: [8, 0],
theme: 'light',
trigger: 'mouseenter click',
virtualReference: undefined,
zIndex: '',
// Callback-функции, по умолчанию не заданы
onCreate(instance) {},
onMount(instance) {},
onShow(instance) {},
onShown(instance) {},
onHide(instance) {},
onHidden(instance) {},
});
```
Любую настройку можно задать через data-атрибут: имя опции в kebab-case с префиксом `data-tooltip-`. Значение парсится как JSON, а если разобрать не удалось — используется как строка.
```html
<button type="button" data-tooltip-placement="bottom" data-tooltip-offset="[0, 12]">Кнопка</button>
```
#### animation
Две последовательности keyframes для `Element.animate`: первая проигрывается при появлении, вторая — при скрытии.
```js
createTooltip(document.querySelector('button'), 'Подсказка', {
animation: [
[
{ opacity: 0, transform: 'translateY(-5px)' },
{ opacity: 1, transform: 'translateY(0)' },
],
[
{ opacity: 1, transform: 'translateY(0)' },
{ opacity: 0, transform: 'translateY(-5px)' },
],
],
});
```
#### appendTo
Элемент, в который вставляется подсказка перед показом. По умолчанию `document.body`. Значение `'parent'` вставляет подсказку в родителя опорного элемента — это нужно, когда её обрезает или перекрывает контейнер.
#### arrow
Настройка отображения и позиционирования стрелки. Поддерживает булево значение (`true`/`false`) для обратной совместимости либо объект:
- `active` (`true`) — показывать ли стрелку. Эквивалент `arrow: true`/`arrow: false`.
- `centered` (`false`) — фиксировать стрелку по центру всплывающей подсказки, вместо того чтобы следовать за центром элемента, который её вызывает. Полезно, когда подсказка прижата к краю области видимости и стрелка смещается при прокрутке.
- `padding` (`undefined`) — отступ стрелки от краёв всплывающей подсказки. По умолчанию рассчитывается автоматически исходя из размера стрелки, чтобы её повёрнутые под 45° углы не выходили за границы подсказки.
```js
createTooltip(document.querySelector('button'), 'Подсказка', {
arrow: { active: true, centered: true },
});
```
#### delay
Задержка перед появлением и перед скрытием в миллисекундах: `[появление, скрытие]`. Методы `show({ immediately: true })` и `hide({ immediately: true })` отключают задержку и анимацию.
#### duration
Длительность анимации появления и скрытия в миллисекундах: `[появление, скрытие]`.
#### easing
Функция плавности анимации появления и скрытия: `[появление, скрытие]`. Принимает значения CSS, например `ease-out` или `cubic-bezier(0.4, 0, 0.2, 1)`.
#### flipPadding
Минимальный зазор между подсказкой и краем области видимости, при котором подсказка переворачивается на противоположную сторону. По умолчанию `0`: переворот происходит, только если подсказка не помещается целиком.
Переворот наступает, когда подсказка, её зазор `offset` и `flipPadding` вместе не помещаются с выбранной стороны. Например, при `flipPadding: 60` подсказка над элементом перевернётся вниз, если сверху останется меньше 60 px свободного места.
Значение передаётся в middleware `flip` из Floating UI: число либо объект со сторонами `top`, `right`, `bottom`, `left`.
```js
createTooltip(document.querySelector('button'), 'Подсказка', {
flipPadding: 60,
});
```
Так же настраивается через data-атрибут:
```html
<button type="button" data-tooltip-flip-padding="60">Кнопка</button>
```
#### hideOnClick
- `true` (по умолчанию) — всплывающая подсказка скрывается при клике по любому элементу на странице (**кроме** самой всплывающей подсказки).
- `'all'` — всплывающая подсказка скрывается при клике по любому элементу на странице (**включая** саму всплывающую подсказку).
- `'toggle'` — всплывающая подсказка скрывается только при клике по элементу, который её вызывает.
Настройка работает только с `trigger`, включающим `click` или `manual`.
#### interactive
`true` (по умолчанию) — курсор можно перевести с элемента на подсказку и взаимодействовать с её содержимым. Невидимая зона перекрывает зазор `offset` между элементом и подсказкой, чтобы подсказка не скрылась по пути курсора.
`false` — подсказка скрывается сразу, как только курсор уходит с элемента.
#### offset
Зазор между элементом и подсказкой: `[поперёк основной оси, вдоль основной оси]`. Для `top` и `bottom` первое значение сдвигает подсказку по горизонтали, второе задаёт зазор по вертикали. По умолчанию `[0, 8]` — 8 px между элементом и подсказкой.
#### placement
Сторона размещения: `top`, `right`, `bottom`, `left`. Выравнивание задаётся суффиксом `-start` или `-end`, например `bottom-start`. Если места с выбранной стороны не хватает, подсказка переворачивается (см. `flipPadding`).
#### shiftPadding
Отступ от края области видимости, на который подсказка сдвигается вдоль оси, чтобы полностью поместиться на экране: `[по горизонтали, по вертикали]`. Для `top` и `bottom` работает по горизонтали, для `left` и `right` — по вертикали.
По умолчанию `[8, 0]`. Пример с отступом 12 px от краёв экрана на мобильных:
```js
createTooltip(document.querySelector('button'), 'Подсказка', {
shiftPadding: [12, 0],
});
```
#### theme
Тема оформления. Значение подставляется в класс `tooltip_theme_<theme>` — стили для каждой темы задаёт потребитель. По умолчанию `light`.
#### trigger
События, по которым показывается и скрывается подсказка: строка со списком через пробел. По умолчанию `mouseenter click`.
- `mouseenter` — по наведению курсора (только мышь);
- `click` — по клику;
- `focus` — по получению фокуса;
- `blur` — скрытие по потере фокуса;
- `manual` — без обработчиков: показ и скрытие только через `show()` и `hide()`.
```js
createTooltip(document.querySelector('button'), 'Подсказка', {
trigger: 'click',
});
```
#### virtualReference
Настройка используется для кастомного позиционирования, ожидает объект с методом `getBoundingClientRect`.
Например, позиционирование всплывающей подсказки относительно виртуального элемента размером 100&times;50, который располагается в левой верхней точке экрана:
```js
createTooltip(document.querySelector('button'), 'Подсказка', {
virtualReference: {
getBoundingClientRect() {
return {
x: 0,
y: 0,
top: 0,
left: 0,
bottom: 50,
right: 100,
width: 100,
height: 50,
};
},
},
});
```
#### zIndex
Значение для свойства `z-index` подсказки. По умолчанию пустая строка — `z-index` не задаётся, работает значение из CSS.
#### Колбэки
Каждый колбэк получает экземпляр подсказки (`instance` — то же, что `$el._tooltip`).
- `onCreate` — после создания экземпляра, до первого показа. Здесь уже доступны `show()` и `hide()`.
- `onMount` — при первом показе, после создания DOM подсказки и до её вставки в документ. Удобно для инициализации вложенных компонентов.
- `onShow` — после вставки в документ, перед анимацией появления.
- `onShown` — после анимации появления.
- `onHide` — перед анимацией скрытия.
- `onHidden` — после анимации скрытия, когда подсказка уже удалена из документа.
### Свойства
#### $tooltip
DOM-элемент всплывающей подсказки (имеет свойство `_reference` для доступа к элементу, на котором был вызван `createTooltip`)
#### options
Текущие настройки
#### isVisible
Видимость всплывающей подсказки - `true`/`false`
### Методы
#### show
```js
document.querySelector('button')._tooltip.show();
```
#### hide
```js
document.querySelector('button')._tooltip.hide();
```
#### setContent
```js
document.querySelector('button')._tooltip.setContent('Новая подсказка');
```
#### updateOptions
```js
document.querySelector('button')._tooltip.updateOptions({ placement: 'bottom' });
```
#### destroy
```js
document.querySelector('button')._tooltip.destroy();
```
### Стили
```scss
$b: '.tooltip';
#{$b} {
left: 0;
max-width: calc(100vw - 32px);
position: absolute;
top: 0;
width: max-content;
will-change: transform;
z-index: 200;
@media (min-width: 900px) {
max-width: 300px;
}
&__root {
}
&__arrow {
#{$b}_theme_light & {
background-color: white;
height: 8px;
width: 8px;
}
}
&__container {
#{$b}_theme_light & {
background-color: white;
box-shadow: 0 0 8px 0 rgba(0, 0, 0, 0.2);
}
}
}
```
+618
View File
@@ -0,0 +1,618 @@
const roundByDPR = (value) => {
const dpr = window.devicePixelRatio || 1;
return Math.round(value * dpr) / dpr;
};
const attributeToOption = (attribute) => {
const option = attribute.replace('tooltip', '');
return option.charAt(0).toLowerCase() + option.slice(1);
};
/*
Приводит опцию arrow к единому виду { active, centered, padding }.
Поддерживает булево значение для обратной совместимости: arrow: true/false
*/
const normalizeArrow = (arrow) => {
const defaults = { active: Boolean(arrow), centered: false, padding: undefined };
return typeof arrow === 'object' && arrow !== null ? { ...defaults, active: true, ...arrow } : defaults;
};
// Слушатель visibilitychange один на всю страницу
let visibilityListenerRegistered = false;
/*
Подсказки, оставшиеся открытыми при уходе со страницы, скрываются,
а их отложенный показ отменяется
*/
const handleVisibilityChange = () => {
if (document.hidden) {
for (const $tooltip of document.querySelectorAll('.tooltip')) {
const ref = $tooltip._reference;
if (ref?._tooltip) {
clearTimeout(ref._tooltip._showTimeout);
if (ref._tooltip.isVisible) {
ref._tooltip.hide({ immediately: true });
}
}
}
}
};
const templates = {
arrow: () => `
<div class="tooltip__arrow" style="pointer-events: none; position: absolute; transform: rotate(45deg);"></div>
`,
interactiveHelper: () => `
<div class="tooltip__interactive-helper" style="position: absolute; z-index: -1;"></div>
`,
};
export const createTooltip = ($el, initialContent, initialOptions) => {
let content = initialContent;
const options = {
animation: [
[{ opacity: 0 }, { opacity: 1 }],
[{ opacity: 1 }, { opacity: 0 }],
],
appendTo: document.body,
arrow: true,
delay: [0, 0],
duration: [0, 0],
easing: ['linear', 'linear'],
flipPadding: 0,
hideOnClick: true, // Возможные значения: true, 'all', 'toggle'
interactive: true,
offset: [0, 8],
placement: 'top',
shiftPadding: [8, 0],
theme: 'light',
trigger: 'mouseenter click',
virtualReference: undefined,
zIndex: '',
...initialOptions,
};
for (const [key, value] of Object.entries($el.dataset)) {
if (key.startsWith('tooltip')) {
let parsedValue = value;
try {
parsedValue = JSON.parse(value);
} catch {} // oxlint-disable-line no-empty
options[attributeToOption(key)] = parsedValue;
}
}
/*
Нормализуем arrow после применения data-атрибутов,
чтобы поддержать и объект, и булево значение
*/
options.arrow = normalizeArrow(options.arrow);
let rafId;
const listeners = [];
const registerListeners = () => {
for (const trigger of options.trigger.split(' ')) {
switch (trigger) {
case 'mouseenter': {
$el.addEventListener('pointerenter', $el._tooltip.mouseEnterListener);
listeners.push({ el: $el, event: 'pointerenter', listener: $el._tooltip.mouseEnterListener });
$el.addEventListener('pointerleave', $el._tooltip.mouseLeaveListener);
listeners.push({ el: $el, event: 'pointerleave', listener: $el._tooltip.mouseLeaveListener });
break;
}
case 'click': {
$el.addEventListener('click', $el._tooltip.clickListener);
listeners.push({ el: $el, event: 'click', listener: $el._tooltip.clickListener });
if (!options.interactive) {
$el.addEventListener('pointerleave', $el._tooltip.mouseLeaveListener);
listeners.push({ el: $el, event: 'pointerleave', listener: $el._tooltip.mouseLeaveListener });
}
break;
}
case 'focus': {
$el.addEventListener('focus', $el._tooltip.focusListener);
listeners.push({ el: $el, event: 'focus', listener: $el._tooltip.focusListener });
break;
}
case 'blur': {
$el.addEventListener('blur', $el._tooltip.blurListener);
listeners.push({ el: $el, event: 'blur', listener: $el._tooltip.blurListener });
break;
}
default: {
break;
}
}
}
};
// Проигрывает анимацию появления (0) или скрытия (1) на корне подсказки
const animateRoot = async (index, immediately) => {
try {
const animation = $el._tooltip.$tooltip.querySelector('.tooltip__root').animate(options.animation[index], {
duration: immediately ? 0 : options.duration[index],
easing: options.easing[index],
});
$el._tooltip._currentAnimation = animation;
await animation.finished;
} catch {} // oxlint-disable-line no-empty
};
// Добавляет стрелку, если она включена и ещё не создана
const mountArrow = () => {
if (options.arrow.active && !$el._tooltip.$arrow && $el._tooltip.$tooltip) {
$el._tooltip.$tooltip.querySelector('.tooltip__root').insertAdjacentHTML('afterbegin', templates.arrow());
$el._tooltip.$arrow = $el._tooltip.$tooltip.querySelector('.tooltip__arrow');
// Со стрелкой набор middleware другой
$el._tooltip._middleware = undefined;
}
};
// Удаляет стрелку из разметки
const unmountArrow = () => {
$el._tooltip.$arrow?.remove();
$el._tooltip.$arrow = undefined;
$el._tooltip._middleware = undefined;
};
$el._tooltip = {
options,
isVisible: false,
$tooltip: undefined,
$container: undefined,
$arrow: undefined,
$interactive: undefined,
// Кэши позиционирования
_side: undefined,
_middleware: undefined,
_showTimeout: undefined,
_hideTimeout: undefined,
_currentAnimation: undefined,
// Счётчик поколений show/hide: отменяет устаревшие асинхронные операции
_generation: 0,
/*
Заглушки до первого show(): настоящие функции создаются в show().
Нужны, чтобы вызовы из updateOptions/destroy не падали с ошибкой
*/
autoUpdateCleanup: () => {
// Переопределяется в show() после первого показа
},
updatePosition: () => {
// Переопределяется в show() после первого показа
},
setContent(updatedContent) {
if (updatedContent !== undefined) {
content = updatedContent;
}
if ($el._tooltip.$container) {
if (content instanceof HTMLElement) {
$el._tooltip.$container.innerHTML = '';
$el._tooltip.$container.append(content);
} else {
$el._tooltip.$container.innerHTML = content;
}
}
},
async updateOptions(updatedOptions = {}) {
for (const [name, value] of Object.entries(updatedOptions)) {
options[name] = value;
}
if (
updatedOptions.offset !== undefined ||
updatedOptions.flipPadding !== undefined ||
updatedOptions.shiftPadding !== undefined ||
updatedOptions.arrow !== undefined
) {
$el._tooltip._middleware = undefined;
}
if (
updatedOptions.placement !== undefined ||
updatedOptions.offset !== undefined ||
updatedOptions.interactive !== undefined
) {
$el._tooltip._side = undefined;
}
if (updatedOptions.arrow !== undefined) {
/*
Опция могла прийти булевым значением — приводим к единому виду.
Нормализуем всегда, даже если подсказка ещё не создана
*/
options.arrow = normalizeArrow(options.arrow);
if ($el._tooltip.$tooltip) {
if (options.arrow.active) {
mountArrow();
} else {
unmountArrow();
}
}
}
if (updatedOptions.interactive !== undefined) {
for (const { el, event, listener } of listeners) {
el.removeEventListener(event, listener);
}
listeners.length = 0;
registerListeners();
if ($el._tooltip.$tooltip) {
if (options.interactive) {
if (!$el._tooltip.$interactive) {
$el._tooltip.$tooltip
.querySelector('.tooltip__root')
.insertAdjacentHTML('afterbegin', templates.interactiveHelper());
$el._tooltip.$interactive =
$el._tooltip.$tooltip.querySelector('.tooltip__interactive-helper');
}
} else {
$el._tooltip.$interactive?.remove();
$el._tooltip.$interactive = undefined;
}
}
}
if (updatedOptions.theme !== undefined && $el._tooltip.$tooltip) {
const themeClass = [...$el._tooltip.$tooltip.classList].find((className) =>
className.startsWith('tooltip_theme_'),
);
if (themeClass) {
$el._tooltip.$tooltip.classList.remove(themeClass);
}
$el._tooltip.$tooltip.classList.add(`tooltip_theme_${options.theme}`);
}
if (updatedOptions.zIndex !== undefined && $el._tooltip.$tooltip) {
Object.assign($el._tooltip.$tooltip.style, { zIndex: options.zIndex });
}
if ($el._tooltip.$tooltip) {
await $el._tooltip.updatePosition();
}
},
destroy() {
if (!$el._tooltip) {
return;
}
clearTimeout($el._tooltip._showTimeout);
clearTimeout($el._tooltip._hideTimeout);
$el._tooltip._currentAnimation?.cancel();
cancelAnimationFrame(rafId);
$el._tooltip.$tooltip?.remove();
// autoUpdateCleanup нужен только для показанной подсказки
if ($el._tooltip.isVisible) {
$el._tooltip.autoUpdateCleanup();
}
for (const { el, event, listener } of listeners) {
el.removeEventListener(event, listener);
}
listeners.length = 0;
document.body.removeEventListener('click', $el._tooltip.hideOnClickListener);
delete $el._tooltip;
},
};
$el._tooltip.show = async ({ immediately } = {}) => {
clearTimeout($el._tooltip._hideTimeout);
clearTimeout($el._tooltip._showTimeout);
$el._tooltip._generation += 1;
const generation = $el._tooltip._generation;
const { computePosition, autoUpdate, offset, flip, shift, arrow } = await import('@floating-ui/dom');
if (generation !== $el._tooltip._generation) {
return;
}
if (!$el._tooltip.$tooltip) {
$el._tooltip.$tooltip = document.createElement('div');
$el._tooltip.$tooltip._reference = $el;
$el._tooltip.$tooltip.classList.add('tooltip', `tooltip_theme_${options.theme}`);
Object.assign($el._tooltip.$tooltip.style, { zIndex: options.zIndex });
$el._tooltip.$tooltip.innerHTML = `
<div class="tooltip__root">
${options.interactive ? templates.interactiveHelper() : ''}
<div class="tooltip__container"></div>
</div>
`;
$el._tooltip.$container = $el._tooltip.$tooltip.querySelector('.tooltip__container');
$el._tooltip.$interactive = $el._tooltip.$tooltip.querySelector('.tooltip__interactive-helper');
$el._tooltip.setContent();
mountArrow();
const buildMiddleware = () => {
const arrowSize = $el._tooltip.$arrow?.offsetWidth ?? 0;
return [
offset({ mainAxis: options.offset[1], crossAxis: options.offset[0] }),
flip({ padding: options.flipPadding }),
shift({
padding: {
top: options.shiftPadding[1],
right: options.shiftPadding[0],
bottom: options.shiftPadding[1],
left: options.shiftPadding[0],
},
}),
arrow({
element: $el._tooltip.$arrow,
/*
Отступ стрелки от краёв подсказки. По умолчанию считаем из размера стрелки:
квадрат со стороной size, повёрнутый на 45°, выступает за свою рамку
на (√2 − 1) / 2 · size — это не даёт его углам вылезать за границы.
Можно задать вручную через arrow.padding
*/
padding: options.arrow.padding ?? Math.ceil(((Math.SQRT2 - 1) / 2) * arrowSize),
}),
];
};
$el._tooltip.updatePosition = () => {
cancelAnimationFrame(rafId);
rafId = requestAnimationFrame(async () => {
/*
Все чтения геометрии делаем до первой записи стилей, иначе браузер
вынужден делать принудительный reflow на каждом кадре прокрутки
*/
const tooltipWidth = $el._tooltip.$tooltip.offsetWidth;
const tooltipHeight = $el._tooltip.$tooltip.offsetHeight;
const arrowWidth = $el._tooltip.$arrow?.offsetWidth ?? 0;
const arrowHeight = $el._tooltip.$arrow?.offsetHeight ?? 0;
const { x, y, placement, middlewareData } = await computePosition(
options.virtualReference ?? $el,
$el._tooltip.$tooltip,
{
placement: options.placement,
middleware: ($el._tooltip._middleware ??= buildMiddleware()),
},
);
Object.assign($el._tooltip.$tooltip.style, {
transform: `translate(${roundByDPR(x)}px, ${roundByDPR(y)}px)`,
});
const side = placement.split('-')[0];
const staticSide = { top: 'bottom', right: 'left', bottom: 'top', left: 'right' }[side];
// Стили стороны применяем только при её смене
if (side !== $el._tooltip._side) {
$el._tooltip._side = side;
$el._tooltip.$tooltip.classList.remove(
'tooltip_side_top',
'tooltip_side_bottom',
'tooltip_side_left',
'tooltip_side_right',
);
$el._tooltip.$tooltip.classList.add(`tooltip_side_${side}`);
if ($el._tooltip.$interactive) {
Object.assign($el._tooltip.$interactive.style, {
width: side === 'left' || side === 'right' ? `${options.offset[1]}px` : '100%',
height: side === 'top' || side === 'bottom' ? `${options.offset[1]}px` : '100%',
[staticSide]: `-${options.offset[1]}px`,
});
}
}
if ($el._tooltip.$arrow && middlewareData.arrow) {
const { $arrow } = $el._tooltip;
let { x, y } = middlewareData.arrow;
/*
centered: фиксируем стрелку по центру подсказки, чтобы она не смещалась
вслед за опорным элементом при прокрутке (например, когда подсказка
прижата к краю экрана). Ось центрирования зависит от стороны:
для left/right — вертикаль, для top/bottom — горизонталь
*/
if (options.arrow.centered) {
if (side === 'left' || side === 'right') {
y = (tooltipHeight - arrowHeight) / 2;
} else {
x = (tooltipWidth - arrowWidth) / 2;
}
}
Object.assign($arrow.style, {
left: x === undefined ? '' : `${x}px`,
top: y === undefined ? '' : `${y}px`,
[staticSide]: `-${arrowWidth / 2}px`,
});
}
});
};
if (options.onMount) {
options.onMount($el._tooltip);
}
}
$el._tooltip._showTimeout = setTimeout(
async () => {
if (generation !== $el._tooltip._generation) {
return;
}
const isMouseEnterTrigger = options.trigger.includes('mouseenter');
const isHovering = $el.matches(':hover');
// За время задержки состояние могло измениться
if (
!$el._tooltip ||
$el._tooltip.isVisible ||
(isMouseEnterTrigger && !isHovering) ||
document.hidden
) {
return;
}
(options.appendTo === 'parent' ? $el.parentElement : options.appendTo).append($el._tooltip.$tooltip);
$el._tooltip.isVisible = true;
$el._tooltip.autoUpdateCleanup = autoUpdate(
options.virtualReference ?? $el,
$el._tooltip.$tooltip,
$el._tooltip.updatePosition,
);
if (options.hideOnClick && (options.trigger.includes('click') || options.trigger.includes('manual'))) {
document.body.addEventListener('click', $el._tooltip.hideOnClickListener);
}
if (options.onShow) {
options.onShow($el._tooltip);
}
await animateRoot(0, immediately);
if (generation !== $el._tooltip._generation) {
return;
}
if (options.onShown) {
options.onShown($el._tooltip);
}
},
immediately ? 0 : options.delay[0],
);
};
$el._tooltip.hide = ({ immediately } = {}) => {
clearTimeout($el._tooltip._showTimeout);
$el._tooltip._generation += 1;
const generation = $el._tooltip._generation;
$el._tooltip._hideTimeout = setTimeout(
async () => {
if (generation !== $el._tooltip._generation) {
return;
}
// Подсказку могли удалить или скрыть за время задержки
if (!$el._tooltip || !$el._tooltip.isVisible) {
return;
}
if (options.onHide) {
options.onHide($el._tooltip);
}
document.body.removeEventListener('click', $el._tooltip.hideOnClickListener);
await animateRoot(1, immediately);
// Пока шла анимация, подсказку могли скрыть повторно или удалить
if (generation !== $el._tooltip._generation || !$el._tooltip) {
return;
}
if ($el._tooltip.$tooltip) {
$el._tooltip.$tooltip.remove();
}
$el._tooltip.isVisible = false;
$el._tooltip.autoUpdateCleanup();
if (options.onHidden) {
options.onHidden($el._tooltip);
}
},
immediately ? 0 : options.delay[1],
);
};
$el._tooltip.hideOnClickListener = ({ target }) => {
if (!$el._tooltip.isVisible) {
return;
}
if (options.hideOnClick === 'all') {
$el._tooltip.hide();
} else if (options.hideOnClick === 'toggle') {
if ($el.contains(target)) {
$el._tooltip.hide();
}
} else {
// options.hideOnClick === true
if ($el.contains(target) || !$el._tooltip.$tooltip.contains(target)) {
$el._tooltip.hide();
}
}
};
$el._tooltip.clickListener = () => {
if (document.hidden) {
return;
}
if (!$el._tooltip.isVisible) {
$el._tooltip.show();
}
};
$el._tooltip.mouseEnterListener = (event) => {
if (event.pointerType !== 'mouse' || document.hidden) {
return;
}
$el._tooltip.show();
};
$el._tooltip.mouseLeaveListener = (event) => {
if (event.pointerType !== 'mouse') {
return;
}
if (options.interactive && event.relatedTarget && $el._tooltip.$tooltip?.contains(event.relatedTarget)) {
$el._tooltip.$tooltip.addEventListener(
'pointerleave',
(event) => {
if (event.pointerType !== 'mouse') {
return;
}
if (!event.relatedTarget || !$el.contains(event.relatedTarget)) {
$el._tooltip.hide();
}
},
{ once: true },
);
} else {
$el._tooltip.hide();
}
};
$el._tooltip.focusListener = () => {
if (document.hidden) {
return;
}
$el._tooltip.show();
};
$el._tooltip.blurListener = () => {
$el._tooltip.hide();
};
registerListeners();
if (!visibilityListenerRegistered) {
document.addEventListener('visibilitychange', handleVisibilityChange);
visibilityListenerRegistered = true;
}
// Вызываем onCreate в конце, когда все методы и слушатели уже инициализированы
if (options.onCreate) {
options.onCreate($el._tooltip);
}
};
@@ -1,6 +1,6 @@
{
"name": "@advdominion/babel-plugin-nunjucks",
"version": "4.0.0",
"name": "@advdominion/tooltip",
"version": "7.2.0",
"type": "module",
"main": "index.js",
"repository": {
@@ -12,7 +12,6 @@
"access": "public"
},
"peerDependencies": {
"@babel/core": "^8.0.0",
"nunjucks": "^3.0.0"
"@floating-ui/dom": "^1.0.0"
}
}
+304 -4447
View File
File diff suppressed because it is too large. Load diff