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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/build/supernova-sdk-typescript.js +1 -1
  2. package/build/supernova-sdk-typescript.js.map +1 -1
  3. package/build/types/core/SDKSupernova.d.ts +9 -0
  4. package/build/types/core/areas/SDKAreaActivityEvents.d.ts +7 -0
  5. package/build/types/core/areas/SDKAreaAgentChats.d.ts +12 -0
  6. package/build/types/core/areas/SDKAreaBulkOperations.d.ts +76 -74
  7. package/build/types/core/areas/SDKAreaDataSources.d.ts +1 -1
  8. package/build/types/core/areas/SDKAreaDesignSystems.d.ts +13 -13
  9. package/build/types/core/areas/SDKAreaDocumentation.d.ts +304 -289
  10. package/build/types/core/areas/SDKAreaImport.d.ts +35 -0
  11. package/build/types/core/areas/SDKAreaMCP.d.ts +26 -1
  12. package/build/types/core/areas/SDKAreaProjects.d.ts +1084 -1100
  13. package/build/types/core/areas/SDKAreaRawData.d.ts +1040 -1039
  14. package/build/types/core/areas/SDKAreaResources.d.ts +90 -90
  15. package/build/types/core/areas/SDKAreaSanboxes.d.ts +9 -9
  16. package/build/types/core/areas/SDKAreaThreads.d.ts +67 -67
  17. package/build/types/core/areas/SDKAreaTokens.d.ts +17 -12
  18. package/build/types/core/areas/SDKAreaWorkspaces.d.ts +1 -1
  19. package/build/types/core/data/SDKDataCore.d.ts +1771 -1746
  20. package/build/types/core/data/SDKDataCoreCached.d.ts +2 -2
  21. package/build/types/core/data/requests/SDKDataCoreReadRequests.d.ts +647 -593
  22. package/build/types/core/data/requests/SDKDataCoreWriteRequests.d.ts +2515 -2489
  23. package/build/types/core/resolvers/SDKDocsEntityItemResolver.d.ts +121 -121
  24. package/build/types/core/resolvers/SDKSnapshotTokenBuilder.d.ts +28 -0
  25. package/build/types/core/resolvers/SDKTokenResolver.d.ts +11 -9
  26. package/build/types/exports.d.ts +19 -11
  27. package/build/types/model/activity-events/SDKActivityEvent.d.ts +49 -0
  28. package/build/types/model/agent-chats/SDKAgentChat.d.ts +31 -0
  29. package/build/types/model/base/SDKDesignSystem.d.ts +3 -1
  30. package/build/types/model/datasets/SDKDataset.d.ts +15 -5
  31. package/build/types/model/docs/blocks/definition/SDKDocsBlockBehavior.d.ts +4 -1
  32. package/build/types/model/docs/blocks/definition/actual/context-mcp/SDKDocsBlockActualContextMcp.d.ts +2 -0
  33. package/build/types/model/docs/blocks/properties/SDKDocsBlockAssetProperty.d.ts +7 -24
  34. package/build/types/model/docs/blocks/properties/SDKDocsBlockAssetPropertyProperty.d.ts +3 -2
  35. package/build/types/model/docs/blocks/properties/SDKDocsBlockBooleanProperty.d.ts +3 -2
  36. package/build/types/model/docs/blocks/properties/SDKDocsBlockCodeProperty.d.ts +3 -6
  37. package/build/types/model/docs/blocks/properties/SDKDocsBlockCodeSandboxProperty.d.ts +3 -8
  38. package/build/types/model/docs/blocks/properties/SDKDocsBlockColorProperty.d.ts +3 -3
  39. package/build/types/model/docs/blocks/properties/SDKDocsBlockComponentProperty.d.ts +7 -10
  40. package/build/types/model/docs/blocks/properties/SDKDocsBlockComponentPropertyProperty.d.ts +3 -2
  41. package/build/types/model/docs/blocks/properties/SDKDocsBlockContextProperty.d.ts +16 -0
  42. package/build/types/model/docs/blocks/properties/SDKDocsBlockDividerProperty.d.ts +3 -2
  43. package/build/types/model/docs/blocks/properties/SDKDocsBlockEmbedUrlProperty.d.ts +3 -6
  44. package/build/types/model/docs/blocks/properties/SDKDocsBlockFigmaComponentProperty.d.ts +7 -26
  45. package/build/types/model/docs/blocks/properties/SDKDocsBlockFigmaNodeProperty.d.ts +7 -22
  46. package/build/types/model/docs/blocks/properties/SDKDocsBlockFileProperty.d.ts +4 -9
  47. package/build/types/model/docs/blocks/properties/SDKDocsBlockImageProperty.d.ts +3 -10
  48. package/build/types/model/docs/blocks/properties/SDKDocsBlockMarkdownProperty.d.ts +3 -2
  49. package/build/types/model/docs/blocks/properties/SDKDocsBlockMultiRichTextProperty.d.ts +3 -3
  50. package/build/types/model/docs/blocks/properties/SDKDocsBlockMultiSelectProperty.d.ts +3 -2
  51. package/build/types/model/docs/blocks/properties/SDKDocsBlockNumberProperty.d.ts +3 -2
  52. package/build/types/model/docs/blocks/properties/SDKDocsBlockProperty.d.ts +3 -3
  53. package/build/types/model/docs/blocks/properties/SDKDocsBlockRichTextEditorProperty.d.ts +3 -3
  54. package/build/types/model/docs/blocks/properties/SDKDocsBlockRichTextProperty.d.ts +3 -7
  55. package/build/types/model/docs/blocks/properties/SDKDocsBlockSingleSelectProperty.d.ts +3 -2
  56. package/build/types/model/docs/blocks/properties/SDKDocsBlockStorybookProperty.d.ts +4 -22
  57. package/build/types/model/docs/blocks/properties/SDKDocsBlockTableProperty.d.ts +12 -28
  58. package/build/types/model/docs/blocks/properties/SDKDocsBlockTextProperty.d.ts +3 -2
  59. package/build/types/model/docs/blocks/properties/SDKDocsBlockTokenProperty.d.ts +7 -31
  60. package/build/types/model/docs/blocks/properties/SDKDocsBlockTokenPropertyProperty.d.ts +3 -2
  61. package/build/types/model/docs/blocks/properties/SDKDocsBlockTokenTypeProperty.d.ts +3 -3
  62. package/build/types/model/docs/blocks/properties/SDKDocsBlockUrlProperty.d.ts +3 -2
  63. package/build/types/model/docs/sections/SDKDocsSection.d.ts +0 -31
  64. package/build/types/model/documentation/SDKPageHistoryVersion.d.ts +20 -0
  65. package/build/types/model/documentation/blocks/SDKDocumentationLegacyPageBlockContextMcp.d.ts +11 -0
  66. package/build/types/model/elements/SDKElementPropertyOption.d.ts +1 -2
  67. package/build/types/model/enums/SDKCodeLanguage.d.ts +1 -1
  68. package/build/types/model/enums/SDKDesignSystemRole.d.ts +1 -2
  69. package/build/types/model/enums/SDKDocsBlockBehaviorSelectionType.d.ts +4 -2
  70. package/build/types/model/enums/SDKDocsBlockContainerSize.d.ts +6 -4
  71. package/build/types/model/enums/SDKDocsBlockItemPropertyType.d.ts +3 -1
  72. package/build/types/model/enums/SDKDocumentationLegacyPageBlockType.d.ts +1 -0
  73. package/build/types/model/enums/SDKTokenType.d.ts +2 -0
  74. package/build/types/model/enums/SDKWorkspaceSeatType.d.ts +14 -3
  75. package/build/types/model/exporters/SDKExporter.d.ts +2 -2
  76. package/build/types/model/exporters/SDKPipeline.d.ts +1 -1
  77. package/build/types/model/membership/SDKMembership.d.ts +1 -1
  78. package/build/types/model/support/SDKSource.d.ts +4 -3
  79. package/build/types/model/themes/SDKTokenThemeOverride.d.ts +1 -0
  80. package/build/types/model/tokens/remote/SDKRemoteTokenModel.d.ts +34 -1
  81. package/build/types/model/tokens/remote/SDKRemoteTokenValue.d.ts +1 -1
  82. package/build/types/model/workspaces/SDKWorkspaceProductPrice.d.ts +6 -3
  83. package/build/types/model/workspaces/SDKWorkspaceSubscription.d.ts +2 -6
  84. package/build/types/tools/design-tokens/SDKToolsDesignTokensPlugin.d.ts +6 -3
  85. package/build/types/tools/design-tokens/utilities/SDKDTJSONConverter.d.ts +29 -3
  86. package/build/types/tools/design-tokens/utilities/SDKDTJSONLoader.d.ts +2 -0
  87. package/build/types/tools/design-tokens/utilities/SDKDTMapLoader.d.ts +31 -0
  88. package/build/types/tools/design-tokens/utilities/SDKDTTokenReferenceResolver.d.ts +2 -0
  89. package/build/types/tools/design-tokens/utilities/unresolvable-modes/index.d.ts +4 -0
  90. package/build/types/tools/design-tokens/utilities/unresolvable-modes/lenient-resolve.d.ts +2 -0
  91. package/build/types/tools/design-tokens/utilities/unresolvable-modes/placeholder.d.ts +2 -0
  92. package/build/types/tools/design-tokens/utilities/unresolvable-modes/preserve.d.ts +2 -0
  93. package/build/types/tools/design-tokens/utilities/unresolvable-modes/strict.d.ts +2 -0
  94. package/build/types/tools/design-tokens/utilities/unresolvable-modes/types.d.ts +33 -0
  95. package/build/types/tools/docs-block-builder/SDKDocsBlockBuilder.d.ts +9 -0
  96. package/build/types/tools/json-builder/elements-transformers/SDKToolsJSONElementTransformer.d.ts +1 -1
  97. package/build/types/utils/TokenUtils.d.ts +1 -1
  98. package/package.json +17 -21
  99. package/build/types/model/enums/SDKDocsBlockTokenNameFormat.d.ts +0 -10
@@ -1,4 +1,5 @@
1
- import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
1
+ import type { PageBlockItemStorybookValue } from "@supernova-studio/model";
2
+ import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
2
3
  /** Storybook property - Additional non-value options */
3
4
  export type DocsBlockStorybookPropertyOptions = {
4
5
  /** Defines what should be the default height of the embed */
@@ -12,28 +13,9 @@ export type DocsBlockStorybookPropertyOptions = {
12
13
  /** Defines how the storybook should be rendered in the editor */
13
14
  renderLayoutAs?: "Playground" | "Iframe";
14
15
  };
15
- export type DocsBlockStorybookValue = Array<{
16
- entityId?: string;
17
- embed?: {
18
- inputUrl: string;
19
- embedUrl: string;
20
- };
21
- entityMeta?: {
22
- caption?: string;
23
- height?: number;
24
- hiddenProps?: Array<string>;
25
- propValues?: Record<string, unknown>;
26
- };
27
- }> | undefined;
16
+ export type DocsBlockStorybookValue = PageBlockItemStorybookValue["value"];
28
17
  /** Storybook property - Data */
29
- export type DocsBlockStorybookPropertyData = DocsBlockPropertyData<DocsBlockStorybookValue> & {
30
- showCode?: boolean;
31
- showFooter?: boolean;
32
- showThemeSwitcher?: boolean;
33
- showProperties?: boolean;
34
- showDescription?: boolean;
35
- showDefaults?: boolean;
36
- };
18
+ export type DocsBlockStorybookPropertyData = PageBlockItemStorybookValue;
37
19
  /** Storybook property - Definition model */
38
20
  export type DocsBlockStorybookPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockStorybookPropertyOptions;
39
21
  /** Storybook property - Definition */
@@ -1,35 +1,19 @@
1
- import { DocumentationLegacyRichTextModel } from "../../../documentation/SDKDocumentationLegacyRichText";
1
+ import type { PageBlockItemTableImageNode, PageBlockItemTableNode, PageBlockItemTableRichTextNode, PageBlockItemTableValue } from "@supernova-studio/model";
2
2
  import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
3
- import { DocsImageRef } from "../support/SDKDocsImageRef";
4
- import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
3
+ import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
5
4
  /** Table property - Additional non-value options */
6
5
  export type DocsBlockTablePropertyOptions = Record<string, never>;
7
- export type DocsBlockTableRichTextNode = {
8
- type: "RichText";
9
- value: DocumentationLegacyRichTextModel;
10
- };
11
- export type DocsBlockTableImageNode = {
12
- type: "Image";
13
- value: DocsImageRef;
14
- };
15
- export type DocsBlockTableMultiRichTextNode = {
16
- type: "MultiRichText";
17
- value: Array<DocumentationLegacyRichTextModel>;
18
- };
19
- export type DocsBlockTableNode = DocsBlockTableRichTextNode | DocsBlockTableImageNode | DocsBlockTableMultiRichTextNode;
6
+ export type DocsBlockTableRichTextNode = PageBlockItemTableRichTextNode;
7
+ export type DocsBlockTableImageNode = PageBlockItemTableImageNode;
8
+ export type DocsBlockTableNode = PageBlockItemTableNode;
20
9
  /** Table property - Data */
21
- export type DocsBlockTablePropertyData = DocsBlockPropertyData<Array<{
22
- cells: {
23
- id: string;
24
- alignment: "Left" | "Center" | "Right";
25
- columnWidth: number;
26
- nodes: Array<DocsBlockTableNode>;
27
- }[];
28
- }>> & {
29
- highlightHeaderColumn?: boolean;
30
- highlightHeaderRow?: boolean;
31
- showBorder?: boolean;
32
- };
10
+ export type DocsBlockTablePropertyData = PageBlockItemTableValue;
11
+ /** Table property - Value */
12
+ export type DocsBlockTablePropertyValue = DocsBlockTablePropertyData["value"];
13
+ /** Table property - Row */
14
+ export type DocsBlockTablePropertyRow = DocsBlockTablePropertyValue[number];
15
+ /** Table property - Cell */
16
+ export type DocsBlockTablePropertyCell = DocsBlockTablePropertyRow["cells"][number];
33
17
  /** Table property - Definition model */
34
18
  export type DocsBlockTablePropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTablePropertyOptions;
35
19
  /** Table property - Definition */
@@ -1,7 +1,8 @@
1
+ import type { PageBlockItemTextValue } from "@supernova-studio/model";
1
2
  import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
2
3
  import { DocsBlockTextPropertyColor } from "../../../enums/SDKDocsBlockTextPropertyColor";
3
4
  import { DocsBlockTextPropertyStyle } from "../../../enums/SDKDocsBlockTextPropertyStyle";
4
- import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
5
+ import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
5
6
  /** Text property - Additional non-value options */
6
7
  export type DocsBlockTextPropertyOptions = {
7
8
  /** Field placeholder */
@@ -18,7 +19,7 @@ export type DocsBlockTextPropertyOptions = {
18
19
  editorInteractivity?: "edit" | "viewOnly";
19
20
  };
20
21
  /** Text property - Data */
21
- export type DocsBlockTextPropertyData = DocsBlockPropertyData<string> & Record<string, never>;
22
+ export type DocsBlockTextPropertyData = PageBlockItemTextValue;
22
23
  /** Text property - Definition model */
23
24
  export type DocsBlockTextPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTextPropertyOptions;
24
25
  /** Text property - Definition */
@@ -1,7 +1,7 @@
1
+ import type { PageBlockItemTokenValue } from "@supernova-studio/model";
1
2
  import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
2
- import { DocsBlockTokenNameFormat } from "../../../enums/SDKDocsBlockTokenNameFormat";
3
3
  import { TokenType } from "../../../enums/SDKTokenType";
4
- import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
4
+ import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
5
5
  /** Token property - Additional non-value options */
6
6
  export type DocsBlockTokenPropertyOptions = {
7
7
  /** Token types that are allowed to be selected. All types allowed if nothing is provided */
@@ -16,35 +16,11 @@ export type DocsBlockTokenPropertyOptions = {
16
16
  allowNameFormatSelection?: boolean;
17
17
  };
18
18
  /** Token property - Data */
19
- export type DocsBlockTokenPropertyData = DocsBlockPropertyData<Array<{
20
- entityId: string;
21
- entityType: "Token" | "TokenGroup";
22
- entityMeta?: {
23
- showNestedGroups?: boolean;
24
- };
25
- }>> & {
26
- /** Selected token ids */
27
- selectedPropertyIds?: Array<string>;
28
- /** Swatches with selected theme ids */
29
- swatches?: Array<{
30
- id: string;
31
- selectedThemeIds: Array<string>;
32
- }>;
33
- /** Format of the token name */
34
- tokenNameFormat?: DocsBlockTokenNameFormat;
35
- /** Custom property id for token name format, only if tokenNameFormat is "CustomProperty" */
36
- tokenNameCustomPropertyId?: string;
37
- /**
38
- * Selected theme ids
39
- * @deprecated Swatches will be used instead
40
- */
41
- selectedThemeIds?: Array<string>;
42
- /**
43
- * Display mode of themes associated with the token property
44
- * @deprecated Swatches will be used instead
45
- */
46
- themeDisplayMode?: "Split" | "Override";
47
- };
19
+ export type DocsBlockTokenPropertyData = PageBlockItemTokenValue;
20
+ /** Token property - Value */
21
+ export type DocsBlockTokenPropertyValue = DocsBlockTokenPropertyData["value"];
22
+ /** Token property - Entity */
23
+ export type DocsBlockTokenPropertyEntity = DocsBlockTokenPropertyValue[number];
48
24
  /** Token property - Definition model */
49
25
  export type DocsBlockTokenPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTokenPropertyOptions;
50
26
  /** Token property - Definition */
@@ -1,9 +1,10 @@
1
+ import type { PageBlockItemTokenPropertyValue } from "@supernova-studio/model";
1
2
  import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
2
- import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
3
+ import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
3
4
  /** TokenProperty property - Additional non-value options */
4
5
  export type DocsBlockTokenPropertyPropertyOptions = Record<string, never>;
5
6
  /** TokenProperty property - Data */
6
- export type DocsBlockTokenPropertyPropertyData = DocsBlockPropertyData<Array<string>> & Record<string, never>;
7
+ export type DocsBlockTokenPropertyPropertyData = PageBlockItemTokenPropertyValue;
7
8
  /** TokenProperty property - Definition model */
8
9
  export type DocsBlockTokenPropertyPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTokenPropertyPropertyOptions;
9
10
  /** TokenProperty property - Definition */
@@ -1,12 +1,12 @@
1
+ import type { PageBlockItemTokenTypeValue } from "@supernova-studio/model";
1
2
  import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
2
- import { TokenType } from "../../../enums/SDKTokenType";
3
- import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
3
+ import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
4
4
  /** TokenType property - Additional non-value options */
5
5
  export type DocsBlockTokenTypePropertyOptions = {
6
6
  allowMultiSelect?: boolean;
7
7
  };
8
8
  /** TokenType property - Data */
9
- export type DocsBlockTokenTypePropertyData = DocsBlockPropertyData<Array<TokenType>> & Record<string, never>;
9
+ export type DocsBlockTokenTypePropertyData = PageBlockItemTokenTypeValue;
10
10
  /** TokenType property - Definition model */
11
11
  export type DocsBlockTokenTypePropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockTokenTypePropertyOptions;
12
12
  /** TokenType property - Definition */
@@ -1,11 +1,12 @@
1
+ import type { PageBlockItemUrlValue } from "@supernova-studio/model";
1
2
  import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
2
- import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
3
+ import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
3
4
  /** Url property - Additional non-value options */
4
5
  export type DocsBlockUrlPropertyOptions = {
5
6
  urlValidationRegex?: string;
6
7
  };
7
8
  /** Url property - Data */
8
- export type DocsBlockUrlPropertyData = DocsBlockPropertyData<string> & Record<string, never>;
9
+ export type DocsBlockUrlPropertyData = PageBlockItemUrlValue;
9
10
  /** Url property - Definition model */
10
11
  export type DocsBlockUrlPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockUrlPropertyOptions;
11
12
  /** Url property - Definition */
@@ -1,21 +1,8 @@
1
1
  import { DocsSectionType } from "../../enums/SDKDocsSectionType";
2
- import { DocsColorRef } from "../blocks/support/SDKDocsColorRef";
3
2
  import { DocsSectionItemModel } from "./SDKDocsSectionItem";
4
3
  export type DocsSectionModel = {
5
4
  id: string;
6
5
  type: DocsSectionType;
7
- appearance?: {
8
- expandToEdges: boolean;
9
- contentExpandToEdges: boolean;
10
- backgroundColor?: DocsColorRef;
11
- foregroundColor?: DocsColorRef;
12
- padding?: {
13
- top?: number;
14
- bottom?: number;
15
- left?: number;
16
- right?: number;
17
- };
18
- };
19
6
  items: Array<DocsSectionItemModel>;
20
7
  };
21
8
  export declare class DocsSection {
@@ -23,24 +10,6 @@ export declare class DocsSection {
23
10
  id: string;
24
11
  /** Section type */
25
12
  type: DocsSectionType;
26
- /** Global appearance properties for the section like background color, expanding to edges, etc. */
27
- appearance: {
28
- /** Section background is expanded to fill available area, including side margins */
29
- expandToEdges: boolean;
30
- /** Content of the section is expanded to fill available area, including side margins */
31
- contentExpandToEdges: boolean;
32
- /** Background color of the section */
33
- backgroundColor: DocsColorRef | null;
34
- /** Foreground color of the section */
35
- foregroundColor: DocsColorRef | null;
36
- /** Content offset from the sides */
37
- padding: {
38
- top: number;
39
- bottom: number;
40
- left: number;
41
- right: number;
42
- };
43
- };
44
13
  /** Section items contained within this section. At least one is always present */
45
14
  items: Array<DocsSectionItemModel>;
46
15
  constructor(model: DocsSectionModel);
@@ -0,0 +1,20 @@
1
+ import type { DTOPageHistoryVersion, DTOPageHistoryVersionContent } from "@supernova-studio/client";
2
+ export type PageHistoryVersionJSONContent = DTOPageHistoryVersionContent["jsonContent"];
3
+ export type PageHistoryVersionReason = DTOPageHistoryVersion["reason"];
4
+ export declare class PageHistoryVersion {
5
+ id: string;
6
+ createdAt: Date;
7
+ createdByUserId: string | null;
8
+ reason: PageHistoryVersionReason | null;
9
+ name: string | null;
10
+ restoredFromVersionId: string | null;
11
+ authors: string[];
12
+ publishedAt: Date | null;
13
+ publishedByUserId: string | null;
14
+ constructor(model: DTOPageHistoryVersion);
15
+ }
16
+ export declare class PageHistoryVersionContent {
17
+ id: string;
18
+ jsonContent: PageHistoryVersionJSONContent;
19
+ constructor(model: DTOPageHistoryVersionContent);
20
+ }
@@ -0,0 +1,11 @@
1
+ import { DocsBlockContextPropertyData } from "../../docs/blocks/properties/SDKDocsBlockContextProperty";
2
+ import { DocumentationLegacyPageBlock, DocumentationLegacyPageBlockModel } from "../SDKDocumentationLegacyPageBlock";
3
+ export type DocumentationLegacyPageBlockContextMcpModel = {
4
+ contextMcpBlockConfig?: DocsBlockContextPropertyData;
5
+ } & DocumentationLegacyPageBlockModel;
6
+ export declare class DocumentationLegacyPageBlockContextMcp extends DocumentationLegacyPageBlock {
7
+ properties: {
8
+ context: DocsBlockContextPropertyData;
9
+ };
10
+ constructor(model: DocumentationLegacyPageBlockContextMcpModel, children: Array<DocumentationLegacyPageBlock>);
11
+ }
@@ -1,4 +1,4 @@
1
- declare const badgeColorValues: {
1
+ export declare const badgeColorValues: {
2
2
  readonly blue: "#EFF7FF";
3
3
  readonly cyan: "#E8FCFF";
4
4
  readonly fuchsia: "#FFECFF";
@@ -54,4 +54,3 @@ export declare class ElementPropertyOption {
54
54
  */
55
55
  setBackgroundColor(color: string): void;
56
56
  }
57
- export {};
@@ -24,7 +24,7 @@ export declare enum CodeLanguage {
24
24
  rust = "Rust",
25
25
  sass = "Sass",
26
26
  scss = "SCSS",
27
- svelte = "Svelte",
27
+ svelte = "Svetle",
28
28
  swift = "Swift",
29
29
  twig = "Twig",
30
30
  typescript = "Typescript",
@@ -1,6 +1,5 @@
1
1
  import { DTODesignSystemRole } from "@supernova-studio/client";
2
2
  import { UserRole } from "./SDKUserRole";
3
- import { WorkspaceSeatType } from "./SDKWorkspaceSeatType";
4
3
  export type DesignSystemRole = Exclude<UserRole, UserRole.owner | UserRole.billing>;
5
4
  export declare const convertRemoteToDesignSystemRole: (remoteRole: DTODesignSystemRole) => DesignSystemRole;
6
- export declare const resolveDesignSystemRoleFromSeatTypeAndWorkspaceRole: (seatType: WorkspaceSeatType, wsRole: UserRole) => DesignSystemRole;
5
+ export declare const resolveDesignSystemRoleFromWorkspaceRole: (wsRole: UserRole) => DesignSystemRole;
@@ -3,6 +3,8 @@ export declare enum DocsBlockBehaviorSelectionType {
3
3
  entity = "Entity",
4
4
  /** Allows selection of groups only */
5
5
  group = "Group",
6
- /** Allows combined selection of data entities and groups */
7
- entityAndGroup = "EntityAndGroup"
6
+ /** Allows selection of either data entities or groups, never both at once */
7
+ entityAndGroup = "EntityAndGroup",
8
+ /** Allows no selection at all: the block derives its own content */
9
+ none = "None"
8
10
  }
@@ -1,6 +1,8 @@
1
- export declare enum DocsBlockContainerSize {
1
+ import type { PageBlockPreviewContainerSize } from "@supernova-studio/model";
2
+ export declare const DocsBlockContainerSize: {
2
3
  /** Default. Image is centered within a container */
3
- centered = "Centered",
4
+ readonly centered: "Centered";
4
5
  /** The container has the height of the asset within */
5
- naturalHeight = "NaturalHeight"
6
- }
6
+ readonly naturalHeight: "NaturalHeight";
7
+ };
8
+ export type DocsBlockContainerSize = PageBlockPreviewContainerSize;
@@ -57,5 +57,7 @@ export declare enum DocsBlockItemPropertyType {
57
57
  /** Figma component property (Figma components, variants, properties, etc.) */
58
58
  figmaComponent = "FigmaComponent",
59
59
  /** File property allows user to add file to download */
60
- file = "File"
60
+ file = "File",
61
+ /** Context property allows user to select a workspace or design-system context */
62
+ context = "Context"
61
63
  }
@@ -16,6 +16,7 @@ export declare enum DocumentationLegacyPageBlockType {
16
16
  figmaEmbed = "FigmaEmbed",
17
17
  youtubeEmbed = "YoutubeEmbed",
18
18
  storybookEmbed = "StorybookEmbed",
19
+ contextMcp = "ContextMcp",
19
20
  genericEmbed = "Embed",
20
21
  figmaFrames = "FigmaFrames",
21
22
  custom = "Custom",
@@ -34,6 +34,8 @@ export type DimensionTokenType = (typeof DIMENSION_TOKEN_TYPES)[number];
34
34
  export declare const RAW_DIMENSION_TOKEN_TYPES: readonly [TokenType.opacity, TokenType.zIndex];
35
35
  export declare const MS_DIMENSION_TOKEN_TYPES: readonly [TokenType.duration];
36
36
  export declare const ALL_TOKEN_TYPES: readonly [TokenType.dimension, TokenType.size, TokenType.space, TokenType.opacity, TokenType.fontSize, TokenType.lineHeight, TokenType.letterSpacing, TokenType.paragraphSpacing, TokenType.borderWidth, TokenType.radius, TokenType.duration, TokenType.zIndex, TokenType.string, TokenType.productCopy, TokenType.fontFamily, TokenType.fontWeight, TokenType.textCase, TokenType.textDecoration, TokenType.visibility, TokenType.color, TokenType.gradient, TokenType.border, TokenType.radius, TokenType.shadow, TokenType.typography, TokenType.blur];
37
+ /** Undefined for a token type the SDK has no case for, such as Image and Font */
38
+ export declare const tokenTypeFromString: (type: string | undefined) => TokenType | undefined;
37
39
  export declare const PURE_TOKEN_TYPES: readonly [TokenType.dimension, TokenType.size, TokenType.space, TokenType.opacity, TokenType.fontSize, TokenType.lineHeight, TokenType.letterSpacing, TokenType.paragraphSpacing, TokenType.borderWidth, TokenType.radius, TokenType.duration, TokenType.zIndex, TokenType.string, TokenType.productCopy, TokenType.fontFamily, TokenType.fontWeight, TokenType.textCase, TokenType.textDecoration, TokenType.visibility];
38
40
  export type PureTokenType = (typeof PURE_TOKEN_TYPES)[number];
39
41
  export type NonPureTokenType = Exclude<TokenType, PureTokenType>;
@@ -1,3 +1,14 @@
1
- import { DTOWorkspaceSeatType } from "@supernova-studio/client";
2
- export type WorkspaceSeatType = DTOWorkspaceSeatType;
3
- export declare const allWorkspaceSeatTypes: ["Full", "Builder", "None"];
1
+ import { DTOWorkspaceBilledSeatType, DTOWorkspaceSeatType } from "@supernova-studio/client";
2
+ /** The seat a workspace member holds. Builder seats have been migrated away */
3
+ export type WorkspaceSeatType = Exclude<DTOWorkspaceSeatType, "Builder">;
4
+ /**
5
+ * The seat a product price is sold against.
6
+ * Still includes Builder, because legacy Builder prices remain in the catalogue.
7
+ */
8
+ export type WorkspaceBilledSeatType = DTOWorkspaceBilledSeatType;
9
+ export declare const allWorkspaceSeatTypes: ["Full", "None"];
10
+ /**
11
+ * Converts a seat type coming off the wire.
12
+ * The API schema still permits Builder even though no member holds one any more.
13
+ */
14
+ export declare const remoteToWorkspaceSeatType: (remoteSeatType: DTOWorkspaceSeatType) => WorkspaceSeatType;
@@ -1,6 +1,6 @@
1
1
  import { DTOExporterPropertyDefinition } from "@supernova-studio/client";
2
2
  import { ExporterCustomBlock, ExporterCustomBlockModel } from "./custom_blocks/SDKExporterCustomBlock";
3
- import { ExporterCustomBlockVariant } from "./custom_blocks/SDKExporterCustomBlockVariant";
3
+ import { ExporterCustomBlockVariant, ExporterCustomBlockVariantModel } from "./custom_blocks/SDKExporterCustomBlockVariant";
4
4
  import { ExporterConfigurationProperty, ExporterConfigurationPropertyModel } from "./custom_properties/SDKExporterConfigurationProperty";
5
5
  import { ExporterPropertyDefinition } from "./custom_properties/SDKExporterPropertyDefinition";
6
6
  export type ExporterProvider = "github" | "gitlab" | "bitbucket" | "azure";
@@ -26,7 +26,7 @@ export type ExporterModel = {
26
26
  gitUrl: string;
27
27
  gitBranch: string;
28
28
  gitDirectory: string;
29
- blockVariants?: object;
29
+ blockVariants?: Record<string, Array<ExporterCustomBlockVariantModel>>;
30
30
  properties?: Array<DTOExporterPropertyDefinition>;
31
31
  configurationProperties?: Array<ExporterConfigurationPropertyModel>;
32
32
  customBlocks?: Array<ExporterCustomBlockModel>;
@@ -16,7 +16,7 @@ export declare class Pipeline {
16
16
  documentation?: {
17
17
  environment: "Live" | "Preview";
18
18
  };
19
- s3?: Record<string, unknown>;
19
+ s3?: Record<string, never>;
20
20
  github?: {
21
21
  url: string;
22
22
  branch: string;
@@ -1,6 +1,6 @@
1
1
  import { DTOUserWorkspaceMembership } from "@supernova-studio/client";
2
- import { WorkspaceSeatType } from "@supernova-studio/model";
3
2
  import { UserRole } from "../enums/SDKUserRole";
3
+ import { WorkspaceSeatType } from "../enums/SDKWorkspaceSeatType";
4
4
  import { Workspace } from "../workspaces/SDKWorkspace";
5
5
  export type MembershipRemoteModel = DTOUserWorkspaceMembership;
6
6
  export declare class Membership {
@@ -1,3 +1,4 @@
1
+ import { DataSourceUploadImportMetadata } from "@supernova-studio/model";
1
2
  import { DTPluginPreciseCopyStrategy, DTPluginThemeOverrideStrategy } from "../../tools/design-tokens/utilities/SDKDTMapLoader";
2
3
  import { ImportWarningType } from "../enums/SDKCloudWarningType";
3
4
  import { SourceType } from "../enums/SDKSourceType";
@@ -13,7 +14,7 @@ export type SourceRemoteModel = {
13
14
  type: SourceRemoteType;
14
15
  id: string;
15
16
  fileName?: string;
16
- brandId?: string;
17
+ brandId: string;
17
18
  themeId?: string;
18
19
  plugin?: {
19
20
  fileId: string;
@@ -130,7 +131,7 @@ export type SourceRemoteModelTokensStudio = {
130
131
  export type SourceRemoteModelFigmaVariablesPlugin = {
131
132
  fileId: string;
132
133
  lastImportedAt?: string;
133
- lastImportMetadata?: Record<string, unknown>;
134
+ lastImportMetadata?: DataSourceUploadImportMetadata;
134
135
  isTokenTypeSplitEnabled: boolean;
135
136
  };
136
137
  export type SourceRemoteModelUpload = {
@@ -175,7 +176,7 @@ export declare class Source {
175
176
  type: SourceType;
176
177
  id: string;
177
178
  fileName: string | null;
178
- brandId: string | null;
179
+ brandId: string;
179
180
  themeId: string | null;
180
181
  cloud: SourceModelCloud | null;
181
182
  tokenStudio?: SourceModelTokenStudio | null;
@@ -12,6 +12,7 @@ export type TokenThemeOverrideRemoteModel = {
12
12
  };
13
13
  export type TokenThemeOverrideTranserObject = {
14
14
  data: ColorTokenRemoteData | AnyStringTokenRemoteData | TypographyTokenRemoteData | ShadowTokenRemoteData | AnyDimensionTokenRemoteData | BorderTokenRemoteData | GradientTokenRemoteData | BlurTokenRemoteData | AnyOptionTokenRemoteData;
15
+ /** @deprecated Ignored — the override targets the token passed to `updateTokenData` */
15
16
  tokenPersistentId?: string;
16
17
  type?: TokenType;
17
18
  };
@@ -1,5 +1,7 @@
1
- import { TokenType } from "../../enums/SDKTokenType";
1
+ import { DTOTokenPropertyValueUpsertPayload } from "@supernova-studio/client";
2
2
  import { JSONValue } from "../../../utils/SDKJSONValue";
3
+ import { TokenType } from "../../enums/SDKTokenType";
4
+ import { TokenThemeOverrideTranserObject } from "../../themes/SDKTokenThemeOverride";
3
5
  import { AnyDimensionTokenRemoteData, BlurTokenRemoteData, BorderTokenRemoteData, ColorTokenRemoteData, GradientTokenRemoteData, ShadowTokenRemoteData, StringTokenRemoteData, TextCaseTokenRemoteData, TextDecorationTokenRemoteData, TypographyTokenRemoteData, VisibilityTokenRemoteData } from "./SDKRemoteTokenData";
4
6
  export type TokenRemoteModel = {
5
7
  id: string;
@@ -69,3 +71,34 @@ export type GradientTokenRemoteModel = TokenRemoteModel & {
69
71
  export type BlurTokenRemoteModel = TokenRemoteModel & {
70
72
  data: BlurTokenRemoteData;
71
73
  };
74
+ /** Theme overrides and property values that ride along with an aggregated token write */
75
+ type TokenBatchRelations = {
76
+ themeOverridesToUpsert?: Array<{
77
+ themePersistentId: string;
78
+ type: TokenType;
79
+ data: TokenThemeOverrideTranserObject["data"];
80
+ }>;
81
+ themeOverridesToDelete?: Array<{
82
+ themePersistentId: string;
83
+ }>;
84
+ propertyValuesToUpsert?: Array<DTOTokenPropertyValueUpsertPayload>;
85
+ /** Ids of the property values themselves, not of their definitions */
86
+ propertyValuesToDelete?: Array<string>;
87
+ };
88
+ /** Aggregated token update. Token fields are left out when they shouldn't change */
89
+ export type TokenBatchUpdatePayload = TokenBatchRelations & {
90
+ meta?: TokenRemoteModel["meta"];
91
+ data?: Pick<TokenRemoteModel, "data" | "type">;
92
+ originStyle?: TokenRemoteModel["originStyle"];
93
+ groupPersistentId?: string;
94
+ };
95
+ /** Aggregated token create. The endpoint assigns the version id and has no deletes to apply */
96
+ export type TokenBatchCreatePayload = Omit<TokenBatchRelations, "themeOverridesToDelete" | "propertyValuesToDelete"> & {
97
+ persistentId: string;
98
+ brandId: string;
99
+ meta: TokenRemoteModel["meta"];
100
+ data: Pick<TokenRemoteModel, "data" | "type">;
101
+ originStyle?: TokenRemoteModel["originStyle"];
102
+ groupPersistentId?: string;
103
+ };
104
+ export {};
@@ -20,7 +20,7 @@ export type TypographyTokenRemoteValue = {
20
20
  textDecoration: TextDecorationTokenRemoteData;
21
21
  textCase: TextCaseTokenRemoteData;
22
22
  letterSpacing: LetterSpacingTokenRemoteData;
23
- lineHeight: LineHeightTokenRemoteData | null;
23
+ lineHeight: LineHeightTokenRemoteData | undefined;
24
24
  paragraphSpacing: ParagraphSpacingTokenRemoteData;
25
25
  paragraphIndent: ParagraphSpacingTokenRemoteData;
26
26
  };
@@ -1,4 +1,4 @@
1
- import { WorkspaceSeatType } from "../enums/SDKWorkspaceSeatType";
1
+ import { WorkspaceBilledSeatType } from "../enums/SDKWorkspaceSeatType";
2
2
  import { WorkspaceSubscriptionPlanInterval } from "../enums/SDKWorkspaceSubscriptionPlanInterval";
3
3
  export type WorkspaceProductPriceRemoteModel = {
4
4
  stripePriceId: string;
@@ -8,11 +8,12 @@ export type WorkspaceProductPriceRemoteModel = {
8
8
  stripeProductAdditionalFeatures: Array<string>;
9
9
  active: boolean;
10
10
  amount: number;
11
- seatType?: WorkspaceSeatType;
11
+ seatType?: WorkspaceBilledSeatType;
12
12
  interval: WorkspaceSubscriptionPlanInterval;
13
13
  isPricePerCreator: boolean;
14
14
  legacyVersion?: string;
15
15
  monthlyCreditGrant?: number;
16
+ mcpConsumers?: number;
16
17
  };
17
18
  export type WorkspaceProductPriceTransportModel = WorkspaceProductPriceRemoteModel;
18
19
  export declare class WorkspaceProductPrice {
@@ -31,7 +32,7 @@ export declare class WorkspaceProductPrice {
31
32
  /** The amount to be charged for the product, in the smallest currency unit (e.g., cents) */
32
33
  amount: number;
33
34
  /** The matching seat (builder or full). Omitted for free plans */
34
- seatType?: WorkspaceSeatType;
35
+ seatType?: WorkspaceBilledSeatType;
35
36
  /** The billing interval (e.g., monthly, yearly) */
36
37
  interval: WorkspaceSubscriptionPlanInterval;
37
38
  /** Indicates whether the price is per creator (self-serve) or not */
@@ -40,6 +41,8 @@ export declare class WorkspaceProductPrice {
40
41
  legacyVersion?: string | null;
41
42
  /** The number of credits to be granted per month by this price */
42
43
  monthlyCreditGrant: number | null;
44
+ /** The number of MCP consumers included in this price */
45
+ mcpConsumers: number | null;
43
46
  constructor(model: WorkspaceProductPriceRemoteModel);
44
47
  toRemote(): WorkspaceProductPriceRemoteModel;
45
48
  toTransport(): WorkspaceProductPriceTransportModel;
@@ -19,6 +19,8 @@ export declare class WorkspaceSubscription {
19
19
  fullSeatLimit: number;
20
20
  /** Current number of DSM (Full) seats the workspace uses */
21
21
  fullSeats: number;
22
+ /** Maximum number of MCP consumers */
23
+ mcpConsumerLimit: number | undefined;
22
24
  /** Subscription tier */
23
25
  product: WorkspaceSubscriptionProductCode;
24
26
  /** Subscription cycle interval */
@@ -82,12 +84,6 @@ export declare class WorkspaceSubscription {
82
84
  balance: number;
83
85
  resetAt: Date | null;
84
86
  };
85
- spendingLimit: {
86
- total: number;
87
- used: number;
88
- balance: number;
89
- resetAt: Date | null;
90
- };
91
87
  } | null;
92
88
  /** Paid top-up credits balance */
93
89
  paidTopUp: {
@@ -1,4 +1,5 @@
1
1
  import { Supernova } from "../../core/SDKSupernova";
2
+ import { ActivityEventOptions } from "../../core/data/requests/SDKDataCoreWriteRequests";
2
3
  import { Brand } from "../../model/base/SDKBrand";
3
4
  import { TokenGroup } from "../../model/groups/SDKTokenGroup";
4
5
  import { Logger } from "../../model/support/SDKLogger";
@@ -28,7 +29,9 @@ export declare class SupernovaToolsDesignTokensPlugin {
28
29
  private logger;
29
30
  constructor(designSystemId: string, versionId: string, instance: Supernova, logger?: Logger);
30
31
  synchronizeTokensFromData(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings): Promise<object>;
31
- synchronizeTokensFromDataWithResults(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings): Promise<{
32
+ synchronizeTokensFromDataWithResults(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings, options?: {
33
+ activityEventOptions?: ActivityEventOptions;
34
+ }): Promise<{
32
35
  results: SupernovaToolsDesignTokensResult[];
33
36
  logs: string[];
34
37
  }>;
@@ -40,13 +43,13 @@ export declare class SupernovaToolsDesignTokensPlugin {
40
43
  groups: Array<TokenGroup>;
41
44
  };
42
45
  /** Loads remote source connected to this tool, then merges tokens and groups with it, creating union. Can optionally write to the source as well */
43
- mergeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, write: boolean, verbose: boolean, preciseCopy: DTPluginPreciseCopyStrategy): Promise<{
46
+ mergeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, write: boolean, verbose: boolean, preciseCopy: DTPluginPreciseCopyStrategy, activityEventOptions?: ActivityEventOptions): Promise<{
44
47
  tokens: Array<Token>;
45
48
  groups: Array<TokenGroup>;
46
49
  diff: DTTokenMergeDiff;
47
50
  }>;
48
51
  /** Loads remote source connected to this tool, then creates the diff from the base tree and updates the associated theme. Can optionally write to the source as well */
49
- mergeThemeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, theme: TokenTheme, write: boolean, verbose: boolean, preciseCopy?: DTPluginPreciseCopyStrategy, themeOverridesStrategy?: DTPluginThemeOverrideStrategy): Promise<{
52
+ mergeThemeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, theme: TokenTheme, write: boolean, verbose: boolean, preciseCopy?: DTPluginPreciseCopyStrategy, themeOverridesStrategy?: DTPluginThemeOverrideStrategy, activityEventOptions?: ActivityEventOptions): Promise<{
50
53
  theme: TokenTheme;
51
54
  tokens: Array<Token>;
52
55
  }>;