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

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernova-studio/supernova-sdk-beta",
-  "version": "2.4.11",
+  "version": "2.4.12",
   "description": "Supernova.io SDK",
   "main": "./build/supernova-sdk-typescript.js",
   "types": "./build/types/index.d.ts",

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;

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

@@ -1,33 +0,0 @@
-import { Brand } from "../../../../model/base/SDKBrand";
-import { DTParsedNode, DTParsedTokenSet } from "../SDKDTJSONLoader";
-import { DTPluginUnresolvableFallback } from "../SDKDTMapLoader";
-import { DTTokenReferenceResolver } from "../SDKDTTokenReferenceResolver";
-/** Context passed to each unresolvable-ref handler. */
-export type UnresolvableModeContext = {
-    /** Nodes that failed to resolve within the depth limit, paired with their original processing index. */
-    unresolvedTokens: Array<[DTParsedNode, number]>;
-    /** All token sets loaded from the input file (used by `lenientResolve`; other handlers ignore). */
-    allLoadedSets: Array<DTParsedTokenSet>;
-    /** The atomic-token table built during resolution; used to check what IS known. */
-    atomicResolver: DTTokenReferenceResolver;
-    /** Fully-populated fallback values (defaults merged with any user overrides). */
-    fallback: Required<DTPluginUnresolvableFallback>;
-    /** Brand context — passed to per-token conversion. */
-    brand: Brand;
-    /** Short label used in warning strings for attribution (e.g. "Jetstar/jq-web-light"). */
-    mappingKey: string;
-};
-/**
- * Result from a handler. Instead of directly writing tokens, handlers return
- * substituted nodes (whose values may have been rewritten) and/or skipped nodes.
- * The caller re-runs the atomic-conversion path on substituted nodes.
- */
-export type UnresolvableModeResult = {
-    /** Nodes whose values were substituted; re-run conversion on these. */
-    substitutedNodes: Array<[DTParsedNode, number]>;
-    /** Nodes to skip entirely — not emitted this sync. */
-    skippedNodes: Array<[DTParsedNode, number]>;
-    /** `[WARN]`-prefixed lines appended to the existing `logs[]` return value. */
-    warnings: Array<string>;
-};
-export type UnresolvableModeHandler = (context: UnresolvableModeContext) => UnresolvableModeResult;