af-motion 0.0.0-stage → 1.0.0

package/dist/mcp/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AF Motion Model Context Protocol (MCP) Integration
+ *
+ * Dedicated optional integration providing standard MCP tools, resources,
+ * and prompts for AI coding agents.
+ */
+export * from "./types.js";
+export * from "./transport.js";
+export * from "./tools.js";
+export * from "./resources.js";
+export * from "./prompts.js";
+export * from "./server.js";

package/dist/mcp/prompts.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AF Motion MCP Prompts
+ *
+ * Pre-engineered prompts guiding external AI coding agents to leverage AF Motion
+ * capabilities rather than inventing custom, fragile animation code.
+ */
+import type { MCPPrompt, MCPPromptMessage } from "./types.js";
+export declare const MCP_PROMPTS: readonly MCPPrompt[];
+export declare function getMCPPromptMessages(name: string, args?: Record<string, string>): Promise<readonly MCPPromptMessage[]>;

package/dist/mcp/resources.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AF Motion MCP Resources
+ *
+ * Exposes read-only source-of-truth datasets (capabilities, visual styles,
+ * Motion DNA, palettes, and schemas) to external AI agents via standard MCP resource URIs.
+ */
+import type { MCPResource, MCPResourceContent } from "./types.js";
+export declare const MCP_RESOURCES: readonly MCPResource[];
+export declare function readMCPResource(uri: string): Promise<MCPResourceContent>;

package/dist/mcp/server.d.ts

@@ -0,0 +1,29 @@
+/**
+ * AF Motion Model Context Protocol (MCP) Server
+ *
+ * Implements standard MCP server lifecycle, JSON-RPC 2.0 dispatching,
+ * tool execution, resource reading, and prompt generation.
+ */
+import type { JSONRPCRequest, JSONRPCResponse, MCPServerInfo, MCPServerOptions, MCPTransport } from "./types.js";
+export declare const MCP_SERVER_INFO: MCPServerInfo;
+export declare function listMCPTools(): readonly import("./types.js").MCPTool[];
+export declare function listMCPResources(): readonly import("./types.js").MCPResource[];
+export declare function listMCPPrompts(): readonly import("./types.js").MCPPrompt[];
+export declare function getMCPPrompt(name: string, args?: Record<string, string>): Promise<{
+    name: string;
+    description: string | undefined;
+    messages: readonly import("./types.js").MCPPromptMessage[];
+}>;
+export declare class AFMotionMCPServer {
+    private readonly name;
+    private readonly version;
+    private transport?;
+    private isRunning;
+    constructor(options?: MCPServerOptions);
+    close(): Promise<void>;
+    getInfo(): MCPServerInfo;
+    start(transport?: MCPTransport): Promise<void>;
+    stop(): Promise<void>;
+    handleMessage(request: JSONRPCRequest): Promise<JSONRPCResponse | null>;
+}
+export declare function createAFMotionMCPServer(options?: MCPServerOptions): AFMotionMCPServer;

package/dist/mcp/tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AF Motion MCP Tools
+ *
+ * Implements standard MCP tools allowing external AI agents to discover,
+ * inspect, generate, validate, and optimize AF Motion capabilities.
+ */
+import type { MCPTool, MCPToolResult } from "./types.js";
+export declare const MCP_TOOLS: readonly MCPTool[];
+export declare function executeMCPTool(name: string, args?: Record<string, any>): Promise<MCPToolResult>;

package/dist/mcp/transport.d.ts

@@ -0,0 +1,33 @@
+/**
+ * AF Motion MCP Transports
+ *
+ * Pluggable transports for MCP communication: in-memory channel for tests/embedding,
+ * and standard I/O (stdio) transport for external CLI/daemon processes.
+ */
+import type { JSONRPCNotification, JSONRPCRequest, JSONRPCResponse, MCPTransport } from "./types.js";
+/**
+ * In-memory transport for testing, direct in-process agent execution, and embedding.
+ */
+export declare class InMemoryTransport implements MCPTransport {
+    private serverHandler;
+    private clientHandler;
+    private closed;
+    onMessage(handler: (message: JSONRPCRequest) => Promise<void>): void;
+    onClientMessage(handler: (message: JSONRPCResponse | JSONRPCNotification) => void): void;
+    send(message: JSONRPCResponse | JSONRPCNotification): Promise<void>;
+    sendToServer(request: JSONRPCRequest): Promise<void>;
+    sendFromClient(request: JSONRPCRequest): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Standard I/O (stdio) transport reading newline-delimited JSON from stdin and writing to stdout.
+ */
+export declare class StdioTransport implements MCPTransport {
+    private messageHandler;
+    private closed;
+    private dataListener;
+    constructor();
+    onMessage(handler: (message: JSONRPCRequest) => Promise<void>): void;
+    send(message: JSONRPCResponse | JSONRPCNotification): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/mcp/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * AF Motion Model Context Protocol (MCP) Contracts
+ *
+ * Typed contracts for MCP server initialization, JSON-RPC 2.0 transport,
+ * tools, resources, and prompt discovery conforming to the MCP specification.
+ */
+export declare const AF_MOTION_MCP_VERSION = "1.0.0";
+export declare const MCP_PROTOCOL_VERSION = "2024-11-05";
+export interface JSONRPCRequest {
+    readonly jsonrpc: "2.0";
+    readonly id?: string | number | null;
+    readonly method: string;
+    readonly params?: Record<string, unknown>;
+}
+export interface JSONRPCResponse {
+    readonly jsonrpc: "2.0";
+    readonly id: string | number | null;
+    readonly result?: unknown;
+    readonly error?: {
+        readonly code: number;
+        readonly message: string;
+        readonly data?: unknown;
+    };
+}
+export interface JSONRPCNotification {
+    readonly jsonrpc: "2.0";
+    readonly method: string;
+    readonly params?: Record<string, unknown>;
+}
+export interface MCPTool {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties?: Record<string, unknown>;
+        readonly required?: readonly string[];
+        readonly [key: string]: unknown;
+    };
+}
+export interface MCPToolContent {
+    readonly type: "text";
+    readonly text: string;
+}
+export interface MCPToolResult {
+    readonly content: readonly MCPToolContent[];
+    readonly isError?: boolean;
+}
+export interface MCPResource {
+    readonly uri: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly mimeType?: string;
+}
+export interface MCPResourceContent {
+    readonly uri: string;
+    readonly mimeType?: string;
+    readonly text?: string;
+    readonly blob?: string;
+}
+export interface MCPPromptArgument {
+    readonly name: string;
+    readonly description?: string;
+    readonly required?: boolean;
+}
+export interface MCPPrompt {
+    readonly name: string;
+    readonly description?: string;
+    readonly arguments?: readonly MCPPromptArgument[];
+}
+export interface MCPPromptMessage {
+    readonly role: "user" | "assistant";
+    readonly content: {
+        readonly type: "text";
+        readonly text: string;
+    };
+}
+export interface MCPTransport {
+    send(message: JSONRPCResponse | JSONRPCNotification): Promise<void>;
+    onMessage(handler: (message: JSONRPCRequest) => Promise<void>): void;
+    close(): Promise<void>;
+}
+export interface MCPServerOptions {
+    readonly name?: string;
+    readonly version?: string;
+    readonly transport?: MCPTransport;
+}
+export interface MCPServerInfo {
+    readonly name: string;
+    readonly version: string;
+    readonly protocolVersion: string;
+    readonly capabilities: {
+        readonly tools?: Record<string, unknown>;
+        readonly resources?: Record<string, unknown>;
+        readonly prompts?: Record<string, unknown>;
+    };
+}

package/dist/presets.d.ts

@@ -0,0 +1,176 @@
+/**
+ * AF Motion Machine-Readable Motion Preset System
+ *
+ * Provides a unified, machine-readable registry of reusable animation,
+ * visual-effect, and choreography presets for developers and AI agents.
+ */
+import type { AnimatableProperties, AnimateTarget, DOMAnimationOptions } from "./core/animate.js";
+import type { AnimationControls } from "./core/animation.js";
+import type { AnimationSequenceControls, AnimationSequenceOptions, AnimationSequenceStep } from "./core/animation-sequence.js";
+import { type MotionDNA } from "./core/motion-dna.js";
+import { type AdaptiveMotionConditions } from "./core/adaptive-motion.js";
+import { type DesignSystem } from "./core/design-system.js";
+import type { AnimationParallelControls, AnimationParallelOptions, AnimationParallelStep } from "./core/animation-parallel.js";
+export declare const PRESET_SCHEMA_VERSION = "1.0.0";
+export type MotionPresetCategory = "entrance" | "exit" | "hover" | "click-interaction" | "text" | "scroll" | "background" | "page-transition" | "choreography";
+export declare const MOTION_PRESET_CATEGORIES: readonly MotionPresetCategory[];
+export type PresetTargetType = "HTMLElement" | "SVGElement" | "AnimateTarget" | "string (CSS selector)";
+export type PresetReducedMotionBehavior = "skips-to-endpoint" | "disables-animation" | "static-fallback" | "respects-profile";
+export interface PresetParameterSchema {
+    readonly name: string;
+    readonly type: string;
+    readonly description: string;
+    readonly required?: boolean;
+    readonly default?: unknown;
+    readonly range?: {
+        readonly min?: number;
+        readonly max?: number;
+    };
+    readonly enum?: readonly (string | number)[];
+}
+export interface PresetUsageSignature {
+    readonly importStatement: string;
+    readonly invocation: string;
+    readonly exampleCode: string;
+}
+export interface MotionPresetAnimationConfig {
+    readonly properties: Readonly<AnimatableProperties>;
+    readonly duration?: number;
+    readonly easing?: string | ((t: number) => number);
+    readonly delay?: number;
+    readonly repeat?: number;
+    readonly yoyo?: boolean;
+    readonly playbackRate?: number;
+}
+export interface MotionPresetStepConfig {
+    readonly preset: string;
+    readonly target?: AnimateTarget;
+    readonly delay?: number;
+    readonly duration?: number;
+    readonly overrides?: MotionPresetOverrides;
+}
+export interface MotionPresetChoreographyConfig {
+    readonly mode: "sequence" | "parallel";
+    readonly steps: readonly MotionPresetStepConfig[];
+}
+export interface MotionPreset {
+    readonly id: string;
+    readonly name: string;
+    readonly category: MotionPresetCategory;
+    readonly description: string;
+    readonly supportedTargets: readonly PresetTargetType[];
+    readonly reducedMotion: PresetReducedMotionBehavior;
+    readonly tags: readonly string[];
+    readonly signature: PresetUsageSignature;
+    readonly configurableParameters: readonly PresetParameterSchema[];
+    readonly animation?: MotionPresetAnimationConfig;
+    readonly choreography?: MotionPresetChoreographyConfig;
+}
+export type MotionPresetOverrides = Partial<DOMAnimationOptions> & {
+    readonly motionDNA?: string | MotionDNA;
+    readonly adaptive?: boolean | AdaptiveMotionConditions;
+    readonly designSystem?: string | DesignSystem;
+};
+export interface PresetValidationError {
+    readonly parameter?: string;
+    readonly message: string;
+}
+export interface PresetValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly PresetValidationError[];
+}
+export interface PresetDocument {
+    readonly $schema: string;
+    readonly version: string;
+    readonly totalPresets: number;
+    readonly categories: readonly MotionPresetCategory[];
+    readonly presets: readonly MotionPreset[];
+}
+export declare const BUILT_IN_MOTION_PRESETS: readonly MotionPreset[];
+/**
+ * Returns all registered motion presets (built-in and custom).
+ */
+export declare function listPresets(): readonly MotionPreset[];
+/**
+ * Returns all valid motion preset categories.
+ */
+export declare function listPresetCategories(): readonly MotionPresetCategory[];
+/**
+ * Looks up a preset by its ID or friendly name.
+ */
+export declare function getPreset(idOrName: string): MotionPreset | undefined;
+/**
+ * Returns all presets registered under a specific category.
+ */
+export declare function getPresetsByCategory(category: MotionPresetCategory): readonly MotionPreset[];
+/**
+ * Searches presets by keyword query matching ID, name, description, category, or tags.
+ */
+export declare function searchPresets(query: string): readonly MotionPreset[];
+/**
+ * Registers a new custom motion preset. Built-in IDs and names are reserved.
+ */
+export declare function registerPreset(preset: MotionPreset): void;
+/**
+ * Removes a custom motion preset. Built-in presets cannot be removed.
+ */
+export declare function removePreset(idOrName: string): boolean;
+/**
+ * Validates a preset definition against required fields and constraints.
+ */
+export declare function validatePreset(preset: unknown): PresetValidationResult;
+/**
+ * Validates options overrides before applying a preset.
+ */
+export declare function validatePresetOverrides(presetIdOrName: string, overrides: unknown): PresetValidationResult;
+/**
+ * Resolves a preset's animation properties and merged options without mutating the registered preset.
+ */
+export declare function resolvePresetAnimation(presetIdOrName: string, overrides?: MotionPresetOverrides): {
+    properties: AnimatableProperties;
+    options: DOMAnimationOptions;
+};
+/**
+ * Applies a registered preset to a target element through the core animate engine.
+ */
+/**
+ * Applies a registered preset to a target element adapting timing according to runtime context.
+ */
+export declare function applyAdaptivePreset(target: AnimateTarget, presetIdOrName: string, conditions?: AdaptiveMotionConditions, overrides?: MotionPresetOverrides): AnimationControls;
+export declare function applyPreset(target: AnimateTarget, presetIdOrName: string, overrides?: MotionPresetOverrides): AnimationControls;
+/**
+ * Converts a preset into an AnimationSequenceStep for composition.
+ */
+export declare function presetToSequenceStep(target: AnimateTarget, presetIdOrName: string, overrides?: MotionPresetOverrides): AnimationSequenceStep;
+/**
+ * Converts a preset into an AnimationParallelStep for composition.
+ */
+export declare function presetToParallelStep(target: AnimateTarget, presetIdOrName: string, overrides?: MotionPresetOverrides): AnimationParallelStep;
+/**
+ * Composes multiple presets to run in sequence against a target.
+ */
+export declare function composePresetSequence(target: AnimateTarget, steps: readonly (string | {
+    preset: string;
+    overrides?: MotionPresetOverrides;
+})[], options?: AnimationSequenceOptions): AnimationSequenceControls;
+/**
+ * Composes multiple presets to run in parallel against individual targets.
+ */
+export declare function composePresetParallel(steps: readonly {
+    target: AnimateTarget;
+    preset: string;
+    overrides?: MotionPresetOverrides;
+}[], options?: AnimationParallelOptions): AnimationParallelControls;
+/**
+ * Exports all presets as a serialized JSON string.
+ */
+export declare function exportPresetsJson(pretty?: boolean): string;
+/**
+ * Exports a versioned preset document object for AI agents and developer tooling.
+ */
+export declare function exportPresetDocument(): PresetDocument;
+export { BUILT_IN_MOTION_DNA, MOTION_DNA_SCHEMA_VERSION, applyMotionDNA, cloneMotionDNA, exportMotionDNADocument, exportMotionDNAJson, getMotionDNA, importMotionDNAFromJson, listMotionDNA, motionDNARegistry, registerMotionDNA, removeMotionDNA, resolveMotionDNA, searchMotionDNA, validateMotionDNA, type MotionDNA, type MotionDNACharacteristics, type MotionDNAConfigurableParameter, type MotionDNADocument, type MotionDNAOverrides, type MotionDNAPersonality, type MotionDNAProfileMetadata, type MotionDNARegistryApi, type MotionDNASpringConfig, type MotionDNAValidationError, type MotionDNAValidationResult, } from "./core/motion-dna.js";
+export { ADAPTIVE_MOTION_SCHEMA_VERSION, adaptAnimationOptions, detectRuntimeContext, disableAdaptiveMotion, enableAdaptiveMotion, getAdaptiveMotionConfig, inspectAdaptiveMotion, isAdaptiveMotionEnabled, resetAdaptiveMotionConfig, resolveAdaptiveMotion, setAdaptiveMotionConfig, setAdaptiveMotionEnabled, subscribeAdaptiveMotion, type AdaptiveMotionConditions, type AdaptiveMotionConfig, type AdaptiveMotionOverrides, type AdaptiveMotionProfile, type AdaptiveMotionState, type AdaptiveReducedMotion, type RuntimeContext, } from "./core/adaptive-motion.js";
+export { BUILT_IN_DESIGN_SYSTEMS, DESIGN_SYSTEM_SCHEMA_VERSION, cloneDesignSystem, createDesignSystem, exportDesignSystemJson, exportDesignSystemsDocument, getActiveDesignSystem, getDesignSystem, importDesignSystemFromJson, listDesignSystems, registerDesignSystem, removeDesignSystem, resetDesignSystemRegistry, resolveDesignSystem, resolveDesignToken, resolveMotionTiming, resolveMovementDistance, searchDesignSystems, setActiveDesignSystem, subscribeToDesignSystem, validateDesignSystem, type DesignSystem, type DesignSystemDefinition, type DesignSystemEasingTokens, type DesignSystemInteractionTokens, type DesignSystemMetadata, type DesignSystemMotionTimingTokens, type DesignSystemSpacingTokens, type DesignSystemsDocument, type DesignSystemTypographyTokens, type DesignSystemValidationError, type DesignSystemValidationResult, } from "./core/design-system.js";
+export { BUILT_IN_CHOREOGRAPHIES, CHOREOGRAPHY_SCHEMA_VERSION, createMotionChoreography, exportChoreographiesDocument, exportChoreographyJson, getChoreography, importChoreographyFromJson, listChoreographies, registerChoreography, removeChoreography, resetChoreographyRegistry, searchChoreographies, validateChoreography, type ChoreographiesDocument, type ChoreographyDefinition, type ChoreographyMetadata, type ChoreographyQuery, type ChoreographyRunOptions, type ChoreographyTargetMap, type ChoreographyValidationError, type ChoreographyValidationResult, type MotionChoreographyAction, type MotionChoreographyAnimation, type MotionChoreographyBranch, type MotionChoreographyControls, type MotionChoreographyEffect, type MotionChoreographyParallel, type MotionChoreographyPreset, type MotionChoreographyRecipe, type MotionChoreographySequence, } from "./core/motion-choreography.js";
+export { BUILT_IN_MOTION_RECIPES, RECIPE_SCHEMA_VERSION, composeRecipe, runRecipe, registerRecipe, getRecipe, listRecipes, searchRecipes, removeRecipe, validateRecipe, validateRecipeRunOptions, exportRecipeJson, exportRecipesDocument, importRecipeFromJson, type DeclarativeMotionRecipe, type RecipeStep, type RecipePresetStep, type RecipeParallelStep, type RecipeSequenceStep, type RecipeNestedStep, type RecipeParameterSchema, type RecipeTargetMap, type RecipeRunOptions, type RecipeValidationError, type RecipeValidationResult, type RecipesDocument, } from "./core/motion-recipe.js";

package/dist/presets.js

@@ -0,0 +1,3 @@
+import { A as e, C as t, D as n, E as r, F as i, M as a, N as o, O as s, P as c, S as l, T as u, _ as d, b as f, c as p, d as m, f as h, g, h as _, j as v, k as y, l as b, m as x, p as S, u as C, v as w, w as T, x as E, y as D } from "./chunks/core-animation-CeiI_TEe.js";
+import { $ as O, A as k, B as A, C as j, D as M, E as N, F as P, G as F, H as I, I as L, J as R, L as z, M as B, N as V, O as H, P as U, Q as W, S as G, T as K, U as q, V as J, W as Y, X, Y as Z, _ as Q, _t as $, a as ee, at as te, b as ne, c as re, ct as ie, d as ae, dt as oe, et as se, f as ce, ft as le, g as ue, gt as de, h as fe, ht as pe, i as me, it as he, j as ge, k as _e, l as ve, lt as ye, m as be, mt as xe, n as Se, nt as Ce, o as we, ot as Te, p as Ee, pt as De, q as Oe, r as ke, rt as Ae, s as je, st as Me, t as Ne, tt as Pe, u as Fe, ut as Ie, v as Le, vt as Re, w as ze, x as Be, y as Ve, z as He } from "./chunks/motion-choreography-DC6LWvDk.js";
+export { p as ADAPTIVE_MOTION_SCHEMA_VERSION, Ne as BUILT_IN_CHOREOGRAPHIES, W as BUILT_IN_DESIGN_SYSTEMS, E as BUILT_IN_MOTION_DNA, be as BUILT_IN_MOTION_PRESETS, P as BUILT_IN_MOTION_RECIPES, Se as CHOREOGRAPHY_SCHEMA_VERSION, O as DESIGN_SYSTEM_SCHEMA_VERSION, l as MOTION_DNA_SCHEMA_VERSION, fe as MOTION_PRESET_CATEGORIES, ue as PRESET_SCHEMA_VERSION, L as RECIPE_SCHEMA_VERSION, b as adaptAnimationOptions, Q as applyAdaptivePreset, t as applyMotionDNA, Le as applyPreset, se as cloneDesignSystem, T as cloneMotionDNA, Ve as composePresetParallel, ne as composePresetSequence, z as composeRecipe, Pe as createDesignSystem, ke as createMotionChoreography, C as detectRuntimeContext, m as disableAdaptiveMotion, h as enableAdaptiveMotion, me as exportChoreographiesDocument, ee as exportChoreographyJson, Ce as exportDesignSystemJson, Ae as exportDesignSystemsDocument, u as exportMotionDNADocument, r as exportMotionDNAJson, Be as exportPresetDocument, G as exportPresetsJson, He as exportRecipeJson, A as exportRecipesDocument, he as getActiveDesignSystem, S as getAdaptiveMotionConfig, we as getChoreography, te as getDesignSystem, n as getMotionDNA, j as getPreset, ze as getPresetsByCategory, J as getRecipe, je as importChoreographyFromJson, Te as importDesignSystemFromJson, s as importMotionDNAFromJson, I as importRecipeFromJson, x as inspectAdaptiveMotion, _ as isAdaptiveMotionEnabled, re as listChoreographies, Me as listDesignSystems, y as listMotionDNA, K as listPresetCategories, N as listPresets, q as listRecipes, e as motionDNARegistry, M as presetToParallelStep, H as presetToSequenceStep, ve as registerChoreography, ie as registerDesignSystem, v as registerMotionDNA, _e as registerPreset, Y as registerRecipe, Fe as removeChoreography, ye as removeDesignSystem, a as removeMotionDNA, k as removePreset, F as removeRecipe, g as resetAdaptiveMotionConfig, ae as resetChoreographyRegistry, Ie as resetDesignSystemRegistry, d as resolveAdaptiveMotion, oe as resolveDesignSystem, le as resolveDesignToken, o as resolveMotionDNA, De as resolveMotionTiming, xe as resolveMovementDistance, ge as resolvePresetAnimation, Oe as runRecipe, ce as searchChoreographies, pe as searchDesignSystems, c as searchMotionDNA, B as searchPresets, R as searchRecipes, de as setActiveDesignSystem, w as setAdaptiveMotionConfig, D as setAdaptiveMotionEnabled, f as subscribeAdaptiveMotion, $ as subscribeToDesignSystem, Ee as validateChoreography, Re as validateDesignSystem, i as validateMotionDNA, V as validatePreset, U as validatePresetOverrides, Z as validateRecipe, X as validateRecipeRunOptions };