@supernova-studio/supernova-sdk-beta 2.2.52 → 2.4.9

package/build/{sdk-typescript/src → types}/tools/design-tokens/utilities/SDKDTJSONLoader.d.ts

@@ -1,10 +1,11 @@
 import { DTOriginalTokenType } from "../../../model/enums/SDKTokenType";
+import { JSONValue } from "../../../utils/SDKJSONValue";
 export type DTParsedNode = {
     rootKey: string;
     name: string;
     path: Array<string>;
     type: DTOriginalTokenType;
-    value: any;
+    value: JSONValue;
     description: string | null;
 };
 export type DTParsedTokenSet = {

package/build/{sdk-typescript/src → types}/tools/design-tokens/utilities/SDKDTJSONParser.d.ts

@@ -1,11 +1,12 @@
 import { DTOriginalTokenType } from "../../../model/enums/SDKTokenType";
 import { Logger } from "../../../model/support/SDKLogger";
+import { JSONValue } from "../../../utils/SDKJSONValue";
 export type DTParsedNode = {
     rootKey: string;
     name: string;
     path: Array<string>;
     type: DTOriginalTokenType;
-    value: any;
+    value: JSONValue;
     description: string | null;
 };
 export type DTParsedTokenSet = {

package/build/{sdk-typescript/src → types}/tools/design-tokens/utilities/SDKDTThemeMerger.d.ts

@@ -14,7 +14,7 @@ export declare class DTThemeMerger {
     makeTheme(upstreamTokens: Array<Token>, upstreamGroups: Array<TokenGroup>, upstreamTheme: TokenTheme, processedNodes: Array<DTProcessedTokenNode>, preciseCopy?: DTPluginPreciseCopyStrategy, themeOverridesStrategy?: DTPluginThemeOverrideStrategy): TokenTheme;
     inlineTokens(themeReplica: TokenTheme, tokensInThemeButNotInUpstream: Map<string, DTProcessedTokenNode>): void;
     applyThemeOverrideStrategy(idsToRemap: Map<string, string>, themeOverridesStrategy: DTPluginThemeOverrideStrategy, token: Token, incomingThemeOverrideToken?: Token, currentThemeOverride?: Token): {
-        keepOverrideDueToAlias: boolean | "" | null;
-        incomingThemeDiffersFromUpstreamThemeAlias: boolean | "" | null;
+        keepOverrideDueToAlias: boolean;
+        incomingThemeDiffersFromUpstreamThemeAlias: boolean;
     };
 }

package/build/types/tools/design-tokens/utilities/expression/SDKDTExpressionParser.d.ts

@@ -0,0 +1,6 @@
+/** Parsing utility */
+export declare class DTExpressionParser {
+    /** Parsing and reduction utility for simple math expressions */
+    static reduceExpressionsToBaseForm(baseExpression: string): string | number;
+    private static evaluateSingleUnitExpression;
+}

package/build/{sdk-typescript/src → types}/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 | null;
+    static populate(root: TokenTreeElement, elements: Array<TokenTreeElement>, parentChildrenMap: Map<string, Array<TokenTreeElement>>): GroupTree;
 }
 export declare function buildBrandedElementRoots(elements: TokenTreeElement[]): Map<string, Map<TokenType, GroupTree>>;

package/build/{sdk-typescript/src → types}/tools/docs-block-builder/SDKDocsBlockBuilder.d.ts

@@ -10,6 +10,7 @@ import { DocsBlockCodePropertyDefinition, DocsBlockCodePropertyOptions } from ".
 import { DocsBlockCodeSandboxPropertyDefinition, DocsBlockCodeSandboxPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockCodeSandboxProperty";
 import { DocsBlockComponentPropertyDefinition, DocsBlockComponentPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockComponentProperty";
 import { DocsBlockComponentPropertyPropertyDefinition, DocsBlockComponentPropertyPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockComponentPropertyProperty";
+import { DocsBlockContextPropertyDefinition, DocsBlockContextPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockContextProperty";
 import { DocsBlockDividerPropertyDefinition, DocsBlockDividerPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockDividerProperty";
 import { DocsBlockEmbedUrlPropertyDefinition, DocsBlockEmbedUrlPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockEmbedUrlProperty";
 import { DocsBlockFigmaComponentPropertyDefinition, DocsBlockFigmaComponentPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockFigmaComponentProperty";
@@ -182,9 +183,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockTextPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockTextPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockTextPropertyOptions>;
     }): DocsBlockTextPropertyDefinition;
     /** Create a block property with type .richText and its specific options */
     richTextProperty(configuration: {
@@ -192,9 +191,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockRichTextPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockRichTextPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockRichTextPropertyOptions>;
     }): DocsBlockRichTextPropertyDefinition;
     /** Create a block property with type .multiRichText and its specific options */
     multiRichTextProperty(configuration: {
@@ -202,9 +199,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockMultiRichTextPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockMultiRichTextPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockMultiRichTextPropertyOptions>;
     }): DocsBlockMultiRichTextPropertyDefinition;
     /** Create a block property with type .multiRichText and its specific options */
     richTextEditorProperty(configuration: {
@@ -212,9 +207,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockRichTextEditorPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockRichTextEditorPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockRichTextEditorPropertyOptions>;
     }): DocsBlockRichTextEditorPropertyDefinition;
     /** Create a block property with type .boolean and its specific options */
     booleanProperty(configuration: {
@@ -222,9 +215,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockBooleanPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockBooleanPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockBooleanPropertyOptions>;
     }): DocsBlockBooleanPropertyDefinition;
     /** Create a block property with type .number and its specific options */
     numericProperty(configuration: {
@@ -232,9 +223,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockNumberPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockNumberPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockNumberPropertyOptions>;
     }): DocsBlockNumberPropertyDefinition;
     /** Create a block property with type .singleSelect and its specific options */
     singleSelectProperty(configuration: {
@@ -242,9 +231,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockSingleSelectPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockSingleSelectPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockSingleSelectPropertyOptions>;
     }): DocsBlockSingleSelectPropertyDefinition;
     /** Create a block property with type .multiSelect and its specific options */
     multiSelectProperty(configuration: {
@@ -252,9 +239,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockMultiSelectPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockMultiSelectPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockMultiSelectPropertyOptions>;
     }): DocsBlockMultiSelectPropertyDefinition;
     /** Create a block property with type .image and its specific options */
     imageProperty(configuration: {
@@ -262,9 +247,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options?: DocsBlockImagePropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockImagePropertyOptions;
-        };
+        variants?: Record<string, DocsBlockImagePropertyOptions>;
     }): DocsBlockImagePropertyDefinition;
     /** Create a block property with type .token and its specific options */
     tokenProperty(configuration: {
@@ -272,9 +255,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockTokenPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockTokenPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockTokenPropertyOptions>;
     }): DocsBlockTokenPropertyDefinition;
     /** Create a block property with type .tokenType and its specific options */
     tokenTypeProperty(configuration: {
@@ -282,9 +263,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockTokenTypePropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockTokenTypePropertyOptions;
-        };
+        variants?: Record<string, DocsBlockTokenTypePropertyOptions>;
     }): DocsBlockTokenTypePropertyDefinition;
     /** Create a block property with type .tokenProperty and its specific options */
     tokenPropertyProperty(configuration: {
@@ -292,9 +271,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockTokenPropertyPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockTokenPropertyPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockTokenPropertyPropertyOptions>;
     }): DocsBlockTokenPropertyPropertyDefinition;
     /** Create a block property with type .component and its specific options */
     componentProperty(configuration: {
@@ -302,9 +279,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockComponentPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockComponentPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockComponentPropertyOptions>;
     }): DocsBlockComponentPropertyDefinition;
     /** Create a block property with type .componentProperty and its specific options */
     componentPropertyProperty(configuration: {
@@ -312,9 +287,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockComponentPropertyPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockComponentPropertyPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockComponentPropertyPropertyOptions>;
     }): DocsBlockComponentPropertyPropertyDefinition;
     /** Create a block property with type .figmaComponentProperty and its specific options */
     figmaComponentProperty(configuration: {
@@ -322,9 +295,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockFigmaComponentPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockFigmaComponentPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockFigmaComponentPropertyOptions>;
     }): DocsBlockFigmaComponentPropertyDefinition;
     /** Create a block property with type .asset and its specific options */
     assetProperty(configuration: {
@@ -332,9 +303,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockAssetPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockAssetPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockAssetPropertyOptions>;
     }): DocsBlockAssetPropertyDefinition;
     /** Create a block property with type .figmaNodeProperty and its specific options */
     figmaNodeProperty(configuration: {
@@ -342,9 +311,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockFigmaNodePropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockFigmaNodePropertyOptions;
-        };
+        variants?: Record<string, DocsBlockFigmaNodePropertyOptions>;
     }): DocsBlockFigmaNodePropertyDefinition;
     /** Create a block property with type .assetProperty and its specific options */
     assetPropertyProperty(configuration: {
@@ -352,9 +319,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockAssetPropertyPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockAssetPropertyPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockAssetPropertyPropertyOptions>;
     }): DocsBlockAssetPropertyPropertyDefinition;
     /** Create a block property with type .embedURL and its specific options */
     embedUrlProperty(configuration: {
@@ -362,9 +327,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockEmbedUrlPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockEmbedUrlPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockEmbedUrlPropertyOptions>;
     }): DocsBlockEmbedUrlPropertyDefinition;
     /** Create a block property with type .markdown and its specific options */
     markdownProperty(configuration: {
@@ -372,9 +335,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockMarkdownPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockMarkdownPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockMarkdownPropertyOptions>;
     }): DocsBlockMarkdownPropertyDefinition;
     /** Create a block property with type .url and its specific options */
     urlProperty(configuration: {
@@ -382,9 +343,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockUrlPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockUrlPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockUrlPropertyOptions>;
     }): DocsBlockUrlPropertyDefinition;
     /** Create a block property with type .storybook and its specific options */
     storybookProperty(configuration: {
@@ -392,9 +351,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockStorybookPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockStorybookPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockStorybookPropertyOptions>;
     }): DocsBlockStorybookPropertyDefinition;
     /** Create a block property with type .code and its specific options */
     codeProperty(configuration: {
@@ -402,9 +359,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockCodePropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockCodePropertyOptions;
-        };
+        variants?: Record<string, DocsBlockCodePropertyOptions>;
     }): DocsBlockCodePropertyDefinition;
     /** Create a block property with type .codeSandbox and its specific options */
     codeSandboxProperty(configuration: {
@@ -412,9 +367,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockCodeSandboxPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockCodeSandboxPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockCodeSandboxPropertyOptions>;
     }): DocsBlockCodeSandboxPropertyDefinition;
     /** Create a block property with type .table and its specific options */
     tableProperty(configuration: {
@@ -422,9 +375,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockTablePropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockTablePropertyOptions;
-        };
+        variants?: Record<string, DocsBlockTablePropertyOptions>;
     }): DocsBlockTablePropertyDefinition;
     /** Create a block property with type .divider and its specific options */
     dividerProperty(configuration: {
@@ -432,9 +383,7 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockDividerPropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockDividerPropertyOptions;
-        };
+        variants?: Record<string, DocsBlockDividerPropertyOptions>;
     }): DocsBlockDividerPropertyDefinition;
     /** Create a block property with type .file and its specific options */
     fileProperty(configuration: {
@@ -442,8 +391,14 @@ export declare class DocsBlockBuilder {
         name: string;
         description?: string;
         options: DocsBlockFilePropertyOptions;
-        variants?: {
-            [key: string]: DocsBlockFilePropertyOptions;
-        };
+        variants?: Record<string, DocsBlockFilePropertyOptions>;
     }): DocsBlockFilePropertyDefinition;
+    /** Create a block property with type .context and its specific options */
+    contextProperty(configuration: {
+        id: string;
+        name: string;
+        description?: string;
+        options?: DocsBlockContextPropertyOptions;
+        variants?: Record<string, DocsBlockContextPropertyOptions>;
+    }): DocsBlockContextPropertyDefinition;
 }

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

@@ -1,29 +1,30 @@
 import { TokenGroup } from "../../../model/groups/SDKTokenGroup";
 import { Token } from "../../../model/tokens/SDKToken";
 import { AnyOptionTokenValue, AnyStringTokenValue, BorderTokenValue, ColorTokenValue, DimensionTokenValue, GradientTokenValue, ShadowTokenValue, TypographyTokenValue } from "../../../model/tokens/SDKTokenValue";
+import { JSONValue } from "../../../utils/SDKJSONValue";
 import { TokenJSONBuilderOptionsInternal } from "../SDKToolsJSONBuilder";
 import { TokenJSONElementTransformer } from "./SDKToolsJSONElementTransformer";
 /** Token transformer that allow generic transform of tokens to different destinations, like Style Dictionary or Figma Tokens representation */
 export declare class TokenJSONElementFigmaTokensTransformer extends TokenJSONElementTransformer {
     /** Represent color token value either as reference or as plain representation */
-    representColorTokenValue(value: ColorTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representColorTokenValue(value: ColorTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent dimension token value either as reference or as plain representation */
-    representDimensionTokenValue(value: DimensionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representDimensionTokenValue(value: DimensionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent text token value either as reference or as plain representation */
-    representStringTokenValue(value: AnyStringTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
-    representOptionTokenValue(value: AnyOptionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representStringTokenValue(value: AnyStringTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
+    representOptionTokenValue(value: AnyOptionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent typography token value either as reference or as plain representation */
-    representTypographyTokenValue(value: TypographyTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representTypographyTokenValue(value: TypographyTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent border token value either as reference or as plain representation */
-    representBorderTokenValue(value: BorderTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representBorderTokenValue(value: BorderTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent shadow token value either as reference or as plain representation */
-    representShadowTokenValue(values: ShadowTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representShadowTokenValue(values: ShadowTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent gradient token value either as reference or as plain representation */
-    representGradientTokenValue(values: GradientTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representGradientTokenValue(values: GradientTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** 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;
+    tokenWrapper(token: Token, value: JSONValue, 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 | undefined;
+    typeLabelConsideringAbstractGroups(token: Token, groups: Array<TokenGroup>): string;
     /** 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 → types}/tools/json-builder/elements-transformers/SDKToolsJSONElementStyleDictionaryTransformer.d.ts

@@ -1,25 +1,26 @@
 import { TokenGroup } from "../../../model/groups/SDKTokenGroup";
 import { Token } from "../../../model/tokens/SDKToken";
 import { AnyOptionTokenValue, AnyStringTokenValue, BorderTokenValue, ColorTokenValue, DimensionTokenValue, GradientTokenValue, ShadowTokenValue, TypographyTokenValue } from "../../../model/tokens/SDKTokenValue";
+import { JSONValue } from "../../../utils/SDKJSONValue";
 import { TokenJSONBuilderOptionsInternal } from "../SDKToolsJSONBuilder";
 import { TokenJSONElementTransformer } from "./SDKToolsJSONElementTransformer";
 /** Token transformer that allow generic transform of tokens to different destinations, like Style Dictionary or Figma Tokens representation */
 export declare class TokenJSONElementStyleDictionaryTransformer extends TokenJSONElementTransformer {
     /** Represent color token value either as reference or as plain representation */
-    representColorTokenValue(value: ColorTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representColorTokenValue(value: ColorTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent dimension token value either as reference or as plain representation */
-    representDimensionTokenValue(value: DimensionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representDimensionTokenValue(value: DimensionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent text token value either as reference or as plain representation */
-    representStringTokenValue(value: AnyStringTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
-    representOptionTokenValue(value: AnyOptionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representStringTokenValue(value: AnyStringTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
+    representOptionTokenValue(value: AnyOptionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent typography token value either as reference or as plain representation */
-    representTypographyTokenValue(value: TypographyTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representTypographyTokenValue(value: TypographyTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent border token value either as reference or as plain representation */
-    representBorderTokenValue(value: BorderTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representBorderTokenValue(value: BorderTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent shadow token value either as reference or as plain representation */
-    representShadowTokenValue(values: ShadowTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representShadowTokenValue(values: ShadowTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent gradient token value either as reference or as plain representation */
-    representGradientTokenValue(values: GradientTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representGradientTokenValue(values: GradientTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Retrieve wrapper to certain token (referenced by name) pointing to token value */
     referenceWrapper(reference: string): string;
     groupIsAbstract(group: TokenGroup): boolean;

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

@@ -9,6 +9,7 @@ import { AnyStringToken } from "../../../model/tokens/SDKStringToken";
 import { Token } from "../../../model/tokens/SDKToken";
 import { AnyDimensionTokenValue, AnyOptionToken, AnyOptionTokenValue, AnyStringTokenValue, BorderTokenValue, ColorTokenValue, GradientTokenValue, ShadowTokenValue, TypographyTokenValue } from "../../../model/tokens/SDKTokenValue";
 import { TypographyToken } from "../../../model/tokens/SDKTypographyToken";
+import { JSONValue } from "../../../utils/SDKJSONValue";
 import { JSONBuilderNamingOption, TokenJSONBuilderOptionsInternal } from "../SDKToolsJSONBuilder";
 /** Token transformer that allow generic transform of tokens to different destinations, like Style Dictionary or Figma Tokens representation */
 export declare class TokenJSONElementTransformer {
@@ -21,33 +22,33 @@ export declare class TokenJSONElementTransformer {
     /** Represent full gradient token, including wrapping meta-information such as user description */
     representGradientToken(token: GradientToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): object;
     /** Represent full dimension token, including wrapping meta-information such as user description */
-    representDimensionToken(token: AnyDimensionToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
+    representDimensionToken(token: AnyDimensionToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): object;
     /** Represent full shadow token, including wrapping meta-information such as user description */
     representShadowToken(token: ShadowToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): object;
     /** Represent full text token, including wrapping meta-information such as user description */
-    representStringToken(token: AnyStringToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
-    representOptionToken(token: AnyOptionToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
+    representStringToken(token: AnyStringToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): object;
+    representOptionToken(token: AnyOptionToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): object;
     /** Represent full typography token, including wrapping meta-information such as user description */
     representTypographyToken(token: TypographyToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): object;
     /** Represent color token value either as reference or as plain representation */
-    representColorTokenValue(value: ColorTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representColorTokenValue(value: ColorTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent dimension token value either as reference or as plain representation */
-    representDimensionTokenValue(value: AnyDimensionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representDimensionTokenValue(value: AnyDimensionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent text token value either as reference or as plain representation */
-    representStringTokenValue(value: AnyStringTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
-    representOptionTokenValue(value: AnyOptionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representStringTokenValue(value: AnyStringTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
+    representOptionTokenValue(value: AnyOptionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent typography token value either as reference or as plain representation */
-    representTypographyTokenValue(value: TypographyTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representTypographyTokenValue(value: TypographyTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent border token value either as reference or as plain representation */
-    representBorderTokenValue(value: BorderTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representBorderTokenValue(value: BorderTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent shadow token value either as reference or as plain representation */
-    representShadowTokenValue(values: ShadowTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representShadowTokenValue(values: ShadowTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Represent gradient token value either as reference or as plain representation */
-    representGradientTokenValue(value: GradientTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representGradientTokenValue(value: GradientTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): JSONValue;
     /** Retrieve wrapper to certain token (referenced by name) pointing to token value */
     referenceWrapper(reference: string, options: TokenJSONBuilderOptionsInternal): void;
     /** 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;
+    tokenWrapper(token: Token, value: JSONValue, options: TokenJSONBuilderOptionsInternal, groups: Array<TokenGroup>): object;
     /** Create full reference name representing token. Such name can, for example, look like: [g1].[g2].[g3].[g4].[token-name] */
     referenceName(referenceId: string, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): string;
     /** Retrieve safe token name made out of normal token name
@@ -62,7 +63,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): "visibility" | "color" | "gradient" | "typography" | "border" | "text" | "textCase" | "textDecoration" | "shadow" | "measure" | undefined;
+    typeLabel(type: TokenType): "visibility" | "border" | "color" | "gradient" | "measure" | "shadow" | "text" | "textCase" | "textDecoration" | "typography";
     /** 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 → types}/tools/token-preview/TokenUtilPreviewGenerator.d.ts

@@ -5,7 +5,7 @@ export declare class TokenUtilPreviewGenerator {
     /** Generates segments required for rendering of the preview. Only usable with Supernova preview */
     static tokenPreviewSegments(token: Token, allTokens: Map<string, Token>): Array<TokenUtilPreviewTokenValueSegment | "separator">;
     /** Generates metadata required for rendering of the preview. Only usable with Supernova preview */
-    static tokenPreviewMetadata(token: Token, allTokens: Map<string, Token>): TokenUtilPreviewMetadata;
+    static tokenPreviewMetadata(token: Token, allTokens: Map<string, Token>, layerIndex?: number): TokenUtilPreviewMetadata;
     /** Generates style required for rendering of the preview. Only usable with Supernova preview */
     static tokenPreviewStyle(token: Token, overridenStyles?: {
         fontFamily?: string;

package/build/{sdk-typescript/src → types}/tools/token-preview/TokenUtilPreviewMetadataGenerator.d.ts

@@ -2,7 +2,7 @@ import { TokenType } from "../../model/enums/SDKTokenType";
 import { Token } from "../../model/tokens/SDKToken";
 import { TokenUtilPreviewMetadata, TokenUtilPreviewTokenType } from "./TokenUtilPreviewTypes";
 export declare class TokenUtilPreviewMetadataGenerator {
-    resolvedMetadataForToken(token: Token, allTokens: Map<string, Token>): TokenUtilPreviewMetadata;
+    resolvedMetadataForToken(token: Token, allTokens: Map<string, Token>, layerIndex?: number): TokenUtilPreviewMetadata;
     displayValue(token: Token): string;
     tokenTypeToPreviewType(type: TokenType): TokenUtilPreviewTokenType;
 }

package/build/{sdk-typescript/src → types}/tools/token-preview/TokenUtilPreviewSegmentGenerator.d.ts

@@ -5,7 +5,7 @@ export declare class TokenUtilPreviewSegmentGenerator {
     static getTypographyValueReferenceProperties(tokenValue: TypographyTokenValueTypes | undefined | null, allTokens: Map<string, Token>): Pick<TokenUtilPreviewTokenValueSegment, "referencedName" | "referenceResolutionFailed" | "referenceOriginRemote" | "referenceOriginName" | "referenceFullPath">;
     static getReferenceName(reference: Token): string;
     static getCommonProperties(token: Token | undefined, reference: Token | undefined): {
-        referenceName: undefined;
+        referenceName: any;
         referenceResolutionFailed?: undefined;
         referenceOriginRemote?: undefined;
         referenceOriginName?: undefined;
@@ -18,13 +18,13 @@ export declare class TokenUtilPreviewSegmentGenerator {
     } | {
         referenceResolutionFailed: boolean;
         referenceOriginRemote: boolean;
-        referenceOriginName: string | undefined;
-        referenceFullPath: string | undefined;
-        referencedName: string | undefined;
+        referenceOriginName: string;
+        referenceFullPath: string;
+        referencedName: string;
         isDifferentTypeValue: boolean;
         isValueOutOfRange: boolean;
-        tokenOutOfRangeErrorMessage: string | undefined;
-        tokenDifferentTypeErrorMessage: string | undefined;
+        tokenOutOfRangeErrorMessage: string;
+        tokenDifferentTypeErrorMessage: string;
         referenceName?: undefined;
     };
     static resolvedSegmentsForToken(token: Token, allTokens: Map<string, Token>): Array<TokenUtilPreviewTokenValueSegment | "separator">;

package/build/types/utils/ContextUtils.d.ts

@@ -0,0 +1,16 @@
+import { SDKDataset } from "../model/datasets/SDKDataset";
+import { ForgeProjectContext } from "../model/projects/SDKForgeProjectContext";
+export type ContextCompositionNode = {
+    id: string;
+    includedContextIds: readonly string[];
+};
+export declare class ContextUtils {
+    static getDatasetFromContext(context: ForgeProjectContext): SDKDataset;
+    static getResolvedDatasetForContext(context: ForgeProjectContext, allContexts: ForgeProjectContext[]): SDKDataset;
+    static hasCircularIncludedContextDependency({ contextsById, sourceContextId, targetContextIds, visitedContextIds, }: {
+        contextsById: ReadonlyMap<string, ContextCompositionNode>;
+        sourceContextId: string;
+        targetContextIds: ReadonlySet<string>;
+        visitedContextIds?: Set<string>;
+    }): boolean;
+}