@supernova-studio/supernova-sdk-beta 1.6.42 → 1.6.45

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

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

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

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

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

@@ -10,8 +10,8 @@ export declare class TypographyToken extends Token {
     value: TypographyTokenValue;
     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;
+    static create(versionId: string, brandId: string, name: string, description: string, value: object, alias: TypographyToken | null, referenceResolver: DTTokenReferenceResolver, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>, reference?: string): TypographyToken;
+    static typographyValueFromDefinition(definition: any, referenceResolver: DTTokenReferenceResolver, reference?: string): TypographyTokenValue;
     toWriteObject(): TypographyTokenRemoteModel;
     static valueToWriteObject(value: TypographyTokenValue): {
         aliasTo: string | undefined;

package/build/sdk-typescript/src/model/users/SDKUserProfile.d.ts

@@ -1,5 +1,7 @@
-export type UserOnboardingDepartmentType = "Design" | "Engineering" | "Brand" | "Other";
-export type UserOnboardingJobLevelType = "Executive" | "Manager" | "IndividualContributor" | "Other";
+export type UserOnboardingDepartmentType = (typeof UserOnboardingDepartmentTypes)[number];
+export declare const UserOnboardingDepartmentTypes: readonly ["Design", "Product", "Engineering", "Brand", "Other"];
+export type UserOnboardingJobLevelType = (typeof UserOnboardingJobLevelTypes)[number];
+export declare const UserOnboardingJobLevelTypes: readonly ["Executive", "Manager", "IndividualContributor", "Other"];
 export type UserProfileRemoteModel = {
     name?: string;
     nickname?: string;

package/build/sdk-typescript/src/model/workspaces/SDKWorkspaceIntegration.d.ts

@@ -0,0 +1,75 @@
+import { OAuth2IntegrationTypes } from "./SDKWorkspaceIntegrationOauthRequest";
+export type WorkspaceIntegrationsRemoteModel = {
+    integrations: Array<WorkspaceIntegrationType>;
+};
+export type WorkspaceLinkedIntegrations = {
+    Figma?: WorkspaceIntegrationType[];
+    FigmaVariablesPlugin?: WorkspaceIntegrationType[];
+    Github?: WorkspaceIntegrationType[];
+    TokenStudio?: WorkspaceIntegrationType[];
+    Gitlab?: WorkspaceIntegrationType[];
+    Azure?: WorkspaceIntegrationType[];
+    Bitbucket?: WorkspaceIntegrationType[];
+};
+type WorkspaceIntegrationCredentialProfile = {
+    avatarUrl: string;
+    id: string;
+    handle: string;
+    email: string;
+};
+type WorkspaceIntegrationUser = {
+    id: string;
+    email: string;
+    name: string;
+    avatar?: string;
+};
+type WorkspaceIntegrationCredential = {
+    id: string;
+    integrationId: number;
+    userId: string;
+    createdAt: string;
+    accessToken: string;
+    refreshToken: string;
+    type: "OAuth2" | "PAT" | "GithubApp";
+    tokenName?: string;
+    profile: WorkspaceIntegrationCredentialProfile;
+    user: WorkspaceIntegrationUser;
+};
+type WorkspaceIntegrationDesignSystem = {
+    brandId: string;
+    designSystemId: string;
+    date: string;
+    title?: string;
+    user: WorkspaceIntegrationUser;
+};
+export type WorkspaceIntegrationType = {
+    id: string;
+    createdAt: string;
+    type: keyof WorkspaceLinkedIntegrations;
+    workspaceId: string;
+    integrationCredentials?: Array<WorkspaceIntegrationCredential>;
+    integrationDesignSystems?: Array<WorkspaceIntegrationDesignSystem>;
+};
+export type WorkspaceIntegrationTypeOnlyCredentials = Omit<WorkspaceIntegrationType, "integrationDesignSystems"> & {
+    type: OAuth2IntegrationTypes;
+};
+export type WorkspaceIntegrationTypeOnlyDesignSystems = Omit<WorkspaceIntegrationType, "integrationCredentials"> & {
+    type: keyof Pick<WorkspaceLinkedIntegrations, "FigmaVariablesPlugin" | "TokenStudio">;
+};
+export type WorkspaceIntegrationCredentialType = NonNullable<WorkspaceIntegrationType["integrationCredentials"]>[0];
+export type WorkspaceIntegrationDesignType = NonNullable<WorkspaceIntegrationType["integrationDesignSystems"]>[0];
+export declare class WorkspaceIntegration implements WorkspaceIntegrationType {
+    id: string;
+    createdAt: string;
+    type: keyof WorkspaceLinkedIntegrations;
+    workspaceId: string;
+    integrationCredentials?: Array<WorkspaceIntegrationCredential>;
+    integrationDesignSystems?: Array<WorkspaceIntegrationDesignSystem>;
+    constructor(model: WorkspaceIntegrationType);
+}
+export declare class WorkspaceIntegrations {
+    /** List of integrations of the workspace */
+    integrations: Array<WorkspaceIntegrationType>;
+    constructor(model: WorkspaceIntegrationsRemoteModel);
+}
+export {};

package/build/sdk-typescript/src/model/workspaces/SDKWorkspaceIntegrationAccessToken.d.ts

@@ -0,0 +1,12 @@
+export type AccessTokenIntegrationTypes = "Github" | "Gitlab" | "Bitbucket" | "Azure";
+export type WorkspaceIntegrationAccessTokenPayload = {
+    userId: string;
+    type: AccessTokenIntegrationTypes;
+    token: {
+        token_name: string;
+        access_token: string;
+        custom_url?: string;
+        token_bitbucket_username?: string;
+        token_azure_organization_name?: string;
+    };
+};

package/build/sdk-typescript/src/model/workspaces/SDKWorkspaceIntegrationOauthRequest.d.ts

@@ -0,0 +1,9 @@
+export type OAuth2IntegrationTypes = "Figma" | "Github" | "Gitlab" | "Bitbucket" | "Azure";
+export type WorkspaceIntegrationOauthRequestRemoteModel = {
+    url: string;
+};
+export declare class WorkspaceIntegrationOauthRequest {
+    /** Redirect url for oauth of given integration */
+    url: string;
+    constructor(model: WorkspaceIntegrationOauthRequestRemoteModel);
+}

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

@@ -1,7 +1,12 @@
 import { Supernova } from "../core/SDKSupernova";
 import { RemoteVersionIdentifier, RemoteWorkspaceVersionIdentifier } from "../core/areas/SDKRemoteIdentifiers";
+import { ExecutionContext } from "ava";
 export declare const testInstance: Supernova;
 export declare const testVersionIdentifier: RemoteVersionIdentifier;
 export declare const testWorkspaceVersionIdentifier: RemoteWorkspaceVersionIdentifier;
 export declare const randomAlphabeticalOnlyIdentifier: (length: number) => string;
 export declare const randomNumberInRange: (min: number, max: number) => number;
+export declare const retryAssertAsync: (t: ExecutionContext<unknown>, assertFn: (ctx: ExecutionContext<unknown>) => Promise<any>, beforeFn?: (ctx: ExecutionContext<unknown>) => Promise<any>, retriesLeft?: number, interval?: number) => Promise<any>;
+export declare const testRetry: (title: string, fn: (ctx: ExecutionContext<unknown>) => Promise<any>, beforeFn?: (ctx: ExecutionContext<unknown>) => Promise<any>, attempts?: number, interval?: number) => Promise<void>;
+export declare const testRetryBefore: (beforeFn: (ctx: ExecutionContext<unknown>) => Promise<any>) => (title: string, fn: (ctx: ExecutionContext<unknown>) => Promise<any>, attempts?: number, interval?: number) => Promise<void>;
+export declare const testAva: import("ava").TestFn;

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

@@ -2,7 +2,7 @@ import { BorderPosition, ColorToken, ShadowType, TextCase, TextDecoration, Unit
 import { BorderStyle } from "../model/enums/SDKBorderStyle";
 import { StringTokenType } from "../model/enums/SDKTokenType";
 import { Token } from "../model/tokens/SDKToken";
-export declare const validateToken: (t: any, tokens: Token[], name: string, hex: string, opacity?: number) => void;
+export declare const validateToken: (t: any, tokens: Token[], name: string, hex: string, opacity?: number, aliasName?: string) => void;
 export declare const validateDimensionToken: (t: any, tokens: Token[], name: string, measure: number, unit: Unit) => void;
 export declare const validateStringToken: (t: any, tokens: Token[], name: string, text: string, type: StringTokenType) => void;
 export declare const validateOptionToken: (t: any, tokens: Token[], name: string, text: string) => void;
@@ -38,7 +38,7 @@ export declare const validateShadowTokenRef: (t: any, tokens: Token[], descripti
     spread: number;
     type: ShadowType;
 }>) => void;
-export declare const validateShadowTokenRefMultiple: (t: any, tokens: Token[], description: string, layers: {
+export declare const validateShadowTokenRefMultiple: (t: any, tokens: Token[], description: string, layers: Array<{
     refName: string;
     layers: Array<{
         hex: string;
@@ -48,7 +48,7 @@ export declare const validateShadowTokenRefMultiple: (t: any, tokens: Token[], d
         spread: number;
         type: ShadowType;
     }>;
-}[]) => void;
+}>) => void;
 export declare const validateShadowTokenInnerRef: (t: any, tokens: Token[], name: string, value: {
     hex: string;
     x: number;

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

@@ -6,7 +6,7 @@ import { TokenTheme } from "../../model/themes/SDKTokenTheme";
 import { Token } from "../../model/tokens/SDKToken";
 import { AnyToken } from "../../model/tokens/SDKTokenValue";
 import { DTProcessedTokenNode } from "./utilities/SDKDTJSONConverter";
-import { DTPluginToSupernovaMap, DTPluginToSupernovaMapPack, DTPluginToSupernovaSettings } from "./utilities/SDKDTMapLoader";
+import { DTPluginPreciseCopyStrategy, DTPluginThemeOverrideStrategy, DTPluginToSupernovaMap, DTPluginToSupernovaMapPack, DTPluginToSupernovaSettings } from "./utilities/SDKDTMapLoader";
 import { DTTokenMergeDiff } from "./utilities/SDKDTTokenMerger";
 export type SupernovaToolsDesignTokensLoadingResult = {
     processedNodes: Array<DTProcessedTokenNode>;
@@ -40,13 +40,13 @@ export declare class SupernovaToolsDesignTokensPlugin {
         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 */
-    mergeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, write: boolean, verbose: boolean, preciseCopy: boolean): Promise<{
+    mergeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, write: boolean, verbose: boolean, preciseCopy: DTPluginPreciseCopyStrategy): Promise<{
         tokens: Array<Token>;
         groups: Array<TokenGroup>;
         diff: DTTokenMergeDiff;
     }>;
     /** Loads remote source connected to this tool, then creates the diff from the base tree and updates the associated theme. Can optionally write to the source as well */
-    mergeThemeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, theme: TokenTheme, write: boolean, verbose: boolean, preciseCopy?: boolean): Promise<{
+    mergeThemeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, theme: TokenTheme, write: boolean, verbose: boolean, preciseCopy?: DTPluginPreciseCopyStrategy, themeOverridesStrategy?: DTPluginThemeOverrideStrategy): Promise<{
         theme: TokenTheme;
         tokens: Array<Token>;
     }>;

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

@@ -6,6 +6,16 @@ export declare enum DTPluginToSupernovaMapType {
     theme = "theme",
     set = "set"
 }
+export declare enum DTPluginThemeOverrideStrategy {
+    default = "default",
+    aliasIsDifferent = "aliasIsDifferent"
+}
+export declare enum DTPluginPreciseCopyStrategy {
+    none = "none",// preciseCopy = false
+    deleteAll = "deleteAll",// preciseCopy = true
+    keepManualTokens = "keepManualTokens"
+}
+export declare const isPreciseCopyEnabled: (preciseCopy: DTPluginPreciseCopyStrategy) => boolean;
 export type DTPluginToSupernovaMap = {
     type: DTPluginToSupernovaMapType;
     pluginSets: Array<string> | null;
@@ -29,11 +39,13 @@ export type DTPluginToSupernovaMappingFile = {
     settings?: {
         verbose?: boolean;
         dryRun?: boolean;
-        preciseCopy?: boolean;
+        preciseCopy?: boolean | DTPluginPreciseCopyStrategy;
+        themeOverridesStrategy?: DTPluginThemeOverrideStrategy;
     };
 };
 export type DTPluginToSupernovaSettings = {
     verbose: boolean;
     dryRun: boolean;
-    preciseCopy: boolean;
+    preciseCopy: DTPluginPreciseCopyStrategy;
+    themeOverridesStrategy: DTPluginThemeOverrideStrategy;
 };

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

@@ -2,6 +2,7 @@ import { TokenGroup } from "../../../model/groups/SDKTokenGroup";
 import { TokenTheme } from "../../../model/themes/SDKTokenTheme";
 import { Token } from "../../../model/tokens/SDKToken";
 import { DTProcessedTokenNode } from "./SDKDTJSONConverter";
+import { DTPluginPreciseCopyStrategy, DTPluginThemeOverrideStrategy } from "./SDKDTMapLoader";
 export type DTThemeMergeDiff = {
     toUpdate: Array<DTProcessedTokenNode>;
     toCreate: Array<DTProcessedTokenNode>;
@@ -10,6 +11,10 @@ export type DTThemeMergeDiff = {
 export declare class DTThemeMerger {
     private versionId;
     constructor(versionId: string);
-    makeTheme(upstreamTokens: Array<Token>, upstreamGroups: Array<TokenGroup>, upstreamTheme: TokenTheme, processedNodes: Array<DTProcessedTokenNode>, preciseCopy?: boolean): TokenTheme;
+    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;
+    };
 }

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

@@ -10,6 +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;
+    static buildReference(path: Array<string>, name: string): string;
     buildNodeMap(nodes: Array<DTProcessedTokenNode>): Map<string, DTProcessedTokenNode>;
     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/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<import("../../../..").AnyToken>>;
+    readonly deleted: Map<string, DTProcessedTokenNode>;
     readonly dirty: Set<string>;
     readonly list: Array<DTProcessedTokenNode>;
     constructor(source: Array<DTProcessedTokenNode> | Map<string, DTProcessedTokenNode>);

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

@@ -62,7 +62,7 @@ export declare class TokenJSONElementTransformer {
     safeGroupName(group: TokenGroup): string;
     processedName(name: string, naming: JSONBuilderNamingOption): string;
     /** Retrieve human-readable token type in unified fashion, used both as token type and as token master group */
-    typeLabel(type: TokenType): "color" | "gradient" | "typography" | "border" | "textCase" | "textDecoration" | "visibility" | "shadow" | "text" | "measure" | undefined;
+    typeLabel(type: TokenType): "visibility" | "color" | "gradient" | "typography" | "border" | "textCase" | "textDecoration" | "text" | "shadow" | "measure" | undefined;
     /** Retrieve chain of groups up to a specified group, ordered from parent to children */
     referenceGroupChain(containingGroup: TokenGroup, allGroups: Array<TokenGroup>): Array<TokenGroup>;
 }

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

@@ -279,6 +279,7 @@ export declare class TokenUtils {
     static inlineValueIntoComplexTokens(token: AnyToken, candidateId: string, candidateValueToInline: AnyTokenValue): void;
     static getRefIdsFromComplexTokens(token: AnyToken): (string | null | undefined)[];
     static buildKey(path: Array<string>, name: string): string;
+    static buildReference(path: Array<string>, name: string): string;
     static buildPath(token: Token, groups: Array<TokenGroup>): Array<string>;
     static mapTypeToPrefix: (type: TokenType) => string;
     static mapTypeToPrefixBack: (type: TokenType) => string;