@supernova-studio/supernova-sdk-beta 1.6.48 → 2.0.17

package/build/sdk-typescript/src/model/exporters/SDKPipeline.d.ts

@@ -1,13 +1,11 @@
+import { DTOPipeline } from "@supernova-studio/client";
 import { ExportBuild } from "./exporter_builds/SDKExportBuild";
-import { PipelineRemoteModel } from "./remote/SDKRemotePipelineModel";
 export type GithubDestinationPayload = {
-    connectionId: string;
     branch: string;
     relativePath: string;
     url: string;
 };
 export type AzureDestinationPayload = {
-    connectionId: string;
     organizationId: string;
     projectId: string;
     repositoryId: string;
@@ -15,7 +13,6 @@ export type AzureDestinationPayload = {
     relativePath: string;
 };
 export type BitbucketDestinationPayload = {
-    connectionId: string;
     workspaceSlug: string;
     projectKey: string;
     repoSlug: string;
@@ -23,7 +20,6 @@ export type BitbucketDestinationPayload = {
     relativePath: string;
 };
 export type GitlabDestinationPayload = {
-    connectionId: string;
     projectId: string;
     branch: string;
     relativePath: string;
@@ -31,9 +27,15 @@ export type GitlabDestinationPayload = {
 export type DocumentationDestinationPayload = {
     environment: "Live" | "Preview";
 };
+export type GitObjectQuery = {
+    organization?: string;
+    project?: string;
+    repository?: string;
+};
+export type NewPipelinePayloadDestination = "Github" | "Gitlab" | "Bitbucket" | "Azure" | "WebhookUrl" | "S3" | "Documentation";
 export type NewPipelinePayload = {
-    brandId?: string;
-    themeId?: string;
+    brandPersistentId?: string;
+    themePersistentId?: string;
     designSystemId: string;
     destinations: {
         azure: AzureDestinationPayload | null;
@@ -48,66 +50,59 @@ export type NewPipelinePayload = {
     exporterId: string;
     isEnabled: boolean;
     name: string;
+    destination: NewPipelinePayloadDestination;
+    gitQuery: GitObjectQuery;
 };
-export type PipelineUpdateModel = Omit<PipelineRemoteModel, "latestJobs" | "workspaceId" | "designSystem">;
+export type PipelineUpdateModel = Omit<DTOPipeline, "latestJobs" | "workspaceId" | "designSystem">;
 export declare class Pipeline {
     id: string;
     workspaceId: string;
-    designSystem: {
-        id: string;
-        meta: {
-            name: string;
-            description: string;
-        };
-    };
+    designSystemId: string;
     name: string;
     isEnabled: boolean;
-    eventType: "OnVersionReleased" | "OnHeadChanged" | "OnSourceUpdated";
+    eventType: "OnVersionReleased" | "OnHeadChanged" | "OnSourceUpdated" | "None";
     exporterId: string;
     destinations: {
-        webhookUrl: string | null;
-        documentation: {
+        webhookUrl?: string;
+        documentation?: {
             environment: "Live" | "Preview";
-        } | null;
-        s3: Record<any, any> | null;
-        github: {
-            connectionId: string;
+        };
+        s3?: Record<any, any>;
+        github?: {
             url: string;
             branch: string;
-            relativePath: string;
-        } | null;
-        azure: {
-            connectionId: string;
+            relativePath?: string;
+        };
+        azure?: {
             organizationId: string;
             projectId: string;
             repositoryId: string;
             branch: string;
-            relativePath: string;
-            url: string;
-        } | null;
-        gitlab: {
-            connectionId: string;
+            relativePath?: string;
+            url?: string;
+        };
+        gitlab?: {
             projectId: string;
             branch: string;
-            relativePath: string;
-            url: string;
-        } | null;
-        bitbucket: {
-            connectionId: string;
+            relativePath?: string;
+            url?: string;
+        };
+        bitbucket?: {
             workspaceSlug: string;
             projectKey: string;
             repoSlug: string;
             branch: string;
-            relativePath: string;
-            url: string;
-        } | null;
+            relativePath?: string;
+            url?: string;
+        };
     };
-    brandId: string | null;
-    themeId: string | null;
+    brandPersistentId?: string;
+    themePersistentId?: string;
     latestJobs: Array<ExportBuild>;
-    constructor(data: PipelineRemoteModel);
+    constructor(data: DTOPipeline);
     get isBuildOnly(): boolean;
     get gitProviderType(): "github" | "bitbucket" | "gitlab" | "azure" | null;
-    get toRemoteModel(): PipelineRemoteModel;
+    get toRemoteModel(): DTOPipeline;
     get isRunning(): boolean;
+    private parseLatestJobs;
 }

package/build/sdk-typescript/src/model/exporters/exporter_builds/SDKExportBuild.d.ts

@@ -22,8 +22,8 @@ export declare enum ExportBuildStatus {
 export type ExportBuildModel = {
     index: number | null;
     id: string;
-    createdAt: string;
-    finishedAt: string | null;
+    createdAt: Date;
+    finishedAt: Date;
     designSystem: {
         id: string;
         meta: {
@@ -40,15 +40,15 @@ export type ExportBuildModel = {
         version: string;
         isReadonly: boolean;
     };
-    result: ExportBuildResult | null;
+    result: ExportBuildResult;
     status: ExportBuildStatus;
     estimatedExecutionTime: number | null;
     createdBy: ExportBuildCreatedBy | null;
     destinations: ExportDestinations;
     scheduleId: string | null;
     exporterId: string;
-    brandId: string | null;
-    themeId: string | null;
+    brandPersistentId: string | null;
+    themePersistentId: string | null;
 };
 /** Build run entry */
 export declare class ExportBuild {
@@ -65,7 +65,7 @@ export declare class ExportBuild {
         id: string;
         meta: {
             name: string;
-            description: string;
+            description?: string;
         };
     };
     /** The version of the design system used in the export build */
@@ -73,7 +73,7 @@ export declare class ExportBuild {
         id: string;
         meta: {
             name: string;
-            description: string;
+            description?: string;
         };
         version: string;
         isReadonly: boolean;

package/build/sdk-typescript/src/model/exporters/exporter_builds/SDKExportBuildResults.d.ts

@@ -1,13 +1,16 @@
 export type S3ExportBuildResultModel = {
-    urls: Array<string>;
-    url: string;
+    bucket: string;
+    files: Array<string>;
+    path: string;
 };
 /** The type definition for the data model of an S3 export build result. */
 export declare class S3ExportBuildResult {
+    /** The S3 bucket associated with the export build result */
+    bucket: string;
     /** An array of URLs associated with the export build result */
-    urls: Array<string>;
+    files: Array<string>;
     /** A URL associated with the export build result */
-    url: string;
+    path: string;
     constructor(data: S3ExportBuildResultModel);
 }
 export type ExportBuildPullRequestResultModel = {
@@ -55,30 +58,30 @@ export declare class ExportBuildResultLog {
 }
 export type ExportBuildResultModel = {
     logs: Array<ExportBuildResultLog>;
-    s3: S3ExportBuildResult | null;
-    azure: ExportBuildPullRequestResult | null;
-    bitbucket: ExportBuildPullRequestResult | null;
-    github: ExportBuildPullRequestResult | null;
-    gitlab: ExportBuildPullRequestResult | null;
-    documentation: ExportBuildDocumentationResult | null;
-    error: string | null;
+    s3?: S3ExportBuildResult;
+    azure?: ExportBuildPullRequestResult;
+    bitbucket?: ExportBuildPullRequestResult;
+    github?: ExportBuildPullRequestResult;
+    gitlab?: ExportBuildPullRequestResult;
+    documentation?: ExportBuildDocumentationResult;
+    error?: string;
 };
 export declare class ExportBuildResult {
     /** An array of log entries associated with the export build result */
     logs: Array<ExportBuildResultLog>;
     /** The S3 export build result, or null if not available */
-    s3: S3ExportBuildResult | null;
+    s3?: S3ExportBuildResult;
     /** The Azure export build pull request result, or null if not available */
-    azure: ExportBuildPullRequestResult | null;
+    azure?: ExportBuildPullRequestResult;
     /** The Bitbucket export build pull request result, or null if not available */
-    bitbucket: ExportBuildPullRequestResult | null;
+    bitbucket?: ExportBuildPullRequestResult;
     /** The GitHub export build pull request result, or null if not available */
-    github: ExportBuildPullRequestResult | null;
+    github?: ExportBuildPullRequestResult;
     /** The GitLab export build pull request result, or null if not available */
-    gitlab: ExportBuildPullRequestResult | null;
+    gitlab?: ExportBuildPullRequestResult;
     /** The documentation build result, or null if not available */
-    documentation: ExportBuildDocumentationResult | null;
+    documentation?: ExportBuildDocumentationResult;
     /** The error message, or null if not available */
-    error: string | null;
+    error?: string;
     constructor(data: ExportBuildResultModel);
 }

package/build/sdk-typescript/src/model/exporters/remote/SDKRemotePipelineModel.d.ts

@@ -2,30 +2,24 @@ import { ExportBuildModel } from "../exporter_builds/SDKExportBuild";
 export type PipelineRemoteModel = {
     id: string;
     workspaceId: string;
-    designSystem: {
-        id: string;
-        meta: {
-            name: string;
-            description: string;
-        };
-    };
+    designSystemId: string;
     name: string;
     isEnabled: boolean;
     eventType: "OnVersionReleased" | "OnHeadChanged" | "OnSourceUpdated";
     exporterId: string;
     destinations: {
         webhookUrl: string | null;
-        documentation: {
+        destinationSnDocs: {
             environment: "Live" | "Preview";
         } | null;
-        s3: Record<any, any> | null;
-        github: {
+        destinationS3: Record<any, any> | null;
+        destinationGithub: {
             connectionId: string;
             url: string;
             branch: string;
             relativePath: string;
         } | null;
-        azure: {
+        destinationAzure: {
             connectionId: string;
             organizationId: string;
             projectId: string;
@@ -34,14 +28,14 @@ export type PipelineRemoteModel = {
             relativePath: string;
             url: string;
         } | null;
-        gitlab: {
+        destinationGitlab: {
             connectionId: string;
             projectId: string;
             branch: string;
             relativePath: string;
             url: string;
         } | null;
-        bitbucket: {
+        destinationBitbucket: {
             connectionId: string;
             workspaceSlug: string;
             projectKey: string;
@@ -51,7 +45,7 @@ export type PipelineRemoteModel = {
             url: string;
         } | null;
     };
-    brandId: string | null;
-    themeId: string | null;
+    brandPersistentId: string | null;
+    themePersistentId: string | null;
     latestJobs: Array<ExportBuildModel> | null;
 };

package/build/sdk-typescript/src/model/support/SDKTokenOrigin.d.ts

@@ -6,6 +6,8 @@ export type TokenOriginModel = {
     sourceType?: SourceType;
     referenceOriginId?: string;
     referencePersistentId?: string;
+    referenceResolutionFailed?: boolean;
+    key?: string;
 };
 export declare class TokenOrigin {
     id: string | null;
@@ -14,5 +16,7 @@ export declare class TokenOrigin {
     sourceType?: SourceType | null;
     referenceOriginId?: string | null;
     referencePersistentId?: string | null;
+    referenceResolutionFailed?: boolean | null;
+    key?: string | null;
     constructor(model: TokenOriginModel);
 }

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

@@ -16,6 +16,8 @@ export type TokenRemoteModel = {
         sourceId?: string;
         referenceOriginId?: string;
         referencePersistentId?: string;
+        referenceResolutionFailed?: boolean;
+        key?: string;
     };
     data: {
         aliasTo?: string;

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

@@ -1,7 +1,9 @@
 import { UserProfile, UserProfileRemoteModel, UserProfileTransportModel } from "./SDKUserProfile";
+type UserSource = "SignUp" | "Invite" | "SSO";
 export type UserRemoteModel = {
     id: string;
     email: string;
+    source: UserSource | null;
     createdAt: string;
     profile: UserProfileRemoteModel;
     linkedIntegrations?: LinkedIntegrations;
@@ -21,7 +23,7 @@ type UserLinkedIntegration = {
     avatarUrl?: string;
     customUrl?: string;
 };
-export type UserTransportModel = Pick<User, "id" | "email"> & {
+export type UserTransportModel = Pick<User, "id" | "email" | "source"> & {
     createdAt: string;
     profile: UserProfileTransportModel;
     linkedIntegrations?: LinkedIntegrations;
@@ -38,6 +40,8 @@ export declare class User {
     createdAt: Date | null;
     /** User profile */
     profile: UserProfile;
+    /** Source of user account */
+    source: UserSource | null;
     /** Linked integrations */
     linkedIntegrations: LinkedIntegrations | null;
     constructor(model: UserRemoteModel);

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

@@ -1,7 +1,12 @@
-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 declare const UserOnboardingDepartments: readonly ["Design", "Product", "Engineering", "Brand", "Other"];
+export type UserOnboardingDepartment = (typeof UserOnboardingDepartments)[number];
+export declare const UserOnboardingJobLevels: readonly ["Executive", "Manager", "IndividualContributor", "Other"];
+export type UserOnboardingJobLevel = (typeof UserOnboardingJobLevels)[number];
+export declare const UserOnboardingCompanySizes: readonly ["Just me", "2 - 49", "50 - 249", "250 - 999", "1,000 - 4,999", "5,000 - 9,999", "More than 10,000"];
+export type UserOnboardingCompanySize = (typeof UserOnboardingCompanySizes)[number];
+export declare const UserOnboardingDesignSystemTeamSizes: readonly ["We don’t have a design system team", "Only one person", "2 - 5", "6 - 10", "More than 10"];
+export type UserOnboardingDesignSystemTeamSize = (typeof UserOnboardingDesignSystemTeamSizes)[number];
+export type UserOnboardingDefaultDestination = "tokens" | "docs";
 export type UserProfileRemoteModel = {
     name?: string;
     nickname?: string;
@@ -11,12 +16,15 @@ export type UserProfileRemoteModel = {
 };
 export type UserProfileOnboardingRemoteModel = {
     companyName?: string;
-    numberOfPeopleInOrg?: string;
-    numberOfPeopleInDesignTeam?: string;
-    department?: UserOnboardingDepartmentType;
+    numberOfPeopleInOrg?: UserOnboardingCompanySize;
+    numberOfPeopleInDesignTeam?: UserOnboardingDesignSystemTeamSize;
+    department?: UserOnboardingDepartment;
     jobTitle?: string;
     phase?: string;
-    jobLevel?: UserOnboardingJobLevelType;
+    jobLevel?: UserOnboardingJobLevel;
+    designSystemName?: string;
+    figmaUrl?: string;
+    defaultDestination?: UserOnboardingDefaultDestination;
 };
 export type UserProfileTransportModel = UserProfileRemoteModel;
 export type UserProfileOnboardingUpdateModel = UserProfileOnboardingRemoteModel;
@@ -37,12 +45,15 @@ export declare class UserProfile {
     /** Onboarding object */
     onboarding: {
         companyName: string | null;
-        numberOfPeopleInOrg: string | null;
-        numberOfPeopleInDesignTeam: string | null;
-        department: UserOnboardingDepartmentType | null;
+        numberOfPeopleInOrg: UserOnboardingCompanySize | null;
+        numberOfPeopleInDesignTeam: UserOnboardingDesignSystemTeamSize | null;
+        department: UserOnboardingDepartment | null;
         jobTitle: string | null;
         phase: string | null;
-        jobLevel: UserOnboardingJobLevelType | null;
+        jobLevel: UserOnboardingJobLevel | null;
+        designSystemName: string | null;
+        figmaUrl: string | null;
+        defaultDestination: UserOnboardingDefaultDestination | null;
     } | null;
     constructor(model: UserProfileRemoteModel);
     /** Constructs directly manipulable update object for user profile */

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

@@ -0,0 +1,16 @@
+export type LiveblocksNotificationSettings = {
+    sendCommentNotificationEmails: boolean;
+};
+export type UserWorkspaceNotificationSettingsRemoteModel = {
+    liveblocksNotificationSettings: LiveblocksNotificationSettings;
+};
+export type UserWorkspaceNotificationSettingsUpdateModel = UserWorkspaceNotificationSettingsRemoteModel;
+export declare class UserWorkspaceNotificationSettings {
+    liveblocksNotificationSettings: LiveblocksNotificationSettings;
+    constructor(model: UserWorkspaceNotificationSettingsRemoteModel);
+    static initial(): UserWorkspaceNotificationSettings;
+    toUpdateObject(): UserWorkspaceNotificationSettingsUpdateModel;
+    toRemote(): UserWorkspaceNotificationSettingsRemoteModel;
+    toTransport(): UserWorkspaceNotificationSettingsRemoteModel;
+    static fromTransport(model: UserWorkspaceNotificationSettingsRemoteModel): UserWorkspaceNotificationSettings;
+}

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

@@ -1,6 +1,8 @@
+import { DTOIntegrationCredentials } from "@supernova-studio/client";
 import { OAuth2IntegrationTypes } from "./SDKWorkspaceIntegrationOauthRequest";
 export type WorkspaceIntegrationsRemoteModel = {
     integrations: Array<WorkspaceIntegrationType>;
+    hasFigmaIntegration: boolean;
 };
 export type WorkspaceLinkedIntegrations = {
     Figma?: WorkspaceIntegrationType[];
@@ -11,36 +13,17 @@ export type WorkspaceLinkedIntegrations = {
     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 WorkspaceIntegrationCredential = DTOIntegrationCredentials & {
+    profile: NonNullable<DTOIntegrationCredentials["profile"]>;
+    user: NonNullable<DTOIntegrationCredentials["user"]>;
+    state: "Active" | "Inactive";
 };
 type WorkspaceIntegrationDesignSystem = {
     brandId: string;
     designSystemId: string;
     date: string;
     title?: string;
-    user: WorkspaceIntegrationUser;
+    user?: DTOIntegrationCredentials["user"];
 };
 export type WorkspaceIntegrationType = {
     id: string;
@@ -70,6 +53,7 @@ export declare class WorkspaceIntegration implements WorkspaceIntegrationType {
 export declare class WorkspaceIntegrations {
     /** List of integrations of the workspace */
     integrations: Array<WorkspaceIntegrationType>;
+    get hasFigmaIntegration(): boolean;
     constructor(model: WorkspaceIntegrationsRemoteModel);
 }
 export {};

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

@@ -0,0 +1,15 @@
+export declare const GitProviderEndpoints: {
+    readonly Organizations: "organizations";
+    readonly Projects: "projects";
+    readonly Repositories: "repositories";
+    readonly Branches: "branches";
+};
+export type GitProviderEndpointsKeys = keyof typeof GitProviderEndpoints;
+export type GitProviderValues = (typeof GitProviderEndpoints)[GitProviderEndpointsKeys];
+export type WorkspaceIntegrationGetGitProvidersInput = {
+    organization?: string;
+    project?: string;
+    repository?: string;
+    branch?: string;
+    user?: string;
+};

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

@@ -0,0 +1,13 @@
+import { DTOGitBranch } from "@supernova-studio/client";
+export type GitProviderBranchesRemoteModel = {
+    branches: Array<DTOGitBranch>;
+};
+export declare class GitProvidersBranch implements DTOGitBranch {
+    name: string;
+    lastCommitId: string;
+    constructor(model: DTOGitBranch);
+}
+export declare class GitProvidersBranches {
+    branches: Array<GitProvidersBranch>;
+    constructor(model: GitProviderBranchesRemoteModel);
+}

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

@@ -0,0 +1,15 @@
+import { DTOGitOrganization } from "@supernova-studio/client";
+export type GitProvidersOrganizationsRemoteModel = {
+    organizations: Array<DTOGitOrganization>;
+};
+export declare class GitProvidersOrganization implements DTOGitOrganization {
+    id: string;
+    name: string;
+    url: string;
+    slug: string;
+    constructor(model: DTOGitOrganization);
+}
+export declare class GitProvidersOrganizations {
+    organizations: Array<GitProvidersOrganization>;
+    constructor(model: GitProvidersOrganizationsRemoteModel);
+}

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

@@ -0,0 +1,15 @@
+import { DTOGitProject } from "@supernova-studio/client";
+export type GitProvidersProjectsRemoteModel = {
+    projects: Array<DTOGitProject>;
+};
+export declare class GitProvidersProject implements DTOGitProject {
+    id: string;
+    name: string;
+    url: string;
+    slug: string;
+    constructor(model: DTOGitProject);
+}
+export declare class GitProvidersProjects {
+    projects: Array<GitProvidersProject>;
+    constructor(model: GitProvidersProjectsRemoteModel);
+}

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

@@ -0,0 +1,16 @@
+import { DTOGitRepository } from "@supernova-studio/client";
+export type GitProvidersRepositoriesRemoteModel = {
+    repositories: Array<DTOGitRepository>;
+};
+export declare class GitProvidersRepository implements DTOGitRepository {
+    id: string;
+    name: string;
+    url: string;
+    defaultBranch: string | undefined;
+    slug: string;
+    constructor(model: DTOGitRepository);
+}
+export declare class GitProvidersRepositories {
+    repositories: Array<GitProvidersRepository>;
+    constructor(model: GitProvidersRepositoriesRemoteModel);
+}

package/build/sdk-typescript/src/tools/docs-block-builder/SDKDocsBlockBuilder.d.ts

@@ -13,6 +13,7 @@ import { DocsBlockComponentPropertyDefinition, DocsBlockComponentPropertyOptions
 import { DocsBlockComponentPropertyPropertyDefinition, DocsBlockComponentPropertyPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockComponentPropertyProperty";
 import { DocsBlockDividerPropertyDefinition, DocsBlockDividerPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockDividerProperty";
 import { DocsBlockEmbedUrlPropertyDefinition, DocsBlockEmbedUrlPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockEmbedUrlProperty";
+import { DocsBlockFigmaComponentPropertyDefinition, DocsBlockFigmaComponentPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockFigmaComponentProperty";
 import { DocsBlockFigmaNodePropertyDefinition } from "../../model/docs/blocks/properties/SDKDocsBlockFigmaNodeProperty";
 import { DocsBlockImagePropertyDefinition, DocsBlockImagePropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockImageProperty";
 import { DocsBlockMarkdownPropertyDefinition, DocsBlockMarkdownPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockMarkdownProperty";
@@ -296,6 +297,16 @@ export declare class DocsBlockBuilder {
             [key: string]: DocsBlockComponentPropertyPropertyOptions;
         };
     }): DocsBlockComponentPropertyPropertyDefinition;
+    /** Create a block property with type .figmaComponentProperty and its specific options */
+    figmaComponentProperty(configuration: {
+        id: string;
+        name: string;
+        description?: string;
+        options: DocsBlockFigmaComponentPropertyOptions;
+        variants?: {
+            [key: string]: DocsBlockFigmaComponentPropertyOptions;
+        };
+    }): DocsBlockFigmaComponentPropertyDefinition;
     /** Create a block property with type .asset and its specific options */
     assetProperty(configuration: {
         id: string;

package/build/sdk-typescript/src/tools/token-preview/TokenUtilPreviewTypes.d.ts

@@ -2,11 +2,13 @@ export type TokenUtilPreviewTokenValueSegment = {
     value: string;
     referencedName?: string;
     prefersReferenceName?: boolean;
+    referenceResolutionFailed?: boolean;
 };
 export type TokenUtilPreviewTokenType = "blur" | "border" | "borderWidth" | "color" | "copy" | "fontFamily" | "fontSize" | "fontWeight" | "dimension" | "duration" | "gradient" | "lineHeight" | "letterSpacing" | "opacity" | "paragraphSpacing" | "radius" | "shadow" | "size" | "space" | "string" | "textCase" | "textDecoration" | "typography" | "visibility" | "zIndex";
 export type TokenUtilPreviewMetadata = {
     displayValue: string;
     referencedTo?: string;
+    referenceResolutionFailed?: boolean;
     tokenType: TokenUtilPreviewTokenType;
 } & ({
     meta?: null;