@supernova-studio/supernova-sdk-beta 1.6.13 → 1.6.15

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;
+        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/SDKAreaPipelines.d.ts

@@ -1,3 +1,4 @@
+import { DocumentationEnvironment } from "../../model/enums/SDKDocumentationEnvironment";
 import { ExporterCustomBlockVariant } from "../../model/exporters/custom_blocks/SDKExporterCustomBlockVariant";
 import { ExporterConfigurationProperty } from "../../model/exporters/custom_properties/SDKExporterConfigurationProperty";
 import { Exporter } from "../../model/exporters/SDKExporter";
@@ -22,13 +23,13 @@ export declare class AreaPipelines {
      */
     getExporterBlockVariants(workspaceId: string, exporterId: string): Promise<Array<ExporterCustomBlockVariant>>;
     /** Publish documentation. This queues a build on Supernova's server that will be processed by the asynchronous CI/CD pipeline. You can request status of the build with associated `isBeingPublished` method. */
-    publish(to: RemoteWorkspaceVersionIdentifier): Promise<{
+    publish(to: RemoteWorkspaceVersionIdentifier, environment: DocumentationEnvironment): Promise<{
         status: "Queued" | "InProgress" | "Failure";
         jobId: string | null;
         exporterId: string | null;
     }>;
     /** Publish documentation. This queues a build on Supernova's server that will be processed by the asynchronous CI/CD pipeline. You can request status of the build with associated `isBeingPublished` method. */
-    isPublishing(to: RemoteWorkspaceVersionIdentifier): Promise<{
+    isPublishing(to: RemoteWorkspaceVersionIdentifier, environment: DocumentationEnvironment): Promise<{
         status: "InProgress" | "Idle";
         jobId: string | null;
         exporterId: string | null;

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/areas/SDKAreaTokens.d.ts

@@ -188,12 +188,20 @@ export declare class AreaTokens {
      * @returns Nothing
      */
     deleteToken(to: RemoteVersionIdentifier, tokenIdInVersion: string): Promise<void>;
-    /** Deletes remote token group. This method will also fix the token group tree by moving any subgroups to parent. Calling this method on group that doesn't exist in the version will result in error
+    /** Deletes remote token group. This method will also fix the token 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 tokenGroupIdInVersion - Token group idInVersion to delete
      * @returns Nothing
      */
-    deleteTokenGroup(to: RemoteVersionIdentifier, tokenGroupIdInVersion: string): Promise<void>;
+    ungroupTokenGroup(to: RemoteVersionIdentifier, tokenGroupIdInVersion: string): Promise<void>;
+    /** Deletes remote token group and all its descendants. All items (groups and tokens) 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 tokenGroupToDelete - Token group to delete
+     * @param allTokens - Tokens for lookup
+     * @param allTokenGroup - Token group for lookup
+     * @returns Nothing
+     */
+    deleteTokenGroup(to: RemoteVersionIdentifier, tokenGroupToDelete: TokenGroup, tokens: Array<Token>, tokenGroups: Array<TokenGroup>): Promise<void>;
     /** Deletes remote token theme. This method will also remove all theme overrides and disconnect theme from assigned column, all of which will be updated
      * @param to - Remote version to write to
      * @param idInVersion - Theme idInVersion to delete
@@ -201,7 +209,7 @@ export declare class AreaTokens {
      */
     deleteTokenTheme(to: RemoteVersionIdentifier, idInVersion: string): Promise<void>;
     /** Warning: INTERNAL, DO NOT USE YET, NOT STABLE INTERFACE. Write tokens in bulk */
-    writeTokens(to: RemoteVersionIdentifier, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>): Promise<void>;
+    writeTokens(to: RemoteVersionIdentifier, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>): Promise<void>;
     /** Warning: INTERNAL, DO NOT USE YET, NOT STABLE INTERFACE. Write theme in bulk */
     writeTheme(to: RemoteVersionIdentifier, theme: TokenTheme): Promise<void>;
     /** Resolves tokens by applying themes to them and retrieves new token set where values correctly correspond to that theme */

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

@@ -11,4 +11,6 @@ export declare class AreaVersions {
     getVersions(designSystemId: string): Promise<Array<DesignSystemVersion>>;
     /** Fetches design system version by id */
     getVersion(from: RemoteVersionIdentifier): Promise<DesignSystemVersion>;
+    getTokenStudioData(from: RemoteVersionIdentifier): Promise<object>;
+    writeTokenStudioData(from: RemoteVersionIdentifier, data: object): Promise<boolean>;
 }

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

@@ -1,3 +1,4 @@
+import { DocumentationEnvironment } from "../../model/enums/SDKDocumentationEnvironment";
 import { Acl } from "../../model/acl/SDKAcl";
 import { Asset } from "../../model/assets/SDKAsset";
 import { RenderedAsset } from "../../model/assets/SDKRenderedAsset";
@@ -71,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;
@@ -111,14 +112,17 @@ export declare class DataCore {
     /** Update existing token theme in remote */
     updateTokenTheme(designSystemId: string, versionId: string, theme: TokenTheme): Promise<void>;
     /** Write the tokens to remote */
-    writeTokenData(designSystemId: string, versionId: string, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>): Promise<void>;
+    writeTokenData(designSystemId: string, versionId: string, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteGroups: Array<TokenGroup>): Promise<void>;
     writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenTheme): Promise<void>;
     /** Delete token from remote */
     deleteToken(designSystemId: string, versionId: string, tokenId: string): Promise<void>;
     /** Delete group from remote */
-    deleteTokenGroup(designSystemId: string, versionId: string, groupId: string): Promise<void>;
+    ungroupTokenGroup(designSystemId: string, versionId: string, groupId: string): Promise<void>;
+    /** Delete group from remote */
+    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, 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 */
@@ -142,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 */
@@ -155,7 +198,7 @@ export declare class DataCore {
     /** Retrieve currently deployed documentation url */
     documentationDomain(designSystemId: string, versionId: string): Promise<string | null>;
     /** Publish the documentation */
-    documentationPublish(workspaceId: string, designSystemId: string, versionId: string): Promise<{
+    documentationPublish(workspaceId: string, designSystemId: string, versionId: string, environment: DocumentationEnvironment): Promise<{
         status: "Queued" | "InProgress" | "Failure";
         jobId: string;
         exporterId: string;
@@ -176,7 +219,7 @@ export declare class DataCore {
     /** Download information about all installed exporter and retrieve it resolved */
     exporters(workspaceId: string): Promise<Array<Exporter>>;
     /** Download information about documentation builds and retrieve it resolved */
-    documentationBuilds(workspaceId: string, designSystemId: string, versionId: string, limit?: number): Promise<Array<{
+    documentationBuilds(workspaceId: string, designSystemId: string, versionId: string, environment: DocumentationEnvironment, limit?: number): Promise<Array<{
         status: "InProgress" | "Success" | "Failed";
         id: string | null;
         exporterId: string | null;
@@ -213,4 +256,6 @@ export declare class DataCore {
     getBrand(designSystemId: string, versionId: string, brandId: string): Promise<Brand>;
     getOAuthURL(service: "figma" | "bitbucket" | "github" | "gitlab" | "azure"): Promise<string>;
     bulkUpdateTokenData(designSystemId: string, versionId: string, data: TokenUpdateTransactionData): Promise<any>;
+    getTokenStudioData(designSystemId: string, versionId: string): Promise<object>;
+    writeTokenStudioData(designSystemId: string, versionId: string, data: object): Promise<boolean>;
 }

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

@@ -1,3 +1,4 @@
+import { DocumentationEnvironment } from "../../../model/enums/SDKDocumentationEnvironment";
 import { AclRemoteModel } from "../../../model/acl/SDKAcl";
 import { BrandRemoteModel } from "../../../model/base/SDKBrand";
 import { DesignSystemRemoteModel } from "../../../model/base/SDKDesignSystem";
@@ -111,7 +112,7 @@ export declare class DataCoreReadRequests {
     getRemoteElementDataViewDefinitions(designSystemId: string, versionId: string): Promise<Array<ElementDataViewRemoteModel>>;
     /** Remote: Get all property values that were set by the user for each elemen */
     getRemoteElementPropertyValues(designSystemId: string, versionId: string): Promise<ElementPropertyValueRemoteModel[]>;
-    getRemoteDocumentationBuilds(workspaceId: string, designSystemId: string, versionId: string, limit?: number): Promise<Array<{
+    getRemoteDocumentationBuilds(workspaceId: string, designSystemId: string, versionId: string, environment: DocumentationEnvironment, limit?: number): Promise<Array<{
         status: "InProgress" | "Success" | "Failed";
         id: string | null;
         exporterId: string | null;
@@ -121,4 +122,5 @@ export declare class DataCoreReadRequests {
     getOAuthURL(service: "figma" | "bitbucket" | "github" | "gitlab" | "azure"): Promise<string>;
     getVersion(designSystemId: string, versionId: string): Promise<DesignSystemVersionRemoteModel>;
     getVersions(designSystemId: string): Promise<Array<DesignSystemVersionRemoteModel>>;
+    getTokenStudioData(designSystemId: string, versionId: string): Promise<object>;
 }

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

@@ -1,6 +1,9 @@
+import { DocumentationEnvironment } from "../../../model/enums/SDKDocumentationEnvironment";
 import { ElementDataViewColumnType } from "../../../exports";
+import { Component, ComponentRemoteModel } from "../../../model/components/SDKComponent";
 import { ElementPropertyRemoteModel } from "../../../model/elements/SDKElementProperty";
-import { TokenGroupRemoteModel } from "../../../model/groups/SDKTokenGroup";
+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";
 import { Token } from "../../../model/tokens/SDKToken";
@@ -47,7 +50,7 @@ export declare class DataCoreWriteRequests {
     deleteRemoteWorkspaceAvatar(workspaceId: string): Promise<void>;
     /** Remote: Deletes a workspace NPM settings */
     deleteRemoteWorkspaceNPMRegistrySettings(workspaceId: string): Promise<void>;
-    publishDocumentation(workspaceId: string, designSystemId: string, versionId: string): Promise<{
+    publishDocumentation(workspaceId: string, designSystemId: string, versionId: string, environment: DocumentationEnvironment): Promise<{
         status: "Queued" | "InProgress" | "Failure";
         jobId: string;
         exporterId: string;
@@ -57,17 +60,32 @@ export declare class DataCoreWriteRequests {
     createRemoteTokenGroup(designSystemId: string, versionId: string, group: TokenGroupRemoteModel): Promise<TokenGroupRemoteModel>;
     updateRemoteTokenGroup(designSystemId: string, versionId: string, group: TokenGroupRemoteModel): Promise<void>;
     deleteRemoteToken(designSystemId: string, versionId: string, tokenId: string): Promise<void>;
-    deleteRemoteTokenGroup(designSystemId: string, versionId: string, tokenGroupId: string): Promise<void>;
+    ungroupRemoteTokenGroup(designSystemId: string, versionId: string, tokenGroupId: string): Promise<void>;
     createRemoteTokenTheme(designSystemId: string, versionId: string, theme: TokenThemeRemoteModel): Promise<TokenThemeRemoteModel>;
     updateRemoteTokenTheme(designSystemId: string, versionId: string, group: TokenThemeRemoteModel): Promise<void>;
     deleteRemoteTokenTheme(designSystemId: string, versionId: string, themeId: string): Promise<void>;
-    writeTokenData(designSystemId: string, versionId: string, tokens: Array<TokenRemoteModel>, groups: Array<TokenGroupRemoteModel>, deleteTokens: Array<Token>): 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, 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/core/resolvers/SDKDocumentationItemResolver.d.ts

@@ -11,15 +11,16 @@ export declare class DocumentationItemResolver {
     workspaceHandle: string;
     versionId: string;
     designSystemId: string;
+    designSystemName: string;
     docsUrl: string | undefined;
-    constructor(customBlocks: Array<ExporterCustomBlock>, configuration: DocumentationConfiguration, designSystemId: string, versionId: string, workspaceHandle: string, docsUrl: string | undefined);
+    constructor(customBlocks: Array<ExporterCustomBlock>, configuration: DocumentationConfiguration, designSystemId: string, designSystemName: string, versionId: string, workspaceHandle: string, docsUrl: string | undefined);
     resolveItemData(pageDetails: Array<DocumentationPageModel>, groupDetails: Array<DocumentationGroupModel>): Array<DocumentationItem>;
     private resolveItemsForGroup;
     private resolveBlockChains;
     private resolveBlockGroup;
     /** Create URL pointing to the deployed documentation page hosted on Supernova side. Will be empty if there was nothing deployed, or if not hosted at Supernova */
     private deployedUrl;
-    /** Create editor URL pointing to editable page. Since Supernova doesn't link to pages directly yet, this will for now open the editor */
+    /** Create editor URL pointing to editable page. */
     private editorUrl;
     /** Create page URL or group URL pointing to the first contained page */
     private pageUrl;

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

@@ -1,4 +1,9 @@
-export { DimensionTokenType, DIMENSION_TOKEN_TYPES, } from "./model/enums/SDKTokenType";
+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 { 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";
@@ -27,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";
@@ -141,3 +146,4 @@ export { TokenTransform } from "./tools/token-transform/SDKToolsTokenTransform";
 export { UnreachableCaseError } from "./utils/UnreachableCaseError";
 export { SupernovaError, SupernovaFieldValidationError, } from "./core/errors/SDKSupernovaError";
 export { RemoteVersionIdentifier, RemoteBrandIdentifier, RemoteWorkspaceVersionIdentifier, } from "./core/areas/SDKRemoteIdentifiers";
+export { TokenUtilPreviewReferenceInfo, TokenUtilPreviewReferenceInfoPiece, } from "./tools/token-preview/TokenUtilPreviewTypes";

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/documentation/SDKDocumentationItem.d.ts

@@ -2,6 +2,7 @@ import { DocumentationItemType } from "../enums/SDKDocumentationItemType";
 import { DocumentationItemConfiguration, DocumentationItemConfigurationModel } from "./configuration/SDKDocumentationItemConfiguration";
 export type DocumentationItemModel = {
     persistentId: string;
+    shortPersistentId: string;
     id: string;
     designSystemVersionId: string;
     title: string;
@@ -15,6 +16,7 @@ export type DocumentationItemModel = {
 export declare class DocumentationItem {
     id: string;
     persistentId: string;
+    shortPersistentId: string;
     type: DocumentationItemType;
     title: string;
     configuration: DocumentationItemConfiguration;

package/build/sdk-typescript/src/model/documentation/SDKDocumentationPage.d.ts

@@ -4,6 +4,7 @@ import { DocumentationGroup } from "./SDKDocumentationGroup";
 import { DocumentationItem, DocumentationItemModel } from "./SDKDocumentationItem";
 import { DocumentationPageBlock, DocumentationPageBlockModel } from "./SDKDocumentationPageBlock";
 export type DocumentationPageModel = {
+    path: string;
     blocks?: Array<DocumentationPageBlockModel>;
 } & DocumentationItemModel;
 export declare class DocumentationPage extends DocumentationItem {
@@ -14,12 +15,12 @@ export declare class DocumentationPage extends DocumentationItem {
     /** Internal */
     deployedUrl: string | null;
     /** Internal */
-    relativeUrl: string | null;
+    relativeUrl: string;
     /** Internal */
     editorUrl: string | null;
     constructor(model: DocumentationPageModel, customBlocks: Array<ExporterCustomBlock>, configuration: DocumentationConfiguration);
     /** Internal: Modifies object with new paths. Don't use outside SDK environment as it doesn't propagate the data back to source */
-    internalOverridePaths(deployed: string | null, editor: string | null, relative: string | null): void;
+    internalOverridePaths(deployed: string | null, editor: string | null): void;
     /** Internal: Sets new parent. Used when manipulating with object internally. Don't use outside SDK environment */
     setParent(parent: DocumentationGroup): void;
     /** Retrieve editor page URL that can be opened */

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/SDKDocumentationEnvironment.d.ts

@@ -0,0 +1,4 @@
+export declare enum DocumentationEnvironment {
+    live = "Live",
+    preview = "Preview"
+}

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

@@ -33,7 +33,7 @@ export declare class TokenTheme {
     toWriteObject(): TokenThemeRemoteModel;
     private tokensToOverrides;
     toWriteOverrideObject(token: Token): TokenThemeOverrideRemoteModel;
-    valueToWriteObject(value: AnyTokenValue, type: TokenType, token: AnyToken): {
+    valueToWriteObject(value: AnyTokenValue, type: TokenType, token: AnyToken): import("../tokens/remote/SDKRemoteTokenData").ShadowTokenRemoteData | import("../tokens/remote/SDKRemoteTokenData").GradientTokenRemoteData | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").BlurTokenRemoteValue;
     } | {
@@ -42,14 +42,14 @@ export declare class TokenTheme {
     } | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").ColorTokenRemoteValue;
-    } | import("../tokens/remote/SDKRemoteTokenData").GradientTokenRemoteData | {
+    } | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").AnyDimensionTokenRemoteValue;
-    } | import("../tokens/remote/SDKRemoteTokenData").ShadowTokenRemoteData | {
-        aliasTo: string;
-        value: import("../tokens/remote/SDKRemoteTokenValue").TypographyTokenRemoteValue;
     } | {
         aliasTo: string;
         value: string;
+    } | {
+        aliasTo: string;
+        value: import("../tokens/remote/SDKRemoteTokenValue").TypographyTokenRemoteValue;
     };
 }