feat: добавить поддержку 20 framework exact modes

Добавлены exact modes:
- vue@vite и vue@webpack
- nuxt@vite и nuxt@webpack
- svelte@vite, svelte@webpack и sveltekit@vite
- angular@application и angular@webpack
- astro@vite
- solid@vite, solid@webpack и solid-start@vite
- preact@vite и preact@webpack
- qwik@vite
- lit@vite и lit@webpack
- alpine@vite и alpine@webpack

Для каждого mode реализованы изолированный adapter, нативный
framework-компонент, declarations, manifest, CSS и внешний asset URL.

Добавлены production integration-стенды с генерацией, typecheck,
сборкой и Playwright-проверкой рендера спрайта и Viewer.

Обновлены Viewer, RU/EN-гайды, README, technical reference и AI skills.
Итоговая матрица включает 29 exact modes.

Проверки:
- 48 unit-тестов
- 29 integration E2E-тестов

integration/apps/preact-webpack/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@svg-sprites-fixtures/preact-webpack",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "sprites": "svg-sprites src/sprite/svg-sprite.config.ts",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run sprites && npm run typecheck && webpack --mode production",
+    "dev": "npm run sprites && webpack serve --mode development"
+  },
+  "dependencies": {
+    "preact": "10.27.2"
+  },
+  "devDependencies": {
+    "@gromlab/svg-sprites": "file:../../..",
+    "css-loader": "7.1.4",
+    "html-webpack-plugin": "5.6.7",
+    "style-loader": "4.0.0",
+    "typescript": "6.0.2",
+    "webpack": "5.108.4",
+    "webpack-cli": "7.2.1",
+    "webpack-dev-server": "5.2.2"
+  }
+}

integration/apps/preact-webpack/src/generated-contract.typecheck.ts

@@ -0,0 +1,13 @@
+import { IconsIcon, iconsIconNames } from './sprite/index.js'
+import type { IconsIconName, IconsIconProps } from './sprite/index.js'
+
+const iconName: IconsIconName = 'check'
+const props: IconsIconProps = { icon: iconName, width: 24 }
+
+void IconsIcon
+void iconsIconNames
+void props
+
+// @ts-expect-error Generated icon names form a literal union.
+const missingIcon: IconsIconName = 'missing'
+void missingIcon

integration/apps/preact-webpack/src/main.js

@@ -0,0 +1,34 @@
+import { h, render } from 'preact'
+
+import '@gromlab/svg-sprites/viewer/element'
+import { IconsIcon } from './sprite/index.js'
+import './style.css'
+
+const viewerSources = [
+  () => import('./sprite/.svg-sprite/svg-sprite.manifest.js'),
+]
+
+function App() {
+  const connectViewer = (viewer) => {
+    if (viewer) viewer.sources = viewerSources
+  }
+
+  return h('main', null,
+    h('h1', null, 'Preact + Webpack'),
+    h(IconsIcon, {
+      'data-testid': 'icon',
+      'data-app': 'preact-webpack',
+      icon: 'check',
+      'aria-label': 'Check icon',
+      width: 64,
+      height: 64,
+      style: { '--icon-color-1': '#16a34a' },
+    }),
+    h('gromlab-sprite-viewer', {
+      ref: connectViewer,
+      'viewer-title': 'Preact Webpack Viewer',
+    }),
+  )
+}
+
+render(h(App), document.getElementById('root'))

integration/apps/preact-webpack/src/sprite/.gitignore

@@ -0,0 +1,2 @@
+# @generated by @gromlab/svg-sprites. Do not edit.
+/.svg-sprite/

integration/apps/preact-webpack/src/sprite/index.d.ts

@@ -0,0 +1 @@
+export * from './.svg-sprite/index.js'

integration/apps/preact-webpack/src/sprite/index.js

@@ -0,0 +1 @@
+export * from './.svg-sprite/index.js'

integration/apps/preact-webpack/src/sprite/svg-sprite.config.ts

@@ -0,0 +1,8 @@
+import { defineSpriteConfig } from '@gromlab/svg-sprites'
+
+export default defineSpriteConfig({
+  mode: 'preact@webpack',
+  name: 'icons',
+  input: '../../../../fixtures/icons/check.svg',
+  generatedNotice: false,
+})

integration/apps/preact-webpack/src/style.css

@@ -0,0 +1,15 @@
+:root {
+  font-family: system-ui, sans-serif;
+  color: #172033;
+  background: #fff;
+}
+
+body {
+  margin: 0;
+  padding: 40px;
+}
+
+gromlab-sprite-viewer {
+  display: block;
+  margin-top: 32px;
+}

integration/apps/preact-webpack/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts"]
+}

integration/apps/preact-webpack/webpack.config.js

@@ -0,0 +1,40 @@
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import HtmlWebpackPlugin from 'html-webpack-plugin'
+
+const root = path.dirname(fileURLToPath(import.meta.url))
+
+export default {
+  entry: './src/main.js',
+  output: {
+    path: path.join(root, 'dist'),
+    filename: 'assets/app.[contenthash].js',
+    assetModuleFilename: 'assets/[name].[contenthash][ext]',
+    clean: true,
+  },
+  resolve: {
+    extensions: ['.js'],
+    alias: {
+      preact: path.resolve(root, '../../node_modules/preact'),
+    },
+  },
+  module: {
+    rules: [
+      {
+        test: /\.module\.css$/,
+        use: ['style-loader', { loader: 'css-loader', options: { modules: { namedExport: false } } }],
+      },
+      {
+        test: /\.css$/,
+        exclude: /\.module\.css$/,
+        use: ['style-loader', 'css-loader'],
+      },
+    ],
+  },
+  plugins: [
+    new HtmlWebpackPlugin({
+      templateContent: '<!doctype html><html><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Preact Webpack sprite fixture</title></head><body><div id="root"></div></body></html>',
+    }),
+  ],
+}