@uniformdev/mesh-sdk 20.56.1-alpha.10 → 20.56.1-alpha.21

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { ApiClient, ClientOptions, ExceptProject } from '@uniformdev/context/api';
-import { AssetParamValue, DataType, DataSource, DataSourceVariantsKeys, DataResourceVariables, RootComponentInstance, ComponentInstance, ComponentDefinition, ComponentDefinitionParameter, DataVariableDefinition, Locale, EntryData } from '@uniformdev/canvas';
+import { AssetParamValue, DataType, DataSource, DataSourceVariantsKeys, DataResourceVariables, RootComponentInstance, ComponentInstance, ComponentDefinition, ComponentDefinitionParameter, DataVariableDefinition, Locale, ComponentParameter, VisibilityCriteriaGroup, EntryData } from '@uniformdev/canvas';
 export { AssetParamValue, AssetParamValueItem } from '@uniformdev/canvas';
 import { ProjectMapNode } from '@uniformdev/project-map';
 import { AssetDefinitionType } from '@uniformdev/assets';
@@ -174,6 +174,18 @@ interface paths$1 {
                                                     };
                                                 };
                                                 embeddedEditor?: string;
+                                                dataResourceSelectorUrl?: string;
+                                                dataResourceSelectorLocations?: {
+                                                    [key: string]: {
+                                                        url: string;
+                                                        layout?: {
+                                                            /** @enum {string} */
+                                                            height?: "full-height";
+                                                            /** @enum {string} */
+                                                            width?: "wide";
+                                                        };
+                                                    };
+                                                };
                                             };
                                         };
                                         badgeIconUrl?: string;
@@ -452,6 +464,18 @@ interface paths$1 {
                                                 };
                                             };
                                             embeddedEditor?: string;
+                                            dataResourceSelectorUrl?: string;
+                                            dataResourceSelectorLocations?: {
+                                                [key: string]: {
+                                                    url: string;
+                                                    layout?: {
+                                                        /** @enum {string} */
+                                                        height?: "full-height";
+                                                        /** @enum {string} */
+                                                        width?: "wide";
+                                                    };
+                                                };
+                                            };
                                         };
                                     };
                                     badgeIconUrl?: string;
@@ -715,6 +739,18 @@ interface paths$1 {
                                                 };
                                             };
                                             embeddedEditor?: string;
+                                            dataResourceSelectorUrl?: string;
+                                            dataResourceSelectorLocations?: {
+                                                [key: string]: {
+                                                    url: string;
+                                                    layout?: {
+                                                        /** @enum {string} */
+                                                        height?: "full-height";
+                                                        /** @enum {string} */
+                                                        width?: "wide";
+                                                    };
+                                                };
+                                            };
                                         };
                                     };
                                     badgeIconUrl?: string;
@@ -1328,6 +1364,16 @@ declare class IntegrationDefinitionClient extends ApiClient<DefClientOptions> {
                             };
                         };
                         embeddedEditor?: string;
+                        dataResourceSelectorUrl?: string;
+                        dataResourceSelectorLocations?: {
+                            [key: string]: {
+                                url: string;
+                                layout?: {
+                                    height?: "full-height";
+                                    width?: "wide";
+                                };
+                            };
+                        };
                     };
                 };
                 badgeIconUrl?: string;
@@ -1568,6 +1614,35 @@ type DataResourceLocationMetadata<TIntegrationConfiguration = unknown> = CommonM
 }, TIntegrationConfiguration>;
 type DataResourceLocation = MeshLocationCore<DataResourceVariables, DataResourceLocationMetadata, DataResourceVariables, 'dataResource'> & GetDataResourceLocation;
 
+/**
+ * Metadata for the dataResourceSelector location.
+ * This location type allows custom UI for selecting JSON pointers within a data resource,
+ * replacing the default JSON tree viewer in the dynamic token picker.
+ * @deprecated This is experimental functionality and is subject to change without notice.
+ */
+type DataResourceSelectorLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
+    /** The resolved data for the currently selected data resource */
+    dataResourceValue: unknown;
+    /** The name of the currently selected data resource */
+    dataResourceName: string;
+    /** The data type ID for the current data resource */
+    dataTypeId: string;
+    /** The data type's archetype value (useful for apps sharing a selector across archetypes) */
+    archetype: string;
+    /** Allowed bindable types for the parameter being connected */
+    allowedTypes: BindableTypes[];
+}, TIntegrationConfiguration>;
+/**
+ * Location for custom data resource selector UI.
+ * Replaces the default JSON tree viewer when selecting dynamic tokens from a data resource.
+ *
+ * Value: The selected JSON pointer string (e.g., "/moves/0/move/name")
+ * setValue: Call with a valid JSON pointer to select that path
+ * getDataResource: Fetch data from the data connector using the current data source
+ * @deprecated This is experimental functionality and is subject to change without notice.
+ */
+type DataResourceSelectorLocation = MeshLocationCore<string, DataResourceSelectorLocationMetadata, string, 'dataResourceSelector'> & GetDataResourceLocation;
+
 type DataSourceLocationValue = Pick<DataSource, 'baseUrl' | 'custom' | 'customPublic' | 'headers' | 'parameters' | 'variables' | 'enableUnpublishedMode' | 'variants'>;
 type DataSourceLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
     /**
@@ -1579,6 +1654,7 @@ type DataSourceLocationMetadata<TIntegrationConfiguration = unknown> = CommonMet
 type DataSourceLocation = MeshLocationCore<DataSourceLocationValue, DataSourceLocationMetadata, DataSourceLocationValue, 'dataSource'>;
 
 type ParamTypeLocationMetadata<TParamConfiguration = unknown, TIntegrationConfiguration = unknown> = CommonMetadata<{
+    /** editorState is an experimental replacement for rootNode. This may become deprecated in the future. */
     rootNode: Omit<RootComponentInstance, 'slots' | '_data'> & {
         _editionId?: string;
     };
@@ -1607,6 +1683,11 @@ type ParamTypeLocationMetadata<TParamConfiguration = unknown, TIntegrationConfig
      * Note that setValue() always sets the target language automatically.
      */
     targetLocale: string | undefined;
+    /**
+     * The current locale selected in the editor UI.
+     * Unlike targetLocale, this reflects the editor's global locale state.
+     */
+    currentLocale: string | undefined;
     /**
      * When editing a conditional value, this is the index in the parent parameter of the conditional value.
      * If this is -1, then the editor is not editing a conditional value.
@@ -1619,6 +1700,12 @@ type ParamTypeLocation<TParamValue = unknown, TParamConfiguration = unknown, TPa
      * Returns the result of the dialog. Useful to build data-enabled parameter types.
      */
     editConnectedData: Awaited<ReturnType<typeof connectToParent>>['parent']['editConnectedData'];
+    /**
+     * Imperative API for interacting with the composition/entry editor state.
+     * Provides non-reactive access to read and modify the editor state.
+     * @deprecated This is experimental functionality and is subject to change without notice.
+     */
+    editorState: EditorStateApi;
 };
 
 type SettingsLocationMetadata = CommonMetadata;
@@ -1628,7 +1715,7 @@ type SettingsLocation<TSettingsType> = MeshLocationCore<TSettingsType, SettingsL
  * Defines methods used for interacting with a Mesh location
  * To receive useful typings, check the `type` property of the location to narrow the typing.
  */
-type MeshLocation<TValue = unknown, TSetValue = TValue> = ParamTypeLocation<TValue, unknown, TSetValue> | ParamTypeConfigLocation<TValue> | SettingsLocation<TValue> | AssetLibraryLocation | AssetParameterLocation | DataSourceLocation | DataTypeLocation | DataResourceLocation | CanvasEditorToolsLocation | EmbeddedEditorLocation | AIGenerateLocation<TValue> | AIPromptMetadataLocation | PersonalizationCriteriaLocation<TValue> | DashboardToolLocation<TValue> | ProjectToolLocation<TValue>;
+type MeshLocation<TValue = unknown, TSetValue = TValue> = ParamTypeLocation<TValue, unknown, TSetValue> | ParamTypeConfigLocation<TValue> | SettingsLocation<TValue> | AssetLibraryLocation | AssetParameterLocation | DataSourceLocation | DataTypeLocation | DataResourceLocation | DataResourceSelectorLocation | CanvasEditorToolsLocation | EmbeddedEditorLocation | AIGenerateLocation<TValue> | AIPromptMetadataLocation | PersonalizationCriteriaLocation<TValue> | DashboardToolLocation<TValue> | ProjectToolLocation<TValue>;
 interface MeshContextData {
     locationKey: string;
     locationType: MeshLocationTypes;
@@ -1820,6 +1907,7 @@ declare function connectToParent({ dialogResponseHandlers, onMetadataUpdated, on
         navigate: (message: NavigateMessage) => Promise<void>;
         reloadLocation: () => Promise<void>;
         editConnectedData: (message: EditConnectedDataMessage) => Promise<EditConnectedDataResponse>;
+        editorState: EditorStateApi;
     };
 }>;
 
@@ -1986,7 +2074,7 @@ type MeshLocationUserPermissions =
 /**
  * Known location types that can be passed to a mesh location
  */
-type MeshLocationTypes = 'paramType' | 'paramTypeConfig' | 'assetLibrary' | 'assetParameter' | 'settings' | 'dataSource' | 'dataType' | 'dataResource' | 'aiGenerate' | 'embeddedEditor' | 'canvasEditorTools' | 'aiMetadata' | 'personalizationCriteria' | 'dashboardTool' | 'projectTool';
+type MeshLocationTypes = 'paramType' | 'paramTypeConfig' | 'assetLibrary' | 'assetParameter' | 'settings' | 'dataSource' | 'dataType' | 'dataResource' | 'dataResourceSelector' | 'aiGenerate' | 'embeddedEditor' | 'canvasEditorTools' | 'aiMetadata' | 'personalizationCriteria' | 'dashboardTool' | 'projectTool';
 type SetValueOptions = ValidationResult;
 type SetValueMessage = {
     uniformMeshLocationValue: unknown;
@@ -2011,6 +2099,183 @@ type DynamicInput = {
 };
 /** Record of dynamic inputs keyed by the input name */
 type DynamicInputs = Record<string, DynamicInput>;
+/** Metadata about the composition (description, category, workflow, etc.) */
+type EditorRootMetadata = {
+    description?: string;
+    previewImageUrl?: string;
+    categoryId?: string;
+    workflowId?: string;
+    workflowStageId?: string;
+    editionName?: string;
+    editionPriority?: number;
+};
+/** Root node metadata (name and slug) */
+type EditorRootNodeMetadata = {
+    _name: string;
+    _slug: string | null | undefined;
+};
+/** Options for exporting the tree */
+type EditorExportOptions = {
+    /** If true, includes pattern descendant data in export */
+    keepPatternData?: boolean;
+};
+/** A component instance without slots/params (indexed separately) */
+type EditorComponentInstance = Omit<ComponentInstance, 'slots' | 'parameters' | '_id'>;
+/** An indexed node within the editor state */
+type EditorNode = {
+    nodeId: string;
+    parentId?: string;
+    isBlock?: boolean;
+    value: EditorComponentInstance;
+    /** If part of a pattern, the pattern ID */
+    partOfPattern?: string;
+    /** If part of a nested pattern */
+    partOfNestedPattern?: string;
+    /** UI expansion state */
+    isExpandedInUI?: boolean;
+};
+/** Child node IDs indexed by slot name */
+type EditorNodeChildren = {
+    [slotName: string]: string[];
+};
+/** A component parameter value */
+type EditorComponentParameter<T = unknown> = Omit<ComponentParameter<T>, 'connectedData'>;
+/** Parent info for a node */
+type EditorNodeParentInfo = {
+    parentId: string;
+    parentName: string;
+    targetIndexInParent: number;
+    value: EditorComponentInstance;
+    parentChildIds: string[];
+    parentType: 'slot' | 'block';
+};
+/** Options for updateNodeProperty */
+type UpdateNodePropertyOptions = {
+    nodeId: string;
+    property: string;
+    /**
+     * The new value to set. Pass the final value directly.
+     * - `undefined` to soft-delete (remove current locale/condition value)
+     * - `null` to hard-delete (remove entire parameter)
+     * - any other value to set
+     *
+     * For read-modify-write, call getNodeProperty() first to get current value.
+     */
+    value: unknown | undefined | null;
+    /** Parameter type (required for new parameters) */
+    type?: string;
+    /** Target locale, or undefined for invariant value */
+    locale: string | undefined;
+    /** Condition index (-1 for base value, >= 0 for conditional) */
+    conditionIndex: number;
+    /** Condition definition (required when conditionIndex >= 0) */
+    conditionDefinition?: VisibilityCriteriaGroup | null;
+};
+/** Options for insertNode */
+type InsertNodeOptions = {
+    node: EditorComponentInstance;
+    parentNodeId: string;
+    parentSlot: string;
+    targetIndexInSlot?: number;
+};
+/** Options for moveNode */
+type MoveNodeOptions = {
+    movedNodeId: string;
+    parentNodeId: string;
+    parentSlot: string;
+    targetIndexInSlot: number;
+};
+/** Options for insertPattern */
+type InsertPatternOptions = {
+    pattern: RootComponentInstance;
+    parentNodeId: string;
+    parentSlot: string;
+    targetIndexInSlot?: number;
+    patternInstanceId?: string;
+};
+/** Options for updateRootNode */
+type UpdateRootNodeOptions = {
+    update: Partial<EditorRootNodeMetadata>;
+};
+/**
+ * Imperative API for interacting with the composition/entry editor state.
+ * Available on `canvasEditorTools` and `paramType` locations.
+ *
+ * All methods use object parameters for consistency across client, wire format, and server.
+ */
+interface EditorStateApi {
+    getRootNodeId(): Promise<string>;
+    exportTree(params?: EditorExportOptions): Promise<RootComponentInstance>;
+    exportSubtree(params: {
+        nodeId: string;
+        options?: EditorExportOptions;
+    }): Promise<ComponentInstance>;
+    exportMetadata(): Promise<EditorRootMetadata>;
+    exportRootNodeMetadata(): Promise<EditorRootNodeMetadata>;
+    getNodeById(params: {
+        nodeId: string;
+    }): Promise<EditorNode | undefined>;
+    getNodeChildren(params: {
+        nodeId: string;
+    }): Promise<EditorNodeChildren | undefined>;
+    getNodeProperty<T = unknown>(params: {
+        nodeId: string;
+        property: string;
+    }): Promise<EditorComponentParameter<T> | undefined>;
+    getNodeProperties(params: {
+        nodeId: string;
+    }): Promise<Record<string, EditorComponentParameter>>;
+    getParentInfo(params: {
+        nodeId: string;
+    }): Promise<EditorNodeParentInfo | undefined>;
+    getSelectedNodeId(): Promise<string | undefined>;
+    setSelectedNodeId(params: {
+        nodeId: string | undefined;
+    }): Promise<void>;
+    getSelectedParameterId(): Promise<string | undefined>;
+    setSelectedParameterId(params: {
+        parameterId: string | undefined;
+    }): Promise<void>;
+    getPristine(): Promise<boolean>;
+    insertNode(params: InsertNodeOptions): Promise<string>;
+    deleteNode(params: {
+        nodeId: string;
+    }): Promise<void>;
+    moveNode(params: MoveNodeOptions): Promise<void>;
+    updateNodeProperty(params: UpdateNodePropertyOptions): Promise<void>;
+    updateRootMetadata(params: {
+        metadata: Partial<EditorRootMetadata>;
+    }): Promise<void>;
+    updateRootNode(params: UpdateRootNodeOptions): Promise<void>;
+    insertPattern(params: InsertPatternOptions): Promise<string>;
+    isPatternPropertyOverridden(params: {
+        nodeId: string;
+        property: string;
+        locale?: string;
+    }): Promise<boolean>;
+    resetPatternPropertyOverride(params: {
+        nodeId: string;
+        property: string;
+        locale: string | undefined;
+    }): Promise<void>;
+    enableLocale(params: {
+        locale: string | string[];
+    }): Promise<void>;
+    disableLocale(params: {
+        locale: string;
+    }): Promise<void>;
+    /** Sets the currently active locale in the editor UI */
+    setCurrentLocale(params: {
+        locale: string;
+    }): Promise<void>;
+    /**
+     * Sets the current preview value for a dynamic input.
+     */
+    setDynamicInputPreviewValue(params: {
+        name: string;
+        value: string;
+    }): Promise<void>;
+}
 
 type AIGenerateLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
     prompt: string;
@@ -2037,6 +2302,13 @@ type CanvasEditorToolsLocationMetadata<TIntegrationConfiguration = unknown> = Co
      */
     activeReleaseId?: string;
     state?: number;
+    /** The current locale selected in the editor UI */
+    currentLocale: string | undefined;
+    /**
+     * Current dynamic inputs configured on the composition (if any).
+     * Dynamic inputs come from project map nodes and represent path or query based dynamic values.
+     */
+    dynamicInputs: DynamicInputs;
 }, TIntegrationConfiguration>;
 type CanvasEditorToolsReferenceData = {
     name: string;
@@ -2047,13 +2319,22 @@ type CanvasEditorToolsData = {
     entryNamesIndex?: Record<string, CanvasEditorToolsReferenceData>;
     entityType: CanvasEditorEntityType;
 } & ({
+    /** editorState is an experimental replacement for rootEntity. This may become deprecated in the future. */
     rootEntity: RootComponentInstance;
     entityType: 'composition' | 'componentPattern' | 'compositionDefaults';
 } | {
+    /** editorState is an experimental replacement for rootEntity. This may become deprecated in the future. */
     rootEntity: EntryData;
     entityType: 'entry' | 'entryPattern';
 });
-type CanvasEditorToolsLocation = MeshLocationCore<CanvasEditorToolsData, CanvasEditorToolsLocationMetadata, CanvasEditorToolsData, 'canvasEditorTools'> & GetDataResourceLocation;
+type CanvasEditorToolsLocation = MeshLocationCore<CanvasEditorToolsData, CanvasEditorToolsLocationMetadata, CanvasEditorToolsData, 'canvasEditorTools'> & GetDataResourceLocation & {
+    /**
+     * Imperative API for interacting with the composition/entry editor state.
+     * Provides non-reactive access to read and modify the editor state.
+     * @deprecated This is experimental functionality and is subject to change without notice.
+     */
+    editorState: EditorStateApi;
+};
 
 /**
  * @deprecated Alpha version of the Embedded Editor location. This location is not yet available for use in the Mesh SDK.
@@ -2221,4 +2502,4 @@ declare const hasPermissions: (permissions: MeshLocationUserPermissions | MeshLo
  */
 declare const hasRole: (role: string, user: UniformUser) => boolean;
 
-export { type AIGenerateLocation, type AIGenerateLocationMetadata, type AIPromptMetadataLocation, type AssetLibraryLocation, type AssetLibraryLocationMetadata, type AssetParameterLocation, type AssetParameterLocationMetadata, type BindableTypes, type CSSHeight, type CanvasEditorEntityType, type CanvasEditorToolsData, type CanvasEditorToolsLocation, type CanvasEditorToolsLocationMetadata, type CloseDialogMessage, type CloseLocationDialogOptions, type CommonMetadata, type DashboardToolLocation, type DashboardToolLocationMetadata, type DataConnectorInfo, type DataResourceLocation, type DataResourceLocationMetadata, type DataSourceLocation, type DataSourceLocationMetadata, type DataSourceLocationValue, type DataTypeLocation, type DataTypeLocationMetadata, type DataTypeLocationValue, type DialogContext, type DialogOptions, type DialogParamValue, type DialogParams, type DialogResponseData, type DialogResponseHandler, type DialogResponseHandlers, type DialogType, type DynamicInput, type DynamicInputs, type EditConnectedDataMessage, type EditConnectedDataResponse, type EditConnectedDataResponseCancellationContext, type EmbeddedEditorLocation, type EmbeddedEditorLocationMetadata, type EmbeddedEditorLocationSetValue, type EmbeddedEditorLocationValue, type FunctionCallResponse, type FunctionCallSystemParameter, type GetDataResourceLocation, type GetDataResourceMessage, IntegrationDefinitionClient, type IntegrationDefinitionDeleteParameters, type IntegrationDefinitionGetParameters, type IntegrationDefinitionGetResponse, type IntegrationDefinitionPutParameters, type IntegrationDefinitionPutResponse, IntegrationInstallationClient, type IntegrationInstallationDeleteParameters, type IntegrationInstallationGetParameters, type IntegrationInstallationGetResponse, type IntegrationInstallationPutParameters, type LocationDialogResponse, type MeshContextData, type MeshLocation, type MeshLocationCore, type MeshLocationTypes, type MeshLocationUserPermissions, type MeshRouter, type MeshSDKEventInterface, type NavigateMessage, type OpenConfirmationDialogOptions, type OpenConfirmationDialogResult, type OpenDialogMessage, type OpenDialogResult, type OpenLocationDialogOptions, type ParamTypeConfigLocation, type ParamTypeConfigLocationMetadata, type ParamTypeLocation, type ParamTypeLocationMetadata, type PersonalizationCriteriaLocation, type PersonalizationCriteriaLocationMetadata, type ProjectToolLocation, type ProjectToolLocationMetadata, type PromptSettingsLocationMetadata, type SdkWindow, type SetLocationFunction, type SetValueMessage, type SetValueOptions, type SettingsLocation, type SettingsLocationMetadata, type UniformMeshSDK, type UniformMeshSDKEvents, type UniformUser, type ValidationResult, functionCallSystemParameters, hasPermissions, hasRole, initializeUniformMeshSDK, parseFunctionCall };
+export { type AIGenerateLocation, type AIGenerateLocationMetadata, type AIPromptMetadataLocation, type AssetLibraryLocation, type AssetLibraryLocationMetadata, type AssetParameterLocation, type AssetParameterLocationMetadata, type BindableTypes, type CSSHeight, type CanvasEditorEntityType, type CanvasEditorToolsData, type CanvasEditorToolsLocation, type CanvasEditorToolsLocationMetadata, type CloseDialogMessage, type CloseLocationDialogOptions, type CommonMetadata, type DashboardToolLocation, type DashboardToolLocationMetadata, type DataConnectorInfo, type DataResourceLocation, type DataResourceLocationMetadata, type DataResourceSelectorLocation, type DataResourceSelectorLocationMetadata, type DataSourceLocation, type DataSourceLocationMetadata, type DataSourceLocationValue, type DataTypeLocation, type DataTypeLocationMetadata, type DataTypeLocationValue, type DialogContext, type DialogOptions, type DialogParamValue, type DialogParams, type DialogResponseData, type DialogResponseHandler, type DialogResponseHandlers, type DialogType, type DynamicInput, type DynamicInputs, type EditConnectedDataMessage, type EditConnectedDataResponse, type EditConnectedDataResponseCancellationContext, type EditorComponentInstance, type EditorComponentParameter, type EditorExportOptions, type EditorNode, type EditorNodeChildren, type EditorNodeParentInfo, type EditorRootMetadata, type EditorRootNodeMetadata, type EditorStateApi, type EmbeddedEditorLocation, type EmbeddedEditorLocationMetadata, type EmbeddedEditorLocationSetValue, type EmbeddedEditorLocationValue, type FunctionCallResponse, type FunctionCallSystemParameter, type GetDataResourceLocation, type GetDataResourceMessage, type InsertNodeOptions, type InsertPatternOptions, IntegrationDefinitionClient, type IntegrationDefinitionDeleteParameters, type IntegrationDefinitionGetParameters, type IntegrationDefinitionGetResponse, type IntegrationDefinitionPutParameters, type IntegrationDefinitionPutResponse, IntegrationInstallationClient, type IntegrationInstallationDeleteParameters, type IntegrationInstallationGetParameters, type IntegrationInstallationGetResponse, type IntegrationInstallationPutParameters, type LocationDialogResponse, type MeshContextData, type MeshLocation, type MeshLocationCore, type MeshLocationTypes, type MeshLocationUserPermissions, type MeshRouter, type MeshSDKEventInterface, type MoveNodeOptions, type NavigateMessage, type OpenConfirmationDialogOptions, type OpenConfirmationDialogResult, type OpenDialogMessage, type OpenDialogResult, type OpenLocationDialogOptions, type ParamTypeConfigLocation, type ParamTypeConfigLocationMetadata, type ParamTypeLocation, type ParamTypeLocationMetadata, type PersonalizationCriteriaLocation, type PersonalizationCriteriaLocationMetadata, type ProjectToolLocation, type ProjectToolLocationMetadata, type PromptSettingsLocationMetadata, type SdkWindow, type SetLocationFunction, type SetValueMessage, type SetValueOptions, type SettingsLocation, type SettingsLocationMetadata, type UniformMeshSDK, type UniformMeshSDKEvents, type UniformUser, type UpdateNodePropertyOptions, type UpdateRootNodeOptions, type ValidationResult, functionCallSystemParameters, hasPermissions, hasRole, initializeUniformMeshSDK, parseFunctionCall };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ApiClient, ClientOptions, ExceptProject } from '@uniformdev/context/api';
-import { AssetParamValue, DataType, DataSource, DataSourceVariantsKeys, DataResourceVariables, RootComponentInstance, ComponentInstance, ComponentDefinition, ComponentDefinitionParameter, DataVariableDefinition, Locale, EntryData } from '@uniformdev/canvas';
+import { AssetParamValue, DataType, DataSource, DataSourceVariantsKeys, DataResourceVariables, RootComponentInstance, ComponentInstance, ComponentDefinition, ComponentDefinitionParameter, DataVariableDefinition, Locale, ComponentParameter, VisibilityCriteriaGroup, EntryData } from '@uniformdev/canvas';
 export { AssetParamValue, AssetParamValueItem } from '@uniformdev/canvas';
 import { ProjectMapNode } from '@uniformdev/project-map';
 import { AssetDefinitionType } from '@uniformdev/assets';
@@ -174,6 +174,18 @@ interface paths$1 {
                                                     };
                                                 };
                                                 embeddedEditor?: string;
+                                                dataResourceSelectorUrl?: string;
+                                                dataResourceSelectorLocations?: {
+                                                    [key: string]: {
+                                                        url: string;
+                                                        layout?: {
+                                                            /** @enum {string} */
+                                                            height?: "full-height";
+                                                            /** @enum {string} */
+                                                            width?: "wide";
+                                                        };
+                                                    };
+                                                };
                                             };
                                         };
                                         badgeIconUrl?: string;
@@ -452,6 +464,18 @@ interface paths$1 {
                                                 };
                                             };
                                             embeddedEditor?: string;
+                                            dataResourceSelectorUrl?: string;
+                                            dataResourceSelectorLocations?: {
+                                                [key: string]: {
+                                                    url: string;
+                                                    layout?: {
+                                                        /** @enum {string} */
+                                                        height?: "full-height";
+                                                        /** @enum {string} */
+                                                        width?: "wide";
+                                                    };
+                                                };
+                                            };
                                         };
                                     };
                                     badgeIconUrl?: string;
@@ -715,6 +739,18 @@ interface paths$1 {
                                                 };
                                             };
                                             embeddedEditor?: string;
+                                            dataResourceSelectorUrl?: string;
+                                            dataResourceSelectorLocations?: {
+                                                [key: string]: {
+                                                    url: string;
+                                                    layout?: {
+                                                        /** @enum {string} */
+                                                        height?: "full-height";
+                                                        /** @enum {string} */
+                                                        width?: "wide";
+                                                    };
+                                                };
+                                            };
                                         };
                                     };
                                     badgeIconUrl?: string;
@@ -1328,6 +1364,16 @@ declare class IntegrationDefinitionClient extends ApiClient<DefClientOptions> {
                             };
                         };
                         embeddedEditor?: string;
+                        dataResourceSelectorUrl?: string;
+                        dataResourceSelectorLocations?: {
+                            [key: string]: {
+                                url: string;
+                                layout?: {
+                                    height?: "full-height";
+                                    width?: "wide";
+                                };
+                            };
+                        };
                     };
                 };
                 badgeIconUrl?: string;
@@ -1568,6 +1614,35 @@ type DataResourceLocationMetadata<TIntegrationConfiguration = unknown> = CommonM
 }, TIntegrationConfiguration>;
 type DataResourceLocation = MeshLocationCore<DataResourceVariables, DataResourceLocationMetadata, DataResourceVariables, 'dataResource'> & GetDataResourceLocation;
 
+/**
+ * Metadata for the dataResourceSelector location.
+ * This location type allows custom UI for selecting JSON pointers within a data resource,
+ * replacing the default JSON tree viewer in the dynamic token picker.
+ * @deprecated This is experimental functionality and is subject to change without notice.
+ */
+type DataResourceSelectorLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
+    /** The resolved data for the currently selected data resource */
+    dataResourceValue: unknown;
+    /** The name of the currently selected data resource */
+    dataResourceName: string;
+    /** The data type ID for the current data resource */
+    dataTypeId: string;
+    /** The data type's archetype value (useful for apps sharing a selector across archetypes) */
+    archetype: string;
+    /** Allowed bindable types for the parameter being connected */
+    allowedTypes: BindableTypes[];
+}, TIntegrationConfiguration>;
+/**
+ * Location for custom data resource selector UI.
+ * Replaces the default JSON tree viewer when selecting dynamic tokens from a data resource.
+ *
+ * Value: The selected JSON pointer string (e.g., "/moves/0/move/name")
+ * setValue: Call with a valid JSON pointer to select that path
+ * getDataResource: Fetch data from the data connector using the current data source
+ * @deprecated This is experimental functionality and is subject to change without notice.
+ */
+type DataResourceSelectorLocation = MeshLocationCore<string, DataResourceSelectorLocationMetadata, string, 'dataResourceSelector'> & GetDataResourceLocation;
+
 type DataSourceLocationValue = Pick<DataSource, 'baseUrl' | 'custom' | 'customPublic' | 'headers' | 'parameters' | 'variables' | 'enableUnpublishedMode' | 'variants'>;
 type DataSourceLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
     /**
@@ -1579,6 +1654,7 @@ type DataSourceLocationMetadata<TIntegrationConfiguration = unknown> = CommonMet
 type DataSourceLocation = MeshLocationCore<DataSourceLocationValue, DataSourceLocationMetadata, DataSourceLocationValue, 'dataSource'>;
 
 type ParamTypeLocationMetadata<TParamConfiguration = unknown, TIntegrationConfiguration = unknown> = CommonMetadata<{
+    /** editorState is an experimental replacement for rootNode. This may become deprecated in the future. */
     rootNode: Omit<RootComponentInstance, 'slots' | '_data'> & {
         _editionId?: string;
     };
@@ -1607,6 +1683,11 @@ type ParamTypeLocationMetadata<TParamConfiguration = unknown, TIntegrationConfig
      * Note that setValue() always sets the target language automatically.
      */
     targetLocale: string | undefined;
+    /**
+     * The current locale selected in the editor UI.
+     * Unlike targetLocale, this reflects the editor's global locale state.
+     */
+    currentLocale: string | undefined;
     /**
      * When editing a conditional value, this is the index in the parent parameter of the conditional value.
      * If this is -1, then the editor is not editing a conditional value.
@@ -1619,6 +1700,12 @@ type ParamTypeLocation<TParamValue = unknown, TParamConfiguration = unknown, TPa
      * Returns the result of the dialog. Useful to build data-enabled parameter types.
      */
     editConnectedData: Awaited<ReturnType<typeof connectToParent>>['parent']['editConnectedData'];
+    /**
+     * Imperative API for interacting with the composition/entry editor state.
+     * Provides non-reactive access to read and modify the editor state.
+     * @deprecated This is experimental functionality and is subject to change without notice.
+     */
+    editorState: EditorStateApi;
 };
 
 type SettingsLocationMetadata = CommonMetadata;
@@ -1628,7 +1715,7 @@ type SettingsLocation<TSettingsType> = MeshLocationCore<TSettingsType, SettingsL
  * Defines methods used for interacting with a Mesh location
  * To receive useful typings, check the `type` property of the location to narrow the typing.
  */
-type MeshLocation<TValue = unknown, TSetValue = TValue> = ParamTypeLocation<TValue, unknown, TSetValue> | ParamTypeConfigLocation<TValue> | SettingsLocation<TValue> | AssetLibraryLocation | AssetParameterLocation | DataSourceLocation | DataTypeLocation | DataResourceLocation | CanvasEditorToolsLocation | EmbeddedEditorLocation | AIGenerateLocation<TValue> | AIPromptMetadataLocation | PersonalizationCriteriaLocation<TValue> | DashboardToolLocation<TValue> | ProjectToolLocation<TValue>;
+type MeshLocation<TValue = unknown, TSetValue = TValue> = ParamTypeLocation<TValue, unknown, TSetValue> | ParamTypeConfigLocation<TValue> | SettingsLocation<TValue> | AssetLibraryLocation | AssetParameterLocation | DataSourceLocation | DataTypeLocation | DataResourceLocation | DataResourceSelectorLocation | CanvasEditorToolsLocation | EmbeddedEditorLocation | AIGenerateLocation<TValue> | AIPromptMetadataLocation | PersonalizationCriteriaLocation<TValue> | DashboardToolLocation<TValue> | ProjectToolLocation<TValue>;
 interface MeshContextData {
     locationKey: string;
     locationType: MeshLocationTypes;
@@ -1820,6 +1907,7 @@ declare function connectToParent({ dialogResponseHandlers, onMetadataUpdated, on
         navigate: (message: NavigateMessage) => Promise<void>;
         reloadLocation: () => Promise<void>;
         editConnectedData: (message: EditConnectedDataMessage) => Promise<EditConnectedDataResponse>;
+        editorState: EditorStateApi;
     };
 }>;
 
@@ -1986,7 +2074,7 @@ type MeshLocationUserPermissions =
 /**
  * Known location types that can be passed to a mesh location
  */
-type MeshLocationTypes = 'paramType' | 'paramTypeConfig' | 'assetLibrary' | 'assetParameter' | 'settings' | 'dataSource' | 'dataType' | 'dataResource' | 'aiGenerate' | 'embeddedEditor' | 'canvasEditorTools' | 'aiMetadata' | 'personalizationCriteria' | 'dashboardTool' | 'projectTool';
+type MeshLocationTypes = 'paramType' | 'paramTypeConfig' | 'assetLibrary' | 'assetParameter' | 'settings' | 'dataSource' | 'dataType' | 'dataResource' | 'dataResourceSelector' | 'aiGenerate' | 'embeddedEditor' | 'canvasEditorTools' | 'aiMetadata' | 'personalizationCriteria' | 'dashboardTool' | 'projectTool';
 type SetValueOptions = ValidationResult;
 type SetValueMessage = {
     uniformMeshLocationValue: unknown;
@@ -2011,6 +2099,183 @@ type DynamicInput = {
 };
 /** Record of dynamic inputs keyed by the input name */
 type DynamicInputs = Record<string, DynamicInput>;
+/** Metadata about the composition (description, category, workflow, etc.) */
+type EditorRootMetadata = {
+    description?: string;
+    previewImageUrl?: string;
+    categoryId?: string;
+    workflowId?: string;
+    workflowStageId?: string;
+    editionName?: string;
+    editionPriority?: number;
+};
+/** Root node metadata (name and slug) */
+type EditorRootNodeMetadata = {
+    _name: string;
+    _slug: string | null | undefined;
+};
+/** Options for exporting the tree */
+type EditorExportOptions = {
+    /** If true, includes pattern descendant data in export */
+    keepPatternData?: boolean;
+};
+/** A component instance without slots/params (indexed separately) */
+type EditorComponentInstance = Omit<ComponentInstance, 'slots' | 'parameters' | '_id'>;
+/** An indexed node within the editor state */
+type EditorNode = {
+    nodeId: string;
+    parentId?: string;
+    isBlock?: boolean;
+    value: EditorComponentInstance;
+    /** If part of a pattern, the pattern ID */
+    partOfPattern?: string;
+    /** If part of a nested pattern */
+    partOfNestedPattern?: string;
+    /** UI expansion state */
+    isExpandedInUI?: boolean;
+};
+/** Child node IDs indexed by slot name */
+type EditorNodeChildren = {
+    [slotName: string]: string[];
+};
+/** A component parameter value */
+type EditorComponentParameter<T = unknown> = Omit<ComponentParameter<T>, 'connectedData'>;
+/** Parent info for a node */
+type EditorNodeParentInfo = {
+    parentId: string;
+    parentName: string;
+    targetIndexInParent: number;
+    value: EditorComponentInstance;
+    parentChildIds: string[];
+    parentType: 'slot' | 'block';
+};
+/** Options for updateNodeProperty */
+type UpdateNodePropertyOptions = {
+    nodeId: string;
+    property: string;
+    /**
+     * The new value to set. Pass the final value directly.
+     * - `undefined` to soft-delete (remove current locale/condition value)
+     * - `null` to hard-delete (remove entire parameter)
+     * - any other value to set
+     *
+     * For read-modify-write, call getNodeProperty() first to get current value.
+     */
+    value: unknown | undefined | null;
+    /** Parameter type (required for new parameters) */
+    type?: string;
+    /** Target locale, or undefined for invariant value */
+    locale: string | undefined;
+    /** Condition index (-1 for base value, >= 0 for conditional) */
+    conditionIndex: number;
+    /** Condition definition (required when conditionIndex >= 0) */
+    conditionDefinition?: VisibilityCriteriaGroup | null;
+};
+/** Options for insertNode */
+type InsertNodeOptions = {
+    node: EditorComponentInstance;
+    parentNodeId: string;
+    parentSlot: string;
+    targetIndexInSlot?: number;
+};
+/** Options for moveNode */
+type MoveNodeOptions = {
+    movedNodeId: string;
+    parentNodeId: string;
+    parentSlot: string;
+    targetIndexInSlot: number;
+};
+/** Options for insertPattern */
+type InsertPatternOptions = {
+    pattern: RootComponentInstance;
+    parentNodeId: string;
+    parentSlot: string;
+    targetIndexInSlot?: number;
+    patternInstanceId?: string;
+};
+/** Options for updateRootNode */
+type UpdateRootNodeOptions = {
+    update: Partial<EditorRootNodeMetadata>;
+};
+/**
+ * Imperative API for interacting with the composition/entry editor state.
+ * Available on `canvasEditorTools` and `paramType` locations.
+ *
+ * All methods use object parameters for consistency across client, wire format, and server.
+ */
+interface EditorStateApi {
+    getRootNodeId(): Promise<string>;
+    exportTree(params?: EditorExportOptions): Promise<RootComponentInstance>;
+    exportSubtree(params: {
+        nodeId: string;
+        options?: EditorExportOptions;
+    }): Promise<ComponentInstance>;
+    exportMetadata(): Promise<EditorRootMetadata>;
+    exportRootNodeMetadata(): Promise<EditorRootNodeMetadata>;
+    getNodeById(params: {
+        nodeId: string;
+    }): Promise<EditorNode | undefined>;
+    getNodeChildren(params: {
+        nodeId: string;
+    }): Promise<EditorNodeChildren | undefined>;
+    getNodeProperty<T = unknown>(params: {
+        nodeId: string;
+        property: string;
+    }): Promise<EditorComponentParameter<T> | undefined>;
+    getNodeProperties(params: {
+        nodeId: string;
+    }): Promise<Record<string, EditorComponentParameter>>;
+    getParentInfo(params: {
+        nodeId: string;
+    }): Promise<EditorNodeParentInfo | undefined>;
+    getSelectedNodeId(): Promise<string | undefined>;
+    setSelectedNodeId(params: {
+        nodeId: string | undefined;
+    }): Promise<void>;
+    getSelectedParameterId(): Promise<string | undefined>;
+    setSelectedParameterId(params: {
+        parameterId: string | undefined;
+    }): Promise<void>;
+    getPristine(): Promise<boolean>;
+    insertNode(params: InsertNodeOptions): Promise<string>;
+    deleteNode(params: {
+        nodeId: string;
+    }): Promise<void>;
+    moveNode(params: MoveNodeOptions): Promise<void>;
+    updateNodeProperty(params: UpdateNodePropertyOptions): Promise<void>;
+    updateRootMetadata(params: {
+        metadata: Partial<EditorRootMetadata>;
+    }): Promise<void>;
+    updateRootNode(params: UpdateRootNodeOptions): Promise<void>;
+    insertPattern(params: InsertPatternOptions): Promise<string>;
+    isPatternPropertyOverridden(params: {
+        nodeId: string;
+        property: string;
+        locale?: string;
+    }): Promise<boolean>;
+    resetPatternPropertyOverride(params: {
+        nodeId: string;
+        property: string;
+        locale: string | undefined;
+    }): Promise<void>;
+    enableLocale(params: {
+        locale: string | string[];
+    }): Promise<void>;
+    disableLocale(params: {
+        locale: string;
+    }): Promise<void>;
+    /** Sets the currently active locale in the editor UI */
+    setCurrentLocale(params: {
+        locale: string;
+    }): Promise<void>;
+    /**
+     * Sets the current preview value for a dynamic input.
+     */
+    setDynamicInputPreviewValue(params: {
+        name: string;
+        value: string;
+    }): Promise<void>;
+}
 
 type AIGenerateLocationMetadata<TIntegrationConfiguration = unknown> = CommonMetadata<{
     prompt: string;
@@ -2037,6 +2302,13 @@ type CanvasEditorToolsLocationMetadata<TIntegrationConfiguration = unknown> = Co
      */
     activeReleaseId?: string;
     state?: number;
+    /** The current locale selected in the editor UI */
+    currentLocale: string | undefined;
+    /**
+     * Current dynamic inputs configured on the composition (if any).
+     * Dynamic inputs come from project map nodes and represent path or query based dynamic values.
+     */
+    dynamicInputs: DynamicInputs;
 }, TIntegrationConfiguration>;
 type CanvasEditorToolsReferenceData = {
     name: string;
@@ -2047,13 +2319,22 @@ type CanvasEditorToolsData = {
     entryNamesIndex?: Record<string, CanvasEditorToolsReferenceData>;
     entityType: CanvasEditorEntityType;
 } & ({
+    /** editorState is an experimental replacement for rootEntity. This may become deprecated in the future. */
     rootEntity: RootComponentInstance;
     entityType: 'composition' | 'componentPattern' | 'compositionDefaults';
 } | {
+    /** editorState is an experimental replacement for rootEntity. This may become deprecated in the future. */
     rootEntity: EntryData;
     entityType: 'entry' | 'entryPattern';
 });
-type CanvasEditorToolsLocation = MeshLocationCore<CanvasEditorToolsData, CanvasEditorToolsLocationMetadata, CanvasEditorToolsData, 'canvasEditorTools'> & GetDataResourceLocation;
+type CanvasEditorToolsLocation = MeshLocationCore<CanvasEditorToolsData, CanvasEditorToolsLocationMetadata, CanvasEditorToolsData, 'canvasEditorTools'> & GetDataResourceLocation & {
+    /**
+     * Imperative API for interacting with the composition/entry editor state.
+     * Provides non-reactive access to read and modify the editor state.
+     * @deprecated This is experimental functionality and is subject to change without notice.
+     */
+    editorState: EditorStateApi;
+};
 
 /**
  * @deprecated Alpha version of the Embedded Editor location. This location is not yet available for use in the Mesh SDK.
@@ -2221,4 +2502,4 @@ declare const hasPermissions: (permissions: MeshLocationUserPermissions | MeshLo
  */
 declare const hasRole: (role: string, user: UniformUser) => boolean;
 
-export { type AIGenerateLocation, type AIGenerateLocationMetadata, type AIPromptMetadataLocation, type AssetLibraryLocation, type AssetLibraryLocationMetadata, type AssetParameterLocation, type AssetParameterLocationMetadata, type BindableTypes, type CSSHeight, type CanvasEditorEntityType, type CanvasEditorToolsData, type CanvasEditorToolsLocation, type CanvasEditorToolsLocationMetadata, type CloseDialogMessage, type CloseLocationDialogOptions, type CommonMetadata, type DashboardToolLocation, type DashboardToolLocationMetadata, type DataConnectorInfo, type DataResourceLocation, type DataResourceLocationMetadata, type DataSourceLocation, type DataSourceLocationMetadata, type DataSourceLocationValue, type DataTypeLocation, type DataTypeLocationMetadata, type DataTypeLocationValue, type DialogContext, type DialogOptions, type DialogParamValue, type DialogParams, type DialogResponseData, type DialogResponseHandler, type DialogResponseHandlers, type DialogType, type DynamicInput, type DynamicInputs, type EditConnectedDataMessage, type EditConnectedDataResponse, type EditConnectedDataResponseCancellationContext, type EmbeddedEditorLocation, type EmbeddedEditorLocationMetadata, type EmbeddedEditorLocationSetValue, type EmbeddedEditorLocationValue, type FunctionCallResponse, type FunctionCallSystemParameter, type GetDataResourceLocation, type GetDataResourceMessage, IntegrationDefinitionClient, type IntegrationDefinitionDeleteParameters, type IntegrationDefinitionGetParameters, type IntegrationDefinitionGetResponse, type IntegrationDefinitionPutParameters, type IntegrationDefinitionPutResponse, IntegrationInstallationClient, type IntegrationInstallationDeleteParameters, type IntegrationInstallationGetParameters, type IntegrationInstallationGetResponse, type IntegrationInstallationPutParameters, type LocationDialogResponse, type MeshContextData, type MeshLocation, type MeshLocationCore, type MeshLocationTypes, type MeshLocationUserPermissions, type MeshRouter, type MeshSDKEventInterface, type NavigateMessage, type OpenConfirmationDialogOptions, type OpenConfirmationDialogResult, type OpenDialogMessage, type OpenDialogResult, type OpenLocationDialogOptions, type ParamTypeConfigLocation, type ParamTypeConfigLocationMetadata, type ParamTypeLocation, type ParamTypeLocationMetadata, type PersonalizationCriteriaLocation, type PersonalizationCriteriaLocationMetadata, type ProjectToolLocation, type ProjectToolLocationMetadata, type PromptSettingsLocationMetadata, type SdkWindow, type SetLocationFunction, type SetValueMessage, type SetValueOptions, type SettingsLocation, type SettingsLocationMetadata, type UniformMeshSDK, type UniformMeshSDKEvents, type UniformUser, type ValidationResult, functionCallSystemParameters, hasPermissions, hasRole, initializeUniformMeshSDK, parseFunctionCall };
+export { type AIGenerateLocation, type AIGenerateLocationMetadata, type AIPromptMetadataLocation, type AssetLibraryLocation, type AssetLibraryLocationMetadata, type AssetParameterLocation, type AssetParameterLocationMetadata, type BindableTypes, type CSSHeight, type CanvasEditorEntityType, type CanvasEditorToolsData, type CanvasEditorToolsLocation, type CanvasEditorToolsLocationMetadata, type CloseDialogMessage, type CloseLocationDialogOptions, type CommonMetadata, type DashboardToolLocation, type DashboardToolLocationMetadata, type DataConnectorInfo, type DataResourceLocation, type DataResourceLocationMetadata, type DataResourceSelectorLocation, type DataResourceSelectorLocationMetadata, type DataSourceLocation, type DataSourceLocationMetadata, type DataSourceLocationValue, type DataTypeLocation, type DataTypeLocationMetadata, type DataTypeLocationValue, type DialogContext, type DialogOptions, type DialogParamValue, type DialogParams, type DialogResponseData, type DialogResponseHandler, type DialogResponseHandlers, type DialogType, type DynamicInput, type DynamicInputs, type EditConnectedDataMessage, type EditConnectedDataResponse, type EditConnectedDataResponseCancellationContext, type EditorComponentInstance, type EditorComponentParameter, type EditorExportOptions, type EditorNode, type EditorNodeChildren, type EditorNodeParentInfo, type EditorRootMetadata, type EditorRootNodeMetadata, type EditorStateApi, type EmbeddedEditorLocation, type EmbeddedEditorLocationMetadata, type EmbeddedEditorLocationSetValue, type EmbeddedEditorLocationValue, type FunctionCallResponse, type FunctionCallSystemParameter, type GetDataResourceLocation, type GetDataResourceMessage, type InsertNodeOptions, type InsertPatternOptions, IntegrationDefinitionClient, type IntegrationDefinitionDeleteParameters, type IntegrationDefinitionGetParameters, type IntegrationDefinitionGetResponse, type IntegrationDefinitionPutParameters, type IntegrationDefinitionPutResponse, IntegrationInstallationClient, type IntegrationInstallationDeleteParameters, type IntegrationInstallationGetParameters, type IntegrationInstallationGetResponse, type IntegrationInstallationPutParameters, type LocationDialogResponse, type MeshContextData, type MeshLocation, type MeshLocationCore, type MeshLocationTypes, type MeshLocationUserPermissions, type MeshRouter, type MeshSDKEventInterface, type MoveNodeOptions, type NavigateMessage, type OpenConfirmationDialogOptions, type OpenConfirmationDialogResult, type OpenDialogMessage, type OpenDialogResult, type OpenLocationDialogOptions, type ParamTypeConfigLocation, type ParamTypeConfigLocationMetadata, type ParamTypeLocation, type ParamTypeLocationMetadata, type PersonalizationCriteriaLocation, type PersonalizationCriteriaLocationMetadata, type ProjectToolLocation, type ProjectToolLocationMetadata, type PromptSettingsLocationMetadata, type SdkWindow, type SetLocationFunction, type SetValueMessage, type SetValueOptions, type SettingsLocation, type SettingsLocationMetadata, type UniformMeshSDK, type UniformMeshSDKEvents, type UniformUser, type UpdateNodePropertyOptions, type UpdateRootNodeOptions, type ValidationResult, functionCallSystemParameters, hasPermissions, hasRole, initializeUniformMeshSDK, parseFunctionCall };

package/dist/index.esm.js

@@ -535,7 +535,110 @@ async function connectToParent({
             )
           }
         );
+      },
+      editorState: createEditorStateApi(client)
+    }
+  };
+}
+function createEditorStateApi(client) {
+  let cachedRootNodeId;
+  return {
+    async getRootNodeId() {
+      if (cachedRootNodeId) {
+        return cachedRootNodeId;
       }
+      const result = await client.request("editorState.getRootNodeId");
+      cachedRootNodeId = result;
+      return result;
+    },
+    // Read operations
+    async exportTree(params) {
+      const result = await client.request("editorState.exportTree", params);
+      cachedRootNodeId != null ? cachedRootNodeId : cachedRootNodeId = result == null ? void 0 : result._id;
+      return result;
+    },
+    async exportSubtree(params) {
+      return await client.request("editorState.exportSubtree", params);
+    },
+    async exportMetadata() {
+      return await client.request("editorState.exportMetadata");
+    },
+    async exportRootNodeMetadata() {
+      return await client.request("editorState.exportRootNodeMetadata");
+    },
+    async getNodeById(params) {
+      return await client.request("editorState.getNodeById", params);
+    },
+    async getNodeChildren(params) {
+      return await client.request("editorState.getNodeChildren", params);
+    },
+    async getNodeProperty(params) {
+      return await client.request("editorState.getNodeProperty", params);
+    },
+    async getNodeProperties(params) {
+      return await client.request("editorState.getNodeProperties", params);
+    },
+    async getParentInfo(params) {
+      return await client.request("editorState.getParentInfo", params);
+    },
+    // Selection
+    async getSelectedNodeId() {
+      return await client.request("editorState.getSelectedNodeId");
+    },
+    async setSelectedNodeId(params) {
+      await client.request("editorState.setSelectedNodeId", params);
+    },
+    async getSelectedParameterId() {
+      return await client.request("editorState.getSelectedParameterId");
+    },
+    async setSelectedParameterId(params) {
+      await client.request("editorState.setSelectedParameterId", params);
+    },
+    async getPristine() {
+      return await client.request("editorState.getPristine");
+    },
+    // Write operations
+    async insertNode(params) {
+      return await client.request("editorState.insertNode", params);
+    },
+    async deleteNode(params) {
+      await client.request("editorState.deleteNode", params);
+    },
+    async moveNode(params) {
+      await client.request("editorState.moveNode", params);
+    },
+    async updateNodeProperty(params) {
+      await client.request("editorState.updateNodeProperty", params);
+    },
+    async updateRootMetadata(params) {
+      await client.request("editorState.updateRootMetadata", params);
+    },
+    async updateRootNode(params) {
+      await client.request("editorState.updateRootNode", params);
+    },
+    // Pattern operations
+    async insertPattern(params) {
+      return await client.request("editorState.insertPattern", params);
+    },
+    async isPatternPropertyOverridden(params) {
+      return await client.request("editorState.isPatternPropertyOverridden", params);
+    },
+    async resetPatternPropertyOverride(params) {
+      await client.request("editorState.resetPatternPropertyOverride", params);
+    },
+    // Locale operations
+    async enableLocale(params) {
+      await client.request("editorState.enableLocale", params);
+    },
+    async disableLocale(params) {
+      await client.request("editorState.disableLocale", params);
+    },
+    async setCurrentLocale(params) {
+      await client.request("editorState.setCurrentLocale", params);
+    },
+    // Dynamic input operations
+    async setDynamicInputPreviewValue(params) {
+      await client.request("editorState.setDynamicInputPreviewValue", params);
     }
   };
 }
@@ -733,7 +836,8 @@ async function initializeUniformMeshSDK({
               sdk.events.emit("onValueChanged", { newValue: value });
               await parent.setValue({ uniformMeshLocationValue: value, closeDialog: true });
             }
-          } : void 0
+          } : void 0,
+          editorState: parent.editorState
         };
         return location;
       },

package/dist/index.js

@@ -576,7 +576,110 @@ async function connectToParent({
             )
           }
         );
+      },
+      editorState: createEditorStateApi(client)
+    }
+  };
+}
+function createEditorStateApi(client) {
+  let cachedRootNodeId;
+  return {
+    async getRootNodeId() {
+      if (cachedRootNodeId) {
+        return cachedRootNodeId;
       }
+      const result = await client.request("editorState.getRootNodeId");
+      cachedRootNodeId = result;
+      return result;
+    },
+    // Read operations
+    async exportTree(params) {
+      const result = await client.request("editorState.exportTree", params);
+      cachedRootNodeId != null ? cachedRootNodeId : cachedRootNodeId = result == null ? void 0 : result._id;
+      return result;
+    },
+    async exportSubtree(params) {
+      return await client.request("editorState.exportSubtree", params);
+    },
+    async exportMetadata() {
+      return await client.request("editorState.exportMetadata");
+    },
+    async exportRootNodeMetadata() {
+      return await client.request("editorState.exportRootNodeMetadata");
+    },
+    async getNodeById(params) {
+      return await client.request("editorState.getNodeById", params);
+    },
+    async getNodeChildren(params) {
+      return await client.request("editorState.getNodeChildren", params);
+    },
+    async getNodeProperty(params) {
+      return await client.request("editorState.getNodeProperty", params);
+    },
+    async getNodeProperties(params) {
+      return await client.request("editorState.getNodeProperties", params);
+    },
+    async getParentInfo(params) {
+      return await client.request("editorState.getParentInfo", params);
+    },
+    // Selection
+    async getSelectedNodeId() {
+      return await client.request("editorState.getSelectedNodeId");
+    },
+    async setSelectedNodeId(params) {
+      await client.request("editorState.setSelectedNodeId", params);
+    },
+    async getSelectedParameterId() {
+      return await client.request("editorState.getSelectedParameterId");
+    },
+    async setSelectedParameterId(params) {
+      await client.request("editorState.setSelectedParameterId", params);
+    },
+    async getPristine() {
+      return await client.request("editorState.getPristine");
+    },
+    // Write operations
+    async insertNode(params) {
+      return await client.request("editorState.insertNode", params);
+    },
+    async deleteNode(params) {
+      await client.request("editorState.deleteNode", params);
+    },
+    async moveNode(params) {
+      await client.request("editorState.moveNode", params);
+    },
+    async updateNodeProperty(params) {
+      await client.request("editorState.updateNodeProperty", params);
+    },
+    async updateRootMetadata(params) {
+      await client.request("editorState.updateRootMetadata", params);
+    },
+    async updateRootNode(params) {
+      await client.request("editorState.updateRootNode", params);
+    },
+    // Pattern operations
+    async insertPattern(params) {
+      return await client.request("editorState.insertPattern", params);
+    },
+    async isPatternPropertyOverridden(params) {
+      return await client.request("editorState.isPatternPropertyOverridden", params);
+    },
+    async resetPatternPropertyOverride(params) {
+      await client.request("editorState.resetPatternPropertyOverride", params);
+    },
+    // Locale operations
+    async enableLocale(params) {
+      await client.request("editorState.enableLocale", params);
+    },
+    async disableLocale(params) {
+      await client.request("editorState.disableLocale", params);
+    },
+    async setCurrentLocale(params) {
+      await client.request("editorState.setCurrentLocale", params);
+    },
+    // Dynamic input operations
+    async setDynamicInputPreviewValue(params) {
+      await client.request("editorState.setDynamicInputPreviewValue", params);
     }
   };
 }
@@ -774,7 +877,8 @@ async function initializeUniformMeshSDK({
               sdk.events.emit("onValueChanged", { newValue: value });
               await parent.setValue({ uniformMeshLocationValue: value, closeDialog: true });
             }
-          } : void 0
+          } : void 0,
+          editorState: parent.editorState
         };
         return location;
       },

package/dist/index.mjs

@@ -535,7 +535,110 @@ async function connectToParent({
             )
           }
         );
+      },
+      editorState: createEditorStateApi(client)
+    }
+  };
+}
+function createEditorStateApi(client) {
+  let cachedRootNodeId;
+  return {
+    async getRootNodeId() {
+      if (cachedRootNodeId) {
+        return cachedRootNodeId;
       }
+      const result = await client.request("editorState.getRootNodeId");
+      cachedRootNodeId = result;
+      return result;
+    },
+    // Read operations
+    async exportTree(params) {
+      const result = await client.request("editorState.exportTree", params);
+      cachedRootNodeId != null ? cachedRootNodeId : cachedRootNodeId = result == null ? void 0 : result._id;
+      return result;
+    },
+    async exportSubtree(params) {
+      return await client.request("editorState.exportSubtree", params);
+    },
+    async exportMetadata() {
+      return await client.request("editorState.exportMetadata");
+    },
+    async exportRootNodeMetadata() {
+      return await client.request("editorState.exportRootNodeMetadata");
+    },
+    async getNodeById(params) {
+      return await client.request("editorState.getNodeById", params);
+    },
+    async getNodeChildren(params) {
+      return await client.request("editorState.getNodeChildren", params);
+    },
+    async getNodeProperty(params) {
+      return await client.request("editorState.getNodeProperty", params);
+    },
+    async getNodeProperties(params) {
+      return await client.request("editorState.getNodeProperties", params);
+    },
+    async getParentInfo(params) {
+      return await client.request("editorState.getParentInfo", params);
+    },
+    // Selection
+    async getSelectedNodeId() {
+      return await client.request("editorState.getSelectedNodeId");
+    },
+    async setSelectedNodeId(params) {
+      await client.request("editorState.setSelectedNodeId", params);
+    },
+    async getSelectedParameterId() {
+      return await client.request("editorState.getSelectedParameterId");
+    },
+    async setSelectedParameterId(params) {
+      await client.request("editorState.setSelectedParameterId", params);
+    },
+    async getPristine() {
+      return await client.request("editorState.getPristine");
+    },
+    // Write operations
+    async insertNode(params) {
+      return await client.request("editorState.insertNode", params);
+    },
+    async deleteNode(params) {
+      await client.request("editorState.deleteNode", params);
+    },
+    async moveNode(params) {
+      await client.request("editorState.moveNode", params);
+    },
+    async updateNodeProperty(params) {
+      await client.request("editorState.updateNodeProperty", params);
+    },
+    async updateRootMetadata(params) {
+      await client.request("editorState.updateRootMetadata", params);
+    },
+    async updateRootNode(params) {
+      await client.request("editorState.updateRootNode", params);
+    },
+    // Pattern operations
+    async insertPattern(params) {
+      return await client.request("editorState.insertPattern", params);
+    },
+    async isPatternPropertyOverridden(params) {
+      return await client.request("editorState.isPatternPropertyOverridden", params);
+    },
+    async resetPatternPropertyOverride(params) {
+      await client.request("editorState.resetPatternPropertyOverride", params);
+    },
+    // Locale operations
+    async enableLocale(params) {
+      await client.request("editorState.enableLocale", params);
+    },
+    async disableLocale(params) {
+      await client.request("editorState.disableLocale", params);
+    },
+    async setCurrentLocale(params) {
+      await client.request("editorState.setCurrentLocale", params);
+    },
+    // Dynamic input operations
+    async setDynamicInputPreviewValue(params) {
+      await client.request("editorState.setDynamicInputPreviewValue", params);
     }
   };
 }
@@ -733,7 +836,8 @@ async function initializeUniformMeshSDK({
               sdk.events.emit("onValueChanged", { newValue: value });
               await parent.setValue({ uniformMeshLocationValue: value, closeDialog: true });
             }
-          } : void 0
+          } : void 0,
+          editorState: parent.editorState
         };
         return location;
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/mesh-sdk",
-  "version": "20.56.1-alpha.10+d14d9d60a8",
+  "version": "20.56.1-alpha.21+28f83064e9",
   "description": "Uniform Mesh Framework SDK",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -33,10 +33,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@uniformdev/assets": "20.56.1-alpha.10+d14d9d60a8",
-    "@uniformdev/canvas": "20.56.1-alpha.10+d14d9d60a8",
-    "@uniformdev/context": "20.56.1-alpha.10+d14d9d60a8",
-    "@uniformdev/project-map": "20.56.1-alpha.10+d14d9d60a8",
+    "@uniformdev/assets": "20.56.1-alpha.21+28f83064e9",
+    "@uniformdev/canvas": "20.56.1-alpha.21+28f83064e9",
+    "@uniformdev/context": "20.56.1-alpha.21+28f83064e9",
+    "@uniformdev/project-map": "20.56.1-alpha.21+28f83064e9",
     "imagesloaded": "^5.0.0",
     "mitt": "^3.0.1"
   },
@@ -44,5 +44,5 @@
     "@types/imagesloaded": "^4.1.2",
     "openai": "4.94.0"
   },
-  "gitHead": "d14d9d60a8c7be2fb1fac33e42c60500cb3cf2aa"
+  "gitHead": "28f83064e9573adbe807d4ec989ee57a2b311fa8"
 }