@aelionsdk/vite-plugin 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FoyonaCZY and AelionSDK contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# `@aelionsdk/vite-plugin`
+
+Official Vite integration for AelionSDK's module Worker and AudioWorklet entry files.
+
+## Install
+
+```bash
+pnpm add @aelionsdk/sdk@next
+pnpm add -D @aelionsdk/vite-plugin@next vite
+```
+
+```ts
+// vite.config.ts
+import { aelion } from '@aelionsdk/vite-plugin';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [aelion()],
+});
+```
+
+No asset paths or workspace aliases are required. During `vite build`, the plugin emits the
+published `@aelionsdk/renderer-worker` WebGL2 Worker, the `@aelionsdk/export` mux Worker, and both
+published `@aelionsdk/audio` AudioWorklet entry chunks, then rewrites the SDK package URLs to the
+generated hashed files. During `vite dev`, it exposes equivalent virtual module URLs through
+Vite's module server.
+
+The optional flags are only for applications that never load the corresponding runtime:
+
+```ts
+aelion({ audioWorklets: true, exportWorker: true, rendererWorker: true });
+```
+
+All flags default to `true`. A disabled asset group must not be used by application code.
+
+Production pages should use HTTPS. For the SharedArrayBuffer audio path, also return `Cross-Origin-Opener-Policy: same-origin` and `Cross-Origin-Embedder-Policy: require-corp`. CSP must allow same-origin `worker-src` and `script-src`.
+
+This package is part of [AelionSDK](https://github.com/FoyonaCZY/AelionSDK). The `0.1.0-beta.1` API may change before the first stable release.

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { Plugin } from 'vite';
+/** Options for the official Aelion Vite integration. */
+export interface AelionVitePluginOptions {
+    /** Emit and serve both `@aelionsdk/audio` AudioWorklet entries. Defaults to true. */
+    audioWorklets?: boolean;
+    /** Emit and serve the `@aelionsdk/renderer-worker` module Worker. Defaults to true. */
+    rendererWorker?: boolean;
+    /** Emit and serve the `@aelionsdk/export` mux Worker. Defaults to true. */
+    exportWorker?: boolean;
+}
+/**
+ * Adds the published Aelion Worker/AudioWorklet entry graphs to Vite builds and
+ * exposes the same module entries through the Vite development server.
+ */
+export declare function aelion(options?: AelionVitePluginOptions): Plugin;
+export default aelion;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAiBnC,wDAAwD;AACxD,MAAM,WAAW,uBAAuB;IACtC,qFAAqF;IACrF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA6CD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAmGpE;AAED,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,141 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const virtualPrefix = '\0@aelionsdk/vite-plugin:runtime-asset:';
+const publicPrefix = '/@aelionsdk/vite-plugin/runtime-assets';
+function normalizedModuleId(id) {
+    return id.split('?', 1)[0]?.replaceAll('\\', '/') ?? id.replaceAll('\\', '/');
+}
+function packageDistDirectory(packageName) {
+    return dirname(fileURLToPath(import.meta.resolve(packageName)));
+}
+function isPackageDistModule(id, asset) {
+    const normalizedId = normalizedModuleId(id);
+    const normalizedDirectory = asset.packageDistDirectory.replaceAll('\\', '/');
+    return (normalizedId.startsWith(`${normalizedDirectory}/`) ||
+        normalizedId.includes(`/node_modules/${asset.packageName}/dist/`));
+}
+function createRuntimeAsset(packageName, packageDist, fileName) {
+    const namespace = packageName === '@aelionsdk/audio'
+        ? 'audio'
+        : packageName === '@aelionsdk/export'
+            ? 'export'
+            : 'renderer-worker';
+    const key = `${namespace}/${fileName}`;
+    return {
+        entryFile: resolve(packageDist, fileName),
+        key,
+        packageName,
+        packageDistDirectory: packageDist,
+        publicUrl: `${publicPrefix}/${key}`,
+        referencePattern: new RegExp(String.raw `new URL\(\s*(['"])\.\/${fileName.replaceAll('.', String.raw `\.`)}\1\s*,\s*import\.meta\.url\s*\)`, 'gu'),
+        virtualId: `${virtualPrefix}${key}`,
+    };
+}
+/**
+ * Adds the published Aelion Worker/AudioWorklet entry graphs to Vite builds and
+ * exposes the same module entries through the Vite development server.
+ */
+export function aelion(options = {}) {
+    const includeAudioWorklets = options.audioWorklets ?? true;
+    const includeRendererWorker = options.rendererWorker ?? true;
+    const includeExportWorker = options.exportWorker ?? true;
+    const audioDist = includeAudioWorklets ? packageDistDirectory('@aelionsdk/audio') : undefined;
+    const rendererDist = includeRendererWorker
+        ? packageDistDirectory('@aelionsdk/renderer-worker')
+        : undefined;
+    const exportDist = includeExportWorker ? packageDistDirectory('@aelionsdk/export') : undefined;
+    const assets = [
+        ...(audioDist === undefined
+            ? []
+            : [
+                createRuntimeAsset('@aelionsdk/audio', audioDist, 'pcm-player.worklet.js'),
+                createRuntimeAsset('@aelionsdk/audio', audioDist, 'pcm-message-player.worklet.js'),
+            ]),
+        ...(rendererDist === undefined
+            ? []
+            : [createRuntimeAsset('@aelionsdk/renderer-worker', rendererDist, 'webgl2-worker.js')]),
+        ...(exportDist === undefined
+            ? []
+            : [createRuntimeAsset('@aelionsdk/export', exportDist, 'mux-export-worker.js')]),
+    ];
+    const assetByVirtualId = new Map(assets.map(asset => [asset.virtualId, asset]));
+    const assetByPublicUrl = new Map(assets.map(asset => [asset.publicUrl, asset]));
+    const emittedReferences = new Map();
+    let command;
+    return {
+        name: '@aelionsdk/vite-plugin',
+        enforce: 'pre',
+        config() {
+            const excluded = [
+                ...(includeAudioWorklets ? ['@aelionsdk/audio', '@aelionsdk/sdk'] : []),
+                ...(includeRendererWorker ? ['@aelionsdk/renderer-worker', '@aelionsdk/sdk'] : []),
+                ...(includeExportWorker ? ['@aelionsdk/export', '@aelionsdk/sdk'] : []),
+            ];
+            return {
+                optimizeDeps: {
+                    exclude: [...new Set(excluded)],
+                },
+            };
+        },
+        configResolved(config) {
+            command = config.command;
+        },
+        buildStart() {
+            if (command !== 'build')
+                return;
+            for (const asset of assets) {
+                emittedReferences.set(asset.key, this.emitFile({
+                    type: 'chunk',
+                    id: asset.virtualId,
+                    name: `aelion-${asset.key.replaceAll('/', '-')}`,
+                }));
+            }
+        },
+        resolveId(source, importer) {
+            if (assetByVirtualId.has(source))
+                return source;
+            const publicAsset = assetByPublicUrl.get(source.split('?', 1)[0] ?? source);
+            if (publicAsset !== undefined)
+                return publicAsset.virtualId;
+            if (importer?.startsWith(virtualPrefix) === true && source.startsWith('.')) {
+                const importerAsset = assetByVirtualId.get(importer);
+                if (importerAsset !== undefined) {
+                    return resolve(dirname(importerAsset.entryFile), source);
+                }
+            }
+            return undefined;
+        },
+        async load(id) {
+            const asset = assetByVirtualId.get(id);
+            return asset === undefined ? undefined : readFile(asset.entryFile, 'utf8');
+        },
+        transform(source, id) {
+            let transformed = source;
+            let changed = false;
+            for (const asset of assets) {
+                if (!isPackageDistModule(id, asset))
+                    continue;
+                asset.referencePattern.lastIndex = 0;
+                if (!asset.referencePattern.test(transformed))
+                    continue;
+                asset.referencePattern.lastIndex = 0;
+                let replacement;
+                if (command === 'serve') {
+                    replacement = `new URL(${JSON.stringify(asset.publicUrl)}, import.meta.url)`;
+                }
+                else {
+                    const referenceId = emittedReferences.get(asset.key);
+                    if (referenceId === undefined) {
+                        this.error(`Aelion runtime asset ${asset.key} was not emitted before transform`);
+                    }
+                    replacement = `new URL(import.meta.ROLLUP_FILE_URL_${referenceId}, import.meta.url)`;
+                }
+                transformed = transformed.replace(asset.referencePattern, replacement);
+                changed = true;
+            }
+            return changed ? { code: transformed, map: null } : undefined;
+        },
+    };
+}
+export default aelion;

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@aelionsdk/vite-plugin",
+  "version": "0.1.0-beta.1",
+  "description": "Official Vite integration for AelionSDK Worker and AudioWorklet assets",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FoyonaCZY/AelionSDK.git",
+    "directory": "packages/vite-plugin"
+  },
+  "homepage": "https://github.com/FoyonaCZY/AelionSDK#readme",
+  "bugs": {
+    "url": "https://github.com/FoyonaCZY/AelionSDK/issues"
+  },
+  "keywords": [
+    "aelion",
+    "vite",
+    "video",
+    "worker",
+    "audioworklet"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo"
+  ],
+  "engines": {
+    "node": ">=20.19"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@aelionsdk/audio": "0.1.0-beta.1",
+    "@aelionsdk/export": "0.1.0-beta.1",
+    "@aelionsdk/renderer-worker": "0.1.0-beta.1"
+  },
+  "peerDependencies": {
+    "vite": "^7.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "corepack pnpm run build && node test/vite-plugin.test-runner.mjs",
+    "typecheck": "tsc -b --pretty false"
+  }
+}