@supernova-studio/supernova-sdk-beta 1.6.10 → 1.6.12

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

@@ -2,62 +2,54 @@ import { TokenType } from "../../../model/enums/SDKTokenType";
 import { TokenGroup } from "../../../model/groups/SDKTokenGroup";
 import { BorderToken } from "../../../model/tokens/SDKBorderToken";
 import { ColorToken } from "../../../model/tokens/SDKColorToken";
-import { FontToken } from "../../../model/tokens/SDKFontToken";
+import { AnyDimensionToken } from "../../../model/tokens/SDKDimensionToken";
 import { GradientToken } from "../../../model/tokens/SDKGradientToken";
-import { MeasureToken } from "../../../model/tokens/SDKMeasureToken";
-import { RadiusToken } from "../../../model/tokens/SDKRadiusToken";
 import { ShadowToken } from "../../../model/tokens/SDKShadowToken";
-import { TextToken } from "../../../model/tokens/SDKTextToken";
+import { AnyStringToken } from "../../../model/tokens/SDKStringToken";
 import { Token } from "../../../model/tokens/SDKToken";
-import { BorderTokenValue, ColorTokenValue, FontTokenValue, GradientTokenValue, MeasureTokenValue, RadiusTokenValue, ShadowTokenValue, TextTokenValue, TypographyTokenValue } from "../../../model/tokens/SDKTokenValue";
+import { AnyDimensionTokenValue, AnyOptionToken, AnyOptionTokenValue, AnyStringTokenValue, BorderTokenValue, ColorTokenValue, GradientTokenValue, ShadowTokenValue, TypographyTokenValue } from "../../../model/tokens/SDKTokenValue";
 import { TypographyToken } from "../../../model/tokens/SDKTypographyToken";
 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 {
     /** Represent a singular token as SD object */
-    representToken(token: Token, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
+    representToken(token: Token, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): object;
     /** Represent full color token, including wrapping meta-information such as user description */
-    representColorToken(token: ColorToken, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
+    representColorToken(token: ColorToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): object;
     /** Represent full border token, including wrapping meta-information such as user description */
-    representBorderToken(token: BorderToken, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
-    /** Represent full font token, including wrapping meta-information such as user description */
-    representFontToken(token: FontToken, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
+    representBorderToken(token: BorderToken, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): object;
     /** Represent full gradient token, including wrapping meta-information such as user description */
-    representGradientToken(token: GradientToken, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
-    /** Represent full measure token, including wrapping meta-information such as user description */
-    representMeasureToken(token: MeasureToken, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
-    /** Represent full radius token, including wrapping meta-information such as user description */
-    representRadiusToken(token: RadiusToken, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
+    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;
     /** Represent full shadow token, including wrapping meta-information such as user description */
-    representShadowToken(token: ShadowToken, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
+    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 */
-    representTextToken(token: TextToken, allTokens: Array<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: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): Object;
+    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: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
-    /** Represent radius token value either as reference or as plain representation */
-    representRadiusTokenValue(value: RadiusTokenValue, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
-    /** Represent measure token value either as reference or as plain representation */
-    representMeasureTokenValue(value: MeasureTokenValue, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
-    /** Represent font token value either as reference or as plain representation */
-    representFontTokenValue(value: FontTokenValue, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representColorTokenValue(value: ColorTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    /** Represent dimension token value either as reference or as plain representation */
+    representDimensionTokenValue(value: AnyDimensionTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
     /** Represent text token value either as reference or as plain representation */
-    representTextTokenValue(value: TextTokenValue, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    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;
     /** Represent typography token value either as reference or as plain representation */
-    representTypographyTokenValue(value: TypographyTokenValue, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representTypographyTokenValue(value: TypographyTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
     /** Represent border token value either as reference or as plain representation */
-    representBorderTokenValue(value: BorderTokenValue, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representBorderTokenValue(value: BorderTokenValue, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
     /** Represent shadow token value either as reference or as plain representation */
-    representShadowTokenValue(value: ShadowTokenValue, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representShadowTokenValue(values: ShadowTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
     /** Represent gradient token value either as reference or as plain representation */
-    representGradientTokenValue(value: GradientTokenValue, allTokens: Array<Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
+    representGradientTokenValue(value: GradientTokenValue[], allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): any;
     /** 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): Object;
+    tokenWrapper(token: Token, value: any, 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(token: Token, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): string;
+    referenceName(referenceId: string, allTokens: Map<string, Token>, allGroups: Array<TokenGroup>, options: TokenJSONBuilderOptionsInternal): string;
     /** Retrieve safe token name made out of normal token name
      * This replace spaces with dashes, also change anything non-alphanumeric char to it as well.
      * For example, ST&RK Industries will be changed to st-rk-industries
@@ -67,11 +59,10 @@ export declare class TokenJSONElementTransformer {
      * This replace spaces with dashes, also change anything non-alphanumeric char to it as well.
      * For example, ST&RK Industries will be changed to st-rk-industries
      */
-    safeGroupName(group: TokenGroup, naming: JSONBuilderNamingOption): string;
+    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): "border" | "color" | "font" | "gradient" | "measure" | "radius" | "shadow" | "text" | "typography";
+    typeLabel(type: TokenType): "color" | "gradient" | "typography" | "border" | "textCase" | "textDecoration" | "measure" | "shadow" | "text" | "visibility";
     /** Retrieve chain of groups up to a specified group, ordered from parent to children */
-    referenceGroupChain(containingGroup: TokenGroup): Array<TokenGroup>;
-    groupIsAbstract(group: TokenGroup): boolean;
+    referenceGroupChain(containingGroup: TokenGroup, allGroups: Array<TokenGroup>): Array<TokenGroup>;
 }

package/build/sdk-typescript/src/tools/markdown-transform/SDKToolsMarkdownTransform.d.ts

@@ -1,7 +1,7 @@
-import { DesignSystemVersion } from '../../core/SDKDesignSystemVersion';
-import { DocumentationPageBlockType } from '../../exports';
-import { DocumentationPage } from '../../model/documentation/SDKDocumentationPage';
-import { MarkdownTransformBlock } from './SDKToolsMarkdownTransformBlock';
+import { Supernova } from "../../core/SDKSupernova";
+import { DocumentationPage } from "../../model/documentation/SDKDocumentationPage";
+import { DocumentationPageBlockType } from "../../model/enums/SDKDocumentationPageBlockType";
+import { MarkdownTransformBlock } from "./SDKToolsMarkdownTransformBlock";
 /** Output markdown mode. Commonmark and GitHub is currently supported */
 export declare enum MarkdownTransformType {
     commonmark = "commonmark",
@@ -11,8 +11,7 @@ export declare enum MarkdownTransformType {
 export declare class MarkdownTransform {
     conversionType: MarkdownTransformType;
     blockTransformer: MarkdownTransformBlock;
-    version: DesignSystemVersion;
-    constructor(type: MarkdownTransformType, version: DesignSystemVersion);
+    constructor(type: MarkdownTransformType, instance: Supernova, designSystemId: string, workspaceId: string, versionId: string);
     /** Converts entire definition of the page, including its metadata like title and description, to markdown */
     convertPageToMarkdown(page: DocumentationPage): Promise<string>;
     /** Creates flattened structure of the blocks, even from the contained blocks, so it is easier to iterate through them */

package/build/sdk-typescript/src/tools/markdown-transform/SDKToolsMarkdownTransformBlock.d.ts

@@ -1,49 +1,49 @@
-import { DesignSystemVersion } from '../../core/SDKDesignSystemVersion';
-import { DocumentationPageBlockAssets } from '../../model/documentation/blocks/SDKDocumentationPageBlockAssets';
-import { DocumentationPageBlockCallout } from '../../model/documentation/blocks/SDKDocumentationPageBlockCallout';
-import { DocumentationPageBlockCode } from '../../model/documentation/blocks/SDKDocumentationPageBlockCode';
-import { DocumentationPageBlockColumn } from '../../model/documentation/blocks/SDKDocumentationPageBlockColumn';
-import { DocumentationPageBlockColumnItem } from '../../model/documentation/blocks/SDKDocumentationPageBlockColumnItem';
-import { DocumentationPageBlockCustom } from '../../model/documentation/blocks/SDKDocumentationPageBlockCustom';
-import { DocumentationPageBlockDivider } from '../../model/documentation/blocks/SDKDocumentationPageBlockDivider';
-import { DocumentationPageBlockEmbedFigma } from '../../model/documentation/blocks/SDKDocumentationPageBlockEmbedFigma';
-import { DocumentationPageBlockEmbedGeneric } from '../../model/documentation/blocks/SDKDocumentationPageBlockEmbedGeneric';
-import { DocumentationPageBlockEmbedLink } from '../../model/documentation/blocks/SDKDocumentationPageBlockEmbedLink';
-import { DocumentationPageBlockEmbedStorybook } from '../../model/documentation/blocks/SDKDocumentationPageBlockEmbedStorybook';
-import { DocumentationPageBlockEmbedYoutube } from '../../model/documentation/blocks/SDKDocumentationPageBlockEmbedYoutube';
-import { DocumentationPageBlockFrames } from '../../model/documentation/blocks/SDKDocumentationPageBlockFrames';
-import { DocumentationPageBlockHeading } from '../../model/documentation/blocks/SDKDocumentationPageBlockHeading';
-import { DocumentationPageBlockImage } from '../../model/documentation/blocks/SDKDocumentationPageBlockImage';
-import { DocumentationPageOrderedList } from '../../model/documentation/blocks/SDKDocumentationPageBlockOrderedList';
-import { DocumentationPageBlockQuote } from '../../model/documentation/blocks/SDKDocumentationPageBlockQuote';
-import { DocumentationPageBlockRenderCode } from '../../model/documentation/blocks/SDKDocumentationPageBlockRenderCode';
-import { DocumentationPageBlockShortcuts } from '../../model/documentation/blocks/SDKDocumentationPageBlockShortcuts';
-import { DocumentationPageBlockTab } from '../../model/documentation/blocks/SDKDocumentationPageBlockTab';
-import { DocumentationPageBlockTabItem } from '../../model/documentation/blocks/SDKDocumentationPageBlockTabItem';
-import { DocumentationPageBlockTable } from '../../model/documentation/blocks/SDKDocumentationPageBlockTable';
-import { DocumentationPageBlockTableCell } from '../../model/documentation/blocks/SDKDocumentationPageBlockTableCell';
-import { DocumentationPageBlockTableRow } from '../../model/documentation/blocks/SDKDocumentationPageBlockTableRow';
-import { DocumentationPageBlockText } from '../../model/documentation/blocks/SDKDocumentationPageBlockText';
-import { DocumentationPageBlockToken } from '../../model/documentation/blocks/SDKDocumentationPageBlockToken';
-import { DocumentationPageBlockTokenGroup } from '../../model/documentation/blocks/SDKDocumentationPageBlockTokenGroup';
-import { DocumentationPageBlockTokenList } from '../../model/documentation/blocks/SDKDocumentationPageBlockTokenList';
-import { DocumentationPageUnorderedList } from '../../model/documentation/blocks/SDKDocumentationPageBlockUnorderedList';
-import { DocumentationPage } from '../../model/documentation/SDKDocumentationPage';
-import { DocumentationPageBlock } from '../../model/documentation/SDKDocumentationPageBlock';
-import { MarkdownTransformType } from './SDKToolsMarkdownTransform';
+import { Supernova } from "../../core/SDKSupernova";
+import { DocumentationPageBlockAssets } from "../../model/documentation/blocks/SDKDocumentationPageBlockAssets";
+import { DocumentationPageBlockCallout } from "../../model/documentation/blocks/SDKDocumentationPageBlockCallout";
+import { DocumentationPageBlockCode } from "../../model/documentation/blocks/SDKDocumentationPageBlockCode";
+import { DocumentationPageBlockColumn } from "../../model/documentation/blocks/SDKDocumentationPageBlockColumn";
+import { DocumentationPageBlockColumnItem } from "../../model/documentation/blocks/SDKDocumentationPageBlockColumnItem";
+import { DocumentationPageBlockEmbedFigma } from "../../model/documentation/blocks/SDKDocumentationPageBlockEmbedFigma";
+import { DocumentationPageBlockEmbedGeneric } from "../../model/documentation/blocks/SDKDocumentationPageBlockEmbedGeneric";
+import { DocumentationPageBlockEmbedLink } from "../../model/documentation/blocks/SDKDocumentationPageBlockEmbedLink";
+import { DocumentationPageBlockEmbedStorybook } from "../../model/documentation/blocks/SDKDocumentationPageBlockEmbedStorybook";
+import { DocumentationPageBlockEmbedYoutube } from "../../model/documentation/blocks/SDKDocumentationPageBlockEmbedYoutube";
+import { DocumentationPageBlockFrames } from "../../model/documentation/blocks/SDKDocumentationPageBlockFrames";
+import { DocumentationPageBlockHeading } from "../../model/documentation/blocks/SDKDocumentationPageBlockHeading";
+import { DocumentationPageBlockImage } from "../../model/documentation/blocks/SDKDocumentationPageBlockImage";
+import { DocumentationPageOrderedList } from "../../model/documentation/blocks/SDKDocumentationPageBlockOrderedList";
+import { DocumentationPageBlockQuote } from "../../model/documentation/blocks/SDKDocumentationPageBlockQuote";
+import { DocumentationPageBlockRenderCode } from "../../model/documentation/blocks/SDKDocumentationPageBlockRenderCode";
+import { DocumentationPageBlockShortcuts } from "../../model/documentation/blocks/SDKDocumentationPageBlockShortcuts";
+import { DocumentationPageBlockTab } from "../../model/documentation/blocks/SDKDocumentationPageBlockTab";
+import { DocumentationPageBlockTabItem } from "../../model/documentation/blocks/SDKDocumentationPageBlockTabItem";
+import { DocumentationPageBlockTable } from "../../model/documentation/blocks/SDKDocumentationPageBlockTable";
+import { DocumentationPageBlockTableCell } from "../../model/documentation/blocks/SDKDocumentationPageBlockTableCell";
+import { DocumentationPageBlockText } from "../../model/documentation/blocks/SDKDocumentationPageBlockText";
+import { DocumentationPageBlockToken } from "../../model/documentation/blocks/SDKDocumentationPageBlockToken";
+import { DocumentationPageBlockTokenGroup } from "../../model/documentation/blocks/SDKDocumentationPageBlockTokenGroup";
+import { DocumentationPageBlockTokenList } from "../../model/documentation/blocks/SDKDocumentationPageBlockTokenList";
+import { DocumentationPageUnorderedList } from "../../model/documentation/blocks/SDKDocumentationPageBlockUnorderedList";
+import { DocumentationPage } from "../../model/documentation/SDKDocumentationPage";
+import { DocumentationPageBlock } from "../../model/documentation/SDKDocumentationPageBlock";
+import { MarkdownTransformType } from "./SDKToolsMarkdownTransform";
 /** Markdown block transformer */
 export declare class MarkdownTransformBlock {
     private transformType;
     private utilTransformer;
-    private version;
+    private instance;
+    private designSystemId;
+    private versionId;
+    private workspaceId;
     newlineSeparator: string;
-    constructor(type: MarkdownTransformType, version: DesignSystemVersion);
+    constructor(type: MarkdownTransformType, instance: Supernova, designSystemId: string, workspaceId: string, versionId: string);
     /** Converts a single block - depending on the type - to a markdown definition of specific type */
     convertBlockToMarkdown(block: DocumentationPageBlock, pageContext: DocumentationPage): Promise<string | null>;
     convertHeadingBlock(block: DocumentationPageBlockHeading): string | null;
     convertCalloutBlock(block: DocumentationPageBlockCallout): string | null;
     convertQuoteBlock(block: DocumentationPageBlockQuote): string | null;
-    convertDividerBlock(block: DocumentationPageBlockDivider): string | null;
+    convertDividerBlock(): string | null;
     convertImageBlock(block: DocumentationPageBlockImage): string | null;
     convertOrderedListBlock(block: DocumentationPageOrderedList): string | null;
     convertUnorderedListBlock(block: DocumentationPageUnorderedList): string | null;
@@ -64,12 +64,12 @@ export declare class MarkdownTransformBlock {
     convertShortcutsBlock(block: DocumentationPageBlockShortcuts, pageContext: DocumentationPage): Promise<string | null>;
     private relativePathToPage;
     convertTableBlock(block: DocumentationPageBlockTable, pageContext: DocumentationPage): Promise<string | null>;
-    convertTableRowBlock(block: DocumentationPageBlockTableRow): string | null;
+    convertTableRowBlock(): string | null;
     convertTableCellBlock(block: DocumentationPageBlockTableCell, pageContext: DocumentationPage): Promise<string | null>;
     convertTabsBlock(block: DocumentationPageBlockTab, pageContext: DocumentationPage): Promise<string | null>;
     convertTabItemBlock(block: DocumentationPageBlockTabItem, pageContext: DocumentationPage): Promise<string | null>;
     convertColumnBlock(block: DocumentationPageBlockColumn, pageContext: DocumentationPage): Promise<string | null>;
     convertColumnItemBlock(block: DocumentationPageBlockColumnItem, pageContext: DocumentationPage): Promise<string | null>;
-    convertCustomBlock(block: DocumentationPageBlockCustom): string | null;
-    convertURLBlock(block: DocumentationPageBlockEmbedGeneric, userAction: string, showLink: boolean): string | null;
+    convertCustomBlock(): string | null;
+    convertURLBlock(block: DocumentationPageBlockEmbedGeneric, userAction: string): string | null;
 }

package/build/sdk-typescript/src/tools/markdown-transform/SDKToolsMarkdownTransformUtil.d.ts

@@ -1,14 +1,10 @@
-import { DocumentationRichText } from '../../model/documentation/SDKDocumentationRichText';
-import { MarkdownTransformType } from './SDKToolsMarkdownTransform';
-import { DocumentationPageBlockText } from '../../model/documentation/blocks/SDKDocumentationPageBlockText';
-import { DesignSystemVersion } from '../../core/SDKDesignSystemVersion';
-import { Token } from '../..';
+import { DocumentationPageBlockText } from "../../model/documentation/blocks/SDKDocumentationPageBlockText";
+import { DocumentationRichText } from "../../model/documentation/SDKDocumentationRichText";
+import { Token } from "../../model/tokens/SDKToken";
 /** Markdown block transformer */
 export declare class MarkdownTransformUtil {
-    private transformType;
-    private version;
     private tokenTransformer;
-    constructor(type: MarkdownTransformType, version: DesignSystemVersion);
+    constructor();
     /** Converts rich text block to markdown
      *
      * This is very naive implementation and will break in complicated cases, like double control characters of the same type next to each other

package/build/sdk-typescript/src/tools/search-index/SDKToolsDocSearch.d.ts

@@ -1,5 +1,5 @@
-import Fuse from "fuse.js";
 import { DocumentationPage } from "../../model/documentation/SDKDocumentationPage";
+import Fuse from "fuse.js";
 export declare enum DocSearchResultDataType {
     contentBlock = "contentBlock",
     sectionHeader = "sectionHeader",

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

@@ -0,0 +1,17 @@
+import { Token } from "../../model/tokens/SDKToken";
+import { AnyMultiLayerToken, AnySingleLayerToken } from "../../model/tokens/SDKTokenValue";
+import { TokenUtilPreviewMetadata, TokenUtilPreviewReferenceInfo, TokenUtilPreviewResolvedStyle, TokenUtilPreviewTokenType, TokenUtilPreviewTokenValueSegment } from "./TokenUtilPreviewTypes";
+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;
+    /** Generates style required for rendering of the preview. Only usable with Supernova preview */
+    static tokenPreviewStyle(token: Token): 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 */
+    static tokenReferenceInfoForSingleLayerToken(token: AnySingleLayerToken, allTokens: Map<string, Token>): TokenUtilPreviewReferenceInfo;
+    /** Generates per-value description of passed token. Only usable with Supernova preview */
+    static tokenReferenceInfoForMultiLayerToken(token: AnyMultiLayerToken, layerIndex: number, allTokens: Map<string, Token>): TokenUtilPreviewReferenceInfo;
+}

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

@@ -0,0 +1,8 @@
+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;
+    displayValue(token: Token): string;
+    tokenTypeToPreviewType(type: TokenType): TokenUtilPreviewTokenType;
+}

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

@@ -0,0 +1,10 @@
+import { Token } from "../../model/tokens/SDKToken";
+import { AnyMultiLayerToken } from "../../model/tokens/SDKTokenValue";
+import { TokenUtilPreviewReferenceInfo } from "./TokenUtilPreviewTypes";
+export declare class TokenUtilPreviewReferenceInfoGenerator {
+    resolvedInfoForSingleLayerToken(token: Token, allTokens: Map<string, Token>): TokenUtilPreviewReferenceInfo;
+    resolvedInfoForMultiLayerToken(token: AnyMultiLayerToken, layerIndex: number, allTokens: Map<string, Token>): TokenUtilPreviewReferenceInfo;
+    private label;
+    private textCaseToString;
+    private textDecorationToString;
+}

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

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

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

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

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

@@ -0,0 +1,68 @@
+export type TokenUtilPreviewTokenValueSegment = {
+    value: string;
+    referencedName?: string;
+    prefersReferenceName?: boolean;
+};
+export type TokenUtilPreviewTokenType = "blur" | "border" | "borderWidth" | "color" | "copy" | "fontFamily" | "fontSize" | "fontWeight" | "dimension" | "duration" | "gradient" | "lineHeight" | "letterSpacing" | "opacity" | "paragraphSpacing" | "radius" | "shadow" | "size" | "space" | "string" | "textCase" | "textDecoration" | "typography" | "visibility" | "zIndex";
+export type TokenUtilPreviewMetadata = {
+    displayValue: string;
+    referencedTo?: string;
+    tokenType: TokenUtilPreviewTokenType;
+} & ({
+    meta?: null;
+} | TokenUtilPreviewShadowTokenPreview | TokenUtilPreviewTypographyTokenPreview | TokenUtilPreviewDimensionTokenPreview | TokenUtilPreviewBlurTokenPreview);
+export type TokenUtilPreviewShadowTokenPreview = {
+    meta: ShadowTokenMetadata;
+};
+export type TokenUtilPreviewTypographyTokenPreview = {
+    meta: TypographyTokenMetadata;
+};
+export type TokenUtilPreviewDimensionTokenPreview = {
+    meta: DimensionTokenMetadata;
+};
+export type TokenUtilPreviewBlurTokenPreview = {
+    meta: BlurTokenMetadata;
+};
+export type TokenUtilPreviewResolvedStyle = {
+    background?: string;
+    blur?: string;
+    borderStyle?: "solid" | "dashed" | "dotted";
+    borderWidth?: string;
+    borderColor?: string;
+    borderRadius?: string;
+    boxShadow?: string;
+    fontFamily?: string;
+    fontSize?: string;
+    fontWeight?: string;
+    letterSpacing?: string;
+    lineHeight?: string;
+    opacity?: string;
+    textTransform?: string;
+    textDecoration?: string;
+    width?: string;
+};
+export type ShadowTokenMetadata = {
+    x: number;
+    y: number;
+    type: "inner" | "drop";
+};
+export type TypographyTokenMetadata = {
+    fontSize: DimensionTokenMetadata;
+};
+export type DimensionTokenMetadata = {
+    value: number;
+    unit: string;
+};
+export type BlurTokenMetadata = {
+    type: "layer" | "background";
+};
+export type TokenUtilPreviewReferenceInfo = {
+    alwaysShown: Array<TokenUtilPreviewReferenceInfoPiece>;
+    optionallyShown: Array<TokenUtilPreviewReferenceInfoPiece>;
+};
+export type TokenUtilPreviewReferenceInfoPiece = {
+    key?: Array<TokenUtilPreviewTokenValueSegment>;
+    value?: Array<TokenUtilPreviewTokenValueSegment>;
+    icon?: string;
+    fullWidth?: boolean;
+};

package/build/sdk-typescript/src/tools/token-transform/SDKToolsTokenTransform.d.ts

@@ -1,9 +1,8 @@
-import { Token } from '../../model/tokens/SDKToken';
-import { ColorToken } from '../../model/tokens/SDKColorToken';
-import { BlurTokenValue, BorderTokenValue, ColorTokenValue, FontTokenValue, GenericTokenValue, GradientTokenValue, MeasureTokenValue, RadiusTokenValue, ShadowTokenValue, TextTokenValue, TypographyTokenValue } from '../../model/tokens/SDKTokenValue';
+import { AnyDimensionTokenValue, AnyOptionTokenValue, AnyStringTokenValue, BlurTokenValue, BorderTokenValue, ColorTokenValue, GradientTokenValue, ShadowTokenValue, TypographyTokenValue } from "../../model/tokens/SDKTokenValue";
+import { ColorToken } from "../../model/tokens/SDKColorToken";
+import { Token } from "../../model/tokens/SDKToken";
 /** Token data transformer. Use for direct representation of token to other representations, such as CSS, rgb etc. More transformers will be added over time */
 export declare class TokenTransform {
-    constructor();
     /** Converts a single token to CSS definition. Values are always resolved to plain values, references to other tokens are not yet supported */
     tokenToCSS(token: Token): string;
     /** Converts token to appropriate css variable definition --(name): css_definition */
@@ -13,24 +12,21 @@ export declare class TokenTransform {
     /** Converts border token value to css definition */
     borderTokenToCSS(value: BorderTokenValue): string;
     /** Converts shadow token value to css definition */
+    shadowsTokenToCSS(value: ShadowTokenValue[]): string;
     shadowTokenToCSS(value: ShadowTokenValue): string;
     /** Converts typography token value to css definition */
     typographyTokenToCSS(value: TypographyTokenValue): string;
     /** Converts border token value to css definition */
     blurTokenToCSS(value: BlurTokenValue): string;
     /** Converts border token value to css definition */
-    measureTokenToCSS(value: MeasureTokenValue): string;
+    dimensionTokenToCSS(value: AnyDimensionTokenValue): string;
     private unitToCSS;
-    /** Converts border token value to css definition */
-    radiusTokenToCSS(value: RadiusTokenValue): string;
+    gradientsTokenToCSS(value: GradientTokenValue[]): string;
     /** Converts gradient token value to css definition */
     gradientTokenToCSS(value: GradientTokenValue): string;
-    /** Converts font token value to css definition */
-    fontTokenToCSS(value: FontTokenValue): string;
-    /** Converts generic token value to css definition */
-    genericTokenToCSS(value: GenericTokenValue): string;
     /** Converts generic token value to css definition */
-    textTokenToCSS(value: TextTokenValue): string;
+    stringTokenToCSS(value: AnyStringTokenValue): string;
+    optionTokenToCSS(value: AnyOptionTokenValue): string;
     /** Converts a single color token to #hheexx or #hheexxaa */
     colorTokenToHEXorHEXA(colorToken: ColorToken): string;
     /** Converts a single color token to rgba(x,x,x,x)  */

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

@@ -0,0 +1,113 @@
+import { AnyToken, DTProcessedTokenNode, TokenGroup, TokenTheme } from "../exports";
+import { ElementProperty } from "../model/elements/SDKElementProperty";
+import { TokenType } from "../model/enums/SDKTokenType";
+import { BlurToken } from "../model/tokens/SDKBlurToken";
+import { BorderToken } from "../model/tokens/SDKBorderToken";
+import { ColorToken } from "../model/tokens/SDKColorToken";
+import { BorderWidthToken, DimensionToken, DurationToken, FontSizeToken, LetterSpacingToken, LineHeightToken, OpacityToken, ParagraphSpacingToken, RadiusToken, SizeToken, SpaceToken, ZIndexToken } from "../model/tokens/SDKDimensionToken";
+import { GradientToken } from "../model/tokens/SDKGradientToken";
+import { ShadowToken } from "../model/tokens/SDKShadowToken";
+import { FontFamilyToken, FontWeightToken, ProductCopyToken, StringToken } from "../model/tokens/SDKStringToken";
+import { TextCaseToken } from "../model/tokens/SDKTextCaseToken";
+import { TextDecorationToken } from "../model/tokens/SDKTextDecorationToken";
+import { Token } from "../model/tokens/SDKToken";
+import { TypographyToken } from "../model/tokens/SDKTypographyToken";
+import { VisibilityToken } from "../model/tokens/SDKVisibilityToken";
+type TokenMapCompletenessTypeCheck<T extends {
+    [key in TokenType]: AnyToken;
+}> = T;
+type ActualTypeToTokenMap = {
+    [TokenType.color]: ColorToken;
+    [TokenType.typography]: TypographyToken;
+    [TokenType.blur]: BlurToken;
+    [TokenType.border]: BorderToken;
+    [TokenType.shadow]: ShadowToken;
+    [TokenType.gradient]: GradientToken;
+    [TokenType.string]: StringToken;
+    [TokenType.productCopy]: ProductCopyToken;
+    [TokenType.fontFamily]: FontFamilyToken;
+    [TokenType.fontWeight]: FontWeightToken;
+    [TokenType.textCase]: TextCaseToken;
+    [TokenType.textDecoration]: TextDecorationToken;
+    [TokenType.visibility]: VisibilityToken;
+    [TokenType.borderWidth]: BorderWidthToken;
+    [TokenType.dimension]: DimensionToken;
+    [TokenType.size]: SizeToken;
+    [TokenType.space]: SpaceToken;
+    [TokenType.opacity]: OpacityToken;
+    [TokenType.fontSize]: FontSizeToken;
+    [TokenType.lineHeight]: LineHeightToken;
+    [TokenType.letterSpacing]: LetterSpacingToken;
+    [TokenType.paragraphSpacing]: ParagraphSpacingToken;
+    [TokenType.radius]: RadiusToken;
+    [TokenType.duration]: DurationToken;
+    [TokenType.zIndex]: ZIndexToken;
+};
+export type TokenTypeMapToken = TokenMapCompletenessTypeCheck<ActualTypeToTokenMap>;
+export declare class TokenUtils {
+    /** Map tokens for lookup */
+    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;
+    /** 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 */
+    static createDefaultTokenTheme(versionId: string, brandId: string): TokenTheme;
+    /** Creates a new token for a given token type. Default values will be used for all properties */
+    static createDefaultToken<T extends TokenType>(type: T, versionId: string, brandId: string, properties: Array<ElementProperty>): TokenTypeMapToken[T];
+    /** Creates a new default color token */
+    private static createDefaultColorToken;
+    /** Creates a new default typography token */
+    private static createDefaultTypographyToken;
+    /** Creates a new default typography token */
+    private static createDefaultGradientToken;
+    /** Creates a new default dimension token */
+    private static createDefaultDimensionToken;
+    /** Creates a new default size token */
+    private static createDefaultSizeToken;
+    /** Creates a new default space token */
+    private static createDefaultSpaceToken;
+    /** Creates a new default opacity token */
+    private static createDefaultOpacityToken;
+    /** Creates a new default line height token */
+    private static createDefaultLineHeightToken;
+    /** Creates a new default letter spacing token */
+    private static createDefaultLetterSpacingToken;
+    /** Creates a new default paragraph spacing token */
+    private static createDefaultParagraphSpacingToken;
+    /** Creates a new default border token */
+    private static createDefaultBorderWidthToken;
+    /** Creates a new default border radius token */
+    private static createDefaultRadiusToken;
+    /** Creates a new default font size token */
+    private static createDefaultFontSizeToken;
+    /** Creates a new default font family token */
+    private static createDefaultFontFamilyToken;
+    /** Creates a new default font weight token */
+    private static createDefaultFontWeightToken;
+    /** Creates a new default duration token */
+    private static createDefaultDurationToken;
+    /** Creates a new default z-index token */
+    private static createDefaultZIndexToken;
+    /** Creates a new default text case token */
+    private static createDefaultTextCaseToken;
+    /** Creates a new default text case token */
+    private static createDefaultTextDecorationToken;
+    /** Creates a new default visibility token */
+    private static createDefaultVisibilityToken;
+    /** Creates a new default generic token */
+    private static createDefaultBlurToken;
+    /** Creates a new default generic token */
+    private static createDefaultStringToken;
+    /** Creates a new default generic token */
+    private static createDefaultProductCopyToken;
+    /** Creates a new default generic token */
+    private static createDefaultShadowToken;
+    /** Creates a new default generic token */
+    private static createDefaultBorderToken;
+    static replaceIdAcrossAllPossibleReferences(override: DTProcessedTokenNode, newId: string, allTokens: Array<DTProcessedTokenNode>): void;
+    static replaceIdAcrossAllPossibleReferencesWithTokens(currentId: string, newId: string, allTokens: Array<Token>): void;
+    static replaceIdForComplexTokens(token: AnyToken, currentId: string, newId: string): void;
+}
+export {};

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

@@ -0,0 +1,3 @@
+export declare class UnreachableCaseError extends Error {
+    constructor(val: never, message?: string);
+}