@chili-publish/studio-sdk 1.44.0 → 1.45.0

package/lib/src/types/FrameTypes.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrameTypes.cjs.js","sources":["../../../src/types/FrameTypes.ts"],"sourcesContent":["// FramePropertiesDto\nimport { BarcodeCharacterSet, BarcodeErrorCorrectionLevel, BarcodeType, QuietZone } from './BarcodeTypes';\nimport { ColorUsage } from './ColorStyleTypes';\nimport { HasOverrideState, Id, PropertyState } from './CommonTypes';\nimport { GradientUsage } from './GradientStyleTypes';\nimport { ComponentGridSettings } from '../types/ComponentGridTypes';\nimport {\n    CornerRadiusAll,\n    CornerRadiusNone,\n    CornerRadiusOnly,\n    ShapeFrameSource,\n    ShapeType,\n    ShapeContainerProperties,\n} from './ShapeTypes';\n\nexport type FrameLayoutType = {\n    id: Id;\n    layoutId: Id;\n    horizontal: FrameAnchor;\n    vertical: FrameAnchor;\n    x: PropertyState<number>;\n    y: PropertyState<number>;\n    width: PropertyState<number>;\n    height: PropertyState<number>;\n    rotationDegrees: PropertyState<number>;\n    scaleX: PropertyState<number>;\n    scaleY: PropertyState<number>;\n    isVisible: PropertyState<boolean>;\n    fitMode: PropertyState<FitMode>;\n    fitModePosition: PropertyState<FitModePosition>;\n    smartCropSettings: PropertyState<SmartCropSettings>;\n    hasImageCrop: PropertyState<boolean>;\n    hasFrameSubjectArea: PropertyState<boolean>;\n    minCopyfitting: PropertyState<number>;\n    maxCopyfitting: PropertyState<number>;\n    enableCopyfitting: PropertyState<boolean>;\n    autoGrow: AutoGrowSettings;\n    isShowingCustomCroppedAsset: boolean;\n    customCroppedAssetCount: number;\n    subjectId: PropertyState<Id | null>;\n    componentGridSettings: PropertyState<ComponentGridSettings>;\n} | null;\n\n//Frame.image\nexport type FrameType = {\n    id: Id;\n    name: string;\n    type: FrameTypeEnum;\n    // `imageUrl` is not generic: should be removed from model\n    imageUrl: string;\n    blendMode: string;\n    opacity: number;\n};\n\nexport type Frame = TextFrame | ImageFrame | ShapeFrame | BarcodeFrame | ComponentFrame | ComponentGridFrame;\n\nexport type ImageFrameVariableSource = {\n    type: ImageSourceTypeEnum.variable;\n    id: Id;\n};\n\nexport type ImageFrameUrlSource = {\n    type: ImageSourceTypeEnum.url;\n    url: string;\n};\n\nexport type ImageFrameConnectorSource = {\n    type: ImageSourceTypeEnum.connector;\n    assetId: Id;\n    id: Id;\n};\n\nexport type ImageFrameBrandkitMediaSource = {\n    type: ImageSourceTypeEnum.brandKitMedia;\n    name: string;\n};\n\nexport type ImageFrameSource =\n    | ImageFrameConnectorSource\n    | ImageFrameVariableSource\n    | ImageFrameUrlSource\n    | ImageFrameBrandkitMediaSource;\n\n// used by new getter methods\nexport type ImageFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.image;\n    src?: ImageFrameSource;\n    blendMode: BlendMode;\n    dropShadowSettings?: DropShadowSettings;\n    container: {\n        source: ShapeFrameSource;\n        properties: ShapeContainerProperties;\n    };\n};\n\nexport type ShapeFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.shape;\n    blendMode: BlendMode;\n    shapeProperties: {\n        enableFill: boolean;\n        fillColor: ColorUsage;\n        enableStroke: boolean;\n        strokeWeight: number;\n        strokeColor: ColorUsage;\n        allCornersSame: boolean;\n    };\n    src: {\n        type: ShapeType;\n        cornerRadius: CornerRadiusNone | CornerRadiusAll | CornerRadiusOnly;\n        sides?: number;\n    };\n    dropShadowSettings?: DropShadowSettings;\n    gradient?: GradientUsage;\n};\n\nexport type TextFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.text;\n    textContent: string;\n    paddingLeft: number;\n    paddingTop: number;\n    paddingRight: number;\n    paddingBottom: number;\n    numberOfColumns: number;\n    columnGap: number;\n    textDirection: TextDirection;\n    flowDirection: FlowDirection;\n    verticalAlign: VerticalAlign;\n    textStroke: boolean;\n    textStrokeWeight: number;\n    textStrokeColor: number;\n    hasClippingPath: boolean;\n    blendMode: BlendMode;\n    dropShadowSettings?: DropShadowSettings;\n    hasVariable?: boolean;\n};\n\nexport type BarcodeFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.barcode;\n    blendMode: BlendMode;\n    barcodeProperties: {\n        enableBackground: boolean;\n        backgroundColor: ColorUsage;\n        enableBarColor: boolean;\n        barColor: ColorUsage;\n        enableText: boolean;\n        barHeight: number;\n        magnification: number;\n        quietZone: QuietZone;\n        errorCorrectionLevel?: BarcodeErrorCorrectionLevel;\n        characterSet?: BarcodeCharacterSet;\n        drawStartStopChars: boolean;\n    };\n    src?: BarcodeSource;\n    barcodeType: BarcodeType;\n    dropShadowSettings?: DropShadowSettings;\n};\n\nexport type BarcodeSource = BarcodeVariableSource | BarcodeTextSource;\n\nexport type BarcodeVariableSource = {\n    type: BarcodeSourceTypeEnum.variable;\n    id: Id;\n};\n\nexport type BarcodeTextSource = {\n    type: BarcodeSourceTypeEnum.text;\n    text: string;\n};\n\nexport type ComponentFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.component;\n    blendMode: BlendMode;\n    src: ComponentSource;\n    variableMappings: VariableMapping[];\n\n    /**\n     * How the component fits within the frame.\n     */\n    fitMode: ComponentFitEnum;\n};\n\nexport type ComponentGridFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.componentGrid;\n    blendMode: BlendMode;\n    dataSourceVariableId?: Id | null;\n    src?: ComponentSource | null;\n    variableMappings: GridVariableMapping;\n\n    /**\n     * How the component grid fits within the frame.\n     */\n    fitMode: ComponentFitEnum;\n};\n\nexport type GridVariableMapping = {\n    mappings: Record<string, VariableMapping[] | null>;\n}\n\nexport type ComponentSource = ConnectorComponentSource;\n\nexport type ConnectorComponentSource = {\n    type: ComponentSourceTypeEnum.connector;\n    id: Id;\n    assetId: Id | null;\n};\n\nexport type VariableMapping = {\n    source: Id;\n    target: Id;\n    sourceField?: string;\n};\n\nexport enum ComponentFitEnum {\n    /**\n     * The component resizes to fit the frame size.\n     */\n    resize = 'resize',\n\n    /**\n     * The component scales to fit the frame size while maintaining its aspect ratio.\n     */\n    scale = 'scale',\n\n    /**\n     * The component first scales to fit the frame size while maintaining its aspect ratio,\n     * then resizes to fill the remaining space.\n     */\n    scaleAndResize = 'scaleAndResize',\n}\n\nexport type CropSettings = {\n    left: number;\n    top: number;\n    width: number;\n    height: number;\n    rotationDegrees: number;\n    type: 'default';\n};\n\nexport type NoCropSettings = {\n    type: 'noCrop';\n};\n\nexport type AutoGrowSettings = {\n    enabled: PropertyState<boolean>;\n    minWidth: PropertyState<number>;\n    maxWidth: PropertyState<number>;\n    minHeight: PropertyState<number>;\n    maxHeight: PropertyState<number>;\n    directions: PropertyState<Array<AutoGrowDirection>>;\n};\n\nexport interface AutoGrowDeltaUpdate {\n    enabled?: {\n        value: boolean;\n    };\n    minWidth?: {\n        value: string | null;\n    };\n    maxWidth?: {\n        value: string | null;\n    };\n    minHeight?: {\n        value: string | null;\n    };\n    maxHeight?: {\n        value: string | null;\n    };\n    directions?: {\n        value: Array<AutoGrowDirection>;\n    };\n}\n\nexport type DropShadowSettings = {\n    enabled: boolean;\n    distance: number;\n    angleDegrees: number;\n    blurRadius: number;\n    color: ColorUsage;\n};\n\nexport interface ShadowSettingsDeltaUpdate {\n    distance?: {\n        value: string;\n    };\n    angleDegrees?: {\n        value: number;\n    };\n    blurRadius?: {\n        value: number;\n    };\n    enabled?: {\n        value: boolean;\n    };\n    color?: {\n        value: ColorUsage;\n    };\n}\n\nexport enum AutoGrowDirection {\n    top = 'top',\n    bottom = 'bottom',\n    left = 'left',\n    right = 'right',\n}\n\nexport enum ImageSourceTypeEnum {\n    url = 'url',\n    variable = 'variable',\n    connector = 'connector',\n    brandKitMedia = 'brandKitMedia',\n}\n\nexport enum ComponentSourceTypeEnum {\n    connector = 'connector',\n}\n\nexport enum FrameTypeEnum {\n    text = 'text',\n    image = 'image',\n    shape = 'shape',\n    barcode = 'barcode',\n    component = 'component',\n    componentGrid = 'componentGrid',\n}\n\nexport enum BarcodeSourceTypeEnum {\n    variable = 'variable',\n    text = 'text',\n}\n\nexport enum TextDirection {\n    leftToRight = 'leftToRight',\n    rightToLeft = 'rightToLeft',\n    weak = 'weak',\n}\n\nexport enum FlowDirection {\n    horizontal = 'horizontal',\n    vertical = 'vertical',\n    onPath = 'onPath',\n}\n\nexport enum VerticalAlign {\n    top = 'top',\n    bottom = 'bottom',\n    middle = 'middle',\n    justify = 'justify',\n}\n\nexport enum BlendMode {\n    normal = 'normal',\n    screen = 'screen',\n    overlay = 'overlay',\n    darken = 'darken',\n    lighten = 'lighten',\n    colorDodge = 'colorDodge',\n    colorBurn = 'colorBurn',\n    hardLight = 'hardLight',\n    softLight = 'softLight',\n    difference = 'difference',\n    exclusion = 'exclusion',\n    multiply = 'multiply',\n    hue = 'hue',\n    saturation = 'saturation',\n    color = 'color',\n    luminosity = 'luminosity',\n}\n\nexport enum FitMode {\n    fill = 'fill',\n    fit = 'fit',\n    smartCrop = 'smartCrop',\n    manualCrop = 'manualCrop',\n}\n\nexport enum FitModePosition {\n    topLeft = 'topLeft',\n    topCenter = 'topCenter',\n    topRight = 'topRight',\n    centerLeft = 'centerLeft',\n    center = 'center',\n    centerRight = 'centerRight',\n    bottomLeft = 'bottomLeft',\n    bottomCenter = 'bottomCenter',\n    bottomRight = 'bottomRight',\n}\n\nexport enum UpdateZIndexMethod {\n    bringToFront = 'bringToFront',\n    sendToBack = 'sendToBack',\n    bringForward = 'bringForward',\n    sendBackward = 'sendBackward',\n}\n\nexport enum FrameAnchorType {\n    relative = 'relative',\n    start = 'start',\n    end = 'end',\n    startAndEnd = 'startAndEnd',\n    center = 'center',\n}\n\nexport enum AnchorTargetType {\n    page = 'page',\n    frame = 'frame',\n}\n\nexport enum AnchorTargetEdgeType {\n    start = 'start',\n    end = 'end',\n    center = 'center',\n}\n\nexport class PageAnchorTarget {\n    type = AnchorTargetType.page;\n}\n\nexport class FrameAnchorTarget {\n    frameId: Id;\n    edge: AnchorTargetEdgeType;\n    type = AnchorTargetType.frame;\n\n    constructor(id: Id, edge: AnchorTargetEdgeType) {\n        (this.frameId = id), (this.edge = edge);\n    }\n}\n\nexport type AnchorTarget = PageAnchorTarget | FrameAnchorTarget;\n\nexport type RelativeFrameAnchor = {\n    start: PropertyState<number>;\n    end: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.relative;\n} & HasOverrideState;\n\nexport type StartFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.start;\n} & HasOverrideState;\n\nexport type EndFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.end;\n} & HasOverrideState;\n\nexport type StartAndEndFrameAnchor = {\n    start: PropertyState<number>;\n    startTarget: AnchorTarget;\n    end: PropertyState<number>;\n    endTarget: AnchorTarget;\n    type: FrameAnchorType.startAndEnd;\n} & HasOverrideState;\n\nexport type CenterFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.center;\n} & HasOverrideState;\n\nexport type FrameAnchor =\n    | RelativeFrameAnchor\n    | StartFrameAnchor\n    | EndFrameAnchor\n    | StartAndEndFrameAnchor\n    | CenterFrameAnchor;\n\nexport type FrameAnchorProperties = {\n    horizontal: boolean;\n    type: FrameAnchorType;\n    target: AnchorTarget;\n    endTarget?: AnchorTarget | null;\n};\n\nexport type AnchorConfiguration = {\n    allowedTypes: Set<FrameAnchorType>;\n    allowedFrameIds: Set<Id>;\n};\n\nexport type FrameConfiguration = {\n    horizontal: AnchorConfiguration;\n    vertical: AnchorConfiguration;\n};\n\nexport enum CropType {\n    frameCrop = 'frameCrop',\n    assetCrop = 'assetCrop',\n}\n\n/**\n * Image-specific editing constraints.\n */\nexport type ImageFrameConstraints = {\n    cropAllowed: PropertyState<boolean>;\n};\n\n/**\n * Text-specific editing constraints.\n */\nexport type TextFrameConstraints = {\n    editingAllowed: PropertyState<boolean>;\n    paragraphStyles: PropertyState<IdSetManagedConstraint>;\n    characterStyles: PropertyState<IdSetManagedConstraint>;\n    colors: PropertyState<IdSetManagedConstraint>;\n    fontSizes: PropertyState<FontSizeRangeManagedConstraint>;\n};\n\nexport interface ManagedConstraint {\n    allowed: boolean;\n}\n\n/**\n * A managed constraint represented by a set of allowed Id identifiers.\n *\n * Example: used to allow only a specific set of paragraph or character styles.\n * - `allowed`: If true, only the provided `ids` may be used.\n * - `ids`: The set of allowed Id values.\n */\nexport interface IdSetManagedConstraint extends ManagedConstraint {\n    allowed: boolean;\n    ids: Id[];\n}\n\n/**\n * A managed constraint that restricts allowed font sizes to a continuous range.\n *\n * - `allowed`: If true, restricts allowed font sizes to [min, max] (inclusive).\n * - `min`: The minimum allowed font size (nullable).\n * - `max`: The maximum allowed font size (nullable).\n */\nexport interface FontSizeRangeManagedConstraint extends ManagedConstraint {\n    allowed: boolean;\n    min: number | null;\n    max: number | null;\n}\n\n/**\n * Frame editing constraints with optional frame-type-specific sub-properties.\n */\nexport type FrameConstraints = {\n    selectionAllowed: PropertyState<boolean>;\n    horizontalMovementAllowed: PropertyState<boolean>;\n    verticalMovementAllowed: PropertyState<boolean>;\n    rotationAllowed: PropertyState<boolean>;\n    resizeAllowed: PropertyState<boolean>;\n    proportionLocked: PropertyState<boolean>;\n    /** Image-specific constraints. */\n    image?: ImageFrameConstraints;\n    /** Text-specific constraints. */\n    text?: TextFrameConstraints;\n};\n\n/**\n * Image-specific constraints delta update.\n */\nexport interface ImageFrameConstraintsDeltaUpdate {\n    cropAllowed?: {\n        value: boolean;\n    };\n}\n\n/**\n * Text-specific constraints delta update.\n */\nexport interface TextFrameConstraintsDeltaUpdate {\n    editingAllowed?: {\n        value: boolean;\n    };\n    paragraphStyles?: {\n        value: IdSetManagedConstraint;\n    };\n    characterStyles?: {\n        value: IdSetManagedConstraint;\n    };\n    colors?: {\n        value: IdSetManagedConstraint;\n    };\n    fontSizes?: {\n        value: FontSizeRangeManagedConstraint;\n    };\n}\n\n/**\n * Frame constraints delta update with optional frame-type-specific sub-properties.\n */\nexport interface FrameConstraintsDeltaUpdate {\n    selectionAllowed?: {\n        value: boolean;\n    };\n    horizontalMovementAllowed?: {\n        value: boolean;\n    };\n    verticalMovementAllowed?: {\n        value: boolean;\n    };\n    rotationAllowed?: {\n        value: boolean;\n    };\n    resizeAllowed?: {\n        value: boolean;\n    };\n    proportionLocked?: {\n        value: boolean;\n    };\n    /** Image-specific constraints update. */\n    image?: ImageFrameConstraintsDeltaUpdate;\n    /** Text-specific constraints update. */\n    text?: TextFrameConstraintsDeltaUpdate;\n}\n\nexport type SmartCropSettings = SmartCropSettingsV1 | SmartCropSettingsV2;\n\nexport type SmartCropSettingsV1 = {\n    version: SmartCropVersion.v1;\n};\n\nexport type SmartCropSettingsV2 = {\n    version: SmartCropVersion.v2;\n    horizontalBias: SmartCropAxisBias;\n    verticalBias: SmartCropAxisBias;\n};\n\nexport enum SmartCropVersion {\n    v1 = 'v1',\n    v2 = 'v2',\n}\n\n/**\n * Latest version of the smart crop algorithm.\n * Keep in sync with @SmartCropVersion enum.\n */\nexport const LATEST_SMART_CROP_VERSION = SmartCropVersion.v2;\n\nexport enum SmartCropAxisBias {\n    start = 'start',\n    center = 'center',\n    end = 'end',\n}\n"],"names":["ComponentFitEnum","AutoGrowDirection","ImageSourceTypeEnum","ComponentSourceTypeEnum","FrameTypeEnum","BarcodeSourceTypeEnum","TextDirection","FlowDirection","VerticalAlign","BlendMode","FitMode","FitModePosition","UpdateZIndexMethod","FrameAnchorType","AnchorTargetType","AnchorTargetEdgeType","CropType","SmartCropVersion","SmartCropAxisBias"],"mappings":"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"}
+{"version":3,"file":"FrameTypes.cjs.js","sources":["../../../src/types/FrameTypes.ts"],"sourcesContent":["// FramePropertiesDto\nimport { BarcodeCharacterSet, BarcodeErrorCorrectionLevel, BarcodeType, QuietZone } from './BarcodeTypes';\nimport { ColorUsage } from './ColorStyleTypes';\nimport { HasOverrideState, Id, PropertyState } from './CommonTypes';\nimport { GradientUsage } from './GradientStyleTypes';\nimport { ComponentGridSettings } from '../types/ComponentGridTypes';\nimport {\n    CornerRadiusAll,\n    CornerRadiusNone,\n    CornerRadiusOnly,\n    ShapeFrameSource,\n    ShapeType,\n    ShapeContainerProperties,\n} from './ShapeTypes';\n\nexport type FrameLayoutType = {\n    id: Id;\n    layoutId: Id;\n    horizontal: FrameAnchor;\n    vertical: FrameAnchor;\n    x: PropertyState<number>;\n    y: PropertyState<number>;\n    width: PropertyState<number>;\n    height: PropertyState<number>;\n    rotationDegrees: PropertyState<number>;\n    scaleX: PropertyState<number>;\n    scaleY: PropertyState<number>;\n    isVisible: PropertyState<boolean>;\n    fitMode: PropertyState<FitMode>;\n    fitModePosition: PropertyState<FitModePosition>;\n    smartCropSettings: PropertyState<SmartCropSettings>;\n    hasImageCrop: PropertyState<boolean>;\n    hasFrameSubjectArea: PropertyState<boolean>;\n    minCopyfitting: PropertyState<number>;\n    maxCopyfitting: PropertyState<number>;\n    enableCopyfitting: PropertyState<boolean>;\n    autoGrow: AutoGrowSettings;\n    isShowingCustomCroppedAsset: boolean;\n    customCroppedAssetCount: number;\n    subjectId: PropertyState<Id | null>;\n    componentGridSettings: PropertyState<ComponentGridSettings>;\n    componentFit: PropertyState<ComponentFitEnum>;\n} | null;\n\n//Frame.image\nexport type FrameType = {\n    id: Id;\n    name: string;\n    type: FrameTypeEnum;\n    // `imageUrl` is not generic: should be removed from model\n    imageUrl: string;\n    blendMode: string;\n    opacity: number;\n};\n\nexport type Frame = TextFrame | ImageFrame | ShapeFrame | BarcodeFrame | ComponentFrame | ComponentGridFrame;\n\nexport type ImageFrameVariableSource = {\n    type: ImageSourceTypeEnum.variable;\n    id: Id;\n};\n\nexport type ImageFrameUrlSource = {\n    type: ImageSourceTypeEnum.url;\n    url: string;\n};\n\nexport type ImageFrameConnectorSource = {\n    type: ImageSourceTypeEnum.connector;\n    assetId: Id;\n    id: Id;\n};\n\nexport type ImageFrameBrandkitMediaSource = {\n    type: ImageSourceTypeEnum.brandKitMedia;\n    name: string;\n};\n\nexport type ImageFrameSource =\n    | ImageFrameConnectorSource\n    | ImageFrameVariableSource\n    | ImageFrameUrlSource\n    | ImageFrameBrandkitMediaSource;\n\n// used by new getter methods\nexport type ImageFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.image;\n    src?: ImageFrameSource;\n    blendMode: BlendMode;\n    dropShadowSettings?: DropShadowSettings;\n    container: {\n        source: ShapeFrameSource;\n        properties: ShapeContainerProperties;\n    };\n};\n\nexport type ShapeFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.shape;\n    blendMode: BlendMode;\n    shapeProperties: {\n        enableFill: boolean;\n        fillColor: ColorUsage;\n        enableStroke: boolean;\n        strokeWeight: number;\n        strokeColor: ColorUsage;\n        allCornersSame: boolean;\n    };\n    src: {\n        type: ShapeType;\n        cornerRadius: CornerRadiusNone | CornerRadiusAll | CornerRadiusOnly;\n        sides?: number;\n    };\n    dropShadowSettings?: DropShadowSettings;\n    gradient?: GradientUsage;\n};\n\nexport type TextFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.text;\n    textContent: string;\n    paddingLeft: number;\n    paddingTop: number;\n    paddingRight: number;\n    paddingBottom: number;\n    numberOfColumns: number;\n    columnGap: number;\n    textDirection: TextDirection;\n    flowDirection: FlowDirection;\n    verticalAlign: VerticalAlign;\n    textStroke: boolean;\n    textStrokeWeight: number;\n    textStrokeColor: number;\n    hasClippingPath: boolean;\n    blendMode: BlendMode;\n    dropShadowSettings?: DropShadowSettings;\n    hasVariable?: boolean;\n};\n\nexport type BarcodeFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.barcode;\n    blendMode: BlendMode;\n    barcodeProperties: {\n        enableBackground: boolean;\n        backgroundColor: ColorUsage;\n        enableBarColor: boolean;\n        barColor: ColorUsage;\n        enableText: boolean;\n        barHeight: number;\n        magnification: number;\n        quietZone: QuietZone;\n        errorCorrectionLevel?: BarcodeErrorCorrectionLevel;\n        characterSet?: BarcodeCharacterSet;\n        drawStartStopChars: boolean;\n    };\n    src?: BarcodeSource;\n    barcodeType: BarcodeType;\n    dropShadowSettings?: DropShadowSettings;\n};\n\nexport type BarcodeSource = BarcodeVariableSource | BarcodeTextSource;\n\nexport type BarcodeVariableSource = {\n    type: BarcodeSourceTypeEnum.variable;\n    id: Id;\n};\n\nexport type BarcodeTextSource = {\n    type: BarcodeSourceTypeEnum.text;\n    text: string;\n};\n\nexport type ComponentFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.component;\n    blendMode: BlendMode;\n    src: ComponentSource;\n    variableMappings: VariableMapping[];\n\n    /**\n     * How the component fits within the frame.\n     */\n    fitMode: ComponentFitEnum;\n};\n\nexport type ComponentGridFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.componentGrid;\n    blendMode: BlendMode;\n    dataSourceVariableId?: Id | null;\n    src?: ComponentSource | null;\n    variableMappings: GridVariableMapping;\n};\n\nexport type GridVariableMapping = {\n    mappings: Record<string, VariableMapping[] | null>;\n}\n\nexport type ComponentSource = ConnectorComponentSource;\n\nexport type ConnectorComponentSource = {\n    type: ComponentSourceTypeEnum.connector;\n    id: Id;\n    assetId: Id | null;\n};\n\nexport type VariableMapping = {\n    source: Id;\n    target: Id;\n    sourceField?: string;\n};\n\nexport enum ComponentFitEnum {\n    /**\n     * The component resizes to fit the frame size.\n     */\n    resize = 'resize',\n\n    /**\n     * The component scales to fit the frame size while maintaining its aspect ratio.\n     */\n    scale = 'scale',\n\n    /**\n     * The component first scales to fit the frame size while maintaining its aspect ratio,\n     * then resizes to fill the remaining space.\n     */\n    scaleAndResize = 'scaleAndResize',\n}\n\nexport type CropSettings = {\n    left: number;\n    top: number;\n    width: number;\n    height: number;\n    rotationDegrees: number;\n    type: 'default';\n};\n\nexport type NoCropSettings = {\n    type: 'noCrop';\n};\n\nexport type AutoGrowSettings = {\n    enabled: PropertyState<boolean>;\n    minWidth: PropertyState<number>;\n    maxWidth: PropertyState<number>;\n    minHeight: PropertyState<number>;\n    maxHeight: PropertyState<number>;\n    directions: PropertyState<Array<AutoGrowDirection>>;\n};\n\nexport interface AutoGrowDeltaUpdate {\n    enabled?: {\n        value: boolean;\n    };\n    minWidth?: {\n        value: string | null;\n    };\n    maxWidth?: {\n        value: string | null;\n    };\n    minHeight?: {\n        value: string | null;\n    };\n    maxHeight?: {\n        value: string | null;\n    };\n    directions?: {\n        value: Array<AutoGrowDirection>;\n    };\n}\n\nexport type DropShadowSettings = {\n    enabled: boolean;\n    distance: number;\n    angleDegrees: number;\n    blurRadius: number;\n    color: ColorUsage;\n};\n\nexport interface ShadowSettingsDeltaUpdate {\n    distance?: {\n        value: string;\n    };\n    angleDegrees?: {\n        value: number;\n    };\n    blurRadius?: {\n        value: number;\n    };\n    enabled?: {\n        value: boolean;\n    };\n    color?: {\n        value: ColorUsage;\n    };\n}\n\nexport enum AutoGrowDirection {\n    top = 'top',\n    bottom = 'bottom',\n    left = 'left',\n    right = 'right',\n}\n\nexport enum ImageSourceTypeEnum {\n    url = 'url',\n    variable = 'variable',\n    connector = 'connector',\n    brandKitMedia = 'brandKitMedia',\n}\n\nexport enum ComponentSourceTypeEnum {\n    connector = 'connector',\n}\n\nexport enum FrameTypeEnum {\n    text = 'text',\n    image = 'image',\n    shape = 'shape',\n    barcode = 'barcode',\n    component = 'component',\n    componentGrid = 'componentGrid',\n}\n\nexport enum BarcodeSourceTypeEnum {\n    variable = 'variable',\n    text = 'text',\n}\n\nexport enum TextDirection {\n    leftToRight = 'leftToRight',\n    rightToLeft = 'rightToLeft',\n    weak = 'weak',\n}\n\nexport enum FlowDirection {\n    horizontal = 'horizontal',\n    vertical = 'vertical',\n    onPath = 'onPath',\n}\n\nexport enum VerticalAlign {\n    top = 'top',\n    bottom = 'bottom',\n    middle = 'middle',\n    justify = 'justify',\n}\n\nexport enum BlendMode {\n    normal = 'normal',\n    screen = 'screen',\n    overlay = 'overlay',\n    darken = 'darken',\n    lighten = 'lighten',\n    colorDodge = 'colorDodge',\n    colorBurn = 'colorBurn',\n    hardLight = 'hardLight',\n    softLight = 'softLight',\n    difference = 'difference',\n    exclusion = 'exclusion',\n    multiply = 'multiply',\n    hue = 'hue',\n    saturation = 'saturation',\n    color = 'color',\n    luminosity = 'luminosity',\n}\n\nexport enum FitMode {\n    fill = 'fill',\n    fit = 'fit',\n    smartCrop = 'smartCrop',\n    manualCrop = 'manualCrop',\n}\n\nexport enum FitModePosition {\n    topLeft = 'topLeft',\n    topCenter = 'topCenter',\n    topRight = 'topRight',\n    centerLeft = 'centerLeft',\n    center = 'center',\n    centerRight = 'centerRight',\n    bottomLeft = 'bottomLeft',\n    bottomCenter = 'bottomCenter',\n    bottomRight = 'bottomRight',\n}\n\nexport enum UpdateZIndexMethod {\n    bringToFront = 'bringToFront',\n    sendToBack = 'sendToBack',\n    bringForward = 'bringForward',\n    sendBackward = 'sendBackward',\n}\n\nexport enum FrameAnchorType {\n    relative = 'relative',\n    start = 'start',\n    end = 'end',\n    startAndEnd = 'startAndEnd',\n    center = 'center',\n}\n\nexport enum AnchorTargetType {\n    page = 'page',\n    frame = 'frame',\n}\n\nexport enum AnchorTargetEdgeType {\n    start = 'start',\n    end = 'end',\n    center = 'center',\n}\n\nexport class PageAnchorTarget {\n    type = AnchorTargetType.page;\n}\n\nexport class FrameAnchorTarget {\n    frameId: Id;\n    edge: AnchorTargetEdgeType;\n    type = AnchorTargetType.frame;\n\n    constructor(id: Id, edge: AnchorTargetEdgeType) {\n        (this.frameId = id), (this.edge = edge);\n    }\n}\n\nexport type AnchorTarget = PageAnchorTarget | FrameAnchorTarget;\n\nexport type RelativeFrameAnchor = {\n    start: PropertyState<number>;\n    end: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.relative;\n} & HasOverrideState;\n\nexport type StartFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.start;\n} & HasOverrideState;\n\nexport type EndFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.end;\n} & HasOverrideState;\n\nexport type StartAndEndFrameAnchor = {\n    start: PropertyState<number>;\n    startTarget: AnchorTarget;\n    end: PropertyState<number>;\n    endTarget: AnchorTarget;\n    type: FrameAnchorType.startAndEnd;\n} & HasOverrideState;\n\nexport type CenterFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.center;\n} & HasOverrideState;\n\nexport type FrameAnchor =\n    | RelativeFrameAnchor\n    | StartFrameAnchor\n    | EndFrameAnchor\n    | StartAndEndFrameAnchor\n    | CenterFrameAnchor;\n\nexport type FrameAnchorProperties = {\n    horizontal: boolean;\n    type: FrameAnchorType;\n    target: AnchorTarget;\n    endTarget?: AnchorTarget | null;\n};\n\nexport type AnchorConfiguration = {\n    allowedTypes: Set<FrameAnchorType>;\n    allowedFrameIds: Set<Id>;\n};\n\nexport type FrameConfiguration = {\n    horizontal: AnchorConfiguration;\n    vertical: AnchorConfiguration;\n};\n\nexport enum CropType {\n    frameCrop = 'frameCrop',\n    assetCrop = 'assetCrop',\n}\n\n/**\n * Image-specific editing constraints.\n */\nexport type ImageFrameConstraints = {\n    cropAllowed: PropertyState<boolean>;\n};\n\n/**\n * Text-specific editing constraints.\n */\nexport type TextFrameConstraints = {\n    editingAllowed: PropertyState<boolean>;\n    paragraphStyles: PropertyState<IdSetManagedConstraint>;\n    characterStyles: PropertyState<IdSetManagedConstraint>;\n    colors: PropertyState<IdSetManagedConstraint>;\n    fontSizes: PropertyState<FontSizeRangeManagedConstraint>;\n};\n\nexport interface ManagedConstraint {\n    allowed: boolean;\n}\n\n/**\n * A managed constraint represented by a set of allowed Id identifiers.\n *\n * Example: used to allow only a specific set of paragraph or character styles.\n * - `allowed`: If true, only the provided `ids` may be used.\n * - `ids`: The set of allowed Id values.\n */\nexport interface IdSetManagedConstraint extends ManagedConstraint {\n    allowed: boolean;\n    ids: Id[];\n}\n\n/**\n * A managed constraint that restricts allowed font sizes to a continuous range.\n *\n * - `allowed`: If true, restricts allowed font sizes to [min, max] (inclusive).\n * - `min`: The minimum allowed font size (nullable).\n * - `max`: The maximum allowed font size (nullable).\n */\nexport interface FontSizeRangeManagedConstraint extends ManagedConstraint {\n    allowed: boolean;\n    min: number | null;\n    max: number | null;\n}\n\n/**\n * Frame editing constraints with optional frame-type-specific sub-properties.\n */\nexport type FrameConstraints = {\n    selectionAllowed: PropertyState<boolean>;\n    horizontalMovementAllowed: PropertyState<boolean>;\n    verticalMovementAllowed: PropertyState<boolean>;\n    rotationAllowed: PropertyState<boolean>;\n    resizeAllowed: PropertyState<boolean>;\n    proportionLocked: PropertyState<boolean>;\n    /** Image-specific constraints. */\n    image?: ImageFrameConstraints;\n    /** Text-specific constraints. */\n    text?: TextFrameConstraints;\n};\n\n/**\n * Image-specific constraints delta update.\n */\nexport interface ImageFrameConstraintsDeltaUpdate {\n    cropAllowed?: {\n        value: boolean;\n    };\n}\n\n/**\n * Text-specific constraints delta update.\n */\nexport interface TextFrameConstraintsDeltaUpdate {\n    editingAllowed?: {\n        value: boolean;\n    };\n    paragraphStyles?: {\n        value: IdSetManagedConstraint;\n    };\n    characterStyles?: {\n        value: IdSetManagedConstraint;\n    };\n    colors?: {\n        value: IdSetManagedConstraint;\n    };\n    fontSizes?: {\n        value: FontSizeRangeManagedConstraint;\n    };\n}\n\n/**\n * Frame constraints delta update with optional frame-type-specific sub-properties.\n */\nexport interface FrameConstraintsDeltaUpdate {\n    selectionAllowed?: {\n        value: boolean;\n    };\n    horizontalMovementAllowed?: {\n        value: boolean;\n    };\n    verticalMovementAllowed?: {\n        value: boolean;\n    };\n    rotationAllowed?: {\n        value: boolean;\n    };\n    resizeAllowed?: {\n        value: boolean;\n    };\n    proportionLocked?: {\n        value: boolean;\n    };\n    /** Image-specific constraints update. */\n    image?: ImageFrameConstraintsDeltaUpdate;\n    /** Text-specific constraints update. */\n    text?: TextFrameConstraintsDeltaUpdate;\n}\n\nexport type SmartCropSettings = SmartCropSettingsV1 | SmartCropSettingsV2;\n\nexport type SmartCropSettingsV1 = {\n    version: SmartCropVersion.v1;\n};\n\nexport type SmartCropSettingsV2 = {\n    version: SmartCropVersion.v2;\n    horizontalBias: SmartCropAxisBias;\n    verticalBias: SmartCropAxisBias;\n};\n\nexport enum SmartCropVersion {\n    v1 = 'v1',\n    v2 = 'v2',\n}\n\n/**\n * Latest version of the smart crop algorithm.\n * Keep in sync with @SmartCropVersion enum.\n */\nexport const LATEST_SMART_CROP_VERSION = SmartCropVersion.v2;\n\nexport enum SmartCropAxisBias {\n    start = 'start',\n    center = 'center',\n    end = 'end',\n}\n"],"names":["ComponentFitEnum","AutoGrowDirection","ImageSourceTypeEnum","ComponentSourceTypeEnum","FrameTypeEnum","BarcodeSourceTypeEnum","TextDirection","FlowDirection","VerticalAlign","BlendMode","FitMode","FitModePosition","UpdateZIndexMethod","FrameAnchorType","AnchorTargetType","AnchorTargetEdgeType","CropType","SmartCropVersion","SmartCropAxisBias"],"mappings":"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"}

package/lib/src/types/FrameTypes.d.ts

@@ -30,6 +30,7 @@ export type FrameLayoutType = {
     customCroppedAssetCount: number;
     subjectId: PropertyState<Id | null>;
     componentGridSettings: PropertyState<ComponentGridSettings>;
+    componentFit: PropertyState<ComponentFitEnum>;
 } | null;
 export type FrameType = {
     id: Id;
@@ -170,10 +171,6 @@ export type ComponentGridFrame = {
     dataSourceVariableId?: Id | null;
     src?: ComponentSource | null;
     variableMappings: GridVariableMapping;
-    /**
-     * How the component grid fits within the frame.
-     */
-    fitMode: ComponentFitEnum;
 };
 export type GridVariableMapping = {
     mappings: Record<string, VariableMapping[] | null>;

package/lib/src/types/FrameTypes.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrameTypes.es.js","sources":["../../../src/types/FrameTypes.ts"],"sourcesContent":["// FramePropertiesDto\nimport { BarcodeCharacterSet, BarcodeErrorCorrectionLevel, BarcodeType, QuietZone } from './BarcodeTypes';\nimport { ColorUsage } from './ColorStyleTypes';\nimport { HasOverrideState, Id, PropertyState } from './CommonTypes';\nimport { GradientUsage } from './GradientStyleTypes';\nimport { ComponentGridSettings } from '../types/ComponentGridTypes';\nimport {\n    CornerRadiusAll,\n    CornerRadiusNone,\n    CornerRadiusOnly,\n    ShapeFrameSource,\n    ShapeType,\n    ShapeContainerProperties,\n} from './ShapeTypes';\n\nexport type FrameLayoutType = {\n    id: Id;\n    layoutId: Id;\n    horizontal: FrameAnchor;\n    vertical: FrameAnchor;\n    x: PropertyState<number>;\n    y: PropertyState<number>;\n    width: PropertyState<number>;\n    height: PropertyState<number>;\n    rotationDegrees: PropertyState<number>;\n    scaleX: PropertyState<number>;\n    scaleY: PropertyState<number>;\n    isVisible: PropertyState<boolean>;\n    fitMode: PropertyState<FitMode>;\n    fitModePosition: PropertyState<FitModePosition>;\n    smartCropSettings: PropertyState<SmartCropSettings>;\n    hasImageCrop: PropertyState<boolean>;\n    hasFrameSubjectArea: PropertyState<boolean>;\n    minCopyfitting: PropertyState<number>;\n    maxCopyfitting: PropertyState<number>;\n    enableCopyfitting: PropertyState<boolean>;\n    autoGrow: AutoGrowSettings;\n    isShowingCustomCroppedAsset: boolean;\n    customCroppedAssetCount: number;\n    subjectId: PropertyState<Id | null>;\n    componentGridSettings: PropertyState<ComponentGridSettings>;\n} | null;\n\n//Frame.image\nexport type FrameType = {\n    id: Id;\n    name: string;\n    type: FrameTypeEnum;\n    // `imageUrl` is not generic: should be removed from model\n    imageUrl: string;\n    blendMode: string;\n    opacity: number;\n};\n\nexport type Frame = TextFrame | ImageFrame | ShapeFrame | BarcodeFrame | ComponentFrame | ComponentGridFrame;\n\nexport type ImageFrameVariableSource = {\n    type: ImageSourceTypeEnum.variable;\n    id: Id;\n};\n\nexport type ImageFrameUrlSource = {\n    type: ImageSourceTypeEnum.url;\n    url: string;\n};\n\nexport type ImageFrameConnectorSource = {\n    type: ImageSourceTypeEnum.connector;\n    assetId: Id;\n    id: Id;\n};\n\nexport type ImageFrameBrandkitMediaSource = {\n    type: ImageSourceTypeEnum.brandKitMedia;\n    name: string;\n};\n\nexport type ImageFrameSource =\n    | ImageFrameConnectorSource\n    | ImageFrameVariableSource\n    | ImageFrameUrlSource\n    | ImageFrameBrandkitMediaSource;\n\n// used by new getter methods\nexport type ImageFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.image;\n    src?: ImageFrameSource;\n    blendMode: BlendMode;\n    dropShadowSettings?: DropShadowSettings;\n    container: {\n        source: ShapeFrameSource;\n        properties: ShapeContainerProperties;\n    };\n};\n\nexport type ShapeFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.shape;\n    blendMode: BlendMode;\n    shapeProperties: {\n        enableFill: boolean;\n        fillColor: ColorUsage;\n        enableStroke: boolean;\n        strokeWeight: number;\n        strokeColor: ColorUsage;\n        allCornersSame: boolean;\n    };\n    src: {\n        type: ShapeType;\n        cornerRadius: CornerRadiusNone | CornerRadiusAll | CornerRadiusOnly;\n        sides?: number;\n    };\n    dropShadowSettings?: DropShadowSettings;\n    gradient?: GradientUsage;\n};\n\nexport type TextFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.text;\n    textContent: string;\n    paddingLeft: number;\n    paddingTop: number;\n    paddingRight: number;\n    paddingBottom: number;\n    numberOfColumns: number;\n    columnGap: number;\n    textDirection: TextDirection;\n    flowDirection: FlowDirection;\n    verticalAlign: VerticalAlign;\n    textStroke: boolean;\n    textStrokeWeight: number;\n    textStrokeColor: number;\n    hasClippingPath: boolean;\n    blendMode: BlendMode;\n    dropShadowSettings?: DropShadowSettings;\n    hasVariable?: boolean;\n};\n\nexport type BarcodeFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.barcode;\n    blendMode: BlendMode;\n    barcodeProperties: {\n        enableBackground: boolean;\n        backgroundColor: ColorUsage;\n        enableBarColor: boolean;\n        barColor: ColorUsage;\n        enableText: boolean;\n        barHeight: number;\n        magnification: number;\n        quietZone: QuietZone;\n        errorCorrectionLevel?: BarcodeErrorCorrectionLevel;\n        characterSet?: BarcodeCharacterSet;\n        drawStartStopChars: boolean;\n    };\n    src?: BarcodeSource;\n    barcodeType: BarcodeType;\n    dropShadowSettings?: DropShadowSettings;\n};\n\nexport type BarcodeSource = BarcodeVariableSource | BarcodeTextSource;\n\nexport type BarcodeVariableSource = {\n    type: BarcodeSourceTypeEnum.variable;\n    id: Id;\n};\n\nexport type BarcodeTextSource = {\n    type: BarcodeSourceTypeEnum.text;\n    text: string;\n};\n\nexport type ComponentFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.component;\n    blendMode: BlendMode;\n    src: ComponentSource;\n    variableMappings: VariableMapping[];\n\n    /**\n     * How the component fits within the frame.\n     */\n    fitMode: ComponentFitEnum;\n};\n\nexport type ComponentGridFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.componentGrid;\n    blendMode: BlendMode;\n    dataSourceVariableId?: Id | null;\n    src?: ComponentSource | null;\n    variableMappings: GridVariableMapping;\n\n    /**\n     * How the component grid fits within the frame.\n     */\n    fitMode: ComponentFitEnum;\n};\n\nexport type GridVariableMapping = {\n    mappings: Record<string, VariableMapping[] | null>;\n}\n\nexport type ComponentSource = ConnectorComponentSource;\n\nexport type ConnectorComponentSource = {\n    type: ComponentSourceTypeEnum.connector;\n    id: Id;\n    assetId: Id | null;\n};\n\nexport type VariableMapping = {\n    source: Id;\n    target: Id;\n    sourceField?: string;\n};\n\nexport enum ComponentFitEnum {\n    /**\n     * The component resizes to fit the frame size.\n     */\n    resize = 'resize',\n\n    /**\n     * The component scales to fit the frame size while maintaining its aspect ratio.\n     */\n    scale = 'scale',\n\n    /**\n     * The component first scales to fit the frame size while maintaining its aspect ratio,\n     * then resizes to fill the remaining space.\n     */\n    scaleAndResize = 'scaleAndResize',\n}\n\nexport type CropSettings = {\n    left: number;\n    top: number;\n    width: number;\n    height: number;\n    rotationDegrees: number;\n    type: 'default';\n};\n\nexport type NoCropSettings = {\n    type: 'noCrop';\n};\n\nexport type AutoGrowSettings = {\n    enabled: PropertyState<boolean>;\n    minWidth: PropertyState<number>;\n    maxWidth: PropertyState<number>;\n    minHeight: PropertyState<number>;\n    maxHeight: PropertyState<number>;\n    directions: PropertyState<Array<AutoGrowDirection>>;\n};\n\nexport interface AutoGrowDeltaUpdate {\n    enabled?: {\n        value: boolean;\n    };\n    minWidth?: {\n        value: string | null;\n    };\n    maxWidth?: {\n        value: string | null;\n    };\n    minHeight?: {\n        value: string | null;\n    };\n    maxHeight?: {\n        value: string | null;\n    };\n    directions?: {\n        value: Array<AutoGrowDirection>;\n    };\n}\n\nexport type DropShadowSettings = {\n    enabled: boolean;\n    distance: number;\n    angleDegrees: number;\n    blurRadius: number;\n    color: ColorUsage;\n};\n\nexport interface ShadowSettingsDeltaUpdate {\n    distance?: {\n        value: string;\n    };\n    angleDegrees?: {\n        value: number;\n    };\n    blurRadius?: {\n        value: number;\n    };\n    enabled?: {\n        value: boolean;\n    };\n    color?: {\n        value: ColorUsage;\n    };\n}\n\nexport enum AutoGrowDirection {\n    top = 'top',\n    bottom = 'bottom',\n    left = 'left',\n    right = 'right',\n}\n\nexport enum ImageSourceTypeEnum {\n    url = 'url',\n    variable = 'variable',\n    connector = 'connector',\n    brandKitMedia = 'brandKitMedia',\n}\n\nexport enum ComponentSourceTypeEnum {\n    connector = 'connector',\n}\n\nexport enum FrameTypeEnum {\n    text = 'text',\n    image = 'image',\n    shape = 'shape',\n    barcode = 'barcode',\n    component = 'component',\n    componentGrid = 'componentGrid',\n}\n\nexport enum BarcodeSourceTypeEnum {\n    variable = 'variable',\n    text = 'text',\n}\n\nexport enum TextDirection {\n    leftToRight = 'leftToRight',\n    rightToLeft = 'rightToLeft',\n    weak = 'weak',\n}\n\nexport enum FlowDirection {\n    horizontal = 'horizontal',\n    vertical = 'vertical',\n    onPath = 'onPath',\n}\n\nexport enum VerticalAlign {\n    top = 'top',\n    bottom = 'bottom',\n    middle = 'middle',\n    justify = 'justify',\n}\n\nexport enum BlendMode {\n    normal = 'normal',\n    screen = 'screen',\n    overlay = 'overlay',\n    darken = 'darken',\n    lighten = 'lighten',\n    colorDodge = 'colorDodge',\n    colorBurn = 'colorBurn',\n    hardLight = 'hardLight',\n    softLight = 'softLight',\n    difference = 'difference',\n    exclusion = 'exclusion',\n    multiply = 'multiply',\n    hue = 'hue',\n    saturation = 'saturation',\n    color = 'color',\n    luminosity = 'luminosity',\n}\n\nexport enum FitMode {\n    fill = 'fill',\n    fit = 'fit',\n    smartCrop = 'smartCrop',\n    manualCrop = 'manualCrop',\n}\n\nexport enum FitModePosition {\n    topLeft = 'topLeft',\n    topCenter = 'topCenter',\n    topRight = 'topRight',\n    centerLeft = 'centerLeft',\n    center = 'center',\n    centerRight = 'centerRight',\n    bottomLeft = 'bottomLeft',\n    bottomCenter = 'bottomCenter',\n    bottomRight = 'bottomRight',\n}\n\nexport enum UpdateZIndexMethod {\n    bringToFront = 'bringToFront',\n    sendToBack = 'sendToBack',\n    bringForward = 'bringForward',\n    sendBackward = 'sendBackward',\n}\n\nexport enum FrameAnchorType {\n    relative = 'relative',\n    start = 'start',\n    end = 'end',\n    startAndEnd = 'startAndEnd',\n    center = 'center',\n}\n\nexport enum AnchorTargetType {\n    page = 'page',\n    frame = 'frame',\n}\n\nexport enum AnchorTargetEdgeType {\n    start = 'start',\n    end = 'end',\n    center = 'center',\n}\n\nexport class PageAnchorTarget {\n    type = AnchorTargetType.page;\n}\n\nexport class FrameAnchorTarget {\n    frameId: Id;\n    edge: AnchorTargetEdgeType;\n    type = AnchorTargetType.frame;\n\n    constructor(id: Id, edge: AnchorTargetEdgeType) {\n        (this.frameId = id), (this.edge = edge);\n    }\n}\n\nexport type AnchorTarget = PageAnchorTarget | FrameAnchorTarget;\n\nexport type RelativeFrameAnchor = {\n    start: PropertyState<number>;\n    end: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.relative;\n} & HasOverrideState;\n\nexport type StartFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.start;\n} & HasOverrideState;\n\nexport type EndFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.end;\n} & HasOverrideState;\n\nexport type StartAndEndFrameAnchor = {\n    start: PropertyState<number>;\n    startTarget: AnchorTarget;\n    end: PropertyState<number>;\n    endTarget: AnchorTarget;\n    type: FrameAnchorType.startAndEnd;\n} & HasOverrideState;\n\nexport type CenterFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.center;\n} & HasOverrideState;\n\nexport type FrameAnchor =\n    | RelativeFrameAnchor\n    | StartFrameAnchor\n    | EndFrameAnchor\n    | StartAndEndFrameAnchor\n    | CenterFrameAnchor;\n\nexport type FrameAnchorProperties = {\n    horizontal: boolean;\n    type: FrameAnchorType;\n    target: AnchorTarget;\n    endTarget?: AnchorTarget | null;\n};\n\nexport type AnchorConfiguration = {\n    allowedTypes: Set<FrameAnchorType>;\n    allowedFrameIds: Set<Id>;\n};\n\nexport type FrameConfiguration = {\n    horizontal: AnchorConfiguration;\n    vertical: AnchorConfiguration;\n};\n\nexport enum CropType {\n    frameCrop = 'frameCrop',\n    assetCrop = 'assetCrop',\n}\n\n/**\n * Image-specific editing constraints.\n */\nexport type ImageFrameConstraints = {\n    cropAllowed: PropertyState<boolean>;\n};\n\n/**\n * Text-specific editing constraints.\n */\nexport type TextFrameConstraints = {\n    editingAllowed: PropertyState<boolean>;\n    paragraphStyles: PropertyState<IdSetManagedConstraint>;\n    characterStyles: PropertyState<IdSetManagedConstraint>;\n    colors: PropertyState<IdSetManagedConstraint>;\n    fontSizes: PropertyState<FontSizeRangeManagedConstraint>;\n};\n\nexport interface ManagedConstraint {\n    allowed: boolean;\n}\n\n/**\n * A managed constraint represented by a set of allowed Id identifiers.\n *\n * Example: used to allow only a specific set of paragraph or character styles.\n * - `allowed`: If true, only the provided `ids` may be used.\n * - `ids`: The set of allowed Id values.\n */\nexport interface IdSetManagedConstraint extends ManagedConstraint {\n    allowed: boolean;\n    ids: Id[];\n}\n\n/**\n * A managed constraint that restricts allowed font sizes to a continuous range.\n *\n * - `allowed`: If true, restricts allowed font sizes to [min, max] (inclusive).\n * - `min`: The minimum allowed font size (nullable).\n * - `max`: The maximum allowed font size (nullable).\n */\nexport interface FontSizeRangeManagedConstraint extends ManagedConstraint {\n    allowed: boolean;\n    min: number | null;\n    max: number | null;\n}\n\n/**\n * Frame editing constraints with optional frame-type-specific sub-properties.\n */\nexport type FrameConstraints = {\n    selectionAllowed: PropertyState<boolean>;\n    horizontalMovementAllowed: PropertyState<boolean>;\n    verticalMovementAllowed: PropertyState<boolean>;\n    rotationAllowed: PropertyState<boolean>;\n    resizeAllowed: PropertyState<boolean>;\n    proportionLocked: PropertyState<boolean>;\n    /** Image-specific constraints. */\n    image?: ImageFrameConstraints;\n    /** Text-specific constraints. */\n    text?: TextFrameConstraints;\n};\n\n/**\n * Image-specific constraints delta update.\n */\nexport interface ImageFrameConstraintsDeltaUpdate {\n    cropAllowed?: {\n        value: boolean;\n    };\n}\n\n/**\n * Text-specific constraints delta update.\n */\nexport interface TextFrameConstraintsDeltaUpdate {\n    editingAllowed?: {\n        value: boolean;\n    };\n    paragraphStyles?: {\n        value: IdSetManagedConstraint;\n    };\n    characterStyles?: {\n        value: IdSetManagedConstraint;\n    };\n    colors?: {\n        value: IdSetManagedConstraint;\n    };\n    fontSizes?: {\n        value: FontSizeRangeManagedConstraint;\n    };\n}\n\n/**\n * Frame constraints delta update with optional frame-type-specific sub-properties.\n */\nexport interface FrameConstraintsDeltaUpdate {\n    selectionAllowed?: {\n        value: boolean;\n    };\n    horizontalMovementAllowed?: {\n        value: boolean;\n    };\n    verticalMovementAllowed?: {\n        value: boolean;\n    };\n    rotationAllowed?: {\n        value: boolean;\n    };\n    resizeAllowed?: {\n        value: boolean;\n    };\n    proportionLocked?: {\n        value: boolean;\n    };\n    /** Image-specific constraints update. */\n    image?: ImageFrameConstraintsDeltaUpdate;\n    /** Text-specific constraints update. */\n    text?: TextFrameConstraintsDeltaUpdate;\n}\n\nexport type SmartCropSettings = SmartCropSettingsV1 | SmartCropSettingsV2;\n\nexport type SmartCropSettingsV1 = {\n    version: SmartCropVersion.v1;\n};\n\nexport type SmartCropSettingsV2 = {\n    version: SmartCropVersion.v2;\n    horizontalBias: SmartCropAxisBias;\n    verticalBias: SmartCropAxisBias;\n};\n\nexport enum SmartCropVersion {\n    v1 = 'v1',\n    v2 = 'v2',\n}\n\n/**\n * Latest version of the smart crop algorithm.\n * Keep in sync with @SmartCropVersion enum.\n */\nexport const LATEST_SMART_CROP_VERSION = SmartCropVersion.v2;\n\nexport enum SmartCropAxisBias {\n    start = 'start',\n    center = 'center',\n    end = 'end',\n}\n"],"names":["ComponentFitEnum","AutoGrowDirection","ImageSourceTypeEnum","ComponentSourceTypeEnum","FrameTypeEnum","BarcodeSourceTypeEnum","TextDirection","FlowDirection","VerticalAlign","BlendMode","FitMode","FitModePosition","UpdateZIndexMethod","FrameAnchorType","AnchorTargetType","AnchorTargetEdgeType","CropType","SmartCropVersion","SmartCropAxisBias"],"mappings":"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"}
+{"version":3,"file":"FrameTypes.es.js","sources":["../../../src/types/FrameTypes.ts"],"sourcesContent":["// FramePropertiesDto\nimport { BarcodeCharacterSet, BarcodeErrorCorrectionLevel, BarcodeType, QuietZone } from './BarcodeTypes';\nimport { ColorUsage } from './ColorStyleTypes';\nimport { HasOverrideState, Id, PropertyState } from './CommonTypes';\nimport { GradientUsage } from './GradientStyleTypes';\nimport { ComponentGridSettings } from '../types/ComponentGridTypes';\nimport {\n    CornerRadiusAll,\n    CornerRadiusNone,\n    CornerRadiusOnly,\n    ShapeFrameSource,\n    ShapeType,\n    ShapeContainerProperties,\n} from './ShapeTypes';\n\nexport type FrameLayoutType = {\n    id: Id;\n    layoutId: Id;\n    horizontal: FrameAnchor;\n    vertical: FrameAnchor;\n    x: PropertyState<number>;\n    y: PropertyState<number>;\n    width: PropertyState<number>;\n    height: PropertyState<number>;\n    rotationDegrees: PropertyState<number>;\n    scaleX: PropertyState<number>;\n    scaleY: PropertyState<number>;\n    isVisible: PropertyState<boolean>;\n    fitMode: PropertyState<FitMode>;\n    fitModePosition: PropertyState<FitModePosition>;\n    smartCropSettings: PropertyState<SmartCropSettings>;\n    hasImageCrop: PropertyState<boolean>;\n    hasFrameSubjectArea: PropertyState<boolean>;\n    minCopyfitting: PropertyState<number>;\n    maxCopyfitting: PropertyState<number>;\n    enableCopyfitting: PropertyState<boolean>;\n    autoGrow: AutoGrowSettings;\n    isShowingCustomCroppedAsset: boolean;\n    customCroppedAssetCount: number;\n    subjectId: PropertyState<Id | null>;\n    componentGridSettings: PropertyState<ComponentGridSettings>;\n    componentFit: PropertyState<ComponentFitEnum>;\n} | null;\n\n//Frame.image\nexport type FrameType = {\n    id: Id;\n    name: string;\n    type: FrameTypeEnum;\n    // `imageUrl` is not generic: should be removed from model\n    imageUrl: string;\n    blendMode: string;\n    opacity: number;\n};\n\nexport type Frame = TextFrame | ImageFrame | ShapeFrame | BarcodeFrame | ComponentFrame | ComponentGridFrame;\n\nexport type ImageFrameVariableSource = {\n    type: ImageSourceTypeEnum.variable;\n    id: Id;\n};\n\nexport type ImageFrameUrlSource = {\n    type: ImageSourceTypeEnum.url;\n    url: string;\n};\n\nexport type ImageFrameConnectorSource = {\n    type: ImageSourceTypeEnum.connector;\n    assetId: Id;\n    id: Id;\n};\n\nexport type ImageFrameBrandkitMediaSource = {\n    type: ImageSourceTypeEnum.brandKitMedia;\n    name: string;\n};\n\nexport type ImageFrameSource =\n    | ImageFrameConnectorSource\n    | ImageFrameVariableSource\n    | ImageFrameUrlSource\n    | ImageFrameBrandkitMediaSource;\n\n// used by new getter methods\nexport type ImageFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.image;\n    src?: ImageFrameSource;\n    blendMode: BlendMode;\n    dropShadowSettings?: DropShadowSettings;\n    container: {\n        source: ShapeFrameSource;\n        properties: ShapeContainerProperties;\n    };\n};\n\nexport type ShapeFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.shape;\n    blendMode: BlendMode;\n    shapeProperties: {\n        enableFill: boolean;\n        fillColor: ColorUsage;\n        enableStroke: boolean;\n        strokeWeight: number;\n        strokeColor: ColorUsage;\n        allCornersSame: boolean;\n    };\n    src: {\n        type: ShapeType;\n        cornerRadius: CornerRadiusNone | CornerRadiusAll | CornerRadiusOnly;\n        sides?: number;\n    };\n    dropShadowSettings?: DropShadowSettings;\n    gradient?: GradientUsage;\n};\n\nexport type TextFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.text;\n    textContent: string;\n    paddingLeft: number;\n    paddingTop: number;\n    paddingRight: number;\n    paddingBottom: number;\n    numberOfColumns: number;\n    columnGap: number;\n    textDirection: TextDirection;\n    flowDirection: FlowDirection;\n    verticalAlign: VerticalAlign;\n    textStroke: boolean;\n    textStrokeWeight: number;\n    textStrokeColor: number;\n    hasClippingPath: boolean;\n    blendMode: BlendMode;\n    dropShadowSettings?: DropShadowSettings;\n    hasVariable?: boolean;\n};\n\nexport type BarcodeFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.barcode;\n    blendMode: BlendMode;\n    barcodeProperties: {\n        enableBackground: boolean;\n        backgroundColor: ColorUsage;\n        enableBarColor: boolean;\n        barColor: ColorUsage;\n        enableText: boolean;\n        barHeight: number;\n        magnification: number;\n        quietZone: QuietZone;\n        errorCorrectionLevel?: BarcodeErrorCorrectionLevel;\n        characterSet?: BarcodeCharacterSet;\n        drawStartStopChars: boolean;\n    };\n    src?: BarcodeSource;\n    barcodeType: BarcodeType;\n    dropShadowSettings?: DropShadowSettings;\n};\n\nexport type BarcodeSource = BarcodeVariableSource | BarcodeTextSource;\n\nexport type BarcodeVariableSource = {\n    type: BarcodeSourceTypeEnum.variable;\n    id: Id;\n};\n\nexport type BarcodeTextSource = {\n    type: BarcodeSourceTypeEnum.text;\n    text: string;\n};\n\nexport type ComponentFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.component;\n    blendMode: BlendMode;\n    src: ComponentSource;\n    variableMappings: VariableMapping[];\n\n    /**\n     * How the component fits within the frame.\n     */\n    fitMode: ComponentFitEnum;\n};\n\nexport type ComponentGridFrame = {\n    id: Id;\n    name: string;\n    opacity: number;\n    type: FrameTypeEnum.componentGrid;\n    blendMode: BlendMode;\n    dataSourceVariableId?: Id | null;\n    src?: ComponentSource | null;\n    variableMappings: GridVariableMapping;\n};\n\nexport type GridVariableMapping = {\n    mappings: Record<string, VariableMapping[] | null>;\n}\n\nexport type ComponentSource = ConnectorComponentSource;\n\nexport type ConnectorComponentSource = {\n    type: ComponentSourceTypeEnum.connector;\n    id: Id;\n    assetId: Id | null;\n};\n\nexport type VariableMapping = {\n    source: Id;\n    target: Id;\n    sourceField?: string;\n};\n\nexport enum ComponentFitEnum {\n    /**\n     * The component resizes to fit the frame size.\n     */\n    resize = 'resize',\n\n    /**\n     * The component scales to fit the frame size while maintaining its aspect ratio.\n     */\n    scale = 'scale',\n\n    /**\n     * The component first scales to fit the frame size while maintaining its aspect ratio,\n     * then resizes to fill the remaining space.\n     */\n    scaleAndResize = 'scaleAndResize',\n}\n\nexport type CropSettings = {\n    left: number;\n    top: number;\n    width: number;\n    height: number;\n    rotationDegrees: number;\n    type: 'default';\n};\n\nexport type NoCropSettings = {\n    type: 'noCrop';\n};\n\nexport type AutoGrowSettings = {\n    enabled: PropertyState<boolean>;\n    minWidth: PropertyState<number>;\n    maxWidth: PropertyState<number>;\n    minHeight: PropertyState<number>;\n    maxHeight: PropertyState<number>;\n    directions: PropertyState<Array<AutoGrowDirection>>;\n};\n\nexport interface AutoGrowDeltaUpdate {\n    enabled?: {\n        value: boolean;\n    };\n    minWidth?: {\n        value: string | null;\n    };\n    maxWidth?: {\n        value: string | null;\n    };\n    minHeight?: {\n        value: string | null;\n    };\n    maxHeight?: {\n        value: string | null;\n    };\n    directions?: {\n        value: Array<AutoGrowDirection>;\n    };\n}\n\nexport type DropShadowSettings = {\n    enabled: boolean;\n    distance: number;\n    angleDegrees: number;\n    blurRadius: number;\n    color: ColorUsage;\n};\n\nexport interface ShadowSettingsDeltaUpdate {\n    distance?: {\n        value: string;\n    };\n    angleDegrees?: {\n        value: number;\n    };\n    blurRadius?: {\n        value: number;\n    };\n    enabled?: {\n        value: boolean;\n    };\n    color?: {\n        value: ColorUsage;\n    };\n}\n\nexport enum AutoGrowDirection {\n    top = 'top',\n    bottom = 'bottom',\n    left = 'left',\n    right = 'right',\n}\n\nexport enum ImageSourceTypeEnum {\n    url = 'url',\n    variable = 'variable',\n    connector = 'connector',\n    brandKitMedia = 'brandKitMedia',\n}\n\nexport enum ComponentSourceTypeEnum {\n    connector = 'connector',\n}\n\nexport enum FrameTypeEnum {\n    text = 'text',\n    image = 'image',\n    shape = 'shape',\n    barcode = 'barcode',\n    component = 'component',\n    componentGrid = 'componentGrid',\n}\n\nexport enum BarcodeSourceTypeEnum {\n    variable = 'variable',\n    text = 'text',\n}\n\nexport enum TextDirection {\n    leftToRight = 'leftToRight',\n    rightToLeft = 'rightToLeft',\n    weak = 'weak',\n}\n\nexport enum FlowDirection {\n    horizontal = 'horizontal',\n    vertical = 'vertical',\n    onPath = 'onPath',\n}\n\nexport enum VerticalAlign {\n    top = 'top',\n    bottom = 'bottom',\n    middle = 'middle',\n    justify = 'justify',\n}\n\nexport enum BlendMode {\n    normal = 'normal',\n    screen = 'screen',\n    overlay = 'overlay',\n    darken = 'darken',\n    lighten = 'lighten',\n    colorDodge = 'colorDodge',\n    colorBurn = 'colorBurn',\n    hardLight = 'hardLight',\n    softLight = 'softLight',\n    difference = 'difference',\n    exclusion = 'exclusion',\n    multiply = 'multiply',\n    hue = 'hue',\n    saturation = 'saturation',\n    color = 'color',\n    luminosity = 'luminosity',\n}\n\nexport enum FitMode {\n    fill = 'fill',\n    fit = 'fit',\n    smartCrop = 'smartCrop',\n    manualCrop = 'manualCrop',\n}\n\nexport enum FitModePosition {\n    topLeft = 'topLeft',\n    topCenter = 'topCenter',\n    topRight = 'topRight',\n    centerLeft = 'centerLeft',\n    center = 'center',\n    centerRight = 'centerRight',\n    bottomLeft = 'bottomLeft',\n    bottomCenter = 'bottomCenter',\n    bottomRight = 'bottomRight',\n}\n\nexport enum UpdateZIndexMethod {\n    bringToFront = 'bringToFront',\n    sendToBack = 'sendToBack',\n    bringForward = 'bringForward',\n    sendBackward = 'sendBackward',\n}\n\nexport enum FrameAnchorType {\n    relative = 'relative',\n    start = 'start',\n    end = 'end',\n    startAndEnd = 'startAndEnd',\n    center = 'center',\n}\n\nexport enum AnchorTargetType {\n    page = 'page',\n    frame = 'frame',\n}\n\nexport enum AnchorTargetEdgeType {\n    start = 'start',\n    end = 'end',\n    center = 'center',\n}\n\nexport class PageAnchorTarget {\n    type = AnchorTargetType.page;\n}\n\nexport class FrameAnchorTarget {\n    frameId: Id;\n    edge: AnchorTargetEdgeType;\n    type = AnchorTargetType.frame;\n\n    constructor(id: Id, edge: AnchorTargetEdgeType) {\n        (this.frameId = id), (this.edge = edge);\n    }\n}\n\nexport type AnchorTarget = PageAnchorTarget | FrameAnchorTarget;\n\nexport type RelativeFrameAnchor = {\n    start: PropertyState<number>;\n    end: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.relative;\n} & HasOverrideState;\n\nexport type StartFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.start;\n} & HasOverrideState;\n\nexport type EndFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.end;\n} & HasOverrideState;\n\nexport type StartAndEndFrameAnchor = {\n    start: PropertyState<number>;\n    startTarget: AnchorTarget;\n    end: PropertyState<number>;\n    endTarget: AnchorTarget;\n    type: FrameAnchorType.startAndEnd;\n} & HasOverrideState;\n\nexport type CenterFrameAnchor = {\n    offset: PropertyState<number>;\n    target: AnchorTarget;\n    type: FrameAnchorType.center;\n} & HasOverrideState;\n\nexport type FrameAnchor =\n    | RelativeFrameAnchor\n    | StartFrameAnchor\n    | EndFrameAnchor\n    | StartAndEndFrameAnchor\n    | CenterFrameAnchor;\n\nexport type FrameAnchorProperties = {\n    horizontal: boolean;\n    type: FrameAnchorType;\n    target: AnchorTarget;\n    endTarget?: AnchorTarget | null;\n};\n\nexport type AnchorConfiguration = {\n    allowedTypes: Set<FrameAnchorType>;\n    allowedFrameIds: Set<Id>;\n};\n\nexport type FrameConfiguration = {\n    horizontal: AnchorConfiguration;\n    vertical: AnchorConfiguration;\n};\n\nexport enum CropType {\n    frameCrop = 'frameCrop',\n    assetCrop = 'assetCrop',\n}\n\n/**\n * Image-specific editing constraints.\n */\nexport type ImageFrameConstraints = {\n    cropAllowed: PropertyState<boolean>;\n};\n\n/**\n * Text-specific editing constraints.\n */\nexport type TextFrameConstraints = {\n    editingAllowed: PropertyState<boolean>;\n    paragraphStyles: PropertyState<IdSetManagedConstraint>;\n    characterStyles: PropertyState<IdSetManagedConstraint>;\n    colors: PropertyState<IdSetManagedConstraint>;\n    fontSizes: PropertyState<FontSizeRangeManagedConstraint>;\n};\n\nexport interface ManagedConstraint {\n    allowed: boolean;\n}\n\n/**\n * A managed constraint represented by a set of allowed Id identifiers.\n *\n * Example: used to allow only a specific set of paragraph or character styles.\n * - `allowed`: If true, only the provided `ids` may be used.\n * - `ids`: The set of allowed Id values.\n */\nexport interface IdSetManagedConstraint extends ManagedConstraint {\n    allowed: boolean;\n    ids: Id[];\n}\n\n/**\n * A managed constraint that restricts allowed font sizes to a continuous range.\n *\n * - `allowed`: If true, restricts allowed font sizes to [min, max] (inclusive).\n * - `min`: The minimum allowed font size (nullable).\n * - `max`: The maximum allowed font size (nullable).\n */\nexport interface FontSizeRangeManagedConstraint extends ManagedConstraint {\n    allowed: boolean;\n    min: number | null;\n    max: number | null;\n}\n\n/**\n * Frame editing constraints with optional frame-type-specific sub-properties.\n */\nexport type FrameConstraints = {\n    selectionAllowed: PropertyState<boolean>;\n    horizontalMovementAllowed: PropertyState<boolean>;\n    verticalMovementAllowed: PropertyState<boolean>;\n    rotationAllowed: PropertyState<boolean>;\n    resizeAllowed: PropertyState<boolean>;\n    proportionLocked: PropertyState<boolean>;\n    /** Image-specific constraints. */\n    image?: ImageFrameConstraints;\n    /** Text-specific constraints. */\n    text?: TextFrameConstraints;\n};\n\n/**\n * Image-specific constraints delta update.\n */\nexport interface ImageFrameConstraintsDeltaUpdate {\n    cropAllowed?: {\n        value: boolean;\n    };\n}\n\n/**\n * Text-specific constraints delta update.\n */\nexport interface TextFrameConstraintsDeltaUpdate {\n    editingAllowed?: {\n        value: boolean;\n    };\n    paragraphStyles?: {\n        value: IdSetManagedConstraint;\n    };\n    characterStyles?: {\n        value: IdSetManagedConstraint;\n    };\n    colors?: {\n        value: IdSetManagedConstraint;\n    };\n    fontSizes?: {\n        value: FontSizeRangeManagedConstraint;\n    };\n}\n\n/**\n * Frame constraints delta update with optional frame-type-specific sub-properties.\n */\nexport interface FrameConstraintsDeltaUpdate {\n    selectionAllowed?: {\n        value: boolean;\n    };\n    horizontalMovementAllowed?: {\n        value: boolean;\n    };\n    verticalMovementAllowed?: {\n        value: boolean;\n    };\n    rotationAllowed?: {\n        value: boolean;\n    };\n    resizeAllowed?: {\n        value: boolean;\n    };\n    proportionLocked?: {\n        value: boolean;\n    };\n    /** Image-specific constraints update. */\n    image?: ImageFrameConstraintsDeltaUpdate;\n    /** Text-specific constraints update. */\n    text?: TextFrameConstraintsDeltaUpdate;\n}\n\nexport type SmartCropSettings = SmartCropSettingsV1 | SmartCropSettingsV2;\n\nexport type SmartCropSettingsV1 = {\n    version: SmartCropVersion.v1;\n};\n\nexport type SmartCropSettingsV2 = {\n    version: SmartCropVersion.v2;\n    horizontalBias: SmartCropAxisBias;\n    verticalBias: SmartCropAxisBias;\n};\n\nexport enum SmartCropVersion {\n    v1 = 'v1',\n    v2 = 'v2',\n}\n\n/**\n * Latest version of the smart crop algorithm.\n * Keep in sync with @SmartCropVersion enum.\n */\nexport const LATEST_SMART_CROP_VERSION = SmartCropVersion.v2;\n\nexport enum SmartCropAxisBias {\n    start = 'start',\n    center = 'center',\n    end = 'end',\n}\n"],"names":["ComponentFitEnum","AutoGrowDirection","ImageSourceTypeEnum","ComponentSourceTypeEnum","FrameTypeEnum","BarcodeSourceTypeEnum","TextDirection","FlowDirection","VerticalAlign","BlendMode","FitMode","FitModePosition","UpdateZIndexMethod","FrameAnchorType","AnchorTargetType","AnchorTargetEdgeType","CropType","SmartCropVersion","SmartCropAxisBias"],"mappings":"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"}

package/lib/src/types/MethodInvocationTypes.d.ts

@@ -0,0 +1,27 @@
+export type MethodInvocationBase = {
+    path: string;
+    controller: string;
+    method: string;
+    args: unknown[];
+};
+export type MethodInvokeEvent = MethodInvocationBase & {
+    phase: 'invoke';
+};
+export type MethodCompleteEvent = MethodInvocationBase & {
+    phase: 'complete';
+    success: boolean;
+    result?: unknown;
+    error?: unknown;
+};
+export type MethodInvocationEvent = MethodInvokeEvent | MethodCompleteEvent;
+export type MethodInvocationListener = (event: MethodInvocationEvent) => void;
+export interface Unsubscriber {
+    (): void;
+}
+export type MethodListenable<T extends (...args: any[]) => any> = T & {
+    addEventListener(listener: MethodInvocationListener): Unsubscriber;
+    removeEventListener(listener: MethodInvocationListener): void;
+};
+export type Instrumented<T> = {
+    [K in keyof T]: T[K] extends (...args: any[]) => any ? MethodListenable<T[K]> : T[K] extends object ? Instrumented<T[K]> : T[K];
+};

package/lib/src/utils/EngineEventTrigger.cjs.js

@@ -5,6 +5,9 @@ class EngineEventTrigger {
   constructor(logger) {
     this.logger = logger;
   }
+  getLogCategory() {
+    return CommonTypes.LogCategory.event;
+  }
   createEventHandlerFn(callbackFn, errorBehavior) {
     const wrapper = (...args) => {
       try {
@@ -22,7 +25,7 @@ class EngineEventTrigger {
   handleError(error, errorBehavior, fnName) {
     var _a;
     if (errorBehavior === CommonTypes.CallbackErrorBehavior.log) {
-      (_a = this.logger) == null ? void 0 : _a.call(this, CommonTypes.LogLevel.error, CommonTypes.LogCategory.event, `Error in callback ${fnName}: ${error}`);
+      (_a = this.logger) == null ? void 0 : _a.call(this, CommonTypes.LogLevel.error, this.getLogCategory(), `Error in callback ${fnName}: ${error}`);
     } else {
       throw error;
     }

package/lib/src/utils/EngineEventTrigger.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"EngineEventTrigger.cjs.js","sources":["../../../src/utils/EngineEventTrigger.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { CallbackErrorBehavior, LogCategory, LoggerFunction, LogLevel } from '../types/CommonTypes';\nexport abstract class EngineEventTrigger<T extends (...args: any[]) => any> {\n    constructor(protected logger?: LoggerFunction) {}\n\n    abstract trigger(...args: Parameters<T>): ReturnType<T>;\n\n    protected createEventHandlerFn(callbackFn: T, errorBehavior: CallbackErrorBehavior): T {\n        const wrapper: any = (...args: Parameters<T>) => {\n            try {\n                const result = callbackFn(...args);\n                // If the callback returns a promise, we need to await it\n                if (result instanceof Promise) {\n                    return result.catch((error) => this.handleError(error, errorBehavior, callbackFn.name));\n                }\n                return result;\n            } catch (error) {\n                this.handleError(error, errorBehavior, callbackFn.name);\n            }\n        };\n        return wrapper;\n    }\n\n    private handleError(error: unknown, errorBehavior: CallbackErrorBehavior, fnName: string) {\n        if (errorBehavior === CallbackErrorBehavior.log) {\n            this.logger?.(LogLevel.error, LogCategory.event, `Error in callback ${fnName}: ${error}`);\n        } else {\n            throw error;\n        }\n    }\n}\n"],"names":["CallbackErrorBehavior","LogLevel","LogCategory"],"mappings":";;;AAEO,MAAe,mBAAsD;AAAA,EACxE,YAAsB,QAAyB;AAAzB,SAAA,SAAA;AAAA,EAA0B;AAAA,EAItC,qBAAqB,YAAe,eAAyC;AACnF,UAAM,UAAe,IAAI,SAAwB;AAC7C,UAAI;AACA,cAAM,SAAS,WAAW,GAAG,IAAI;AAEjC,YAAI,kBAAkB,SAAS;AAC3B,iBAAO,OAAO,MAAM,CAAC,UAAU,KAAK,YAAY,OAAO,eAAe,WAAW,IAAI,CAAC;AAAA,QAC1F;AACA,eAAO;AAAA,MACX,SAAS,OAAO;AACZ,aAAK,YAAY,OAAO,eAAe,WAAW,IAAI;AAAA,MAC1D;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA,EAEQ,YAAY,OAAgB,eAAsC,QAAgB;;AACtF,QAAI,kBAAkBA,YAAAA,sBAAsB,KAAK;AAC7C,iBAAK,WAAL,8BAAcC,qBAAS,OAAOC,YAAAA,YAAY,OAAO,qBAAqB,MAAM,KAAK,KAAK;AAAA,IAC1F,OAAO;AACH,YAAM;AAAA,IACV;AAAA,EACJ;AACJ;;"}
+{"version":3,"file":"EngineEventTrigger.cjs.js","sources":["../../../src/utils/EngineEventTrigger.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { CallbackErrorBehavior, LogCategory, LoggerFunction, LogLevel } from '../types/CommonTypes';\nexport abstract class EngineEventTrigger<T extends (...args: any[]) => any> {\n    constructor(protected logger?: LoggerFunction) {}\n\n    abstract trigger(...args: Parameters<T>): ReturnType<T>;\n\n    protected getLogCategory(): LogCategory {\n        return LogCategory.event;\n    }\n\n    protected createEventHandlerFn(callbackFn: T, errorBehavior: CallbackErrorBehavior): T {\n        const wrapper: any = (...args: Parameters<T>) => {\n            try {\n                const result = callbackFn(...args);\n                // If the callback returns a promise, we need to await it\n                if (result instanceof Promise) {\n                    return result.catch((error) => this.handleError(error, errorBehavior, callbackFn.name));\n                }\n                return result;\n            } catch (error) {\n                this.handleError(error, errorBehavior, callbackFn.name);\n            }\n        };\n        return wrapper;\n    }\n\n    private handleError(error: unknown, errorBehavior: CallbackErrorBehavior, fnName: string) {\n        if (errorBehavior === CallbackErrorBehavior.log) {\n            this.logger?.(LogLevel.error, this.getLogCategory(), `Error in callback ${fnName}: ${error}`);\n        } else {\n            throw error;\n        }\n    }\n}\n"],"names":["LogCategory","CallbackErrorBehavior","LogLevel"],"mappings":";;;AAEO,MAAe,mBAAsD;AAAA,EACxE,YAAsB,QAAyB;AAAzB,SAAA,SAAA;AAAA,EAA0B;AAAA,EAItC,iBAA8B;AACpC,WAAOA,YAAAA,YAAY;AAAA,EACvB;AAAA,EAEU,qBAAqB,YAAe,eAAyC;AACnF,UAAM,UAAe,IAAI,SAAwB;AAC7C,UAAI;AACA,cAAM,SAAS,WAAW,GAAG,IAAI;AAEjC,YAAI,kBAAkB,SAAS;AAC3B,iBAAO,OAAO,MAAM,CAAC,UAAU,KAAK,YAAY,OAAO,eAAe,WAAW,IAAI,CAAC;AAAA,QAC1F;AACA,eAAO;AAAA,MACX,SAAS,OAAO;AACZ,aAAK,YAAY,OAAO,eAAe,WAAW,IAAI;AAAA,MAC1D;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA,EAEQ,YAAY,OAAgB,eAAsC,QAAgB;;AACtF,QAAI,kBAAkBC,YAAAA,sBAAsB,KAAK;AAC7C,iBAAK,WAAL,8BAAcC,qBAAS,OAAO,KAAK,kBAAkB,qBAAqB,MAAM,KAAK,KAAK;AAAA,IAC9F,OAAO;AACH,YAAM;AAAA,IACV;AAAA,EACJ;AACJ;;"}

package/lib/src/utils/EngineEventTrigger.d.ts

@@ -1,8 +1,9 @@
-import { CallbackErrorBehavior, LoggerFunction } from '../types/CommonTypes';
+import { CallbackErrorBehavior, LogCategory, LoggerFunction } from '../types/CommonTypes';
 export declare abstract class EngineEventTrigger<T extends (...args: any[]) => any> {
     protected logger?: LoggerFunction | undefined;
     constructor(logger?: LoggerFunction | undefined);
     abstract trigger(...args: Parameters<T>): ReturnType<T>;
+    protected getLogCategory(): LogCategory;
     protected createEventHandlerFn(callbackFn: T, errorBehavior: CallbackErrorBehavior): T;
     private handleError;
 }

package/lib/src/utils/EngineEventTrigger.es.js

@@ -1,8 +1,11 @@
-import { CallbackErrorBehavior, LogLevel, LogCategory } from "../types/CommonTypes.es.js";
+import { LogCategory, CallbackErrorBehavior, LogLevel } from "../types/CommonTypes.es.js";
 class EngineEventTrigger {
   constructor(logger) {
     this.logger = logger;
   }
+  getLogCategory() {
+    return LogCategory.event;
+  }
   createEventHandlerFn(callbackFn, errorBehavior) {
     const wrapper = (...args) => {
       try {
@@ -20,7 +23,7 @@ class EngineEventTrigger {
   handleError(error, errorBehavior, fnName) {
     var _a;
     if (errorBehavior === CallbackErrorBehavior.log) {
-      (_a = this.logger) == null ? void 0 : _a.call(this, LogLevel.error, LogCategory.event, `Error in callback ${fnName}: ${error}`);
+      (_a = this.logger) == null ? void 0 : _a.call(this, LogLevel.error, this.getLogCategory(), `Error in callback ${fnName}: ${error}`);
     } else {
       throw error;
     }

package/lib/src/utils/EngineEventTrigger.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"EngineEventTrigger.es.js","sources":["../../../src/utils/EngineEventTrigger.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { CallbackErrorBehavior, LogCategory, LoggerFunction, LogLevel } from '../types/CommonTypes';\nexport abstract class EngineEventTrigger<T extends (...args: any[]) => any> {\n    constructor(protected logger?: LoggerFunction) {}\n\n    abstract trigger(...args: Parameters<T>): ReturnType<T>;\n\n    protected createEventHandlerFn(callbackFn: T, errorBehavior: CallbackErrorBehavior): T {\n        const wrapper: any = (...args: Parameters<T>) => {\n            try {\n                const result = callbackFn(...args);\n                // If the callback returns a promise, we need to await it\n                if (result instanceof Promise) {\n                    return result.catch((error) => this.handleError(error, errorBehavior, callbackFn.name));\n                }\n                return result;\n            } catch (error) {\n                this.handleError(error, errorBehavior, callbackFn.name);\n            }\n        };\n        return wrapper;\n    }\n\n    private handleError(error: unknown, errorBehavior: CallbackErrorBehavior, fnName: string) {\n        if (errorBehavior === CallbackErrorBehavior.log) {\n            this.logger?.(LogLevel.error, LogCategory.event, `Error in callback ${fnName}: ${error}`);\n        } else {\n            throw error;\n        }\n    }\n}\n"],"names":[],"mappings":";AAEO,MAAe,mBAAsD;AAAA,EACxE,YAAsB,QAAyB;AAAzB,SAAA,SAAA;AAAA,EAA0B;AAAA,EAItC,qBAAqB,YAAe,eAAyC;AACnF,UAAM,UAAe,IAAI,SAAwB;AAC7C,UAAI;AACA,cAAM,SAAS,WAAW,GAAG,IAAI;AAEjC,YAAI,kBAAkB,SAAS;AAC3B,iBAAO,OAAO,MAAM,CAAC,UAAU,KAAK,YAAY,OAAO,eAAe,WAAW,IAAI,CAAC;AAAA,QAC1F;AACA,eAAO;AAAA,MACX,SAAS,OAAO;AACZ,aAAK,YAAY,OAAO,eAAe,WAAW,IAAI;AAAA,MAC1D;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA,EAEQ,YAAY,OAAgB,eAAsC,QAAgB;;AACtF,QAAI,kBAAkB,sBAAsB,KAAK;AAC7C,iBAAK,WAAL,8BAAc,SAAS,OAAO,YAAY,OAAO,qBAAqB,MAAM,KAAK,KAAK;AAAA,IAC1F,OAAO;AACH,YAAM;AAAA,IACV;AAAA,EACJ;AACJ;"}
+{"version":3,"file":"EngineEventTrigger.es.js","sources":["../../../src/utils/EngineEventTrigger.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { CallbackErrorBehavior, LogCategory, LoggerFunction, LogLevel } from '../types/CommonTypes';\nexport abstract class EngineEventTrigger<T extends (...args: any[]) => any> {\n    constructor(protected logger?: LoggerFunction) {}\n\n    abstract trigger(...args: Parameters<T>): ReturnType<T>;\n\n    protected getLogCategory(): LogCategory {\n        return LogCategory.event;\n    }\n\n    protected createEventHandlerFn(callbackFn: T, errorBehavior: CallbackErrorBehavior): T {\n        const wrapper: any = (...args: Parameters<T>) => {\n            try {\n                const result = callbackFn(...args);\n                // If the callback returns a promise, we need to await it\n                if (result instanceof Promise) {\n                    return result.catch((error) => this.handleError(error, errorBehavior, callbackFn.name));\n                }\n                return result;\n            } catch (error) {\n                this.handleError(error, errorBehavior, callbackFn.name);\n            }\n        };\n        return wrapper;\n    }\n\n    private handleError(error: unknown, errorBehavior: CallbackErrorBehavior, fnName: string) {\n        if (errorBehavior === CallbackErrorBehavior.log) {\n            this.logger?.(LogLevel.error, this.getLogCategory(), `Error in callback ${fnName}: ${error}`);\n        } else {\n            throw error;\n        }\n    }\n}\n"],"names":[],"mappings":";AAEO,MAAe,mBAAsD;AAAA,EACxE,YAAsB,QAAyB;AAAzB,SAAA,SAAA;AAAA,EAA0B;AAAA,EAItC,iBAA8B;AACpC,WAAO,YAAY;AAAA,EACvB;AAAA,EAEU,qBAAqB,YAAe,eAAyC;AACnF,UAAM,UAAe,IAAI,SAAwB;AAC7C,UAAI;AACA,cAAM,SAAS,WAAW,GAAG,IAAI;AAEjC,YAAI,kBAAkB,SAAS;AAC3B,iBAAO,OAAO,MAAM,CAAC,UAAU,KAAK,YAAY,OAAO,eAAe,WAAW,IAAI,CAAC;AAAA,QAC1F;AACA,eAAO;AAAA,MACX,SAAS,OAAO;AACZ,aAAK,YAAY,OAAO,eAAe,WAAW,IAAI;AAAA,MAC1D;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA,EAEQ,YAAY,OAAgB,eAAsC,QAAgB;;AACtF,QAAI,kBAAkB,sBAAsB,KAAK;AAC7C,iBAAK,WAAL,8BAAc,SAAS,OAAO,KAAK,kBAAkB,qBAAqB,MAAM,KAAK,KAAK;AAAA,IAC9F,OAAO;AACH,YAAM;AAAA,IACV;AAAA,EACJ;AACJ;"}

package/lib/src/utils/MethodInstrumentation.cjs.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const CommonTypes = require("../types/CommonTypes.cjs.js");
+const NOOP_UNSUBSCRIBER = () => void 0;
+class MethodListenerRegistry {
+  constructor() {
+    this.listeners = /* @__PURE__ */ new Map();
+  }
+  add(path, listener) {
+    if (typeof listener !== "function") {
+      return NOOP_UNSUBSCRIBER;
+    }
+    const subscriptions = this.listeners.get(path) ?? /* @__PURE__ */ new Set();
+    subscriptions.add(listener);
+    this.listeners.set(path, subscriptions);
+    return () => {
+      this.remove(path, listener);
+    };
+  }
+  remove(path, listener) {
+    const subscriptions = this.listeners.get(path);
+    if (!subscriptions) {
+      return;
+    }
+    subscriptions.delete(listener);
+    if (subscriptions.size === 0) {
+      this.listeners.delete(path);
+    }
+  }
+  getListeners(path) {
+    return [...this.listeners.get(path) ?? []];
+  }
+}
+const isThenable = (value) => {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  return typeof value.then === "function";
+};
+const isInstrumentableObject = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return false;
+  }
+  return true;
+};
+const reportListenerError = (path, error, logger) => {
+  logger == null ? void 0 : logger(CommonTypes.LogLevel.error, CommonTypes.LogCategory.sdk, `Error in method listener for ${path}: ${String(error)}`);
+};
+const notifyListeners = (path, event, listenerRegistry, sdkEvents, logger) => {
+  for (const callback of listenerRegistry.getListeners(path)) {
+    try {
+      callback(event);
+    } catch (error) {
+      reportListenerError(path, error, logger);
+    }
+  }
+  try {
+    if (event.phase === "invoke") {
+      sdkEvents.onMethodInvoked.trigger(event);
+    } else {
+      sdkEvents.onMethodCompleted.trigger(event);
+    }
+  } catch (error) {
+    reportListenerError(path, error, logger);
+  }
+};
+function wrapWithInvocationObserver(target, basePath, listenerRegistry, sdkEvents, logger) {
+  const methodWrappers = /* @__PURE__ */ new Map();
+  const nestedControllers = /* @__PURE__ */ new Map();
+  return new Proxy(target, {
+    get(targetController, propKey, receiver) {
+      const value = Reflect.get(targetController, propKey, receiver);
+      if (typeof propKey === "symbol") {
+        return value;
+      }
+      if (typeof value === "function") {
+        if (methodWrappers.has(propKey)) {
+          return methodWrappers.get(propKey);
+        }
+        const methodPath = `${basePath}.${String(propKey)}`;
+        const controllerName = basePath.split(".")[0] || basePath;
+        const methodName = String(propKey);
+        const wrappedMethod = ((...args) => {
+          const invokeEvent = {
+            phase: "invoke",
+            path: methodPath,
+            controller: controllerName,
+            method: methodName,
+            args: [...args]
+          };
+          notifyListeners(methodPath, invokeEvent, listenerRegistry, sdkEvents, logger);
+          try {
+            const result = value.apply(targetController, args);
+            if (isThenable(result)) {
+              return result.then((resolvedValue) => {
+                const completeEvent2 = {
+                  phase: "complete",
+                  path: methodPath,
+                  controller: controllerName,
+                  method: methodName,
+                  args: [...args],
+                  success: true,
+                  result: resolvedValue
+                };
+                notifyListeners(methodPath, completeEvent2, listenerRegistry, sdkEvents, logger);
+                return resolvedValue;
+              }).catch((error) => {
+                const completeEvent2 = {
+                  phase: "complete",
+                  path: methodPath,
+                  controller: controllerName,
+                  method: methodName,
+                  args: [...args],
+                  success: false,
+                  error
+                };
+                notifyListeners(methodPath, completeEvent2, listenerRegistry, sdkEvents, logger);
+                throw error;
+              });
+            }
+            const completeEvent = {
+              phase: "complete",
+              path: methodPath,
+              controller: controllerName,
+              method: methodName,
+              args: [...args],
+              success: true,
+              result
+            };
+            notifyListeners(methodPath, completeEvent, listenerRegistry, sdkEvents, logger);
+            return result;
+          } catch (error) {
+            const completeEvent = {
+              phase: "complete",
+              path: methodPath,
+              controller: controllerName,
+              method: methodName,
+              args: [...args],
+              success: false,
+              error
+            };
+            notifyListeners(methodPath, completeEvent, listenerRegistry, sdkEvents, logger);
+            throw error;
+          }
+        });
+        wrappedMethod.addEventListener = (listener) => {
+          return listenerRegistry.add(methodPath, listener);
+        };
+        wrappedMethod.removeEventListener = (listener) => {
+          listenerRegistry.remove(methodPath, listener);
+        };
+        methodWrappers.set(propKey, wrappedMethod);
+        return wrappedMethod;
+      }
+      if (isInstrumentableObject(value)) {
+        if (nestedControllers.has(propKey)) {
+          return nestedControllers.get(propKey);
+        }
+        const nestedPath = `${basePath}.${String(propKey)}`;
+        const wrappedNestedController = wrapWithInvocationObserver(
+          value,
+          nestedPath,
+          listenerRegistry,
+          sdkEvents,
+          logger
+        );
+        nestedControllers.set(propKey, wrappedNestedController);
+        return wrappedNestedController;
+      }
+      return value;
+    }
+  });
+}
+exports.MethodListenerRegistry = MethodListenerRegistry;
+exports.wrapWithInvocationObserver = wrapWithInvocationObserver;
+//# sourceMappingURL=MethodInstrumentation.cjs.js.map

package/lib/src/utils/MethodInstrumentation.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MethodInstrumentation.cjs.js","sources":["../../../src/utils/MethodInstrumentation.ts"],"sourcesContent":["import { LogCategory, LoggerFunction, LogLevel } from '../types/CommonTypes';\nimport {\n    Instrumented,\n    MethodCompleteEvent,\n    MethodInvocationEvent,\n    MethodInvocationListener,\n    MethodInvokeEvent,\n    MethodListenable,\n    Unsubscriber,\n} from '../types/MethodInvocationTypes';\nimport { SdkEvents } from './SdkEvents';\n\nconst NOOP_UNSUBSCRIBER: Unsubscriber = () => undefined;\n\nexport class MethodListenerRegistry {\n    private listeners = new Map<string, Set<MethodInvocationListener>>();\n\n    add(path: string, listener: MethodInvocationListener): Unsubscriber {\n        if (typeof listener !== 'function') {\n            return NOOP_UNSUBSCRIBER;\n        }\n\n        const subscriptions = this.listeners.get(path) ?? new Set<MethodInvocationListener>();\n        subscriptions.add(listener);\n        this.listeners.set(path, subscriptions);\n\n        return () => {\n            this.remove(path, listener);\n        };\n    }\n\n    remove(path: string, listener: MethodInvocationListener): void {\n        const subscriptions = this.listeners.get(path);\n        if (!subscriptions) {\n            return;\n        }\n\n        subscriptions.delete(listener);\n\n        if (subscriptions.size === 0) {\n            this.listeners.delete(path);\n        }\n    }\n\n    getListeners(path: string): MethodInvocationListener[] {\n        return [...(this.listeners.get(path) ?? [])];\n    }\n}\n\nconst isThenable = (value: unknown): value is Promise<unknown> => {\n    if (!value || typeof value !== 'object') {\n        return false;\n    }\n\n    return typeof (value as Promise<unknown>).then === 'function';\n};\n\nconst isInstrumentableObject = (value: unknown): value is Record<string, unknown> => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) {\n        return false;\n    }\n\n    return true;\n};\n\nconst reportListenerError = (path: string, error: unknown, logger?: LoggerFunction) => {\n    logger?.(LogLevel.error, LogCategory.sdk, `Error in method listener for ${path}: ${String(error)}`);\n};\n\nconst notifyListeners = (\n    path: string,\n    event: MethodInvocationEvent,\n    listenerRegistry: MethodListenerRegistry,\n    sdkEvents: SdkEvents,\n    logger?: LoggerFunction,\n) => {\n    for (const callback of listenerRegistry.getListeners(path)) {\n        try {\n            callback(event);\n        } catch (error) {\n            reportListenerError(path, error, logger);\n        }\n    }\n\n    try {\n        if (event.phase === 'invoke') {\n            sdkEvents.onMethodInvoked.trigger(event);\n        } else {\n            sdkEvents.onMethodCompleted.trigger(event);\n        }\n    } catch (error) {\n        reportListenerError(path, error, logger);\n    }\n};\n\nexport function wrapWithInvocationObserver<T extends object>(\n    target: T,\n    basePath: string,\n    listenerRegistry: MethodListenerRegistry,\n    sdkEvents: SdkEvents,\n    logger?: LoggerFunction,\n): Instrumented<T> {\n    const methodWrappers = new Map<PropertyKey, unknown>();\n    const nestedControllers = new Map<PropertyKey, unknown>();\n\n    return new Proxy(target, {\n        get(targetController, propKey, receiver) {\n            const value = Reflect.get(targetController, propKey, receiver);\n            if (typeof propKey === 'symbol') {\n                return value;\n            }\n\n            if (typeof value === 'function') {\n                if (methodWrappers.has(propKey)) {\n                    return methodWrappers.get(propKey);\n                }\n\n                const methodPath = `${basePath}.${String(propKey)}`;\n                const controllerName = basePath.split('.')[0] || basePath;\n                const methodName = String(propKey);\n\n                const wrappedMethod = ((...args: unknown[]) => {\n                    const invokeEvent: MethodInvokeEvent = {\n                        phase: 'invoke',\n                        path: methodPath,\n                        controller: controllerName,\n                        method: methodName,\n                        args: [...args],\n                    };\n                    notifyListeners(methodPath, invokeEvent, listenerRegistry, sdkEvents, logger);\n\n                    try {\n                        const result = value.apply(targetController, args);\n\n                        if (isThenable(result)) {\n                            return result\n                                .then((resolvedValue) => {\n                                    const completeEvent: MethodCompleteEvent = {\n                                        phase: 'complete',\n                                        path: methodPath,\n                                        controller: controllerName,\n                                        method: methodName,\n                                        args: [...args],\n                                        success: true,\n                                        result: resolvedValue,\n                                    };\n                                    notifyListeners(methodPath, completeEvent, listenerRegistry, sdkEvents, logger);\n                                    return resolvedValue;\n                                })\n                                .catch((error) => {\n                                    const completeEvent: MethodCompleteEvent = {\n                                        phase: 'complete',\n                                        path: methodPath,\n                                        controller: controllerName,\n                                        method: methodName,\n                                        args: [...args],\n                                        success: false,\n                                        error,\n                                    };\n                                    notifyListeners(methodPath, completeEvent, listenerRegistry, sdkEvents, logger);\n                                    throw error;\n                                });\n                        }\n\n                        const completeEvent: MethodCompleteEvent = {\n                            phase: 'complete',\n                            path: methodPath,\n                            controller: controllerName,\n                            method: methodName,\n                            args: [...args],\n                            success: true,\n                            result,\n                        };\n                        notifyListeners(methodPath, completeEvent, listenerRegistry, sdkEvents, logger);\n\n                        return result;\n                    } catch (error) {\n                        const completeEvent: MethodCompleteEvent = {\n                            phase: 'complete',\n                            path: methodPath,\n                            controller: controllerName,\n                            method: methodName,\n                            args: [...args],\n                            success: false,\n                            error,\n                        };\n                        notifyListeners(methodPath, completeEvent, listenerRegistry, sdkEvents, logger);\n                        throw error;\n                    }\n                }) as MethodListenable<(...args: unknown[]) => unknown>;\n\n                wrappedMethod.addEventListener = (listener: MethodInvocationListener) => {\n                    return listenerRegistry.add(methodPath, listener);\n                };\n                wrappedMethod.removeEventListener = (listener: MethodInvocationListener) => {\n                    listenerRegistry.remove(methodPath, listener);\n                };\n\n                methodWrappers.set(propKey, wrappedMethod);\n                return wrappedMethod;\n            }\n\n            if (isInstrumentableObject(value)) {\n                if (nestedControllers.has(propKey)) {\n                    return nestedControllers.get(propKey);\n                }\n\n                const nestedPath = `${basePath}.${String(propKey)}`;\n                const wrappedNestedController = wrapWithInvocationObserver(\n                    value,\n                    nestedPath,\n                    listenerRegistry,\n                    sdkEvents,\n                    logger,\n                );\n                nestedControllers.set(propKey, wrappedNestedController);\n\n                return wrappedNestedController;\n            }\n\n            return value;\n        },\n    }) as Instrumented<T>;\n}\n"],"names":["LogLevel","LogCategory","completeEvent"],"mappings":"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"}

package/lib/src/utils/MethodInstrumentation.d.ts

@@ -0,0 +1,10 @@
+import { LoggerFunction } from '../types/CommonTypes';
+import { Instrumented, MethodInvocationListener, Unsubscriber } from '../types/MethodInvocationTypes';
+import { SdkEvents } from './SdkEvents';
+export declare class MethodListenerRegistry {
+    private listeners;
+    add(path: string, listener: MethodInvocationListener): Unsubscriber;
+    remove(path: string, listener: MethodInvocationListener): void;
+    getListeners(path: string): MethodInvocationListener[];
+}
+export declare function wrapWithInvocationObserver<T extends object>(target: T, basePath: string, listenerRegistry: MethodListenerRegistry, sdkEvents: SdkEvents, logger?: LoggerFunction): Instrumented<T>;