@plasmicapp/host 2.0.2 → 2.0.4

package/registerToken/dist/data.d.ts

@@ -51,8 +51,13 @@ export interface PageParamsProviderProps {
      * Page query params (e.g. { q: "search term" })
      */
     query?: Record<string, string | string[] | undefined>;
+    /**
+     * Defaults to false. If true, query params are derived from `location.search` sync
+     * with client-side history changes. `query` prop is used as a fallback during SSR.
+     */
+    trackQueryParams?: boolean;
 }
-export declare function PageParamsProvider({ children, route, params, query, }: PageParamsProviderProps): React.JSX.Element;
+export declare function PageParamsProvider({ children, route, params, query, trackQueryParams, }: PageParamsProviderProps): React.JSX.Element;
 export declare function DataCtxReader({ children, }: {
     children: ($ctx: DataDict | undefined) => ReactNode;
 }): React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;

package/registerToken/dist/data.test.d.ts

@@ -0,0 +1 @@
+export {};

package/registerToken/dist/exports.d.ts

@@ -5,7 +5,7 @@ export * from "./global-actions";
 export * from "./link";
 export { ChoiceObject, ChoiceOptions, ChoiceValue, ComponentContextConfig, ComponentControlContext, ContextDependentConfig, ControlExtras, CustomControlProps, ProjectData, PropType, StudioOps, } from "./prop-types";
 export { Action, ActionProps, CodeComponentMeta, CodeComponentMode, ComponentHelpers, ComponentRegistration, ComponentTemplates, StateHelpers, StateSpec, default as registerComponent, stateHelpersKeys, } from "./registerComponent";
-export { CustomFunctionMeta, CustomFunctionRegistration, FunctionContextConfig, FunctionControlContext, ParamType, default as registerFunction, } from "./registerFunction";
+export { CustomFunctionMeta, CustomFunctionRegistration, FunctionContextConfig, FunctionControlContext, FunctionControlExtras, ParamType, default as registerFunction, } from "./registerFunction";
 export { GlobalContextMeta, PropType as GlobalContextPropType, GlobalContextRegistration, default as registerGlobalContext, } from "./registerGlobalContext";
 export { TokenRegistration, TokenType, default as registerToken, } from "./registerToken";
 export { BasicTrait, ChoiceTrait, TraitMeta, TraitRegistration, default as registerTrait, } from "./registerTrait";

package/registerToken/dist/history.d.ts

@@ -0,0 +1 @@
+export declare function useBrowserQueryParams(enabled: boolean): Record<string, string | string[] | undefined> | undefined;

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

@@ -11,8 +11,14 @@ import { Nullish } from "./type-utils";
 export type PartialParams<P extends any[]> = {
     [K in keyof P]: P[K] | undefined;
 };
+export interface FunctionControlExtras {
+    path: (string | number)[];
+    item?: any;
+    mode?: "query" | "mutation";
+}
 export type FunctionControlContext<P extends any[]> = GenericContext<PartialParams<P>, // Function params, each may be undefined
-any>;
+any, // Data from fnContext
+FunctionControlExtras>;
 export type FunctionContextConfig<P extends any[], R> = ContextDependentConfig<FunctionControlContext<P>, R>;
 export interface TypeBaseDefault<Ctx extends any[], T> extends CommonTypeBase, Defaultable<Ctx, T> {
     displayName?: string;

package/registerToken/dist/types/shared-controls.d.ts

@@ -41,7 +41,7 @@ export interface Defaultable<Ctx extends any[], T> {
     /**
      * Default value to set for this prop when the component is instantiated
      */
-    defaultValue?: T;
+    defaultValue?: T | ContextDependentConfig<Ctx, T | undefined>;
     /**
      * Specify that default when no prop/param is provided,
      * so the Plasmic user can see it in the studio UI

package/registerToken/dist/version.d.ts

@@ -1 +1 @@
-export declare const hostVersion = "2.0.2";
+export declare const hostVersion = "2.0.4";

package/registerTrait/dist/data.d.ts

@@ -51,8 +51,13 @@ export interface PageParamsProviderProps {
      * Page query params (e.g. { q: "search term" })
      */
     query?: Record<string, string | string[] | undefined>;
+    /**
+     * Defaults to false. If true, query params are derived from `location.search` sync
+     * with client-side history changes. `query` prop is used as a fallback during SSR.
+     */
+    trackQueryParams?: boolean;
 }
-export declare function PageParamsProvider({ children, route, params, query, }: PageParamsProviderProps): React.JSX.Element;
+export declare function PageParamsProvider({ children, route, params, query, trackQueryParams, }: PageParamsProviderProps): React.JSX.Element;
 export declare function DataCtxReader({ children, }: {
     children: ($ctx: DataDict | undefined) => ReactNode;
 }): React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;

package/registerTrait/dist/data.test.d.ts

@@ -0,0 +1 @@
+export {};

package/registerTrait/dist/exports.d.ts

@@ -5,7 +5,7 @@ export * from "./global-actions";
 export * from "./link";
 export { ChoiceObject, ChoiceOptions, ChoiceValue, ComponentContextConfig, ComponentControlContext, ContextDependentConfig, ControlExtras, CustomControlProps, ProjectData, PropType, StudioOps, } from "./prop-types";
 export { Action, ActionProps, CodeComponentMeta, CodeComponentMode, ComponentHelpers, ComponentRegistration, ComponentTemplates, StateHelpers, StateSpec, default as registerComponent, stateHelpersKeys, } from "./registerComponent";
-export { CustomFunctionMeta, CustomFunctionRegistration, FunctionContextConfig, FunctionControlContext, ParamType, default as registerFunction, } from "./registerFunction";
+export { CustomFunctionMeta, CustomFunctionRegistration, FunctionContextConfig, FunctionControlContext, FunctionControlExtras, ParamType, default as registerFunction, } from "./registerFunction";
 export { GlobalContextMeta, PropType as GlobalContextPropType, GlobalContextRegistration, default as registerGlobalContext, } from "./registerGlobalContext";
 export { TokenRegistration, TokenType, default as registerToken, } from "./registerToken";
 export { BasicTrait, ChoiceTrait, TraitMeta, TraitRegistration, default as registerTrait, } from "./registerTrait";

package/registerTrait/dist/history.d.ts

@@ -0,0 +1 @@
+export declare function useBrowserQueryParams(enabled: boolean): Record<string, string | string[] | undefined> | undefined;

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

@@ -11,8 +11,14 @@ import { Nullish } from "./type-utils";
 export type PartialParams<P extends any[]> = {
     [K in keyof P]: P[K] | undefined;
 };
+export interface FunctionControlExtras {
+    path: (string | number)[];
+    item?: any;
+    mode?: "query" | "mutation";
+}
 export type FunctionControlContext<P extends any[]> = GenericContext<PartialParams<P>, // Function params, each may be undefined
-any>;
+any, // Data from fnContext
+FunctionControlExtras>;
 export type FunctionContextConfig<P extends any[], R> = ContextDependentConfig<FunctionControlContext<P>, R>;
 export interface TypeBaseDefault<Ctx extends any[], T> extends CommonTypeBase, Defaultable<Ctx, T> {
     displayName?: string;

package/registerTrait/dist/types/shared-controls.d.ts

@@ -41,7 +41,7 @@ export interface Defaultable<Ctx extends any[], T> {
     /**
      * Default value to set for this prop when the component is instantiated
      */
-    defaultValue?: T;
+    defaultValue?: T | ContextDependentConfig<Ctx, T | undefined>;
     /**
      * Specify that default when no prop/param is provided,
      * so the Plasmic user can see it in the studio UI

package/registerTrait/dist/version.d.ts

@@ -1 +1 @@
-export declare const hostVersion = "2.0.2";
+export declare const hostVersion = "2.0.4";