@supernova-studio/supernova-sdk-beta 1.6.43 → 1.6.46

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

@@ -6,7 +6,7 @@ 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>) | undefined, retriesLeft?: number, interval?: number) => Promise<any>;
-export declare const testRetry: (title: string, fn: (ctx: ExecutionContext<unknown>) => Promise<any>, beforeFn?: ((ctx: ExecutionContext<unknown>) => Promise<any>) | undefined, attempts?: number, interval?: number) => Promise<void>;
+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/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" | "text" | "shadow" | "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>;
 }