@affectively/neural 5.0.0 → 5.0.2

package/dist/backend/factory.js

@@ -1,37 +0,0 @@
-import { WebGPUBackend } from './webgpu';
-import { WebNNBackend } from './webnn';
-export var BackendType;
-(function (BackendType) {
-    BackendType["WebGPU"] = "WebGPU";
-    BackendType["WebNN"] = "WebNN";
-    BackendType["Auto"] = "Auto";
-})(BackendType || (BackendType = {}));
-export async function getBackend(type = BackendType.Auto) {
-    const webnn = new WebNNBackend();
-    const webgpu = new WebGPUBackend();
-    if (type === BackendType.WebNN) {
-        await webnn.initialize();
-        return webnn;
-    }
-    if (type === BackendType.WebGPU) {
-        await webgpu.initialize();
-        return webgpu;
-    }
-    // Auto Selection Strategy:
-    // 1. Try WebNN (NPU) first for efficiency/speed
-    // 2. Fallback to WebGPU
-    // 3. (Future) Fallback to WASM
-    if (await webnn.isSupported()) {
-        try {
-            console.log('Neural 3.0: Attempting WebNN initialization...');
-            await webnn.initialize();
-            return webnn;
-        }
-        catch (err) {
-            console.warn('Neural 3.0: WebNN failed to initialize, falling back to WebGPU', err);
-        }
-    }
-    console.log('Neural 3.0: initializing WebGPU...');
-    await webgpu.initialize();
-    return webgpu;
-}

package/dist/backend/types.d.ts

@@ -1,33 +0,0 @@
-/**
- * Represents a tensor on the compute device.
- */
-export interface Tensor {
-    /** Raw data (if downloaded to CPU) */
-    data?: Float32Array;
-    /** Shape of the tensor */
-    shape: number[];
-    /**
-     * The underlying buffer on the device.
-     * - WebGPU: GPUBuffer
-     * - WebNN: MLOperand
-     */
-    buffer?: any;
-}
-/**
- * Abstract interface for a compute backend (WebGPU or WebNN).
- */
-export interface ComputeBackend {
-    name: string;
-    /**
-     * Checks if this backend is supported in the current environment.
-     */
-    isSupported(): Promise<boolean>;
-    /**
-     * Initializes the backend context.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Creates a tensor from the given data.
-     */
-    createTensor(data: Float32Array, shape: number[]): Promise<Tensor>;
-}

package/dist/backend/types.js

@@ -1 +0,0 @@
-export {};

package/dist/backend/webgpu/index.d.ts

@@ -1,9 +0,0 @@
-import { ComputeBackend, Tensor } from '../types';
-export declare class WebGPUBackend implements ComputeBackend {
-    name: string;
-    private adapter;
-    private device;
-    isSupported(): Promise<boolean>;
-    initialize(): Promise<void>;
-    createTensor(data: Float32Array, shape: number[]): Promise<Tensor>;
-}

package/dist/backend/webgpu/index.js

@@ -1,37 +0,0 @@
-export class WebGPUBackend {
-    name = 'WebGPU';
-    adapter = null;
-    device = null;
-    async isSupported() {
-        return typeof navigator !== 'undefined' && 'gpu' in navigator;
-    }
-    async initialize() {
-        if (!await this.isSupported()) {
-            throw new Error('WebGPU is not supported');
-        }
-        this.adapter = await navigator.gpu.requestAdapter();
-        if (!this.adapter) {
-            throw new Error('Failed to request WebGPU adapter');
-        }
-        this.device = await this.adapter.requestDevice();
-        console.log(`WebGPU initialized: ${this.adapter.info.vendor} ${this.adapter.info.architecture}`);
-    }
-    async createTensor(data, shape) {
-        if (!this.device)
-            throw new Error('WebGPUBackend not initialized');
-        // Create a buffer for the tensor on the GPU
-        const buffer = this.device.createBuffer({
-            size: data.byteLength,
-            usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
-            mappedAtCreation: true
-        });
-        // Write data to the mapped buffer
-        new Float32Array(buffer.getMappedRange()).set(data);
-        buffer.unmap();
-        return {
-            data, // Keep a CPU copy for now for debugging
-            shape,
-            buffer
-        };
-    }
-}

package/dist/backend/webnn/index.d.ts

@@ -1,14 +0,0 @@
-import { ComputeBackend, Tensor } from '../types';
-declare global {
-    interface Navigator {
-        ml: any;
-    }
-}
-export declare class WebNNBackend implements ComputeBackend {
-    name: string;
-    private context;
-    private builder;
-    isSupported(): Promise<boolean>;
-    initialize(): Promise<void>;
-    createTensor(data: Float32Array, shape: number[]): Promise<Tensor>;
-}

package/dist/backend/webnn/index.js

@@ -1,39 +0,0 @@
-export class WebNNBackend {
-    name = 'WebNN';
-    context = null;
-    builder = null;
-    async isSupported() {
-        return typeof navigator !== 'undefined' && 'ml' in navigator;
-    }
-    async initialize() {
-        if (!await this.isSupported()) {
-            throw new Error('WebNN is not supported');
-        }
-        try {
-            // 1. Create Context (Access to NPU/GPU/CPU)
-            this.context = await navigator.ml.createContext();
-            // 2. Create Graph Builder (Use this to construct the compute graph)
-            this.builder = new window.MLGraphBuilder(this.context);
-            console.log('WebNN: Context initialized successfully');
-        }
-        catch (err) {
-            console.error('WebNN: Initialization failed', err);
-            throw err;
-        }
-    }
-    async createTensor(data, shape) {
-        if (!this.context)
-            throw new Error('WebNNBackend not initialized');
-        // In WebNN, we often bind data at execution time rather than uploading strictly beforehand
-        // But for the abstraction, we can treat constant data as inputs.
-        // For now, return the CPU data, and we will bind it as an MLBuffer or Input/Constant during graph execution.
-        // Note: WebNN currently deals in Operations. 
-        // Data is usually an input to the `compute` method.
-        // We will store the Float32Array as the "buffer" for now.
-        return {
-            data,
-            shape,
-            buffer: data // Holding the reference for now
-        };
-    }
-}

package/src/backend/factory.ts

@@ -1,43 +0,0 @@
-import { ComputeBackend } from './types';
-import { WebGPUBackend } from './webgpu';
-import { WebNNBackend } from './webnn';
-
-export enum BackendType {
-  WebGPU = 'WebGPU',
-  WebNN = 'WebNN',
-  Auto = 'Auto'
-}
-
-export async function getBackend(type: BackendType = BackendType.Auto): Promise<ComputeBackend> {
-  const webnn = new WebNNBackend();
-  const webgpu = new WebGPUBackend();
-
-  if (type === BackendType.WebNN) {
-    await webnn.initialize();
-    return webnn;
-  }
-
-  if (type === BackendType.WebGPU) {
-    await webgpu.initialize();
-    return webgpu;
-  }
-
-  // Auto Selection Strategy:
-  // 1. Try WebNN (NPU) first for efficiency/speed
-  // 2. Fallback to WebGPU
-  // 3. (Future) Fallback to WASM
-  
-  if (await webnn.isSupported()) {
-    try {
-      console.log('Neural 3.0: Attempting WebNN initialization...');
-      await webnn.initialize();
-      return webnn;
-    } catch (err) {
-      console.warn('Neural 3.0: WebNN failed to initialize, falling back to WebGPU', err);
-    }
-  }
-
-  console.log('Neural 3.0: initializing WebGPU...');
-  await webgpu.initialize();
-  return webgpu;
-}

package/src/backend/types.ts

@@ -1,39 +0,0 @@
-/**
- * Represents a tensor on the compute device.
- */
-export interface Tensor {
-  /** Raw data (if downloaded to CPU) */
-  data?: Float32Array;
-  /** Shape of the tensor */
-  shape: number[];
-  /** 
-   * The underlying buffer on the device.
-   * - WebGPU: GPUBuffer
-   * - WebNN: MLOperand
-   */
-  buffer?: any; 
-}
-
-/**
- * Abstract interface for a compute backend (WebGPU or WebNN).
- */
-export interface ComputeBackend {
-  name: string;
-  
-  /**
-   * Checks if this backend is supported in the current environment.
-   */
-  isSupported(): Promise<boolean>;
-
-  /**
-   * Initializes the backend context.
-   */
-  initialize(): Promise<void>;
-
-  /**
-   * Creates a tensor from the given data.
-   */
-  createTensor(data: Float32Array, shape: number[]): Promise<Tensor>;
-  
-  // Future operators will be added here (matmul, add, etc.)
-}

package/src/backend/webgpu/index.ts

@@ -1,46 +0,0 @@
-import { ComputeBackend, Tensor } from '../types';
-
-export class WebGPUBackend implements ComputeBackend {
-  name = 'WebGPU';
-  private adapter: GPUAdapter | null = null;
-  private device: GPUDevice | null = null;
-
-  async isSupported(): Promise<boolean> {
-    return typeof navigator !== 'undefined' && 'gpu' in navigator;
-  }
-
-  async initialize(): Promise<void> {
-    if (!await this.isSupported()) {
-      throw new Error('WebGPU is not supported');
-    }
-
-    this.adapter = await navigator.gpu.requestAdapter();
-    if (!this.adapter) {
-      throw new Error('Failed to request WebGPU adapter');
-    }
-
-    this.device = await this.adapter.requestDevice();
-    console.log(`WebGPU initialized: ${this.adapter.info.vendor} ${this.adapter.info.architecture}`);
-  }
-
-  async createTensor(data: Float32Array, shape: number[]): Promise<Tensor> {
-    if (!this.device) throw new Error('WebGPUBackend not initialized');
-
-    // Create a buffer for the tensor on the GPU
-    const buffer = this.device.createBuffer({
-      size: data.byteLength,
-      usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
-      mappedAtCreation: true
-    });
-
-    // Write data to the mapped buffer
-    new Float32Array(buffer.getMappedRange()).set(data);
-    buffer.unmap();
-
-    return {
-      data, // Keep a CPU copy for now for debugging
-      shape,
-      buffer
-    };
-  }
-}

package/src/backend/webnn/index.ts

@@ -1,55 +0,0 @@
-import { ComputeBackend, Tensor } from '../types';
-
-// Augment the navigator interface for WebNN (types might be missing in default libs)
-declare global {
-  interface Navigator {
-    ml: any;
-  }
-}
-
-export class WebNNBackend implements ComputeBackend {
-  name = 'WebNN';
-  private context: any = null;
-  private builder: any = null;
-
-  async isSupported(): Promise<boolean> {
-    return typeof navigator !== 'undefined' && 'ml' in navigator;
-  }
-
-  async initialize(): Promise<void> {
-    if (!await this.isSupported()) {
-      throw new Error('WebNN is not supported');
-    }
-
-    try {
-      // 1. Create Context (Access to NPU/GPU/CPU)
-      this.context = await navigator.ml.createContext();
-      
-      // 2. Create Graph Builder (Use this to construct the compute graph)
-      this.builder = new (window as any).MLGraphBuilder(this.context);
-      
-      console.log('WebNN: Context initialized successfully');
-    } catch (err) {
-      console.error('WebNN: Initialization failed', err);
-      throw err;
-    }
-  }
-
-  async createTensor(data: Float32Array, shape: number[]): Promise<Tensor> {
-    if (!this.context) throw new Error('WebNNBackend not initialized');
-
-    // In WebNN, we often bind data at execution time rather than uploading strictly beforehand
-    // But for the abstraction, we can treat constant data as inputs.
-    // For now, return the CPU data, and we will bind it as an MLBuffer or Input/Constant during graph execution.
-    
-    // Note: WebNN currently deals in Operations. 
-    // Data is usually an input to the `compute` method.
-    // We will store the Float32Array as the "buffer" for now.
-    
-    return {
-      data,
-      shape,
-      buffer: data // Holding the reference for now
-    };
-  }
-}

package/src/index.ts

@@ -1,14 +0,0 @@
-export * from './backend/types';
-export * from './backend/factory';
-export * from './backend/webgpu';
-export * from './backend/webnn';
-
-// Re-export specific classes if needed for direct access
-import { getBackend } from './backend/factory';
-
-export class NeuralEngine {
-  // Placeholder for the high-level engine that uses the backend
-  static async create() {
-    return getBackend();
-  }
-}

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "declaration": true,
-    "outDir": "dist",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "lib": ["ESNext", "DOM"],
-    "types": ["@webgpu/types"]
-  },
-  "include": ["src/**/*"]
-}

package/verify.ts

@@ -1,22 +0,0 @@
-import { getBackend, BackendType } from './src';
-
-async function main() {
-  console.log('--- Neural 3.0 Verification ---');
-  
-  // Mock navigator for Node environment testing if needed, 
-  // but strictly this is meant for browser.
-  // We can just check if it compiles for now.
-  
-  try {
-    const backend = await getBackend(BackendType.Auto);
-    console.log(`Success: Initialized ${backend.name} backend.`);
-  } catch (err) {
-    if (typeof navigator === 'undefined') {
-        console.log('Running in Node - skipping browser-only initialization.');
-    } else {
-        console.error('Initialization failed:', err);
-    }
-  }
-}
-
-main();