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

package/build/{sdk-typescript/src → types}/model/base/SDKDesignSystem.d.ts

@@ -15,6 +15,10 @@ export declare class DesignSystem {
     name: string;
     /** Design system description */
     description: string;
+    /** Identifier of the uploaded icon file. Null when no icon is set */
+    iconFileId: string | null;
+    /** Public URL of the design system icon. Null when no icon is set */
+    iconUrl: string | null;
     /** If enabled, parts of the design system can be accessed by public (for example, documentation site) */
     isPublic: boolean;
     /** If set, signals that multibrand functionality is enabled for this design system */

package/build/{sdk-typescript/src → types}/model/base/SDKDesignSystemCollection.d.ts

@@ -8,6 +8,7 @@ export declare class DesignSystemCollection {
     createdAt: Date | null;
     updatedAt: Date | null;
     originId: string | null;
-    originSourceId: string | null;
+    originSourceIds: Array<string>;
+    parentPersistentId: string | null;
     constructor(model: DTOTokenCollection);
 }

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

@@ -0,0 +1,14 @@
+import type { DTODesignSystemListViewItem, DTODesignSystemListViewPayload } from "@supernova-studio/client";
+export type DesignSystemListViewItemRemoteModel = DTODesignSystemListViewItem;
+/** Replaces the user's entire saved order + visibility for the workspace nav */
+export type DesignSystemListViewPayload = DTODesignSystemListViewPayload;
+/** A user's saved order + visibility for one design system in the workspace nav */
+export declare class DesignSystemListViewItem {
+    /** Design system this entry refers to */
+    designSystemId: string;
+    /** Position of the design system in the user's list */
+    sortOrder: number;
+    /** Whether the design system is shown in the user's list */
+    isVisible: boolean;
+    constructor(model: DesignSystemListViewItemRemoteModel);
+}

package/build/{sdk-typescript/src → types}/model/base/SDKDesignSystemMemberList.d.ts

@@ -12,6 +12,7 @@ export type DesignSystemInvitation = {
     workspaceInvitationId: string;
     designSystemRole: DesignSystemRole | null;
 };
+export type DesignSystemMemberListRemoteModel = DTODesignSystemMemberListResponse;
 export declare class DesignSystemMemberList {
     /**
      * List of existing users that belong to the design system.

package/build/types/model/code-components/SDKCodeComponent.d.ts

@@ -0,0 +1,18 @@
+import { DTOCodeComponent, DTOCodeComponentDocFile, DTOCodeComponentStorybookFile } from "@supernova-studio/client";
+import { CodeComponentPropertyDefinition } from "./SDKCodeComponentPropertyDefinition";
+export type CodeComponentStorybookFile = DTOCodeComponentStorybookFile;
+export type CodeComponentDocFile = DTOCodeComponentDocFile;
+export declare class CodeComponent {
+    id: string;
+    name: string;
+    packageName: string;
+    repositoryName: string;
+    description: string;
+    filePath: string;
+    props: Array<CodeComponentPropertyDefinition>;
+    storybookFiles: Array<CodeComponentStorybookFile>;
+    docFiles: Array<CodeComponentDocFile>;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(model: DTOCodeComponent);
+}

package/build/types/model/code-components/SDKCodeComponentMarkdown.d.ts

@@ -0,0 +1,14 @@
+import { DTOCodeComponentMarkdown, DTOCodeComponentReference } from "@supernova-studio/client";
+export type CodeComponentReference = DTOCodeComponentReference;
+export declare class CodeComponentMarkdown {
+    name: string;
+    componentKey: string;
+    packageName: string;
+    componentPath: string;
+    markdown: string;
+    constructor(model: DTOCodeComponentMarkdown);
+}
+export type CodeComponentMarkdownResult = {
+    /** Components for which markdown was found */
+    components: Array<CodeComponentMarkdown>;
+};

package/build/types/model/code-components/SDKCodeComponentPropUsage.d.ts

@@ -0,0 +1,7 @@
+import { DTOCodeComponentPropUsage } from "@supernova-studio/client";
+export declare class CodeComponentPropUsage {
+    usages: number;
+    values: Record<string, number>;
+    undefinedValue: number;
+    constructor(model: DTOCodeComponentPropUsage);
+}

package/build/types/model/code-components/SDKCodeComponentPropertyDefinition.d.ts

@@ -0,0 +1,7 @@
+import { DTOCodeComponentProperty } from "@supernova-studio/client";
+export declare class CodeComponentPropertyDefinition {
+    name: string;
+    isRequired: boolean;
+    type: string;
+    constructor(model: DTOCodeComponentProperty);
+}

package/build/types/model/code-components/SDKCodeComponentUsage.d.ts

@@ -0,0 +1,12 @@
+import { DTOCodeComponentUsage } from "@supernova-studio/client";
+import { CodeComponentPropUsage } from "./SDKCodeComponentPropUsage";
+export declare class CodeComponentUsage {
+    componentName: string;
+    componentPackageName: string;
+    usageRepositoryName: string;
+    usagePackageName: string;
+    usages: number;
+    usageFiles: number;
+    props: Record<string, CodeComponentPropUsage>;
+    constructor(model: DTOCodeComponentUsage);
+}

package/build/types/model/code-components/SDKCodeHistorySnapshot.d.ts

@@ -0,0 +1,12 @@
+import { DTOCodeHistoryQuery, DTOCodeHistoryRepositoryFilter, DTOCodeHistorySnapshot } from "@supernova-studio/client";
+export type CodeHistoryRepositoryFilter = DTOCodeHistoryRepositoryFilter;
+export type CodeHistoryQuery = DTOCodeHistoryQuery;
+export declare class CodeHistorySnapshot {
+    scanId: string;
+    scanTimestamp: Date;
+    totalComponents: number;
+    componentsWithUsage: number;
+    componentsWithStorybook: number;
+    totalUsages: number;
+    constructor(model: DTOCodeHistorySnapshot);
+}

package/build/types/model/code-components/SDKCodeScanListItem.d.ts

@@ -0,0 +1,11 @@
+import { DTOCodeScanListItem, DTOCodeScanUploadedBy } from "@supernova-studio/client";
+export type CodeScanUploadedBy = DTOCodeScanUploadedBy;
+export declare class CodeScanListItem {
+    scanId: string;
+    scanTimestamp: Date;
+    packageNames: Array<string>;
+    repositoryName: string;
+    uploadedBy: CodeScanUploadedBy | undefined;
+    cliVersion: string | undefined;
+    constructor(model: DTOCodeScanListItem);
+}

package/build/{sdk-typescript/src → types}/model/components/SDKComponent.d.ts

@@ -21,9 +21,7 @@ export declare class Component {
     name: string;
     description: string;
     properties: Array<ElementProperty>;
-    propertyValues: {
-        [key: string]: string | boolean | number;
-    };
+    propertyValues: Record<string, string | boolean | number>;
     createdAt: Date | null;
     updatedAt: Date | null;
     constructor(model: ComponentRemoteModel, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>);

package/build/types/model/context/SDKKnowledgeItem.d.ts

@@ -0,0 +1,42 @@
+import type { DTOKnowledgeFile, DTOKnowledgeFileCreatePayload, DTOKnowledgeFileDeletePayload, DTOKnowledgeFileDeleteResponse, DTOKnowledgeFileListResponse, DTOKnowledgeFileResponse, DTOKnowledgeFileUpdatePayload, DTOKnowledgeSkill, DTOKnowledgeSkillCreatePayload, DTOKnowledgeSkillDeletePayload, DTOKnowledgeSkillDeleteResponse, DTOKnowledgeSkillListResponse, DTOKnowledgeSkillResponse, DTOKnowledgeSkillUpdatePayload } from "@supernova-studio/client";
+export type KnowledgeFileCreateInput = DTOKnowledgeFileCreatePayload;
+export type KnowledgeFileDeleteInput = DTOKnowledgeFileDeletePayload;
+export type KnowledgeFileDeleteResponse = DTOKnowledgeFileDeleteResponse;
+export type KnowledgeFileListResponse = DTOKnowledgeFileListResponse;
+export type KnowledgeFileResponse = DTOKnowledgeFileResponse;
+export type KnowledgeFileRemoteModel = Omit<DTOKnowledgeFile, "isTextReadable">;
+export type KnowledgeFileUpdateInput = DTOKnowledgeFileUpdatePayload;
+export declare class KnowledgeFile {
+    id: string;
+    workspaceId: string;
+    createdByUserId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    contentUpdatedAt: Date;
+    path: string;
+    description: string;
+    file: KnowledgeFileRemoteModel["file"];
+    constructor(model: KnowledgeFileRemoteModel);
+    toRemote(): KnowledgeFileRemoteModel;
+}
+export type KnowledgeSkillCreateInput = DTOKnowledgeSkillCreatePayload;
+export type KnowledgeSkillDeleteInput = DTOKnowledgeSkillDeletePayload;
+export type KnowledgeSkillDeleteResponse = DTOKnowledgeSkillDeleteResponse;
+export type KnowledgeSkillListResponse = DTOKnowledgeSkillListResponse;
+export type KnowledgeSkillResponse = DTOKnowledgeSkillResponse;
+export type KnowledgeSkillRemoteModel = DTOKnowledgeSkill;
+export type KnowledgeSkillUpdateInput = DTOKnowledgeSkillUpdatePayload;
+export declare class KnowledgeSkill {
+    id: string;
+    workspaceId: string;
+    createdByUserId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    contentUpdatedAt: Date;
+    path: string;
+    name: string;
+    description: string;
+    content: string;
+    constructor(model: KnowledgeSkillRemoteModel);
+    toRemote(): KnowledgeSkillRemoteModel;
+}

package/build/types/model/datasets/SDKDataset.d.ts

@@ -0,0 +1,228 @@
+export declare const DATASET_ENTITY_TYPES: readonly ["tokens", "tokenThemes", "figmaComponents", "designComponents", "assets", "documentation", "contexts", "skills", "files", "codeComponents"];
+export declare const DATASET_WORKSPACE_ENTITY_TYPES: readonly ["contexts", "skills", "files"];
+export type DatasetEntityType = (typeof DATASET_ENTITY_TYPES)[number];
+export type DatasetLogicalOperator = "and" | "or";
+export type DatasetPropertyOperator = "is" | "isNot" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "isEmpty" | "isNotEmpty" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "in" | "notIn";
+export type DatasetPrimitiveValue = string | number | boolean | null;
+export type DatasetConditionValue = DatasetPrimitiveValue | readonly DatasetPrimitiveValue[];
+export type DatasetEntityFieldMap = {
+    tokens: {
+        id: string;
+        name: string;
+        description: string;
+        path: string;
+        tokenType: string;
+        brandId: string;
+        themeId: string | null;
+        collectionId: string | null;
+        sortOrder: number;
+    };
+    tokenThemes: {
+        id: string;
+        name: string;
+        description: string;
+        codeName: string;
+        brandId: string;
+        collectionName: string;
+    };
+    figmaComponents: {
+        id: string;
+        name: string;
+        description: string;
+    };
+    designComponents: {
+        id: string;
+        name: string;
+        description: string;
+        [property: `customProperties.${string}`]: string | number | boolean | null;
+    };
+    assets: {
+        id: string;
+        name: string;
+        description: string;
+    };
+    documentation: {
+        id: string;
+        name: string;
+        description: string;
+        path: string;
+    };
+    contexts: {
+        id: string;
+        name: string;
+        description: string;
+        workspaceId: string;
+        designSystemId: string | null;
+    };
+    skills: {
+        id: string;
+        name: string;
+        path: string;
+        description: string;
+        type: string;
+    };
+    files: {
+        id: string;
+        name: string;
+        path: string;
+        description: string;
+        type: string;
+    };
+    codeComponents: {
+        id: string;
+        name: string;
+        description: string;
+        packageName: string;
+        repositoryName: string;
+        filePath: string;
+    };
+};
+export type DatasetFilterProperty<TEntity extends DatasetEntityType> = keyof DatasetEntityFieldMap[TEntity] & string;
+type DatasetFieldValue<TEntity extends DatasetEntityType, TProperty extends DatasetFilterProperty<TEntity>> = DatasetEntityFieldMap[TEntity][TProperty];
+type DatasetStringPropertyOperator = "is" | "isNot" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "isEmpty" | "isNotEmpty" | "in" | "notIn";
+type DatasetNumberPropertyOperator = "is" | "isNot" | "isEmpty" | "isNotEmpty" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "in" | "notIn";
+type DatasetBooleanPropertyOperator = "is" | "isNot" | "isEmpty" | "isNotEmpty";
+type DatasetArrayPropertyOperator = "contains" | "doesNotContain" | "isEmpty" | "isNotEmpty" | "in" | "notIn";
+export type DatasetPropertyOperatorForField<TEntity extends DatasetEntityType, TProperty extends DatasetFilterProperty<TEntity>> = DatasetFieldValue<TEntity, TProperty> extends readonly unknown[] ? DatasetArrayPropertyOperator : DatasetFieldValue<TEntity, TProperty> extends number ? DatasetNumberPropertyOperator : DatasetFieldValue<TEntity, TProperty> extends boolean ? DatasetBooleanPropertyOperator : DatasetStringPropertyOperator;
+export type DatasetConditionValueForField<TEntity extends DatasetEntityType, TProperty extends DatasetFilterProperty<TEntity>> = DatasetFieldValue<TEntity, TProperty> extends readonly (infer TItem)[] ? TItem | readonly TItem[] : DatasetFieldValue<TEntity, TProperty> | readonly DatasetFieldValue<TEntity, TProperty>[];
+export type DatasetIncludeAllCondition = {
+    type: "includeAll";
+};
+export type DatasetIncludeIdsCondition = {
+    type: "includeIds";
+    ids: readonly string[];
+};
+export type DatasetExcludeIdsCondition = {
+    type: "excludeIds";
+    ids: readonly string[];
+};
+export type DatasetPropertyCondition<TEntity extends DatasetEntityType = DatasetEntityType, TProperty extends DatasetFilterProperty<TEntity> = DatasetFilterProperty<TEntity>> = {
+    type: "property";
+    property: TProperty;
+    operator: DatasetPropertyOperatorForField<TEntity, TProperty>;
+    value?: DatasetConditionValueForField<TEntity, TProperty>;
+};
+export type DatasetCondition<TEntity extends DatasetEntityType = DatasetEntityType> = DatasetIncludeAllCondition | DatasetIncludeIdsCondition | DatasetExcludeIdsCondition | DatasetPropertyCondition<TEntity>;
+export type DatasetFilterNode<TEntity extends DatasetEntityType = DatasetEntityType> = DatasetCondition<TEntity> | DatasetFilterGroup<TEntity>;
+export type DatasetFilterGroup<TEntity extends DatasetEntityType = DatasetEntityType> = {
+    type: "group";
+    operator: DatasetLogicalOperator;
+    children: readonly DatasetFilterNode<TEntity>[];
+};
+export type DatasetEntity = {
+    id: string;
+    [property: string]: unknown;
+};
+export type DatasetFilterItem = {
+    id: string;
+};
+export type DatasetFilterEntity<TItem extends DatasetFilterItem> = DatasetEntity & {
+    name?: string;
+    path?: string;
+    item: TItem;
+};
+export type DatasetFilterResultSource = "current" | "inherited";
+export type DatasetFilterResult<TItem extends DatasetFilterItem> = {
+    item: TItem;
+    source: DatasetFilterResultSource;
+};
+export type DatasetFilterResultByEntityType<TItem extends DatasetFilterItem = DatasetFilterItem> = Partial<Record<DatasetEntityType, Array<DatasetFilterResult<TItem>>>>;
+export type DatasetIdInScopeResult = {
+    status: "in_scope";
+    reason: "includeAll" | "explicit_include" | "no_filter_configured";
+} | {
+    status: "not_in_scope";
+    reason: "explicit_exclude" | "not_in_includes";
+};
+export type DatasetItemProjector<TItem extends DatasetFilterItem> = (item: TItem) => DatasetFilterEntity<TItem>;
+export type DatasetSelections = Partial<Record<DatasetEntityType, DatasetFilterGroup>>;
+export type SDKDatasetData = {
+    designSystemId?: string | null;
+    selections?: DatasetSelections;
+};
+export type DatasetResolveResult<TEntity extends DatasetFilterItem = DatasetEntity> = DatasetFilterResultByEntityType<TEntity>;
+export type DatasetDataRepository<TEntity extends DatasetFilterItem = DatasetEntity> = {
+    getAllForType: (entityType: DatasetEntityType, designSystemId: string | null) => readonly TEntity[];
+};
+type DatasetPropertyGetter<TEntity extends DatasetEntity> = (item: TEntity, property: string) => unknown;
+/**
+ * Canonical id for dataset filter matching. For `documentation` items, prefer
+ * `persistentId` when present — page entities expose both `id` (numeric,
+ * version-specific) and `persistentId` (UUID, stable across versions), and
+ * filters store the persistentId. Other entity types fall through to `id`,
+ * which the SDK already normalizes to the persistent form on construction.
+ */
+export declare const getDatasetFilterEntityId: <TItem extends DatasetFilterItem>(item: TItem, entityType: DatasetEntityType) => string;
+export type DatasetEvaluatedPropertyCondition = {
+    type: "property";
+    property: string;
+    operator: DatasetPropertyOperator;
+    value?: DatasetConditionValue;
+};
+export type DatasetFilterEvaluationOptions = {
+    isPropertyConditionValid?: (condition: DatasetEvaluatedPropertyCondition) => boolean;
+};
+export declare class DatasetSelectionBuilder<TEntity extends DatasetEntityType> {
+    and(children: readonly DatasetFilterNode<TEntity>[]): DatasetFilterGroup<TEntity>;
+    or(children: readonly DatasetFilterNode<TEntity>[]): DatasetFilterGroup<TEntity>;
+    includeAll(): DatasetIncludeAllCondition;
+    includeIds(ids: readonly string[]): DatasetIncludeIdsCondition;
+    excludeIds(ids: readonly string[]): DatasetExcludeIdsCondition;
+    where<TProperty extends DatasetFilterProperty<TEntity>, TOperator extends DatasetPropertyOperatorForField<TEntity, TProperty>>(property: TProperty, operator: TOperator, value?: DatasetConditionValueForField<TEntity, TProperty>): DatasetPropertyCondition<TEntity, TProperty>;
+}
+export declare class SDKDataset {
+    /** @deprecated not used anymore */
+    readonly designSystemId: string | null;
+    readonly tokens?: DatasetFilterGroup;
+    readonly tokenThemes?: DatasetFilterGroup;
+    readonly figmaComponents?: DatasetFilterGroup;
+    readonly designComponents?: DatasetFilterGroup;
+    readonly assets?: DatasetFilterGroup;
+    readonly documentation?: DatasetFilterGroup;
+    readonly contexts?: DatasetFilterGroup;
+    readonly skills?: DatasetFilterGroup;
+    readonly files?: DatasetFilterGroup;
+    readonly codeComponents?: DatasetFilterGroup;
+    private readonly refinedSourceDataset?;
+    private readonly refinedBaseDataset?;
+    constructor(data?: SDKDatasetData, refinedSourceDataset?: SDKDataset, refinedBaseDataset?: SDKDataset);
+    static create(designSystemId?: string | null): SDKDataset;
+    static and<TEntity extends DatasetEntityType = DatasetEntityType>(children: readonly DatasetFilterNode<TEntity>[]): DatasetFilterGroup<TEntity>;
+    static or<TEntity extends DatasetEntityType = DatasetEntityType>(children: readonly DatasetFilterNode<TEntity>[]): DatasetFilterGroup<TEntity>;
+    static includeAll(): DatasetIncludeAllCondition;
+    static includeIds(ids: readonly string[]): DatasetIncludeIdsCondition;
+    static excludeIds(ids: readonly string[]): DatasetExcludeIdsCondition;
+    withSelection<TEntity extends DatasetEntityType>(entityType: TEntity, buildGroup: (builder: DatasetSelectionBuilder<TEntity>) => DatasetFilterGroup<TEntity>): SDKDataset;
+    withoutSelection(entityType: DatasetEntityType): SDKDataset;
+    canUnionWith(other: SDKDataset): boolean;
+    union(other: SDKDataset): SDKDataset;
+    refine(baseDataset: SDKDataset): SDKDataset;
+    resolve<TEntity extends DatasetEntity>(repository: DatasetDataRepository<TEntity>, getPropertyValue?: DatasetPropertyGetter<TEntity>): DatasetResolveResult<TEntity>;
+    filteredTokens<TToken extends DatasetFilterItem>(allTokens: readonly TToken[], inheritedDataset?: SDKDataset): DatasetFilterResult<TToken>[];
+    filteredTokenThemes<TTokenTheme extends DatasetFilterItem>(allTokenThemes: readonly TTokenTheme[], inheritedDataset?: SDKDataset): DatasetFilterResult<TTokenTheme>[];
+    filteredFigmaComponents<TFigmaComponent extends DatasetFilterItem>(allFigmaComponents: readonly TFigmaComponent[], inheritedDataset?: SDKDataset): DatasetFilterResult<TFigmaComponent>[];
+    filteredDesignComponents<TDesignComponent extends DatasetFilterItem>(allDesignComponents: readonly TDesignComponent[], inheritedDataset?: SDKDataset): DatasetFilterResult<TDesignComponent>[];
+    filteredAssets<TAsset extends DatasetFilterItem>(allAssets: readonly TAsset[], inheritedDataset?: SDKDataset): DatasetFilterResult<TAsset>[];
+    filteredDocumentation<TDocumentation extends DatasetFilterItem>(allDocumentation: readonly TDocumentation[], inheritedDataset?: SDKDataset): DatasetFilterResult<TDocumentation>[];
+    filteredContexts<TContext extends DatasetFilterItem>(allContexts: readonly TContext[], inheritedDataset?: SDKDataset): DatasetFilterResult<TContext>[];
+    filteredSkills<TSkill extends DatasetFilterItem>(allSkills: readonly TSkill[], inheritedDataset?: SDKDataset): DatasetFilterResult<TSkill>[];
+    filteredFiles<TFile extends DatasetFilterItem>(allFiles: readonly TFile[], inheritedDataset?: SDKDataset): DatasetFilterResult<TFile>[];
+    filteredCodeComponents<TCodeComponent extends DatasetFilterItem>(allCodeComponents: readonly TCodeComponent[], inheritedDataset?: SDKDataset): DatasetFilterResult<TCodeComponent>[];
+    filteredItems<TItem extends DatasetFilterItem>(entityType: DatasetEntityType, allItems: readonly TItem[], inheritedDataset?: SDKDataset, projectItem?: DatasetItemProjector<TItem>, evaluationOptions?: DatasetFilterEvaluationOptions): Array<DatasetFilterResult<TItem>>;
+    /**
+     * Id-only membership check against the dataset's scope for one entity type.
+     * Walks the filter tree for `includeAll`, `includeIds`, `excludeIds` and
+     * returns a structured reason. Does not evaluate property predicates — for
+     * those use `filteredItems`.
+     *
+     * Default for a missing filter group: strict-default entities drop, every
+     * other entity passes.
+     */
+    isIdInScope(entityType: DatasetEntityType, id: string): DatasetIdInScopeResult;
+    isEmpty(): boolean;
+    private getSelections;
+    toRemote(): SDKDatasetData;
+    private getMatchingItemIds;
+    private mapItemsToResults;
+}
+export {};

package/build/{sdk-typescript/src → types}/model/docs/blocks/definition/SDKDocsBlockBehavior.d.ts

@@ -24,7 +24,10 @@ export declare class DocsBlockBehavior {
         /**
          * If selectionType === "Entity", then only an entity of specific "dataType" can be selected (and no groups of that type)
          * If selectionType === "Group", then only a group of specific "dataType" can be selected (and no entity of that type)
-         * If selectionType === "EntityAndGroup", then both can be selected, even together
+         * If selectionType === "EntityAndGroup", then either can be selected, but never both at once
+         * If selectionType === "None", then nothing can be selected: the block derives its own content
+         *
+         * At most one group can be selected, whichever type allows groups
          */
         selectionType: DocsBlockBehaviorSelectionType;
         /**

package/build/types/model/docs/blocks/definition/actual/context-mcp/SDKDocsBlockActualContextMcp.d.ts

@@ -0,0 +1,2 @@
+declare const block: import("../../SDKDocsBlockDefinition").DocsBlockDefinition;
+export { block as ContextMcp };

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

@@ -0,0 +1,17 @@
+import type { PageBlockItemAssetValue } from "@supernova-studio/model";
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+/** Asset property - Additional non-value options */
+export type DocsBlockAssetPropertyOptions = Record<string, never>;
+/** Asset property - Data */
+export type DocsBlockAssetPropertyData = PageBlockItemAssetValue;
+/** Asset property - Value */
+export type DocsBlockAssetPropertyValue = DocsBlockAssetPropertyData["value"];
+/** Asset property - Entity */
+export type DocsBlockAssetPropertyEntity = DocsBlockAssetPropertyValue[number];
+/** Asset property - Definition model */
+export type DocsBlockAssetPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockAssetPropertyOptions;
+/** Asset property - Definition */
+export declare class DocsBlockAssetPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockAssetPropertyOptions, DocsBlockAssetPropertyData> {
+    type: DocsBlockItemPropertyType.asset;
+}

package/build/{sdk-typescript/src → types}/model/docs/blocks/properties/SDKDocsBlockAssetPropertyProperty.d.ts

@@ -1,9 +1,10 @@
+import type { PageBlockItemAssetPropertyValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
-import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
 /** Asset property property - Additional non-value options */
 export type DocsBlockAssetPropertyPropertyOptions = Record<string, never>;
 /** Asset property property - Data */
-export type DocsBlockAssetPropertyPropertyData = DocsBlockPropertyData<Array<string>> & Record<string, never>;
+export type DocsBlockAssetPropertyPropertyData = PageBlockItemAssetPropertyValue;
 /** Asset property property - Definition model */
 export type DocsBlockAssetPropertyPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockAssetPropertyPropertyOptions;
 /** Asset property property - Definition */

package/build/{sdk-typescript/src → types}/model/docs/blocks/properties/SDKDocsBlockBooleanProperty.d.ts

@@ -1,6 +1,7 @@
+import type { PageBlockItemBooleanValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyOptionRenderingStyle } from "../../../enums/SDKDocsBlockItemPropertyOptionRenderingStyle";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
-import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
 /** Boolean property - Additional non-value options */
 export type DocsBlockBooleanPropertyOptions = {
     /** Default value to set when block is created */
@@ -9,7 +10,7 @@ export type DocsBlockBooleanPropertyOptions = {
     booleanStyle?: Exclude<DocsBlockItemPropertyOptionRenderingStyle, DocsBlockItemPropertyOptionRenderingStyle.select>;
 };
 /** Boolean property - Data */
-export type DocsBlockBooleanPropertyData = DocsBlockPropertyData<boolean> & Record<string, never>;
+export type DocsBlockBooleanPropertyData = PageBlockItemBooleanValue;
 /** Boolean property - Definition model */
 export type DocsBlockBooleanPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockBooleanPropertyOptions;
 /** Boolean property - Definition */

package/build/{sdk-typescript/src → types}/model/docs/blocks/properties/SDKDocsBlockCodeProperty.d.ts

@@ -1,15 +1,12 @@
-import { CodeLanguage } from "../../../enums/SDKCodeLanguage";
+import type { PageBlockItemCodeValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
-import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
 /** Code property - Additional non-value options */
 export type DocsBlockCodePropertyOptions = {
     shouldHideCodeSyntax?: boolean;
 };
 /** Code property - Data */
-export type DocsBlockCodePropertyData = DocsBlockPropertyData<string> & {
-    format?: CodeLanguage;
-    caption?: string;
-};
+export type DocsBlockCodePropertyData = PageBlockItemCodeValue;
 /** Code property - Definition model */
 export type DocsBlockCodePropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockCodePropertyOptions;
 /** Code property - Definition */

package/build/{sdk-typescript/src → types}/model/docs/blocks/properties/SDKDocsBlockCodeSandboxProperty.d.ts

@@ -1,18 +1,13 @@
+import type { PageBlockItemSandboxValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
-import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel, DocsBlockPropertyData } from "./SDKDocsBlockProperty";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
 /** Code Sandbox property - Additional non-value options */
 export type DocsBlockCodeSandboxPropertyOptions = {
     /** How should we render the code example in editor */
     renderLayoutAs?: "PreviewOnTop" | "PreviewOnBottom" | "PreviewOnLeft" | "PreviewOnRight";
 };
 /** Code Sandbox property - Data */
-export type DocsBlockCodeSandboxPropertyData = DocsBlockPropertyData<string> & {
-    showCode?: boolean;
-    showControls?: boolean;
-    backgroundColor?: string;
-    alignPreview?: "Left" | "Center";
-    previewHeight?: number;
-};
+export type DocsBlockCodeSandboxPropertyData = PageBlockItemSandboxValue;
 /** Code Sandbox property - Definition model */
 export type DocsBlockCodeSandboxPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockCodeSandboxPropertyOptions;
 /** Code Sandbox property - Definition */

package/build/{sdk-typescript/src → types}/model/docs/blocks/properties/SDKDocsBlockColorProperty.d.ts

@@ -1,10 +1,10 @@
+import type { PageBlockItemColorValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
-import { ColorTokenValue } from "../../../tokens/SDKTokenValue";
-import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
 /** Color property - Additional non-value options */
 export type DocsBlockColorPropertyOptions = Record<string, never>;
 /** Color property - Data */
-export type DocsBlockColorPropertyData = DocsBlockPropertyData<ColorTokenValue> & Record<string, never>;
+export type DocsBlockColorPropertyData = PageBlockItemColorValue;
 /** Color property - Definition model */
 export type DocsBlockColorPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockColorPropertyOptions;
 /** Color property - Definition */

package/build/{sdk-typescript/src → types}/model/docs/blocks/properties/SDKDocsBlockComponentProperty.d.ts

@@ -1,5 +1,6 @@
+import type { PageBlockItemComponentValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
-import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
 /** Component property - Additional non-value options */
 export type DocsBlockComponentPropertyOptions = {
     /** How should the tokens be rendered in editor */
@@ -8,15 +9,11 @@ export type DocsBlockComponentPropertyOptions = {
     allowPropertySelection?: boolean;
 };
 /** Component property - Data */
-export type DocsBlockComponentPropertyData = DocsBlockPropertyData<Array<{
-    entityId: string;
-    entityType: "Component" | "ComponentGroup";
-}>> & {
-    /** Selected component ids */
-    selectedPropertyIds?: Array<string>;
-    /** Brand id */
-    selectedBrandId?: string;
-};
+export type DocsBlockComponentPropertyData = PageBlockItemComponentValue;
+/** Component property - Value */
+export type DocsBlockComponentPropertyValue = DocsBlockComponentPropertyData["value"];
+/** Component property - Entity */
+export type DocsBlockComponentPropertyEntity = DocsBlockComponentPropertyValue[number];
 /** Component property - Definition model */
 export type DocsBlockComponentPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockComponentPropertyOptions;
 /** Component property - Definition */

package/build/{sdk-typescript/src → types}/model/docs/blocks/properties/SDKDocsBlockComponentPropertyProperty.d.ts

@@ -1,9 +1,10 @@
+import type { PageBlockItemComponentPropertyValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
-import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+import { 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>;
+export type DocsBlockComponentPropertyPropertyData = PageBlockItemComponentPropertyValue;
 /** ComponentProperty property - Definition model */
 export type DocsBlockComponentPropertyPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockComponentPropertyPropertyOptions;
 /** ComponentProperty property - Definition */

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

@@ -0,0 +1,16 @@
+import { PageBlockContextConnection, type PageBlockItemContextValue } from "@supernova-studio/model";
+import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
+import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+export declare const DocsBlockContextPropertyConnectionValues: ["cursor", "claudeCode", "vsCode", "codex", "codeSnippet", "url"];
+export type DocsBlockContextPropertyConnection = PageBlockContextConnection;
+export type DocsBlockContextPropertyOptions = Record<string, never>;
+/** Context property - Data */
+export type DocsBlockContextPropertyData = PageBlockItemContextValue;
+/** Context property - Value */
+export type DocsBlockContextPropertyValue = DocsBlockContextPropertyData["value"];
+/** Context property - Entity */
+export type ContextEntity = DocsBlockContextPropertyValue[number];
+export type DocsBlockContextPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockContextPropertyOptions;
+export declare class DocsBlockContextPropertyDefinition extends DocsBlockPropertyDefinition<DocsBlockContextPropertyOptions, DocsBlockContextPropertyData> {
+    type: DocsBlockItemPropertyType.context;
+}

package/build/{sdk-typescript/src → types}/model/docs/blocks/properties/SDKDocsBlockDividerProperty.d.ts

@@ -1,9 +1,10 @@
+import type { PageBlockItemDividerValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
-import { DocsBlockPropertyData, DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
+import { 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>;
+export type DocsBlockDividerPropertyData = PageBlockItemDividerValue;
 /** Divider property - Definition model */
 export type DocsBlockDividerPropertyDefinitionModel = DocsBlockPropertyDefinitionModel & DocsBlockDividerPropertyOptions;
 /** Divider property - Definition */