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

package/build/types/core/resolvers/SDKDocsEntityItemResolver.d.ts

@@ -3,208 +3,208 @@ import { DocsEntityGroup } from "../../model/docs/entities/SDKDocsEntityGroup";
 import { DocsEntityPage } from "../../model/docs/entities/SDKDocsEntityPage";
 export declare class DocsEntityItemResolver {
     hashedItems: Map<string, {
-        type?: "Page";
-        id?: string;
-        designSystemVersionId?: string;
-        path?: string;
-        createdAt?: Date;
-        updatedAt?: Date;
-        persistentId?: string;
-        title?: string;
-        configuration?: {
-            showSidebar?: boolean;
-            isPrivate?: boolean;
-            isHidden?: boolean;
-            header?: {
-                description?: string;
-                alignment?: "Left" | "Center";
+        id: string;
+        designSystemVersionId: string;
+        createdAt: Date;
+        updatedAt: Date;
+        persistentId: string;
+        title: string;
+        isRoot: boolean;
+        childrenIds: string[];
+        groupBehavior: "Group" | "Tabs";
+        shortPersistentId: string;
+        configuration: {
+            showSidebar: boolean;
+            isPrivate: boolean;
+            isHidden: boolean;
+            header: {
+                description: string;
+                alignment: "Left" | "Center";
+                backgroundImageScaleType: "AspectFill" | "AspectFit";
+                showBackgroundOverlay: boolean;
+                showCoverText: boolean;
                 foregroundColor?: {
-                    value?: string;
+                    value: string;
                     referencedTokenId?: string;
                 };
                 backgroundColor?: {
-                    value?: string;
+                    value: string;
                     referencedTokenId?: string;
                 };
                 backgroundImageAsset?: {
-                    type?: "Resource" | "FigmaNode";
+                    type: "Resource" | "FigmaNode";
                     resource?: {
-                        url?: string;
-                        resourceId?: string;
+                        resourceId: string;
+                        url: string;
                     };
                     figmaNode?: {
-                        sourceId?: string;
-                        frameReferenceId?: string;
+                        sourceId: string;
+                        frameReferenceId: string;
                     };
                 };
-                backgroundImageScaleType?: "AspectFill" | "AspectFit";
-                showBackgroundOverlay?: boolean;
-                showCoverText?: boolean;
                 minHeight?: number;
             };
         };
-        shortPersistentId?: string;
+        type: "Group";
         slug?: string;
         userSlug?: string;
+        publishMetadata?: {
+            lastPublishedByUserId: string;
+            lastPublishedAt: Date;
+        };
+        approvalState?: {
+            persistentId: string;
+            groupPersistentId: string;
+            designSystemVersionId: string;
+            approvalState: "ReadyForReview" | "ChangesRequested" | "Approved";
+        };
         draftState?: {
-            changeType?: "Created";
+            changeType: "Created";
         } | {
-            changeType?: "Updated";
-            changes?: {
+            changeType: "Updated";
+            changes: {
                 previousTitle?: string;
                 previousConfiguration?: {
-                    showSidebar?: boolean;
-                    isPrivate?: boolean;
-                    isHidden?: boolean;
-                    header?: {
-                        description?: string;
-                        alignment?: "Left" | "Center";
+                    showSidebar: boolean;
+                    isPrivate: boolean;
+                    isHidden: boolean;
+                    header: {
+                        description: string;
+                        alignment: "Left" | "Center";
+                        backgroundImageScaleType: "AspectFill" | "AspectFit";
+                        showBackgroundOverlay: boolean;
+                        showCoverText: boolean;
                         foregroundColor?: {
-                            value?: string;
+                            value: string;
                             referencedTokenId?: string;
                         };
                         backgroundColor?: {
-                            value?: string;
+                            value: string;
                             referencedTokenId?: string;
                         };
                         backgroundImageAsset?: {
-                            type?: "Resource" | "FigmaNode";
+                            type: "Resource" | "FigmaNode";
                             resource?: {
-                                url?: string;
-                                resourceId?: string;
+                                resourceId: string;
+                                url: string;
                             };
                             figmaNode?: {
-                                sourceId?: string;
-                                frameReferenceId?: string;
+                                sourceId: string;
+                                frameReferenceId: string;
                             };
                         };
-                        backgroundImageScaleType?: "AspectFill" | "AspectFit";
-                        showBackgroundOverlay?: boolean;
-                        showCoverText?: boolean;
                         minHeight?: number;
                     };
                 };
                 previousContentHash?: string;
             };
         } | {
-            changeType?: "Deleted";
-            deletedAt?: Date;
-            deletedByUserId?: string;
+            changeType: "Deleted";
+            deletedAt: Date;
+            deletedByUserId: string;
         };
-        publishMetadata?: {
-            lastPublishedByUserId?: string;
-            lastPublishedAt?: Date;
-        };
-        approvalState?: {
-            designSystemVersionId?: string;
-            createdAt?: Date;
-            updatedAt?: Date;
-            approvalState?: "ReadyForReview" | "ChangesRequested" | "Approved";
-            pagePersistentId?: string;
-            updatedByUserId?: string;
-        };
-        liveblocksRoomId?: string;
     } | {
-        type?: "Group";
-        id?: string;
-        designSystemVersionId?: string;
-        createdAt?: Date;
-        updatedAt?: Date;
-        persistentId?: string;
-        title?: string;
-        configuration?: {
-            showSidebar?: boolean;
-            isPrivate?: boolean;
-            isHidden?: boolean;
-            header?: {
-                description?: string;
-                alignment?: "Left" | "Center";
+        id: string;
+        persistentId: string;
+        designSystemVersionId: string;
+        title: string;
+        configuration: {
+            showSidebar: boolean;
+            isPrivate: boolean;
+            isHidden: boolean;
+            header: {
+                description: string;
+                alignment: "Left" | "Center";
+                backgroundImageScaleType: "AspectFill" | "AspectFit";
+                showBackgroundOverlay: boolean;
+                showCoverText: boolean;
                 foregroundColor?: {
-                    value?: string;
+                    value: string;
                     referencedTokenId?: string;
                 };
                 backgroundColor?: {
-                    value?: string;
+                    value: string;
                     referencedTokenId?: string;
                 };
                 backgroundImageAsset?: {
-                    type?: "Resource" | "FigmaNode";
+                    type: "Resource" | "FigmaNode";
                     resource?: {
-                        url?: string;
-                        resourceId?: string;
+                        resourceId: string;
+                        url: string;
                     };
                     figmaNode?: {
-                        sourceId?: string;
-                        frameReferenceId?: string;
+                        sourceId: string;
+                        frameReferenceId: string;
                     };
                 };
-                backgroundImageScaleType?: "AspectFill" | "AspectFit";
-                showBackgroundOverlay?: boolean;
-                showCoverText?: boolean;
                 minHeight?: number;
             };
         };
-        shortPersistentId?: string;
+        shortPersistentId: string;
+        createdAt: Date;
+        updatedAt: Date;
+        path: string;
+        type: "Page";
         slug?: string;
         userSlug?: string;
+        publishMetadata?: {
+            lastPublishedByUserId: string;
+            lastPublishedAt: Date;
+        };
+        approvalState?: {
+            approvalState: "ReadyForReview" | "ChangesRequested" | "Approved";
+            pagePersistentId: string;
+            updatedByUserId: string;
+            designSystemVersionId: string;
+            updatedAt: Date;
+            createdAt: Date;
+        };
+        liveblocksRoomId?: string;
         draftState?: {
-            changeType?: "Created";
+            changeType: "Created";
         } | {
-            changeType?: "Updated";
-            changes?: {
+            changeType: "Updated";
+            changes: {
                 previousTitle?: string;
                 previousConfiguration?: {
-                    showSidebar?: boolean;
-                    isPrivate?: boolean;
-                    isHidden?: boolean;
-                    header?: {
-                        description?: string;
-                        alignment?: "Left" | "Center";
+                    showSidebar: boolean;
+                    isPrivate: boolean;
+                    isHidden: boolean;
+                    header: {
+                        description: string;
+                        alignment: "Left" | "Center";
+                        backgroundImageScaleType: "AspectFill" | "AspectFit";
+                        showBackgroundOverlay: boolean;
+                        showCoverText: boolean;
                         foregroundColor?: {
-                            value?: string;
+                            value: string;
                             referencedTokenId?: string;
                         };
                         backgroundColor?: {
-                            value?: string;
+                            value: string;
                             referencedTokenId?: string;
                         };
                         backgroundImageAsset?: {
-                            type?: "Resource" | "FigmaNode";
+                            type: "Resource" | "FigmaNode";
                             resource?: {
-                                url?: string;
-                                resourceId?: string;
+                                resourceId: string;
+                                url: string;
                             };
                             figmaNode?: {
-                                sourceId?: string;
-                                frameReferenceId?: string;
+                                sourceId: string;
+                                frameReferenceId: string;
                             };
                         };
-                        backgroundImageScaleType?: "AspectFill" | "AspectFit";
-                        showBackgroundOverlay?: boolean;
-                        showCoverText?: boolean;
                         minHeight?: number;
                     };
                 };
                 previousContentHash?: string;
             };
         } | {
-            changeType?: "Deleted";
-            deletedAt?: Date;
-            deletedByUserId?: string;
-        };
-        publishMetadata?: {
-            lastPublishedByUserId?: string;
-            lastPublishedAt?: Date;
-        };
-        approvalState?: {
-            designSystemVersionId?: string;
-            persistentId?: string;
-            approvalState?: "ReadyForReview" | "ChangesRequested" | "Approved";
-            groupPersistentId?: string;
+            changeType: "Deleted";
+            deletedAt: Date;
+            deletedByUserId: string;
         };
-        isRoot?: boolean;
-        childrenIds?: string[];
-        groupBehavior?: "Group" | "Tabs";
     }>;
     resolvedItems: Map<string, DocsEntityPage | DocsEntityGroup>;
     resolveMultiplayerItems(pageDetails: Array<DTODocumentationHierarchyV2["pages"][number]>, groupDetails: Array<DTODocumentationHierarchyV2["groups"][number]>): Array<DocsEntityGroup | DocsEntityPage>;

package/build/types/exports.d.ts

@@ -228,6 +228,7 @@ export { DocumentationLegacyRichText } from "./model/documentation/SDKDocumentat
 export { RichTextSpan } from "./model/documentation/SDKDocumentationLegacyRichTextSpan";
 export { RichTextSpanAttribute } from "./model/documentation/SDKDocumentationLegacyRichTextSpanAttribute";
 export { AssetGroup } from "./model/groups/SDKAssetGroup";
+export { ComponentGroup } from "./model/groups/SDKComponentGroup";
 export { DesignComponentGroup } from "./model/groups/SDKDesignComponentGroup";
 export { TokenGroup } from "./model/groups/SDKTokenGroup";
 export { DesignSystemCollection } from "./model/base/SDKDesignSystemCollection";

package/build/types/model/activity-events/SDKActivityEvent.d.ts

@@ -21,6 +21,7 @@ export declare class ActivityEvent {
     action: ActivityEventAction;
     targetType: ActivityEventTargetType;
     targetId: string;
+    targetName: ActivityEventRemoteModel["targetName"];
     targetSubtype: ActivityEventRemoteModel["targetSubtype"];
     parentId: string | undefined;
     changes: ActivityEventChange[];
@@ -38,6 +39,8 @@ export type ActivityEventListFilter = {
     versionId: string;
     /** Scopes the query to one entity's history; omitted reads the whole version */
     targetId?: string;
+    /** Brand persistent ids; the "null" sentinel adds workspace-level rows */
+    brandIds?: string[];
     /** "null" reads root events only, an id reads that parent's children */
     parentId?: DTOActivityEventListInput["parentId"];
     /** Keyset cursor from the previous page; omitted reads the newest page */

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

@@ -21,6 +21,9 @@ export declare class AgentChat {
     eveSessionId: string | undefined;
     name: string;
     isArchived: boolean;
+    isRead: boolean;
+    isInProgress: boolean;
+    lastMessageAt: Date;
     createdAt: Date;
     updatedAt: Date;
     constructor(model: AgentChatRemoteModel);

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

@@ -5,7 +5,7 @@ export type DesignSystemSwitcher = {
     designSystemIds: Array<string>;
 };
 export type DesignSystemAccessMode = "Open" | "InviteOnly";
-export type DesignSystemTransportModel = Pick<DesignSystem, "id" | "name" | "description" | "isPublic" | "isMultiBrand" | "documentationSlug" | "documentationUserSlug" | "documentationExporterId" | "designSystemSwitcher" | "workspaceId">;
+export type DesignSystemTransportModel = Pick<DesignSystem, "id" | "name" | "description" | "isPublic" | "isMultiBrand" | "documentationSlug" | "documentationUserSlug" | "documentationExporterId" | "designSystemSwitcher" | "workspaceId" | "createdAt">;
 export declare class DesignSystem {
     /** Unique identifier of design system */
     id: string;
@@ -45,6 +45,8 @@ export declare class DesignSystem {
     isAvailableToUser: boolean;
     /** Unique identifier of the shared draft version of the design system */
     sharedDraftId: string;
+    /** When the design system was created */
+    createdAt: Date;
     constructor(model: Omit<DTODesignSystem, "isPublic"> & {
         isPublic: boolean;
     });

package/build/types/model/docs/blocks/properties/SDKDocsBlockContextProperty.d.ts

@@ -1,7 +1,7 @@
 import { PageBlockContextConnection, type PageBlockItemContextValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
 import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
-export declare const DocsBlockContextPropertyConnectionValues: ["cursor", "claudeCode", "vsCode", "codex", "codeSnippet", "url"];
+export declare const DocsBlockContextPropertyConnectionValues: ("url" | "cursor" | "claudeCode" | "vsCode" | "codex" | "codeSnippet")[];
 export type DocsBlockContextPropertyConnection = PageBlockContextConnection;
 export type DocsBlockContextPropertyOptions = Record<string, never>;
 /** Context property - Data */

package/build/types/model/exporters/SDKPipeline.d.ts

@@ -16,7 +16,7 @@ export declare class Pipeline {
         documentation?: {
             environment: "Live" | "Preview";
         };
-        s3?: Record<string, unknown>;
+        s3?: Record<string, never>;
         github?: {
             url: string;
             branch: string;

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

@@ -1,22 +1,48 @@
 import { Brand } from "../../../model/base/SDKBrand";
 import { DTOriginalTokenType } from "../../../model/enums/SDKTokenType";
 import { AnyToken } from "../../../model/tokens/SDKTokenValue";
-import { DTParsedNode } from "./SDKDTJSONLoader";
-import { DTPluginToSupernovaMapPack } from "./SDKDTMapLoader";
+import { DTParsedNode, DTParsedThemeSetPriority, DTParsedTokenSet } from "./SDKDTJSONLoader";
+import { DTPluginSourceMode, DTPluginToSupernovaMapPack, DTPluginUnresolvableFallback, DTPluginUnresolvableRefMode } 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;
-    constructor(versionId: string, mapping: DTPluginToSupernovaMapPack);
+    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);
     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,6 +7,8 @@ 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,6 +15,31 @@ 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 = {
@@ -42,6 +67,9 @@ export type DTPluginToSupernovaMappingFile = {
         dryRun?: boolean;
         preciseCopy?: boolean | DTPluginPreciseCopyStrategy;
         themeOverridesStrategy?: DTPluginThemeOverrideStrategy;
+        sourceMode?: DTPluginSourceMode;
+        unresolvableRefMode?: DTPluginUnresolvableRefMode;
+        unresolvableFallback?: DTPluginUnresolvableFallback;
     };
 };
 export type DTPluginToSupernovaSettings = {
@@ -49,4 +77,7 @@ 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,4 +45,6 @@ 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/design-tokens/utilities/unresolvable-modes/index.d.ts

@@ -0,0 +1,4 @@
+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

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

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

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

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

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

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

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

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

@@ -0,0 +1,33 @@
+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;

package/package.json

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