[{"data":1,"prerenderedAt":206},["ShallowReactive",2],{"journal-all":3,"journal-post-dva-puti-k-svg-sprajtu-v-iconly":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":60,"documentId":61,"title":62,"content":203,"slug":63,"author":9,"displayDate":64,"publishedAt":65,"tags":204,"html":205},"В `3.0` у iconly появился довольно понятный контракт загрузки: при вызове `init()` загрузчик проверяет кэш, при необходимости получает внешний SVG-файл и вставляет его в DOM. Источник иконок в этой схеме — готовый файл со спрайтом.\n\nДля части проектов это удобно. В других проектах иконки уже доступны как ESM-модули рядом с остальным кодом. Собирать из них отдельный файл только затем, чтобы iconly снова его загрузил, выглядит лишним кругом. Поэтому в `4.1.0` я добавил второй публичный путь — `iconly\u002Fsprite`. Он принимает уже импортированные объекты иконок, собирает из них SVG и при необходимости вставляет его в тот же DOM-контейнер.\n\nЧерез несколько дней, в `4.2.0`, я добавил базовую защитную обработку для любой строки SVG, которую библиотека собирается вставить в DOM страницы. При этом встроенную очистку я сознательно не называю полноценной санитизацией и оставляю хук для специализированной обработки.\n\n## Сборка и проверки пакета\n\nВ `4.0.0` iconly переехал на общий для моих библиотек стек сборки и проверки: tsdown, ESM\u002FCJS, smoke-тесты, проверка tarball и публикация через Trusted Publishing. Для следующего изменения важно, что проверки уже не ограничены корневым импортом. Второй публичный подпуть можно включить в `exports`, добавить для него типы и smoke-тесты.\n\n## Внешний файл больше не единственный источник\n\nДо `4.1` основной сценарий выглядел так:\n\n```ts\nimport { createIconly } from 'iconly';\n\nconst iconLoader = createIconly({\n  file: '.\u002Fsprite.svg',\n  version: '1.0',\n  storage: 'indexeddb',\n});\n\nconst result = await iconLoader.init();\n```\n\nЗагрузчик работает с кэшем, получает внешний файл при необходимости, разбирает SVG и вставляет его в DOM.\n\nДля импортированных иконок мне нужен небольшой сборщик, которому можно передать только нужные объекты:\n\n```ts\nimport { createSprite } from 'iconly\u002Fsprite';\nimport { search, user, trash } from '.\u002Ficons';\n\nconst sprite = createSprite({\n  icons: [search, user, trash],\n  container: '#app',\n});\n\nconst result = sprite.render();\n\nif (!result.ok) {\n  console.error(result.error);\n}\n```\n\nФормат одной иконки намеренно маленький:\n\n```ts\nexport interface IconlyIcon {\n  name: string;\n  viewBox: string;\n  body: string;\n}\n```\n\n`name` становится `id` у `\u003Csymbol>`, `viewBox` переносится в одноимённый SVG-атрибут, `body` остаётся содержимым `\u003Csymbol>`.\n\nСборщик не использует сеть и хранилище. Он работает с данными, которые приложение уже импортировало.\n\n## Отдельный подпуть вместо расширения основного импорта\n\nДля сборщика спрайта я добавил отдельный подпуть, не расширяя корневой импорт:\n\n```ts\nimport { createSprite, buildSpriteString } from 'iconly\u002Fsprite';\n```\n\nВ `package.json` это отдельный экспорт:\n\n```json\n{\n  \"exports\": {\n    \".\u002Fsprite\": {\n      \"import\": {\n        \"types\": \".\u002Fdist\u002Fsprite.d.ts\",\n        \"default\": \".\u002Fdist\u002Fsprite.js\"\n      },\n      \"require\": {\n        \"types\": \".\u002Fdist\u002Fsprite.d.cts\",\n        \"default\": \".\u002Fdist\u002Fsprite.cjs\"\n      }\n    }\n  }\n}\n```\n\nА tsdown получает вторую точку входа:\n\n```ts\nexport default defineLibrary({\n  platform: 'browser',\n  entry: {\n    index: 'src\u002Findex.ts',\n    sprite: 'src\u002Fsprite.ts',\n  },\n});\n```\n\n`iconly` остаётся API загрузки внешнего файла. `iconly\u002Fsprite` — API сборки спрайта из уже имеющихся объектов иконок.\n\nЗаодно smoke-тесты проверяют четыре новых файла: ESM-модуль, CJS-модуль и оба файла типов. После `4.0` проверка нового подпути уже не ограничивается тем, что он \"локально импортируется\".\n\n## buildSpriteString не требует DOM\n\nЕсли нужна только SVG-строка, есть `buildSpriteString()`:\n\n```ts\nimport { buildSpriteString } from 'iconly\u002Fsprite';\n\nconst svg = buildSpriteString([search, user, trash]);\n```\n\nФункция собирает из иконок элементы `\u003Csymbol>`:\n\n```ts\nexport const buildSpriteString = (icons: IconlyIcon[]): string => {\n  const symbols = icons\n    .map(\n      (icon) =>\n        `\u003Csymbol id=\"${escapeAttr(icon.name)}\" viewBox=\"${escapeAttr(icon.viewBox)}\">${icon.body}\u003C\u002Fsymbol>`,\n    )\n    .join('');\n\n  return `\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">${symbols}\u003C\u002Fsvg>`;\n};\n```\n\nЗдесь нет обращения к `document`, сети или хранилищу. Поэтому функцию можно использовать там, где нужен SVG в виде строки, например в SSR или в тесте.\n\nПустой массив тоже имеет определённый результат:\n\n```html\n\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">\u003C\u002Fsvg>\n```\n\nДля `name` и `viewBox` сборщик экранирует специальные символы. `body` при этом не превращается в текст, потому что это и есть SVG-разметка конкретной иконки.\n\n## Tree-shaking начинается до iconly\n\nОдна из причин держать этот путь на уровне объектов иконок — он естественно сочетается с ESM-импортами:\n\n```ts\nimport { search, user } from '.\u002Ficons';\n\nbuildSpriteString([search, user]);\n```\n\nСам iconly не запускает tree-shaking и не анализирует каталог иконок. Он получает уже выбранный массив.\n\nУдалить неиспользованные экспорты может сборщик приложения, если пакет иконок организован подходящим образом. Задача `iconly\u002Fsprite` — собрать спрайт из выбранных объектов, без подготовки отдельного файла.\n\n## Два пути используют одну вставку в DOM\n\nДобавляя `createSprite()`, я хотел использовать существующий код вставки SVG.\n\nВ `4.1` я перенёс `resolveContainer()` из `core.ts` в `dom.ts`. Теперь его используют оба сценария. Метод `render()` созданного спрайта использует тот же `insertSvg()`, что и загрузчик:\n\n```ts\nreturn insertSvg(\n  containerResult.value,\n  buildSpriteString(icons),\n);\n```\n\nПолучаются две разные цепочки до DOM:\n\n```text\ncreateIconly()\n  кэш -> fetch -> строка SVG\n                  |\n                  v\n               insertSvg()\n\ncreateSprite()\n  объекты иконок -> buildSpriteString()\n                    |\n                    v\n                 insertSvg()\n```\n\nИсточник данных может быть разным, но правила выбора контейнера, разбора SVG и вставки не должны расходиться без причины.\n\n## Защитная обработка перед вставкой SVG\n\nВ `2.0` я добавил отдельный разбор SVG через `DOMParser`. Это не делает входной SVG безопасным. В `4.2.0` добавил обработку перед вставкой разобранного элемента в DOM страницы.\n\nТеперь `insertSvg()` принимает необязательные параметры:\n\n```ts\nexport interface InsertSvgOptions {\n  sanitize?: SvgSanitizer;\n}\n```\n\nПорядок такой:\n\n```text\nSVG string\n  -> пользовательская функция sanitize, если задана\n  -> DOMParser\n  -> встроенная защитная обработка SVG\n  -> document.importNode()\n  -> DOM страницы\n```\n\nОдин и тот же путь используется и для внешнего файла, и для `createSprite().render()`.\n\nВ обоих сценариях `sanitize` можно указать в параметрах:\n\n```ts\nconst iconLoader = createIconly({\n  file: '.\u002Fsprite.svg',\n  sanitize,\n});\n```\n\n```ts\nconst sprite = createSprite({\n  icons: [search, user],\n  sanitize,\n});\n```\n\nПользовательская функция вызывается до разбора SVG. Это оставляет возможность подключить специализированный санитайзер или собственные правила обработки строки, не зашивая стороннюю зависимость в iconly.\n\n## Что делает встроенная защитная обработка\n\nПосле разбора библиотека рекурсивно проходит дерево SVG.\n\nВ текущей версии удаляются:\n\n- `\u003Cscript>`\n- `\u003CforeignObject>`\n- атрибуты вида `onerror`, `onclick` и другие обработчики `on*`\n- `href` и `xlink:href` со схемами `javascript:` и `data:text\u002Fhtml`\n- элементы SMIL-анимации, которые пытаются менять `href` или `xlink:href`.\n\nЭто не запрет всей SVG-анимации. Например, `animate` для `opacity` остаётся допустимым. Тесты отдельно фиксируют это различие.\n\nЕсть и интеграционные тесты для обоих публичных сценариев. Внешний SVG с `onerror` проходит через `createIconly()`, `body` иконки с тем же атрибутом — через `createSprite()`. В обоих случаях обработчик должен исчезнуть до вставки.\n\nТо есть защитная обработка привязана не к тому, откуда пришёл SVG, а к общей операции \"сейчас эта структура попадёт в DOM\".\n\n## Это не полноценный санитайзер\n\nЗдесь я не хочу \"переобещать\".\n\nВстроенная обработка удаляет несколько очевидных опасных конструкций, но не заменяет полноценный санитайзер SVG\u002FHTML. В README я прямо оставил примеры того, что она не покрывает полностью: CSS-векторы внутри `\u003Cstyle>` и внешние ссылки в `\u003Cuse>` или `\u003Cimage>`.\n\nПоэтому для недоверенного содержимого есть хук `sanitize`. Например, туда можно подключить специализированную библиотеку, а встроенный проход оставить дополнительным слоем перед вставкой.\n\nВ `buildSpriteString()` встроенная защитная обработка не выполняется: функция собирает строку и не обращается к DOM.\n\n```ts\nconst svg = buildSpriteString(untrustedIcons);\n```\n\nЕсли такую строку дальше использовать самостоятельно, ответственность за очистку остаётся у вызывающего кода. В `4.2` сборщик дополнительно экранирует `>` в `name` и `viewBox`, но `icon.body` по-прежнему остаётся SVG-разметкой.",[],"\u003Cp class=\"body-large\">В \u003Ccode>3.0\u003C\u002Fcode> у iconly появился довольно понятный контракт загрузки: при вызове \u003Ccode>init()\u003C\u002Fcode> загрузчик проверяет кэш, при необходимости получает внешний SVG-файл и вставляет его в DOM. Источник иконок в этой схеме — готовый файл со спрайтом.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Для части проектов это удобно. В других проектах иконки уже доступны как ESM-модули рядом с остальным кодом. Собирать из них отдельный файл только затем, чтобы iconly снова его загрузил, выглядит лишним кругом. Поэтому в \u003Ccode>4.1.0\u003C\u002Fcode> я добавил второй публичный путь — \u003Ccode>iconly\u002Fsprite\u003C\u002Fcode>. Он принимает уже импортированные объекты иконок, собирает из них SVG и при необходимости вставляет его в тот же DOM-контейнер.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Через несколько дней, в \u003Ccode>4.2.0\u003C\u002Fcode>, я добавил базовую защитную обработку для любой строки SVG, которую библиотека собирается вставить в DOM страницы. При этом встроенную очистку я сознательно не называю полноценной санитизацией и оставляю хук для специализированной обработки.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Сборка и проверки пакета\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В \u003Ccode>4.0.0\u003C\u002Fcode> iconly переехал на общий для моих библиотек стек сборки и проверки: tsdown, ESM\u002FCJS, smoke-тесты, проверка tarball и публикация через Trusted Publishing. Для следующего изменения важно, что проверки уже не ограничены корневым импортом. Второй публичный подпуть можно включить в \u003Ccode>exports\u003C\u002Fcode>, добавить для него типы и smoke-тесты.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Внешний файл больше не единственный источник\u003C\u002Fh2>\n\u003Cp class=\"body-large\">До \u003Ccode>4.1\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\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { createIconly } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">from\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'iconly'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> iconLoader\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  file: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'.\u002Fsprite.svg'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  version: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'1.0'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  storage: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'indexeddb'\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:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> result\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> iconLoader.\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\">Загрузчик работает с кэшем, получает внешний файл при необходимости, разбирает SVG и вставляет его в DOM.\u003C\u002Fp>\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:#F97583\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { createSprite } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">from\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'iconly\u002Fsprite'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { search, user, trash } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">from\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> '.\u002Ficons'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> sprite\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> createSprite\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  icons: [search, user, trash],\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  container: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'#app'\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:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> result\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> sprite.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">render\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">!\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">result.ok) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  console.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">error\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(result.error);\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\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">export\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> interface\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconlyIcon\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  name\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  viewBox\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  body\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\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>name\u003C\u002Fcode> становится \u003Ccode>id\u003C\u002Fcode> у \u003Ccode>&lt;symbol&gt;\u003C\u002Fcode>, \u003Ccode>viewBox\u003C\u002Fcode> переносится в одноимённый SVG-атрибут, \u003Ccode>body\u003C\u002Fcode> остаётся содержимым \u003Ccode>&lt;symbol&gt;\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Сборщик не использует сеть и хранилище. Он работает с данными, которые приложение уже импортировало.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Отдельный подпуть вместо расширения основного импорта\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:#F97583\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { createSprite, buildSpriteString } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">from\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'iconly\u002Fsprite'\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>package.json\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\">{\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\">    \".\u002Fsprite\"\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>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">        \"types\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\".\u002Fdist\u002Fsprite.d.ts\"\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\u002Fsprite.js\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\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>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">        \"types\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\".\u002Fdist\u002Fsprite.d.cts\"\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\u002Fsprite.cjs\"\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\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">А tsdown получает вторую точку входа:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">export\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> default\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> defineLibrary\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  platform: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'browser'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  entry: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    index: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'src\u002Findex.ts'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    sprite: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'src\u002Fsprite.ts'\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\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">\u003Ccode>iconly\u003C\u002Fcode> остаётся API загрузки внешнего файла. \u003Ccode>iconly\u002Fsprite\u003C\u002Fcode> — API сборки спрайта из уже имеющихся объектов иконок.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Заодно smoke-тесты проверяют четыре новых файла: ESM-модуль, CJS-модуль и оба файла типов. После \u003Ccode>4.0\u003C\u002Fcode> проверка нового подпути уже не ограничивается тем, что он “локально импортируется”.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">buildSpriteString не требует DOM\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Если нужна только SVG-строка, есть \u003Ccode>buildSpriteString()\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\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { buildSpriteString } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">from\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'iconly\u002Fsprite'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> svg\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> buildSpriteString\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">([search, user, trash]);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Функция собирает из иконок элементы \u003Ccode>&lt;symbol&gt;\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\">export\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> const\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> buildSpriteString\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">icons\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconlyIcon\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">[])\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =>\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> symbols\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> icons\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    .\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">map\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">      (\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">icon\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#9ECBFF\">        `&#x3C;symbol id=\"${\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">escapeAttr\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">(\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">icon\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">name\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">)\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">}\" viewBox=\"${\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">escapeAttr\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">(\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">icon\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">viewBox\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">)\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">}\">${\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">icon\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">body\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">}&#x3C;\u002Fsymbol>`\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\">\u003Cspan style=\"color:#E1E4E8\">    .\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">join\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">''\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  return\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> `&#x3C;svg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\">${\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">symbols\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">}&#x3C;\u002Fsvg>`\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>document\u003C\u002Fcode>, сети или хранилищу. Поэтому функцию можно использовать там, где нужен SVG в виде строки, например в SSR или в тесте.\u003C\u002Fp>\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\">svg\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> xmlns\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>&#x3C;\u002F\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">svg\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>name\u003C\u002Fcode> и \u003Ccode>viewBox\u003C\u002Fcode> сборщик экранирует специальные символы. \u003Ccode>body\u003C\u002Fcode> при этом не превращается в текст, потому что это и есть SVG-разметка конкретной иконки.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Tree-shaking начинается до iconly\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Одна из причин держать этот путь на уровне объектов иконок — он естественно сочетается с ESM-импортами:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { search, user } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">from\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> '.\u002Ficons'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">buildSpriteString\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">([search, user]);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Сам iconly не запускает tree-shaking и не анализирует каталог иконок. Он получает уже выбранный массив.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Удалить неиспользованные экспорты может сборщик приложения, если пакет иконок организован подходящим образом. Задача \u003Ccode>iconly\u002Fsprite\u003C\u002Fcode> — собрать спрайт из выбранных объектов, без подготовки отдельного файла.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Два пути используют одну вставку в DOM\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Добавляя \u003Ccode>createSprite()\u003C\u002Fcode>, я хотел использовать существующий код вставки SVG.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>4.1\u003C\u002Fcode> я перенёс \u003Ccode>resolveContainer()\u003C\u002Fcode> из \u003Ccode>core.ts\u003C\u002Fcode> в \u003Ccode>dom.ts\u003C\u002Fcode>. Теперь его используют оба сценария. Метод \u003Ccode>render()\u003C\u002Fcode> созданного спрайта использует тот же \u003Ccode>insertSvg()\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\">return\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> insertSvg\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  containerResult.value,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  buildSpriteString\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(icons),\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\">Получаются две разные цепочки до DOM:\u003C\u002Fp>\n\u003Cpre class=\"shiki\">\u003Ccode>createIconly()\n  кэш -&gt; fetch -&gt; строка SVG\n                  |\n                  v\n               insertSvg()\n\ncreateSprite()\n  объекты иконок -&gt; buildSpriteString()\n                    |\n                    v\n                 insertSvg()\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Источник данных может быть разным, но правила выбора контейнера, разбора SVG и вставки не должны расходиться без причины.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Защитная обработка перед вставкой SVG\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В \u003Ccode>2.0\u003C\u002Fcode> я добавил отдельный разбор SVG через \u003Ccode>DOMParser\u003C\u002Fcode>. Это не делает входной SVG безопасным. В \u003Ccode>4.2.0\u003C\u002Fcode> добавил обработку перед вставкой разобранного элемента в DOM страницы.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Теперь \u003Ccode>insertSvg()\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\">export\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> interface\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> InsertSvgOptions\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  sanitize\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">?:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> SvgSanitizer\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\u003Cpre class=\"shiki\">\u003Ccode>SVG string\n  -&gt; пользовательская функция sanitize, если задана\n  -&gt; DOMParser\n  -&gt; встроенная защитная обработка SVG\n  -&gt; document.importNode()\n  -&gt; DOM страницы\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Один и тот же путь используется и для внешнего файла, и для \u003Ccode>createSprite().render()\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В обоих сценариях \u003Ccode>sanitize\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\"> iconLoader\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  file: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'.\u002Fsprite.svg'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  sanitize,\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>\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\"> sprite\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> createSprite\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  icons: [search, user],\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  sanitize,\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\">Пользовательская функция вызывается до разбора SVG. Это оставляет возможность подключить специализированный санитайзер или собственные правила обработки строки, не зашивая стороннюю зависимость в iconly.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Что делает встроенная защитная обработка\u003C\u002Fh2>\n\u003Cp class=\"body-large\">После разбора библиотека рекурсивно проходит дерево SVG.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В текущей версии удаляются:\u003C\u002Fp>\n\u003Cul class=\"list-large\">\n\u003Cli>\u003Ccode>&lt;script&gt;\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Ccode>&lt;foreignObject&gt;\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>атрибуты вида \u003Ccode>onerror\u003C\u002Fcode>, \u003Ccode>onclick\u003C\u002Fcode> и другие обработчики \u003Ccode>on*\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Ccode>href\u003C\u002Fcode> и \u003Ccode>xlink:href\u003C\u002Fcode> со схемами \u003Ccode>javascript:\u003C\u002Fcode> и \u003Ccode>data:text\u002Fhtml\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>элементы SMIL-анимации, которые пытаются менять \u003Ccode>href\u003C\u002Fcode> или \u003Ccode>xlink:href\u003C\u002Fcode>.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp class=\"body-large\">Это не запрет всей SVG-анимации. Например, \u003Ccode>animate\u003C\u002Fcode> для \u003Ccode>opacity\u003C\u002Fcode> остаётся допустимым. Тесты отдельно фиксируют это различие.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Есть и интеграционные тесты для обоих публичных сценариев. Внешний SVG с \u003Ccode>onerror\u003C\u002Fcode> проходит через \u003Ccode>createIconly()\u003C\u002Fcode>, \u003Ccode>body\u003C\u002Fcode> иконки с тем же атрибутом — через \u003Ccode>createSprite()\u003C\u002Fcode>. В обоих случаях обработчик должен исчезнуть до вставки.\u003C\u002Fp>\n\u003Cp class=\"body-large\">То есть защитная обработка привязана не к тому, откуда пришёл SVG, а к общей операции “сейчас эта структура попадёт в DOM”.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Это не полноценный санитайзер\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Здесь я не хочу “переобещать”.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Встроенная обработка удаляет несколько очевидных опасных конструкций, но не заменяет полноценный санитайзер SVG\u002FHTML. В README я прямо оставил примеры того, что она не покрывает полностью: CSS-векторы внутри \u003Ccode>&lt;style&gt;\u003C\u002Fcode> и внешние ссылки в \u003Ccode>&lt;use&gt;\u003C\u002Fcode> или \u003Ccode>&lt;image&gt;\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Поэтому для недоверенного содержимого есть хук \u003Ccode>sanitize\u003C\u002Fcode>. Например, туда можно подключить специализированную библиотеку, а встроенный проход оставить дополнительным слоем перед вставкой.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>buildSpriteString()\u003C\u002Fcode> встроенная защитная обработка не выполняется: функция собирает строку и не обращается к DOM.\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\"> svg\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> buildSpriteString\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(untrustedIcons);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Если такую строку дальше использовать самостоятельно, ответственность за очистку остаётся у вызывающего кода. В \u003Ccode>4.2\u003C\u002Fcode> сборщик дополнительно экранирует \u003Ccode>&gt;\u003C\u002Fcode> в \u003Ccode>name\u003C\u002Fcode> и \u003Ccode>viewBox\u003C\u002Fcode>, но \u003Ccode>icon.body\u003C\u002Fcode> по-прежнему остаётся SVG-разметкой.\u003C\u002Fp>\n",1795172788624]