@supernova-studio/supernova-sdk-beta 1.6.14 → 1.6.16

package/build/sdk-typescript/src/core/areas/SDKAreaBulkOperations.d.ts

@@ -11,7 +11,7 @@ export type TokenUpdateTransactionData = {
     tokenMode: "create" | "update";
     propertyValuesToCreateOrUpdate?: Array<{
         property: ElementProperty;
-        value: string | boolean;
+        value: string | boolean | number;
     }>;
     propertyValuesToDelete?: Array<string>;
     themesToUpdate?: Array<TokenTheme>;

package/build/sdk-typescript/src/core/areas/SDKAreaComponents.d.ts

@@ -1,7 +1,9 @@
 import { Component } from "../../model/components/SDKComponent";
 import { DesignComponent } from "../../model/components/SDKDesignComponent";
 import { ElementDataView } from "../../model/elements/SDKElementDataView";
-import { ElementProperty } from "../../model/elements/SDKElementProperty";
+import { ElementDataViewColumn } from "../../model/elements/SDKElementDataViewColumn";
+import { ElementProperty, ElementPropertyCreationModel, ElementPropertyUpdateModel } from "../../model/elements/SDKElementProperty";
+import { ElementPropertyValue } from "../../model/elements/values/SDKElementPropertyValue";
 import { ComponentGroup } from "../../model/groups/SDKComponentGroup";
 import { DesignComponentGroup } from "../../model/groups/SDKDesignComponentGroup";
 import { DataCore } from "../data/SDKDataCore";
@@ -30,14 +32,124 @@ export declare class AreaComponents {
      * @returns All design component groups in the specified version
      */
     getDesignComponentGroups(from: RemoteVersionIdentifier): Promise<Array<DesignComponentGroup>>;
-    /** Retrieves all remote properties for tokens
+    /** Retrieves all remote properties for components
      * @param from - Remote version to fetch from
      * @returns All component properties in the specified version
      */
     getComponentProperties(from: RemoteVersionIdentifier): Promise<Array<ElementProperty>>;
+    /** Retrieves all remote property definitions for components
+     * @param from - Remote version to fetch from
+     * @returns All property definitions in the specified version
+     */
+    getComponentPropertyValues(from: RemoteVersionIdentifier): Promise<Array<ElementPropertyValue>>;
     /** Retrieves all remote property views for components
      * @param from - Remote version to fetch from
      * @returns All component views in the specified version
      */
     getComponentDataViews(from: RemoteVersionIdentifier): Promise<Array<ElementDataView>>;
+    /** Creates remote component. This method can only be used once per component and will assign persistent id to the component. Calling this version on component that already has id assigned will result in error
+     * @param to - Remote version to write to
+     * @param component - Component to create
+     * @param parentId - Id of the group to add the component to. This is id of the group, not the versioned id
+     * @returns New remote component ids
+     */
+    createComponent(to: RemoteVersionIdentifier, component: Component, parentId: string): Promise<{
+        id: string;
+        idInVersion: string;
+    }>;
+    /** Creates local component. This component doesn't have id associated with it on remote, and must be created once with `createComponent` to be stored in design system
+     * @returns New component filled with default values not associated with remote (yet)
+     */
+    createLocalComponent(versionId: string, brandId: string): Component;
+    /** Creates remote component group. This method can only be used once per group and will assign persistent id to the group. Calling this version on group that already has id assigned will result in error
+     * @param to - Remote version to write to
+     * @param group - Group to create
+     * @param parentId - Id of the group to add the group to. This is id of the group, not the versioned id
+     * @returns New remote component group ids
+     */
+    createComponentGroup(to: RemoteVersionIdentifier, group: ComponentGroup, parentId: string): Promise<{
+        id: string;
+        idInVersion: string;
+    }>;
+    /** Creates local component group. This group doesn't have id associated with it on remote, and must be created once with `createComponentGroup` to be stored in design system
+     * @param versionId - Id of the version to create the group in
+     * @param brandId - Id of the brand to create the group in
+     * @returns New group with id assigned
+     */
+    createLocalComponentGroup(versionId: string, brandId: string): ComponentGroup;
+    /** Updates remote component. This method can only be used on components that already exist in the version
+     * @param to - Remote version to write to
+     * @param component - Component to update
+     * @returns Nothing
+     */
+    updateComponent(to: RemoteVersionIdentifier, component: Component): Promise<void>;
+    /** Updates remote component groups. This method can only be used on component groups that already exist in the version
+     * @param to - Remote version to write to
+     * @param component - Component group to update
+     * @returns Nothing
+     */
+    updateComponentGroup(to: RemoteVersionIdentifier, group: ComponentGroup): Promise<void>;
+    /** Updates remote component property value. This also creates the property value if it doesn't exist
+     * @param to - Remote version to write to
+     * @param newValue - Value to set - this can be multiple things, from ID to raw string value to others
+     * @param forComponent - Component to assign the value to
+     * @param forProperty - Property to assign the value to
+     */
+    updateComponentPropertyValue(to: RemoteVersionIdentifier, newValue: string, forComponent: Component, forProperty: ElementProperty): Promise<void>;
+    /** Deletes remote component property value
+     * @param to - Remote version to write to
+     * @param valueId - Value identifier
+     */
+    deleteComponentPropertyValue(to: RemoteVersionIdentifier, valueId: string): Promise<void>;
+    /** Create component property
+     * @param to - Remote version to write to
+     * @param model - Property creation model to create the property from
+     */
+    createComponentProperty(to: RemoteVersionIdentifier, model: ElementPropertyCreationModel): Promise<{
+        id: string;
+        idInVersion: string;
+    }>;
+    /** Update component property
+     * @param to - Remote version to write to
+     * @param propertyIdInVersion - Remote element property to update
+     * @param model - Property update model to apply to property
+     */
+    updateComponentProperty(to: RemoteVersionIdentifier, propertyIdInVersion: string, model: ElementPropertyUpdateModel): Promise<void>;
+    /** Delete component property. This will remove all values associated with the property
+     * @param to - Remote version to write to
+     * @param propertyIdInVersion - Id of the property to delete
+     */
+    deleteComponentProperty(to: RemoteVersionIdentifier, propertyIdInVersion: string): Promise<void>;
+    /** Resize specific component column
+     * @param to - Remote version to write to
+     * @param columnIdInVersion - Id of the column to update
+     * @param newWidth - New width of the column
+     */
+    updateResizeComponentColumn(to: RemoteVersionIdentifier, view: ElementDataView, column: ElementDataViewColumn, newWidth: number): Promise<void>;
+    /** Move column to a new index and reorder all other columns around it
+     * @param to - Remote version to write to
+     * @param colum - Column object to move
+     * @param newIndex - New index to move the component to
+     */
+    updateReorderComponentColumn(to: RemoteVersionIdentifier, view: ElementDataView, column: ElementDataViewColumn, newIndex: number): Promise<void>;
+    /** Deletes remote component. Calling this method on component that doesn't exist in the version will result in error
+     * @param to - Remote version to write to
+     * @param componentIdInVersion - Component idInVersion to delete
+     * @returns Nothing
+     */
+    deleteComponent(to: RemoteVersionIdentifier, componentIdInVersion: string): Promise<void>;
+    /** Deletes remote component group. This method will also fix the component group tree by moving any subgroups to parent - do note it will NOT delete contents of the group. Calling this method on group that doesn't exist in the version will result in error
+     * @param to - Remote version to write to
+     * @param componentGroupIdInVersion - Component group idInVersion to delete
+     * @returns Nothing
+     */
+    ungroupComponentGroup(to: RemoteVersionIdentifier, componentGroupIdInVersion: string): Promise<void>;
+    /** Deletes remote component group and all its descendants. All items (groups and components) underneath will be deleted. Calling this method on group that doesn't exist in the version will result in error
+     * @param to - Remote version to write to
+     * @param componentGroupToDelete - Component group to delete
+     * @param allComponents - Components for lookup
+     * @param allComponentGroup - Component group for lookup
+     * @returns Nothing
+     */
+    deleteComponentGroup(to: RemoteVersionIdentifier, componentGroupToDelete: ComponentGroup, components: Array<Component>, componentGroups: Array<ComponentGroup>): Promise<void>;
 }

package/build/sdk-typescript/src/core/areas/SDKAreaTokenValues.d.ts

@@ -32,6 +32,8 @@ export declare class AreaTokenValues {
     typographyTokenByUpdatingParagraphIndent(token: TypographyToken, newValue: RawValue<ParagraphSpacingTokenValue> | ParagraphSpacingToken): TypographyToken;
     /** Creates a new border token with updated .position value */
     typographyTokenByUpdatingTextDecoration(token: TypographyToken, newValue: RawValue<TextDecorationTokenValue> | TextDecorationToken): TypographyToken;
+    /** Creates a new typography token with updated .textCase value */
+    typographyTokenByUpdatingTextCase(token: TypographyToken, newValue: RawValue<TextCaseTokenValue> | TextCaseToken): TypographyToken;
     /** Creates a new border token with updated .color value. Do note, opacity is ignored */
     borderTokenByUpdatingColor(token: BorderToken, newValue: ColorValue | ColorToken): BorderToken;
     /** Creates a new border token with updated color.opacity value */
@@ -117,12 +119,10 @@ export declare class AreaTokenValues {
         position: number;
         color: ColorTokenValue | ColorToken;
     }>): GradientToken;
-    /** Builds the gradient stop data from the elementary values */
-    private gradientStopsFromRawData;
     /** Creates a new token where value is reference to the provided token. Token and reference must be of the same type */
     tokenByReferencing<T extends AnyToken>(token: T, reference: T): T;
     /** Creates a new multilayer token where one of the layers is reference to the provided token. Token and reference must be of the same type */
-    multilayerTokenByReferencing<T extends AnyMultiLayerToken>(token: T, layerIndex: number, reference: T): T;
+    multilayerTokenByReferencing<T extends AnyMultiLayerToken, R extends T>(token: T, layerIndex: number, reference: R): T;
     /** Creates a new token where value is raw, but taken from the previously referenced token. Token must have had reference before */
     tokenByDisconnectingReference<T extends AnySingleLayerToken>(token: T): T;
     /** Creates a new multilayer token where one of the layers value is raw, but taken from the previously referenced token. That layer must have had reference before */
@@ -133,8 +133,4 @@ export declare class AreaTokenValues {
     isReferencedMultilayerTokenLayer(token: AnyMultiLayerToken, layerIndex: number): boolean;
     /** Checks if a token was imported from some foreign source. Not imported tokens were always created in Supernova */
     isTokenImported(token: AnyToken): boolean;
-    private checkNotReference;
-    private rawOrReferencedDimensionValue;
-    private rawOrReferencedStringValue;
-    private validateLayerAccess;
 }

package/build/sdk-typescript/src/core/data/SDKDataCore.d.ts

@@ -72,7 +72,7 @@ export declare class DataCore {
     elementPropertyValues(designSystemId: string, versionId: string): Promise<Array<ElementPropertyValue>>;
     /** Download all necessary data for element views and retrieve them resolved */
     elementViews(designSystemId: string, versionId: string, type: ElementPropertyTargetElementType): Promise<Array<ElementDataView>>;
-    /** Download all necesssary data for tokens and retrieve them resolved */
+    /** Download all necessary data for tokens and retrieve them resolved */
     tokens(designSystemId: string, versionId: string, filter?: {
         type?: TokenType;
         brandId?: string;
@@ -122,7 +122,7 @@ export declare class DataCore {
     deleteTokenGroup(designSystemId: string, versionId: string, tokenGroupToDelete: TokenGroup, tokens: Array<Token>, tokenGroups: Array<TokenGroup>): Promise<void>;
     private itemsToDeleteFromGroup;
     /** Update token property at remote */
-    updateTokenPropertyValue(designSystemId: string, versionId: string, newValue: string | boolean, token: Token, property: ElementProperty): Promise<void>;
+    updateTokenPropertyValue(designSystemId: string, versionId: string, newValue: string | boolean | number, token: Token, property: ElementProperty): Promise<void>;
     /** Delete token property in remote */
     deleteTokenPropertyValue(designSystemId: string, versionId: string, valueId: string): Promise<void>;
     /** Create a custom property in remote */
@@ -146,6 +146,45 @@ export declare class DataCore {
     componentGroups(designSystemId: string, versionId: string): Promise<Array<ComponentGroup>>;
     designComponents(designSystemId: string, versionId: string): Promise<Array<DesignComponent>>;
     designComponentGroups(designSystemId: string, versionId: string): Promise<Array<DesignComponentGroup>>;
+    /** Write new component to remote */
+    createComponent(designSystemId: string, versionId: string, component: Component, parentId: string): Promise<{
+        id: string;
+        idInVersion: string;
+    }>;
+    /** Update existing component in remote */
+    updateComponent(designSystemId: string, versionId: string, component: Component): Promise<void>;
+    /** Write new component group to remote */
+    createComponentGroup(designSystemId: string, versionId: string, group: ComponentGroup, parentId: string): Promise<{
+        id: string;
+        idInVersion: string;
+    }>;
+    /** Update existing component group in remote */
+    updateComponentGroup(designSystemId: string, versionId: string, group: ComponentGroup): Promise<void>;
+    /** Update component property at remote */
+    updateComponentPropertyValue(designSystemId: string, versionId: string, newValue: string | boolean, component: Component, property: ElementProperty): Promise<void>;
+    /** Delete component property in remote */
+    deleteComponentPropertyValue(designSystemId: string, versionId: string, valueId: string): Promise<void>;
+    /** Create a custom property in remote */
+    createComponentProperty(designSystemId: string, versionId: string, model: ElementPropertyCreationModel): Promise<{
+        id: string;
+        idInVersion: string;
+    }>;
+    /** Create a custom property in remote */
+    updateComponentProperty(designSystemId: string, versionId: string, propertyIdInVersion: string, model: ElementPropertyUpdateModel): Promise<void>;
+    /** Delete a custom property in remote */
+    deleteComponentProperty(designSystemId: string, versionId: string, propertyId: string): Promise<void>;
+    /** Move column to a new index and reorder all other columns around it */
+    updateReorderComponentColumn(designSystemId: string, versionId: string, view: ElementDataView, column: ElementDataViewColumn, newIndex: number): Promise<void>;
+    /** Update column size */
+    updateResizeComponentColumn(designSystemId: string, versionId: string, view: ElementDataView, column: ElementDataViewColumn, newWidth: number): Promise<void>;
+    /** Delete component from remote */
+    deleteComponent(designSystemId: string, versionId: string, componentId: string): Promise<void>;
+    /** Delete group from remote */
+    ungroupComponentGroup(designSystemId: string, versionId: string, groupId: string): Promise<void>;
+    /** Delete group from remote */
+    deleteComponentGroup(designSystemId: string, versionId: string, componentGroupToDelete: ComponentGroup, components: Array<Component>, componentGroups: Array<ComponentGroup>): Promise<void>;
+    /** Write the component to remote */
+    writeComponentData(designSystemId: string, versionId: string, components: Array<Component>, groups: Array<ComponentGroup>, deleteComponents: Array<Component>, deleteGroups: Array<ComponentGroup>): Promise<void>;
     /** Download all necessary data for assets and retrieve them resolved */
     assets(designSystemId: string, versionId: string): Promise<Array<Asset>>;
     /** Download all necessary data for asset groups and retrieve them resolved */

package/build/sdk-typescript/src/core/data/requests/SDKDataCoreWriteRequests.d.ts

@@ -1,6 +1,8 @@
 import { DocumentationEnvironment } from "../../../model/enums/SDKDocumentationEnvironment";
 import { ElementDataViewColumnType } from "../../../exports";
+import { Component, ComponentRemoteModel } from "../../../model/components/SDKComponent";
 import { ElementPropertyRemoteModel } from "../../../model/elements/SDKElementProperty";
+import { ComponentGroup, ComponentGroupRemoteModel } from "../../../model/groups/SDKComponentGroup";
 import { TokenGroup, TokenGroupRemoteModel } from "../../../model/groups/SDKTokenGroup";
 import { TokenThemeRemoteModel } from "../../../model/themes/SDKTokenTheme";
 import { TokenRemoteModel } from "../../../model/tokens/remote/SDKRemoteTokenModel";
@@ -64,12 +66,26 @@ export declare class DataCoreWriteRequests {
     deleteRemoteTokenTheme(designSystemId: string, versionId: string, themeId: string): Promise<void>;
     writeTokenData(designSystemId: string, versionId: string, tokens: Array<TokenRemoteModel>, groups: Array<TokenGroupRemoteModel>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>): Promise<void>;
     writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenThemeRemoteModel): Promise<void>;
-    updateTokenPropertyValue(designSystemId: string, versionId: string, newValue: string | boolean, tokenId: string, propertyId: string): Promise<void>;
+    updateTokenPropertyValue(designSystemId: string, versionId: string, newValue: string | boolean | number, tokenId: string, propertyId: string): Promise<void>;
     deleteTokenPropertyValue(designSystemId: string, versionId: string, valueId: string): Promise<void>;
     createTokenProperty(designSystemId: string, versionId: string, model: object): Promise<ElementPropertyRemoteModel>;
     updateTokenProperty(designSystemId: string, versionId: string, propertyIdInVersion: string, model: object): Promise<void>;
     deleteTokenProperty(designSystemId: string, versionId: string, propertyId: string): Promise<void>;
     updateReorderTokenColumn(designSystemId: string, versionId: string, viewId: string, columnId: string, newIndex: number): Promise<void>;
-    updateResizeTokenColumn(designSystemId: string, versionId: string, viewId: string, columnType: ElementDataViewColumnType, columnId: string, columnThemeId: string | undefined, columnBasePropertyType: string | undefined, newWidth: number): Promise<void>;
+    updateResizeTokenColumn(designSystemId: string, versionId: string, viewId: string, columnType: ElementDataViewColumnType, columnId: string, columnThemeId: string | undefined, columnBasePropertyType: string | undefined, columnPropertyDefinitionId: string | undefined, newWidth: number): Promise<void>;
+    createRemoteComponent(designSystemId: string, versionId: string, component: ComponentRemoteModel): Promise<ComponentRemoteModel>;
+    updateRemoteComponent(designSystemId: string, versionId: string, component: ComponentRemoteModel): Promise<ComponentRemoteModel>;
+    createRemoteComponentGroup(designSystemId: string, versionId: string, group: ComponentGroupRemoteModel): Promise<ComponentGroupRemoteModel>;
+    updateRemoteComponentGroup(designSystemId: string, versionId: string, group: ComponentGroupRemoteModel): Promise<void>;
+    deleteRemoteComponent(designSystemId: string, versionId: string, componentId: string): Promise<void>;
+    ungroupRemoteComponentGroup(designSystemId: string, versionId: string, componentGroupId: string): Promise<void>;
+    writeComponentData(designSystemId: string, versionId: string, components: Array<ComponentRemoteModel>, groups: Array<ComponentGroupRemoteModel>, deleteComponents: Array<Component>, deleteComponentGroups: Array<ComponentGroup>): Promise<void>;
+    updateComponentPropertyValue(designSystemId: string, versionId: string, newValue: string | boolean, componentId: string, propertyId: string): Promise<void>;
+    deleteComponentPropertyValue(designSystemId: string, versionId: string, valueId: string): Promise<void>;
+    createComponentProperty(designSystemId: string, versionId: string, model: object): Promise<ElementPropertyRemoteModel>;
+    updateComponentProperty(designSystemId: string, versionId: string, propertyIdInVersion: string, model: object): Promise<void>;
+    deleteComponentProperty(designSystemId: string, versionId: string, propertyId: string): Promise<void>;
+    updateReorderComponentColumn(designSystemId: string, versionId: string, viewId: string, columnId: string, newIndex: number): Promise<void>;
+    updateResizeComponentColumn(designSystemId: string, versionId: string, viewId: string, columnType: ElementDataViewColumnType, columnId: string, columnThemeId: string | undefined, columnBasePropertyType: string | undefined, columnPropertyDefinitionId: string | undefined, newWidth: number): Promise<void>;
     writeTokenStudioJSONData(designSystemId: string, versionId: string, data: object): Promise<boolean>;
 }

package/build/sdk-typescript/src/exports.d.ts

@@ -1,7 +1,9 @@
+export { ThemeUtilities } from "./model/themes/SDKThemeUtilities";
 export { ElementPropertyValue } from "./model/elements/values/SDKElementPropertyValue";
 export { TokenUtilPreviewSegmentGenerator } from "./tools/token-preview/TokenUtilPreviewSegmentGenerator";
 export { TokenTypeMapToken } from "./utils/TokenUtils";
-export { DimensionTokenType, DIMENSION_TOKEN_TYPES, } from "./model/enums/SDKTokenType";
+export { TokenUtils } from "./utils/TokenUtils";
+export { DimensionTokenType, DIMENSION_TOKEN_TYPES, StringTokenType, STRING_TOKEN_TYPES, OptionTokenType, OPTION_TOKEN_TYPES, } from "./model/enums/SDKTokenType";
 export { Supernova } from "./core/SDKSupernova";
 export { Workspace } from "./model/workspaces/SDKWorkspace";
 export { WorkspaceProfile, WorkspaceProfileUpdateModel, } from "./model/workspaces/SDKWorkspaceProfile";
@@ -30,7 +32,7 @@ export { Asset } from "./model/assets/SDKAsset";
 export { RenderedAsset } from "./model/assets/SDKRenderedAsset";
 export { Component } from "./model/components/SDKComponent";
 export { ElementProperty, ElementPropertyLinkElementType, ElementPropertyTargetElementType, ElementPropertyType, } from "./model/elements/SDKElementProperty";
-export { ElementPropertyOption } from "./model/elements/SDKElementPropertyOption";
+export { ElementPropertyOption, ElementPropertyOptionBadgeColor, } from "./model/elements/SDKElementPropertyOption";
 export { ElementDataView } from "./model/elements/SDKElementDataView";
 export { ElementDataViewColumn, ElementDataViewColumnBasePropertyType, ElementDataViewColumnType, } from "./model/elements/SDKElementDataViewColumn";
 export { DesignComponent } from "./model/components/SDKDesignComponent";

package/build/sdk-typescript/src/model/components/SDKComponent.d.ts

@@ -11,10 +11,11 @@ export type ComponentRemoteModel = {
     };
     createdAt?: string;
     updatedAt?: string;
+    groupPersistentId?: string;
 };
 export declare class Component {
+    idInVersion: string;
     id: string;
-    persistentId: string;
     designSystemVersionId: string;
     brandId: string;
     name: string;
@@ -24,4 +25,5 @@ export declare class Component {
     createdAt: Date | null;
     updatedAt: Date | null;
     constructor(model: ComponentRemoteModel, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
+    toWriteObject(): ComponentRemoteModel;
 }

package/build/sdk-typescript/src/model/elements/SDKElementPropertyOption.d.ts

@@ -1,3 +1,4 @@
+export type ElementPropertyOptionBadgeColor = "blue" | "cyan" | "fuchsia" | "green" | "grey" | "light-grey" | "orange" | "pink" | "purple" | "red" | "teal" | "yellow" | "custom";
 export type ElementPropertyOptionRemoteModel = {
     id: string;
     name: string;
@@ -14,4 +15,8 @@ export declare class ElementPropertyOption {
     constructor(model: ElementPropertyOptionRemoteModel);
     /** Constructs directly manipulable update object for user profile */
     toUpdateObject(): ElementPropertyOptionUpdateModel;
+    /** Returns background color represented as badge color. If badge color is different than what badge defines as base, return custom. Note: Only temporary implementation until BE supports it properly */
+    asBadgeColor(): ElementPropertyOptionBadgeColor;
+    /** Sets background color based on badge identifier color. Note: Only temporary implementation until BE supports it properly */
+    setFromBadgeColor(color: ElementPropertyOptionBadgeColor): void;
 }

package/build/sdk-typescript/src/model/enums/SDKTokenType.d.ts

@@ -34,10 +34,10 @@ export type DimensionTokenType = (typeof DIMENSION_TOKEN_TYPES)[number];
 export declare const RAW_DIMENSION_TOKEN_TYPES: TokenType[];
 export declare const MS_DIMENSION_TOKEN_TYPES: TokenType[];
 export declare const ALL_TOKEN_TYPES: TokenType[];
-export declare const PURE_TOKEN_TYPES: readonly [TokenType.color, TokenType.dimension, TokenType.size, TokenType.space, TokenType.opacity, TokenType.fontSize, TokenType.lineHeight, TokenType.letterSpacing, TokenType.paragraphSpacing, TokenType.borderWidth, TokenType.radius, TokenType.duration, TokenType.zIndex, TokenType.string, TokenType.productCopy, TokenType.fontFamily, TokenType.fontWeight, TokenType.textCase, TokenType.textDecoration, TokenType.visibility];
+export declare const PURE_TOKEN_TYPES: readonly [TokenType.dimension, TokenType.size, TokenType.space, TokenType.opacity, TokenType.fontSize, TokenType.lineHeight, TokenType.letterSpacing, TokenType.paragraphSpacing, TokenType.borderWidth, TokenType.radius, TokenType.duration, TokenType.zIndex, TokenType.string, TokenType.productCopy, TokenType.fontFamily, TokenType.fontWeight, TokenType.textCase, TokenType.textDecoration, TokenType.visibility];
 export type PureTokenType = (typeof PURE_TOKEN_TYPES)[number];
 export type NonPureTokenType = Exclude<TokenType, PureTokenType>;
-export declare const tokenTypeIsPure: (tokenType: TokenType) => tokenType is TokenType.color | TokenType.dimension | TokenType.size | TokenType.space | TokenType.opacity | TokenType.fontSize | TokenType.lineHeight | TokenType.letterSpacing | TokenType.paragraphSpacing | TokenType.borderWidth | TokenType.radius | TokenType.duration | TokenType.zIndex | TokenType.string | TokenType.productCopy | TokenType.fontFamily | TokenType.fontWeight | TokenType.textCase | TokenType.textDecoration | TokenType.visibility;
+export declare const tokenTypeIsPure: (tokenType: TokenType) => tokenType is TokenType.dimension | TokenType.size | TokenType.space | TokenType.opacity | TokenType.fontSize | TokenType.lineHeight | TokenType.letterSpacing | TokenType.paragraphSpacing | TokenType.borderWidth | TokenType.radius | TokenType.duration | TokenType.zIndex | TokenType.string | TokenType.productCopy | TokenType.fontFamily | TokenType.fontWeight | TokenType.textCase | TokenType.textDecoration | TokenType.visibility;
 export declare const tokenTypeIsNonPure: (tokenType: TokenType) => tokenType is NonPureTokenType;
 export declare const REPLACABLE_TOKEN_TYPES: readonly [TokenType.color, TokenType.dimension, TokenType.size, TokenType.space, TokenType.opacity, TokenType.fontSize, TokenType.lineHeight, TokenType.letterSpacing, TokenType.paragraphSpacing, TokenType.borderWidth, TokenType.radius, TokenType.duration, TokenType.zIndex, TokenType.string, TokenType.productCopy, TokenType.fontFamily, TokenType.fontWeight, TokenType.textCase, TokenType.textDecoration, TokenType.visibility];
 export type ReplacableTokenType = (typeof REPLACABLE_TOKEN_TYPES)[number];

package/build/sdk-typescript/src/model/groups/SDKComponentGroup.d.ts

@@ -11,6 +11,7 @@ export type ComponentGroupRemoteModel = {
     childrenIds: string[];
     createdAt?: string;
     updatedAt?: string;
+    parentId?: string;
 };
 export declare class ComponentGroup {
     id: string;

package/build/sdk-typescript/src/model/themes/SDKTokenTheme.d.ts

@@ -42,14 +42,14 @@ export declare class TokenTheme {
     } | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").ColorTokenRemoteValue;
-    } | {
-        aliasTo: string;
-        value: import("../tokens/remote/SDKRemoteTokenValue").TypographyTokenRemoteValue;
     } | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").AnyDimensionTokenRemoteValue;
     } | {
         aliasTo: string;
         value: string;
+    } | {
+        aliasTo: string;
+        value: import("../tokens/remote/SDKRemoteTokenValue").TypographyTokenRemoteValue;
     };
 }

package/build/sdk-typescript/src/model/themes/SDKTokenThemeOverride.d.ts

@@ -28,14 +28,14 @@ export declare class TokenThemeOverride {
     } | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").ColorTokenRemoteValue;
-    } | {
-        aliasTo: string;
-        value: import("../tokens/remote/SDKRemoteTokenValue").TypographyTokenRemoteValue;
     } | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").AnyDimensionTokenRemoteValue;
     } | {
         aliasTo: string;
         value: string;
+    } | {
+        aliasTo: string;
+        value: import("../tokens/remote/SDKRemoteTokenValue").TypographyTokenRemoteValue;
     };
 }

package/build/sdk-typescript/src/model/tokens/SDKColorToken.d.ts

@@ -20,6 +20,9 @@ export declare class ColorToken extends Token {
     toHex8(): string;
     static colorValueToHex6(value: ColorTokenValue): string;
     static colorValueToHex8(value: ColorTokenValue): string;
+    /** Normalizes any color value to server readable value, and ignores alpha value optionally */
+    static colorStringToNormalizedServerValue(value: string | undefined | null, ignoreAlpha?: boolean): string;
+    static normalizedDefaultServerValue(): string;
     updateWithRawValue(value: Omit<ColorTokenValue, "referencedTokenId">): void;
     updateWithReferencedValue(value: ColorToken): void;
     toWriteObject(): ColorTokenRemoteModel;

package/build/sdk-typescript/src/model/tokens/SDKDimensionToken.d.ts

@@ -22,7 +22,14 @@ export declare class DimensionCategoryToken<T extends AnyDimensionTokenValue> ex
     };
     static dimensionValueFromDefinitionOrReference(definition: any, referenceResolver: DTTokenReferenceResolver, tokenType: DimensionTokenType): BorderWidthTokenValue;
     toString(): string;
-    static valueToString(value: AnyDimensionTokenValue): string;
+    static valueToString(value: AnyDimensionTokenValue, options?: {
+        maxNumberOfDecimals?: number;
+        clipTrailingZeroes?: boolean;
+    }): string;
+    static numberToString(value: number, options?: {
+        maxNumberOfDecimals?: number;
+        clipTrailingZeroes?: boolean;
+    }): string;
     static unitToString(unit: Unit): string;
     toWriteObject(): DimensionTokenRemoteModel;
     static valueToWriteObject(value: AnyDimensionTokenValue): {

package/build/sdk-typescript/src/tests/validators.d.ts

@@ -78,6 +78,7 @@ export declare const validateNoToken: (t: any, tokens: Token[], name: string) =>
 export declare const validateTokenRef: (t: any, tokens: Token[], description: string, hex: string, name: string, refDescription?: string) => void;
 export declare const validateTokensJustColorRef: (t: any, token: ColorToken, colorRef: ColorToken, name: string, hex: string, opacity?: number, colorRefId?: string, colorRefName?: string, refHex?: string, refOpacity?: number) => void;
 export declare const validateTokenJustColorRef: (t: any, tokens: Token[], name: string, hex: string, opacity?: number, colorRefId?: string, colorRefName?: string, refHex?: string, refOpacity?: number) => void;
+export declare const validateColorTokenJustOpacityRef: (t: any, tokens: Token[], name: string, opacity: number, unit: Unit, opacityRefId: string, opacityRefName: string) => void;
 export declare const validateDimensionTokenRef: (t: any, tokens: Token[], description: string, refName: string, measure: number, unit: Unit) => void;
 export declare const validateBorderTokenRef: (t: any, tokens: Token[], description: string, refName: string, hex: string, position: BorderPosition, style: BorderStyle, measure: number, unit: Unit) => void;
 export declare const validateBorderTokenInnerRef: (t: any, tokens: Token[], name: string, hex: string, position: BorderPosition, style: BorderStyle, measure: number, unit: Unit) => void;

package/build/sdk-typescript/src/tools/json-builder/elements-transformers/SDKToolsJSONElementTransformer.d.ts

@@ -62,7 +62,7 @@ export declare class TokenJSONElementTransformer {
     safeGroupName(group: TokenGroup): string;
     processedName(name: string, naming: JSONBuilderNamingOption): string;
     /** Retrieve human-readable token type in unified fashion, used both as token type and as token master group */
-    typeLabel(type: TokenType): "color" | "gradient" | "typography" | "border" | "textCase" | "textDecoration" | "shadow" | "visibility" | "measure" | "text";
+    typeLabel(type: TokenType): "color" | "gradient" | "typography" | "border" | "textCase" | "textDecoration" | "shadow" | "visibility" | "text" | "measure";
     /** Retrieve chain of groups up to a specified group, ordered from parent to children */
     referenceGroupChain(containingGroup: TokenGroup, allGroups: Array<TokenGroup>): Array<TokenGroup>;
 }

package/build/sdk-typescript/src/utils/ComponentUtils.d.ts

@@ -0,0 +1,12 @@
+import { Component } from "../model/components/SDKComponent";
+import { ComponentGroup } from "../model/groups/SDKComponentGroup";
+export declare class ComponentUtils {
+    /** Map components for lookup */
+    static componentsToReferenceMap(components: Array<Component>): Map<string, Component>;
+    /** Map component groups for lookup */
+    static componentGroupsToReferenceMap(groups: Array<ComponentGroup>): Map<string, ComponentGroup>;
+    /** Creates a new component group. Default values will be used for all properties */
+    static createDefaultComponentGroup(versionId: string, brandId: string, name?: string): ComponentGroup;
+    /** Creates a new component. Default values will be used for all properties */
+    static createDefaultComponent(versionId: string, brandId: string, name?: string): Component;
+}