ws.smartArt

add(config: SmartArtConfig): Promise<SmartArtObject>;

Add a diagram to the sheet. Returns the created floating object.

get(objectId: string): Promise<SmartArtDiagram | null>;

Get a diagram by object ID, or null if not found.

has(objectId: string): Promise<boolean>;

Check if a diagram exists by object ID.

getCount(): Promise<number>;

Get the total number of diagrams on this sheet.

remove(objectId: string): Promise<void>;

Remove a diagram by object ID.

list(): Promise<SmartArtDiagram[]>;

List all diagrams on the sheet.

clear(): Promise<void>;

Remove all diagrams from the sheet.

duplicate(objectId: string): Promise<string>;

Duplicate a diagram. Returns the new object ID.

addNode(
    objectId: string,
    text: string,
    position: NodePosition,
    referenceNodeId: NodeId | null,
  ): Promise<NodeId>;

Add a node to a diagram. Returns the new node ID.

removeNode(objectId: string, nodeId: NodeId): Promise<void>;

Remove a node from a diagram.

updateNode(
    objectId: string,
    nodeId: NodeId,
    updates: Partial<SmartArtNode>,
  ): Promise<void>;

Update a node's properties.

moveNode(objectId: string, nodeId: NodeId, direction: NodeMoveDirection): Promise<void>;

Move a node in the hierarchy.

getNode(
    objectId: string,
    nodeId: NodeId,
  ): Promise<SmartArtNode | undefined>;

Get a node by ID.

getDiagram(objectId: string): Promise<SmartArtDiagram | null>;

@deprecated Use `get(objectId)` instead. Will be removed in a future release.

getDiagramsOnSheet(): Promise<SmartArtDiagram[]>;

@deprecated Use `list()` instead. Will be removed in a future release.

changeLayout(objectId: string, newLayoutId: string): Promise<void>;

Change the diagram layout.

changeQuickStyle(objectId: string, quickStyleId: string): Promise<void>;

Change the quick style.

changeColorTheme(objectId: string, colorThemeId: string): Promise<void>;

Change the color theme.

getComputedLayout(
    objectId: string,
  ): Promise<ComputedLayout | undefined>;

Get the computed layout for a diagram. Returns cached result if valid.

invalidateLayout(objectId: string): void;

Invalidate the cached layout for a diagram.

invalidateAllLayouts(): void;

Invalidate all cached layouts.