@plasmicapp/react-web 0.2.188 → 0.2.189

package/dist/all.d.ts

@@ -10998,17 +10998,32 @@ interface CanvasComponentProps<Data = any> {
     setControlContextData?: (data: Data) => void;
 }
 declare type InferDataType<P> = P extends CanvasComponentProps<infer Data> ? Data : any;
+declare type ControlExtras = {
+    path: (string | number)[];
+};
 /**
- * Config option that takes the context (e.g., props) of the component instance
- * to dynamically set its value.
+ * Context that we pass back to control functions.
+ */
+declare type ControlContext<P> = [
+/**
+ * props
  */
-declare type ContextDependentConfig<P, R> = (props: P, 
+P, 
 /**
  * `contextData` can be `null` if the prop controls are rendering before
  * the component instance itself (it will re-render once the component
  * calls `setControlContextData`)
  */
-contextData: InferDataType<P> | null) => R;
+InferDataType<P> | null, 
+/**
+ * Extra information for the control to use
+ */
+ControlExtras];
+/**
+ * Config option that takes the context (e.g., props) of the component instance
+ * to dynamically set its value.
+ */
+declare type ContextDependentConfig<P, R> = (...args: ControlContext<P>) => R;
 interface PropTypeBase<P> {
     displayName?: string;
     description?: string;
@@ -11162,7 +11177,7 @@ declare type JSONLikeType<P> = "object" | ({
     /**
      * Optional function that generates a name for this item in the array
      */
-    nameFunc?: (item: any) => string | undefined;
+    nameFunc?: (item: any, ...args: ControlContext<P>) => string | undefined;
 } & DefaultValueOrExpr<P, any> & PropTypeBase<P>) | ({
     type: "array";
     itemType?: {
@@ -11173,8 +11188,29 @@ declare type JSONLikeType<P> = "object" | ({
         /**
          * Optional function that generates a name for this item in the array
          */
-        nameFunc?: (item: any) => string | undefined;
+        nameFunc?: (item: any, ...args: ControlContext<P>) => string | undefined;
     };
+    /**
+     * Specify how to let Plasmic know how to update its own internal representation of the data when the value has
+     * changed, or when issuing a minimalValue or shownValue that is different.
+     *
+     * Important to specify this if you are expecting any nested expression values in this data type!
+     */
+    unstable__keyFunc?: (item: any) => any;
+    /**
+     * Specify what would be the tentative new value that is set if the user makes any changes.
+     *
+     * Useful for field mappings.
+     *
+     * For instance, consider a Table where we have a `fields` prop:
+     *
+     * - Initially, the value is undefined. But if the user makes any changes, we would want to save an array of at
+     *   least three items (corresponding to, say, three columns inferred from a schema).
+     *
+     * - Let's say there are 5 columns in the value. The data schema changes, removing a column and adding two new
+     *   ones. Now we would want a different minimal value, containing 6 items.
+     */
+    unstable__minimalValue?: ContextDependentConfig<P, any>;
 } & DefaultValueOrExpr<P, any[]> & PropTypeBase<P>) | ({
     type: "dataSource";
     dataSource: "airtable" | "cms";
@@ -11903,31 +11939,6 @@ declare type Queries = {
 };
 declare function createUseScreenVariants(isMulti: boolean, screenQueries: Queries): () => string | string[] | undefined;
 
-/**
- * Returns whether the component is currently being server side rendered or
- * hydrated on the client. Can be used to delay browser-specific rendering
- * until after hydration.
- */
-declare function useIsSSR$1(): boolean;
-
-declare type PlasmicTranslator = (str: string, opts?: {
-    components?: {
-        [key: string]: React__default.ReactElement;
-    };
-}) => React__default.ReactNode;
-interface TransProps {
-    transKey?: string;
-    children?: React__default.ReactNode;
-}
-declare function genTranslatableString(elt: React__default.ReactNode): {
-    str: string;
-    components: {
-        [key: string]: React__default.ReactElement<any, string | ((props: any) => React__default.ReactElement<any, any> | null) | (new (props: any) => React__default.Component<any, any, any>)>;
-    };
-    componentsCount: number;
-};
-declare function Trans({ transKey, children }: TransProps): React__default.ReactNode;
-
 interface PlasmicDataSourceContextValue {
     userAuthToken?: string | null;
     isUserLoading?: boolean;
@@ -11953,7 +11964,32 @@ declare function useCurrentUser(): {
 };
 declare const PlasmicDataSourceContextProvider: React__default.Provider<PlasmicDataSourceContextValue | undefined>;
 
-interface PlasmicRootProviderProps {
+/**
+ * Returns whether the component is currently being server side rendered or
+ * hydrated on the client. Can be used to delay browser-specific rendering
+ * until after hydration.
+ */
+declare function useIsSSR$1(): boolean;
+
+declare type PlasmicTranslator = (str: string, opts?: {
+    components?: {
+        [key: string]: React__default.ReactElement;
+    };
+}) => React__default.ReactNode;
+interface TransProps {
+    transKey?: string;
+    children?: React__default.ReactNode;
+}
+declare function genTranslatableString(elt: React__default.ReactNode): {
+    str: string;
+    components: {
+        [key: string]: React__default.ReactElement<any, string | ((props: any) => React__default.ReactElement<any, any> | null) | (new (props: any) => React__default.Component<any, any, any>)>;
+    };
+    componentsCount: number;
+};
+declare function Trans({ transKey, children }: TransProps): React__default.ReactNode;
+
+interface PlasmicRootProviderProps extends PlasmicDataSourceContextValue {
     platform?: "nextjs" | "gatsby";
     children?: React$1.ReactNode;
     translator?: PlasmicTranslator;