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

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

@@ -19,7 +19,7 @@ export declare class TokenThemeOverride {
     updatedAt: Date | null;
     constructor(model: TokenThemeOverrideRemoteModel, value: AnyTokenValue);
     toWriteObject(): TokenThemeOverrideRemoteModel;
-    valueToWriteObject(value: AnyTokenValue, type: TokenType): {
+    valueToWriteObject(value: AnyTokenValue, type: TokenType): ShadowTokenRemoteData | GradientTokenRemoteData | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").BlurTokenRemoteValue;
     } | {
@@ -28,14 +28,14 @@ export declare class TokenThemeOverride {
     } | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").ColorTokenRemoteValue;
-    } | GradientTokenRemoteData | {
+    } | {
         aliasTo: string;
         value: import("../tokens/remote/SDKRemoteTokenValue").AnyDimensionTokenRemoteValue;
-    } | ShadowTokenRemoteData | {
-        aliasTo: string;
-        value: import("../tokens/remote/SDKRemoteTokenValue").TypographyTokenRemoteValue;
     } | {
         aliasTo: string;
         value: string;
+    } | {
+        aliasTo: string;
+        value: import("../tokens/remote/SDKRemoteTokenValue").TypographyTokenRemoteValue;
     };
 }

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

@@ -10,7 +10,7 @@ export declare class BlurToken extends Token {
     value: BlurTokenValue;
     blurLayers: Array<BlurToken>;
     isVirtual: boolean;
-    tokenType: TokenType;
+    tokenType: TokenType.blur;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: BlurTokenValue, alias: BlurToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create(versionId: string, brandId: string, name: string, description: string, value: object, alias: BlurToken | null, referenceResolver: DTTokenReferenceResolver, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): BlurToken;
     static blurValueFromDefinition(definition: object, referenceResolver: DTTokenReferenceResolver): BlurTokenValue;

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

@@ -10,7 +10,7 @@ import { Token } from "./SDKToken";
 import { BorderTokenValue } from "./SDKTokenValue";
 export declare class BorderToken extends Token {
     value: BorderTokenValue;
-    tokenType: TokenType;
+    tokenType: TokenType.border;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: BorderTokenValue, alias: BorderToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create(versionId: string, brandId: string, name: string, description: string, value: object, alias: BorderToken | null, referenceResolver: DTTokenReferenceResolver, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): BorderToken;
     static borderValueFromDefinition(definition: object, referenceResolver: DTTokenReferenceResolver): BorderTokenValue;

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

@@ -8,7 +8,7 @@ import { Token } from "./SDKToken";
 import { ColorTokenValue } from "./SDKTokenValue";
 export declare class ColorToken extends Token {
     value: ColorTokenValue;
-    tokenType: TokenType;
+    tokenType: TokenType.color;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: ColorTokenValue, alias: ColorToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create(versionId: string, brandId: string, name: string, description: string, value: string, alias: ColorToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): ColorToken;
     static colorValueFromDefinition(definition: string): ColorTokenValue;
@@ -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

@@ -7,11 +7,14 @@ import { DimensionTokenRemoteModel, TokenRemoteModel } from "./remote/SDKRemoteT
 import { AnyDimensionTokenRemoteValue } from "./remote/SDKRemoteTokenValue";
 import { Token } from "./SDKToken";
 import { AnyDimensionTokenValue, BorderWidthTokenValue, DimensionTokenValue, DurationTokenValue, FontSizeTokenValue, LetterSpacingTokenValue, LineHeightTokenValue, OpacityTokenValue, ParagraphSpacingTokenValue, RadiusTokenValue, SizeTokenValue, SpaceTokenValue, ZIndexTokenValue } from "./SDKTokenValue";
+import { TokenClassTypeMapToken } from "../../utils/TokenUtils";
 export declare class DimensionCategoryToken<T extends AnyDimensionTokenValue> extends Token {
     value: T;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: T, alias: DimensionCategoryToken<T> | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create<TValue extends AnyDimensionTokenValue, TToken extends DimensionCategoryToken<TValue>>(this: new (...args: any[]) => TToken, type: DimensionTokenType, versionId: string, brandId: string, name: string, description: string, value: string | number, alias: TToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): TToken;
-    static getDefaultUnit(type: DimensionTokenType): Unit.pixels | Unit.ms | Unit.raw;
+    static getCompatibleUnit(unit: Unit, type: DimensionTokenType): Unit;
+    static getCompatibleMeasure(unit: Unit, type: DimensionTokenType, measure: number): number;
+    static getDefaultUnit(type: DimensionTokenType, parsedDefinition?: number): Unit.pixels | Unit.ms | Unit.raw;
     static dimensionValueFromDefinition(definition: string | number, type: DimensionTokenType): OpacityTokenValue;
     static parseDimension(definition: string, type: DimensionTokenType): {
         measure: number;
@@ -19,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): {
@@ -29,42 +39,66 @@ export declare class DimensionCategoryToken<T extends AnyDimensionTokenValue> ex
     static valueToInternalWriteObject(value: AnyDimensionTokenValue | null): AnyDimensionTokenValue | null;
 }
 export declare class DimensionToken extends DimensionCategoryToken<DimensionTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.dimension;
 }
 export declare class SizeToken extends DimensionCategoryToken<SizeTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.size;
 }
 export declare class SpaceToken extends DimensionCategoryToken<SpaceTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.space;
 }
 export declare class OpacityToken extends DimensionCategoryToken<OpacityTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.opacity;
 }
 export declare class FontSizeToken extends DimensionCategoryToken<FontSizeTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.fontSize;
 }
 export declare class LineHeightToken extends DimensionCategoryToken<LineHeightTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.lineHeight;
 }
 export declare class LetterSpacingToken extends DimensionCategoryToken<LetterSpacingTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.letterSpacing;
 }
 export declare class ParagraphSpacingToken extends DimensionCategoryToken<ParagraphSpacingTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.paragraphSpacing;
 }
 export declare class BorderWidthToken extends DimensionCategoryToken<BorderWidthTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.borderWidth;
 }
 export declare class RadiusToken extends DimensionCategoryToken<RadiusTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.radius;
 }
 export declare class DurationToken extends DimensionCategoryToken<DurationTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.duration;
 }
 export declare class ZIndexToken extends DimensionCategoryToken<ZIndexTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.zIndex;
 }
 export type AnyDimensionToken = DimensionToken | SizeToken | SpaceToken | OpacityToken | FontSizeToken | LineHeightToken | LetterSpacingToken | ParagraphSpacingToken | BorderWidthToken | RadiusToken | DurationToken | ZIndexToken;
-type TypeofAnyDimensionToken = typeof DimensionToken | typeof SizeToken | typeof SpaceToken | typeof OpacityToken | typeof FontSizeToken | typeof LineHeightToken | typeof LetterSpacingToken | typeof ParagraphSpacingToken | typeof BorderWidthToken | typeof RadiusToken | typeof DurationToken | typeof ZIndexToken;
-export declare const resolveDimension: (type: DimensionTokenType) => TypeofAnyDimensionToken;
-export {};
+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) => {
+    Color: typeof import("./SDKColorToken").ColorToken;
+    Typography: typeof import("./SDKTypographyToken").TypographyToken;
+    Blur: typeof import("./SDKBlurToken").BlurToken;
+    Border: typeof import("./SDKBorderToken").BorderToken;
+    Shadow: typeof import("./SDKShadowToken").ShadowToken;
+    Gradient: typeof import("./SDKGradientToken").GradientToken;
+    String: typeof import("./SDKStringToken").StringToken;
+    ProductCopy: typeof import("./SDKStringToken").ProductCopyToken;
+    FontFamily: typeof import("./SDKStringToken").FontFamilyToken;
+    FontWeight: typeof import("./SDKStringToken").FontWeightToken;
+    TextCase: typeof import("./SDKTextCaseToken").TextCaseToken;
+    TextDecoration: typeof import("./SDKTextDecorationToken").TextDecorationToken;
+    Visibility: typeof import("./SDKVisibilityToken").VisibilityToken;
+    BorderWidth: typeof BorderWidthToken;
+    Dimension: typeof DimensionToken;
+    Size: typeof SizeToken;
+    Space: typeof SpaceToken;
+    Opacity: typeof OpacityToken;
+    FontSize: typeof FontSizeToken;
+    LineHeight: typeof LineHeightToken;
+    LetterSpacing: typeof LetterSpacingToken;
+    ParagraphSpacing: typeof ParagraphSpacingToken;
+    BorderRadius: typeof RadiusToken;
+    Duration: typeof DurationToken;
+    ZIndex: typeof ZIndexToken;
+}[TK];

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

@@ -11,7 +11,7 @@ export declare class GradientToken extends Token {
     value: GradientTokenValue[];
     gradientLayers: Array<GradientToken>;
     isVirtual: boolean;
-    tokenType: TokenType;
+    tokenType: TokenType.gradient;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: GradientTokenValue[], alias: GradientToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create(versionId: string, brandId: string, name: string, description: string, value: string, alias: GradientToken | null, referenceResolver: DTTokenReferenceResolver, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): GradientToken;
     static gradientValueFromDefinition(definition: object | string, referenceResolver: DTTokenReferenceResolver): GradientTokenValue[];

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

@@ -11,7 +11,7 @@ export declare class ShadowToken extends Token {
     value: Array<ShadowTokenValue>;
     shadowLayers: Array<ShadowToken>;
     isVirtual: boolean;
-    tokenType: TokenType;
+    tokenType: TokenType.shadow;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: ShadowTokenValue[], alias: ShadowToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create(versionId: string, brandId: string, name: string, description: string, value: object, alias: ShadowToken | null, referenceResolver: DTTokenReferenceResolver, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): ShadowToken;
     static shadowValueFromDefinition(definition: object, referenceResolver: DTTokenReferenceResolver): ShadowTokenValue[];

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

@@ -6,6 +6,7 @@ import { StringTokenRemoteValue } from "./remote/SDKRemoteTokenValue";
 import { Token } from "./SDKToken";
 import { AnyStringTokenValue, FontFamilyTokenValue, FontWeightTokenValue, ProductCopyTokenValue, StringTokenValue } from "./SDKTokenValue";
 import { DTTokenReferenceResolver } from "../../tools/design-tokens/utilities/SDKDTTokenReferenceResolver";
+import { TokenClassTypeMapToken } from "../../utils/TokenUtils";
 export declare class StringCategoryToken<T extends AnyStringTokenValue> extends Token {
     value: T;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: T, alias: StringCategoryToken<T> | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
@@ -19,18 +20,42 @@ export declare class StringCategoryToken<T extends AnyStringTokenValue> extends
     };
 }
 export declare class StringToken extends StringCategoryToken<StringTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.string;
 }
 export declare class ProductCopyToken extends StringCategoryToken<ProductCopyTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.productCopy;
 }
 export declare class FontFamilyToken extends StringCategoryToken<FontFamilyTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.fontFamily;
 }
 export declare class FontWeightToken extends StringCategoryToken<FontWeightTokenValue> {
-    tokenType: TokenType;
+    tokenType: TokenType.fontWeight;
 }
 export type AnyStringToken = StringToken | ProductCopyToken | FontFamilyToken | FontWeightToken;
-type TypeofAnyStringToken = typeof StringToken | typeof ProductCopyToken | typeof FontFamilyToken | typeof FontWeightToken;
-export declare const resolveString: (type: StringTokenType) => TypeofAnyStringToken;
-export {};
+export declare const resolveString: <TK extends TokenType.string | TokenType.productCopy | TokenType.fontFamily | TokenType.fontWeight>(type: TK) => {
+    Color: typeof import("./SDKColorToken").ColorToken;
+    Typography: typeof import("./SDKTypographyToken").TypographyToken;
+    Blur: typeof import("./SDKBlurToken").BlurToken;
+    Border: typeof import("./SDKBorderToken").BorderToken;
+    Shadow: typeof import("./SDKShadowToken").ShadowToken;
+    Gradient: typeof import("./SDKGradientToken").GradientToken;
+    String: typeof StringToken;
+    ProductCopy: typeof ProductCopyToken;
+    FontFamily: typeof FontFamilyToken;
+    FontWeight: typeof FontWeightToken;
+    TextCase: typeof import("./SDKTextCaseToken").TextCaseToken;
+    TextDecoration: typeof import("./SDKTextDecorationToken").TextDecorationToken;
+    Visibility: typeof import("./SDKVisibilityToken").VisibilityToken;
+    BorderWidth: typeof import("./SDKDimensionToken").BorderWidthToken;
+    Dimension: typeof import("./SDKDimensionToken").DimensionToken;
+    Size: typeof import("./SDKDimensionToken").SizeToken;
+    Space: typeof import("./SDKDimensionToken").SpaceToken;
+    Opacity: typeof import("./SDKDimensionToken").OpacityToken;
+    FontSize: typeof import("./SDKDimensionToken").FontSizeToken;
+    LineHeight: typeof import("./SDKDimensionToken").LineHeightToken;
+    LetterSpacing: typeof import("./SDKDimensionToken").LetterSpacingToken;
+    ParagraphSpacing: typeof import("./SDKDimensionToken").ParagraphSpacingToken;
+    BorderRadius: typeof import("./SDKDimensionToken").RadiusToken;
+    Duration: typeof import("./SDKDimensionToken").DurationToken;
+    ZIndex: typeof import("./SDKDimensionToken").ZIndexToken;
+}[TK];

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

@@ -8,7 +8,7 @@ import { Token } from "./SDKToken";
 import { TextCaseTokenValue } from "./SDKTokenValue";
 export declare class TextCaseToken extends Token {
     value: TextCaseTokenValue;
-    tokenType: TokenType;
+    tokenType: TokenType.textCase;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: TextCaseTokenValue, alias: TextCaseToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     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): {

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

@@ -9,7 +9,7 @@ import { Token } from "./SDKToken";
 import { AnyOptionTokenValue, TextDecorationTokenValue } from "./SDKTokenValue";
 export declare class TextDecorationToken extends Token {
     value: TextDecorationTokenValue;
-    tokenType: TokenType;
+    tokenType: TokenType.textDecoration;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: TextDecorationTokenValue, alias: TextDecorationToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     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): {

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

@@ -20,7 +20,9 @@ export declare class Token implements TokenValue {
     parentGroupId: string;
     sortOrder: number;
     properties: Array<ElementProperty>;
-    propertyValues: object;
+    propertyValues: {
+        [key: string]: string | boolean | number;
+    };
     createdAt: Date | null;
     updatedAt: Date | null;
     constructor(model: TokenRemoteModel, versionId: string, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>, empty?: boolean);

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

@@ -187,6 +187,7 @@ export type AnyTokenValue = ColorTokenValue | AnyStringTokenValue | TypographyTo
 export type AnyToken = ColorToken | AnyStringToken | TypographyToken | ShadowToken | AnyDimensionToken | BorderToken | GradientToken | BlurToken | AnyOptionToken;
 export type AnySingleLayerToken = Exclude<AnyToken, ShadowToken | GradientToken>;
 export type AnyMultiLayerToken = ShadowToken | GradientToken;
+export type AnyMultiLayerTokenValue = ShadowTokenValue | GradientTokenValue;
 export type AnyPlainTokenValue = Exclude<AnyTokenValue, ShadowTokenValue[] | GradientTokenValue[]> | ShadowTokenValue | GradientTokenValue;
 export type RawValue<T extends {
     referencedTokenId: string;

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

@@ -8,7 +8,7 @@ import { Token } from "./SDKToken";
 import { TypographyTokenValue } from "./SDKTokenValue";
 export declare class TypographyToken extends Token {
     value: TypographyTokenValue;
-    tokenType: TokenType;
+    tokenType: TokenType.typography;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: TypographyTokenValue, alias: TypographyToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create(versionId: string, brandId: string, name: string, description: string, value: object, alias: TypographyToken | null, referenceResolver: DTTokenReferenceResolver, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): TypographyToken;
     static typographyValueFromDefinition(definition: any, referenceResolver: DTTokenReferenceResolver): TypographyTokenValue;

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

@@ -7,7 +7,7 @@ import { Token } from "./SDKToken";
 import { VisibilityTokenValue } from "./SDKTokenValue";
 export declare class VisibilityToken extends Token {
     value: VisibilityTokenValue;
-    tokenType: TokenType;
+    tokenType: TokenType.visibility;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: VisibilityTokenValue, alias: VisibilityToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create(versionId: string, brandId: string, name: string, description: string, value: string, alias: VisibilityToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): VisibilityToken;
     toWriteObject(): TextCaseTokenRemoteModel;

package/build/sdk-typescript/src/tests/Areas/AreaDocumentation.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/build/sdk-typescript/src/tests/Enterprise/PluginFigmaTokens.spec.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -3,6 +3,19 @@ import { DTPluginToSupernovaMapPack, DTPluginToSupernovaSettings } from "../tool
 export declare class FigmaTokensDataLoader {
     static sync(instance: Supernova, designSystemId: string, versionId: string, basePath: string[], dataPath?: string[], mappingPath?: string[], root?: string): Promise<void>;
     static syncPath(instance: Supernova, designSystemId: string, versionId: string, basePath: string, dataPath?: string, mappingPath?: string, root?: string): Promise<void>;
+    static loadTokenStudioPayload(basePath: string[], dataPath?: string[], mappingPath?: string[], root?: string): Promise<{
+        connection: {
+            name: string;
+        };
+        settings: DTPluginToSupernovaSettings;
+        mapping: {
+            supernovaBrand: string;
+            supernovaTheme: string;
+            tokensTheme: string;
+            tokenSets: string[];
+        }[];
+        payload: object;
+    }>;
     /** Load token definitions from path */
     loadTokensFromPath(pathToFile: string): object;
     loadTokensFromDirectory(pathToDirectory: string, settingsPath: string): object;

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

@@ -75,9 +75,10 @@ export declare const validateTypographyToken: (t: any, tokens: Token[], name: st
 export declare const validateTypographyTokenRef: (t: any, tokens: Token[], description: string, refName: string, fontFamily: string, fontWeight: string, lineHeightMeasure: number, fontSizeMeasure: number, letterSpacingMeasure: number, paragraphSpacingMeasure: number, paragraphIndentMeasure: number, textDecoration: TextDecoration, textCase: TextCase) => void;
 export declare const validateTypographyTokenInnerRef: (t: any, tokens: Token[], name: string, fontFamily: string, fontWeight: string, lineHeightMeasure: number, fontSizeMeasure: number, letterSpacingMeasure: number, paragraphSpacingMeasure: number, paragraphIndentMeasure: number, textDecoration: TextDecoration, textCase: TextCase) => void;
 export declare const validateNoToken: (t: any, tokens: Token[], name: string) => void;
-export declare const validateTokenRef: (t: any, tokens: Token[], description: string, hex: string, name: string) => void;
+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/design-tokens/SDKToolsDesignTokensPlugin.d.ts

@@ -6,6 +6,7 @@ import { Token } from "../../model/tokens/SDKToken";
 import { DTProcessedTokenNode } from "./utilities/SDKDTJSONConverter";
 import { DTPluginToSupernovaMap, DTPluginToSupernovaMapPack, DTPluginToSupernovaSettings } from "./utilities/SDKDTMapLoader";
 import { DTTokenMergeDiff } from "./utilities/SDKDTTokenMerger";
+import { AnyToken } from "../../model/tokens/SDKTokenValue";
 export type SupernovaToolsDesignTokensLoadingResult = {
     processedNodes: Array<DTProcessedTokenNode>;
     tokens: Array<Token>;
@@ -30,7 +31,7 @@ export declare class SupernovaToolsDesignTokensPlugin {
     private setTokensOrigin;
     /** Creates pure tree for validation purposes, ignoring any existing token state in workspaces. This method works offline. */
     createPureTokenTree(processedNodes: Array<DTProcessedTokenNode>, verbose: boolean): {
-        tokens: Array<Token>;
+        tokens: Array<AnyToken>;
         groups: Array<TokenGroup>;
     };
     /** Loads remote source connected to this tool, then merges tokens and groups with it, creating union. Can optionally write to the source as well */

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

@@ -1,11 +1,11 @@
 import { Brand } from "../../../model/base/SDKBrand";
 import { DTOriginalTokenType } from "../../../model/enums/SDKTokenType";
-import { Token } from "../../../model/tokens/SDKToken";
 import { DTParsedNode } from "./SDKDTJSONLoader";
 import { DTPluginToSupernovaMapPack } from "./SDKDTMapLoader";
 import { DTTokenReferenceResolver } from "./SDKDTTokenReferenceResolver";
-export type DTProcessedTokenNode = {
-    token: Token;
+import { AnyToken } from "../../../model/tokens/SDKTokenValue";
+export type DTProcessedTokenNode<T extends AnyToken = AnyToken> = {
+    token: T;
     originalType: DTOriginalTokenType;
     path: Array<string>;
     key: string;

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

@@ -12,6 +12,4 @@ export declare class DTThemeMerger {
     constructor(versionId: string);
     makeTheme(upstreamTokens: Array<Token>, upstreamGroups: Array<TokenGroup>, upstreamTheme: TokenTheme, processedNodes: Array<DTProcessedTokenNode>, preciseCopy?: boolean): TokenTheme;
     inlineTokens(themeReplica: TokenTheme, tokensInThemeButNotInUpstream: Map<string, DTProcessedTokenNode>): void;
-    buildKey(path: Array<string>, name: string): string;
-    buildPath(token: Token, groups: Array<TokenGroup>): Array<string>;
 }

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

@@ -1,5 +1,5 @@
 import { TokenGroup } from "../../../model/groups/SDKTokenGroup";
-import { Token } from "../../../model/tokens/SDKToken";
+import { AnyToken } from "../../../model/tokens/SDKTokenValue";
 import { DTProcessedTokenNode } from "./SDKDTJSONConverter";
 export type DTTokenMergeDiff = {
     toUpdate: Array<DTProcessedTokenNode>;
@@ -10,8 +10,7 @@ export type DTTokenMergeDiff = {
 /** Utility allowing merging of two pools of tokens */
 export declare class DTTokenMerger {
     static buildKey(path: Array<string>, name: string): string;
-    buildPath(token: Token, groups: Array<TokenGroup>): Array<string>;
     buildNodeMap(nodes: Array<DTProcessedTokenNode>): Map<string, DTProcessedTokenNode>;
-    convertBaseTokensToProcessedNode(tokens: Array<Token>, groups: Array<TokenGroup>): Array<DTProcessedTokenNode>;
-    makeTokensDiff(existing: Array<Token>, extracted: Array<DTProcessedTokenNode>, groups: Array<TokenGroup>): DTTokenMergeDiff;
+    convertBaseTokensToProcessedNode(tokens: Array<AnyToken>, groups: Array<TokenGroup>): Array<DTProcessedTokenNode>;
+    makeTokensDiff(existing: Array<AnyToken>, extracted: Array<DTProcessedTokenNode>, groups: Array<TokenGroup>): DTTokenMergeDiff;
 }

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

@@ -1,3 +1,4 @@
+import { TokenType } from "../../../model/enums/SDKTokenType";
 import { Token } from "../../../model/tokens/SDKToken";
 import { AnyToken } from "../../../model/tokens/SDKTokenValue";
 import { DTProcessedTokenNode } from "./SDKDTJSONConverter";
@@ -9,19 +10,22 @@ export declare class DTTokenReferenceResolver {
     addAtomicToken(token: DTProcessedTokenNode, indexOfNewNode: number): void;
     addAtomicTokens(tokens: Array<DTProcessedTokenNode>): void;
     unmappedValues(): Array<DTProcessedTokenNode>;
+    tokensOfType(type: TokenType): Array<Token>;
     lookupReferencedToken(reference: string): Token | undefined;
     lookupAllReferencedTokens(reference: string): Array<{
         token: Token;
         key: string;
         location: number;
+        dollarTypeReference: boolean;
     }> | undefined;
     replaceAllReferencedTokens(reference: string, replacements: Array<{
         token: Token;
         key: string;
         location: number;
+        dollarTypeReference: boolean;
     }>): string;
-    replaceToken(base: string, token: Token, key: string, location: number): string;
-    replaceAt(s: string, what: string, replacement: string, index: number): string;
+    replaceToken(base: string, token: Token, key: string, location: number, dollarTypeReference: boolean): string;
+    replaceAt(s: string, what: string, replacement: string, index: number, dollarTypeReference: boolean): string;
     replacableValue(token: Token): string;
     isBalancedReference(syntax: string): boolean;
     valueHasReference(value: string | object | number): boolean;
@@ -32,5 +36,12 @@ export declare class DTTokenReferenceResolver {
     findBracketStrings(str: string): {
         index: number;
         value: string;
+        dollarTypeReference: boolean;
     }[];
+    findDollarStrings(str: string): {
+        index: number;
+        value: string;
+        dollarTypeReference: boolean;
+    }[];
+    isDollarIdentifier(value: string): boolean;
 }

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

@@ -2,7 +2,7 @@ import { DTProcessedTokenNode } from "../SDKDTJSONConverter";
 export declare class DTProcessedTokenNodeCollection {
     readonly index: Map<string, DTProcessedTokenNode>;
     readonly added: Set<string>;
-    readonly deleted: Map<string, DTProcessedTokenNode>;
+    readonly deleted: Map<string, DTProcessedTokenNode<import("../../../..").AnyToken>>;
     readonly dirty: Set<string>;
     readonly list: Array<DTProcessedTokenNode>;
     constructor(source: Array<DTProcessedTokenNode> | Map<string, DTProcessedTokenNode>);

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

@@ -1,5 +1,7 @@
 import { Token } from "../../model/tokens/SDKToken";
+import { ShadowTokenValue } from "../../model/tokens/SDKTokenValue";
 import { TokenUtilPreviewTokenValueSegment } from "./TokenUtilPreviewTypes";
 export declare class TokenUtilPreviewSegmentGenerator {
-    resolvedSegmentsForToken(token: Token, allTokens: Map<string, Token>): Array<TokenUtilPreviewTokenValueSegment | "separator">;
+    static resolvedSegmentsForToken(token: Token, allTokens: Map<string, Token>): Array<TokenUtilPreviewTokenValueSegment | "separator">;
+    static shadowValuesToSegments(layer: ShadowTokenValue | null, allTokens: Map<string, Token>): Array<TokenUtilPreviewTokenValueSegment | "separator">;
 }

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;
+}