@supernova-studio/supernova-sdk-beta 2.4.11 → 2.5.1

package/build/types/model/agent-chats/SDKAgentChat.d.ts

@@ -1,4 +1,5 @@
-import type { DTOAgentChat, DTOAgentChatChangedEntitiesResponse, DTOAgentChatChangedEntity, DTOAgentChatCreatePayload, DTOAgentChatDeleteResponse, DTOAgentChatListResponse, DTOAgentChatResponse, DTOAgentChatUpdatePayload } from "@supernova-studio/client";
+import type { DTOAgentChat, DTOAgentChatChangedEntitiesResponse, DTOAgentChatChangedEntity, DTOAgentChatCreatePayload, DTOAgentChatDeleteResponse, DTOAgentChatListResponse, DTOAgentChatResponse, DTOAgentChatUpdatePayload, DTOAgentTurnRating, DTOAgentTurnRatingListResponse, DTOAgentTurnRatingResponse, DTOAgentTurnRatingTag, DTOAgentTurnRatingType, DTOAgentTurnRatingUpsertPayload } from "@supernova-studio/client";
+export { AGENT_CHAT_NAME_SOURCE_MAX_LENGTH } from "@supernova-studio/client";
 export type AgentChatChangedEntitiesResponse = DTOAgentChatChangedEntitiesResponse;
 export type AgentChatChangedEntity = DTOAgentChatChangedEntity;
 export type AgentChatCreateInput = DTOAgentChatCreatePayload;
@@ -7,6 +8,12 @@ export type AgentChatListResponse = DTOAgentChatListResponse;
 export type AgentChatRemoteModel = DTOAgentChat;
 export type AgentChatResponse = DTOAgentChatResponse;
 export type AgentChatUpdateInput = DTOAgentChatUpdatePayload;
+export type AgentTurnRating = DTOAgentTurnRating;
+export type AgentTurnRatingInput = DTOAgentTurnRatingUpsertPayload;
+export type AgentTurnRatingListResponse = DTOAgentTurnRatingListResponse;
+export type AgentTurnRatingResponse = DTOAgentTurnRatingResponse;
+export type AgentTurnRatingTag = DTOAgentTurnRatingTag;
+export type AgentTurnRatingType = DTOAgentTurnRatingType;
 export type AgentChatListFilter = {
     workspaceId: string;
     designSystemId?: string;
@@ -15,6 +22,10 @@ export type AgentChatListFilter = {
 export declare class AgentChat {
     id: string;
     workspaceId: string;
+    /**
+     * @deprecated Chats belong to a workspace and are never created with a design
+     * system any more. Older chats may still carry one; nothing reads it
+     */
     designSystemId: string | undefined;
     userId: string;
     threadId: string;

package/build/types/model/base/SDKDesignSystemVersionStats.d.ts

@@ -1,9 +1,14 @@
-import { DTODesignSystemVersionStats } from "@supernova-studio/client";
+import { DTODesignSystemVersionStats, DTODesignSystemVersionTokenCollectionStats } from "@supernova-studio/client";
 export declare class DesignSystemVersionStats {
     tokens: number;
+    tokensByType: Record<string, number>;
+    /** Tokens not linked to any data source, i.e. authored in Supernova */
+    authoredTokens: number;
+    tokenCollections: Array<DTODesignSystemVersionTokenCollectionStats>;
     designSystemComponents: number;
     assets: number;
     documentationPages: number;
+    publishedDocumentationPages: number;
     figmaComponents: number;
     stories: number;
     constructor(model: DTODesignSystemVersionStats);

package/build/types/model/docs/blocks/support/SDKDocsImageRef.d.ts

@@ -1,4 +1,4 @@
-import { Supernova } from "../../../../exports";
+import { Supernova } from "../../../../core/SDKSupernova";
 /** An image data container */
 export type DocsImageRef = {
     /** Ref type */

package/build/types/model/documentation/SDKPublishedDocsSite.d.ts

@@ -0,0 +1,20 @@
+import type { DTOFileReference, DTOPublishedDocsSite } from "@supernova-studio/client";
+import { DocumentationEnvironment } from "../enums/SDKDocumentationEnvironment";
+export declare class PublishedDocsSite {
+    id: string;
+    designSystemVersionId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    lastPublishedAt: Date;
+    environment: DocumentationEnvironment;
+    isDefault: boolean;
+    isPublic: boolean;
+    routingVersion: DTOPublishedDocsSite["routingVersion"];
+    usesLocalizations: boolean;
+    wasPublishedWithLocalizations: boolean;
+    tokenCount: number;
+    assetCount: number;
+    thumbnail?: DTOFileReference;
+    thumbnailUpdatedAt?: Date;
+    constructor(model: DTOPublishedDocsSite);
+}

package/build/types/model/enums/SDKUnit.d.ts

@@ -7,6 +7,8 @@ export declare enum Unit {
 }
 export declare const SIZE_UNITS: readonly [Unit.pixels, Unit.percent, Unit.rem];
 export type SizeUnit = (typeof SIZE_UNITS)[number];
+export declare const OPACITY_UNITS: readonly [Unit.pixels, Unit.percent, Unit.raw];
+export type OpacityUnit = (typeof OPACITY_UNITS)[number];
 export declare const LINE_HEIGHT_UNITS: readonly [Unit.pixels, Unit.percent, Unit.rem, Unit.raw];
 export type LineHeightUnit = (typeof LINE_HEIGHT_UNITS)[number];
 export declare const RAW_UNITS: readonly [Unit.raw];

package/build/types/model/exporters/exporter_builds/SDKExportDestinations.d.ts

@@ -82,6 +82,9 @@ export type DocsExportDestinationModel = {
     changes: DocsExportDestinationChanges | null;
 };
 export type DocsExportDestinationChanges = {
+    /** What the build publishes, absent on builds that publish everything */
+    pagePersistentIds?: string[];
+    groupPersistentIds?: string[];
     selectivePublishing: boolean | null;
 };
 /**

package/build/types/model/support/SDKSource.d.ts

@@ -115,7 +115,7 @@ export type SourceRemoteModelTokensStudio = {
     };
     lastImportedResults?: Array<{
         mapping: {
-            tokensTheme?: string;
+            tokensTheme?: string | string[];
             tokenSets?: string[];
             supernovaBrand?: string;
             supernovaTheme?: string;

package/build/types/model/tokens/SDKColorToken.d.ts

@@ -12,6 +12,10 @@ export declare class ColorToken extends Token {
     constructor(versionId: string, baseToken: TokenRemoteModel, value: ColorTokenValue, alias: ColorToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create(versionId: string, brandId: string, name: string, description: string, value: string, alias: ColorToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): ColorToken;
     static colorValueFromDefinition(definition: string): ColorTokenValue;
+    /**
+     * Rewrite rgb()/hsl() forms into hex, including shapes tinycolor2 cannot read on its own.
+     * Keep color2k here: the catch below only fires because it throws, where tinycolor2 returns an invalid color.
+     */
     static normalizeColor(color: string): string | null;
     static normalizeOpacity(value: string): number;
     static normalizedHex(value: string | null): string | null;

package/build/types/model/tokens/SDKDimensionToken.d.ts

@@ -27,8 +27,13 @@ export declare class DimensionCategoryToken<T extends AnyDimensionTokenValue> ex
     value: T;
     constructor(versionId: string, baseToken: TokenRemoteModel, value: AnyDimensionTokenValue, alias: DimensionCategoryToken<AnyDimensionTokenValue> | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);
     static create<TToken extends DimensionCategoryToken<AnyDimensionTokenValue>>(this: new (versionId: string, baseToken: TokenRemoteModel, value: AnyDimensionTokenValue, alias: DimensionCategoryToken<AnyDimensionTokenValue> | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>) => TToken, type: DimensionTokenType, versionId: string, brandId: string, name: string, description: string, value: string | number, alias: TToken | null, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): TToken;
-    static getCompatibleUnit(unit: Unit, type: DimensionTokenType): Unit;
+    static getCompatibleUnit(unit: Unit, type: DimensionTokenType, referenceCheckOnly?: boolean): Unit;
     static getCompatibleMeasure(unit: Unit, type: DimensionTokenType, measure: number): number;
+    /**
+     * Reads a px or % value aliased by an opacity as a fraction, so 50px becomes 0.5.
+     * Values outside 0–100 keep their unit so the out-of-range warning still shows.
+     */
+    static toOpacityValue<T extends AnyDimensionTokenValue>(value: T): T;
     static getDefaultUnit(type: DimensionTokenType, parsedDefinition?: number): Unit.pixels | Unit.ms | Unit.raw;
     static dimensionValueFromDefinition<T extends DimensionTokenType>(definition: string | number, type: T): DimensionValueForType<T>;
     static parseDimension(definition: string, type: DimensionTokenType): {

package/build/types/model/users/SDKUserWorkspaceNotificationSettings.d.ts

@@ -6,6 +6,9 @@ type GeneralNotificationSetting = {
 type DocsCommentsSetting = {
     email: boolean;
 };
+type AgentSoundSetting = {
+    enabled: boolean;
+};
 export type NotificationSettingsRemoteModel = DTOUserNotificationSettings;
 export type NotificationSettingsUpdateModel = Omit<NotificationSettingsRemoteModel, "liveblocksNotificationSettings">;
 export declare class UserWorkspaceNotificationSettings {
@@ -13,6 +16,7 @@ export declare class UserWorkspaceNotificationSettings {
     projectChatMention: GeneralNotificationSetting;
     projectDocumentComments: GeneralNotificationSetting;
     projectInvitation: GeneralNotificationSetting;
+    agentSound: AgentSoundSetting;
     constructor(model: NotificationSettingsRemoteModel);
     toRemote(): NotificationSettingsRemoteModel;
 }

package/build/types/model/workspaces/SDKWorkspaceProduct.d.ts

@@ -1,17 +1,13 @@
-import { UserRole } from "../enums/SDKUserRole";
 import { WorkspaceSubscriptionProductCode } from "../enums/SDKWorkspaceSubscriptionProduct";
 import { WorkspaceProductPrice, WorkspaceProductPriceRemoteModel } from "./SDKWorkspaceProductPrice";
 export type WorkspaceProductRemoteModel = {
     code: WorkspaceSubscriptionProductCode;
-    allowedInviteRoles: Array<UserRole>;
     prices: Array<WorkspaceProductPriceRemoteModel>;
 };
 export type WorkspaceProductTransportModel = WorkspaceProductRemoteModel;
 export declare class WorkspaceProduct {
     /** The code corresponding to this product */
     code: WorkspaceSubscriptionProductCode;
-    /** The roles that are allowed to be invited to the workspace under this product */
-    allowedInviteRoles: Array<UserRole>;
     /** The list of prices associated with the product */
     prices: Array<WorkspaceProductPrice>;
     constructor(model: WorkspaceProductTransportModel);

package/build/types/model/workspaces/SDKWorkspaceProductPrice.d.ts

@@ -3,17 +3,17 @@ import { WorkspaceSubscriptionPlanInterval } from "../enums/SDKWorkspaceSubscrip
 export type WorkspaceProductPriceRemoteModel = {
     stripePriceId: string;
     stripeProductId: string;
-    stripeProductDescription: string;
     stripeProductFeatures: Array<string>;
     stripeProductAdditionalFeatures: Array<string>;
     active: boolean;
     amount: number;
     seatType?: WorkspaceBilledSeatType;
     interval: WorkspaceSubscriptionPlanInterval;
-    isPricePerCreator: boolean;
     legacyVersion?: string;
     monthlyCreditGrant?: number;
     mcpConsumers?: number;
+    isFixed?: boolean;
+    isSelfServe: boolean;
 };
 export type WorkspaceProductPriceTransportModel = WorkspaceProductPriceRemoteModel;
 export declare class WorkspaceProductPrice {
@@ -21,28 +21,37 @@ export declare class WorkspaceProductPrice {
     stripePriceId: string;
     /** The unique identifier for the Stripe product associated with the price */
     stripeProductId: string;
-    /** Product description */
-    stripeProductDescription: string;
-    /** List of features available to this product price */
+    /**
+     * List of features available to this product price
+     * @deprecated Plan copy is hardcoded on the frontend now
+     */
     stripeProductFeatures: Array<string>;
-    /** List of additional features available to this product price */
+    /**
+     * List of additional features available to this product price
+     * @deprecated Plan copy is hardcoded on the frontend now
+     */
     stripeProductAdditionalFeatures: Array<string>;
     /** Indicates whether the price is currently active */
     active: boolean;
     /** The amount to be charged for the product, in the smallest currency unit (e.g., cents) */
     amount: number;
-    /** The matching seat (builder or full). Omitted for free plans */
+    /**
+     * The matching seat (builder or full). Omitted for free plans
+     * @deprecated Flat plans have no seat type
+     */
     seatType?: WorkspaceBilledSeatType;
     /** The billing interval (e.g., monthly, yearly) */
     interval: WorkspaceSubscriptionPlanInterval;
-    /** Indicates whether the price is per creator (self-serve) or not */
-    isPricePerCreator: boolean;
     /** An optional legacy version identifier, if applicable */
     legacyVersion?: string | null;
     /** The number of credits to be granted per month by this price */
     monthlyCreditGrant: number | null;
     /** The number of MCP consumers included in this price */
     mcpConsumers: number | null;
+    /** Whether the plan is charged as a flat fee instead of per seat */
+    isFixed: boolean;
+    /** Whether the plan can be bought without contacting sales */
+    isSelfServe: boolean;
     constructor(model: WorkspaceProductPriceRemoteModel);
     toRemote(): WorkspaceProductPriceRemoteModel;
     toTransport(): WorkspaceProductPriceTransportModel;

package/build/types/model/workspaces/SDKWorkspaceSubscription.d.ts

@@ -11,16 +11,13 @@ export type WorkspaceSubscriptionUpdatePreviewModel = DTOSubscriptionUpdatePrevi
 export declare class WorkspaceSubscription {
     /** Main status of the workspace subscription */
     status: WorkspaceSubscriptionStatus;
-    /** Maximum number of Builders seats */
-    builderSeatLimit: number;
-    /** Current number of Builder seats the workspace uses */
-    builderSeats: number;
-    /** Maximum number of DSM (Full) seats */
+    /**
+     * Number of DSM (Full) seats the workspace bought. Zero when the backend does not send it
+     * @deprecated Only seat-priced plans use it. Flat plans buy no seats
+     */
     fullSeatLimit: number;
     /** Current number of DSM (Full) seats the workspace uses */
     fullSeats: number;
-    /** Maximum number of MCP consumers */
-    mcpConsumerLimit: number | undefined;
     /** Subscription tier */
     product: WorkspaceSubscriptionProductCode;
     /** Subscription cycle interval */
@@ -31,11 +28,6 @@ export declare class WorkspaceSubscription {
      * Stripe price id for a Full seat.
      */
     fullSeatPriceId: string;
-    /**
-     * Stripe price id for a Builder seat.
-     * Can be optional if no Builder subscription was created on Stripe (e.g., on legacy plans).
-     */
-    builderSeatPriceId: string | null;
     /** Starting date of the current billing cycle */
     currentPeriodStart: Date | null;
     /** Ending date of the current billing cycle */
@@ -58,20 +50,28 @@ export declare class WorkspaceSubscription {
     } | null;
     /** Price of the subscription, in the smallest currency unit (e.g., cents) */
     amount: number;
-    /** Product description */
-    stripeProductDescription: string | null;
     /** Date when subscription status was updated */
     subscriptionStatusUpdatedAt: Date | null;
     /** Product version when it is legacy */
     legacyVersion: string | null;
-    /** Indicates whether the price is per creator (self-serve) or not */
-    isPricePerCreator: boolean;
-    /** List of features available to this product price */
+    /** Whether the plan can be changed without contacting sales */
+    isPriceSelfServe: boolean;
+    /** Whether the plan is charged as a flat fee instead of per seat */
+    isPriceFixed: boolean;
+    /**
+     * List of features available to this product price
+     * @deprecated Plan copy is hardcoded on the frontend now
+     */
     stripeProductFeatures: Array<string>;
-    /** List of additional features available to this product price */
+    /**
+     * List of additional features available to this product price
+     * @deprecated Plan copy is hardcoded on the frontend now
+     */
     stripeProductAdditionalFeatures: Array<string>;
     /** List of features defined in a machine-readable way */
     featuresSummary: ProductFeature;
+    /** Monthly credits bought as add-ons on top of the plan */
+    additionalCredits: number;
     creditsPrices: {
         creditsToCentsConversionRate: number;
         purchaseTopUpCreditsToCentsConversionRate: number;
@@ -105,7 +105,6 @@ export declare class WorkspaceSubscription {
     subscriptionUpcomingChange: {
         effectiveAt: Date;
         fullSeatLimit: number | null;
-        builderSeatLimit: number | null;
         additionalCredits: number | null;
     } | null;
     /** List of roles allowed to be invited to the workspace under this product */

package/build/types/tools/design-tokens/SDKToolsDesignTokensPlugin.d.ts

@@ -1,5 +1,4 @@
 import { Supernova } from "../../core/SDKSupernova";
-import { ActivityEventOptions } from "../../core/data/requests/SDKDataCoreWriteRequests";
 import { Brand } from "../../model/base/SDKBrand";
 import { TokenGroup } from "../../model/groups/SDKTokenGroup";
 import { Logger } from "../../model/support/SDKLogger";
@@ -29,9 +28,7 @@ export declare class SupernovaToolsDesignTokensPlugin {
     private logger;
     constructor(designSystemId: string, versionId: string, instance: Supernova, logger?: Logger);
     synchronizeTokensFromData(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings): Promise<object>;
-    synchronizeTokensFromDataWithResults(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings, options?: {
-        activityEventOptions?: ActivityEventOptions;
-    }): Promise<{
+    synchronizeTokensFromDataWithResults(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings): Promise<{
         results: SupernovaToolsDesignTokensResult[];
         logs: string[];
     }>;
@@ -43,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: DTPluginPreciseCopyStrategy, activityEventOptions?: ActivityEventOptions): 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?: DTPluginPreciseCopyStrategy, themeOverridesStrategy?: DTPluginThemeOverrideStrategy, activityEventOptions?: ActivityEventOptions): 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/types/tools/design-tokens/utilities/SDKDTJSONConverter.d.ts

@@ -1,48 +1,22 @@
 import { Brand } from "../../../model/base/SDKBrand";
 import { DTOriginalTokenType } from "../../../model/enums/SDKTokenType";
 import { AnyToken } from "../../../model/tokens/SDKTokenValue";
-import { DTParsedNode, DTParsedThemeSetPriority, DTParsedTokenSet } from "./SDKDTJSONLoader";
-import { DTPluginSourceMode, DTPluginToSupernovaMapPack, DTPluginUnresolvableFallback, DTPluginUnresolvableRefMode } from "./SDKDTMapLoader";
+import { DTParsedNode } from "./SDKDTJSONLoader";
+import { DTPluginToSupernovaMapPack } from "./SDKDTMapLoader";
 import { DTTokenReferenceResolver } from "./SDKDTTokenReferenceResolver";
 export type DTProcessedTokenNode<T extends AnyToken = AnyToken> = {
     token: T;
     originalType: DTOriginalTokenType;
     path: Array<string>;
     key: string;
-    /** Originating set's status in `$themes.json`; absent for explicit-`tokenSets` mappings */
-    sourcePriority?: DTParsedThemeSetPriority;
-};
-export type DTJSONConverterOptions = {
-    /** How to handle references that can't resolve; defaults to `strict` (throw). */
-    unresolvableRefMode?: DTPluginUnresolvableRefMode;
-    /** Per-type fallback values used by `placeholder` and `lenientResolve` modes. */
-    unresolvableFallback?: Required<DTPluginUnresolvableFallback>;
-    /** Full input token sets — used only by `lenientResolve` for wider-scope lookup. */
-    allLoadedSets?: Array<DTParsedTokenSet>;
-    /** Attribution label included in warnings — usually `"<brand>/<theme>"`. */
-    mappingKey?: string;
-    /** How to handle `source`-statused sets (Fix B). Defaults to `emit`. */
-    sourceMode?: DTPluginSourceMode;
 };
 /** Utility to DS Tokens plugin JSON to Supernova entities */
 export declare class DTJSONConverter {
     versionId: string;
     mapping: DTPluginToSupernovaMapPack;
     referenceResolver: DTTokenReferenceResolver;
-    unresolvableRefMode: DTPluginUnresolvableRefMode;
-    unresolvableFallback: Required<DTPluginUnresolvableFallback>;
-    allLoadedSets: Array<DTParsedTokenSet>;
-    mappingKey: string;
-    sourceMode: DTPluginSourceMode;
-    /** Warnings surfaced during resolution (emitted by non-strict unresolvable modes). Consumed by the plugin and folded into logs[]. */
-    warnings: Array<string>;
-    /** Keys of processed nodes that should be dropped before emission (populated by `preserve` mode and Fix B source filtering). */
-    skippedKeys: Set<string>;
-    constructor(versionId: string, mapping: DTPluginToSupernovaMapPack, options?: DTJSONConverterOptions);
+    constructor(versionId: string, mapping: DTPluginToSupernovaMapPack);
     convertNodesToTokens(nodes: Array<DTParsedNode>, brand: Brand): Array<DTProcessedTokenNode>;
-    private applySourceModeSkip;
-    /** Single-pass cascade: mark tokens whose referencedTokenId targets are in `skipIds`. Returns true if any new skip was added. */
-    private markCascadingSkips;
     private restoreInitialTokenOrder;
     private remapRootNodeKey;
     private remapRootNodeKeys;

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

@@ -7,8 +7,6 @@ export type DTParsedNode = {
     type: DTOriginalTokenType;
     value: JSONValue;
     description: string | null;
-    /** Originating set's status in `$themes.json`; absent for explicit-`tokenSets` mappings */
-    sourcePriority?: DTParsedThemeSetPriority;
 };
 export type DTParsedTokenSet = {
     name: string;

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

@@ -15,31 +15,6 @@ export declare enum DTPluginPreciseCopyStrategy {
     deleteAll = "deleteAll",// preciseCopy = true
     keepManualTokens = "keepManualTokens"
 }
-/** Controls how `source`-statused sets in `$themes.json` are handled during sync. */
-export declare enum DTPluginSourceMode {
-    /** Source sets contribute tokens AND resolve references (current SDK behavior) */
-    emit = "emit",
-    /** Source sets are used for reference resolution only; their tokens are inlined into referring enabled tokens and not emitted separately */
-    referenceOnly = "referenceOnly"
-}
-/** Controls what happens when a `{...}` reference can't be resolved within the mapping's set pool. */
-export declare enum DTPluginUnresolvableRefMode {
-    /** Throw the enriched error listing missing refs (current SDK behavior) */
-    strict = "strict",
-    /** Substitute unresolvable refs with configured fallback values; emit warnings to logs */
-    placeholder = "placeholder",
-    /** Keep the `{...}` literal in the token value; self-heals on next sync when target exists */
-    preserve = "preserve",
-    /** Try to resolve against all loaded sets (not just mapping's subset); fall back to placeholder if still unresolvable */
-    lenientResolve = "lenientResolve"
-}
-/** Per-type fallback values used by `placeholder` mode (and `lenientResolve` fallback). */
-export type DTPluginUnresolvableFallback = {
-    color?: string;
-    dimension?: number;
-    string?: string;
-};
-export declare const DEFAULT_UNRESOLVABLE_FALLBACK: Required<DTPluginUnresolvableFallback>;
 export declare const isPreciseCopyEnabled: (preciseCopy: DTPluginPreciseCopyStrategy) => preciseCopy is DTPluginPreciseCopyStrategy.deleteAll | DTPluginPreciseCopyStrategy.keepManualTokens;
 export declare const toPreciseCopyStrategy: (preciseCopy?: boolean | DTPluginPreciseCopyStrategy) => DTPluginPreciseCopyStrategy;
 export type DTPluginToSupernovaMap = {
@@ -67,9 +42,6 @@ export type DTPluginToSupernovaMappingFile = {
         dryRun?: boolean;
         preciseCopy?: boolean | DTPluginPreciseCopyStrategy;
         themeOverridesStrategy?: DTPluginThemeOverrideStrategy;
-        sourceMode?: DTPluginSourceMode;
-        unresolvableRefMode?: DTPluginUnresolvableRefMode;
-        unresolvableFallback?: DTPluginUnresolvableFallback;
     };
 };
 export type DTPluginToSupernovaSettings = {
@@ -77,7 +49,4 @@ export type DTPluginToSupernovaSettings = {
     dryRun: boolean;
     preciseCopy: DTPluginPreciseCopyStrategy;
     themeOverridesStrategy: DTPluginThemeOverrideStrategy;
-    sourceMode: DTPluginSourceMode;
-    unresolvableRefMode: DTPluginUnresolvableRefMode;
-    unresolvableFallback: Required<DTPluginUnresolvableFallback>;
 };

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

@@ -45,6 +45,4 @@ export declare class DTTokenReferenceResolver {
         dollarTypeReference: boolean;
     }[];
     isDollarIdentifier(value: string): boolean;
-    /** Extract references appearing in `value` that aren't defined in the atomic table. Returns bracket-normalized keys (e.g. `{color.base.foo}`). */
-    unresolvedReferencesIn(value: unknown): Array<string>;
 }

package/build/types/tools/token-preview/TokenUtilPreviewTypes.d.ts

@@ -74,6 +74,8 @@ export type TokenUtilPreviewReferenceInfo = {
 export type TokenUtilPreviewReferenceInfoPiece = {
     key?: Array<TokenUtilPreviewTokenValueSegment>;
     value?: Array<TokenUtilPreviewTokenValueSegment>;
+    /** Opaque hex of a colour row, for a swatch beside it. Opacity has its own row */
+    swatchColor?: string;
     icon?: string;
     fullWidth?: boolean;
     wrapSegments?: boolean;

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

@@ -1,19 +1,27 @@
-import { AnyToken, AnyDimensionToken, BlurType, BorderPosition, BorderStyle, DTProcessedTokenNode, GradientType, ShadowType, TextCase, TokenGroup, TokenTheme } from "../exports";
 import { ElementProperty } from "../model/elements/SDKElementProperty";
+import { BlurType } from "../model/enums/SDKBlurType";
+import { BorderPosition } from "../model/enums/SDKBorderPosition";
+import { BorderStyle } from "../model/enums/SDKBorderStyle";
+import { GradientType } from "../model/enums/SDKGradientType";
+import { ShadowType } from "../model/enums/SDKShadowType";
+import { TextCase } from "../model/enums/SDKTextCase";
 import { TokenType } from "../model/enums/SDKTokenType";
+import { TokenGroup } from "../model/groups/SDKTokenGroup";
+import { TokenTheme } from "../model/themes/SDKTokenTheme";
 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 { AnyDimensionToken, 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, StringCategoryToken, StringToken } from "../model/tokens/SDKStringToken";
 import { TextCaseToken } from "../model/tokens/SDKTextCaseToken";
 import { TextDecorationToken } from "../model/tokens/SDKTextDecorationToken";
 import { Token } from "../model/tokens/SDKToken";
-import { AnyMultiLayerToken, AnySingleLayerToken, AnyStringTokenValue, AnyTokenValue, BorderWidthTokenValue, ColorTokenValue, ColorValue, DimensionTokenValue, DurationTokenValue, FontFamilyTokenValue, FontSizeTokenValue, FontWeightTokenValue, LetterSpacingTokenValue, LineHeightTokenValue, OpacityTokenValue, ParagraphSpacingTokenValue, ProductCopyTokenValue, RadiusTokenValue, RawValue, SizeTokenValue, SpaceTokenValue, StringTokenValue, TextCaseTokenValue, TextDecorationTokenValue, VisibilityTokenValue, ZIndexTokenValue } from "../model/tokens/SDKTokenValue";
+import { AnyToken, AnyMultiLayerToken, AnySingleLayerToken, AnyStringTokenValue, AnyTokenValue, BorderWidthTokenValue, ColorTokenValue, ColorValue, DimensionTokenValue, DurationTokenValue, FontFamilyTokenValue, FontSizeTokenValue, FontWeightTokenValue, LetterSpacingTokenValue, LineHeightTokenValue, OpacityTokenValue, ParagraphSpacingTokenValue, ProductCopyTokenValue, RadiusTokenValue, RawValue, SizeTokenValue, SpaceTokenValue, StringTokenValue, TextCaseTokenValue, TextDecorationTokenValue, VisibilityTokenValue, ZIndexTokenValue } from "../model/tokens/SDKTokenValue";
 import { TypographyToken } from "../model/tokens/SDKTypographyToken";
 import { VisibilityToken } from "../model/tokens/SDKVisibilityToken";
+import { DTProcessedTokenNode } from "../tools/design-tokens/utilities/SDKDTJSONConverter";
 type TokenMapCompletenessTypeCheck<T extends Record<TokenType, AnyToken>> = T;
 type ActualTypeToTokenMap = {
     [TokenType.color]: ColorToken;
@@ -307,6 +315,6 @@ export declare class TokenUtils {
     static getTokenByKeyOrFallbackKeys<T extends DTProcessedTokenNode | Token>(node: Pick<DTProcessedTokenNode, "path" | "token">, map: Map<string, T>): T | undefined;
     static getKeysByKeyOrFallbackKeys(node: Pick<DTProcessedTokenNode, "path" | "token">): string[];
     static getTokenByKeyOrBackwardKey(node: Pick<DTProcessedTokenNode, "path" | "token">, map: Map<string, DTProcessedTokenNode>): DTProcessedTokenNode | undefined;
-    static getTextCaseTokenValue(value: TextCase): "Uppercase" | "Lowercase" | "Capitalize" | "Small caps" | "Original";
+    static getTextCaseTokenValue(value: TextCase): "Original" | "Uppercase" | "Lowercase" | "Capitalize" | "Small caps";
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernova-studio/supernova-sdk-beta",
-  "version": "2.4.11",
+  "version": "2.5.1",
   "description": "Supernova.io SDK",
   "main": "./build/supernova-sdk-typescript.js",
   "types": "./build/types/index.d.ts",
@@ -26,7 +26,6 @@
     "build": "Clean and rebuild the project",
     "test": "Lint and unit test the project",
     "watch": "Watch and rebuild the project on save, then rerun relevant tests",
-    "cov": "Rebuild, run tests, then create and open the coverage report",
     "doc": "Generate HTML API documentation and open it in a browser",
     "doc:json": "Generate API documentation in typedoc JSON format",
     "version": "Bump package.json version, update CHANGELOG.md, tag release",
@@ -38,54 +37,37 @@
     "node": ">=18"
   },
   "dependencies": {
-    "async-mutex": "0.3.2",
-    "color-string": "1.9.1",
     "color2k": "2.0.4",
     "fuse.js": "6.6.2",
     "lodash": "4.18.1",
-    "parse-color": "1.0.0",
     "tinycolor2": "1.6.0",
     "uuid": "14.0.0",
+    "zod": "4.4.3",
     "@supernova-studio/client": "1.96.10",
     "@supernova-studio/model": "1.96.10"
   },
   "devDependencies": {
-    "@istanbuljs/nyc-config-typescript": "0.1.3",
     "@types/lodash": "4.17.24",
-    "@types/parse-color": "1.0.3",
     "@types/tinycolor2": "1.4.6",
     "dotenv": "16.0.3",
-    "esm": "3.2.25",
-    "nyc": "17.1.0",
     "readable-stream": "4.7.0",
-    "trash-cli": "5.0.0",
     "ts-loader": "9.6.2",
     "tsconfig-paths-webpack-plugin": "4.2.0",
-    "tsx": "4.19.3",
     "vitest": "4.1.4",
     "webpack": "5.108.4",
     "webpack-cli": "6.0.1",
     "webpack-node-externals": "3.0.0",
     "@supernovaio/typescript-with-config": "1.3.28",
-    "eslint-config-supernova": "0.0.0"
-  },
-  "config": {},
-  "nyc": {
-    "extends": "@istanbuljs/nyc-config-typescript",
-    "exclude": [
-      "**/*.spec.js"
-    ]
+    "@supernovaio/lint-rules": "0.0.0"
   },
   "optionalDependencies": {
     "@rollup/rollup-darwin-x64": "4.59.0"
   },
   "scripts": {
     "build:production": "pnpm clean && webpack --mode production --config ./webpack.config.sdk.js && pnpm build:types",
-    "build:types": "tsc --noCheck --declaration --emitDeclarationOnly --declarationMap false --skipLibCheck --module CommonJS --target ES2020 --moduleResolution node --esModuleInterop --outDir build/types src/index.ts",
+    "build:types": "tsc --ignoreConfig --strict false --noCheck --declaration --emitDeclarationOnly --declarationMap false --skipLibCheck --module CommonJS --target ES2020 --moduleResolution bundler --esModuleInterop --outDir build/types src/index.ts",
     "build-sdk": "pnpm build:production",
-    "clean": "trash build test",
-    "lint": "eslint 'src/**/*.ts*'",
-    "lint:fix": "eslint 'src/**/*.ts*' --fix",
+    "clean": "rm -rf build",
     "test": "pnpm test:unit",
     "test:unit": "vitest run --config vitest.config.ts --reporter verbose",
     "test:watch": "vitest --config vitest.config.ts --watch",

package/build/types/tools/design-tokens/utilities/unresolvable-modes/index.d.ts

@@ -1,4 +0,0 @@
-import { DTPluginUnresolvableRefMode } from "../SDKDTMapLoader";
-import { UnresolvableModeHandler } from "./types";
-export * from "./types";
-export declare const UNRESOLVABLE_MODE_HANDLERS: Record<DTPluginUnresolvableRefMode, UnresolvableModeHandler>;

package/build/types/tools/design-tokens/utilities/unresolvable-modes/lenient-resolve.d.ts

@@ -1,2 +0,0 @@
-import { UnresolvableModeHandler } from "./types";
-export declare const lenientResolveHandler: UnresolvableModeHandler;

package/build/types/tools/design-tokens/utilities/unresolvable-modes/placeholder.d.ts

@@ -1,2 +0,0 @@
-import { UnresolvableModeHandler } from "./types";
-export declare const placeholderHandler: UnresolvableModeHandler;

package/build/types/tools/design-tokens/utilities/unresolvable-modes/preserve.d.ts

@@ -1,2 +0,0 @@
-import { UnresolvableModeHandler } from "./types";
-export declare const preserveHandler: UnresolvableModeHandler;

package/build/types/tools/design-tokens/utilities/unresolvable-modes/strict.d.ts

@@ -1,2 +0,0 @@
-import { UnresolvableModeHandler } from "./types";
-export declare const strictHandler: UnresolvableModeHandler;