@uniformdev/canvas-react 19.61.1 → 19.62.1-alpha.127

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import React$1, { Key, ReactNode, PropsWithChildren } from 'react';
-import { ComponentInstance, RootComponentInstance, UpdateCompositionMessage, getParameterAttributes as getParameterAttributes$1, SubscribeToCompositionOptions } from '@uniformdev/canvas';
+import { ComponentInstance, RootComponentInstance, UpdateCompositionMessage, getParameterAttributes as getParameterAttributes$1, SubscribeToCompositionOptions, UpdateContextualEditingStateInternalMessage } from '@uniformdev/canvas';
 export { GetParameterAttributesProps, createUniformApiEnhancer } from '@uniformdev/canvas';
-import { PureUniformTextProps } from './core.js';
+import { P as PureUniformTextProps } from './PureUniformText-B3GAm6Dc.js';
 import { RichTextNode } from '@uniformdev/richtext';
 
 /**
@@ -31,6 +31,7 @@ type ComponentStore = {
         component: React.ComponentType<ComponentProps<any>>;
     }) => void;
     get: (type: string, variantId?: string) => React.ComponentType<ComponentProps<any>> | undefined;
+    getComponentsMap: () => Map<string, React.ComponentType<ComponentProps<any>>>;
 };
 
 /**
@@ -104,11 +105,17 @@ declare const useUniformContextualEditing: ({ initialCompositionValue, enhance,
         type: string;
         parameters?: {
             [key: string]: {
-                value: unknown;
+                value?: unknown;
                 type: string;
                 connectedData?: {
                     pointer: string;
                     syntax: "jptr";
+                    failureAction?: "a" | "p" | "t" | "c" | undefined;
+                    failureLogLevel?: "i" | "e" | "w" | undefined;
+                    failureDefault?: string | undefined;
+                } | undefined;
+                locales?: {
+                    [key: string]: unknown;
                 } | undefined;
             };
         } | undefined;
@@ -117,17 +124,38 @@ declare const useUniformContextualEditing: ({ initialCompositionValue, enhance,
             id: string;
             path: string;
             projectMapId: string;
+            data?: {
+                isSearchHit?: boolean | undefined;
+                queryStrings?: {
+                    name: string;
+                    value?: string | undefined;
+                    helpText?: string | undefined;
+                }[] | undefined;
+                previewValue?: string | undefined;
+            } | undefined;
+            locales?: {
+                [key: string]: {
+                    path: string;
+                    inherited: boolean;
+                };
+            } | undefined;
         }[] | undefined;
         slots?: {
             [key: string]: {
                 type: string;
                 parameters?: {
                     [key: string]: {
-                        value: unknown;
+                        value?: unknown;
                         type: string;
                         connectedData?: {
                             pointer: string;
                             syntax: "jptr";
+                            failureAction?: "a" | "p" | "t" | "c" | undefined;
+                            failureLogLevel?: "i" | "e" | "w" | undefined;
+                            failureDefault?: string | undefined;
+                        } | undefined;
+                        locales?: {
+                            [key: string]: unknown;
                         } | undefined;
                     };
                 } | undefined;
@@ -162,14 +190,23 @@ declare const useUniformContextualEditing: ({ initialCompositionValue, enhance,
                     [key: string]: {
                         parameters?: {
                             [key: string]: {
-                                value: unknown;
+                                value?: unknown;
                                 type: string;
                                 connectedData?: {
                                     pointer: string;
                                     syntax: "jptr";
+                                    failureAction?: "a" | "p" | "t" | "c" | undefined;
+                                    failureLogLevel?: "i" | "e" | "w" | undefined;
+                                    failureDefault?: string | undefined;
+                                } | undefined;
+                                locales?: {
+                                    [key: string]: unknown;
                                 } | undefined;
                             };
                         } | undefined;
+                        slots?: {
+                            [key: string]: any[];
+                        } | undefined;
                         variant?: string | undefined;
                     };
                 } | undefined;
@@ -178,12 +215,25 @@ declare const useUniformContextualEditing: ({ initialCompositionValue, enhance,
                         [key: string]: "yes" | "no";
                     } | undefined;
                     variants?: boolean | undefined;
+                    hideLockedParameters?: boolean | undefined;
                 } | undefined;
+                _locales?: string[] | undefined;
             }[];
         } | undefined;
         _id: string;
         _slug?: string | null | undefined;
         _name: string;
+        _pattern?: string | undefined;
+        _patternDataResources?: {
+            [key: string]: {
+                type: string;
+                isPatternParameter?: boolean | undefined;
+                ignorePatternParameterDefault?: boolean | undefined;
+                variables?: {
+                    [key: string]: string;
+                } | undefined;
+            };
+        } | undefined;
         _dataResources?: {
             [key: string]: {
                 type: string;
@@ -194,18 +244,28 @@ declare const useUniformContextualEditing: ({ initialCompositionValue, enhance,
                 } | undefined;
             };
         } | undefined;
+        _patternError?: "NOTFOUND" | "CYCLIC" | undefined;
         _overrides?: {
             [key: string]: {
                 parameters?: {
                     [key: string]: {
-                        value: unknown;
+                        value?: unknown;
                         type: string;
                         connectedData?: {
                             pointer: string;
                             syntax: "jptr";
+                            failureAction?: "a" | "p" | "t" | "c" | undefined;
+                            failureLogLevel?: "i" | "e" | "w" | undefined;
+                            failureDefault?: string | undefined;
+                        } | undefined;
+                        locales?: {
+                            [key: string]: unknown;
                         } | undefined;
                     };
                 } | undefined;
+                slots?: {
+                    [key: string]: any[];
+                } | undefined;
                 variant?: string | undefined;
             };
         } | undefined;
@@ -214,7 +274,9 @@ declare const useUniformContextualEditing: ({ initialCompositionValue, enhance,
                 [key: string]: "yes" | "no";
             } | undefined;
             variants?: boolean | undefined;
+            hideLockedParameters?: boolean | undefined;
         } | undefined;
+        _locales?: string[] | undefined;
     } | undefined;
     isContextualEditing: boolean;
 };
@@ -380,26 +442,31 @@ type UseUniformContextualEditingStateProps = {
      **/
     global?: boolean;
 };
+type UseUniformContextualEditingStateReturnType = {
+    /**
+     * Returns `true` when the app is rendered inside Canvas editor. Regardless of which preview mode is currently selected ("editor" or "preview").
+     */
+    isContextualEditing: boolean;
+    /**
+     * A reference to the currently selected component in Canvas editor.
+     * Returns `undefined` if the selected component is not part of the current React component.
+     * Set the `global` option to `true` to get a reference of the selected component anywhere in the composition tree.
+     */
+    selectedComponentReference: UpdateContextualEditingStateInternalMessage['state']['selectedComponentReference'];
+    /**
+     * Returns the current preview mode in Canvas editor ("editor" or "preview").
+     * Returns `undefined` when the app is not rendered inside Canvas editor.
+     * Learn more about the preview modes: https://docs.uniform.app/docs/guides/composition/visual-editing#editing-and-preview-mode
+     * @deprecated this is an experimental property, it might receive breaking changes in minor releases ⚠️
+     */
+    previewMode: UpdateContextualEditingStateInternalMessage['state']['previewMode'] | undefined;
+};
 /**
  * Returns the state of contextual editing, when the app is open inside Canvas Editor.
  * This hook can be used to improve the editing experience of your team.
  * For example: You can use `selectedComponentReference` to control which element to show inside a carousel or an accordion.
  */
-declare const useUniformContextualEditingState: ({ global, }?: UseUniformContextualEditingStateProps) => {
-    isContextualEditing: boolean;
-    selectedComponentReference: {
-        id: string;
-        slotName?: string | undefined;
-        componentIndex?: number | undefined;
-        totalComponents?: number | undefined;
-        componentName?: string | undefined;
-        componentTitle?: string | undefined;
-        parentId?: string | undefined;
-        parentType?: string | undefined;
-        isLocalized?: boolean | undefined;
-        isReadOnly?: boolean | undefined;
-    } | undefined;
-};
+declare const useUniformContextualEditingState: ({ global, }?: UseUniformContextualEditingStateProps) => UseUniformContextualEditingStateReturnType;
 
 declare const componentStore: ComponentStore;
 declare const registerUniformComponent: ({ type, variantId, component, }: {
@@ -417,4 +484,4 @@ declare const createComponentStoreResolver: (options: {
     defaultComponent?: React$1.ComponentType<ComponentProps<any>>;
 }) => RenderComponentResolver;
 
-export { ComponentProps, ComponentStore, CustomSlotChildRenderFunc, DefaultNotImplementedComponent, NOT_IMPLEMENTED_COMPONENT, RenderComponentResolver, RenderRichTextComponentResolver, RichTextComponentProps, RichTextRendererComponent, SystemRenderConfig, SystemRenderFunction, UniformComponent, UniformComponentContextValue, UniformComponentProps, UniformComposition, UniformCompositionContext, UniformCompositionProps, UniformPlayground, UniformPlaygroundDecorator, UniformPlaygroundProps, UniformRichText, UniformRichTextNode, UniformRichTextNodeProps, UniformRichTextProps, UniformSlot, UniformSlotProps, UniformSlotWrapperComponentProps, UniformText, UniformTextProps, UseCompositionEventEffectOptions, UseUniformContextualEditingProps, UseUniformContextualEditingStateProps, componentStore, componentStoreResolver, convertComponentToProps, createComponentStore, createComponentStoreResolver, getParameterAttributes, registerUniformComponent, useCompositionEventEffect, useUniformContextualEditing, useUniformContextualEditingState, useUniformCurrentComponent, useUniformCurrentComposition };
+export { type ComponentProps, type ComponentStore, type CustomSlotChildRenderFunc, DefaultNotImplementedComponent, NOT_IMPLEMENTED_COMPONENT, type RenderComponentResolver, type RenderRichTextComponentResolver, type RichTextComponentProps, type RichTextRendererComponent, type SystemRenderConfig, type SystemRenderFunction, UniformComponent, type UniformComponentContextValue, type UniformComponentProps, UniformComposition, UniformCompositionContext, type UniformCompositionProps, UniformPlayground, type UniformPlaygroundDecorator, type UniformPlaygroundProps, UniformRichText, UniformRichTextNode, type UniformRichTextNodeProps, type UniformRichTextProps, UniformSlot, type UniformSlotProps, type UniformSlotWrapperComponentProps, UniformText, type UniformTextProps, type UseCompositionEventEffectOptions, type UseUniformContextualEditingProps, type UseUniformContextualEditingStateProps, type UseUniformContextualEditingStateReturnType, componentStore, componentStoreResolver, convertComponentToProps, createComponentStore, createComponentStoreResolver, getParameterAttributes, registerUniformComponent, useCompositionEventEffect, useUniformContextualEditing, useUniformContextualEditingState, useUniformCurrentComponent, useUniformCurrentComposition };