af-motion 0.0.0-stage → 1.0.0

package/dist/graphics/materials/schema.d.ts

@@ -0,0 +1,574 @@
+/**
+ * AF Motion Materials & Glass Validation Schemas
+ *
+ * Schemas, validators, configuration correction, and AI capability registration
+ * for materials, surfaces, lighting, and glass presets.
+ */
+import type { ValidationReport } from "../schema.js";
+import type { GlassMaterialOptions, MaterialDefinition } from "./types.js";
+export declare const MATERIALS_SCHEMA_VERSION = "1.0.0";
+export declare const SURFACE_DEFINITION_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly roughness: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+        };
+        readonly smoothness: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+        };
+        readonly opacity: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+        };
+        readonly transmission: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+        };
+        readonly baseColor: {
+            readonly type: "string";
+        };
+        readonly border: {
+            readonly type: "object";
+            readonly properties: {
+                readonly width: {
+                    readonly type: readonly ["number", "string"];
+                };
+                readonly style: {
+                    readonly type: "string";
+                };
+                readonly color: {
+                    readonly type: "string";
+                };
+                readonly radius: {
+                    readonly type: readonly ["number", "string"];
+                };
+                readonly glow: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly elevation: {
+            readonly type: "number";
+            readonly minimum: 0;
+        };
+        readonly depth: {
+            readonly type: "number";
+            readonly minimum: 0;
+        };
+        readonly highlight: {
+            readonly type: "object";
+            readonly properties: {
+                readonly color: {
+                    readonly type: "string";
+                };
+                readonly intensity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly angle: {
+                    readonly type: "number";
+                };
+                readonly spread: {
+                    readonly type: "number";
+                };
+            };
+        };
+        readonly reflectivity: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+        };
+        readonly refractiveIndex: {
+            readonly type: "number";
+            readonly minimum: 1;
+        };
+        readonly textureRef: {
+            readonly type: "string";
+        };
+        readonly blendMode: {
+            readonly type: "string";
+            readonly enum: readonly ["normal", "multiply", "screen", "overlay", "soft-light"];
+        };
+    };
+};
+export declare const LIGHTING_CONFIG_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly ambient: {
+            readonly type: "object";
+            readonly properties: {
+                readonly color: {
+                    readonly type: "string";
+                };
+                readonly intensity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 2;
+                };
+            };
+        };
+        readonly directional: {
+            readonly type: "object";
+            readonly properties: {
+                readonly direction: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                    };
+                    readonly minItems: 3;
+                    readonly maxItems: 3;
+                };
+                readonly color: {
+                    readonly type: "string";
+                };
+                readonly intensity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 5;
+                };
+            };
+        };
+        readonly point: {
+            readonly type: "object";
+            readonly properties: {
+                readonly position: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                    };
+                    readonly minItems: 3;
+                    readonly maxItems: 3;
+                };
+                readonly color: {
+                    readonly type: "string";
+                };
+                readonly intensity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 5;
+                };
+                readonly attenuation: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                };
+            };
+        };
+        readonly highlight: {
+            readonly type: "object";
+            readonly properties: {
+                readonly color: {
+                    readonly type: "string";
+                };
+                readonly blur: {
+                    readonly type: readonly ["number", "string"];
+                };
+                readonly angle: {
+                    readonly type: "number";
+                };
+            };
+        };
+        readonly shadows: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly offset: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "number";
+                        };
+                        readonly minItems: 2;
+                        readonly maxItems: 2;
+                    };
+                    readonly blur: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                    };
+                    readonly spread: {
+                        readonly type: "number";
+                    };
+                    readonly color: {
+                        readonly type: "string";
+                    };
+                    readonly opacity: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly maximum: 1;
+                    };
+                    readonly inset: {
+                        readonly type: "boolean";
+                    };
+                };
+            };
+        };
+        readonly environment: {
+            readonly type: "object";
+            readonly properties: {
+                readonly preset: {
+                    readonly type: "string";
+                    readonly enum: readonly ["studio", "dramatic", "ambient-soft", "neon", "sunset"];
+                };
+                readonly intensity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                };
+                readonly tint: {
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+};
+export declare const MATERIAL_DEFINITION_SCHEMA: {
+    readonly type: "object";
+    readonly required: readonly ["id", "name", "type", "surface"];
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+        };
+        readonly name: {
+            readonly type: "string";
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["matte", "metallic", "glass", "plastic", "emissive", "translucent", "custom"];
+        };
+        readonly version: {
+            readonly type: "string";
+        };
+        readonly surface: {
+            readonly type: "object";
+            readonly properties: {
+                readonly roughness: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly smoothness: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly opacity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly transmission: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly baseColor: {
+                    readonly type: "string";
+                };
+                readonly border: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly width: {
+                            readonly type: readonly ["number", "string"];
+                        };
+                        readonly style: {
+                            readonly type: "string";
+                        };
+                        readonly color: {
+                            readonly type: "string";
+                        };
+                        readonly radius: {
+                            readonly type: readonly ["number", "string"];
+                        };
+                        readonly glow: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly elevation: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                };
+                readonly depth: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                };
+                readonly highlight: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly color: {
+                            readonly type: "string";
+                        };
+                        readonly intensity: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                            readonly maximum: 1;
+                        };
+                        readonly angle: {
+                            readonly type: "number";
+                        };
+                        readonly spread: {
+                            readonly type: "number";
+                        };
+                    };
+                };
+                readonly reflectivity: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly refractiveIndex: {
+                    readonly type: "number";
+                    readonly minimum: 1;
+                };
+                readonly textureRef: {
+                    readonly type: "string";
+                };
+                readonly blendMode: {
+                    readonly type: "string";
+                    readonly enum: readonly ["normal", "multiply", "screen", "overlay", "soft-light"];
+                };
+            };
+        };
+        readonly lighting: {
+            readonly type: "object";
+            readonly properties: {
+                readonly ambient: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly color: {
+                            readonly type: "string";
+                        };
+                        readonly intensity: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                            readonly maximum: 2;
+                        };
+                    };
+                };
+                readonly directional: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly direction: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "number";
+                            };
+                            readonly minItems: 3;
+                            readonly maxItems: 3;
+                        };
+                        readonly color: {
+                            readonly type: "string";
+                        };
+                        readonly intensity: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                            readonly maximum: 5;
+                        };
+                    };
+                };
+                readonly point: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly position: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "number";
+                            };
+                            readonly minItems: 3;
+                            readonly maxItems: 3;
+                        };
+                        readonly color: {
+                            readonly type: "string";
+                        };
+                        readonly intensity: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                            readonly maximum: 5;
+                        };
+                        readonly attenuation: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                        };
+                    };
+                };
+                readonly highlight: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly color: {
+                            readonly type: "string";
+                        };
+                        readonly blur: {
+                            readonly type: readonly ["number", "string"];
+                        };
+                        readonly angle: {
+                            readonly type: "number";
+                        };
+                    };
+                };
+                readonly shadows: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly offset: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "number";
+                                };
+                                readonly minItems: 2;
+                                readonly maxItems: 2;
+                            };
+                            readonly blur: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                            };
+                            readonly spread: {
+                                readonly type: "number";
+                            };
+                            readonly color: {
+                                readonly type: "string";
+                            };
+                            readonly opacity: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 1;
+                            };
+                            readonly inset: {
+                                readonly type: "boolean";
+                            };
+                        };
+                    };
+                };
+                readonly environment: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly preset: {
+                            readonly type: "string";
+                            readonly enum: readonly ["studio", "dramatic", "ambient-soft", "neon", "sunset"];
+                        };
+                        readonly intensity: {
+                            readonly type: "number";
+                            readonly minimum: 0;
+                        };
+                        readonly tint: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+            };
+        };
+        readonly uniforms: {
+            readonly type: "object";
+        };
+        readonly customShaders: {
+            readonly type: "object";
+            readonly properties: {
+                readonly vertexShader: {
+                    readonly type: "string";
+                };
+                readonly fragmentShader: {
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+};
+export declare const GLASS_OPTIONS_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly preset: {
+            readonly type: "string";
+            readonly enum: readonly ["frosted-glass", "clear-glass", "tinted-glass", "liquid-glass", "acrylic", "translucent-panel"];
+        };
+        readonly blur: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 100;
+        };
+        readonly opacity: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+        };
+        readonly tint: {
+            readonly type: "string";
+        };
+        readonly elevation: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 24;
+        };
+        readonly edgeHighlight: {
+            readonly type: "boolean";
+        };
+        readonly borderWidth: {
+            readonly type: readonly ["number", "string"];
+        };
+        readonly borderColor: {
+            readonly type: "string";
+        };
+        readonly borderRadius: {
+            readonly type: readonly ["number", "string"];
+        };
+        readonly refractiveIndex: {
+            readonly type: "number";
+            readonly minimum: 1;
+            readonly maximum: 3;
+        };
+        readonly highContrast: {
+            readonly type: "boolean";
+        };
+        readonly reducedMotion: {
+            readonly type: "boolean";
+        };
+    };
+};
+export declare function validateSurfaceDefinition(input: unknown): ValidationReport;
+export declare function validateLightingConfig(input: unknown): ValidationReport;
+export declare function validateMaterialDefinition(input: unknown): ValidationReport;
+export declare function validateGlassOptions(input: unknown): ValidationReport;
+export declare function correctMaterialConfig(input: unknown): MaterialDefinition;
+export declare function correctGlassConfig(input: unknown): GlassMaterialOptions;
+export declare const MATERIALS_SYSTEM_CAPABILITY: {
+    id: string;
+    name: string;
+    category: "graphics";
+    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;
+    };
+    react: {
+        available: boolean;
+        componentName: string;
+        hookName: string;
+        importPath: string;
+    };
+};
+export declare function registerMaterialsCapability(registry: {
+    registerCapability: (cap: any, opts?: any) => void;
+}): void;

package/dist/graphics/materials/surface.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AF Motion Surface System
+ *
+ * Computes deterministic surface styles, depth appearance, and shader properties.
+ */
+import type { LightingConfig, SurfaceDefinition, SurfaceStyleResult } from "./types.js";
+export interface ComputeSurfaceOptions {
+    readonly highContrast?: boolean;
+}
+/**
+ * Compute CSS and uniform properties for a surface definition.
+ */
+export declare function computeSurfaceStyle(surface: SurfaceDefinition, lighting?: LightingConfig, options?: ComputeSurfaceOptions): SurfaceStyleResult;