ugcinc 2.42.0 → 2.46.0

package/dist/types.d.ts

@@ -431,14 +431,56 @@ export interface BorderRadiusConfig {
     bottomLeft?: number;
 }
 /**
- * Position anchor for relative positioning
- * Specifies which edge of the reference element to anchor to
+ * Vertical anchor for Y positioning (parent element)
+ * Specifies which vertical edge of the reference element to anchor to
  */
+export type VerticalAnchor = 'top' | 'bottom';
+/**
+ * Horizontal anchor for X positioning (parent element)
+ * Specifies which horizontal edge of the reference element to anchor to
+ */
+export type HorizontalAnchor = 'left' | 'right';
+/**
+ * Self anchor for X positioning
+ * Specifies which horizontal edge of THIS element to use for positioning
+ */
+export type HorizontalSelfAnchor = 'left' | 'center' | 'right';
+/**
+ * Self anchor for Y positioning
+ * Specifies which vertical edge of THIS element to use for positioning
+ */
+export type VerticalSelfAnchor = 'top' | 'middle' | 'bottom';
+/** @deprecated Use VerticalAnchor or HorizontalAnchor instead */
 export type PositionAnchor = 'top' | 'bottom' | 'left' | 'right';
 /**
- * Relative position configuration
- * When set on a segment, its position is calculated relative to another segment
+ * Relative X position configuration
+ * When set, the segment's X position is calculated relative to another segment
+ */
+export interface RelativePositionConfigX {
+    /** ID of the segment to position relative to */
+    elementId: string;
+    /** Which horizontal edge of the reference segment to anchor to */
+    anchor: HorizontalAnchor;
+    /** Which horizontal edge of THIS segment to use (default: opposite of anchor) */
+    selfAnchor?: HorizontalSelfAnchor;
+    /** Offset in pixels from the anchor point */
+    offset: number;
+}
+/**
+ * Relative Y position configuration
+ * When set, the segment's Y position is calculated relative to another segment
  */
+export interface RelativePositionConfigY {
+    /** ID of the segment to position relative to */
+    elementId: string;
+    /** Which vertical edge of the reference segment to anchor to */
+    anchor: VerticalAnchor;
+    /** Which vertical edge of THIS segment to use (default: opposite of anchor) */
+    selfAnchor?: VerticalSelfAnchor;
+    /** Offset in pixels from the anchor point */
+    offset: number;
+}
+/** @deprecated Use RelativePositionConfigX and RelativePositionConfigY instead */
 export interface RelativePositionConfig {
     /** ID of the segment to position relative to */
     elementId: string;
@@ -468,14 +510,24 @@ export interface VisualSegmentProps extends BaseSegmentProps {
     /** Opacity percentage 0-100 (default: 100) */
     opacity?: number;
     /**
-     * Relative positioning - when set, xOffset/yOffset are calculated from the reference segment
+     * Relative X positioning - when set, xOffset is calculated from the reference segment
+     *
+     * @example
+     * // Position this segment to the right of another segment
+     * relativePositionX: { elementId: 'message-1', anchor: 'right', offset: 10 }
+     */
+    relativePositionX?: RelativePositionConfigX;
+    /**
+     * Relative Y positioning - when set, yOffset is 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 }
+     * relativePositionY: { elementId: 'message-1', anchor: 'bottom', offset: 10 }
      */
+    relativePositionY?: RelativePositionConfigY;
+    /** @deprecated Use relativePositionX and relativePositionY instead */
     relativePosition?: RelativePositionConfig;
 }
 /**
@@ -564,14 +616,20 @@ export interface TextSegment extends VisualSegmentProps {
     ellipsis?: string;
     /** Text color (default: '#FFFFFF') */
     color?: string;
-    /** Background color with optional alpha (default: transparent) */
+    /** Background color in hex format #RRGGBB (default: transparent) */
     backgroundColor?: string;
+    /** Background opacity 0-100 (default: 100) */
+    backgroundOpacity?: number;
     /** Border radius for background box - individual corners (default: 0) */
     backgroundBorderRadius?: BorderRadiusConfig;
     /** Text outline color (default: none) */
     strokeColor?: string;
     /** Outline width in pixels (default: 0) */
     strokeWidth?: number;
+    /** When true, box shrinks to fit content (width becomes max width) */
+    autoWidth?: boolean;
+    /** Which side the box anchors to when autoWidth is true (default: 'left') */
+    boxAlign?: 'left' | 'center' | 'right';
 }
 /**
  * Editor segment - nested composition (editor within editor)

package/package.json

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