@plasmicapp/host 1.0.149 → 1.0.151

package/registerGlobalContext/dist/exports.d.ts

@@ -3,7 +3,7 @@ export * from "./data";
 export { PlasmicElement } from "./element-types";
 export { registerFetcher as unstable_registerFetcher } from "./fetcher";
 export * from "./global-actions";
-export { Action, ActionProps, CodeComponentMeta, ComponentHelpers, ComponentMeta, ComponentRegistration, ComponentTemplates, default as registerComponent, StateHelpers, StateSpec, CodeComponentMode, } from "./registerComponent";
+export { Action, ActionProps, CodeComponentMeta, ComponentHelpers, ComponentMeta, ComponentRegistration, ComponentTemplates, default as registerComponent, stateHelpersKeys, StateHelpers, StateSpec, CodeComponentMode, } from "./registerComponent";
 export { PropType, ContextDependentConfig } from "./prop-types";
 export { default as registerGlobalContext, GlobalContextMeta, GlobalContextRegistration, PropType as GlobalContextPropType, } from "./registerGlobalContext";
 export { default as registerToken, TokenRegistration, TokenType, } from "./registerToken";

package/registerGlobalContext/dist/prop-types.d.ts

@@ -41,6 +41,7 @@ export interface PropTypeBase<P> {
     displayName?: string;
     description?: string;
     helpText?: string;
+    required?: boolean;
     /**
      * If the user has chosen to use a dynamic expression for this prop, provide
      * a hint as to the expected values that the expression should evaluate to.
@@ -84,6 +85,11 @@ interface Defaultable<P, T> {
      */
     defaultExpr?: string;
     defaultExprHint?: string;
+    /**
+     * This function validates whether the prop value is valid.
+     * If the value is invalid, it returns an error message. Otherwise, it returns true.
+     */
+    validator?: (value: T, ...args: ControlContext<P>) => (string | true) | Promise<string | true>;
 }
 interface Controllable {
     /**
@@ -259,15 +265,19 @@ export interface DataSourceType<P> extends PropTypeBase<P> {
     dataSource: "airtable" | "cms";
 }
 type DataPickerValueType = string | number | (string | number)[];
-interface DataPickerType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
+interface RichDataPickerType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
     type: "dataSelector";
-    data: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
+    data?: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
     alwaysShowValuePathAsLabel?: boolean;
+    mergeWithExternalData?: boolean;
 }
-interface ExprEditorType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
+type DataPickerType<P> = "dataPicker" | RichDataPickerType<P>;
+interface RichExprEditorType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
     type: "exprEditor";
-    data: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
+    data?: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
+    mergeWithExternalData?: boolean;
 }
+type ExprEditorType<P> = "exprEditor" | RichExprEditorType<P>;
 interface FormValidationRulesType<P> extends PropTypeBaseDefault<P, any> {
     type: "formValidationRules";
 }

package/registerGlobalContext/dist/registerComponent.d.ts

@@ -76,7 +76,12 @@ export type StateSpec = {
 export interface StateHelpers<P, T> {
     initFunc?: ($props: P) => T;
     onChangeArgsToValue?: (...args: any) => T;
+    onMutate?: (stateValue: T, $ref: any) => void;
 }
+type TupleUnion<U extends string, R extends string[] = []> = {
+    [S in U]: Exclude<U, S> extends never ? [...R, S] : TupleUnion<Exclude<U, S>, [...R, S]>;
+}[U] & string[];
+export declare const stateHelpersKeys: TupleUnion<keyof StateHelpers<any, any>>;
 export type ComponentHelpers<P> = {
     states: Record<string, StateHelpers<P, any>>;
 };

package/registerGlobalContext/dist/version.d.ts

@@ -1 +1 @@
-export declare const hostVersion = "1.0.149";
+export declare const hostVersion = "1.0.151";

package/registerToken/dist/exports.d.ts

@@ -3,7 +3,7 @@ export * from "./data";
 export { PlasmicElement } from "./element-types";
 export { registerFetcher as unstable_registerFetcher } from "./fetcher";
 export * from "./global-actions";
-export { Action, ActionProps, CodeComponentMeta, ComponentHelpers, ComponentMeta, ComponentRegistration, ComponentTemplates, default as registerComponent, StateHelpers, StateSpec, CodeComponentMode, } from "./registerComponent";
+export { Action, ActionProps, CodeComponentMeta, ComponentHelpers, ComponentMeta, ComponentRegistration, ComponentTemplates, default as registerComponent, stateHelpersKeys, StateHelpers, StateSpec, CodeComponentMode, } from "./registerComponent";
 export { PropType, ContextDependentConfig } from "./prop-types";
 export { default as registerGlobalContext, GlobalContextMeta, GlobalContextRegistration, PropType as GlobalContextPropType, } from "./registerGlobalContext";
 export { default as registerToken, TokenRegistration, TokenType, } from "./registerToken";

package/registerToken/dist/prop-types.d.ts

@@ -41,6 +41,7 @@ export interface PropTypeBase<P> {
     displayName?: string;
     description?: string;
     helpText?: string;
+    required?: boolean;
     /**
      * If the user has chosen to use a dynamic expression for this prop, provide
      * a hint as to the expected values that the expression should evaluate to.
@@ -84,6 +85,11 @@ interface Defaultable<P, T> {
      */
     defaultExpr?: string;
     defaultExprHint?: string;
+    /**
+     * This function validates whether the prop value is valid.
+     * If the value is invalid, it returns an error message. Otherwise, it returns true.
+     */
+    validator?: (value: T, ...args: ControlContext<P>) => (string | true) | Promise<string | true>;
 }
 interface Controllable {
     /**
@@ -259,15 +265,19 @@ export interface DataSourceType<P> extends PropTypeBase<P> {
     dataSource: "airtable" | "cms";
 }
 type DataPickerValueType = string | number | (string | number)[];
-interface DataPickerType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
+interface RichDataPickerType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
     type: "dataSelector";
-    data: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
+    data?: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
     alwaysShowValuePathAsLabel?: boolean;
+    mergeWithExternalData?: boolean;
 }
-interface ExprEditorType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
+type DataPickerType<P> = "dataPicker" | RichDataPickerType<P>;
+interface RichExprEditorType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
     type: "exprEditor";
-    data: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
+    data?: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
+    mergeWithExternalData?: boolean;
 }
+type ExprEditorType<P> = "exprEditor" | RichExprEditorType<P>;
 interface FormValidationRulesType<P> extends PropTypeBaseDefault<P, any> {
     type: "formValidationRules";
 }

package/registerToken/dist/registerComponent.d.ts

@@ -76,7 +76,12 @@ export type StateSpec = {
 export interface StateHelpers<P, T> {
     initFunc?: ($props: P) => T;
     onChangeArgsToValue?: (...args: any) => T;
+    onMutate?: (stateValue: T, $ref: any) => void;
 }
+type TupleUnion<U extends string, R extends string[] = []> = {
+    [S in U]: Exclude<U, S> extends never ? [...R, S] : TupleUnion<Exclude<U, S>, [...R, S]>;
+}[U] & string[];
+export declare const stateHelpersKeys: TupleUnion<keyof StateHelpers<any, any>>;
 export type ComponentHelpers<P> = {
     states: Record<string, StateHelpers<P, any>>;
 };

package/registerToken/dist/version.d.ts

@@ -1 +1 @@
-export declare const hostVersion = "1.0.149";
+export declare const hostVersion = "1.0.151";

package/registerTrait/dist/exports.d.ts

@@ -3,7 +3,7 @@ export * from "./data";
 export { PlasmicElement } from "./element-types";
 export { registerFetcher as unstable_registerFetcher } from "./fetcher";
 export * from "./global-actions";
-export { Action, ActionProps, CodeComponentMeta, ComponentHelpers, ComponentMeta, ComponentRegistration, ComponentTemplates, default as registerComponent, StateHelpers, StateSpec, CodeComponentMode, } from "./registerComponent";
+export { Action, ActionProps, CodeComponentMeta, ComponentHelpers, ComponentMeta, ComponentRegistration, ComponentTemplates, default as registerComponent, stateHelpersKeys, StateHelpers, StateSpec, CodeComponentMode, } from "./registerComponent";
 export { PropType, ContextDependentConfig } from "./prop-types";
 export { default as registerGlobalContext, GlobalContextMeta, GlobalContextRegistration, PropType as GlobalContextPropType, } from "./registerGlobalContext";
 export { default as registerToken, TokenRegistration, TokenType, } from "./registerToken";

package/registerTrait/dist/prop-types.d.ts

@@ -41,6 +41,7 @@ export interface PropTypeBase<P> {
     displayName?: string;
     description?: string;
     helpText?: string;
+    required?: boolean;
     /**
      * If the user has chosen to use a dynamic expression for this prop, provide
      * a hint as to the expected values that the expression should evaluate to.
@@ -84,6 +85,11 @@ interface Defaultable<P, T> {
      */
     defaultExpr?: string;
     defaultExprHint?: string;
+    /**
+     * This function validates whether the prop value is valid.
+     * If the value is invalid, it returns an error message. Otherwise, it returns true.
+     */
+    validator?: (value: T, ...args: ControlContext<P>) => (string | true) | Promise<string | true>;
 }
 interface Controllable {
     /**
@@ -259,15 +265,19 @@ export interface DataSourceType<P> extends PropTypeBase<P> {
     dataSource: "airtable" | "cms";
 }
 type DataPickerValueType = string | number | (string | number)[];
-interface DataPickerType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
+interface RichDataPickerType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
     type: "dataSelector";
-    data: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
+    data?: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
     alwaysShowValuePathAsLabel?: boolean;
+    mergeWithExternalData?: boolean;
 }
-interface ExprEditorType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
+type DataPickerType<P> = "dataPicker" | RichDataPickerType<P>;
+interface RichExprEditorType<P> extends PropTypeBaseDefault<P, DataPickerValueType> {
     type: "exprEditor";
-    data: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
+    data?: Record<string, any> | ContextDependentConfig<P, Record<string, any>>;
+    mergeWithExternalData?: boolean;
 }
+type ExprEditorType<P> = "exprEditor" | RichExprEditorType<P>;
 interface FormValidationRulesType<P> extends PropTypeBaseDefault<P, any> {
     type: "formValidationRules";
 }

package/registerTrait/dist/registerComponent.d.ts

@@ -76,7 +76,12 @@ export type StateSpec = {
 export interface StateHelpers<P, T> {
     initFunc?: ($props: P) => T;
     onChangeArgsToValue?: (...args: any) => T;
+    onMutate?: (stateValue: T, $ref: any) => void;
 }
+type TupleUnion<U extends string, R extends string[] = []> = {
+    [S in U]: Exclude<U, S> extends never ? [...R, S] : TupleUnion<Exclude<U, S>, [...R, S]>;
+}[U] & string[];
+export declare const stateHelpersKeys: TupleUnion<keyof StateHelpers<any, any>>;
 export type ComponentHelpers<P> = {
     states: Record<string, StateHelpers<P, any>>;
 };

package/registerTrait/dist/version.d.ts

@@ -1 +1 @@
-export declare const hostVersion = "1.0.149";
+export declare const hostVersion = "1.0.151";