@plasmicapp/react-web 1.0.5 → 1.0.7

package/dist/all.d.ts

@@ -12158,7 +12158,7 @@ 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
@@ -12974,8 +12974,14 @@ interface SimplifiedField {
 type PartialParams<P extends any[]> = {
     [K in keyof P]: P[K] | undefined;
 };
+interface FunctionControlExtras {
+    path: (string | number)[];
+    item?: any;
+    mode?: "query" | "mutation";
+}
 type FunctionControlContext<P extends any[]> = GenericContext<PartialParams<P>, // Function params, each may be undefined
-any>;
+any, // Data from fnContext
+FunctionControlExtras>;
 type FunctionContextConfig<P extends any[], R> = ContextDependentConfig<FunctionControlContext<P>, R>;
 interface TypeBaseDefault<Ctx extends any[], T> extends CommonTypeBase, Defaultable<Ctx, T> {
     displayName?: string;
@@ -13751,6 +13757,63 @@ interface PlasmicRootProviderProps extends PlasmicDataSourceContextValue {
     disableLoadingBoundary?: boolean;
     suspenseFallback?: React$1.ReactNode;
 }
+/**
+ * PlasmicRootProvider sets up the React context that Plasmic-generated components
+ * rely on including data sources, i18n, Head, and Link.
+ *
+ * In Next.js app router, props passed from a Server to a Client Components must be serializable
+ * but several PlasmicRootProvider props are not (e.g. `loader`, `Link` from `next/link`).
+ * We recommend defining a Client Component wrapper (`ClientPlasmicRootProvider` in
+ * `plasmic-init-client.tsx`) that imports non-serializable values and passes them to
+ * PlasmicRootProvider (and only accepts serializable props from its caller).
+ *
+ * Loader example:
+ *
+ * ```tsx
+ * // plasmic-init-client.tsx
+ * "use client";
+ * import { PlasmicRootProvider } from "@plasmicapp/loader-nextjs";
+ * import { PLASMIC } from "@/plasmic-init";
+ * export function ClientPlasmicRootProvider(
+ *   props: Omit<React.ComponentProps<typeof PlasmicRootProvider>, "loader">
+ * ) {
+ *   return <PlasmicRootProvider loader={PLASMIC} {...props} />;
+ * }
+ * ```
+ *
+ * Codegen example:
+ *
+ * ```tsx
+ * // plasmic-init-client.tsx
+ * "use client";
+ * import { PlasmicRootProvider } from "@plasmicapp/react-web";
+ * import Link from "next/link";
+ * export function ClientPlasmicRootProvider(
+ *   props: Omit<React.ComponentProps<typeof PlasmicRootProvider>, "Link">
+ * ) {
+ *   return <PlasmicRootProvider Link={Link} {...props} />;
+ * }
+ * ```
+ *
+ * A Server Component can then render `ClientPlasmicRootProvider` and pass
+ * serializable props such as prefetched data and children:
+ *
+ * ```tsx
+ * import { PLASMIC } from "@/plasmic-init";
+ * import { ClientPlasmicRootProvider } from "@/plasmic-init-client";
+ * export default async function MyPage() {
+ *   const prefetchedData = await PLASMIC.fetchComponentData("YourPage");
+ *   return (
+ *     <ClientPlasmicRootProvider prefetchedData={prefetchedData}>
+ *       {yourContent()}
+ *     </ClientPlasmicRootProvider>
+ *   );
+ * }
+ * ```
+ *
+ * See https://nextjs.org/docs/app/getting-started/server-and-client-components#passing-data-from-server-to-client-components
+ * for more on the Server/Client Component boundary.
+ */
 declare function PlasmicRootProvider(props: PlasmicRootProviderProps): React$1.JSX.Element;
 declare const useIsSSR: typeof useIsSSR$1;
 

package/dist/index.cjs.js

@@ -1795,6 +1795,63 @@ function createUseScreenVariants(isMulti, screenQueries) {
 }
 
 var PlasmicRootContext = React__namespace.createContext(undefined);
+/**
+ * PlasmicRootProvider sets up the React context that Plasmic-generated components
+ * rely on including data sources, i18n, Head, and Link.
+ *
+ * In Next.js app router, props passed from a Server to a Client Components must be serializable
+ * but several PlasmicRootProvider props are not (e.g. `loader`, `Link` from `next/link`).
+ * We recommend defining a Client Component wrapper (`ClientPlasmicRootProvider` in
+ * `plasmic-init-client.tsx`) that imports non-serializable values and passes them to
+ * PlasmicRootProvider (and only accepts serializable props from its caller).
+ *
+ * Loader example:
+ *
+ * ```tsx
+ * // plasmic-init-client.tsx
+ * "use client";
+ * import { PlasmicRootProvider } from "@plasmicapp/loader-nextjs";
+ * import { PLASMIC } from "@/plasmic-init";
+ * export function ClientPlasmicRootProvider(
+ *   props: Omit<React.ComponentProps<typeof PlasmicRootProvider>, "loader">
+ * ) {
+ *   return <PlasmicRootProvider loader={PLASMIC} {...props} />;
+ * }
+ * ```
+ *
+ * Codegen example:
+ *
+ * ```tsx
+ * // plasmic-init-client.tsx
+ * "use client";
+ * import { PlasmicRootProvider } from "@plasmicapp/react-web";
+ * import Link from "next/link";
+ * export function ClientPlasmicRootProvider(
+ *   props: Omit<React.ComponentProps<typeof PlasmicRootProvider>, "Link">
+ * ) {
+ *   return <PlasmicRootProvider Link={Link} {...props} />;
+ * }
+ * ```
+ *
+ * A Server Component can then render `ClientPlasmicRootProvider` and pass
+ * serializable props such as prefetched data and children:
+ *
+ * ```tsx
+ * import { PLASMIC } from "@/plasmic-init";
+ * import { ClientPlasmicRootProvider } from "@/plasmic-init-client";
+ * export default async function MyPage() {
+ *   const prefetchedData = await PLASMIC.fetchComponentData("YourPage");
+ *   return (
+ *     <ClientPlasmicRootProvider prefetchedData={prefetchedData}>
+ *       {yourContent()}
+ *     </ClientPlasmicRootProvider>
+ *   );
+ * }
+ * ```
+ *
+ * See https://nextjs.org/docs/app/getting-started/server-and-client-components#passing-data-from-server-to-client-components
+ * for more on the Server/Client Component boundary.
+ */
 function PlasmicRootProvider(props) {
     var _a;
     var platform = props.platform, children = props.children, userAuthToken = props.userAuthToken, isUserLoading = props.isUserLoading, authRedirectUri = props.authRedirectUri, user = props.user, disableLoadingBoundary = props.disableLoadingBoundary, suspenseFallback = props.suspenseFallback;