@aelionsdk/vite-plugin 0.1.0-beta.1 → 1.0.0-rc.1

package/README.md

@@ -1,6 +1,7 @@
 # `@aelionsdk/vite-plugin`
 
-Official Vite integration for AelionSDK's module Worker and AudioWorklet entry files.
+Official Vite integration plus Webpack/Rspack and explicit CDN helpers for AelionSDK's module
+Worker and AudioWorklet entry files.
 
 ## Install
 
@@ -33,6 +34,28 @@ aelion({ audioWorklets: true, exportWorker: true, rendererWorker: true });
 
 All flags default to `true`. A disabled asset group must not be used by application code.
 
+## Webpack and Rspack
+
+```ts
+import { AelionWebpackPlugin, aelionRuntimeAssetUrls } from '@aelionsdk/vite-plugin';
+
+// webpack.config.ts / rspack.config.ts
+export default {
+  plugins: [new AelionWebpackPlugin()],
+};
+
+// Client-only application module
+const runtimeAssets = aelionRuntimeAssetUrls('/');
+```
+
+The adapter emits stable `aelion/{audio,renderer-worker,export}` paths and works against the
+Webpack 5-compatible hooks exposed by Rspack. Pass `runtimeAssets` to `Aelion.createSession()`.
+
+For a custom build or CDN copy step, use `loadAelionRuntimeAssets(outputDirectory)`. For an
+already-deployed versioned CDN directory, use
+`aelionRuntimeAssetUrls('https://cdn.example/sdk/0.1.0/')`; keep application modules and all four
+runtime entries on the same SDK version.
+
 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.
+This package is part of [AelionSDK](https://github.com/FoyonaCZY/AelionSDK). The `1.0.0-rc.1` API may change before the first stable release.

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { Plugin } from 'vite';
+export * from './runtime-assets.js';
 /** Options for the official Aelion Vite integration. */
 export interface AelionVitePluginOptions {
     /** Emit and serve both `@aelionsdk/audio` AudioWorklet entries. Defaults to true. */

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,cAAc,qBAAqB,CAAC;AAiBpC,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

@@ -1,6 +1,7 @@
 import { readFile } from 'node:fs/promises';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+export * from './runtime-assets.js';
 const virtualPrefix = '\0@aelionsdk/vite-plugin:runtime-asset:';
 const publicPrefix = '/@aelionsdk/vite-plugin/runtime-assets';
 function normalizedModuleId(id) {

package/dist/runtime-assets.d.ts

@@ -0,0 +1,58 @@
+export interface AelionRuntimeAssetUrls {
+    readonly rendererWorker: string;
+    readonly exportWorker: string;
+    readonly sharedAudioWorklet: string;
+    readonly transferableAudioWorklet: string;
+}
+export interface AelionRuntimeAssetFile {
+    readonly key: keyof AelionRuntimeAssetUrls;
+    readonly outputPath: string;
+    readonly bytes: Uint8Array;
+}
+export interface AelionWebpackPluginOptions {
+    /** Emitted directory inside the bundler output. Defaults to `aelion`. */
+    readonly outputDirectory?: string;
+}
+interface CompilationLike {
+    readonly hooks: {
+        readonly processAssets: {
+            tapPromise(options: {
+                readonly name: string;
+                readonly stage: number;
+            }, callback: () => Promise<void>): void;
+        };
+    };
+    emitAsset(name: string, source: unknown): void;
+}
+interface CompilerLike {
+    readonly webpack: {
+        readonly Compilation: {
+            readonly PROCESS_ASSETS_STAGE_ADDITIONAL: number;
+        };
+        readonly sources: {
+            readonly RawSource: new (bytes: Uint8Array) => unknown;
+        };
+    };
+    readonly hooks: {
+        readonly thisCompilation: {
+            tap(name: string, callback: (compilation: CompilationLike) => void): void;
+        };
+    };
+}
+/** Explicit URLs for ESM/CDN/Next.js clients that serve the four runtime entries themselves. */
+export declare function aelionRuntimeAssetUrls(publicBase?: string, outputDirectory?: string): AelionRuntimeAssetUrls;
+/** Reads the built package entries for custom copy pipelines and non-Webpack bundlers. */
+export declare function loadAelionRuntimeAssets(outputDirectory?: string): Promise<readonly AelionRuntimeAssetFile[]>;
+/**
+ * Webpack 5/Rspack adapter. It emits the same stable asset layout used by
+ * `AelionSessionOptions.runtimeAssets`; applications pass `runtimeAssets()`
+ * from a client-only module.
+ */
+export declare class AelionWebpackPlugin {
+    #private;
+    constructor(options?: AelionWebpackPluginOptions);
+    runtimeAssets(publicBase?: string): AelionRuntimeAssetUrls;
+    apply(compiler: CompilerLike): void;
+}
+export {};
+//# sourceMappingURL=runtime-assets.d.ts.map

package/dist/runtime-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-assets.d.ts","sourceRoot":"","sources":["../src/runtime-assets.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;CAC3C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,aAAa,EAAE;YACtB,UAAU,CACR,OAAO,EAAE;gBAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;aAAE,EAC1D,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC5B,IAAI,CAAC;SACT,CAAC;KACH,CAAC;IACF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAChD;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,WAAW,EAAE;YAAE,QAAQ,CAAC,+BAA+B,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3E,QAAQ,CAAC,OAAO,EAAE;YAChB,QAAQ,CAAC,SAAS,EAAE,KAAK,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;SACxD,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,eAAe,EAAE;YACxB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAC;SAC3E,CAAC;KACH,CAAC;CACH;AA+CD,gGAAgG;AAChG,wBAAgB,sBAAsB,CACpC,UAAU,SAAa,EACvB,eAAe,SAAW,GACzB,sBAAsB,CAOxB;AAED,0FAA0F;AAC1F,wBAAsB,uBAAuB,CAC3C,eAAe,SAAW,GACzB,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAa5C;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;;gBAGX,OAAO,GAAE,0BAA+B;IAIpD,aAAa,CAAC,UAAU,SAAM,GAAG,sBAAsB;IAIvD,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;CAmB3C"}

package/dist/runtime-assets.js

@@ -0,0 +1,89 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, posix, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+function packageDistDirectory(packageName) {
+    return dirname(fileURLToPath(import.meta.resolve(packageName)));
+}
+function specifications(outputDirectory) {
+    return [
+        {
+            key: 'sharedAudioWorklet',
+            packageName: '@aelionsdk/audio',
+            fileName: 'pcm-player.worklet.js',
+            directory: posix.join(outputDirectory, 'audio'),
+        },
+        {
+            key: 'transferableAudioWorklet',
+            packageName: '@aelionsdk/audio',
+            fileName: 'pcm-message-player.worklet.js',
+            directory: posix.join(outputDirectory, 'audio'),
+        },
+        {
+            key: 'rendererWorker',
+            packageName: '@aelionsdk/renderer-worker',
+            fileName: 'webgl2-worker.js',
+            directory: posix.join(outputDirectory, 'renderer-worker'),
+        },
+        {
+            key: 'exportWorker',
+            packageName: '@aelionsdk/export',
+            fileName: 'mux-export-worker.js',
+            directory: posix.join(outputDirectory, 'export'),
+        },
+    ];
+}
+function normalizedDirectory(value) {
+    const result = value.replaceAll('\\', '/').replace(/^\/+|\/+$/gu, '');
+    if (result.length === 0 || result.split('/').some(part => part === '.' || part === '..')) {
+        throw new TypeError('outputDirectory must be a safe relative path');
+    }
+    return result;
+}
+function baseUrl(value) {
+    return `${value.replace(/\/+$/gu, '')}/`;
+}
+/** Explicit URLs for ESM/CDN/Next.js clients that serve the four runtime entries themselves. */
+export function aelionRuntimeAssetUrls(publicBase = '/aelion/', outputDirectory = 'aelion') {
+    const prefix = baseUrl(publicBase);
+    const entries = specifications(normalizedDirectory(outputDirectory)).map(specification => [
+        specification.key,
+        `${prefix}${specification.directory}/${specification.fileName}`,
+    ]);
+    return Object.freeze(Object.fromEntries(entries));
+}
+/** Reads the built package entries for custom copy pipelines and non-Webpack bundlers. */
+export async function loadAelionRuntimeAssets(outputDirectory = 'aelion') {
+    const files = await Promise.all(specifications(normalizedDirectory(outputDirectory)).map(async (specification) => ({
+        key: specification.key,
+        outputPath: posix.join(specification.directory, specification.fileName),
+        bytes: new Uint8Array(await readFile(resolve(packageDistDirectory(specification.packageName), specification.fileName))),
+    })));
+    return Object.freeze(files);
+}
+/**
+ * Webpack 5/Rspack adapter. It emits the same stable asset layout used by
+ * `AelionSessionOptions.runtimeAssets`; applications pass `runtimeAssets()`
+ * from a client-only module.
+ */
+export class AelionWebpackPlugin {
+    #outputDirectory;
+    constructor(options = {}) {
+        this.#outputDirectory = normalizedDirectory(options.outputDirectory ?? 'aelion');
+    }
+    runtimeAssets(publicBase = '/') {
+        return aelionRuntimeAssetUrls(publicBase, this.#outputDirectory);
+    }
+    apply(compiler) {
+        const pluginName = '@aelionsdk/webpack-plugin';
+        compiler.hooks.thisCompilation.tap(pluginName, compilation => {
+            compilation.hooks.processAssets.tapPromise({
+                name: pluginName,
+                stage: compiler.webpack.Compilation.PROCESS_ASSETS_STAGE_ADDITIONAL,
+            }, async () => {
+                for (const asset of await loadAelionRuntimeAssets(this.#outputDirectory)) {
+                    compilation.emitAsset(asset.outputPath, new compiler.webpack.sources.RawSource(asset.bytes));
+                }
+            });
+        });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/vite-plugin",
-  "version": "0.1.0-beta.1",
+  "version": "1.0.0-rc.1",
   "description": "Official Vite integration for AelionSDK Worker and AudioWorklet assets",
   "license": "MIT",
   "repository": {
@@ -39,12 +39,12 @@
     "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"
+    "@aelionsdk/audio": "1.0.0-rc.1",
+    "@aelionsdk/export": "1.0.0-rc.1",
+    "@aelionsdk/renderer-worker": "1.0.0-rc.1"
   },
   "peerDependencies": {
-    "vite": "^7.0.0"
+    "vite": "^7.3.6"
   },
   "scripts": {
     "build": "tsc -b",