@dubium/icons 0.0.2-alpha.2 → 0.0.2-alpha.4

package/dist/vite/icon/Icon.types.d.ts

@@ -0,0 +1,88 @@
+import type { ComponentType } from "react";
+import type { IIconComponentProps } from "../../collection/types.js";
+/**
+ * Тип пустого реестра иконок.
+ *
+ * Используется как default generic, чтобы keyof реестра
+ * не превращался в обычный string.
+ */
+export type TEmptyIconRegistry = Readonly<Record<never, never>>;
+/**
+ * React-компонент иконки.
+ */
+export type TIcon = ComponentType<IIconComponentProps>;
+/**
+ * Модуль динамически загружаемой иконки.
+ */
+export type TIconModule = {
+    default: TIcon;
+};
+/**
+ * Lazy loader иконки.
+ */
+export type TIconLoader = () => Promise<TIconModule>;
+/**
+ * Runtime / custom registry иконок.
+ *
+ * В runtime ключом может быть любая строка.
+ */
+export type TIconRegistry = Readonly<Record<string, TIconLoader>>;
+/**
+ * Все runtime-экспорты collection/index.ts.
+ *
+ * Например:
+ *
+ * "AB2Icon"
+ * "AbacusIcon"
+ * "AccessibleIcon"
+ */
+type TCollectionExportName = Extract<keyof typeof import("../../collection/index.js"), string>;
+/**
+ * Удаляет суффикс "Icon".
+ *
+ * Например:
+ *
+ * "AbacusIcon" -> "Abacus"
+ * "AccessibleIcon" -> "Accessible"
+ */
+type TRemoveIconSuffix<TName extends string> = TName extends `${infer TIconName}Icon` ? TIconName : never;
+/**
+ * Все имена встроенных иконок пакета.
+ *
+ * Автоматически вычисляется из:
+ *
+ * src/icons/collection/index.ts
+ *
+ * Поэтому после sync:icons список обновляется автоматически.
+ */
+export type TPackageIconName = TRemoveIconSuffix<TCollectionExportName>;
+/**
+ * Допустимое имя иконки.
+ *
+ * Включает:
+ *
+ * 1. все встроенные иконки @sg/icons;
+ * 2. ключи кастомного registry, если он передан.
+ *
+ * @example
+ *
+ * ```ts
+ * type TName = TIconName
+ *
+ * // "AB2" | "Abacus" | "Accessible" | ...
+ * ```
+ *
+ * @example
+ *
+ * ```ts
+ * const customIcons = {
+ *   CompanyLogo: () => import("./CompanyLogoIcon"),
+ * } as const
+ *
+ * type TName = TIconName<typeof customIcons>
+ *
+ * // package icons | "CompanyLogo"
+ * ```
+ */
+export type TIconName<TCustomIcons extends TIconRegistry = TEmptyIconRegistry> = TPackageIconName | Extract<keyof TCustomIcons, string>;
+export type { IIconComponentProps };

package/dist/vite/icon/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Публичный API Vite Icon.
+ */
+export { Icon, type IconProps } from "./Icon.js";
+export { createIcon } from "./Icon.create.js";
+export type { IIconComponentProps, TEmptyIconRegistry, TIcon, TIconLoader, TIconModule, TIconName, TIconRegistry, TPackageIconName, } from "./Icon.types.js";

package/dist/vite/index.d.ts

@@ -1,50 +1,14 @@
-import type { Plugin } from "vite";
-export interface DubiumIconsPluginOptions {
-    /**
-     * Имена компонентов, которые плагин должен анализировать.
-     *
-     * @default ["Icon"]
-     */
-    componentNames?: readonly string[];
-    /**
-     * Иконки, которые необходимо включить вручную.
-     *
-     * Используется для runtime-имён:
-     * `<Icon name={valueFromApi} />`.
-     */
-    include?: readonly string[];
-    /**
-     * Имя npm-пакета с иконками.
-     *
-     * @default "@dubium/icons"
-     */
-    packageName?: string;
-    /**
-     * Каталоги приложения, которые нужно сканировать.
-     * Пути могут быть абсолютными или относительными к Vite root.
-     *
-     * @default ["src"]
-     */
-    scan?: readonly string[];
-    /**
-     * Если true, сборка завершится ошибкой при обнаружении
-     * `<Icon name={dynamicValue} />`.
-     *
-     * При false будет выведено предупреждение.
-     *
-     * @default false
-     */
-    strictDynamicNames?: boolean;
-}
 /**
- * Vite-плагин для compile-time извлечения используемых иконок.
+ * Публичный API иконок для Vite.
  *
- * Он сканирует JSX/TSX, находит статические:
- * `<Icon name="User" />`,
- * а затем создаёт virtual registry только для найденных имён.
+ * Источники иконок:
  *
- * Благодаря этому Rollup/Vite видит dynamic import() только реально
- * используемых иконок, и остальные иконки не попадают в dist приложения.
+ * 1. IconProvider;
+ * 2. runtime registry;
+ * 3. compile-time virtual registry.
  */
-export declare const dubiumIcons: (options?: DubiumIconsPluginOptions) => Plugin;
-export default dubiumIcons;
+export { createIcon, Icon, type IconProps } from "./icon/index.js";
+export { IconProvider, useIconContext } from "./provider/index.js";
+export { getRuntimeIconLoader, getRuntimeIconsVersion, registerIcons, removeIconOwner, subscribeRuntimeIcons, } from "./runtime/index.js";
+export type { IIconComponentProps, TEmptyIconRegistry, TIcon, TIconLoader, TIconModule, TIconName, TIconRegistry, TPackageIconName, } from "./icon/index.js";
+export type { IIconContextValue, IIconProviderProps } from "./provider/index.js";

package/dist/vite/index.js

@@ -1,166 +1,6 @@
-import { require___vite_browser_external as e } from "../_virtual/__vite-browser-external.js";
-//#region src/icons/vite/index.ts
-var t = e(), n = "virtual:@dubium/icons-registry", r = `\0${n}`, i = /* @__PURE__ */ new Set([
-	".js",
-	".jsx",
-	".mjs",
-	".cjs",
-	".ts",
-	".tsx"
-]), a = /* @__PURE__ */ new Set([
-	".git",
-	".next",
-	".nuxt",
-	".output",
-	".turbo",
-	"build",
-	"coverage",
-	"dist",
-	"node_modules"
-]), o = (e) => e.replaceAll("\\", "/"), s = (e, t) => {
-	if (e.size !== t.size) return !1;
-	for (let n of e) if (!t.has(n)) return !1;
-	return !0;
-}, c = (e) => {
-	let t = e.map((e) => e.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&"));
-	return RegExp(`<\\s*(?:${t.join("|")})\\b`, "gu");
-}, l = (e, t) => {
-	let n = null, r = !1, i = 0;
-	for (let a = t; a < e.length; a += 1) {
-		let t = e[a];
-		if (n) {
-			if (r) {
-				r = !1;
-				continue;
-			}
-			if (t === "\\") {
-				r = !0;
-				continue;
-			}
-			t === n && (n = null);
-			continue;
-		}
-		if (t === "'" || t === "\"" || t === "`") {
-			n = t;
-			continue;
-		}
-		if (t === "{") {
-			i += 1;
-			continue;
-		}
-		if (t === "}") {
-			i = Math.max(0, i - 1);
-			continue;
-		}
-		if (t === ">" && i === 0) return a;
-	}
-	return -1;
-}, u = (e) => {
-	let t = /\bname\s*=\s*(["'])(.*?)\1/su.exec(e);
-	if (t) return t[2].trim();
-	let n = /\bname\s*=\s*\{\s*(?:(["'])(.*?)\1|`([^`${}]*)`)\s*\}/su.exec(e);
-	return n ? (n[2] ?? n[3] ?? "").trim() : null;
-}, d = (e) => /\bname\s*=/u.test(e), f = (e, t) => {
-	let n = /* @__PURE__ */ new Set(), r = c(t), i = 0;
-	for (let t of e.matchAll(r)) {
-		let r = t.index ?? 0, a = l(e, r);
-		if (a === -1) continue;
-		let o = e.slice(r, a + 1), s = u(o);
-		if (s) {
-			n.add(s);
-			continue;
-		}
-		d(o) && (i += 1);
-	}
-	return {
-		dynamicNames: i,
-		icons: n
-	};
-}, p = async (e) => {
-	let n;
-	try {
-		n = await (0, t.readdir)(e, { withFileTypes: !0 });
-	} catch {
-		return [];
-	}
-	let r = [];
-	for (let o of n) {
-		let n = (0, t.join)(e, o.name);
-		if (o.isDirectory()) {
-			a.has(o.name) || r.push(...await p(n));
-			continue;
-		}
-		o.isFile() && i.has((0, t.extname)(o.name).toLowerCase()) && r.push(n);
-	}
-	return r;
-}, m = (e, t) => `/**
- * AUTO-GENERATED in memory by @dubium/icons/vite.
- * Contains only icons used by the current application.
- */
-export const iconRegistry = {
-${e.map((e) => `\t${JSON.stringify(e)}: () => import(${JSON.stringify(`${t}/icons/${e}`)}),`).join("\n")}
-}
-`, h = (e = {}) => {
-	let a = e.componentNames?.length ? [...e.componentNames] : ["Icon"], c = e.packageName ?? "@dubium/icons", l = e.scan?.length ? [...e.scan] : ["src"], u = new Set(e.include ?? []), d = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new Map(), g = process.cwd(), _, v = () => {
-		let e = new Set(u);
-		for (let t of d.values()) for (let n of t) e.add(n);
-		return [...e].sort((e, t) => e.localeCompare(t));
-	}, y = async (e) => {
-		let n = o(e);
-		if (!i.has((0, t.extname)(e).toLowerCase())) return d.delete(n), h.delete(n), !1;
-		let r;
-		try {
-			r = await (0, t.readFile)(e, "utf8");
-		} catch {
-			let e = d.delete(n), t = h.delete(n);
-			return e || t;
-		}
-		let c = d.get(n) ?? /* @__PURE__ */ new Set(), l = h.get(n) ?? 0, u = f(r, a);
-		return d.set(n, u.icons), u.dynamicNames > 0 ? h.set(n, u.dynamicNames) : h.delete(n), !s(c, u.icons) || l !== u.dynamicNames;
-	}, b = async (e) => {
-		d.clear(), h.clear();
-		for (let n of l) {
-			let r = await p((0, t.isAbsolute)(n) ? n : (0, t.resolve)(g, n));
-			for (let t of r) e?.addWatchFile(t), await y(t);
-		}
-	}, x = () => h.size === 0 ? null : `[@dubium/icons] Найдены динамические name у <Icon>:\n${[...h.entries()].map(([e, n]) => `  - ${o((0, t.relative)(g, e))}: ${n}`).join("\n")}\nVite не может определить такие иконки на этапе сборки. Добавьте допустимые имена в dubiumIcons({ include: [...] }).`, S = () => {
-		if (!_) return;
-		let e = _.moduleGraph.getModuleById(r);
-		e && _.moduleGraph.invalidateModule(e), _.ws.send({ type: "full-reload" });
-	};
-	return {
-		name: "dubium-icons",
-		enforce: "pre",
-		configResolved(e) {
-			g = e.root;
-		},
-		async buildStart() {
-			await b(this);
-			let t = x();
-			t && (e.strictDynamicNames ? this.error(t) : this.warn(t));
-		},
-		configureServer(e) {
-			_ = e;
-			let t = async (e) => {
-				await y(e) && S();
-			}, n = async (e) => {
-				let t = o(e);
-				(d.delete(t) || h.delete(t)) && S();
-			};
-			return e.watcher.on("add", t), e.watcher.on("unlink", n), () => {
-				e.watcher.off("add", t), e.watcher.off("unlink", n);
-			};
-		},
-		resolveId(e) {
-			return e === n ? r : null;
-		},
-		load(e) {
-			return e === r ? m(v(), c) : null;
-		},
-		async handleHotUpdate(e) {
-			if (await y(e.file)) return S(), [];
-		}
-	};
-};
-//#endregion
-export { h as default, h as dubiumIcons };
+import { IconProvider as e } from "./provider/IconProvider.js";
+import { useIconContext as t } from "./provider/useIconContext.js";
+import { getRuntimeIconLoader as n, getRuntimeIconsVersion as r, registerIcons as i, removeIconOwner as a, subscribeRuntimeIcons as o } from "./runtime/IconRuntime.registry.js";
+import { Icon as s } from "./icon/Icon.js";
+import { createIcon as c } from "./icon/Icon.create.js";
+export { s as Icon, e as IconProvider, c as createIcon, n as getRuntimeIconLoader, r as getRuntimeIconsVersion, i as registerIcons, a as removeIconOwner, o as subscribeRuntimeIcons, t as useIconContext };

package/dist/vite/plugin/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Публичный API Vite-плагина {@link dubiumIcons}.
+ *
+ * @remarks
+ * Плагин сканирует исходники приложения, строит виртуальный модуль
+ * `virtual:@dubium/icons-registry` с реестром только реально используемых
+ * иконок и разрешает его через `resolveId`/`load`.
+ */
+export { dubiumIcons } from "./plugin.js";
+export { dubiumIcons as default } from "./plugin.js";
+export type { DubiumIconsPluginOptions, TDubiumIconSource } from "./plugin.types.js";

package/dist/vite/plugin/index.js

@@ -0,0 +1,2 @@
+import { dubiumIcons as e } from "./plugin.js";
+export { e as default, e as dubiumIcons };

package/dist/vite/plugin/plugin.d.ts

@@ -0,0 +1,41 @@
+import type { Plugin } from "vite";
+import type { DubiumIconsPluginOptions } from "./plugin.types.js";
+/**
+ * Плагин Vite для автоматического обнаружения иконок `@dubium/icons`.
+ *
+ * @remarks
+ * Плагин сканирует исходники проекта, находит статические использования
+ * Vite-компонента `Icon` (в виде JSX-тегов и строковых конфигураций) и генерирует
+ * виртуальный модуль `virtual:@dubium/icons-registry` с ленивыми загрузчиками
+ * только для используемых иконок.
+ *
+ * По умолчанию компонентом считается любой JSX-тег `<Icon>`, имя которого
+ * импортировано из `@dubium/icons/vite`. Набор имён можно переопределить через
+ * `options.componentNames`, а список свойств, значения которых трактуются как имена
+ * иконок, — через `options.propertyNames`. Теги прочих компонентов, например
+ * `<IconButton>`, игнорируются.
+ *
+ * Сканируются все файлы директории `src` (настраивается через `options.scan`).
+ * Источником иконок по умолчанию является пакет `@dubium/icons` с подстановкой
+ * имени в `importPattern`; локальные каталоги SVG-файлов подключаются через
+ * `options.sources`.
+ *
+ * Динамические имена вида `<Icon name={expression}>` не могут быть разрешены
+ * на этапе сборки — о них выводится предупреждение с указанием файлов.
+ *
+ * @param options - Опции плагина
+ * @returns Объект плагина Vite
+ *
+ * @example
+ *
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from "vite"
+ * import { dubiumIcons } from "@dubium/icons/vite/plugin"
+ *
+ * export default defineConfig({
+ *   plugins: [dubiumIcons()],
+ * })
+ * ```
+ */
+export declare const dubiumIcons: (options?: DubiumIconsPluginOptions) => Plugin;

package/dist/vite/plugin/plugin.js

@@ -0,0 +1,105 @@
+import { scanSource as e } from "./scanner/scanner.source.js";
+import { DEFAULT_EXTENSIONS as t, getSourceFiles as n, isPathInsideDirectory as r, normalizePath as i } from "./sources/sources.files.js";
+import { buildLocalCatalog as a } from "./sources/sources.catalog.js";
+import { validateSources as o } from "./sources/sources.validate.js";
+import { RESOLVED_VIRTUAL_MODULE_ID as s } from "./virtual/virtual.constants.js";
+import { createVirtualModuleSource as c } from "./virtual/virtual.module.js";
+import { readFile as l } from "node:fs/promises";
+import { extname as u, relative as d, resolve as f } from "node:path";
+//#region src/icons/vite/plugin/plugin.ts
+var p = (e, t) => {
+	if (e.size !== t.size) return !1;
+	for (let n of e) if (!t.has(n)) return !1;
+	return !0;
+}, m = (m = {}) => {
+	let h = m.componentNames ? [...m.componentNames] : [], g = m.propertyNames ? [...m.propertyNames] : [], _ = m.scan ? [...m.scan] : ["src"], v = m.sources ? [...m.sources] : [{
+		type: "package",
+		importPattern: "@dubium/icons/icons/{name}"
+	}];
+	o(v);
+	let y = v.filter((e) => e.type === "local"), b = v.find((e) => e.type === "package"), x = /* @__PURE__ */ new Map(), S = /* @__PURE__ */ new Map(), C = [], w = process.cwd(), T, E = "", D = () => {
+		let e = /* @__PURE__ */ new Set();
+		for (let t of x.values()) for (let n of t) e.add(n);
+		return [...e].sort((e, t) => e.localeCompare(t));
+	}, O = async (n, r) => {
+		let a = i(n);
+		if (!t.has(u(n).toLowerCase())) {
+			let e = x.delete(a), t = S.delete(a);
+			return e || t;
+		}
+		let o;
+		try {
+			o = r ? await r() : await l(n, "utf8");
+		} catch {
+			let e = x.delete(a), t = S.delete(a);
+			return e || t;
+		}
+		let s = x.get(a) ?? /* @__PURE__ */ new Set(), c = S.get(a) ?? 0, d = e(o, h, g);
+		return x.set(a, d.icons), d.dynamicNames > 0 ? S.set(a, d.dynamicNames) : S.delete(a), !p(s, d.icons) || c !== d.dynamicNames;
+	}, k = async (e) => {
+		x.clear(), S.clear();
+		for (let t of _) {
+			let r = f(w, t), i;
+			try {
+				i = await n(r);
+			} catch {
+				e?.warn(`[@dubium/icons] Директория для сканирования недоступна: "${t}".\nПроверьте options.scan, существование пути и права доступа.`);
+				continue;
+			}
+			for (let t of i) e?.addWatchFile(t), await O(t);
+		}
+	}, A = async () => {
+		C = await Promise.all(y.map((e) => a(w, e)));
+	}, j = (e) => y.some((t) => r(f(w, t.path), e)), M = (e) => _.some((t) => r(f(w, t), e)), N = () => {
+		if (!T) return;
+		let e = T.moduleGraph.getModuleById(s);
+		e && T.moduleGraph.invalidateModule(e), T.ws.send({ type: "full-reload" });
+	}, P = (e) => {
+		if (S.size === 0) {
+			E = "";
+			return;
+		}
+		let t = [...S.entries()].sort(([e], [t]) => e.localeCompare(t)).map(([e, t]) => `  - ${i(d(w, e))}: ${t}`).join("\n");
+		t !== E && (E = t, e(`[@dubium/icons] Найдены динамические <Icon name={...}>:\n${t}\nДля MF/EventBus это допустимо, если loader регистрируется remote через runtime registry.`));
+	};
+	return {
+		name: "dubium-icons",
+		enforce: "pre",
+		configResolved(e) {
+			w = e.root;
+		},
+		async buildStart() {
+			await A(), await k(this), P((e) => this.warn(e));
+		},
+		configureServer(e) {
+			T = e;
+			for (let t of y) e.watcher.add(f(w, t.path));
+			let t = async (e) => {
+				let t = j(e), n = M(e) ? await O(e) : !1, r = () => {
+					N(), P((e) => {
+						T?.config.logger.warn(e);
+					});
+				};
+				if (t) {
+					await A(), r();
+					return;
+				}
+				n && r();
+			};
+			e.watcher.on("add", t), e.watcher.on("unlink", t), e.watcher.on("addDir", t), e.watcher.on("unlinkDir", t), e.httpServer?.once("close", () => {
+				e.watcher.off("add", t), e.watcher.off("unlink", t), e.watcher.off("addDir", t), e.watcher.off("unlinkDir", t);
+			});
+		},
+		resolveId(e) {
+			return e === "virtual:@dubium/icons-registry" ? s : null;
+		},
+		load(e) {
+			return e === s ? c(D(), C, b, (e) => this.resolve(e)) : null;
+		},
+		async handleHotUpdate(e) {
+			if (M(e.file) && await O(e.file, e.read)) return N(), P((e) => this.warn(e)), [];
+		}
+	};
+};
+//#endregion
+export { m as dubiumIcons };

package/dist/vite/plugin/plugin.types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Источник, из которого разрешаются имена иконок.
+ *
+ * @remarks
+ * Поддерживается два варианта: локальный каталог компонентов (`local`)
+ * и fallback-шаблон импорта из npm-пакета (`package`).
+ */
+export type TDubiumIconSource = {
+    /**
+     * Локальный источник иконок.
+     *
+     * @example
+     * `UserIcon.tsx` при suffix `Icon` даёт имя `User`.
+     */
+    type: "local";
+    /**
+     * Путь к директории с компонентами относительно Vite root.
+     */
+    path: string;
+    /**
+     * Суффикс имени файла, по которому распознаются компоненты иконок.
+     *
+     * @default "Icon"
+     */
+    suffix?: string;
+} | {
+    /**
+     * Package fallback для иконок, отсутствующих в local sources.
+     *
+     * @remarks
+     * Допускается не более одного `package` source.
+     * Шаблон должен содержать `{name}`.
+     */
+    type: "package";
+    /**
+     * Шаблон пути импорта.
+     *
+     * @example
+     * `@dubium/icons/icons/{name}`
+     */
+    importPattern: string;
+};
+/**
+ * Настройки Vite-плагина {@link dubiumIcons}.
+ */
+export interface DubiumIconsPluginOptions {
+    /**
+     * Дополнительные имена JSX-компонентов, которые scanner должен считать
+     * компонентами иконок независимо от import source.
+     *
+     * @remarks
+     * Обычный `Icon` из `@dubium/icons/vite` определяется автоматически,
+     * включая alias. Эту настройку следует использовать только для собственных
+     * обёрток или нестандартных компонентов.
+     *
+     * @default []
+     */
+    componentNames?: readonly string[];
+    /**
+     * Дополнительные строковые поля, которые считаются ссылками на иконки.
+     *
+     * @remarks
+     * Пустой массив отключает сканирование дополнительных свойств.
+     *
+     * @default []
+     */
+    propertyNames?: readonly string[];
+    /**
+     * Директории проекта, которые нужно сканировать.
+     *
+     * @remarks
+     * Пустой массив полностью отключает сканирование директорий.
+     *
+     * @default ["src"]
+     */
+    scan?: readonly string[];
+    /**
+     * Источники иконок.
+     *
+     * @remarks
+     * Можно указать несколько `local` sources; они проверяются сверху вниз.
+     * Дополнительно можно указать максимум один `package` source,
+     * который используется как fallback.
+     *
+     * Пустой массив означает, что автоматические источники
+     * иконок использоваться не будут.
+     *
+     * @example
+     * ```ts
+     * dubiumIcons({
+     * 	sources: [
+     * 		{ type: "local", path: "src/icons" },
+     * 		{ type: "package", importPattern: "@dubium/icons/icons/{name}" },
+     * 	],
+     * })
+     * ```
+     */
+    sources?: readonly TDubiumIconSource[];
+}

package/dist/vite/plugin/scanner/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Публичный API модуля сканера исходников.
+ *
+ * @remarks
+ * Экспортирует {@link scanSource} — функцию, которая собирает статические
+ * имена иконок из JSX-тегов, импортов `Icon` и строковых свойств.
+ */
+export { scanSource } from "./scanner.source.js";
+export type { ScanResult } from "./scanner.types.js";

package/dist/vite/plugin/scanner/scanner.imports.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Определяет локальные имена компонента `Icon`, реально импортированного
+ * из `@dubium/icons/vite`.
+ */
+export declare const findImportedIconComponentNames: (source: string) => string[];

package/dist/vite/plugin/scanner/scanner.imports.js

@@ -0,0 +1,36 @@
+import { REGEX as e } from "./scanner.regex.js";
+import { isIdentifierCharacter as t, walkCode as n } from "./scanner.lexical.js";
+//#region src/icons/vite/plugin/scanner/scanner.imports.ts
+var r = "@dubium/icons/vite", i = (e, n, r) => {
+	if (!e.startsWith(r, n)) return !1;
+	let i = e[n - 1], a = e[n + r.length];
+	return !t(i) && !t(a);
+}, a = (t) => t.replace(e.COMMENTS.MULTILINE, " ").replace(e.COMMENTS.SINGLE_LINE, " "), o = (t, n) => {
+	let i = t.slice(n), o = e.IMPORT.STATEMENT.exec(i);
+	if (!o) return null;
+	let [s, c, , l] = o;
+	if (l !== r) return null;
+	let u = [], d = a(c).split(",");
+	for (let t of d) {
+		let n = t.trim();
+		if (!n || n.startsWith("type ")) continue;
+		let r = e.IMPORT.ICON_SPECIFIER.exec(n);
+		r && u.push(r[1] ?? "Icon");
+	}
+	return {
+		componentNames: u,
+		endIndex: n + o[0].length
+	};
+}, s = (e) => {
+	let t = /* @__PURE__ */ new Set();
+	return n(e, ({ index: n, skipTo: r }) => {
+		if (!i(e, n, "import")) return;
+		let a = o(e, n);
+		if (a) {
+			for (let e of a.componentNames) t.add(e);
+			r(a.endIndex);
+		}
+	}), [...t];
+};
+//#endregion
+export { s as findImportedIconComponentNames };

package/dist/vite/plugin/scanner/scanner.jsx.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Находит позиции всех JSX-тегов компонентов иконок в исходном тексте.
+ *
+ * @remarks
+ * Общий lexical walker игнорирует комментарии, строки, template literals
+ * и RegExp literals, поэтому ложные `<Icon>` внутри них не учитываются.
+ */
+export declare const findComponentTagStarts: (source: string, componentNames: readonly string[]) => number[];
+/**
+ * Находит индекс закрывающей угловой скобки открывающего JSX-тега.
+ *
+ * @remarks
+ * Поиск учитывает содержимое строк и шаблонных строк, а также глубину вложенности
+ * фигурных скобок `{}` JSX-выражений.
+ */
+export declare const findTagEnd: (source: string, startIndex: number) => number;
+/**
+ * Извлекает статическое значение атрибута `name` из открывающего JSX-тега.
+ */
+export declare const parseStaticName: (openingTag: string) => string | null;
+/**
+ * Проверяет, присутствует ли у открывающего JSX-тега атрибут `name`.
+ */
+export declare const hasNameAttribute: (openingTag: string) => boolean;