@vib3code/sdk 2.0.1

package/types/creative/TransitionAnimator.d.ts

@@ -0,0 +1,71 @@
+/**
+ * TransitionAnimator TypeScript Definitions
+ * VIB3+ SDK - Smooth Parameter Transitions with Easing
+ */
+
+import { ParameterUpdateFn } from '../reactivity/index';
+
+/** Available easing function names */
+export type EasingName =
+    | 'linear'
+    | 'easeIn' | 'easeOut' | 'easeInOut'
+    | 'easeInQuad' | 'easeOutQuad'
+    | 'bounce' | 'elastic'
+    | 'cubic'
+    | 'backOut' | 'backIn'
+    | 'expoOut' | 'expoIn'
+    | 'sineInOut';
+
+/** A single step in a sequence */
+export interface SequenceStep {
+    params: Record<string, number>;
+    duration?: number;
+    easing?: EasingName;
+    delay?: number;
+}
+
+/**
+ * Smooth parameter transitions with 14 easing functions.
+ * Supports single transitions, target-state transitions, and multi-step sequences.
+ */
+export declare class TransitionAnimator {
+    constructor(parameterUpdateFn: ParameterUpdateFn, parameterGetFn?: ((name: string) => number | null) | null);
+
+    /** Transition specific parameters to values */
+    transition(
+        params: Record<string, number>,
+        duration?: number,
+        easing?: EasingName,
+        onComplete?: () => void,
+        onUpdate?: (progress: number) => void
+    ): string;
+
+    /** Transition from current values to target state */
+    transitionTo(
+        targetState: Record<string, number>,
+        duration?: number,
+        easing?: EasingName,
+        onComplete?: () => void
+    ): string;
+
+    /** Run a sequence of transition steps */
+    sequence(steps: SequenceStep[], onComplete?: () => void): string;
+
+    /** Cancel a specific transition by ID */
+    cancel(id: string): boolean;
+
+    /** Cancel all active transitions */
+    cancelAll(): void;
+
+    /** Whether any transitions are active */
+    isAnimating(): boolean;
+
+    /** Get count of active transitions */
+    getActiveCount(): number;
+
+    /** Get all available easing function names */
+    getEasingNames(): EasingName[];
+
+    /** Dispose and cancel all */
+    dispose(): void;
+}

package/types/creative/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Creative Module TypeScript Definitions
+ * VIB3+ SDK - Color Presets, Transitions, Post-Processing, Timeline
+ */
+
+export {
+    ColorPresetsSystem,
+    ColorPresetConfig,
+    PresetInfo,
+    PresetsByCategory,
+    BuiltinPresetName
+} from './ColorPresetsSystem';
+
+export {
+    TransitionAnimator,
+    EasingName,
+    SequenceStep
+} from './TransitionAnimator';
+
+export {
+    PostProcessingPipeline,
+    BuiltinEffectName,
+    PresetChainName,
+    EffectParamDef,
+    EffectDetail,
+    PresetChainInfo,
+    PipelineState
+} from './PostProcessingPipeline';
+
+export {
+    ParameterTimeline,
+    LoopMode,
+    Keyframe,
+    TimelineState
+} from './ParameterTimeline';

package/types/integrations/FigmaPlugin.d.ts

@@ -0,0 +1,46 @@
+/**
+ * FigmaPlugin TypeScript Definitions
+ * VIB3+ SDK - Figma Plugin Generator
+ */
+
+/** Figma plugin manifest options */
+export interface FigmaManifestOptions {
+    name?: string;
+    id?: string;
+    description?: string;
+}
+
+/** Figma plugin manifest */
+export interface FigmaManifest {
+    name: string;
+    id: string;
+    api: string;
+    main: string;
+    ui: string;
+    editorType: string[];
+    [key: string]: any;
+}
+
+/** Plugin code generation options */
+export interface FigmaCodeOptions {
+    uiWidth?: number;
+    uiHeight?: number;
+}
+
+/**
+ * Static generator for Figma plugin packages.
+ * Produces manifest, plugin code, and UI HTML for a VIB3+ Figma plugin.
+ */
+export declare class Vib3FigmaPlugin {
+    /** Generate the plugin manifest.json */
+    static generatePluginManifest(options?: FigmaManifestOptions): FigmaManifest;
+
+    /** Generate the plugin code.js */
+    static generatePluginCode(options?: FigmaCodeOptions): string;
+
+    /** Generate the plugin UI HTML */
+    static generatePluginUI(): string;
+
+    /** Generate the complete plugin package */
+    static generatePackage(): Record<string, any>;
+}

package/types/integrations/OBSMode.d.ts

@@ -0,0 +1,74 @@
+/**
+ * OBSMode TypeScript Definitions
+ * VIB3+ SDK - OBS Browser Source Integration
+ */
+
+/** OBS capture mode */
+export type CaptureMode = 'browser-source' | 'window-capture';
+
+/** OBS mode constructor options */
+export interface OBSModeOptions {
+    captureMode?: CaptureMode;
+    hideUI?: boolean;
+    autoResize?: boolean;
+}
+
+/** OBS browser source config */
+export interface OBSBrowserSourceConfig {
+    url: string;
+    width: number;
+    height: number;
+    fps: number;
+    custom_css?: string;
+    [key: string]: any;
+}
+
+/** Recommended OBS settings */
+export interface OBSRecommendedSettings {
+    browserSource: Record<string, any>;
+    windowCapture: Record<string, any>;
+    [key: string]: any;
+}
+
+/**
+ * OBS integration mode with transparent background support.
+ * Enables VIB3+ as a browser source overlay in OBS.
+ */
+export declare class Vib3OBSMode {
+    readonly transparentMode: boolean;
+    readonly captureMode: CaptureMode;
+    readonly hideUI: boolean;
+    readonly autoResize: boolean;
+
+    constructor(engine: any, options?: OBSModeOptions);
+
+    /** Generate a browser source URL with embedded parameters */
+    static generateBrowserSourceURL(params?: Record<string, any>): string;
+
+    /** Generate an OBS launch command */
+    static generateLaunchCommand(params?: Record<string, any>): string;
+
+    /** Enable OBS mode (transparent bg, hide UI) */
+    enable(): boolean;
+
+    /** Disable OBS mode */
+    disable(): boolean;
+
+    /** Check if transparent mode is active */
+    isTransparent(): boolean;
+
+    /** Hide all non-canvas UI elements */
+    hideUIElements(): void;
+
+    /** Show all UI elements */
+    showUIElements(): void;
+
+    /** Generate OBS browser source JSON config */
+    configureBrowserSource(options?: Record<string, any>): OBSBrowserSourceConfig;
+
+    /** Get recommended OBS settings documentation */
+    getRecommendedSettings(): OBSRecommendedSettings;
+
+    /** Dispose and restore original state */
+    dispose(): void;
+}

package/types/integrations/ThreeJsPackage.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ThreeJsPackage TypeScript Definitions
+ * VIB3+ SDK - Three.js ShaderMaterial Integration
+ */
+
+import { SystemName } from '../core/VIB3Engine';
+
+/** Options for getShaderMaterial */
+export interface ShaderMaterialOptions {
+    system?: SystemName;
+    transparent?: boolean;
+    depthWrite?: boolean;
+    depthTest?: boolean;
+    width?: number;
+    height?: number;
+    initialParams?: Record<string, number>;
+}
+
+/** Three.js uniform value wrapper */
+export interface UniformValue {
+    value: number | number[] | Float32Array;
+}
+
+/** Returned shader material config (compatible with THREE.ShaderMaterial) */
+export interface ShaderMaterialConfig {
+    vertexShader: string;
+    fragmentShader: string;
+    uniforms: Record<string, UniformValue>;
+    transparent: boolean;
+    depthWrite: boolean;
+    depthTest: boolean;
+
+    /** Update time uniform (call each frame with elapsed ms) */
+    update(timeMs: number): void;
+
+    /** Set a single parameter */
+    setParameter(name: string, value: number): void;
+
+    /** Set multiple parameters */
+    setParameters(params: Record<string, number>): void;
+
+    /** Update resolution uniforms */
+    setResolution(w: number, h: number): void;
+
+    /** Update audio uniforms */
+    setAudio(bass: number, mid: number, high: number): void;
+}
+
+/**
+ * Static generator for Three.js ShaderMaterial configurations.
+ * Returns objects compatible with `new THREE.ShaderMaterial(config)`.
+ */
+export declare class Vib3ThreeJsPackage {
+    /** Get a complete ShaderMaterial config for a system */
+    static getShaderMaterial(options?: ShaderMaterialOptions): ShaderMaterialConfig;
+
+    /** Get the vertex shader source */
+    static getVertexShader(): string;
+
+    /** Get the fragment shader source for a given system */
+    static getFragmentShader(system?: SystemName): string;
+}

package/types/integrations/TouchDesignerExport.d.ts

@@ -0,0 +1,36 @@
+/**
+ * TouchDesignerExport TypeScript Definitions
+ * VIB3+ SDK - GLSL TOP Export for TouchDesigner
+ */
+
+import { SystemName } from '../core/VIB3Engine';
+
+/** Options for GLSL TOP export */
+export interface GLSLTOPOptions {
+    includeComments?: boolean;
+    includeAudio?: boolean;
+    useCustomParams?: boolean;
+}
+
+/** TD uniform mapping entry */
+export interface TDUniformMapping {
+    [paramName: string]: {
+        tdName: string;
+        type: string;
+        range: [number, number];
+    };
+}
+
+/**
+ * Static exporter for TouchDesigner GLSL TOP shaders and .tox files.
+ */
+export declare class Vib3TouchDesignerExport {
+    /** Export GLSL TOP shader code for a system */
+    static exportGLSLTOP(system?: SystemName, options?: GLSLTOPOptions): string;
+
+    /** Export a complete .tox file representation */
+    static exportTOX(system?: SystemName): string;
+
+    /** Get the mapping from VIB3 parameters to TD Custom Parameters */
+    static getTDUniformMapping(): TDUniformMapping;
+}

package/types/integrations/Vib3React.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Vib3React TypeScript Definitions
+ * VIB3+ SDK - React Component & Hook Generator
+ */
+
+import { SystemName } from '../core/VIB3Engine';
+
+/** Props for the generated <Vib3Canvas> React component */
+export interface Vib3CanvasProps {
+    system?: SystemName;
+    geometry?: number;
+    hue?: number;
+    saturation?: number;
+    intensity?: number;
+    speed?: number;
+    gridDensity?: number;
+    morphFactor?: number;
+    chaos?: number;
+    dimension?: number;
+    rot4dXY?: number;
+    rot4dXZ?: number;
+    rot4dYZ?: number;
+    rot4dXW?: number;
+    rot4dYW?: number;
+    rot4dZW?: number;
+    width?: number | string;
+    height?: number | string;
+    className?: string;
+    style?: Record<string, any>;
+    onReady?: (engine: any) => void;
+    onError?: (error: Error) => void;
+    engineRef?: { current: any };
+}
+
+/** Return type of the generated useVib3() hook */
+export interface UseVib3Return {
+    engine: any;
+    parameters: Record<string, number>;
+    setParameter: (name: string, value: number) => void;
+    switchSystem: (system: SystemName) => void;
+}
+
+/** Package.json structure for the generated package */
+export interface GeneratedPackageJSON {
+    name: string;
+    version: string;
+    main: string;
+    peerDependencies: Record<string, string>;
+    [key: string]: any;
+}
+
+/** Generated package structure */
+export interface GeneratedPackage {
+    'package.json': GeneratedPackageJSON;
+    [filename: string]: string | GeneratedPackageJSON;
+}
+
+/**
+ * Static wrapper that generates React component and hook source code.
+ * Use the generated code in a React project with @vib3code/sdk as a dependency.
+ */
+export declare class Vib3ReactWrapper {
+    /** Get the React component JSX source code */
+    static getComponent(): string;
+
+    /** Get the useVib3() hook source code */
+    static getHook(): string;
+
+    /** Generate a package.json for the React wrapper package */
+    static generatePackageJSON(): GeneratedPackageJSON;
+
+    /** Generate the complete NPM package structure */
+    static generatePackage(): GeneratedPackage;
+}

package/types/integrations/Vib3Svelte.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Vib3Svelte TypeScript Definitions
+ * VIB3+ SDK - Svelte Component & Store Generator
+ */
+
+import { SystemName } from '../core/VIB3Engine';
+
+/** Props for the generated Vib3Canvas Svelte component */
+export interface Vib3SvelteProps {
+    system?: SystemName;
+    geometry?: number;
+    hue?: number;
+    saturation?: number;
+    intensity?: number;
+    speed?: number;
+    gridDensity?: number;
+    morphFactor?: number;
+    chaos?: number;
+    dimension?: number;
+    rot4dXY?: number;
+    rot4dXZ?: number;
+    rot4dYZ?: number;
+    rot4dXW?: number;
+    rot4dYW?: number;
+    rot4dZW?: number;
+    preferWebGPU?: boolean;
+    debug?: boolean;
+    width?: number | string;
+    height?: number | string;
+}
+
+/** Svelte store interface */
+export interface Vib3StoreValue {
+    engine: any;
+    parameters: Record<string, number>;
+    system: SystemName;
+}
+
+/** Svelte store with helper methods */
+export interface Vib3Store {
+    subscribe: (callback: (value: Vib3StoreValue) => void) => () => void;
+    setParameter: (name: string, value: number) => void;
+    switchSystem: (system: SystemName) => void;
+    getParameter: (name: string) => number;
+    getAllParameters: () => Record<string, number>;
+}
+
+/**
+ * Static wrapper that generates Svelte component and store source code.
+ */
+export declare class Vib3SvelteWrapper {
+    /** Get the Svelte component source code */
+    static getComponent(): string;
+
+    /** Get the writable store source code */
+    static getStore(): string;
+
+    /** Generate a package.json for the Svelte wrapper package */
+    static generatePackageJSON(): Record<string, any>;
+
+    /** Generate the complete NPM package structure */
+    static generatePackage(): Record<string, any>;
+}

package/types/integrations/Vib3Vue.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Vib3Vue TypeScript Definitions
+ * VIB3+ SDK - Vue 3 Component & Composable Generator
+ */
+
+import { SystemName } from '../core/VIB3Engine';
+
+/** Props for the generated Vib3Canvas Vue component */
+export interface Vib3VueProps {
+    system?: SystemName;
+    geometry?: number;
+    hue?: number;
+    saturation?: number;
+    intensity?: number;
+    speed?: number;
+    gridDensity?: number;
+    morphFactor?: number;
+    chaos?: number;
+    dimension?: number;
+    rot4dXY?: number;
+    rot4dXZ?: number;
+    rot4dYZ?: number;
+    rot4dXW?: number;
+    rot4dYW?: number;
+    rot4dZW?: number;
+    preferWebGPU?: boolean;
+    debug?: boolean;
+    width?: number | string;
+    height?: number | string;
+}
+
+/** Return type of the generated useVib3() composable */
+export interface UseVib3ComposableReturn {
+    engine: any;
+    parameters: Record<string, number>;
+    setParameter: (name: string, value: number) => void;
+    switchSystem: (system: SystemName) => void;
+}
+
+/**
+ * Static wrapper that generates Vue 3 component and composable source code.
+ */
+export declare class Vib3VueWrapper {
+    /** Get the Vue 3 SFC source code */
+    static getComponent(): string;
+
+    /** Get the useVib3() composable source code */
+    static getComposable(): string;
+
+    /** Generate a package.json for the Vue wrapper package */
+    static generatePackageJSON(): Record<string, any>;
+
+    /** Generate the complete NPM package structure */
+    static generatePackage(): Record<string, any>;
+}

package/types/integrations/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Integrations Module TypeScript Definitions
+ * VIB3+ SDK - Framework Components, Figma, Three.js, TouchDesigner, OBS
+ */
+
+export {
+    Vib3ReactWrapper,
+    Vib3CanvasProps,
+    UseVib3Return,
+    GeneratedPackage
+} from './Vib3React';
+
+export {
+    Vib3VueWrapper,
+    Vib3VueProps,
+    UseVib3ComposableReturn
+} from './Vib3Vue';
+
+export {
+    Vib3SvelteWrapper,
+    Vib3SvelteProps,
+    Vib3Store,
+    Vib3StoreValue
+} from './Vib3Svelte';
+
+export {
+    Vib3FigmaPlugin,
+    FigmaManifest,
+    FigmaManifestOptions,
+    FigmaCodeOptions
+} from './FigmaPlugin';
+
+export {
+    Vib3ThreeJsPackage,
+    ShaderMaterialConfig,
+    ShaderMaterialOptions,
+    UniformValue
+} from './ThreeJsPackage';
+
+export {
+    Vib3TouchDesignerExport,
+    GLSLTOPOptions,
+    TDUniformMapping
+} from './TouchDesignerExport';
+
+export {
+    Vib3OBSMode,
+    CaptureMode,
+    OBSModeOptions,
+    OBSBrowserSourceConfig,
+    OBSRecommendedSettings
+} from './OBSMode';