af-motion 0.0.0-stage → 1.0.0

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AF Motion CLI — `af-motion doctor`
+ *
+ * Read-only project diagnostics inspecting Node runtime, package installation,
+ * TypeScript configuration, React peer dependencies, and subpath resolution.
+ */
+import type { DoctorReport, GlobalCLIOptions } from "../types.js";
+export declare function runDoctorChecks(cwd: string): DoctorReport;
+export declare function executeDoctor(options?: GlobalCLIOptions): Promise<DoctorReport>;

package/dist/cli/commands/example.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AF Motion CLI — `af-motion example`
+ *
+ * Generates standalone, compilable starter examples for core animation,
+ * physical springs, React hooks, Motion DNA, 3D scenes, and offline AI intelligence.
+ */
+import type { ExampleGenerateOptions, ExampleType } from "../types.js";
+export declare const VALID_EXAMPLE_TYPES: readonly ExampleType[];
+export declare function executeExample(type?: string, options?: ExampleGenerateOptions): Promise<boolean>;

package/dist/cli/commands/info.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AF Motion CLI — `af-motion info`
+ *
+ * Inspects AF Motion capabilities, version, subpath mappings, and AI capability registry.
+ */
+import type { AFMotionCapabilityInfo, GlobalCLIOptions } from "../types.js";
+export declare function getCapabilityInfo(): AFMotionCapabilityInfo;
+export declare function executeInfo(options?: GlobalCLIOptions): Promise<AFMotionCapabilityInfo>;

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AF Motion CLI — `af-motion init`
+ *
+ * Initializes an AF Motion starter configuration and animation template
+ * with strict existing-file protection and template auto-detection.
+ */
+import type { InitOptions, InitResult, StarterTemplate } from "../types.js";
+export declare function detectTemplate(projectDir: string): StarterTemplate;
+export declare function executeInit(options?: InitOptions): Promise<InitResult>;

package/dist/cli/commands/presets.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AF Motion CLI — `af-motion presets`
+ *
+ * Discovery, inspection, and export of standardized animation recipes and presets
+ * reusing the official registry from `src/presets.ts`.
+ */
+import type { PresetExportOptions, PresetInspectResult, PresetsListOptions } from "../types.js";
+export declare function executePresetsList(options?: PresetsListOptions): Promise<void>;
+export declare function executePresetInspect(name: string, options?: PresetsListOptions): Promise<PresetInspectResult | null>;
+export declare function executePresetExport(name: string, options?: PresetExportOptions): Promise<boolean>;

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AF Motion CLI — `af-motion validate`
+ *
+ * Validates AF Motion configuration files and animation compositions
+ * against official schemas, Motion DNA profiles, and the 33 built-in palettes.
+ */
+import type { ConfigValidationReport, GlobalCLIOptions } from "../types.js";
+export declare function validateConfigFile(filePath: string): ConfigValidationReport;
+export declare function executeValidate(targetPath?: string, options?: GlobalCLIOptions): Promise<ConfigValidationReport>;

package/dist/cli/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * AF Motion CLI — Master Router & Command Dispatcher
+ *
+ * Provides a modular, lightweight, dependency-free developer command-line interface.
+ */
+import type { ExitCode } from "./types.js";
+export * from "./types.js";
+export * from "./commands/init.js";
+export * from "./commands/doctor.js";
+export * from "./commands/validate.js";
+export * from "./commands/presets.js";
+export * from "./commands/info.js";
+export * from "./commands/example.js";
+export * from "./utils/terminal.js";
+export * from "./utils/templates.js";
+export declare function printHelp(): void;
+export declare function parseArgs(rawArgs: string[]): {
+    command?: string;
+    positional: string[];
+    options: Record<string, any>;
+};
+export declare function runCLI(rawArgs?: string[]): Promise<ExitCode>;

package/dist/cli/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * AF Motion CLI — Type Definitions
+ *
+ * Types for command arguments, diagnostic results, configuration schemas,
+ * and reporting structures.
+ */
+export type ExitCode = 0 | 1 | 2;
+export interface GlobalCLIOptions {
+    help?: boolean;
+    version?: boolean;
+    json?: boolean;
+    color?: boolean;
+    quiet?: boolean;
+    verbose?: boolean;
+    cwd?: string;
+}
+export type StarterTemplate = "vanilla-js" | "vanilla-ts" | "react-ts";
+export interface InitOptions extends GlobalCLIOptions {
+    template?: StarterTemplate;
+    name?: string;
+    force?: boolean;
+    noConfig?: boolean;
+}
+export interface InitResult {
+    success: boolean;
+    template: StarterTemplate;
+    createdFiles: string[];
+    skippedFiles: string[];
+    configCreated: boolean;
+    message: string;
+}
+export type DiagnosticStatus = "pass" | "warn" | "fail";
+export interface DiagnosticCheck {
+    id: string;
+    category: "environment" | "dependencies" | "configuration" | "framework";
+    name: string;
+    status: DiagnosticStatus;
+    message: string;
+    details?: string;
+    remediation?: string;
+}
+export interface DoctorReport {
+    timestamp: string;
+    overallStatus: DiagnosticStatus;
+    passedCount: number;
+    warnCount: number;
+    failCount: number;
+    checks: DiagnosticCheck[];
+}
+export interface ConfigValidationFinding {
+    severity: "error" | "warning" | "info";
+    path: string;
+    message: string;
+    suggestion?: string;
+}
+export interface ConfigValidationReport {
+    file: string;
+    valid: boolean;
+    findings: ConfigValidationFinding[];
+    summary: {
+        errors: number;
+        warnings: number;
+    };
+}
+export interface PresetsListOptions extends GlobalCLIOptions {
+    category?: string;
+    search?: string;
+}
+export interface PresetInspectResult {
+    id: string;
+    name: string;
+    category: string;
+    description: string;
+    duration?: number;
+    easing?: string;
+    tags?: readonly string[];
+    properties?: Record<string, unknown>;
+    characteristics?: Record<string, unknown>;
+}
+export interface PresetExportOptions extends GlobalCLIOptions {
+    format?: "json" | "ts";
+    out?: string;
+    force?: boolean;
+}
+export interface AFMotionCapabilityInfo {
+    version: string;
+    subpaths: {
+        core: string;
+        react: string;
+        catalogue: string;
+        presets: string;
+    };
+    coreFeatures: string[];
+    easingsCount: number;
+    palettesCount: number;
+    visualStylesCount: number;
+    motionDNAPersonalities: string[];
+    presetsCount: number;
+    aiCapabilities: string[];
+    environment: {
+        nodeVersion: string;
+        platform: string;
+        arch: string;
+        isCI: boolean;
+        supportsColor: boolean;
+    };
+}
+export type ExampleType = "basic" | "reveal-stagger" | "spring" | "timeline" | "react" | "motion-dna" | "3d" | "ai-quality" | "design-to-motion";
+export interface ExampleGenerateOptions extends GlobalCLIOptions {
+    type?: ExampleType;
+    lang?: "ts" | "js";
+    out?: string;
+    force?: boolean;
+    print?: boolean;
+}

package/dist/cli/utils/safety.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AF Motion CLI — Filesystem & Argument Safety Guards
+ *
+ * Prevents path traversal, symlink/prefix escapes outside the workspace root,
+ * null-byte injection, and flag prototype pollution.
+ */
+/**
+ * Resolves a user-supplied target directory or output file path relative to `cwd`
+ * and rejects any path traversal, cross-drive escape, or null-byte injection.
+ */
+export declare function resolveSafeWorkspacePath(cwd: string, userPath: string, label?: string): string;

package/dist/cli/utils/templates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AF Motion CLI — Template Registry
+ *
+ * Provides starter project templates and verified code examples using only
+ * official public package subpaths without internal relative imports.
+ */
+import type { StarterTemplate, ExampleType } from "../types.js";
+export declare const STARTER_CONFIG_JSON: string;
+export declare function getStarterTemplate(template: StarterTemplate): {
+    filename: string;
+    content: string;
+};
+export declare function getExampleContent(type: ExampleType, lang: "ts" | "js"): {
+    filename: string;
+    content: string;
+};

package/dist/cli/utils/terminal.d.ts

@@ -0,0 +1,29 @@
+/**
+ * AF Motion CLI — Terminal & Formatting Utilities
+ *
+ * Lightweight, dependency-free ANSI formatting with automatic color suppression
+ * for non-TTY, CI, and NO_COLOR environments.
+ */
+export declare class Terminal {
+    private enabled;
+    constructor(forceColor?: boolean);
+    setColorEnabled(enabled: boolean): void;
+    isColorEnabled(): boolean;
+    private wrap;
+    bold(text: string): string;
+    dim(text: string): string;
+    red(text: string): string;
+    green(text: string): string;
+    yellow(text: string): string;
+    blue(text: string): string;
+    magenta(text: string): string;
+    cyan(text: string): string;
+    gray(text: string): string;
+    pass(text?: string): string;
+    warn(text?: string): string;
+    fail(text?: string): string;
+    info(text?: string): string;
+    banner(title: string, subtitle?: string): string;
+    table(headers: string[], rows: string[][]): string;
+}
+export declare const term: Terminal;