@supernova-studio/supernova-sdk-beta 0.7.17

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockComponentProperty.d.ts

@@ -0,0 +1,23 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** Component property - Additional non-value options */
+export type DocsBlockComponentPropertyOptions = {
+    /** How should the tokens be rendered in editor */
+    renderLayoutAs?: "List" | "Table";
+    /** Whether to allow selecting component custom properties. True by default */
+    allowPropertySelection?: boolean;
+};
+/** Component property - Data */
+export type DocsBlockComponentPropertyData = DocsBlockPropertyData<Array<{
+    entityId: string;
+    entityType: "Component" | "ComponentGroup";
+}>> & {
+    /** Selected component ids */
+    selectedPropertyIds?: Array<string>;
+};
+/** Component property - Definition model */
+export type DocsBlockComponentPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockComponentPropertyOptions;
+/** Component property - Definition */
+export declare class DocsBlockComponentPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockComponentPropertyOptions, DocsBlockComponentPropertyData> {
+    type: DocsBlockItemPropertyType.component;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockComponentPropertyProperty.d.ts

@@ -0,0 +1,12 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** ComponentProperty property - Additional non-value options */
+export type DocsBlockComponentPropertyPropertyOptions = Record<string, never>;
+/** ComponentProperty property - Data */
+export type DocsBlockComponentPropertyPropertyData = DocsBlockPropertyData<string> & Record<string, never>;
+/** ComponentProperty property - Definition model */
+export type DocsBlockComponentPropertyPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockComponentPropertyPropertyOptions;
+/** ComponentProperty property - Definition */
+export declare class DocsBlockComponentPropertyPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockComponentPropertyPropertyOptions, DocsBlockComponentPropertyPropertyData> {
+    type: DocsBlockItemPropertyType.componentProperty;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockDividerProperty.d.ts

@@ -0,0 +1,12 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** Divider property - Additional non-value options */
+export type DocsBlockDividerPropertyOptions = Record<string, never>;
+/** Divider property - Data */
+export type DocsBlockDividerPropertyData = DocsBlockPropertyData<never> & Record<string, never>;
+/** Divider property - Definition model */
+export type DocsBlockDividerPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockDividerPropertyOptions;
+/** Divider property - Definition */
+export declare class DocsBlockDividerPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockDividerPropertyOptions, DocsBlockDividerPropertyData> {
+    type: DocsBlockItemPropertyType.divider;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockEmbedUrlProperty.d.ts

@@ -0,0 +1,25 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
+/** EmbedUrl property - Additional non-value options */
+export type DocsBlockEmbedUrlPropertyOptions = {
+    /** Defines what should be the default height of the embed */
+    defaultHeight: number;
+    /** If enabled, additional text can be provided for the embed property */
+    allowCaption?: boolean;
+    /** If enabled, the embed can be resized */
+    allowResize?: boolean;
+    /** Defined how to validate the embed URL */
+    urlValidationRegex?: string;
+};
+/** EmbedUrl property - Data */
+export type DocsBlockEmbedUrlPropertyData = DocsBlockPropertyData<string | undefined> & {
+    alt?: string;
+    caption?: string;
+    height?: number;
+};
+/** EmbedUrl property - Definition model */
+export type DocsBlockEmbedUrlPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockEmbedUrlPropertyOptions;
+/** EmbedUrl property - Definition */
+export declare class DocsBlockEmbedUrlPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockEmbedUrlPropertyOptions, DocsBlockEmbedUrlPropertyData> {
+    type: DocsBlockItemPropertyType.embedURL;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockFigmaNodeProperty.d.ts

@@ -0,0 +1,30 @@
+import { DocsBlockContainerSize } from "../../../enums/SDKDocsBlockContainerSize";
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsColorRef } from "../support/SDKDocsColorRef";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** FigmaNode property - Additional non-value options */
+export type DocsBlockFigmaNodePropertyOptions = Record<string, never>;
+/** FigmaNode property - Data */
+export type DocsBlockFigmaNodePropertyData = DocsBlockPropertyData<Array<{
+    entityId: string;
+    entityMeta?: {
+        title?: string;
+        description?: string;
+        backgroundColor?: DocsColorRef | null;
+    };
+}>> & {
+    /** Behavior of container size */
+    previewContainerSize?: DocsBlockContainerSize.centered | DocsBlockContainerSize.naturalHeight;
+    /** If enabled, search is visible */
+    showSearch?: boolean;
+    /** Number of columns */
+    columns?: number;
+    /** Shows details of each frame, or hides them all */
+    showFrameDetails?: boolean;
+};
+/** FigmaNode property - Definition model */
+export type DocsBlockFigmaNodePropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockFigmaNodePropertyOptions;
+/** FigmaNode property - Definition */
+export declare class DocsBlockFigmaNodePropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockFigmaNodePropertyOptions, DocsBlockFigmaNodePropertyData> {
+    type: DocsBlockItemPropertyType.figmaNode;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockImageProperty.d.ts

@@ -0,0 +1,25 @@
+import { Alignment } from "../../../enums/SDKAlignment";
+import { DocsBlockImagePropertyAspectRatio } from "../../../enums/SDKDocsBlockImagePropertyAspectRatio";
+import { DocsBlockImagePropertyWidth } from "../../../enums/SDKDocsBlockImagePropertyWidth";
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsImageRef } from "../support/SDKDocsImageRef";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
+/** Image property - Additional non-value options */
+export type DocsBlockImagePropertyOptions = {
+    width?: DocsBlockImagePropertyWidth;
+    aspectRatio?: DocsBlockImagePropertyAspectRatio;
+    allowCaption?: boolean;
+    recommendation?: string;
+};
+/** Image property - Data */
+export type DocsBlockImagePropertyData = DocsBlockPropertyData<DocsImageRef | undefined> & {
+    alt: string;
+    caption?: string;
+    alignment?: Alignment;
+};
+/** Image property - Definition model */
+export type DocsBlockImagePropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockImagePropertyOptions;
+/** Image property - Definition */
+export declare class DocsBlockImagePropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockImagePropertyOptions, DocsBlockImagePropertyData> {
+    type: DocsBlockItemPropertyType.image;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockMarkdownProperty.d.ts

@@ -0,0 +1,15 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** Markdown property - Additional non-value options */
+export type DocsBlockMarkdownPropertyOptions = {
+    /** Defines how to validate the markdown URL */
+    urlValidationRegex?: string;
+};
+/** Markdown property - Data */
+export type DocsBlockMarkdownPropertyData = DocsBlockPropertyData<string> & Record<string, never>;
+/** Markdown property - Definition model */
+export type DocsBlockMarkdownPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockMarkdownPropertyOptions;
+/** Markdown property - Definition */
+export declare class DocsBlockMarkdownPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockMarkdownPropertyOptions, DocsBlockMarkdownPropertyData> {
+    type: DocsBlockItemPropertyType.markdown;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockMultiRichTextProperty.d.ts

@@ -0,0 +1,19 @@
+import { DocumentationLegacyRichTextModel } from "../../../documentation/SDKDocumentationLegacyRichText";
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockMultiRichTextPropertyStyle } from "../../../enums/SDKDocsBlockMultiRichTextPropertyStyle";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** RichText property - Additional non-value options */
+export type DocsBlockMultiRichTextPropertyOptions = {
+    /** Placeholder to show when rich text area is empty */
+    placeholder?: string;
+    /** Visual style of the rich text property */
+    multiRichTextStyle?: DocsBlockMultiRichTextPropertyStyle;
+};
+/** RichText property - Data */
+export type DocsBlockMultiRichTextPropertyData = DocsBlockPropertyData<Array<DocumentationLegacyRichTextModel>>;
+/** RichText property - Definition model */
+export type DocsBlockRichTextPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockMultiRichTextPropertyOptions;
+/** RichText property - Definition */
+export declare class DocsBlockMultiRichTextPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockMultiRichTextPropertyOptions, DocsBlockMultiRichTextPropertyData> {
+    type: DocsBlockItemPropertyType.multiRichText;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockMultiSelectProperty.d.ts

@@ -0,0 +1,21 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockOptionRenderingStyle } from "../../../enums/SDKDocsBlockOptionRenderStyle";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** MultiSelect property - Additional non-value options */
+export type DocsBlockMultiSelectPropertyOptions = {
+    defaultChoices: Array<string>;
+    choices: Array<{
+        value: string;
+        name: string;
+        icon?: string;
+    }>;
+    multiSelectStyle?: Exclude<DocsBlockOptionRenderingStyle, DocsBlockOptionRenderingStyle.toggleButton>;
+};
+/** MultiSelect property - Data */
+export type DocsBlockMultiSelectPropertyData = DocsBlockPropertyData<Array<string>> & Record<string, never>;
+/** MultiSelect property - Definition model */
+export type DocsBlockMultiSelectPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockMultiSelectPropertyOptions;
+/** MultiSelect property - Definition */
+export declare class DocsBlockMultiSelectPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockMultiSelectPropertyOptions, DocsBlockMultiSelectPropertyData> {
+    type: DocsBlockItemPropertyType.multiSelect;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockNumberProperty.d.ts

@@ -0,0 +1,23 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** Number property - Additional non-value options */
+export type DocsBlockNumberPropertyOptions = {
+    /** Default value to set when block is created */
+    defaultValue: number;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Step value */
+    step?: number;
+    /** Field placeholder */
+    placeholder?: string;
+};
+/** Number property - Data */
+export type DocsBlockNumberPropertyData = DocsBlockPropertyData<number> & Record<string, never>;
+/** Number property - Definition model */
+export type DocsBlockNumberPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockNumberPropertyOptions;
+/** Number property - Definition */
+export declare class DocsBlockNumberPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockNumberPropertyOptions, DocsBlockNumberPropertyData> {
+    type: DocsBlockItemPropertyType.number;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockProperty.d.ts

@@ -0,0 +1,30 @@
+import { PageBlockDefinitionProperty } from "@supernova-studio/model";
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+export type DocsBlockPropertyDefinitionModel = PageBlockDefinitionProperty;
+export type DocsBlockPropertyData<T> = {
+    value: T;
+};
+/** Generic property definition for when we don't care about specific types in options, just want to use the property high-level data */
+export type DocsBlockItemPropertyAnyDefinition = DocsBlockPropertyDefinition<any, DocsBlockPropertyData<any>>;
+export declare class DocsBlockPropertyDefinition<T extends object, D extends DocsBlockPropertyData<any>> {
+    /** Property id, validated to be unique within a block, but not necessarily unique across all blocks */
+    id: string;
+    /** Human readable name that will show in the editor */
+    name: string;
+    /** Property type. There are many different types of properties, explained later */
+    type: DocsBlockItemPropertyType;
+    /** Human readable description that will show next to the property */
+    description: string | null;
+    /** Options specific to this property type */
+    options: T | null;
+    /**
+     * Overrides of options for different variants.
+     * Key/s must be set as id of the variant for override to go into effect.
+     * Options are resolved as variantOptions[key] > options > default for any variant.
+     * It is possible to override only a subset of options, in which case combination of default option settings and the override goes into effect */
+    variantOptions: {
+        [key: string]: T;
+    } | null;
+    constructor(model: DocsBlockPropertyDefinitionModel);
+    defaultData(): D;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockRichTextProperty.d.ts

@@ -0,0 +1,23 @@
+import { DocumentationLegacyRichTextModel } from "../../../documentation/SDKDocumentationLegacyRichText";
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockRichTextPropertyStyle } from "../../../enums/SDKDocsBlockRichTextPropertyStyle";
+import { DocumentationLegacyCalloutType } from "../../../enums/SDKDocumentationLegacyCalloutType";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** RichText property - Additional non-value options */
+export type DocsBlockRichTextPropertyOptions = {
+    /** Placeholder to show when rich text area is empty */
+    placeholder?: string;
+    /** Visual style of the rich text property */
+    richTextStyle?: DocsBlockRichTextPropertyStyle;
+};
+/** RichText property - Data */
+export type DocsBlockRichTextPropertyData = DocsBlockPropertyData<DocumentationLegacyRichTextModel> & {
+    /** Selected token ids */
+    calloutType?: DocumentationLegacyCalloutType;
+};
+/** RichText property - Definition model */
+export type DocsBlockRichTextPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockRichTextPropertyOptions;
+/** RichText property - Definition */
+export declare class DocsBlockRichTextPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockRichTextPropertyOptions, DocsBlockRichTextPropertyData> {
+    type: DocsBlockItemPropertyType.richText;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockSingleSelectProperty.d.ts

@@ -0,0 +1,27 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockOptionRenderingStyle } from "../../../enums/SDKDocsBlockOptionRenderStyle";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** SingleSelect property - Additional non-value options */
+export type DocsBlockSingleSelectPropertyOptions = {
+    /** Default choices to set when block is created */
+    defaultChoice: string;
+    /** List of choices to choose from */
+    choices: Array<{
+        /** Option value / id */
+        value: string;
+        /** Option name */
+        name: string;
+        /** Option icon filename */
+        icon?: string;
+    }>;
+    /** Visual representation of the property */
+    singleSelectStyle?: DocsBlockOptionRenderingStyle;
+};
+/** SingleSelect property - Data */
+export type DocsBlockSingleSelectPropertyData = DocsBlockPropertyData<string> & Record<string, never>;
+/** SingleSelect property - Definition model */
+export type DocsBlockSingleSelectPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockSingleSelectPropertyOptions;
+/** SingleSelect property - Definition */
+export declare class DocsBlockSingleSelectPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockSingleSelectPropertyOptions, DocsBlockSingleSelectPropertyData> {
+    type: DocsBlockItemPropertyType.singleSelect;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockStorybookProperty.d.ts

@@ -0,0 +1,24 @@
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
+/** Storybook property - Additional non-value options */
+export type DocsBlockStorybookPropertyOptions = {
+    /** Defines what should be the default height of the embed */
+    defaultHeight: number;
+    /** If enabled, additional text can be provided for the embed property */
+    allowCaption?: boolean;
+    /** If enabled, the embed can be resized */
+    allowResize?: boolean;
+    /** Defined how to validate the embed URL */
+    urlValidationRegex?: string;
+};
+/** Storybook property - Data */
+export type DocsBlockStorybookPropertyData = DocsBlockPropertyData<string | undefined> & {
+    alt?: string;
+    caption?: string;
+    height?: number;
+    embedUrl?: string;
+};
+/** Storybook property - Definition model */
+export type DocsBlockStorybookPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockStorybookPropertyOptions;
+/** Storybook property - Definition */
+export declare class DocsBlockStorybookPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockStorybookPropertyOptions, DocsBlockStorybookPropertyData> {
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockTableProperty.d.ts

@@ -0,0 +1,38 @@
+import { DocumentationLegacyRichTextModel } from "../../../documentation/SDKDocumentationLegacyRichText";
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsImageRef } from "../support/SDKDocsImageRef";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
+/** Table property - Additional non-value options */
+export type DocsBlockTablePropertyOptions = Record<string, never>;
+export type DocsBlockTableRichTextNode = {
+    type: "RichText";
+    value: DocumentationLegacyRichTextModel;
+};
+export type DocsBlockTableImageNode = {
+    type: "Image";
+    value: DocsImageRef;
+};
+export type DocsBlockTableMultiRichTextNode = {
+    type: "MultiRichText";
+    value: Array<DocumentationLegacyRichTextModel>;
+};
+export type DocsBlockTableNode = DocsBlockTableRichTextNode | DocsBlockTableImageNode | DocsBlockTableMultiRichTextNode;
+/** Table property - Data */
+export type DocsBlockTablePropertyData = DocsBlockPropertyData<Array<{
+    cells: {
+        id: string;
+        alignment: "Left" | "Center" | "Right";
+        columnWidth: number;
+        nodes: Array<DocsBlockTableNode>;
+    }[];
+}>> & {
+    highlightHeaderColumn?: boolean;
+    highlightHeaderRow?: boolean;
+    showBorder?: boolean;
+};
+/** Table property - Definition model */
+export type DocsBlockTablePropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTablePropertyOptions;
+/** Table property - Definition */
+export declare class DocsBlockTablePropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockTablePropertyOptions, DocsBlockTablePropertyData> {
+    type: DocsBlockItemPropertyType.table;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockTextProperty.d.ts

@@ -0,0 +1,23 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockTextPropertyColor } from "../../../enums/SDKDocsBlockTextPropertyColor";
+import { DocsBlockTextPropertyStyle } from "../../../enums/SDKDocsBlockTextPropertyStyle";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** Text property - Additional non-value options */
+export type DocsBlockTextPropertyOptions = {
+    /** Field placeholder */
+    placeholder?: string;
+    /** Default value to set when block is created */
+    defaultValue?: string;
+    /** Visual style of the text property */
+    textStyle?: DocsBlockTextPropertyStyle;
+    /** Text color */
+    color?: DocsBlockTextPropertyColor;
+};
+/** Text property - Data */
+export type DocsBlockTextPropertyData = DocsBlockPropertyData<string> & Record<string, never>;
+/** Text property - Definition model */
+export type DocsBlockTextPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTextPropertyOptions;
+/** Text property - Definition */
+export declare class DocsBlockTextPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockTextPropertyOptions, DocsBlockTextPropertyData> {
+    type: DocsBlockItemPropertyType.text;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockTokenProperty.d.ts

@@ -0,0 +1,36 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { TokenType } from "../../../enums/SDKTokenType";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** Token property - Additional non-value options */
+export type DocsBlockTokenPropertyOptions = {
+    /** Default theme to be chosen */
+    defaultTheme?: "none";
+    /** Default value preview */
+    defaultValuePreview?: "Split" | "Override";
+    /** Token types that are allowed to be selected. All types allowed if nothing is provided */
+    allowedTypes?: Array<TokenType>;
+    /** How should the tokens be rendered in editor */
+    renderLayoutAs?: "Grid" | "List";
+    /** Whether to allow selecting token custom properties. True by default */
+    allowPropertySelection?: boolean;
+    /** Whether to allow selecting themes. True by default */
+    allowThemeSelection?: boolean;
+};
+/** Token property - Data */
+export type DocsBlockTokenPropertyData = DocsBlockPropertyData<Array<{
+    entityId: string;
+    entityType: "Token" | "TokenGroup";
+}>> & {
+    /** Selected token ids */
+    selectedPropertyIds?: Array<string>;
+    /** Selected theme ids */
+    selectedThemeIds?: Array<string>;
+    /** Display mode of themes associated with the token property */
+    themeDisplayMode?: "Split" | "Override";
+};
+/** Token property - Definition model */
+export type DocsBlockTokenPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTokenPropertyOptions;
+/** Token property - Definition */
+export declare class DocsBlockTokenPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockTokenPropertyOptions, DocsBlockTokenPropertyData> {
+    type: DocsBlockItemPropertyType.token;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockTokenPropertyProperty.d.ts

@@ -0,0 +1,12 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** TokenProperty property - Additional non-value options */
+export type DocsBlockTokenPropertyPropertyOptions = Record<string, never>;
+/** TokenProperty property - Data */
+export type DocsBlockTokenPropertyPropertyData = DocsBlockPropertyData<Array<string>> & Record<string, never>;
+/** TokenProperty property - Definition model */
+export type DocsBlockTokenPropertyPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTokenPropertyPropertyOptions;
+/** TokenProperty property - Definition */
+export declare class DocsBlockTokenPropertyPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockTokenPropertyPropertyOptions, DocsBlockTokenPropertyPropertyData> {
+    type: DocsBlockItemPropertyType.tokenProperty;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockTokenTypeProperty.d.ts

@@ -0,0 +1,15 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { TokenType } from "../../../enums/SDKTokenType";
+import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** TokenType property - Additional non-value options */
+export type DocsBlockTokenTypePropertyOptions = {
+    allowMultiSelect?: boolean;
+};
+/** TokenType property - Data */
+export type DocsBlockTokenTypePropertyData = DocsBlockPropertyData<Array<TokenType>> & Record<string, never>;
+/** TokenType property - Definition model */
+export type DocsBlockTokenTypePropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTokenTypePropertyOptions;
+/** TokenType property - Definition */
+export declare class DocsBlockTokenTypePropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockTokenTypePropertyOptions, DocsBlockTokenTypePropertyData> {
+    type: DocsBlockItemPropertyType.tokenType;
+}

package/build/sdk-typescript/src/model/docs/blocks/properties/SDKDocsBlockUrlProperty.d.ts

@@ -0,0 +1,14 @@
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
+/** Url property - Additional non-value options */
+export type DocsBlockUrlPropertyOptions = {
+    urlValidationRegex?: string;
+};
+/** Url property - Data */
+export type DocsBlockUrlPropertyData = DocsBlockPropertyData<string> & Record<string, never>;
+/** Url property - Definition model */
+export type DocsBlockUrlPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockUrlPropertyOptions;
+/** Url property - Definition */
+export declare class DocsBlockUrlPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockUrlPropertyOptions, DocsBlockUrlPropertyData> {
+    type: DocsBlockItemPropertyType.embedURL;
+}

package/build/sdk-typescript/src/model/docs/blocks/support/SDKDocsColorRef.d.ts

@@ -0,0 +1,3 @@
+import { PageBlockColorV2 } from "@supernova-studio/model";
+/** A color data container */
+export type DocsColorRef = PageBlockColorV2;

package/build/sdk-typescript/src/model/docs/blocks/support/SDKDocsImageRef.d.ts

@@ -0,0 +1,26 @@
+import { Supernova } from "../../../../exports";
+/** An image data container */
+export type DocsImageRef = {
+    /** Ref type */
+    type: DocsImageRefType;
+    /** Referenced resource, if any */
+    resource?: {
+        /** Absolute, directly consumable URL */
+        url: string;
+        /** Referenced resource, if any */
+        resourceId: string;
+    };
+    /** Referenced Figma file, if any */
+    figmaNode?: {
+        sourceId: string;
+        frameReferenceId: string;
+    };
+};
+export declare enum DocsImageRefType {
+    resource = "Resource",
+    figmaNode = "FigmaNode"
+}
+export declare function docsImageRefToUrl(image: DocsImageRef | undefined, sdk: Supernova, from: {
+    dsId: string;
+    versionId: string;
+}): string | undefined;

package/build/sdk-typescript/src/model/docs/blocks/support/SDKDocsLinkRef.d.ts

@@ -0,0 +1,24 @@
+/** A link data container */
+export type DocsLinkRef = {
+    /** Ref type */
+    type: DocsLinkRefType;
+    /** Referenced page */
+    documentationItemId?: string;
+    /** Referenced page block - heading */
+    pageHeadingId?: string;
+    /** Referenced URL */
+    url?: string;
+    /** Open in other tab */
+    openInNewTab?: boolean;
+};
+export declare enum DocsLinkRefType {
+    documentationItem = "DocumentationItem",
+    pageHeading = "PageHeading",
+    url = "Url"
+}
+export declare function docsLinkToUrl(link: DocsLinkRef): string | undefined;
+export declare function docsLinkToLinkAttributes(link: DocsLinkRef): {
+    href: string;
+    target: string;
+} | undefined;
+export declare function linkAttributeToDocsLink(href: string | null | undefined, target: string | null | undefined): DocsLinkRef | undefined;

package/build/sdk-typescript/src/model/docs/blocks/support/SDKDocsSizeRef.d.ts

@@ -0,0 +1,8 @@
+import { SizeTokenValue } from "../../../tokens/SDKTokenValue";
+/** A size data container */
+export type DocsSizeRef = {
+    /** Width value - either token reference or raw value */
+    width?: SizeTokenValue;
+    /** Height value - either token reference or raw value */
+    height?: SizeTokenValue;
+};

package/build/sdk-typescript/src/model/docs/blocks/usage/SDKDocsBlock.d.ts

@@ -0,0 +1,47 @@
+import { PageBlockEditorModel } from "@supernova-studio/client";
+import { DocsColorRef } from "../support/SDKDocsColorRef";
+import { DocsLinkRef } from "../support/SDKDocsLinkRef";
+import { DocsBlockItem } from "./SDKDocsBlockItem";
+export type DocsBlockModel = PageBlockEditorModel;
+export declare class DocsBlock {
+    /** Unique identifier of the block */
+    id: string;
+    /** Unique identifier of the block package */
+    packageId: string;
+    /** Unique identifier of the selected variant */
+    variantId: string | null;
+    /** Indentation of the block in levels (0, 1, 2), not pixels */
+    indentLevel: number;
+    /** Block appearance - Properties that are natively available for all blocks, such as background color */
+    appearance: {
+        /** Background color of all items of the block. Can be further overriden on every item */
+        itemBackgroundColor: DocsColorRef | null;
+        /** Number of columns */
+        numberOfColumns?: number;
+    };
+    /** Data of all items of the block */
+    data: Array<DocsBlockItem>;
+    constructor(model: DocsBlockModel);
+    /** Returns stored data of all properties. This will retrieve properties for item on the first position, ideal for single-item blocks */
+    allPropertyDataForSingleItem(): Record<string, object> | null;
+    /** Returns stored data of all properties. This will retrieve properties for item at any position */
+    allPropertyDataForItemAtIndex(index: number): Record<string, object> | null;
+    /** Returns stored data of a single property. This will retrieve property for item on the first position, ideal for single-item blocks */
+    propertyDataForSingleItem<T extends object>(propertyId: string): T | null;
+    /** Returns stored data of a single property. This will retrieve property for item at any position */
+    propertyDataForItemAtIndex<T extends object>(index: number, propertyId: string): T | null;
+    /** Returns stored link, if any. This will retrieve link for item on the first position, ideal for single-item blocks */
+    linkForSingleItem(): DocsLinkRef | null;
+    /** Returns stored link, if any. This will retrieve link for item at any position */
+    linkForItemAtIndex(index: number): DocsLinkRef | null;
+    /** Update data for property of specific key and index */
+    updatePropertyDataForItemAtIndex<T extends object>(index: number, propertyId: string, data: T): void;
+    /** Update data for property of specific key and index */
+    updatePropertyDataForSingleItem<T extends object>(propertyId: string, data: T): void;
+    /** Update link for item at specific index */
+    updateLinkForItemAtIndex(index: number, link: DocsLinkRef | undefined): void;
+    /** Update link for item at specific index */
+    updateLinkForSingleItem(link: DocsLinkRef | undefined): void;
+    /** Constructs representation that can be used to write full object to remote */
+    toRemote(): PageBlockEditorModel;
+}

package/build/sdk-typescript/src/model/docs/blocks/usage/SDKDocsBlockItem.d.ts

@@ -0,0 +1,16 @@
+import { PageBlockItemV2 } from "@supernova-studio/model";
+import { DocsLinkRef } from "../support/SDKDocsLinkRef";
+export type DocsBlockItemModel = PageBlockItemV2;
+export declare class DocsBlockItem {
+    /** Unique identifier of the block item */
+    id: string;
+    /** Dynamic key coming from property.id block definition */
+    props: {
+        [key: string]: object;
+    };
+    /** Link where the item points to, if any. Must be enabled in behaviors */
+    linksTo: DocsLinkRef | undefined;
+    constructor(model: DocsBlockItemModel);
+    /** Constructs representation that can be used to write full object to remote */
+    toRemote(): DocsBlockItemModel;
+}