[{"data":1,"prerenderedAt":206},["ShallowReactive",2],{"journal-all":3,"journal-post-custom-element-uhodit-type-script-prihodit":202},[4,14,23,32,41,50,59,68,77,86,95,104,113,122,131,140,149,158,167,175,184,193],{"id":5,"documentId":6,"title":7,"slug":8,"author":9,"displayDate":10,"publishedAt":11,"tags":12,"excerpt":13},128,"ejmfhc9x77pq7i6lk8uri7vz","Хорошие платформеры прощают маленькие ошибки","horoshie-platformery-proshhayut-malenkie-oshibki-igroka","Maxim","2026-10-08","2026-10-12T14:22:54.799Z",[],"Игрок нажал кнопку прыжка у самого края платформы, а персонаж вместо прыжка падает вниз. Или нажал прыжок чуть раньше приземления, и прыжок не…",{"id":15,"documentId":16,"title":17,"slug":18,"author":9,"displayDate":19,"publishedAt":20,"tags":21,"excerpt":22},151,"cpt6fex3mcb2pk2rwxrqlvl0","Что может локальный coding-agent на 16 GB VRAM","chto-mozhet-lokalnyj-coding-agent-na-16-gb-vram-1","2026-10-03","2026-10-22T07:06:46.248Z",[],"Обычно в работе с кодом я использую frontier-модели. Для разработки у меня достаточно мощный ПК, но специально под запуск локальных моделей я его не…",{"id":24,"documentId":25,"title":26,"slug":27,"author":9,"displayDate":28,"publishedAt":29,"tags":30,"excerpt":31},132,"pg9d6k0p2ggrjlpwnp0vmfhu","Публичный контракт вместо внутренних формул в typographics 5","publichnyj-kontrakt-vmesto-vnutrennih-formul-v-typographics-5","2026-09-03","2026-10-20T09:34:40.187Z",[],"Выпустил typographics@5.0.0. Изменение в самом CSS небольшое: блоки кода теперь по умолчанию используют ту же плавную базу, что и основной текст…",{"id":33,"documentId":34,"title":35,"slug":36,"author":9,"displayDate":37,"publishedAt":38,"tags":39,"excerpt":40},154,"bfbbuk4w3a8878alj8u8tjk7","Получить готовое решение и иметь основания ему доверять — разные вещи","poluchit-gotovoe-reshenie-i-imet-osnovaniya-emu-doveryat-raznye-veshhi","2026-08-22","2026-11-07T12:53:47.007Z",[],"Допустим, нужен поиск по каталогу. Поле ввода, запрос к серверу, список результатов. Поручаем это нейросети, получаем компонент, запускаем. Вводим…",{"id":42,"documentId":43,"title":44,"slug":45,"author":9,"displayDate":46,"publishedAt":47,"tags":48,"excerpt":49},133,"rrs7fbiul9xgn1lqvzvfkv40","Кэш не должен ломать загрузку спрайта","kesh-ne-dolzhen-lomat-zagruzku-sprajta","2026-08-11","2026-10-20T09:35:09.405Z",[],"В iconly 5.0.0 почти не добавил новых возможностей. Разобрал поведение библиотеки в нескольких ситуациях: хранилище недоступно, в кэше лежит плохой…",{"id":51,"documentId":52,"title":53,"slug":54,"author":9,"displayDate":55,"publishedAt":56,"tags":57,"excerpt":58},134,"v415k9na7rfuvuwadzaux2fq","playbackRate не вывозит","playback-rate-ne-vyvozit","2026-08-08","2026-10-20T09:35:39.760Z",[],"В mode=\"scroll\" лента должна ускоряться вместе со страницей и сохранять инерцию, когда прокрутка уже остановилась. После перехода на Web Animations…",{"id":60,"documentId":61,"title":62,"slug":63,"author":9,"displayDate":64,"publishedAt":65,"tags":66,"excerpt":67},131,"ashjhdkt56ram23r40w9vx7e","Два пути к SVG-спрайту в Iconly","dva-puti-k-svg-sprajtu-v-iconly","2026-07-11","2026-10-20T09:27:58.489Z",[],"В 3.0 у iconly появился довольно понятный контракт загрузки: при вызове init() загрузчик проверяет кэш, при необходимости получает внешний SVG-файл и…",{"id":69,"documentId":70,"title":71,"slug":72,"author":9,"displayDate":73,"publishedAt":74,"tags":75,"excerpt":76},135,"jesxp2we692xubc1lvx26tvm","Полируем clicktone","poliruem-clicktone","2026-07-03","2026-10-20T09:37:04.432Z",[],"После изменений в Web Audio поведение clicktone меня устраивает гораздо больше, чем инфраструктура вокруг пакета. Здесь есть неприятный класс ошибок…",{"id":78,"documentId":79,"title":80,"slug":81,"author":9,"displayDate":82,"publishedAt":83,"tags":84,"excerpt":85},136,"zz71n3thhwzglwwguq7j23sf","Vue поверх DOM-контроллера, а не вместо него","vue-poverh-dom-kontrollera-a-ne-vmesto-nego","2026-06-08","2026-10-20T09:37:48.997Z",[],"После 2.0.0 DOM API DialogLite позволяет передать готовый элемент или селектор, настроить закрытие, фокус и прокрутку, а затем явно уничтожить…",{"id":87,"documentId":88,"title":89,"slug":90,"author":9,"displayDate":91,"publishedAt":92,"tags":93,"excerpt":94},137,"gnxwj8ybwrbrexf3hhmg3cwj","Один AudioContext для всех звуков","odin-audio-context-dlya-vseh-zvukov","2026-06-03","2026-10-20T09:38:16.966Z",[],"В игре HopperGame звук перестал быть разовым эффектом, который можно включить и забыть. Один звук должен идти циклически, пока персонаж находится в…",{"id":96,"documentId":97,"title":98,"slug":99,"author":9,"displayDate":100,"publishedAt":101,"tags":102,"excerpt":103},149,"tb0zyd0dkyux359m1ekxjfqk","Стенограмма YouTube-видео локально на Windows через yt-dlp и Whisper от OpenAI","stenogramma-you-tube-video-lokalno-na-windows-cherez-yt-dlp-i-whisper-ot-open-ai","2026-03-17","2026-10-21T12:32:22.911Z",[],"Понадобилось получить обычный текст из YouTube-видео. Встроенная стенограмма есть не у каждого ролика, поэтому решил сделать всё локально: скачать…",{"id":105,"documentId":106,"title":107,"slug":108,"author":9,"displayDate":109,"publishedAt":110,"tags":111,"excerpt":112},138,"kcybzkzc77id357qven9oau2","Делаем API Iconly предсказуемым","delaem-api-iconly-predskazuemym","2026-01-25","2026-10-20T09:39:22.402Z",[],"В 2.0 в основном приводил в порядок внутреннее устройство iconly, сохраняя прежний способ использования. В 3.0 занялся публичным API. Я хотел, чтобы…",{"id":114,"documentId":115,"title":116,"slug":117,"author":9,"displayDate":118,"publishedAt":119,"tags":120,"excerpt":121},139,"x43svzw5tuasmmygpugo9ijk","Жёсткий DOM-контракт начал мешать","zhyostkij-dom-kontrakt-nachal-meshat","2025-12-16","2026-10-20T09:40:16.527Z",[],"В версии 1.5.1 у DialogLite был удобный, но довольно жёсткий договор с разметкой. Контроллер искал первый .dialog-lite, знал про #main-content…",{"id":123,"documentId":124,"title":125,"slug":126,"author":9,"displayDate":127,"publishedAt":128,"tags":129,"excerpt":130},140,"cvonqqvil2tn4fmgaiabss76","Две плавные шкалы вместо корня 10px","dve-plavnye-shkaly-vmesto-kornya-10px","2025-11-04","2026-10-20T09:41:13.937Z",[],"Выпустил typographics@3.0.0. Перед стабильным релизом обкатал новую мажорную версию в реальных проектах. Главное изменение оказалось не в новой…",{"id":132,"documentId":133,"title":134,"slug":135,"author":9,"displayDate":136,"publishedAt":137,"tags":138,"excerpt":139},141,"pvwfuo4kzfsvxwf7rz8tccbj","Вертикальный ритм на lh в typographics","vertikalnyj-ritm-na-lh-v-typographics","2025-09-20","2026-10-20T09:42:09.920Z",[],"Выпустил typographics@2.4.7. За последние две недели пакет заметно разросся вокруг довольно простой проблемы: на реальной странице одной шкалы…",{"id":141,"documentId":142,"title":143,"slug":144,"author":9,"displayDate":145,"publishedAt":146,"tags":147,"excerpt":148},142,"rn9rvxezqx4f3ivdrc6voh0s","Один play() для звука в мини-играх","odin-play-dlya-zvuka-v-mini-igrah","2025-04-17","2026-10-20T09:42:53.018Z",[],"В небольших промо-играх звук обычно нужен как отклик на действие пользователя, например нажатие кнопки. За таким эффектом быстро появляется…",{"id":150,"documentId":151,"title":152,"slug":153,"author":9,"displayDate":154,"publishedAt":155,"tags":156,"excerpt":157},143,"t5o8wrsruzuu542084uuz63y","Дорабатываю Iconly изнутри","dorabatyvayu-iconly-iznutri","2025-03-10","2026-10-20T09:43:35.331Z",[],"В 2.0.0 способ использования Iconly почти не изменился. Я пересмотрел внутреннюю реализацию: поиск контейнера, вставку SVG в DOM, обработку ошибок и…",{"id":159,"documentId":160,"title":161,"slug":162,"author":9,"displayDate":163,"publishedAt":164,"tags":165,"excerpt":166},144,"r0jxt6a2huml847j89tiyxrk","Расстаёмся с Custom Element","custom-element-uhodit-type-script-prihodit","2025-03-09","2026-10-20T09:44:47.700Z",[],"Custom Element давал marquee-content готовые методы жизненного цикла. Проблема появилась при интеграции с фреймворком: одним DOM-узлом одновременно…",{"id":168,"documentId":169,"title":170,"slug":171,"author":9,"displayDate":163,"publishedAt":172,"tags":173,"excerpt":174},145,"tkj2cgfjisq0rr061p90eusp","Один контроллер вместо диалогов под каждый проект","odin-kontroller-vmesto-dialogov-pod-kazhdyj-proekt","2026-10-20T09:45:24.409Z",[],"В разных проектах я снова и снова делал примерно одно и то же: находил контейнер диалога, открывал его, закрывал по кнопке или фону, переключал…",{"id":176,"documentId":177,"title":178,"slug":179,"author":9,"displayDate":180,"publishedAt":181,"tags":182,"excerpt":183},146,"ttv07xomzxiijk85sdob4rlx","SVG-спрайт в localStorage","svg-sprajt-v-local-storage","2024-06-02","2026-10-20T09:45:52.655Z",[],"Кэшировать SVG-спрайт в браузере сначала кажется задачей на несколько строк. Получил файл, положил строку в localStorage, при следующем запуске…",{"id":185,"documentId":186,"title":187,"slug":188,"author":9,"displayDate":189,"publishedAt":190,"tags":191,"excerpt":192},147,"ewuzaa0hw5kfc6gzqph0k67u","Бесконечная анимация, конечный жизненный цикл","beskonechnaya-animacziya-konechnyj-zhiznennyj-czikl","2023-10-31","2026-10-20T09:46:16.781Z",[],"Бесконечная анимация — нормальное поведение для бегущей строки. Бесконечные обработчики и наблюдатели — нет. При ручных проверках заметил, что…",{"id":194,"documentId":195,"title":196,"slug":197,"author":9,"displayDate":198,"publishedAt":199,"tags":200,"excerpt":201},148,"n9v8botqj54tx61u0jahrprs","Бегущая строка за четыре дня","begushhaya-stroka-za-chetyre-dnya","2023-03-24","2026-10-20T09:47:13.002Z",[],"Бегущая строка выглядит почти оскорбительно простой задачей — положить элементы в ряд, сдвигать их влево или вправо и повторять всё сначала. Примерно…",{"id":159,"documentId":160,"title":161,"content":203,"slug":162,"author":9,"displayDate":163,"publishedAt":164,"tags":204,"html":205},"Custom Element давал `marquee-content` готовые методы жизненного цикла. Проблема появилась при интеграции с фреймворком: одним DOM-узлом одновременно управляли и браузер и приложение.\n\nК версии 4 я хотел управлять инициализацией явно. Заодно накопились задачи по типам, форматам сборки и устройству npm-пакета. В результате один архитектурный переход растянулся на несколько релизов, а TypeScript пришлось внедрять дважды. С первого раза он формально появился, но ещё не помогал.\n\n## Последний Custom Element\n\nВ версии `3.1.1` библиотека всё ещё экспортировала класс, унаследованный от `HTMLElement`:\n\n```js\nconnectedCallback() {\n  this.init();\n}\n\ndisconnectedCallback() {\n  this.destroy();\n}\n```\n\nПользователь добавлял в разметку тег компонента, а браузер вызывал `connectedCallback()`. При удалении элемента `disconnectedCallback()` вызывал `destroy()`: текущий Tween останавливался, `this.af` отменялся, а `ResizeObserver` отключался. Очистка оставалась неполной. Отложенный кадр внутри debounce и контексты `matchMedia` не отменялись, а после повторного подключения наблюдение не возобновлялось.\n\nДля изолированного компонента такая схема удобна. Во фреймворке появляется второй жизненный цикл: приложение управляет компонентом страницы, браузер — Custom Element внутри него. Инициализацию и очистку приходится согласовывать между ними.\n\nМне требовались три вещи:\n\n- принимать уже существующий DOM-элемент, а не требовать специальный тег;\n- явно запускать и останавливать анимацию вместе с компонентом приложения;\n- сократить количество неявного поведения внутри библиотеки.\n\nПоэтому в `4.0.0` `MarqueeContent` перестал наследоваться от `HTMLElement`, а управление инициализацией и очисткой перешло к вызывающему коду.\n\n## Обычный класс и явные init() \u002F destroy()\n\nДля бегущей строки больше не нужен специальный тег:\n\n```html\n\u003Cdiv\n  class=\"marquee\"\n  data-mc-speed=\"20\"\n  data-mc-direction=\"auto\"\n>\n  \u003Cdiv class=\"marquee-group\">\n    \u003Cspan>Primary\u003C\u002Fspan>\n    \u003Cspan>Secondary\u003C\u002Fspan>\n    \u003Cspan>Tertiary\u003C\u002Fspan>\n  \u003C\u002Fdiv>\n\u003C\u002Fdiv>\n```\n\nВместо регистрации HTML-тега нужно создать экземпляр класса и вызвать `init()`. В примере используется объект настроек, появившийся в `4.1.0`:\n\n```js\nconst marquee = new MarqueeContent({\n  element: '.marquee',\n});\n\nmarquee.init();\n```\n\nПри размонтировании компонента нужно вызвать:\n\n```js\nmarquee.destroy();\n```\n\nВ `4.0.0` API принимал элемент или селектор напрямую. Вызов с объектом `{ element }` немного длиннее, зато его проще расширять, не добавляя позиционные аргументы.\n\nВ версиях `4.1.0`–`4.5.0` включительно отсутствующий элемент приводил к раннему выходу из конструктора и оставлял частично созданный экземпляр. В `4.6.0` форма `{ element }` сохранилась, но ошибка снова стала явной: конструктор бросает `Target element not found`.\n\nЯвные `init()` и `destroy()` можно привязать к монтированию и размонтированию компонента во фреймворке. Удаление DOM-узла само по себе больше не запускает очистку, поэтому `destroy()` должен вызвать пользователь. Без этого `ResizeObserver` и ScrollTrigger продолжат жить после удаления элемента.\n\nОчистка в `4.6.0` тоже остаётся неполной: отложенный кадр debounce и контексты `matchMedia` не отменяются, а повторный `init()` после `destroy()` не возобновляет наблюдение за размерами.\n\n## Зависимости нужно передавать полностью\n\nВ ранней реализации четвёртой версии GSAP регистрировался через статический метод, но `ScrollTrigger.refresh()` всё ещё вызывался через глобальный `ScrollTrigger`. Модульный API получился не до конца модульным.\n\nВ `4.2.0` регистрация стала явной для обеих зависимостей:\n\n```js\ngsap.registerPlugin(ScrollTrigger);\nMarqueeContent.registerGSAP(gsap, ScrollTrigger);\n```\n\nМетод `registerGSAP()` сохранял обе ссылки, поэтому при вызове `refresh()` больше не требовался глобальный `ScrollTrigger`. Регистрация плагина в самом GSAP оставалась отдельной операцией. В `4.6.0` импортированные GSAP и ScrollTrigger уже служат значениями по умолчанию, а статический метод позволяет их переопределить.\n\nВ пакетах такие детали важнее, чем в коде одной страницы. Приложение может рассчитывать на глобальный объект, потому что само контролирует порядок скриптов. Библиотека не должна молча предполагать, что нужное имя уже существует в `window`.\n\n## Первая попытка TypeScript\n\nПо `4.2.0` включительно исходники оставались на JavaScript и собирались с помощью Parcel. В версии `4.3.0` основной файл перевёл на TypeScript и добавил `tsconfig.json`.\n\nНа уровне списка файлов задача выглядела выполненной. На уровне публичного API — ещё нет.\n\nПараметры регистрации GSAP и часть полей получили тип `never`:\n\n```ts\nstatic registerGSAP(gsap: never, ScrollTrigger: never): void;\n```\n\nТакой тип утверждает, что допустимого значения не существует. JavaScript-код ожидал GSAP и ScrollTrigger, но декларация не могла выразить этот контракт. Типы были в npm-пакете, однако использовать их по назначению было трудно.\n\nЭто хороший пример разницы между \"код переписан на TypeScript\" и \"у библиотеки появился типизированный API\". Компилятор проверяет только ту модель, которую ему дали. Если на границе стоят `never` или безразмерный `any`, наличие `.ts` ещё ничего не гарантирует пользователю.\n\n## Duration переименован в speed\n\nВ версии `4.4.0` заменил атрибут `data-mc-duration` на `data-mc-speed`:\n\n```html\n\u003Cdiv class=\"marquee\" data-mc-speed=\"20\">\n  \u003C!-- элементы ленты -->\n\u003C\u002Fdiv>\n```\n\nМатематика анимации при этом не изменилась. Значение по-прежнему передавалось в GSAP как `duration`:\n\n```js\ntimeline.to(element.children, {\n  duration: speed,\n  x: '-100%',\n});\n```\n\nПоэтому при положительных значениях `speed` меньшее число означало более быструю анимацию, большее — более медленную. `speed` здесь был пользовательской настройкой темпа, а не физической скоростью в пикселях в секунду. Имя стало короче, но семантика осталась обратной привычной скорости.\n\nДля HTML это было несовместимое изменение: старый `data-mc-duration` библиотека больше не читала. Переименование публичного атрибута оказалось заметнее, чем переход исходников на TypeScript.\n\n## Шаг назад без маскировки\n\nВ `4.5.0` убрал TypeScript вместе с декларациями, а инкапсуляция переехала на нативные приватные поля JavaScript:\n\n```js\nclass MarqueeContent {\n  #element;\n  #timeline;\n  #resizeObserver;\n}\n```\n\nМожно было оставить первую миграцию, но пользы от неё немного. Плохие типы не становятся хорошими от того, что дольше лежат в пакете.\n\nВозврат к JavaScript был промежуточным состоянием. Публичный API не изменился: `{ element }`, `init()`, `destroy()` и `registerGSAP()` продолжили работать как раньше.\n\n## TypeScript со второй попытки\n\nК версии `4.6.0` я вернул TypeScript, но начал с границы пакета. В декларации появились реальные типы GSAP и ScrollTrigger, а `element` описан как строковый селектор или `HTMLElement`.\n\n```ts\ntype MarqueeContentOptions = {\n  element?: string | HTMLElement;\n};\n```\n\nТеперь типы соответствуют способу использования библиотеки, а не просто факту существования TypeScript-файла.\n\nОдновременно сборка переехала с Parcel на Vite в режиме сборки библиотек. Пакет начал публиковать три формата:\n\n```json\n{\n  \"main\": \"dist\u002Findex.cjs.js\",\n  \"module\": \"dist\u002Findex.es.js\",\n  \"browser\": \".\u002Fdist\u002Findex.umd.js\",\n  \"types\": \"dist\u002Findex.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"require\": \".\u002Fdist\u002Findex.cjs.js\",\n      \"import\": \".\u002Fdist\u002Findex.es.js\",\n      \"default\": \".\u002Fdist\u002Findex.umd.js\"\n    }\n  }\n}\n```\n\nCommonJS доступен через `require`, ESM — через `import`, UMD — для прямого браузерного подключения. `types` указывает на декларацию, а `exports` задаёт явные точки входа вместо надежды на догадки сборщика.\n\nVite оставляет `gsap` и `gsap\u002FScrollTrigger` внешними модулями, поэтому в сборку `marquee-content` не встраивается собственная копия GSAP. Пользователю по-прежнему нужно установить и зарегистрировать зависимость.\n\n## Материалы\n\n- [MDN: Using custom elements](https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FWeb_components\u002FUsing_custom_elements)\n- [TypeScript: Declaration Files](https:\u002F\u002Fwww.typescriptlang.org\u002Fdocs\u002Fhandbook\u002Fdeclaration-files\u002Fintroduction.html)\n- [Vite: Library Mode](https:\u002F\u002Fvite.dev\u002Fguide\u002Fbuild.html#library-mode)\n- [Node.js: Package entry points](https:\u002F\u002Fnodejs.org\u002Fapi\u002Fpackages.html#package-entry-points)\n- [GSAP: Install](https:\u002F\u002Fgsap.com\u002Fdocs\u002Fv3\u002FInstallation\u002F)",[],"\u003Cp class=\"body-large\">Custom Element давал \u003Ccode>marquee-content\u003C\u002Fcode> готовые методы жизненного цикла. Проблема появилась при интеграции с фреймворком: одним DOM-узлом одновременно управляли и браузер и приложение.\u003C\u002Fp>\n\u003Cp class=\"body-large\">К версии 4 я хотел управлять инициализацией явно. Заодно накопились задачи по типам, форматам сборки и устройству npm-пакета. В результате один архитектурный переход растянулся на несколько релизов, а TypeScript пришлось внедрять дважды. С первого раза он формально появился, но ещё не помогал.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Последний Custom Element\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В версии \u003Ccode>3.1.1\u003C\u002Fcode> библиотека всё ещё экспортировала класс, унаследованный от \u003Ccode>HTMLElement\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">connectedCallback\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">() {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">init\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">disconnectedCallback\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">() {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">destroy\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Пользователь добавлял в разметку тег компонента, а браузер вызывал \u003Ccode>connectedCallback()\u003C\u002Fcode>. При удалении элемента \u003Ccode>disconnectedCallback()\u003C\u002Fcode> вызывал \u003Ccode>destroy()\u003C\u002Fcode>: текущий Tween останавливался, \u003Ccode>this.af\u003C\u002Fcode> отменялся, а \u003Ccode>ResizeObserver\u003C\u002Fcode> отключался. Очистка оставалась неполной. Отложенный кадр внутри debounce и контексты \u003Ccode>matchMedia\u003C\u002Fcode> не отменялись, а после повторного подключения наблюдение не возобновлялось.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Для изолированного компонента такая схема удобна. Во фреймворке появляется второй жизненный цикл: приложение управляет компонентом страницы, браузер — Custom Element внутри него. Инициализацию и очистку приходится согласовывать между ними.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Мне требовались три вещи:\u003C\u002Fp>\n\u003Cul class=\"list-large\">\n\u003Cli>принимать уже существующий DOM-элемент, а не требовать специальный тег;\u003C\u002Fli>\n\u003Cli>явно запускать и останавливать анимацию вместе с компонентом приложения;\u003C\u002Fli>\n\u003Cli>сократить количество неявного поведения внутри библиотеки.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp class=\"body-large\">Поэтому в \u003Ccode>4.0.0\u003C\u002Fcode> \u003Ccode>MarqueeContent\u003C\u002Fcode> перестал наследоваться от \u003Ccode>HTMLElement\u003C\u002Fcode>, а управление инициализацией и очисткой перешло к вызывающему коду.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Обычный класс и явные init() \u002F destroy()\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Для бегущей строки больше не нужен специальный тег:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">div\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  class\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"marquee\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  data-mc-speed\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"20\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  data-mc-direction\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"auto\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  &#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">div\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> class\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"marquee-group\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    &#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">span\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>Primary&#x3C;\u002F\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">span\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    &#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">span\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>Secondary&#x3C;\u002F\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">span\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    &#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">span\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>Tertiary&#x3C;\u002F\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">span\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  &#x3C;\u002F\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">div\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u002F\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">div\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Вместо регистрации HTML-тега нужно создать экземпляр класса и вызвать \u003Ccode>init()\u003C\u002Fcode>. В примере используется объект настроек, появившийся в \u003Ccode>4.1.0\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> marquee\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> MarqueeContent\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  element: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'.marquee'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">marquee.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">init\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">При размонтировании компонента нужно вызвать:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">marquee.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">destroy\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">В \u003Ccode>4.0.0\u003C\u002Fcode> API принимал элемент или селектор напрямую. Вызов с объектом \u003Ccode>{ element }\u003C\u002Fcode> немного длиннее, зато его проще расширять, не добавляя позиционные аргументы.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В версиях \u003Ccode>4.1.0\u003C\u002Fcode>–\u003Ccode>4.5.0\u003C\u002Fcode> включительно отсутствующий элемент приводил к раннему выходу из конструктора и оставлял частично созданный экземпляр. В \u003Ccode>4.6.0\u003C\u002Fcode> форма \u003Ccode>{ element }\u003C\u002Fcode> сохранилась, но ошибка снова стала явной: конструктор бросает \u003Ccode>Target element not found\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Явные \u003Ccode>init()\u003C\u002Fcode> и \u003Ccode>destroy()\u003C\u002Fcode> можно привязать к монтированию и размонтированию компонента во фреймворке. Удаление DOM-узла само по себе больше не запускает очистку, поэтому \u003Ccode>destroy()\u003C\u002Fcode> должен вызвать пользователь. Без этого \u003Ccode>ResizeObserver\u003C\u002Fcode> и ScrollTrigger продолжат жить после удаления элемента.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Очистка в \u003Ccode>4.6.0\u003C\u002Fcode> тоже остаётся неполной: отложенный кадр debounce и контексты \u003Ccode>matchMedia\u003C\u002Fcode> не отменяются, а повторный \u003Ccode>init()\u003C\u002Fcode> после \u003Ccode>destroy()\u003C\u002Fcode> не возобновляет наблюдение за размерами.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Зависимости нужно передавать полностью\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В ранней реализации четвёртой версии GSAP регистрировался через статический метод, но \u003Ccode>ScrollTrigger.refresh()\u003C\u002Fcode> всё ещё вызывался через глобальный \u003Ccode>ScrollTrigger\u003C\u002Fcode>. Модульный API получился не до конца модульным.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>4.2.0\u003C\u002Fcode> регистрация стала явной для обеих зависимостей:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">gsap.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">registerPlugin\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(ScrollTrigger);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">MarqueeContent.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">registerGSAP\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(gsap, ScrollTrigger);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Метод \u003Ccode>registerGSAP()\u003C\u002Fcode> сохранял обе ссылки, поэтому при вызове \u003Ccode>refresh()\u003C\u002Fcode> больше не требовался глобальный \u003Ccode>ScrollTrigger\u003C\u002Fcode>. Регистрация плагина в самом GSAP оставалась отдельной операцией. В \u003Ccode>4.6.0\u003C\u002Fcode> импортированные GSAP и ScrollTrigger уже служат значениями по умолчанию, а статический метод позволяет их переопределить.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В пакетах такие детали важнее, чем в коде одной страницы. Приложение может рассчитывать на глобальный объект, потому что само контролирует порядок скриптов. Библиотека не должна молча предполагать, что нужное имя уже существует в \u003Ccode>window\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Первая попытка TypeScript\u003C\u002Fh2>\n\u003Cp class=\"body-large\">По \u003Ccode>4.2.0\u003C\u002Fcode> включительно исходники оставались на JavaScript и собирались с помощью Parcel. В версии \u003Ccode>4.3.0\u003C\u002Fcode> основной файл перевёл на TypeScript и добавил \u003Ccode>tsconfig.json\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">На уровне списка файлов задача выглядела выполненной. На уровне публичного API — ещё нет.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Параметры регистрации GSAP и часть полей получили тип \u003Ccode>never\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">static \u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">registerGSAP\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(gsap: never, ScrollTrigger: never): \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">void\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Такой тип утверждает, что допустимого значения не существует. JavaScript-код ожидал GSAP и ScrollTrigger, но декларация не могла выразить этот контракт. Типы были в npm-пакете, однако использовать их по назначению было трудно.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Это хороший пример разницы между “код переписан на TypeScript” и “у библиотеки появился типизированный API”. Компилятор проверяет только ту модель, которую ему дали. Если на границе стоят \u003Ccode>never\u003C\u002Fcode> или безразмерный \u003Ccode>any\u003C\u002Fcode>, наличие \u003Ccode>.ts\u003C\u002Fcode> ещё ничего не гарантирует пользователю.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Duration переименован в speed\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В версии \u003Ccode>4.4.0\u003C\u002Fcode> заменил атрибут \u003Ccode>data-mc-duration\u003C\u002Fcode> на \u003Ccode>data-mc-speed\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">div\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> class\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"marquee\"\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> data-mc-speed\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"20\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\">  &#x3C;!-- элементы ленты -->\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u002F\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">div\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Математика анимации при этом не изменилась. Значение по-прежнему передавалось в GSAP как \u003Ccode>duration\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">timeline.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">to\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(element.children, {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  duration: speed,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  x: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'-100%'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Поэтому при положительных значениях \u003Ccode>speed\u003C\u002Fcode> меньшее число означало более быструю анимацию, большее — более медленную. \u003Ccode>speed\u003C\u002Fcode> здесь был пользовательской настройкой темпа, а не физической скоростью в пикселях в секунду. Имя стало короче, но семантика осталась обратной привычной скорости.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Для HTML это было несовместимое изменение: старый \u003Ccode>data-mc-duration\u003C\u002Fcode> библиотека больше не читала. Переименование публичного атрибута оказалось заметнее, чем переход исходников на TypeScript.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Шаг назад без маскировки\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В \u003Ccode>4.5.0\u003C\u002Fcode> убрал TypeScript вместе с декларациями, а инкапсуляция переехала на нативные приватные поля JavaScript:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">class\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> MarqueeContent\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  #element\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  #timeline\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  #resizeObserver\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Можно было оставить первую миграцию, но пользы от неё немного. Плохие типы не становятся хорошими от того, что дольше лежат в пакете.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Возврат к JavaScript был промежуточным состоянием. Публичный API не изменился: \u003Ccode>{ element }\u003C\u002Fcode>, \u003Ccode>init()\u003C\u002Fcode>, \u003Ccode>destroy()\u003C\u002Fcode> и \u003Ccode>registerGSAP()\u003C\u002Fcode> продолжили работать как раньше.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">TypeScript со второй попытки\u003C\u002Fh2>\n\u003Cp class=\"body-large\">К версии \u003Ccode>4.6.0\u003C\u002Fcode> я вернул TypeScript, но начал с границы пакета. В декларации появились реальные типы GSAP и ScrollTrigger, а \u003Ccode>element\u003C\u002Fcode> описан как строковый селектор или \u003Ccode>HTMLElement\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">type\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> MarqueeContentOptions\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  element\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">?:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> |\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> HTMLElement\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">};\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Теперь типы соответствуют способу использования библиотеки, а не просто факту существования TypeScript-файла.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Одновременно сборка переехала с Parcel на Vite в режиме сборки библиотек. Пакет начал публиковать три формата:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  \"main\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"dist\u002Findex.cjs.js\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  \"module\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"dist\u002Findex.es.js\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  \"browser\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\".\u002Fdist\u002Findex.umd.js\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  \"types\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"dist\u002Findex.d.ts\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  \"exports\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">    \".\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">      \"require\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\".\u002Fdist\u002Findex.cjs.js\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">      \"import\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\".\u002Fdist\u002Findex.es.js\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">      \"default\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\".\u002Fdist\u002Findex.umd.js\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">CommonJS доступен через \u003Ccode>require\u003C\u002Fcode>, ESM — через \u003Ccode>import\u003C\u002Fcode>, UMD — для прямого браузерного подключения. \u003Ccode>types\u003C\u002Fcode> указывает на декларацию, а \u003Ccode>exports\u003C\u002Fcode> задаёт явные точки входа вместо надежды на догадки сборщика.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Vite оставляет \u003Ccode>gsap\u003C\u002Fcode> и \u003Ccode>gsap\u002FScrollTrigger\u003C\u002Fcode> внешними модулями, поэтому в сборку \u003Ccode>marquee-content\u003C\u002Fcode> не встраивается собственная копия GSAP. Пользователю по-прежнему нужно установить и зарегистрировать зависимость.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Материалы\u003C\u002Fh2>\n\u003Cul class=\"list-large\">\n\u003Cli>\u003Ca href=\"https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FWeb_components\u002FUsing_custom_elements\" data-cursor-style=\"dot\">MDN: Using custom elements\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"https:\u002F\u002Fwww.typescriptlang.org\u002Fdocs\u002Fhandbook\u002Fdeclaration-files\u002Fintroduction.html\" data-cursor-style=\"dot\">TypeScript: Declaration Files\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"https:\u002F\u002Fvite.dev\u002Fguide\u002Fbuild.html#library-mode\" data-cursor-style=\"dot\">Vite: Library Mode\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"https:\u002F\u002Fnodejs.org\u002Fapi\u002Fpackages.html#package-entry-points\" data-cursor-style=\"dot\">Node.js: Package entry points\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"https:\u002F\u002Fgsap.com\u002Fdocs\u002Fv3\u002FInstallation\u002F\" data-cursor-style=\"dot\">GSAP: Install\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n",1795172791993]