@genfeedai/workflow-ui 0.2.3 → 0.2.5

package/dist/lib.d.ts

@@ -1,92 +1,40 @@
-import { HandleDefinition, NodeType, WorkflowNodeData, CubicBezier, EasingPreset, WorkflowNode, CostBreakdown, ImageModel, LipSyncModel, TextModel, VideoModel } from '@genfeedai/types';
-export { CostBreakdown, NodeCostEstimate } from '@genfeedai/types';
 import * as react from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { CubicBezier, WorkflowNode, CostBreakdown, EasingPreset, NodeType, WorkflowNodeData, ImageModel, LipSyncModel, TextModel, VideoModel, HandleDefinition } from '@genfeedai/types';
+export { CostBreakdown, NodeCostEstimate } from '@genfeedai/types';
 
-/**
- * Generates dynamic input handles from a model's input schema.
- *
- * Merges dynamically discovered handles with static handles defined in NODE_DEFINITIONS.
- * Static handles take precedence - dynamic handles are only added if not already present.
- *
- * @param inputSchema - The model's input schema containing properties
- * @param staticHandles - Static handles from NODE_DEFINITIONS
- * @returns Combined array of handles (static + dynamic)
- */
-declare function generateHandlesFromSchema(inputSchema: Record<string, unknown> | undefined, staticHandles: HandleDefinition[]): HandleDefinition[];
-/**
- * Check if a handle was dynamically generated from schema.
- */
-declare function isSchemaHandle(handle: HandleDefinition): boolean;
-
-/**
- * Utility functions for validating required schema fields
- */
-/**
- * Validates that all required fields in a JSON Schema have values.
- *
- * @param inputSchema - The JSON Schema with required array
- * @param values - Current field values
- * @param skipFields - Fields to skip (e.g., fields populated via connections)
- * @returns Validation result with isValid flag and list of missing fields
- */
-declare function validateRequiredSchemaFields(inputSchema: Record<string, unknown> | undefined, values: Record<string, unknown>, skipFields: Set<string>): {
-    isValid: boolean;
-    missingFields: string[];
-};
-/**
- * Fields that are populated via node connections rather than schema inputs.
- * These should be skipped when validating schema required fields.
- */
-declare const CONNECTION_FIELDS: Set<string>;
+interface CubicBezierEditorProps {
+    value: CubicBezier;
+    onChange: (value: CubicBezier) => void;
+    onCommit?: (value: CubicBezier) => void;
+    disabled?: boolean;
+    width?: number;
+    height?: number;
+}
+declare function CubicBezierEditorComponent({ value, onChange, onCommit, disabled, width, height, }: CubicBezierEditorProps): react_jsx_runtime.JSX.Element;
+declare const CubicBezierEditor: react.MemoExoticComponent<typeof CubicBezierEditorComponent>;
 
-/**
- * Shared utilities for working with provider model schemas
- */
-/**
- * Extract default values from schema properties
- */
-declare function getSchemaDefaults(schema: Record<string, unknown> | undefined): Record<string, unknown>;
-/**
- * Check if the model's schema supports image input
- * Used to determine whether to enable/disable image input handles
- */
-declare function supportsImageInput(schema: Record<string, unknown> | undefined): boolean;
-/**
- * Extract enum values from component schemas for SchemaInputs dropdowns
- */
-declare function extractEnumValues(componentSchemas: Record<string, {
-    enum?: unknown[];
-    type?: string;
-}> | undefined): Record<string, string[]> | undefined;
+declare function calculateWorkflowCost(nodes: WorkflowNode[]): CostBreakdown;
+declare function formatCost(amount: number): string;
 
-interface MediaInfo {
-    url: string | null;
-    urls?: string[];
-    type: 'image' | 'video' | null;
-}
 /**
- * Extract media URL and type from node data
+ * Deduplicated Fetch Utility
+ *
+ * When multiple callers request the same URL concurrently, only one
+ * actual network request is made. All callers receive the same response
+ * data once the request completes. Responses are cached for 5 seconds.
  */
-declare function getMediaFromNode(nodeType: NodeType, data: WorkflowNodeData): MediaInfo;
-
 /**
- * Get the dimensions of an image from its source URL or data URL.
+ * Fetch with request deduplication.
+ *
+ * Multiple concurrent calls to the same URL (with same headers) will
+ * share a single network request. The response is cloned for each caller.
  */
-declare function getImageDimensions$1(src: string): Promise<{
-    width: number;
-    height: number;
-}>;
+declare function deduplicatedFetch(url: string, options?: RequestInit): Promise<Response>;
 /**
- * Get duration and dimensions of a video from its source URL or data URL.
+ * Clear all cached responses.
  */
-declare function getVideoMetadata(src: string): Promise<{
-    duration: number;
-    dimensions: {
-        width: number;
-        height: number;
-    };
-}>;
+declare function clearFetchCache(): void;
 
 type EasingFunction = (t: number) => number;
 /**
@@ -98,10 +46,10 @@ declare const DEFAULT_CUSTOM_BEZIER: CubicBezier;
 /** Named presets for the CubicBezierEditor */
 declare const PRESET_BEZIERS: {
     readonly easeInExpoOutCubic: [0.85, 0, 0.15, 1];
-    readonly easeInOutExpo: [0.87, 0, 0.13, 1];
-    readonly easeInQuartOutQuad: [0.8, 0, 0.2, 1];
     readonly easeInOutCubic: [0.65, 0, 0.35, 1];
+    readonly easeInOutExpo: [0.87, 0, 0.13, 1];
     readonly easeInOutSine: [0.37, 0, 0.63, 1];
+    readonly easeInQuartOutQuad: [0.8, 0, 0.2, 1];
 };
 type EasingPresetName = keyof typeof PRESET_BEZIERS;
 /**
@@ -119,28 +67,28 @@ declare function createAsymmetricEase(easeIn: EasingFunction, easeOut: EasingFun
 declare const easing: {
     readonly easeInExpoOutCubic: EasingFunction;
     readonly easeInQuartOutQuad: EasingFunction;
-    readonly linear: (t: number) => number;
-    readonly easeInQuad: (t: number) => number;
-    readonly easeOutQuad: (t: number) => number;
-    readonly easeInOutQuad: (t: number) => number;
+    readonly easeInCirc: (t: number) => number;
     readonly easeInCubic: (t: number) => number;
-    readonly easeOutCubic: (t: number) => number;
+    readonly easeInExpo: (t: number) => number;
+    readonly easeInOutCirc: (t: number) => number;
     readonly easeInOutCubic: (t: number) => number;
-    readonly easeInQuart: (t: number) => number;
-    readonly easeOutQuart: (t: number) => number;
+    readonly easeInOutExpo: (t: number) => number;
+    readonly easeInOutQuad: (t: number) => number;
     readonly easeInOutQuart: (t: number) => number;
-    readonly easeInQuint: (t: number) => number;
-    readonly easeOutQuint: (t: number) => number;
     readonly easeInOutQuint: (t: number) => number;
-    readonly easeInSine: (t: number) => number;
-    readonly easeOutSine: (t: number) => number;
     readonly easeInOutSine: (t: number) => number;
-    readonly easeInExpo: (t: number) => number;
-    readonly easeOutExpo: (t: number) => number;
-    readonly easeInOutExpo: (t: number) => number;
-    readonly easeInCirc: (t: number) => number;
+    readonly easeInQuad: (t: number) => number;
+    readonly easeInQuart: (t: number) => number;
+    readonly easeInQuint: (t: number) => number;
+    readonly easeInSine: (t: number) => number;
     readonly easeOutCirc: (t: number) => number;
-    readonly easeInOutCirc: (t: number) => number;
+    readonly easeOutCubic: (t: number) => number;
+    readonly easeOutExpo: (t: number) => number;
+    readonly easeOutQuad: (t: number) => number;
+    readonly easeOutQuart: (t: number) => number;
+    readonly easeOutQuint: (t: number) => number;
+    readonly easeOutSine: (t: number) => number;
+    readonly linear: (t: number) => number;
 };
 /**
  * Create an easing function from cubic bezier control points
@@ -164,44 +112,6 @@ declare function applySpeedCurve(duration: number, curve: CubicBezier, sampleRat
  */
 declare function getEasingDisplayName(preset: EasingPreset | string): string;
 
-/**
- * Speed Curve Utility
- *
- * Advanced time-warping for video speed ramps using easing functions.
- * Maps original video timestamps to warped timestamps through easing curves.
- */
-
-/**
- * Maps original video timestamps to warped timestamps using any easing function.
- *
- * @param originalTime - Original timestamp in seconds (0 to inputDuration)
- * @param inputDuration - Input video duration in seconds (default: 5)
- * @param outputDuration - Output video duration in seconds (default: 1.5)
- * @param easingFunction - Easing function or function name string (default: easeInOutCubic)
- * @returns Warped timestamp for the output video
- */
-declare function warpTime(originalTime: number, inputDuration?: number, outputDuration?: number, easingFunction?: EasingFunction | string): number;
-/**
- * Calculate the duration of a frame after warping.
- */
-declare function calculateWarpedDuration(originalStart: number, originalDuration: number, inputDuration?: number, outputDuration?: number, easingFunction?: EasingFunction | string): number;
-/**
- * Validate that a warp time function produces valid output.
- */
-declare function validateWarpFunction(easingFunction?: EasingFunction | string, inputDuration?: number, outputDuration?: number, tolerance?: number): {
-    valid: boolean;
-    errors: string[];
-};
-/**
- * Generate statistics about the warp curve.
- */
-declare function analyzeWarpCurve(easingFunction?: EasingFunction | string, inputDuration?: number, outputDuration?: number, samples?: number): {
-    speedMultipliers: number[];
-    minSpeed: number;
-    maxSpeed: number;
-    avgSpeed: number;
-};
-
 /**
  * Grid Splitter Utility
  *
@@ -266,78 +176,32 @@ declare function splitWithDimensions(imageDataUrl: string, rows: number, cols: n
 }>;
 
 /**
- * Node Dimensions Utility
- *
- * Calculate node dimensions based on output aspect ratio,
- * respecting min/max constraints.
- */
-/**
- * Extract dimensions from a base64 data URL image.
- */
-declare function getImageDimensions(base64DataUrl: string): Promise<{
-    width: number;
-    height: number;
-} | null>;
-/**
- * Extract dimensions from a video data URL or blob URL.
- */
-declare function getVideoDimensions(videoUrl: string): Promise<{
-    width: number;
-    height: number;
-} | null>;
-/**
- * Calculate node dimensions that maintain aspect ratio within constraints.
- *
- * @param aspectRatio - Width divided by height (e.g., 16/9 for landscape)
- * @param baseWidth - Starting width to calculate from (default 300px)
+ * Get the dimensions of an image from its source URL or data URL.
  */
-declare function calculateNodeSize(aspectRatio: number, baseWidth?: number): {
+declare function getImageDimensions$1(src: string): Promise<{
     width: number;
     height: number;
-};
+}>;
 /**
- * Calculate node dimensions preserving current height if provided.
- *
- * @param aspectRatio - Width divided by height
- * @param currentHeight - Optional current height to preserve (if within constraints)
+ * Get duration and dimensions of a video from its source URL or data URL.
  */
-declare function calculateNodeSizePreservingHeight(aspectRatio: number, currentHeight?: number): {
-    width: number;
-    height: number;
-};
+declare function getVideoMetadata(src: string): Promise<{
+    duration: number;
+    dimensions: {
+        width: number;
+        height: number;
+    };
+}>;
 
+interface MediaInfo {
+    url: string | null;
+    urls?: string[];
+    type: 'image' | 'video' | null;
+}
 /**
- * Deduplicated Fetch Utility
- *
- * When multiple callers request the same URL concurrently, only one
- * actual network request is made. All callers receive the same response
- * data once the request completes. Responses are cached for 5 seconds.
- */
-/**
- * Fetch with request deduplication.
- *
- * Multiple concurrent calls to the same URL (with same headers) will
- * share a single network request. The response is cloned for each caller.
- */
-declare function deduplicatedFetch(url: string, options?: RequestInit): Promise<Response>;
-/**
- * Clear all cached responses.
+ * Extract media URL and type from node data
  */
-declare function clearFetchCache(): void;
-
-declare function calculateWorkflowCost(nodes: WorkflowNode[]): CostBreakdown;
-declare function formatCost(amount: number): string;
-
-interface CubicBezierEditorProps {
-    value: CubicBezier;
-    onChange: (value: CubicBezier) => void;
-    onCommit?: (value: CubicBezier) => void;
-    disabled?: boolean;
-    width?: number;
-    height?: number;
-}
-declare function CubicBezierEditorComponent({ value, onChange, onCommit, disabled, width, height, }: CubicBezierEditorProps): react_jsx_runtime.JSX.Element;
-declare const CubicBezierEditor: react.MemoExoticComponent<typeof CubicBezierEditorComponent>;
+declare function getMediaFromNode(nodeType: NodeType, data: WorkflowNodeData): MediaInfo;
 
 interface ImageModelConfig {
     value: ImageModel;
@@ -365,20 +229,20 @@ interface LipSyncModelConfig {
 }
 declare const LIPSYNC_MODELS: LipSyncModelConfig[];
 declare const LIPSYNC_SYNC_MODES: ({
-    value: "loop";
     label: string;
+    value: "loop";
 } | {
-    value: "bounce";
     label: string;
+    value: "bounce";
 } | {
-    value: "cut_off";
     label: string;
+    value: "cut_off";
 } | {
-    value: "silence";
     label: string;
+    value: "silence";
 } | {
-    value: "remap";
     label: string;
+    value: "remap";
 })[];
 declare const DEFAULT_LIPSYNC_MODEL: LipSyncModel;
 interface TextModelConfig {
@@ -396,4 +260,140 @@ declare function getLipSyncModelLabel(model: LipSyncModel): string;
 declare function getLLMModelLabel(model: TextModel): string;
 declare function lipSyncModelSupportsImage(model: LipSyncModel): boolean;
 
+/**
+ * Node Dimensions Utility
+ *
+ * Calculate node dimensions based on output aspect ratio,
+ * respecting min/max constraints.
+ */
+/**
+ * Extract dimensions from a base64 data URL image.
+ */
+declare function getImageDimensions(base64DataUrl: string): Promise<{
+    width: number;
+    height: number;
+} | null>;
+/**
+ * Extract dimensions from a video data URL or blob URL.
+ */
+declare function getVideoDimensions(videoUrl: string): Promise<{
+    width: number;
+    height: number;
+} | null>;
+/**
+ * Calculate node dimensions that maintain aspect ratio within constraints.
+ *
+ * @param aspectRatio - Width divided by height (e.g., 16/9 for landscape)
+ * @param baseWidth - Starting width to calculate from (default 300px)
+ */
+declare function calculateNodeSize(aspectRatio: number, baseWidth?: number): {
+    width: number;
+    height: number;
+};
+/**
+ * Calculate node dimensions preserving current height if provided.
+ *
+ * @param aspectRatio - Width divided by height
+ * @param currentHeight - Optional current height to preserve (if within constraints)
+ */
+declare function calculateNodeSizePreservingHeight(aspectRatio: number, currentHeight?: number): {
+    width: number;
+    height: number;
+};
+
+/**
+ * Generates dynamic input handles from a model's input schema.
+ *
+ * Merges dynamically discovered handles with static handles defined in NODE_DEFINITIONS.
+ * Static handles take precedence - dynamic handles are only added if not already present.
+ *
+ * @param inputSchema - The model's input schema containing properties
+ * @param staticHandles - Static handles from NODE_DEFINITIONS
+ * @returns Combined array of handles (static + dynamic)
+ */
+declare function generateHandlesFromSchema(inputSchema: Record<string, unknown> | undefined, staticHandles: HandleDefinition[]): HandleDefinition[];
+/**
+ * Check if a handle was dynamically generated from schema.
+ */
+declare function isSchemaHandle(handle: HandleDefinition): boolean;
+
+/**
+ * Shared utilities for working with provider model schemas
+ */
+/**
+ * Extract default values from schema properties
+ */
+declare function getSchemaDefaults(schema: Record<string, unknown> | undefined): Record<string, unknown>;
+/**
+ * Check if the model's schema supports image input
+ * Used to determine whether to enable/disable image input handles
+ */
+declare function supportsImageInput(schema: Record<string, unknown> | undefined): boolean;
+/**
+ * Extract enum values from component schemas for SchemaInputs dropdowns
+ */
+declare function extractEnumValues(componentSchemas: Record<string, {
+    enum?: unknown[];
+    type?: string;
+}> | undefined): Record<string, string[]> | undefined;
+
+/**
+ * Utility functions for validating required schema fields
+ */
+/**
+ * Validates that all required fields in a JSON Schema have values.
+ *
+ * @param inputSchema - The JSON Schema with required array
+ * @param values - Current field values
+ * @param skipFields - Fields to skip (e.g., fields populated via connections)
+ * @returns Validation result with isValid flag and list of missing fields
+ */
+declare function validateRequiredSchemaFields(inputSchema: Record<string, unknown> | undefined, values: Record<string, unknown>, skipFields: Set<string>): {
+    isValid: boolean;
+    missingFields: string[];
+};
+/**
+ * Fields that are populated via node connections rather than schema inputs.
+ * These should be skipped when validating schema required fields.
+ */
+declare const CONNECTION_FIELDS: Set<string>;
+
+/**
+ * Speed Curve Utility
+ *
+ * Advanced time-warping for video speed ramps using easing functions.
+ * Maps original video timestamps to warped timestamps through easing curves.
+ */
+
+/**
+ * Maps original video timestamps to warped timestamps using any easing function.
+ *
+ * @param originalTime - Original timestamp in seconds (0 to inputDuration)
+ * @param inputDuration - Input video duration in seconds (default: 5)
+ * @param outputDuration - Output video duration in seconds (default: 1.5)
+ * @param easingFunction - Easing function or function name string (default: easeInOutCubic)
+ * @returns Warped timestamp for the output video
+ */
+declare function warpTime(originalTime: number, inputDuration?: number, outputDuration?: number, easingFunction?: EasingFunction | string): number;
+/**
+ * Calculate the duration of a frame after warping.
+ */
+declare function calculateWarpedDuration(originalStart: number, originalDuration: number, inputDuration?: number, outputDuration?: number, easingFunction?: EasingFunction | string): number;
+/**
+ * Validate that a warp time function produces valid output.
+ */
+declare function validateWarpFunction(easingFunction?: EasingFunction | string, inputDuration?: number, outputDuration?: number, tolerance?: number): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Generate statistics about the warp curve.
+ */
+declare function analyzeWarpCurve(easingFunction?: EasingFunction | string, inputDuration?: number, outputDuration?: number, samples?: number): {
+    speedMultipliers: number[];
+    minSpeed: number;
+    maxSpeed: number;
+    avgSpeed: number;
+};
+
 export { CONNECTION_FIELDS, CubicBezierEditor, DEFAULT_CUSTOM_BEZIER, DEFAULT_IMAGE_MODEL, DEFAULT_LIPSYNC_MODEL, DEFAULT_LLM_MODEL, DEFAULT_VIDEO_MODEL, EASING_BEZIER_MAP, EASING_PRESETS, type EasingFunction, type EasingPresetName, type GridCandidate, type GridCell, type GridDetectionResult, IMAGE_MODELS, IMAGE_MODEL_ID_MAP, IMAGE_MODEL_MAP, type ImageModelConfig, LIPSYNC_MODELS, LIPSYNC_SYNC_MODES, LLM_MODELS, LLM_MODEL_ID_MAP, LLM_MODEL_MAP, type LipSyncModelConfig, type MediaInfo, PRESET_BEZIERS, type TextModelConfig, VIDEO_MODELS, VIDEO_MODEL_ID_MAP, VIDEO_MODEL_MAP, type VideoModelConfig, analyzeWarpCurve, applySpeedCurve, calculateNodeSize, calculateNodeSizePreservingHeight, calculateWarpedDuration, calculateWorkflowCost, clearFetchCache, createAsymmetricEase, createBezierEasing, createGridForDimensions, deduplicatedFetch, detectAndSplitGrid, detectGrid, detectGridWithDimensions, easing, evaluateBezier, extractEnumValues, formatCost, generateHandlesFromSchema, getAllEasingNames, getEasingBezier, getEasingDisplayName, getEasingFunction, getGridCandidates, getImageDimensions$1 as getImageDimensions, getImageDimensions as getImageDimensionsFromDataUrl, getImageModelLabel, getLLMModelLabel, getLipSyncModelLabel, getMediaFromNode, getPresetBezier, getSchemaDefaults, getVideoDimensions as getVideoDimensionsFromUrl, getVideoMetadata, getVideoModelLabel, isSchemaHandle, lipSyncModelSupportsImage, splitImage, splitWithDimensions, supportsImageInput, validateRequiredSchemaFields, validateWarpFunction, warpTime };