af-motion 0.0.0-stage → 1.0.0

package/dist/3d/schema.d.ts

@@ -0,0 +1,739 @@
+/**
+ * AF Motion 3D Scene Schemas & AI Motion Registry Integration
+ *
+ * Machine-readable schemas, validation, configuration correction, and
+ * dynamic discovery integration for 3D rendering.
+ */
+import type { Scene3DDefinition } from "./types.js";
+export declare const SCENE_3D_SCHEMA_VERSION = "1.0.0";
+export declare const CAMERA_3D_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["perspective", "orthographic"];
+            readonly default: "perspective";
+        };
+        readonly fov: {
+            readonly type: "number";
+            readonly minimum: 1;
+            readonly maximum: 179;
+            readonly default: 50;
+        };
+        readonly near: {
+            readonly type: "number";
+            readonly minimum: 0.001;
+            readonly default: 0.1;
+        };
+        readonly far: {
+            readonly type: "number";
+            readonly minimum: 1;
+            readonly default: 1000;
+        };
+        readonly position: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 5];
+        };
+        readonly target: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+    };
+};
+export declare const LIGHTING_3D_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly ambient: {
+            readonly type: "object";
+            readonly properties: {
+                readonly color: {
+                    readonly type: "string";
+                    readonly default: "#ffffff";
+                };
+                readonly intensity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 10;
+                    readonly default: 0.5;
+                };
+            };
+        };
+        readonly directional: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly color: {
+                        readonly type: "string";
+                        readonly default: "#ffffff";
+                    };
+                    readonly intensity: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly default: 1;
+                    };
+                    readonly position: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "number";
+                        };
+                        readonly minItems: 3;
+                        readonly maxItems: 3;
+                    };
+                    readonly castShadow: {
+                        readonly type: "boolean";
+                        readonly default: false;
+                    };
+                };
+            };
+        };
+    };
+};
+export declare const SCENE_3D_SCHEMA: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly title: "Scene3DDefinition";
+    readonly version: "1.0.0";
+    readonly type: "object";
+    readonly required: readonly ["id"];
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly name: {
+            readonly type: "string";
+        };
+        readonly version: {
+            readonly type: "string";
+            readonly default: "1.0.0";
+        };
+        readonly camera: {
+            readonly type: "object";
+            readonly properties: {
+                readonly type: {
+                    readonly type: "string";
+                    readonly enum: readonly ["perspective", "orthographic"];
+                    readonly default: "perspective";
+                };
+                readonly fov: {
+                    readonly type: "number";
+                    readonly minimum: 1;
+                    readonly maximum: 179;
+                    readonly default: 50;
+                };
+                readonly near: {
+                    readonly type: "number";
+                    readonly minimum: 0.001;
+                    readonly default: 0.1;
+                };
+                readonly far: {
+                    readonly type: "number";
+                    readonly minimum: 1;
+                    readonly default: 1000;
+                };
+                readonly position: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                    };
+                    readonly minItems: 3;
+                    readonly maxItems: 3;
+                    readonly default: readonly [0, 0, 5];
+                };
+                readonly target: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                    };
+                    readonly minItems: 3;
+                    readonly maxItems: 3;
+                    readonly default: readonly [0, 0, 0];
+                };
+            };
+        };
+        readonly lighting: {
+            readonly type: "object";
+            readonly properties: {
+                readonly ambient: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly color: {
+                            readonly type: "string";
+                            readonly default: "#ffffff";
+                        };
+                        readonly intensity: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                            readonly maximum: 10;
+                            readonly default: 0.5;
+                        };
+                    };
+                };
+                readonly directional: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly color: {
+                                readonly type: "string";
+                                readonly default: "#ffffff";
+                            };
+                            readonly intensity: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly default: 1;
+                            };
+                            readonly position: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "number";
+                                };
+                                readonly minItems: 3;
+                                readonly maxItems: 3;
+                            };
+                            readonly castShadow: {
+                                readonly type: "boolean";
+                                readonly default: false;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly autoStart: {
+            readonly type: "boolean";
+            readonly default: true;
+        };
+        readonly respectReducedMotion: {
+            readonly type: "boolean";
+            readonly default: true;
+        };
+        readonly renderer: {
+            readonly type: "object";
+            readonly properties: {
+                readonly backend: {
+                    readonly type: "string";
+                    readonly enum: readonly ["three", "webgl", "null"];
+                    readonly default: "three";
+                };
+                readonly powerPreference: {
+                    readonly type: "string";
+                    readonly enum: readonly ["default", "high-performance", "low-power"];
+                };
+                readonly antialias: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                };
+                readonly alpha: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                };
+                readonly dpr: {
+                    readonly type: readonly ["number", "string"];
+                    readonly default: "auto";
+                };
+            };
+        };
+    };
+};
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+/**
+ * Validate a 3D scene definition against schema contracts.
+ */
+export declare function validateScene3D(config: unknown): ValidationResult;
+/**
+ * Automatically sanitize and correct a malformed 3D scene configuration.
+ */
+export declare function correctScene3D(config: unknown): Scene3DDefinition;
+/**
+ * AI Motion Capability definition for 3D Scene Infrastructure.
+ */
+export declare const SCENE_3D_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: ({
+        name: string;
+        kind: "positional";
+        type: string;
+        required: boolean;
+        description: string;
+    } | {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    })[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: string[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+    react: {
+        available: boolean;
+        componentName: string;
+        hookName: string;
+        importPath: string;
+    };
+};
+/**
+ * Register the 3D scene capability with an AI Motion Registry instance.
+ */
+export declare function registerScene3DCapability(registry: {
+    registerCapability: (cap: any, opts?: any) => void;
+}): void;
+export declare const CAMERA_3D_INTELLIGENCE_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    }[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: never[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const LIGHTING_3D_INTELLIGENCE_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    }[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: never[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const ENVIRONMENT_3D_INTELLIGENCE_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    }[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: never[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const MATERIAL_3D_INTELLIGENCE_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    }[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: never[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const ASSET_3D_MANAGEMENT_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: ({
+        name: string;
+        kind: "string";
+        type: string;
+        required: boolean;
+        description: string;
+    } | {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    })[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: string[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const GEOMETRY_3D_PROCEDURAL_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    }[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: never[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const INTERACTION_3D_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: ({
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        default: boolean;
+        description: string;
+    } | {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        default: string;
+        description: string;
+    })[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: string[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const CAMERA_CONTROLS_3D_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: ({
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        default: string;
+        description: string;
+    } | {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        default: boolean;
+        description: string;
+    } | {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        default: number;
+        description: string;
+    })[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: never[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const SCROLL_SCENE_3D_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "scroll";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: ({
+        name: string;
+        kind: "positional";
+        type: string;
+        required: boolean;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        default: boolean;
+        description: string;
+    })[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: string[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const INTERACTIVE_ENVIRONMENTS_3D_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    }[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: never[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare function getAvailableGeometryTypes(): readonly {
+    type: string;
+    description: string;
+    requiredParams: readonly string[];
+    optionalParams: readonly string[];
+}[];
+export declare function getGeometryParameters(type: string): Record<string, unknown>;
+export declare function getSupportedModelFormats(): readonly {
+    format: string;
+    description: string;
+    extension: string;
+    loaderRequired: boolean;
+}[];
+export declare function getAvailableInteractionPresets(): readonly {
+    name: string;
+    description: string;
+}[];
+export declare function getScrollTimelinePresets(): readonly {
+    id: string;
+    name: string;
+    sectionsCount: number;
+}[];
+export declare const SCENE_3D_COMPOSITION_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: ({
+        name: string;
+        kind: "positional";
+        type: string;
+        required: boolean;
+        description: string;
+    } | {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    })[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: string[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare const SCENE_3D_GENERATION_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "composition";
+    description: string;
+    tags: string[];
+    version: string;
+    parameters: ({
+        name: string;
+        kind: "positional";
+        type: string;
+        required: boolean;
+        description: string;
+    } | {
+        name: string;
+        kind: "option";
+        type: string;
+        required: boolean;
+        description: string;
+    })[];
+    supportedTargets: string[];
+    signature: {
+        importStatement: string;
+        invocation: string;
+        exampleCode: string;
+    };
+    controls: string[];
+    callbacks: never[];
+    reducedMotion: "static-fallback";
+    compatibility: {
+        browser: boolean;
+        ssr: boolean;
+        requiresCanvas: boolean;
+    };
+};
+export declare function getAvailableSceneRecipes(): readonly {
+    name: string;
+    title: string;
+    description: string;
+    defaultCamera: string;
+    defaultLighting: string;
+}[];
+export declare function register3DIntelligenceCapabilities(registry: {
+    registerCapability: (cap: any, opts?: any) => void;
+}): void;