ugcinc 2.40.0 → 2.42.0

package/dist/index.d.ts

@@ -13,4 +13,4 @@ export { RenderClient } from './render';
 export { AutomationsClient, getAllNodes, getNodeByType } from './automations';
 export { MediaClient } from './media';
 export type { ClientConfig, } from './base';
-export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStat, ApiKey, EditorConfig, VideoEditorConfig, ImageEditorConfig, EditorChannel, TimeValue, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, RenderJobSubmit, RenderVideoRequest, RenderImageRequest, RenderJobResponse, RenderJobStatus, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, GetTasksParams, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, RefreshStatsParams, RefreshStatsResponse, RefreshStatsError, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, MediaType, NodePort, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, AutomationTemplate, AutomationRun, NodeRun, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, } from './types';
+export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStat, ApiKey, EditorConfig, VideoEditorConfig, ImageEditorConfig, EditorChannel, TimeValue, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, PositionAnchor, RelativePositionConfig, RenderJobSubmit, RenderVideoRequest, RenderImageRequest, RenderJobResponse, RenderJobStatus, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, GetTasksParams, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, RefreshStatsParams, RefreshStatsResponse, RefreshStatsError, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, MediaType, NodePort, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, AutomationTemplate, AutomationRun, NodeRun, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, } from './types';

package/dist/types.d.ts

@@ -430,6 +430,23 @@ export interface BorderRadiusConfig {
     /** Bottom-left corner radius in pixels */
     bottomLeft?: number;
 }
+/**
+ * Position anchor for relative positioning
+ * Specifies which edge of the reference element to anchor to
+ */
+export type PositionAnchor = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Relative position configuration
+ * When set on a segment, its position is calculated relative to another segment
+ */
+export interface RelativePositionConfig {
+    /** ID of the segment to position relative to */
+    elementId: string;
+    /** Which edge of the reference segment to anchor to */
+    anchor: PositionAnchor;
+    /** Offset in pixels from the anchor point (positive = away from reference) */
+    offset: number;
+}
 /**
  * Visual segment properties (video, image, text, editor)
  */
@@ -450,6 +467,16 @@ export interface VisualSegmentProps extends BaseSegmentProps {
     rotation?: number;
     /** Opacity percentage 0-100 (default: 100) */
     opacity?: number;
+    /**
+     * Relative positioning - when set, xOffset/yOffset are calculated from the reference segment
+     * This is useful for stacking elements like text messages where the reference element's
+     * height may vary based on text content.
+     *
+     * @example
+     * // Position this segment below another segment with a 10px gap
+     * relativePosition: { elementId: 'message-1', anchor: 'bottom', offset: 10 }
+     */
+    relativePosition?: RelativePositionConfig;
 }
 /**
  * Video segment - displays video content with optional audio
@@ -503,8 +530,16 @@ export interface TextSegment extends VisualSegmentProps {
     verticalAlign?: 'top' | 'middle' | 'bottom';
     /** Text direction (default: 'ltr') */
     direction?: 'ltr' | 'rtl';
-    /** Inner padding in pixels (default: 0) */
+    /** Inner padding in pixels - uniform for all sides (default: 0). Overridden by individual padding values if set. */
     padding?: number;
+    /** Top padding in pixels (overrides uniform padding) */
+    paddingTop?: number;
+    /** Right padding in pixels (overrides uniform padding) */
+    paddingRight?: number;
+    /** Bottom padding in pixels (overrides uniform padding) */
+    paddingBottom?: number;
+    /** Left padding in pixels (overrides uniform padding) */
+    paddingLeft?: number;
     /** Font family (default: 'tiktok') */
     fontType?: 'tiktok' | 'apple' | 'arial';
     /** Font size in pixels (default: 40) */
@@ -531,6 +566,8 @@ export interface TextSegment extends VisualSegmentProps {
     color?: string;
     /** Background color with optional alpha (default: transparent) */
     backgroundColor?: string;
+    /** Border radius for background box - individual corners (default: 0) */
+    backgroundBorderRadius?: BorderRadiusConfig;
     /** Text outline color (default: none) */
     strokeColor?: string;
     /** Outline width in pixels (default: 0) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "2.40.0",
+  "version": "2.42.0",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",