@supernova-studio/supernova-sdk-beta 1.6.31 → 1.6.33

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

@@ -1,6 +1,7 @@
 import { DesignComponentGroupRemoteModel } from "./SDKDesignComponentGroup";
 export declare class AssetGroup {
     id: string;
+    persistentId: string;
     brandId: string;
     name: string;
     description: string;
@@ -12,6 +13,9 @@ export declare class AssetGroup {
     parentGroupId: string | null;
     createdAt: Date | null;
     updatedAt: Date | null;
+    isAssetGroup: boolean;
+    sourceId: string | null;
+    sourceName: string | null;
     constructor(model: DesignComponentGroupRemoteModel);
     addChild(groupId: string): void;
     addChildren(groupsIds: Array<string>): void;

package/build/sdk-typescript/src/model/resources/SDKResourceFont.d.ts

@@ -1,9 +1,9 @@
 import { Resource, ResourceModel, ResourceType } from "./SDKResource";
 export type ResourceFontModel = ResourceModel & {
-    fontProperties?: {
+    fontProperties?: Array<{
         family?: string;
         subfamily?: string;
-    };
+    }>;
 };
 export declare class ResourceFont extends Resource {
     type: ResourceType;

package/build/sdk-typescript/src/model/support/SDKFigmaFrame.d.ts

@@ -2,7 +2,9 @@ export declare enum FrameType {
     DOCUMENT = "DOCUMENT",
     CANVAS = "CANVAS",
     COMPONENT_SET = "COMPONENT_SET",
+    COMPONENT_VARIANT = "COMPONENT_VARIANT",
     COMPONENT = "COMPONENT",
+    SECTION = "SECTION",
     FRAME = "FRAME"
 }
 export type FigmaFrameModel = {

package/build/sdk-typescript/src/model/support/SDKSource.d.ts

@@ -1,10 +1,15 @@
 import { ImportWarningType } from "../enums/SDKCloudWarningType";
 import { SourceType } from "../enums/SDKSourceType";
+declare enum SourceRemoteType {
+    figma = "Figma",
+    tokenStudio = "TokenStudio",
+    figmaVariablesPlugin = "FigmaVariablesPlugin",
+    upload = "Upload"
+}
 export type SourceRemoteModel = {
-    type: SourceType;
+    type: SourceRemoteType;
     id: string;
     fileName?: string;
-    linkType: "Design" | "Frames";
     brandId?: string;
     plugin?: {
         fileId: string;
@@ -100,6 +105,7 @@ export type SourceRemoteModelTokensStudio = {
 export type SourceRemoteModelFigmaVariablesPlugin = {
     fileId: string;
     lastImportedAt?: string;
+    lastImportMetadata?: Record<string, any>;
 };
 export type SourceModelTokenStudio = Omit<SourceRemoteModelTokensStudio, "lastUpdatesCheckedAt" | "lastImportedAt"> & {
     lastUpdatesCheckedAt?: Date;
@@ -112,14 +118,13 @@ export type SourceModelCloud = Omit<SourceRemoteModelCloud, "lastUpdatesCheckedA
 export type SourceModelFigmaVariablesPlugin = Omit<SourceRemoteModelFigmaVariablesPlugin, "lastImportedAt"> & {
     lastImportedAt?: Date;
 };
-export type SourceTransportModel = Pick<Source, "type" | "id" | "fileName" | "linkType" | "brandId" | "scope"> & {
+export type SourceTransportModel = Pick<Source, "type" | "id" | "fileName" | "brandId" | "scope"> & {
     cloud?: SourceRemoteModelCloud | null;
 };
 export declare class Source {
     type: SourceType;
     id: string;
     fileName: string | null;
-    linkType: "Design" | "Frames";
     brandId: string | null;
     cloud: SourceModelCloud | null;
     tokenStudio?: SourceModelTokenStudio | null;
@@ -139,3 +144,4 @@ export declare class Source {
     /** Reconstructs class from the transport model */
     static fromTransport(model: SourceTransportModel): SourceRemoteModel;
 }
+export {};

package/build/sdk-typescript/src/model/support/SDKTokenOrigin.d.ts

@@ -1,4 +1,4 @@
-import { SourceType } from "../../model/enums/SDKSourceType";
+import { SourceType } from "../enums/SDKSourceType";
 export type TokenOriginModel = {
     id?: string;
     name?: string;

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

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

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

@@ -20,22 +20,22 @@ export declare class TokenThemeOverride {
     constructor(model: TokenThemeOverrideRemoteModel, value: AnyTokenValue);
     toWriteObject(): TokenThemeOverrideRemoteModel;
     valueToWriteObject(value: AnyTokenValue, type: TokenType): ShadowTokenRemoteData | GradientTokenRemoteData | {
-        aliasTo: string;
+        aliasTo: string | undefined;
         value: import("../tokens/remote/SDKRemoteTokenValue").BlurTokenRemoteValue;
     } | {
-        aliasTo: string;
+        aliasTo: string | undefined;
         value: import("../tokens/remote/SDKRemoteTokenValue").BorderTokenRemoteValue;
     } | {
-        aliasTo: string;
+        aliasTo: string | undefined;
         value: import("../tokens/remote/SDKRemoteTokenValue").ColorTokenRemoteValue;
     } | {
-        aliasTo: string;
+        aliasTo: string | undefined;
         value: import("../tokens/remote/SDKRemoteTokenValue").AnyDimensionTokenRemoteValue;
     } | {
-        aliasTo: string;
+        aliasTo: string | undefined;
         value: string;
     } | {
-        aliasTo: string;
+        aliasTo: string | undefined;
         value: import("../tokens/remote/SDKRemoteTokenValue").TypographyTokenRemoteValue;
     };
 }

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

@@ -18,6 +18,7 @@ export declare class ColorToken extends Token {
     static colorValueFromDefinitionOrReference(definition: string | object, referenceResolver: DTTokenReferenceResolver): ColorTokenValue | undefined;
     toHex6(): string;
     toHex8(): string;
+    static hexToColorValue(hex: string): ColorTokenValue;
     static colorValueToHex6(value: ColorTokenValue): string;
     static colorValueToHex8(value: ColorTokenValue): string;
     /** Normalizes any color value to server readable value, and ignores alpha value optionally */

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

@@ -75,7 +75,7 @@ export declare class ZIndexToken extends DimensionCategoryToken<ZIndexTokenValue
     tokenType: TokenType.zIndex;
 }
 export type AnyDimensionToken = DimensionToken | SizeToken | SpaceToken | OpacityToken | FontSizeToken | LineHeightToken | LetterSpacingToken | ParagraphSpacingToken | BorderWidthToken | RadiusToken | DurationToken | ZIndexToken;
-export declare const resolveDimension: <TK extends TokenType.dimension | TokenType.size | TokenType.space | TokenType.opacity | TokenType.fontSize | TokenType.lineHeight | TokenType.letterSpacing | TokenType.paragraphSpacing | TokenType.borderWidth | TokenType.radius | TokenType.duration | TokenType.zIndex>(type: TK) => {
+export declare const resolveDimension: <TK extends TokenType.radius | TokenType.borderWidth | TokenType.duration | TokenType.fontSize | TokenType.dimension | TokenType.letterSpacing | TokenType.lineHeight | TokenType.opacity | TokenType.paragraphSpacing | TokenType.size | TokenType.space | TokenType.zIndex>(type: TK) => {
     Color: typeof import("./SDKColorToken").ColorToken;
     Typography: typeof import("./SDKTypographyToken").TypographyToken;
     Blur: typeof import("./SDKBlurToken").BlurToken;

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

@@ -32,7 +32,7 @@ export declare class FontWeightToken extends StringCategoryToken<FontWeightToken
     tokenType: TokenType.fontWeight;
 }
 export type AnyStringToken = StringToken | ProductCopyToken | FontFamilyToken | FontWeightToken;
-export declare const resolveString: <TK extends TokenType.string | TokenType.productCopy | TokenType.fontFamily | TokenType.fontWeight>(type: TK) => {
+export declare const resolveString: <TK extends TokenType.fontFamily | TokenType.fontWeight | TokenType.string | TokenType.productCopy>(type: TK) => {
     Color: typeof import("./SDKColorToken").ColorToken;
     Typography: typeof import("./SDKTypographyToken").TypographyToken;
     Blur: typeof import("./SDKBlurToken").BlurToken;

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

@@ -13,7 +13,7 @@ export declare class TextCaseToken extends Token {
     static create(versionId: string, brandId: string, name: string, description: string, value: string, alias: TextCaseToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): TextCaseToken;
     static textCaseFromDefinition(textCase: string): {
         value: TextCase;
-        referencedTokenId: any;
+        referencedTokenId: null;
     };
     toWriteObject(): TextCaseTokenRemoteModel;
     static valueToWriteObject(value: TextCaseTokenValue): {

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

@@ -14,7 +14,7 @@ export declare class TextDecorationToken extends Token {
     static create(versionId: string, brandId: string, name: string, description: string, value: string, alias: TextDecorationToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): TextDecorationToken;
     static textDecorationFromDefinition(textDecoration: string): {
         value: TextDecoration;
-        referencedTokenId: any;
+        referencedTokenId: null;
     };
     static optionValueFromDefinitionOrReference(definition: any, referenceResolver: DTTokenReferenceResolver, tokenType: OptionTokenType): AnyOptionTokenValue;
     static optionValueFromDefinition(definition: string, type: OptionTokenType): AnyOptionTokenValue;

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

@@ -192,9 +192,9 @@ export type AnyPlainTokenValue = Exclude<AnyTokenValue, ShadowTokenValue[] | Gra
 export type RawValue<T extends {
     referencedTokenId: string;
 }> = Omit<T, "referencedTokenId">;
-export declare const getReferencedTokens: (token: AnyToken, allTokens: Map<string, Token>) => Token[];
+export declare const getReferencedTokens: (token: AnyToken, allTokens: Map<string, Token>) => (Token | undefined)[];
 export declare const getSingleReferencedTokenId: (token: AnyToken, allTokens: Map<string, Token>) => string | undefined;
-export declare const checkSingleReferencedTokenById: (token: AnyToken, candidateId: string, allTokens: Map<string, Token>) => boolean;
+export declare const checkSingleReferencedTokenById: (token: AnyToken, candidateId: string, allTokens: Map<string, Token>) => boolean | "";
 export declare const replaceReferencedTokenIds: (token: AnyToken, currentId: string, newId: string, allTokens: Map<string, Token>) => void;
 export declare const replaceReferencedToken: (token: Token, existingToken: AnyToken, newToken: AnyToken) => void;
 export declare const replaceReferencedTokenByIds: (token: Token, existingTokenId: string, newTokenId: string) => void;

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

@@ -10,9 +10,9 @@ export declare class FigmaTokensDataLoader {
         settings: DTPluginToSupernovaSettings;
         mapping: {
             supernovaBrand: string;
-            supernovaTheme: string;
-            tokensTheme: string | string[];
-            tokenSets: string[];
+            supernovaTheme: string | null;
+            tokensTheme: string | string[] | null;
+            tokenSets: string[] | null;
         }[];
         payload: object;
     }>;

package/build/sdk-typescript/src/tools/design-tokens/SDKToolsDesignTokensPlugin.d.ts

@@ -1,6 +1,7 @@
 import { Supernova } from "../../core/SDKSupernova";
 import { Brand } from "../../model/base/SDKBrand";
 import { TokenGroup } from "../../model/groups/SDKTokenGroup";
+import { Logger } from "../../model/support/SDKLogger";
 import { TokenTheme } from "../../model/themes/SDKTokenTheme";
 import { Token } from "../../model/tokens/SDKToken";
 import { AnyToken } from "../../model/tokens/SDKTokenValue";
@@ -25,7 +26,7 @@ export declare class SupernovaToolsDesignTokensPlugin {
     private versionId;
     private sortMultiplier;
     private logger;
-    constructor(designSystemId: string, versionId: string, instance: Supernova);
+    constructor(designSystemId: string, versionId: string, instance: Supernova, logger?: Logger);
     synchronizeTokensFromData(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings): Promise<object>;
     synchronizeTokensFromDataWithResults(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings): Promise<{
         results: SupernovaToolsDesignTokensResult[];

package/build/sdk-typescript/src/tools/design-tokens/utilities/SDKDTJSONParser.d.ts

@@ -1,5 +1,5 @@
-import { Logger } from "../../../model/support/SDKLogger";
 import { DTOriginalTokenType } from "../../../model/enums/SDKTokenType";
+import { Logger } from "../../../model/support/SDKLogger";
 export type DTParsedNode = {
     rootKey: string;
     name: string;

package/build/sdk-typescript/src/tools/design-tokens/utilities/tree/SDKDTGroupTree.d.ts

@@ -7,6 +7,6 @@ export type TokenTreeElement = Token | TokenGroup;
 export declare class GroupTree extends GroupTreeNode {
     childType: TokenType;
     constructor(backingElement: TokenTreeElement);
-    static populate(root: TokenTreeElement, elements: Array<TokenTreeElement>, parentChildrenMap: Map<string, Array<TokenTreeElement>>): GroupTree;
+    static populate(root: TokenTreeElement, elements: Array<TokenTreeElement>, parentChildrenMap: Map<string, Array<TokenTreeElement>>): GroupTree | null;
 }
 export declare function buildBrandedElementRoots(elements: TokenTreeElement[]): Map<string, Map<TokenType, GroupTree>>;

package/build/sdk-typescript/src/tools/docs-block-builder/SDKDocsBlockBuilder.d.ts

@@ -1,3 +1,4 @@
+import { DocsBlockMultiRichTextPropertyOptions } from "../../exports";
 import { DocsBlockDefinition } from "../../model/docs/blocks/definition/SDKDocsBlockDefinition";
 import { DocsBlockItemDefinition } from "../../model/docs/blocks/definition/SDKDocsBlockItemDefinition";
 import { DocsBlockLayout } from "../../model/docs/blocks/definition/SDKDocsBlockLayout";
@@ -165,6 +166,16 @@ export declare class DocsBlockBuilder {
             [key: string]: DocsBlockRichTextPropertyOptions;
         };
     }): DocsBlockRichTextPropertyDefinition;
+    /** Create a block property with type .richText and its specific options */
+    multiRichTextProperty(configuration: {
+        id: string;
+        name: string;
+        description?: string;
+        options: DocsBlockMultiRichTextPropertyOptions;
+        variants?: {
+            [key: string]: DocsBlockMultiRichTextPropertyOptions;
+        };
+    }): DocsBlockRichTextPropertyDefinition;
     /** Create a block property with type .boolean and its specific options */
     booleanProperty(configuration: {
         id: string;

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

@@ -23,7 +23,7 @@ export declare class TokenJSONElementFigmaTokensTransformer extends TokenJSONEle
     /** Retrieve token wrapper containing its metadata and value information (used as container for each defined token) */
     tokenWrapper(token: Token, value: any, options: TokenJSONBuilderOptionsInternal, groups: Array<TokenGroup>): object;
     /** Retrieve human-readable token type in unified fashion, used both as token type and as token master group */
-    typeLabelConsideringAbstractGroups(token: Token, groups: Array<TokenGroup>): string;
+    typeLabelConsideringAbstractGroups(token: Token, groups: Array<TokenGroup>): string | undefined;
     /** Retrieve wrapper to certain token (referenced by name) pointing to token value */
     referenceWrapper(reference: string): string;
     /** Retrieve safe group name made out of normal group name

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" | "visibility" | "shadow" | "measure" | "text";
+    typeLabel(type: TokenType): "color" | "gradient" | "typography" | "border" | "textCase" | "textDecoration" | "visibility" | "shadow" | "measure" | "text" | undefined;
     /** 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/tools/token-preview/TokenUtilPreviewGenerator.d.ts

@@ -7,7 +7,10 @@ export declare class TokenUtilPreviewGenerator {
     /** Generates metadata required for rendering of the preview. Only usable with Supernova preview */
     static tokenPreviewMetadata(token: Token, allTokens: Map<string, Token>): TokenUtilPreviewMetadata;
     /** Generates style required for rendering of the preview. Only usable with Supernova preview */
-    static tokenPreviewStyle(token: Token): TokenUtilPreviewResolvedStyle;
+    static tokenPreviewStyle(token: Token, overridenStyles?: {
+        fontFamily?: string;
+        fontWeight?: string;
+    }): TokenUtilPreviewResolvedStyle;
     /** Generates adjusted preview type required for rendering of the preview. Only usable with Supernova preview */
     static tokenPreviewType(token: Token): TokenUtilPreviewTokenType;
     /** Generates per-value description of passed token. Only usable with Supernova preview */

package/build/sdk-typescript/src/tools/token-preview/TokenUtilPreviewStyleGenerator.d.ts

@@ -1,5 +1,8 @@
 import { Token } from "../../model/tokens/SDKToken";
 import { TokenUtilPreviewResolvedStyle } from "./TokenUtilPreviewTypes";
 export declare class TokenUtilPreviewStyleGenerator {
-    resolvedStyleForToken(token: Token): TokenUtilPreviewResolvedStyle | undefined;
+    resolvedStyleForToken(token: Token, overridenStyles?: {
+        fontFamily?: string;
+        fontWeight?: string;
+    }): TokenUtilPreviewResolvedStyle | undefined;
 }

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

@@ -0,0 +1,5 @@
+export declare function castEnum<O extends string>(value: `${O}`): O;
+export declare function castOptionalEnum<O extends string>(value: `${O}` | undefined): O | undefined;
+export type NonEmptyArray<T> = [T, ...T[]];
+export declare function sureOf<T>(entity: T | null | undefined): NonNullable<T>;
+export declare function sortUsingMap<T, K>(items: Array<T>, indexes: Map<K, number>, keyFn: (item: T) => K): Array<T>;

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

@@ -81,7 +81,7 @@ export declare class TokenUtils {
     static tokensToReferenceMap(tokens: Array<Token>): Map<string, Token>;
     /** Map token groups for lookup */
     static tokenGroupsToReferenceMap(groups: Array<TokenGroup>): Map<string, TokenGroup>;
-    static lookupReference<T extends Token>(id: string, tokens: Map<string, Token>): T | undefined;
+    static lookupReference<T extends Token>(id: string | undefined | null, tokens: Map<string, Token>): T | undefined;
     /** Creates a new token group for a given token type. Default values will be used for all properties */
     static createDefaultTokenGroup(type: TokenType, versionId: string, brandId: string, name?: string): TokenGroup;
     /** Creates a new token theme. Default values will be used for all properties */
@@ -275,9 +275,9 @@ export declare class TokenUtils {
     private static checkNotReference;
     private static rawOrReferencedDimensionValue;
     private static rawOrReferencedStringValue;
-    private static validateLayerAccess;
+    static validateLayerAccess(token: AnyMultiLayerToken, index: number): void;
     static inlineValueIntoComplexTokens(token: AnyToken, candidateId: string, candidateValueToInline: AnyTokenValue): void;
-    static getRefIdsFromComplexTokens(token: AnyToken): string[];
+    static getRefIdsFromComplexTokens(token: AnyToken): (string | null | undefined)[];
     static buildKey(path: Array<string>, name: string): string;
     static buildPath(token: Token, groups: Array<TokenGroup>): Array<string>;
     static mapTypeToPrefix: (type: TokenType) => string;

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

@@ -0,0 +1,3 @@
+export type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;