@makeswift/runtime 0.28.10-canary.0 → 0.28.10-canary.10

package/dist/esm/runtimes/react/react-runtime-core.js

@@ -5,8 +5,10 @@ import {
 } from "../../state/actions/internal/read-only-actions";
 import { ComponentIcon } from "../../state/modules/components-meta";
 import { RuntimeCore } from "./runtime-core";
-function validateComponentType(type, component) {
-  const componentName = component?.name ?? "Component";
+function validateComponentType({
+  type,
+  componentName
+}) {
   if (typeof type !== "string" || type === "") {
     throw new Error(
       `${componentName}: A non-empty string \`type\` is required for component registration, got ${type}`
@@ -22,13 +24,32 @@ class ReactRuntimeCore extends RuntimeCore {
     description,
     builtinSuspense,
     unstable_migration,
+    server = false,
     props
   }) {
-    validateComponentType(type, component);
+    const isServerComponent = server !== false;
+    const injectedProps = typeof server === "object" ? server.unstable_injectedProps : {};
+    validateComponentType(
+      // make sure we don't access `component?.name` and trigger loading of the server
+      // component unless we're running in the RSC environment
+      isServerComponent && !this.isRSCEnv() ? { type, componentName: label || "Unknown server component" } : {
+        type,
+        componentName: component?.name || label || "Unknown component"
+      }
+    );
     const unregisterComponent = this.protoStore.dispatch(
       registerComponentEffect(
         type,
-        { label, icon, hidden, description, builtinSuspense, unstable_migration },
+        {
+          label,
+          icon,
+          hidden,
+          description,
+          builtinSuspense,
+          unstable_migration,
+          server: isServerComponent,
+          injectedProps
+        },
         props ?? {}
       )
     );
@@ -37,6 +58,11 @@ class ReactRuntimeCore extends RuntimeCore {
         "builtinSuspense is ignored in React >= 19.2; components are always wrapped in <Activity>."
       );
     }
+    if (isServerComponent && !this.isRSCEnv()) {
+      return () => {
+        unregisterComponent();
+      };
+    }
     const unregisterReactComponent = this.protoStore.dispatch(
       registerReactComponentEffect(type, component)
     );
@@ -45,6 +71,9 @@ class ReactRuntimeCore extends RuntimeCore {
       unregisterReactComponent();
     };
   }
+  isRSCEnv() {
+    return false;
+  }
 }
 export {
   ReactRuntimeCore

package/dist/esm/runtimes/react/react-runtime-core.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/runtimes/react/react-runtime-core.ts"],"sourcesContent":["import { ControlDefinition as UnifiedControlDefinition } from '@makeswift/controls'\n\nimport { type LegacyDescriptor, type DescriptorValueType } from '../../prop-controllers/descriptors'\n\nimport { supportsActivity } from './components/activity-with-fallback'\n\nimport {\n  registerComponentEffect,\n  registerReactComponentEffect,\n} from '../../state/actions/internal/read-only-actions'\n\nimport { ComponentIcon } from '../../state/modules/components-meta'\nimport type { ComponentType } from '../../state/read-only-state'\n\nimport { RuntimeCore } from './runtime-core'\n\nfunction validateComponentType(type: string, component?: ComponentType): void {\n  const componentName = component?.name ?? 'Component'\n  if (typeof type !== 'string' || type === '') {\n    throw new Error(\n      `${componentName}: A non-empty string \\`type\\` is required for component registration, got ${type}`,\n    )\n  }\n}\n\nexport class ReactRuntimeCore extends RuntimeCore {\n  registerComponent<\n    ControlDef extends UnifiedControlDefinition,\n    P extends Record<string, LegacyDescriptor | ControlDef>,\n    C extends ComponentType<{ [K in keyof P]: DescriptorValueType<P[K]> }>,\n  >(\n    component: C,\n    {\n      type,\n      label,\n      icon = ComponentIcon.Cube,\n      hidden = false,\n      description,\n      builtinSuspense,\n      unstable_migration,\n      props,\n    }: {\n      type: string\n      label: string\n      icon?: ComponentIcon\n      hidden?: boolean\n      description?: string\n      /**\n       * In React <= 19.1, controls the default `<Suspense>` boundary.\n       * Ignored in React >= 19.2; components are always wrapped in `<Activity>`.\n       * Defaults to `true`.\n       */\n      builtinSuspense?: boolean\n      /**\n       * Marks this registration as superseded by `replacementType`. When\n       * `replacementType` differs from `type`, the builder offers a way to\n       * update existing instances.\n       */\n      unstable_migration?: { replacementType: string }\n      props?: P\n    },\n  ): () => void {\n    validateComponentType(type, component as unknown as ComponentType)\n\n    const unregisterComponent = this.protoStore.dispatch(\n      registerComponentEffect(\n        type,\n        { label, icon, hidden, description, builtinSuspense, unstable_migration },\n        props ?? {},\n      ),\n    )\n\n    if (supportsActivity() && builtinSuspense !== undefined) {\n      console.warn(\n        'builtinSuspense is ignored in React >= 19.2; components are always wrapped in <Activity>.',\n      )\n    }\n\n    const unregisterReactComponent = this.protoStore.dispatch(\n      registerReactComponentEffect(type, component as unknown as ComponentType),\n    )\n\n    return () => {\n      unregisterComponent()\n      unregisterReactComponent()\n    }\n  }\n}\n"],"mappings":"AAIA,SAAS,wBAAwB;AAEjC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP,SAAS,qBAAqB;AAG9B,SAAS,mBAAmB;AAE5B,SAAS,sBAAsB,MAAc,WAAiC;AAC5E,QAAM,gBAAgB,WAAW,QAAQ;AACzC,MAAI,OAAO,SAAS,YAAY,SAAS,IAAI;AAC3C,UAAM,IAAI;AAAA,MACR,GAAG,aAAa,6EAA6E,IAAI;AAAA,IACnG;AAAA,EACF;AACF;AAEO,MAAM,yBAAyB,YAAY;AAAA,EAChD,kBAKE,WACA;AAAA,IACE;AAAA,IACA;AAAA,IACA,OAAO,cAAc;AAAA,IACrB,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAoBY;AACZ,0BAAsB,MAAM,SAAqC;AAEjE,UAAM,sBAAsB,KAAK,WAAW;AAAA,MAC1C;AAAA,QACE;AAAA,QACA,EAAE,OAAO,MAAM,QAAQ,aAAa,iBAAiB,mBAAmB;AAAA,QACxE,SAAS,CAAC;AAAA,MACZ;AAAA,IACF;AAEA,QAAI,iBAAiB,KAAK,oBAAoB,QAAW;AACvD,cAAQ;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAEA,UAAM,2BAA2B,KAAK,WAAW;AAAA,MAC/C,6BAA6B,MAAM,SAAqC;AAAA,IAC1E;AAEA,WAAO,MAAM;AACX,0BAAoB;AACpB,+BAAyB;AAAA,IAC3B;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/runtimes/react/react-runtime-core.ts"],"sourcesContent":["import { type Component, type PropsWithoutRef, type ReactNode, type RefAttributes } from 'react'\n\nimport {\n  ControlDefinition as UnifiedControlDefinition,\n  type PropsWithValidContextUsage,\n} from '@makeswift/controls'\n\nimport { type LegacyDescriptor, type DescriptorValueType } from '../../prop-controllers/descriptors'\n\nimport { supportsActivity } from './components/activity-with-fallback'\n\nimport {\n  registerComponentEffect,\n  registerReactComponentEffect,\n} from '../../state/actions/internal/read-only-actions'\n\nimport { ComponentIcon } from '../../state/modules/components-meta'\nimport type { ComponentType } from '../../state/read-only-state'\n\nimport { type InjectableProps } from './server/injectable-props'\n\nimport { RuntimeCore } from './runtime-core'\n\nfunction validateComponentType({\n  type,\n  componentName,\n}: {\n  type: string\n  componentName: string\n}): void {\n  if (typeof type !== 'string' || type === '') {\n    throw new Error(\n      `${componentName}: A non-empty string \\`type\\` is required for component registration, got ${type}`,\n    )\n  }\n}\n\ntype InjectedPropsConfig = Record<string, keyof InjectableProps>\n\ntype ServerComponentConfig<I extends InjectedPropsConfig> =\n  | boolean\n  | {\n      unstable_injectedProps: I\n    }\n\ntype InjectedProps<I extends InjectedPropsConfig> = {\n  [K in keyof I]: InjectableProps[I[K]]\n}\n\ntype ResolvedProps<P extends Record<string, LegacyDescriptor | UnifiedControlDefinition>> = {\n  [K in keyof P]: DescriptorValueType<P[K]>\n}\n\ntype RegisteredComponentType<\n  P extends Record<string, LegacyDescriptor | UnifiedControlDefinition>,\n  I extends InjectedPropsConfig,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  T = any,\n> =\n  | {\n      new (\n        props: PropsWithoutRef<ResolvedProps<P>> & InjectedProps<I> & RefAttributes<T>,\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        context?: any,\n      ): Component<ResolvedProps<P> & InjectedProps<I>>\n    }\n  | ((\n      props: PropsWithoutRef<ResolvedProps<P>> & InjectedProps<I> & RefAttributes<T>,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      context?: any,\n    ) => ReactNode)\n\nexport class ReactRuntimeCore extends RuntimeCore {\n  registerComponent<\n    ControlDef extends UnifiedControlDefinition,\n    P extends Record<string, LegacyDescriptor | ControlDef>,\n    // eslint-disable-next-line @typescript-eslint/no-empty-object-type\n    const I extends InjectedPropsConfig = {},\n    C extends RegisteredComponentType<P, I> = RegisteredComponentType<P, I>,\n  >(\n    component: C,\n    {\n      type,\n      label,\n      icon = ComponentIcon.Cube,\n      hidden = false,\n      description,\n      builtinSuspense,\n      unstable_migration,\n      server = false,\n      props,\n    }: {\n      type: string\n      label: string\n      icon?: ComponentIcon\n      hidden?: boolean\n      description?: string\n      /**\n       * In React <= 19.1, controls the default `<Suspense>` boundary.\n       * Ignored in React >= 19.2; components are always wrapped in `<Activity>`.\n       * Defaults to `true`.\n       */\n      builtinSuspense?: boolean\n      /**\n       * Marks this registration as superseded by `replacementType`. When\n       * `replacementType` differs from `type`, the builder offers a way to\n       * update existing instances.\n       */\n      unstable_migration?: { replacementType: string }\n      server?: ServerComponentConfig<I>\n      props?: P & PropsWithValidContextUsage<P>\n    },\n  ): () => void {\n    const isServerComponent = server !== false\n    const injectedProps = typeof server === 'object' ? server.unstable_injectedProps : {}\n\n    validateComponentType(\n      // make sure we don't access `component?.name` and trigger loading of the server\n      // component unless we're running in the RSC environment\n      isServerComponent && !this.isRSCEnv()\n        ? { type, componentName: label || 'Unknown server component' }\n        : {\n            type,\n            componentName: component?.name || label || 'Unknown component',\n          },\n    )\n\n    const unregisterComponent = this.protoStore.dispatch(\n      registerComponentEffect(\n        type,\n        {\n          label,\n          icon,\n          hidden,\n          description,\n          builtinSuspense,\n          unstable_migration,\n          server: isServerComponent,\n          injectedProps,\n        },\n        props ?? {},\n      ),\n    )\n\n    if (supportsActivity() && builtinSuspense !== undefined) {\n      console.warn(\n        'builtinSuspense is ignored in React >= 19.2; components are always wrapped in <Activity>.',\n      )\n    }\n\n    if (isServerComponent && !this.isRSCEnv()) {\n      // we can't load server components code outside of the RSC environment, but we also\n      // don't need to: if everything is set up correctly, React has already rendered and\n      // streamed the corresponding React elements to the client for us -- see\n      // `ServerElementsCache` and `ElementDataServer`\n      return () => {\n        unregisterComponent()\n      }\n    }\n\n    const unregisterReactComponent = this.protoStore.dispatch(\n      registerReactComponentEffect(type, component as unknown as ComponentType),\n    )\n\n    return () => {\n      unregisterComponent()\n      unregisterReactComponent()\n    }\n  }\n\n  protected isRSCEnv() {\n    return false\n  }\n}\n"],"mappings":"AASA,SAAS,wBAAwB;AAEjC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP,SAAS,qBAAqB;AAK9B,SAAS,mBAAmB;AAE5B,SAAS,sBAAsB;AAAA,EAC7B;AAAA,EACA;AACF,GAGS;AACP,MAAI,OAAO,SAAS,YAAY,SAAS,IAAI;AAC3C,UAAM,IAAI;AAAA,MACR,GAAG,aAAa,6EAA6E,IAAI;AAAA,IACnG;AAAA,EACF;AACF;AAqCO,MAAM,yBAAyB,YAAY;AAAA,EAChD,kBAOE,WACA;AAAA,IACE;AAAA,IACA;AAAA,IACA,OAAO,cAAc;AAAA,IACrB,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,EACF,GAqBY;AACZ,UAAM,oBAAoB,WAAW;AACrC,UAAM,gBAAgB,OAAO,WAAW,WAAW,OAAO,yBAAyB,CAAC;AAEpF;AAAA;AAAA;AAAA,MAGE,qBAAqB,CAAC,KAAK,SAAS,IAChC,EAAE,MAAM,eAAe,SAAS,2BAA2B,IAC3D;AAAA,QACE;AAAA,QACA,eAAe,WAAW,QAAQ,SAAS;AAAA,MAC7C;AAAA,IACN;AAEA,UAAM,sBAAsB,KAAK,WAAW;AAAA,MAC1C;AAAA,QACE;AAAA,QACA;AAAA,UACE;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,QAAQ;AAAA,UACR;AAAA,QACF;AAAA,QACA,SAAS,CAAC;AAAA,MACZ;AAAA,IACF;AAEA,QAAI,iBAAiB,KAAK,oBAAoB,QAAW;AACvD,cAAQ;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAEA,QAAI,qBAAqB,CAAC,KAAK,SAAS,GAAG;AAKzC,aAAO,MAAM;AACX,4BAAoB;AAAA,MACtB;AAAA,IACF;AAEA,UAAM,2BAA2B,KAAK,WAAW;AAAA,MAC/C,6BAA6B,MAAM,SAAqC;AAAA,IAC1E;AAEA,WAAO,MAAM;AACX,0BAAoB;AACpB,+BAAyB;AAAA,IAC3B;AAAA,EACF;AAAA,EAEU,WAAW;AACnB,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/esm/runtimes/react/resource-resolver.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/runtimes/react/resource-resolver.ts"],"sourcesContent":["import { type ResourceResolver } from '@makeswift/controls'\n\nimport { getElementId } from '../../state/read-only-state'\nimport { ApiResourcesClient } from '../../api/api-resources-client'\nimport { Store } from '../../state/store'\n\nexport const createResourceResolver = ({\n  store,\n  apiClient,\n  documentKey,\n  locale,\n}: {\n  store: Store\n  apiClient: ApiResourcesClient\n  documentKey: string | null\n  locale: string | null\n}): ResourceResolver => ({\n  resolveSwatch: swatchId => apiClient.resolveSwatch(swatchId),\n  resolveFile: fileId => apiClient.resolveFile(fileId),\n  resolveTypography: typographyId => apiClient.resolveTypography(typographyId),\n  resolvePagePathnameSlice: pageId => apiClient.resolvePagePathnameSlice({ pageId, locale }),\n  resolveElementId: elementKey => {\n    const read = () =>\n      documentKey == null ? null : getElementId(store.getState(), documentKey, elementKey)\n\n    let lastValue: string | null = null\n    return {\n      name: `element-id:${documentKey}:${elementKey}`,\n      readStable: () => (lastValue = read()),\n      subscribe: (onUpdate: () => void) =>\n        store.subscribe(() => {\n          if (read() !== lastValue) onUpdate()\n        }),\n    }\n  },\n})\n"],"mappings":"AAEA,SAAS,oBAAoB;AAItB,MAAM,yBAAyB,CAAC;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,OAKyB;AAAA,EACvB,eAAe,cAAY,UAAU,cAAc,QAAQ;AAAA,EAC3D,aAAa,YAAU,UAAU,YAAY,MAAM;AAAA,EACnD,mBAAmB,kBAAgB,UAAU,kBAAkB,YAAY;AAAA,EAC3E,0BAA0B,YAAU,UAAU,yBAAyB,EAAE,QAAQ,OAAO,CAAC;AAAA,EACzF,kBAAkB,gBAAc;AAC9B,UAAM,OAAO,MACX,eAAe,OAAO,OAAO,aAAa,MAAM,SAAS,GAAG,aAAa,UAAU;AAErF,QAAI,YAA2B;AAC/B,WAAO;AAAA,MACL,MAAM,cAAc,WAAW,IAAI,UAAU;AAAA,MAC7C,YAAY,MAAO,YAAY,KAAK;AAAA,MACpC,WAAW,CAAC,aACV,MAAM,UAAU,MAAM;AACpB,YAAI,KAAK,MAAM;AAAW,mBAAS;AAAA,MACrC,CAAC;AAAA,IACL;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/runtimes/react/resource-resolver.ts"],"sourcesContent":["import { type ResourceResolver } from '@makeswift/controls'\n\nimport { getElementId } from '../../state/read-only-state'\nimport { ApiResourcesClient } from '../../api/api-resources-client'\nimport { Store } from '../../state/store'\n\nexport { type ResourceResolver } from '@makeswift/controls'\n\nexport const createResourceResolver = ({\n  store,\n  apiClient,\n  documentKey,\n  locale,\n}: {\n  store: Store\n  apiClient: ApiResourcesClient\n  documentKey: string | null\n  locale: string | null\n}): ResourceResolver => ({\n  resolveSwatch: swatchId => apiClient.resolveSwatch(swatchId),\n  resolveFile: fileId => apiClient.resolveFile(fileId),\n  resolveTypography: typographyId => apiClient.resolveTypography(typographyId),\n  resolvePagePathnameSlice: pageId => apiClient.resolvePagePathnameSlice({ pageId, locale }),\n  resolveElementId: elementKey => {\n    const read = () =>\n      documentKey == null ? null : getElementId(store.getState(), documentKey, elementKey)\n\n    let lastValue: string | null = null\n    return {\n      name: `element-id:${documentKey}:${elementKey}`,\n      readStable: () => (lastValue = read()),\n      subscribe: (onUpdate: () => void) =>\n        store.subscribe(() => {\n          if (read() !== lastValue) onUpdate()\n        }),\n    }\n  },\n})\n"],"mappings":"AAEA,SAAS,oBAAoB;AAMtB,MAAM,yBAAyB,CAAC;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,OAKyB;AAAA,EACvB,eAAe,cAAY,UAAU,cAAc,QAAQ;AAAA,EAC3D,aAAa,YAAU,UAAU,YAAY,MAAM;AAAA,EACnD,mBAAmB,kBAAgB,UAAU,kBAAkB,YAAY;AAAA,EAC3E,0BAA0B,YAAU,UAAU,yBAAyB,EAAE,QAAQ,OAAO,CAAC;AAAA,EACzF,kBAAkB,gBAAc;AAC9B,UAAM,OAAO,MACX,eAAe,OAAO,OAAO,aAAa,MAAM,SAAS,GAAG,aAAa,UAAU;AAErF,QAAI,YAA2B;AAC/B,WAAO;AAAA,MACL,MAAM,cAAc,WAAW,IAAI,UAAU;AAAA,MAC7C,YAAY,MAAO,YAAY,KAAK;AAAA,MACpC,WAAW,CAAC,aACV,MAAM,UAAU,MAAM;AACpB,YAAI,KAAK,MAAM;AAAW,mBAAS;AAAA,MACrC,CAAC;AAAA,IACL;AAAA,EACF;AACF;","names":[]}

package/dist/esm/runtimes/react/runtime-core.js

@@ -98,7 +98,6 @@ class RuntimeCore {
         fetch: this.fetch,
         apiKey: this.apiKey,
         apiOrigin: this.apiOrigin,
-        graphqlApiEndpoint: this.graphqlApiEndpoint,
         preloadedState
       });
     }

package/dist/esm/runtimes/react/runtime-core.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/runtimes/react/runtime-core.ts"],"sourcesContent":["import { type SerializableReplacementContext } from '@makeswift/controls'\n\nimport { ApiResourcesClient } from '../../api/api-resources-client'\nimport { HostApiResourcesClient } from '../../api/host-api-resources-client'\nimport { MakeswiftApiResourcesClient } from '../../api/makeswift-api-resources-client'\nimport { type HttpFetch } from '../../api/types'\nimport { type SiteVersion } from '../../api/site-version'\n\nimport {\n  type Breakpoints,\n  type BreakpointsInput,\n  parseBreakpointsInput,\n} from '../../state/modules/breakpoints'\n\nimport { copyElementTree } from '../../state/ops/copy-element-tree'\n\nimport { getBreakpoints, type Element, type ElementData } from '../../state/read-only-state'\nimport {\n  configureProtoStore,\n  configureReadWriteStore,\n  type ProtoStore,\n  type Store,\n} from '../../state/store'\n\nimport { RefCountedMap } from '../../utils/ref-counted-map'\nimport { isServer } from '../../utils/is-server'\n\nexport type StoreKey = {\n  siteVersion: SiteVersion | null\n  locale: string | undefined\n}\n\nconst VERSION_TAG_LIVE = 'ref:live'\n\nexport class RuntimeCore {\n  // The unowned entry TTL affects performance, not correctness. The TTL controls how long an unretained store stays\n  // in the map. If an entry expires and is removed from the map before React commits, the store remains retained\n  // via `<StoreContext.Provider>`. The only impact is that future lookups will create a new store instance instead of\n  // reusing the existing one, reducing cache efficiency.\n  private readonly activeStores = new RefCountedMap<string | null, Store>({\n    unownedEntryTtlMs: 1000,\n    // Checking on retain/release is sufficient on the client, and we don't need to check on get on the server\n    // as the only scenario in which we add the store to the map is when the runtime is already bound to the\n    // requested site version, which should be the only site version for which the store is requested\n    ttlCheck: RefCountedMap.TTLCheck.ON_RETAIN | RefCountedMap.TTLCheck.ON_RELEASE,\n  })\n\n  private readonly apiKey: string | undefined\n\n  readonly protoStore: ProtoStore\n  readonly appOrigin: string\n  readonly apiOrigin: string\n  readonly requestKey: StoreKey | undefined\n  readonly fetch: HttpFetch\n\n  constructor({\n    appOrigin = 'https://app.makeswift.com',\n    apiOrigin = 'https://api.makeswift.com',\n    apiKey,\n    breakpoints,\n    requestKey,\n    fetch,\n  }: {\n    appOrigin?: string\n    apiOrigin?: string\n    apiKey?: string\n    breakpoints?: BreakpointsInput\n    requestKey?: StoreKey\n    fetch: HttpFetch\n  }) {\n    this.appOrigin = validateOrigin(appOrigin, 'appOrigin')\n    this.apiOrigin = validateOrigin(apiOrigin, 'apiOrigin')\n    this.apiKey = apiKey\n    this.requestKey = requestKey\n    this.fetch = fetch\n\n    this.protoStore = configureProtoStore({\n      name: 'Runtime proto-store',\n      breakpoints: breakpoints ? parseBreakpointsInput(breakpoints) : undefined,\n    })\n  }\n\n  getOrCreateStore({ siteVersion, locale }: StoreKey): Store {\n    const key = storeCacheKey({ siteVersion, locale })\n\n    const createStore = () => {\n      // API resources client includes an in-memory cache of the site's resources and thus also has to be versioned\n      const apiResourcesClient = this.createApiResourcesClient({ siteVersion, locale })\n\n      // TODO: we need to decouple editability from the site version; specifically, previewing\n      // a draft version of the site should not lead to switching to the read-write state\n      const isReadOnly = siteVersion == null\n\n      return configureReadWriteStore({\n        name: `Runtime read-write store (site version: ${key})`,\n        appOrigin: this.appOrigin,\n        apiResourcesClient,\n        preloadedState: { ...this.protoStore.getState(), siteVersion, isReadOnly, locale },\n      })\n    }\n\n    // On the server, stores are ephemeral by default so SSR does not retain them in a long-lived runtime.\n    // The exception is a runtime that is already bound to the requested site version & locale, where we\n    // can safely reuse the store across multiple root regions and benefit from the host API client's\n    // in-memory cache.\n    //\n    // On the client, stores are reference-counted by site version so multiple root regions can share a store\n    // instance, which preserves the pre-v0.17 per-site-version store behavior without requiring a separate\n    // runtime per root.\n    const usePersistentStore = this.shouldUsePersistentStore(key)\n    return usePersistentStore ? this.activeStores.getOrCreate(key, createStore) : createStore()\n  }\n\n  retainStore({ siteVersion, locale }: StoreKey, store: Store): void {\n    const key = storeCacheKey({ siteVersion, locale })\n\n    if (!this.shouldUsePersistentStore(key)) {\n      console.error('RuntimeCore: attempt to retain an ephemeral store', { key })\n      return\n    }\n\n    if (this.activeStores.retain(key, store)) {\n      store.startBreakpointWatch()\n    }\n  }\n\n  releaseStore({ siteVersion, locale }: StoreKey, store: Store): void {\n    const key = storeCacheKey({ siteVersion, locale })\n\n    if (!this.shouldUsePersistentStore(key)) {\n      console.error('RuntimeCore: attempt to release an ephemeral store', { key })\n      return\n    }\n\n    if (this.activeStores.release(key, store)) {\n      store.stopBreakpointWatch()\n    }\n  }\n\n  copyElementTree(\n    elementTree: ElementData,\n    replacementContext: SerializableReplacementContext,\n  ): Element {\n    return copyElementTree(this.protoStore.getState(), elementTree, replacementContext)\n  }\n\n  getBreakpoints(): Breakpoints {\n    return getBreakpoints(this.protoStore.getState())\n  }\n\n  get graphqlApiEndpoint(): string {\n    return new URL('graphql', this.apiOrigin).href\n  }\n\n  private createApiResourcesClient(preloadedState: {\n    siteVersion: SiteVersion | null\n    locale: string | undefined\n  }): ApiResourcesClient {\n    if (isServer() && this.apiKey) {\n      return new MakeswiftApiResourcesClient({\n        fetch: this.fetch,\n        apiKey: this.apiKey,\n        apiOrigin: this.apiOrigin,\n        graphqlApiEndpoint: this.graphqlApiEndpoint,\n        preloadedState,\n      })\n    }\n\n    return new HostApiResourcesClient({\n      fetch: this.fetch,\n      preloadedState,\n    })\n  }\n\n  private shouldUsePersistentStore(key: string): boolean {\n    // don't persist stores on the server unless the runtime instance is bound to a request\n    // and the requested store matches the request's site version and locale\n    return !isServer() || (this.requestKey !== undefined && storeCacheKey(this.requestKey) === key)\n  }\n}\n\nconst storeCacheKey = ({ siteVersion, locale }: StoreKey): string =>\n  `${siteVersionTag(siteVersion)}/${locale ?? 'default'}`\n\nconst siteVersionTag = (siteVersion: SiteVersion | null): string =>\n  siteVersion?.version ?? VERSION_TAG_LIVE\n\nfunction validateOrigin(url: string, name: string): string {\n  try {\n    return new URL(url).origin\n  } catch {\n    throw new Error(`The Makeswift runtime received an invalid \\`${name}\\` parameter: \"${url}\".`)\n  }\n}\n"],"mappings":"AAGA,SAAS,8BAA8B;AACvC,SAAS,mCAAmC;AAI5C;AAAA,EAGE;AAAA,OACK;AAEP,SAAS,uBAAuB;AAEhC,SAAS,sBAAsD;AAC/D;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AAEP,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AAOzB,MAAM,mBAAmB;AAElB,MAAM,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,EAKN,eAAe,IAAI,cAAoC;AAAA,IACtE,mBAAmB;AAAA;AAAA;AAAA;AAAA,IAInB,UAAU,cAAc,SAAS,YAAY,cAAc,SAAS;AAAA,EACtE,CAAC;AAAA,EAEgB;AAAA,EAER;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY;AAAA,IACV,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAOG;AACD,SAAK,YAAY,eAAe,WAAW,WAAW;AACtD,SAAK,YAAY,eAAe,WAAW,WAAW;AACtD,SAAK,SAAS;AACd,SAAK,aAAa;AAClB,SAAK,QAAQ;AAEb,SAAK,aAAa,oBAAoB;AAAA,MACpC,MAAM;AAAA,MACN,aAAa,cAAc,sBAAsB,WAAW,IAAI;AAAA,IAClE,CAAC;AAAA,EACH;AAAA,EAEA,iBAAiB,EAAE,aAAa,OAAO,GAAoB;AACzD,UAAM,MAAM,cAAc,EAAE,aAAa,OAAO,CAAC;AAEjD,UAAM,cAAc,MAAM;AAExB,YAAM,qBAAqB,KAAK,yBAAyB,EAAE,aAAa,OAAO,CAAC;AAIhF,YAAM,aAAa,eAAe;AAElC,aAAO,wBAAwB;AAAA,QAC7B,MAAM,2CAA2C,GAAG;AAAA,QACpD,WAAW,KAAK;AAAA,QAChB;AAAA,QACA,gBAAgB,EAAE,GAAG,KAAK,WAAW,SAAS,GAAG,aAAa,YAAY,OAAO;AAAA,MACnF,CAAC;AAAA,IACH;AAUA,UAAM,qBAAqB,KAAK,yBAAyB,GAAG;AAC5D,WAAO,qBAAqB,KAAK,aAAa,YAAY,KAAK,WAAW,IAAI,YAAY;AAAA,EAC5F;AAAA,EAEA,YAAY,EAAE,aAAa,OAAO,GAAa,OAAoB;AACjE,UAAM,MAAM,cAAc,EAAE,aAAa,OAAO,CAAC;AAEjD,QAAI,CAAC,KAAK,yBAAyB,GAAG,GAAG;AACvC,cAAQ,MAAM,qDAAqD,EAAE,IAAI,CAAC;AAC1E;AAAA,IACF;AAEA,QAAI,KAAK,aAAa,OAAO,KAAK,KAAK,GAAG;AACxC,YAAM,qBAAqB;AAAA,IAC7B;AAAA,EACF;AAAA,EAEA,aAAa,EAAE,aAAa,OAAO,GAAa,OAAoB;AAClE,UAAM,MAAM,cAAc,EAAE,aAAa,OAAO,CAAC;AAEjD,QAAI,CAAC,KAAK,yBAAyB,GAAG,GAAG;AACvC,cAAQ,MAAM,sDAAsD,EAAE,IAAI,CAAC;AAC3E;AAAA,IACF;AAEA,QAAI,KAAK,aAAa,QAAQ,KAAK,KAAK,GAAG;AACzC,YAAM,oBAAoB;AAAA,IAC5B;AAAA,EACF;AAAA,EAEA,gBACE,aACA,oBACS;AACT,WAAO,gBAAgB,KAAK,WAAW,SAAS,GAAG,aAAa,kBAAkB;AAAA,EACpF;AAAA,EAEA,iBAA8B;AAC5B,WAAO,eAAe,KAAK,WAAW,SAAS,CAAC;AAAA,EAClD;AAAA,EAEA,IAAI,qBAA6B;AAC/B,WAAO,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE;AAAA,EAC5C;AAAA,EAEQ,yBAAyB,gBAGV;AACrB,QAAI,SAAS,KAAK,KAAK,QAAQ;AAC7B,aAAO,IAAI,4BAA4B;AAAA,QACrC,OAAO,KAAK;AAAA,QACZ,QAAQ,KAAK;AAAA,QACb,WAAW,KAAK;AAAA,QAChB,oBAAoB,KAAK;AAAA,QACzB;AAAA,MACF,CAAC;AAAA,IACH;AAEA,WAAO,IAAI,uBAAuB;AAAA,MAChC,OAAO,KAAK;AAAA,MACZ;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEQ,yBAAyB,KAAsB;AAGrD,WAAO,CAAC,SAAS,KAAM,KAAK,eAAe,UAAa,cAAc,KAAK,UAAU,MAAM;AAAA,EAC7F;AACF;AAEA,MAAM,gBAAgB,CAAC,EAAE,aAAa,OAAO,MAC3C,GAAG,eAAe,WAAW,CAAC,IAAI,UAAU,SAAS;AAEvD,MAAM,iBAAiB,CAAC,gBACtB,aAAa,WAAW;AAE1B,SAAS,eAAe,KAAa,MAAsB;AACzD,MAAI;AACF,WAAO,IAAI,IAAI,GAAG,EAAE;AAAA,EACtB,QAAQ;AACN,UAAM,IAAI,MAAM,+CAA+C,IAAI,kBAAkB,GAAG,IAAI;AAAA,EAC9F;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/runtimes/react/runtime-core.ts"],"sourcesContent":["import { type SerializableReplacementContext } from '@makeswift/controls'\n\nimport { ApiResourcesClient } from '../../api/api-resources-client'\nimport { HostApiResourcesClient } from '../../api/host-api-resources-client'\nimport { MakeswiftApiResourcesClient } from '../../api/makeswift-api-resources-client'\nimport { type HttpFetch } from '../../api/types'\nimport { type SiteVersion } from '../../api/site-version'\n\nimport {\n  type Breakpoints,\n  type BreakpointsInput,\n  parseBreakpointsInput,\n} from '../../state/modules/breakpoints'\n\nimport { copyElementTree } from '../../state/ops/copy-element-tree'\n\nimport { getBreakpoints, type Element, type ElementData } from '../../state/read-only-state'\nimport {\n  configureProtoStore,\n  configureReadWriteStore,\n  type ProtoStore,\n  type Store,\n} from '../../state/store'\n\nimport { RefCountedMap } from '../../utils/ref-counted-map'\nimport { isServer } from '../../utils/is-server'\n\nexport type StoreKey = {\n  siteVersion: SiteVersion | null\n  locale: string | undefined\n}\n\nconst VERSION_TAG_LIVE = 'ref:live'\n\nexport class RuntimeCore {\n  // The unowned entry TTL affects performance, not correctness. The TTL controls how long an unretained store stays\n  // in the map. If an entry expires and is removed from the map before React commits, the store remains retained\n  // via `<StoreContext.Provider>`. The only impact is that future lookups will create a new store instance instead of\n  // reusing the existing one, reducing cache efficiency.\n  private readonly activeStores = new RefCountedMap<string | null, Store>({\n    unownedEntryTtlMs: 1000,\n    // Checking on retain/release is sufficient on the client, and we don't need to check on get on the server\n    // as the only scenario in which we add the store to the map is when the runtime is already bound to the\n    // requested site version, which should be the only site version for which the store is requested\n    ttlCheck: RefCountedMap.TTLCheck.ON_RETAIN | RefCountedMap.TTLCheck.ON_RELEASE,\n  })\n\n  private readonly apiKey: string | undefined\n\n  readonly protoStore: ProtoStore\n  readonly appOrigin: string\n  readonly apiOrigin: string\n  readonly requestKey: StoreKey | undefined\n  readonly fetch: HttpFetch\n\n  constructor({\n    appOrigin = 'https://app.makeswift.com',\n    apiOrigin = 'https://api.makeswift.com',\n    apiKey,\n    breakpoints,\n    requestKey,\n    fetch,\n  }: {\n    appOrigin?: string\n    apiOrigin?: string\n    apiKey?: string\n    breakpoints?: BreakpointsInput\n    requestKey?: StoreKey\n    fetch: HttpFetch\n  }) {\n    this.appOrigin = validateOrigin(appOrigin, 'appOrigin')\n    this.apiOrigin = validateOrigin(apiOrigin, 'apiOrigin')\n    this.apiKey = apiKey\n    this.requestKey = requestKey\n    this.fetch = fetch\n\n    this.protoStore = configureProtoStore({\n      name: 'Runtime proto-store',\n      breakpoints: breakpoints ? parseBreakpointsInput(breakpoints) : undefined,\n    })\n  }\n\n  getOrCreateStore({ siteVersion, locale }: StoreKey): Store {\n    const key = storeCacheKey({ siteVersion, locale })\n\n    const createStore = () => {\n      // API resources client includes an in-memory cache of the site's resources and thus also has to be versioned\n      const apiResourcesClient = this.createApiResourcesClient({ siteVersion, locale })\n\n      // TODO: we need to decouple editability from the site version; specifically, previewing\n      // a draft version of the site should not lead to switching to the read-write state\n      const isReadOnly = siteVersion == null\n\n      return configureReadWriteStore({\n        name: `Runtime read-write store (site version: ${key})`,\n        appOrigin: this.appOrigin,\n        apiResourcesClient,\n        preloadedState: { ...this.protoStore.getState(), siteVersion, isReadOnly, locale },\n      })\n    }\n\n    // On the server, stores are ephemeral by default so SSR does not retain them in a long-lived runtime.\n    // The exception is a runtime that is already bound to the requested site version & locale, where we\n    // can safely reuse the store across multiple root regions and benefit from the host API client's\n    // in-memory cache.\n    //\n    // On the client, stores are reference-counted by site version so multiple root regions can share a store\n    // instance, which preserves the pre-v0.17 per-site-version store behavior without requiring a separate\n    // runtime per root.\n    const usePersistentStore = this.shouldUsePersistentStore(key)\n    return usePersistentStore ? this.activeStores.getOrCreate(key, createStore) : createStore()\n  }\n\n  retainStore({ siteVersion, locale }: StoreKey, store: Store): void {\n    const key = storeCacheKey({ siteVersion, locale })\n\n    if (!this.shouldUsePersistentStore(key)) {\n      console.error('RuntimeCore: attempt to retain an ephemeral store', { key })\n      return\n    }\n\n    if (this.activeStores.retain(key, store)) {\n      store.startBreakpointWatch()\n    }\n  }\n\n  releaseStore({ siteVersion, locale }: StoreKey, store: Store): void {\n    const key = storeCacheKey({ siteVersion, locale })\n\n    if (!this.shouldUsePersistentStore(key)) {\n      console.error('RuntimeCore: attempt to release an ephemeral store', { key })\n      return\n    }\n\n    if (this.activeStores.release(key, store)) {\n      store.stopBreakpointWatch()\n    }\n  }\n\n  copyElementTree(\n    elementTree: ElementData,\n    replacementContext: SerializableReplacementContext,\n  ): Element {\n    return copyElementTree(this.protoStore.getState(), elementTree, replacementContext)\n  }\n\n  getBreakpoints(): Breakpoints {\n    return getBreakpoints(this.protoStore.getState())\n  }\n\n  get graphqlApiEndpoint(): string {\n    return new URL('graphql', this.apiOrigin).href\n  }\n\n  private createApiResourcesClient(preloadedState: {\n    siteVersion: SiteVersion | null\n    locale: string | undefined\n  }): ApiResourcesClient {\n    if (isServer() && this.apiKey) {\n      return new MakeswiftApiResourcesClient({\n        fetch: this.fetch,\n        apiKey: this.apiKey,\n        apiOrigin: this.apiOrigin,\n        preloadedState,\n      })\n    }\n\n    return new HostApiResourcesClient({\n      fetch: this.fetch,\n      preloadedState,\n    })\n  }\n\n  private shouldUsePersistentStore(key: string): boolean {\n    // don't persist stores on the server unless the runtime instance is bound to a request\n    // and the requested store matches the request's site version and locale\n    return !isServer() || (this.requestKey !== undefined && storeCacheKey(this.requestKey) === key)\n  }\n}\n\nconst storeCacheKey = ({ siteVersion, locale }: StoreKey): string =>\n  `${siteVersionTag(siteVersion)}/${locale ?? 'default'}`\n\nconst siteVersionTag = (siteVersion: SiteVersion | null): string =>\n  siteVersion?.version ?? VERSION_TAG_LIVE\n\nfunction validateOrigin(url: string, name: string): string {\n  try {\n    return new URL(url).origin\n  } catch {\n    throw new Error(`The Makeswift runtime received an invalid \\`${name}\\` parameter: \"${url}\".`)\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/esm/runtimes/react/server/collect-server-elements.js

@@ -0,0 +1,50 @@
+import { jsx } from "react/jsx-runtime";
+import { isElementReference } from "@makeswift/controls";
+import { getComponentsMeta } from "../../../state/modules/components-meta";
+import { traverseElementTree } from "../../../state/modules/element-trees";
+import { registerDocument } from "../../../state/shared-api";
+import { getPropControllerDescriptors } from "../../../state/read-only-state";
+import { ServerElement } from "./components/element";
+import { getStore } from "./render-context";
+import { updateApiResourceCache } from "./update-api-resource-cache";
+function collectServerElements(context, document, cacheData) {
+  const store = getStore(context);
+  updateApiResourceCache(store, cacheData);
+  store.dispatch(registerDocument(document));
+  const state = store.getState();
+  const descriptors = getPropControllerDescriptors(state);
+  const result = /* @__PURE__ */ new Map();
+  for (const element of traverseElementTree(document.rootElement, descriptors)) {
+    if (isElementReference(element)) {
+      continue;
+    }
+    const meta = getComponentsMeta(state.componentsMeta).get(element.type);
+    if (meta == null) {
+      console.warn(`collectServerElements: Component meta not found for ${element.type}`);
+      continue;
+    }
+    if (result.has(element.key)) {
+      console.warn(`collectServerElements: RSC node already exists for ${element.key}`);
+      continue;
+    }
+    if (meta.server) {
+      result.set(
+        element.key,
+        /* @__PURE__ */ jsx(
+          ServerElement,
+          {
+            context,
+            element,
+            documentKey: document.key
+          },
+          element.key
+        )
+      );
+    }
+  }
+  return result;
+}
+export {
+  collectServerElements
+};
+//# sourceMappingURL=collect-server-elements.js.map

package/dist/esm/runtimes/react/server/collect-server-elements.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/runtimes/react/server/collect-server-elements.tsx"],"sourcesContent":["import { type ReactNode } from 'react'\n\nimport { isElementReference } from '@makeswift/controls'\n\nimport { type CacheData } from '../../../api/api-resources-client'\n\nimport { type Document } from '../../../state/modules/read-only-documents'\nimport { getComponentsMeta } from '../../../state/modules/components-meta'\nimport { traverseElementTree } from '../../../state/modules/element-trees'\nimport { registerDocument } from '../../../state/shared-api'\nimport { getPropControllerDescriptors } from '../../../state/read-only-state'\n\nimport { ServerElement } from './components/element'\n\nimport { type ServerRenderContext, getStore } from './render-context'\nimport { updateApiResourceCache } from './update-api-resource-cache'\n\nexport type ElementsMap = Map<string, ReactNode>\n\n/**\n * Collects React nodes for document's server elements into a map keyed by\n * element key.\n *\n * Note that this function only *creates* React elements and associates them\n * with the corresponding Makeswift elements; it does not render anything.\n *\n * The actual render happens when React's server renderer walks the React tree\n * and hits the 'use client' boundary at `<ServerElementsCache />`, at which\n * point it needs to serialize the `value` prop into the flight stream and thus\n * execute `ServerElement` rendering code for each entry in the map.\n */\nexport function collectServerElements(\n  context: ServerRenderContext,\n  document: Document,\n  cacheData: CacheData,\n): ElementsMap {\n  const store = getStore(context)\n  updateApiResourceCache(store, cacheData)\n\n  store.dispatch(registerDocument(document))\n\n  const state = store.getState()\n  const descriptors = getPropControllerDescriptors(state)\n\n  const result: ElementsMap = new Map()\n\n  for (const element of traverseElementTree(document.rootElement, descriptors)) {\n    if (isElementReference(element)) {\n      // TODO: Element reference support\n      continue\n    }\n\n    const meta = getComponentsMeta(state.componentsMeta).get(element.type)\n\n    if (meta == null) {\n      console.warn(`collectServerElements: Component meta not found for ${element.type}`)\n      continue\n    }\n\n    if (result.has(element.key)) {\n      console.warn(`collectServerElements: RSC node already exists for ${element.key}`)\n      continue\n    }\n\n    if (meta.server) {\n      result.set(\n        element.key,\n        <ServerElement\n          key={element.key}\n          context={context}\n          element={element}\n          documentKey={document.key}\n        />,\n      )\n    }\n  }\n\n  return result\n}\n"],"mappings":"AAmEQ;AAjER,SAAS,0BAA0B;AAKnC,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,wBAAwB;AACjC,SAAS,oCAAoC;AAE7C,SAAS,qBAAqB;AAE9B,SAAmC,gBAAgB;AACnD,SAAS,8BAA8B;AAgBhC,SAAS,sBACd,SACA,UACA,WACa;AACb,QAAM,QAAQ,SAAS,OAAO;AAC9B,yBAAuB,OAAO,SAAS;AAEvC,QAAM,SAAS,iBAAiB,QAAQ,CAAC;AAEzC,QAAM,QAAQ,MAAM,SAAS;AAC7B,QAAM,cAAc,6BAA6B,KAAK;AAEtD,QAAM,SAAsB,oBAAI,IAAI;AAEpC,aAAW,WAAW,oBAAoB,SAAS,aAAa,WAAW,GAAG;AAC5E,QAAI,mBAAmB,OAAO,GAAG;AAE/B;AAAA,IACF;AAEA,UAAM,OAAO,kBAAkB,MAAM,cAAc,EAAE,IAAI,QAAQ,IAAI;AAErE,QAAI,QAAQ,MAAM;AAChB,cAAQ,KAAK,uDAAuD,QAAQ,IAAI,EAAE;AAClF;AAAA,IACF;AAEA,QAAI,OAAO,IAAI,QAAQ,GAAG,GAAG;AAC3B,cAAQ,KAAK,sDAAsD,QAAQ,GAAG,EAAE;AAChF;AAAA,IACF;AAEA,QAAI,KAAK,QAAQ;AACf,aAAO;AAAA,QACL,QAAQ;AAAA,QACR;AAAA,UAAC;AAAA;AAAA,YAEC;AAAA,YACA;AAAA,YACA,aAAa,SAAS;AAAA;AAAA,UAHjB,QAAQ;AAAA,QAIf;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/runtimes/react/server/components/editable-server-element.js

@@ -0,0 +1,152 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useRef, startTransition, useCallback } from "react";
+import {
+  setResolvedValueOverride,
+  clearResolvedValueOverride
+} from "../../../../state/actions/internal/read-write-actions";
+import { useServerElementRefresh } from "../../hooks/use-server-element-refresh";
+import { useElementData } from "../../hooks/use-element-data";
+import { useControlDefs } from "../../hooks/use-control-defs";
+import { useEditableElementStylesheetFactory } from "../../hooks/use-editable-element-stylesheet-factory";
+import { useResolvedProps } from "../../hooks/use-resolved-props";
+import { useControlInstances } from "../../components/control-instances-context";
+import { useDispatch } from "../../hooks/use-dispatch";
+import { useDocumentKey } from "../../hooks/use-document-context";
+import { getProp } from "../../../../utils/prop-by-path";
+import { setUnion, setDifference } from "../../../../utils/set";
+const EditableServerElement = ({
+  initialElementData,
+  children
+}) => {
+  const elementKey = initialElementData.key;
+  const elementData = useElementData({ elementKey });
+  if (elementData == null) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx(EditableServerElementWrapper, { ...{ initialElementData, elementData }, children });
+};
+const EditableServerElementWrapper = ({
+  initialElementData,
+  elementData,
+  children
+}) => {
+  const elementKey = initialElementData.key;
+  const dispatch = useDispatch();
+  const documentKey = useDocumentKey();
+  const [_legacyDefs, definitions] = useControlDefs({ elementType: initialElementData.type });
+  const stylesheetFactory = useEditableElementStylesheetFactory({ elementKey });
+  const controlInstances = useControlInstances(elementKey);
+  const resolvedProps = useResolvedProps({
+    elementKey,
+    propDefs: definitions,
+    propData: elementData.props,
+    controlInstances,
+    stylesheetFactory
+  });
+  const prevPropsRef = useRef(resolvedProps);
+  const prevLeafPropsRef = useRef(
+    getLeafPropsAndInstances(resolvedProps, controlInstances).leafProps
+  );
+  const serverRefresh = useServerElementRefresh({ elementKey });
+  const applyServerRefresh = useCallback(
+    (elementData2, leafInstances, documentKey2) => startTransition(async () => {
+      const applied = await serverRefresh(elementData2);
+      if (!applied)
+        return;
+      startTransition(() => {
+        leafInstances.forEach(
+          (c) => dispatch(clearResolvedValueOverride({ documentKey: documentKey2, instanceKey: c.instanceKey }))
+        );
+      });
+    }),
+    [serverRefresh, dispatch]
+  );
+  const applyResolvedValueOverrides = useCallback(
+    (instances, props, documentKey2) => instances.forEach(
+      (c) => dispatch(
+        setResolvedValueOverride({
+          documentKey: documentKey2,
+          instanceKey: c.instanceKey,
+          value: getProp(props, c.propPath)
+        })
+      )
+    ),
+    [dispatch]
+  );
+  useEffect(() => {
+    if (documentKey == null)
+      return;
+    if (children == null) {
+      const { leafInstances, leafProps } = getLeafPropsAndInstances(resolvedProps, controlInstances);
+      applyServerRefresh(elementData, leafInstances, documentKey);
+      prevPropsRef.current = resolvedProps;
+      prevLeafPropsRef.current = leafProps;
+      return;
+    }
+    if (resolvedProps !== prevPropsRef.current) {
+      const { needsRefresh, leafInstances, leafProps, reactNodeInstances } = needsServerRefresh({
+        resolvedProps,
+        controlInstances,
+        prevProps: prevPropsRef.current,
+        prevLeafProps: prevLeafPropsRef.current
+      });
+      if (needsRefresh) {
+        applyServerRefresh(elementData, leafInstances, documentKey);
+      } else {
+        applyResolvedValueOverrides(reactNodeInstances, resolvedProps, documentKey);
+      }
+      prevPropsRef.current = resolvedProps;
+      prevLeafPropsRef.current = leafProps;
+    }
+  }, [
+    children,
+    resolvedProps,
+    documentKey,
+    elementData,
+    controlInstances,
+    applyServerRefresh,
+    applyResolvedValueOverrides
+  ]);
+  return children;
+};
+const needsServerRefresh = ({
+  resolvedProps,
+  controlInstances,
+  prevProps,
+  prevLeafProps
+}) => {
+  const { leafInstances, leafProps } = getLeafPropsAndInstances(resolvedProps, controlInstances);
+  const combinedLeafProps = setUnion(leafProps, prevLeafProps).values();
+  const updatedLeafProps = new Set(
+    [...combinedLeafProps].filter(
+      (propName) => getProp(resolvedProps, propName) !== getProp(prevProps, propName)
+    )
+  );
+  const updatedLeafInstances = leafInstances.filter(
+    (instance) => updatedLeafProps.has(instance.propPath)
+  );
+  const reactNodeInstances = updatedLeafInstances.filter((c) => c.resolvesToRenderableNode());
+  const reactNodePropKeys = new Set(reactNodeInstances.map((c) => c.propPath));
+  const newlyAddedLeafProps = setDifference(leafProps, prevLeafProps);
+  const needsRefresh = setDifference(updatedLeafProps, reactNodePropKeys).size > 0 || newlyAddedLeafProps.size > 0;
+  return {
+    needsRefresh,
+    leafInstances,
+    leafProps,
+    reactNodeInstances
+  };
+};
+const getLeafPropsAndInstances = (props, controlInstances) => {
+  const topLevelInstances = Object.keys(props).map((prop) => controlInstances?.[prop]).filter((inst) => inst != null);
+  const leafInstances = getLeafInstances(topLevelInstances);
+  const leafProps = new Set(leafInstances.map((c) => c.propPath));
+  return { leafProps, leafInstances };
+};
+const getLeafInstances = (instances) => instances.flatMap(
+  (instance) => instance.isCompositeProp() ? getLeafInstances(instance.children()) : [instance]
+);
+export {
+  EditableServerElement
+};
+//# sourceMappingURL=editable-server-element.js.map

package/dist/esm/runtimes/react/server/components/editable-server-element.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/runtimes/react/server/components/editable-server-element.tsx"],"sourcesContent":["'use client'\n\nimport { type PropsWithChildren, useEffect, useRef, startTransition, useCallback } from 'react'\n\nimport { ControlInstance } from '@makeswift/controls'\n\nimport { type ElementData } from '../../../../state/read-only-state'\nimport {\n  setResolvedValueOverride,\n  clearResolvedValueOverride,\n} from '../../../../state/actions/internal/read-write-actions'\n\nimport { useServerElementRefresh } from '../../hooks/use-server-element-refresh'\nimport { useElementData } from '../../hooks/use-element-data'\nimport { useControlDefs } from '../../hooks/use-control-defs'\nimport { useEditableElementStylesheetFactory } from '../../hooks/use-editable-element-stylesheet-factory'\nimport { useResolvedProps } from '../../hooks/use-resolved-props'\nimport { useControlInstances } from '../../components/control-instances-context'\nimport { useDispatch } from '../../hooks/use-dispatch'\nimport { useDocumentKey } from '../../hooks/use-document-context'\n\nimport { getProp } from '../../../../utils/prop-by-path'\nimport { setUnion, setDifference } from '../../../../utils/set'\n\nexport const EditableServerElement = ({\n  initialElementData,\n  children,\n}: PropsWithChildren<{ initialElementData: ElementData }>) => {\n  const elementKey = initialElementData.key\n  const elementData = useElementData({ elementKey })\n  if (elementData == null) {\n    // Element has been deleted\n    return null\n  }\n\n  return (\n    <EditableServerElementWrapper {...{ initialElementData, elementData }}>\n      {children}\n    </EditableServerElementWrapper>\n  )\n}\n\n/**\n * Reflects edits to `elementData.props` in the server-rendered `children`.\n * Changes limited to existing `ReactNode` props are applied through client-side\n * overrides. Style prop changes are handled by the stylesheet engine during\n * prop resolution. All other prop changes trigger a server refresh.\n */\nconst EditableServerElementWrapper = ({\n  initialElementData,\n  elementData,\n  children,\n}: PropsWithChildren<{ initialElementData: ElementData; elementData: ElementData }>) => {\n  const elementKey = initialElementData.key\n  const dispatch = useDispatch()\n  const documentKey = useDocumentKey()\n\n  const [_legacyDefs, definitions] = useControlDefs({ elementType: initialElementData.type })\n  const stylesheetFactory = useEditableElementStylesheetFactory({ elementKey })\n\n  const controlInstances = useControlInstances(elementKey)\n  const resolvedProps = useResolvedProps({\n    elementKey,\n    propDefs: definitions,\n    propData: elementData.props,\n    controlInstances,\n    stylesheetFactory,\n  })\n\n  const prevPropsRef = useRef(resolvedProps)\n  const prevLeafPropsRef = useRef(\n    getLeafPropsAndInstances(resolvedProps, controlInstances).leafProps,\n  )\n\n  const serverRefresh = useServerElementRefresh({ elementKey })\n  const applyServerRefresh = useCallback(\n    (elementData: ElementData, leafInstances: ControlInstance[], documentKey: string) =>\n      startTransition(async () => {\n        const applied = await serverRefresh(elementData)\n        if (!applied) return\n\n        // need a nested `startTransition` here, see\n        // https://react.dev/reference/react/useTransition#react-doesnt-treat-my-state-update-after-await-as-a-transition\n        startTransition(() => {\n          // reset instance overrides, if any\n          leafInstances.forEach(c =>\n            dispatch(clearResolvedValueOverride({ documentKey, instanceKey: c.instanceKey })),\n          )\n        })\n      }),\n    [serverRefresh, dispatch],\n  )\n\n  const applyResolvedValueOverrides = useCallback(\n    (instances: ControlInstance[], props: Record<string, unknown>, documentKey: string) =>\n      instances.forEach(c =>\n        dispatch(\n          setResolvedValueOverride({\n            documentKey,\n            instanceKey: c.instanceKey,\n            value: getProp(props, c.propPath),\n          }),\n        ),\n      ),\n    [dispatch],\n  )\n\n  useEffect(() => {\n    if (documentKey == null) return\n\n    if (children == null) {\n      // If we don't have a server-rendered node (i.e. user just dropped the element to the page),\n      // trigger a server re-render\n      const { leafInstances, leafProps } = getLeafPropsAndInstances(resolvedProps, controlInstances)\n\n      applyServerRefresh(elementData, leafInstances, documentKey)\n\n      prevPropsRef.current = resolvedProps\n      prevLeafPropsRef.current = leafProps\n      return\n    }\n\n    if (resolvedProps !== prevPropsRef.current) {\n      // If there was a change in resolved value, check if any of the changed props necessitate\n      // a server refresh.\n      //\n      // Note that style props have stable class names and updating a style prop will not result\n      // in a change to the resolved value, which is what we want. The stylesheet engine takes\n      // care of updating the client CSS on style prop updates through the `useResolvedProps` call.\n      const { needsRefresh, leafInstances, leafProps, reactNodeInstances } = needsServerRefresh({\n        resolvedProps,\n        controlInstances,\n        prevProps: prevPropsRef.current,\n        prevLeafProps: prevLeafPropsRef.current,\n      })\n\n      if (needsRefresh) {\n        applyServerRefresh(elementData, leafInstances, documentKey)\n      } else {\n        applyResolvedValueOverrides(reactNodeInstances, resolvedProps, documentKey)\n      }\n\n      prevPropsRef.current = resolvedProps\n      prevLeafPropsRef.current = leafProps\n    }\n  }, [\n    children,\n    resolvedProps,\n    documentKey,\n    elementData,\n    controlInstances,\n    applyServerRefresh,\n    applyResolvedValueOverrides,\n  ])\n\n  return children\n}\n\n/**\n * Determines whether resolved prop changes require a server refresh and returns\n * the control-instance state needed to apply the update.\n */\nconst needsServerRefresh = ({\n  resolvedProps,\n  controlInstances,\n  prevProps,\n  prevLeafProps,\n}: {\n  resolvedProps: Record<string, unknown>\n  controlInstances: Record<string, ControlInstance> | null\n  prevProps: Record<string, unknown>\n  prevLeafProps: Set<string>\n}): {\n  needsRefresh: boolean\n  leafInstances: ControlInstance[]\n  leafProps: Set<string>\n  reactNodeInstances: ControlInstance[]\n} => {\n  const { leafInstances, leafProps } = getLeafPropsAndInstances(resolvedProps, controlInstances)\n\n  const combinedLeafProps = setUnion(leafProps, prevLeafProps).values()\n  const updatedLeafProps = new Set(\n    [...combinedLeafProps].filter(\n      propName => getProp(resolvedProps, propName) !== getProp(prevProps, propName),\n    ),\n  )\n\n  const updatedLeafInstances = leafInstances.filter(instance =>\n    updatedLeafProps.has(instance.propPath),\n  )\n\n  const reactNodeInstances = updatedLeafInstances.filter(c => c.resolvesToRenderableNode())\n\n  const reactNodePropKeys = new Set(reactNodeInstances.map(c => c.propPath))\n  const newlyAddedLeafProps = setDifference(leafProps, prevLeafProps)\n\n  // A server refresh is needed if some of the updated props are not `ReactNode` props, or we\n  // have newly observed props (typically `List` items). Even when newly observed props are\n  // `ReactNode` props, we have to first render them on the server to get them in the element\n  // tree before they can be updated client-side.\n  const needsRefresh =\n    setDifference(updatedLeafProps, reactNodePropKeys).size > 0 || newlyAddedLeafProps.size > 0\n\n  return {\n    needsRefresh,\n    leafInstances,\n    leafProps,\n    reactNodeInstances,\n  }\n}\n\n/**\n *  Returns terminal prop paths with the corresponding control instances.\n */\nconst getLeafPropsAndInstances = (\n  props: Record<string, unknown>,\n  controlInstances: Record<string, ControlInstance> | null,\n): {\n  leafProps: Set<string>\n  leafInstances: ControlInstance[]\n} => {\n  const topLevelInstances = Object.keys(props)\n    .map(prop => controlInstances?.[prop])\n    .filter(inst => inst != null)\n\n  const leafInstances = getLeafInstances(topLevelInstances)\n  const leafProps = new Set(leafInstances.map(c => c.propPath))\n  return { leafProps, leafInstances }\n}\n\n/**\n * Flattens a control instance tree to its leaf (terminal) instances.\n */\nconst getLeafInstances = (instances: ControlInstance[]): ControlInstance[] =>\n  instances.flatMap(instance =>\n    instance.isCompositeProp() ? getLeafInstances(instance.children()) : [instance],\n  )\n"],"mappings":"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","names":["elementData","documentKey"]}

package/dist/esm/runtimes/react/server/components/element-data.js

@@ -0,0 +1,64 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { partitionRecord } from "../../../../utils/partition";
+import {
+  getReactComponent,
+  getBreakpoints,
+  getComponentPropControllerDescriptors
+} from "../../../../state/read-only-state";
+import { FallbackComponent } from "../../../../components/shared/FallbackComponent";
+import { isLegacyDescriptor } from "../../../../prop-controllers/descriptors";
+import {
+  ServerCSSCollector,
+  createCollectingServerStylesheet,
+  InjectServerCSS
+} from "../css/server-css";
+import { getStore } from "../render-context";
+import { resolveProps } from "../resolve-props";
+async function ServerElementData({
+  documentKey,
+  context,
+  elementData,
+  injectedProps
+}) {
+  const state = getStore(context).getState();
+  const Component = getReactComponent(state, elementData.type);
+  if (Component == null) {
+    return /* @__PURE__ */ jsx(
+      FallbackComponent,
+      {
+        text: "Component not found",
+        details: `Unknown component '${elementData.type}'`
+      }
+    );
+  }
+  const [legacyDescriptors, definitions] = getControlDefs(state, elementData);
+  const legacyKeys = Object.keys(legacyDescriptors);
+  if (legacyKeys.length > 0) {
+    console.warn(`Unexpected legacy control data in server element '${elementData.key}`, {
+      elementData,
+      legacyKeys
+    });
+  }
+  const cssCollector = new ServerCSSCollector();
+  const stylesheet = createCollectingServerStylesheet(
+    cssCollector,
+    getBreakpoints(state),
+    elementData.key
+  );
+  const props = {
+    ...await resolveProps(context, elementData, documentKey, definitions, stylesheet),
+    ...injectedProps
+  };
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Component, { ...props }, elementData.key),
+    /* @__PURE__ */ jsx(InjectServerCSS, { collector: cssCollector, elementKey: elementData.key })
+  ] });
+}
+const getControlDefs = (state, elementData) => {
+  const descriptors = getComponentPropControllerDescriptors(state, elementData.type) ?? {};
+  return partitionRecord(descriptors, isLegacyDescriptor);
+};
+export {
+  ServerElementData
+};
+//# sourceMappingURL=element-data.js.map

package/dist/esm/runtimes/react/server/components/element-data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/runtimes/react/server/components/element-data.tsx"],"sourcesContent":["import { type ReactNode } from 'react'\n\nimport { partitionRecord } from '../../../../utils/partition'\n\nimport {\n  type State,\n  type ElementData,\n  getReactComponent,\n  getBreakpoints,\n  getComponentPropControllerDescriptors,\n} from '../../../../state/read-only-state'\n\nimport { FallbackComponent } from '../../../../components/shared/FallbackComponent'\nimport { isLegacyDescriptor } from '../../../../prop-controllers/descriptors'\n\nimport {\n  ServerCSSCollector,\n  createCollectingServerStylesheet,\n  InjectServerCSS,\n} from '../css/server-css'\nimport { type ServerRenderContext, getStore } from '../render-context'\nimport { resolveProps } from '../resolve-props'\n\nexport async function ServerElementData({\n  documentKey,\n  context,\n  elementData,\n  injectedProps,\n}: {\n  documentKey: string\n  context: ServerRenderContext\n  elementData: ElementData\n  injectedProps: Record<string, unknown>\n}): Promise<ReactNode> {\n  const state = getStore(context).getState()\n\n  const Component = getReactComponent(state, elementData.type)\n  if (Component == null) {\n    return (\n      <FallbackComponent\n        text=\"Component not found\"\n        details={`Unknown component '${elementData.type}'`}\n      />\n    )\n  }\n\n  const [legacyDescriptors, definitions] = getControlDefs(state, elementData)\n  const legacyKeys = Object.keys(legacyDescriptors)\n  if (legacyKeys.length > 0) {\n    console.warn(`Unexpected legacy control data in server element '${elementData.key}`, {\n      elementData,\n      legacyKeys,\n    })\n  }\n\n  const cssCollector = new ServerCSSCollector()\n  const stylesheet = createCollectingServerStylesheet(\n    cssCollector,\n    getBreakpoints(state),\n    elementData.key,\n  )\n\n  const props = {\n    ...(await resolveProps(context, elementData, documentKey, definitions, stylesheet)),\n    ...injectedProps,\n  }\n\n  return (\n    <>\n      {/* Make the component the first child so that `findDOMNode` resolves to its first\n        rendered DOM node (if any) rather than the component's `<style>` element */}\n      <Component key={elementData.key} {...props} />\n      <InjectServerCSS collector={cssCollector} elementKey={elementData.key} />\n    </>\n  )\n}\n\nconst getControlDefs = (state: State, elementData: ElementData) => {\n  const descriptors = getComponentPropControllerDescriptors(state, elementData.type) ?? {}\n  return partitionRecord(descriptors, isLegacyDescriptor)\n}\n"],"mappings":"AAuCM,SA6BF,UA7BE,KA6BF,YA7BE;AArCN,SAAS,uBAAuB;AAEhC;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,yBAAyB;AAClC,SAAS,0BAA0B;AAEnC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAmC,gBAAgB;AACnD,SAAS,oBAAoB;AAE7B,eAAsB,kBAAkB;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKuB;AACrB,QAAM,QAAQ,SAAS,OAAO,EAAE,SAAS;AAEzC,QAAM,YAAY,kBAAkB,OAAO,YAAY,IAAI;AAC3D,MAAI,aAAa,MAAM;AACrB,WACE;AAAA,MAAC;AAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAS,sBAAsB,YAAY,IAAI;AAAA;AAAA,IACjD;AAAA,EAEJ;AAEA,QAAM,CAAC,mBAAmB,WAAW,IAAI,eAAe,OAAO,WAAW;AAC1E,QAAM,aAAa,OAAO,KAAK,iBAAiB;AAChD,MAAI,WAAW,SAAS,GAAG;AACzB,YAAQ,KAAK,qDAAqD,YAAY,GAAG,IAAI;AAAA,MACnF;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,eAAe,IAAI,mBAAmB;AAC5C,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,eAAe,KAAK;AAAA,IACpB,YAAY;AAAA,EACd;AAEA,QAAM,QAAQ;AAAA,IACZ,GAAI,MAAM,aAAa,SAAS,aAAa,aAAa,aAAa,UAAU;AAAA,IACjF,GAAG;AAAA,EACL;AAEA,SACE,iCAGE;AAAA,wBAAC,aAAiC,GAAG,SAArB,YAAY,GAAgB;AAAA,IAC5C,oBAAC,mBAAgB,WAAW,cAAc,YAAY,YAAY,KAAK;AAAA,KACzE;AAEJ;AAEA,MAAM,iBAAiB,CAAC,OAAc,gBAA6B;AACjE,QAAM,cAAc,sCAAsC,OAAO,YAAY,IAAI,KAAK,CAAC;AACvF,SAAO,gBAAgB,aAAa,kBAAkB;AACxD;","names":[]}

package/dist/esm/runtimes/react/server/components/element.js

@@ -0,0 +1,56 @@
+import { jsx } from "react/jsx-runtime";
+import { mapValues } from "@makeswift/controls";
+import {
+  isElementReference,
+  getComponentsMeta
+} from "../../../../state/read-only-state";
+import { FallbackComponent } from "../../../../components/shared/FallbackComponent";
+import { Element as ClientElement } from "../../components/Element";
+import { getStore } from "../render-context";
+import { ServerElementData } from "./element-data";
+function ServerElement({
+  context,
+  element,
+  documentKey
+}) {
+  if (isElementReference(element)) {
+    return /* @__PURE__ */ jsx(FallbackComponent, { text: "Element reference is not supported on server yet" });
+  }
+  const state = getStore(context).getState();
+  const elementMeta = getComponentsMeta(state).get(element.type);
+  if (elementMeta == null) {
+    return /* @__PURE__ */ jsx(
+      FallbackComponent,
+      {
+        text: "Component not found",
+        details: `Missing component metadata for '${element.type}'`
+      }
+    );
+  }
+  const elementKey = element.key;
+  const isRSC = elementMeta.server ?? false;
+  if (!isRSC) {
+    return /* @__PURE__ */ jsx(ClientElement, { element }, elementKey);
+  }
+  const injectableProps = {
+    elementKey,
+    documentKey
+  };
+  const injectedProps = mapValues(
+    elementMeta.injectedProps ?? {},
+    (propName) => injectableProps[propName]
+  );
+  return /* @__PURE__ */ jsx(
+    ServerElementData,
+    {
+      documentKey,
+      context,
+      elementData: element,
+      injectedProps
+    }
+  );
+}
+export {
+  ServerElement
+};
+//# sourceMappingURL=element.js.map

package/dist/esm/runtimes/react/server/components/element.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/runtimes/react/server/components/element.tsx"],"sourcesContent":["import { ReactNode } from 'react'\n\nimport { mapValues } from '@makeswift/controls'\n\nimport {\n  isElementReference,\n  getComponentsMeta,\n  type Element as ElementDataOrRef,\n} from '../../../../state/read-only-state'\n\nimport { FallbackComponent } from '../../../../components/shared/FallbackComponent'\n\nimport { Element as ClientElement } from '../../components/Element'\n\nimport { type ServerRenderContext, getStore } from '../render-context'\nimport { type InjectableProps } from '../injectable-props'\n\nimport { ServerElementData } from './element-data'\n\nexport function ServerElement({\n  context,\n  element,\n  documentKey,\n}: {\n  context: ServerRenderContext\n  element: ElementDataOrRef\n  documentKey: string\n}): ReactNode {\n  // check for element references first to avoid looking them up as regular components\n  if (isElementReference(element)) {\n    return <FallbackComponent text=\"Element reference is not supported on server yet\" />\n  }\n\n  const state = getStore(context).getState()\n  const elementMeta = getComponentsMeta(state).get(element.type)\n  if (elementMeta == null) {\n    return (\n      <FallbackComponent\n        text=\"Component not found\"\n        details={`Missing component metadata for '${element.type}'`}\n      />\n    )\n  }\n\n  const elementKey = element.key\n  const isRSC = elementMeta.server ?? false\n  if (!isRSC) {\n    return <ClientElement key={elementKey} element={element} />\n  }\n\n  const injectableProps: InjectableProps = {\n    elementKey,\n    documentKey,\n  }\n\n  const injectedProps = mapValues(\n    elementMeta.injectedProps ?? {},\n    propName => injectableProps[propName],\n  )\n\n  return (\n    <ServerElementData\n      documentKey={documentKey}\n      context={context}\n      elementData={element}\n      injectedProps={injectedProps}\n    />\n  )\n}\n"],"mappings":"AA8BW;AA5BX,SAAS,iBAAiB;AAE1B;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,yBAAyB;AAElC,SAAS,WAAW,qBAAqB;AAEzC,SAAmC,gBAAgB;AAGnD,SAAS,yBAAyB;AAE3B,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AACF,GAIc;AAEZ,MAAI,mBAAmB,OAAO,GAAG;AAC/B,WAAO,oBAAC,qBAAkB,MAAK,oDAAmD;AAAA,EACpF;AAEA,QAAM,QAAQ,SAAS,OAAO,EAAE,SAAS;AACzC,QAAM,cAAc,kBAAkB,KAAK,EAAE,IAAI,QAAQ,IAAI;AAC7D,MAAI,eAAe,MAAM;AACvB,WACE;AAAA,MAAC;AAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAS,mCAAmC,QAAQ,IAAI;AAAA;AAAA,IAC1D;AAAA,EAEJ;AAEA,QAAM,aAAa,QAAQ;AAC3B,QAAM,QAAQ,YAAY,UAAU;AACpC,MAAI,CAAC,OAAO;AACV,WAAO,oBAAC,iBAA+B,WAAZ,UAA8B;AAAA,EAC3D;AAEA,QAAM,kBAAmC;AAAA,IACvC;AAAA,IACA;AAAA,EACF;AAEA,QAAM,gBAAgB;AAAA,IACpB,YAAY,iBAAiB,CAAC;AAAA,IAC9B,cAAY,gBAAgB,QAAQ;AAAA,EACtC;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA,aAAa;AAAA,MACb;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/esm/runtimes/react/server/components/makeswift-component.js

@@ -0,0 +1,8 @@
+import { jsx } from "react/jsx-runtime";
+import { MakeswiftComponent as MakeswiftClientComponent } from "../../components/MakeswiftComponent";
+import { RSCSnapshotRenderer } from "./snapshot-renderer";
+const MakeswiftComponent = (props) => /* @__PURE__ */ jsx(RSCSnapshotRenderer, { ...props, children: /* @__PURE__ */ jsx(MakeswiftClientComponent, { ...props }) });
+export {
+  MakeswiftComponent
+};
+//# sourceMappingURL=makeswift-component.js.map

package/dist/esm/runtimes/react/server/components/makeswift-component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/runtimes/react/server/components/makeswift-component.tsx"],"sourcesContent":["import { type ComponentProps } from 'react'\n\nimport { MakeswiftComponent as MakeswiftClientComponent } from '../../components/MakeswiftComponent'\n\nimport { RSCSnapshotRenderer } from './snapshot-renderer'\n\n/**\n * Renders Makeswift component snapshot with server-element support. RSC counterpart of\n * https://docs.makeswift.com/developer/docs/reference/components/makeswift-component#props\n */\nexport const MakeswiftComponent = (props: ComponentProps<typeof MakeswiftClientComponent>) => (\n  <RSCSnapshotRenderer {...props}>\n    <MakeswiftClientComponent {...props} />\n  </RSCSnapshotRenderer>\n)\n"],"mappings":"AAYI;AAVJ,SAAS,sBAAsB,gCAAgC;AAE/D,SAAS,2BAA2B;AAM7B,MAAM,qBAAqB,CAAC,UACjC,oBAAC,uBAAqB,GAAG,OACvB,8BAAC,4BAA0B,GAAG,OAAO,GACvC;","names":[]}

package/dist/esm/runtimes/react/server/components/renderer.js

@@ -0,0 +1,28 @@
+import { Fragment, jsx } from "react/jsx-runtime";
+import { getStore } from "../render-context";
+import { collectServerElements } from "../collect-server-elements";
+import { updateApiResourceCache } from "../update-api-resource-cache";
+import { ServerElementsProvider } from "./server-elements-cache";
+function RSCRenderer({
+  context,
+  document,
+  cacheData,
+  children
+}) {
+  const serverElements = collectServerElements(context, document, cacheData);
+  return /* @__PURE__ */ jsx(ServerElementsProvider, { elements: serverElements, children });
+}
+function RSCElementRenderer({
+  context,
+  cacheData,
+  children
+}) {
+  const store = getStore(context);
+  updateApiResourceCache(store, cacheData);
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+export {
+  RSCElementRenderer,
+  RSCRenderer
+};
+//# sourceMappingURL=renderer.js.map

package/dist/esm/runtimes/react/server/components/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/runtimes/react/server/components/renderer.tsx"],"sourcesContent":["import { type PropsWithChildren } from 'react'\n\nimport { type CacheData } from '../../../../api/api-resources-client'\nimport { type Document } from '../../../../state/modules/read-only-documents'\n\nimport { type ServerRenderContext, getStore } from '../render-context'\nimport { collectServerElements } from '../collect-server-elements'\nimport { updateApiResourceCache } from '../update-api-resource-cache'\n\nimport { ServerElementsProvider } from './server-elements-cache'\n\n/**\n * Helper for rendering a Makeswift document containing server elements. Makes\n * the server-rendered nodes available to the client renderer and enables\n * client-side style updates for editable server elements.\n */\nexport function RSCRenderer({\n  context,\n  document,\n  cacheData,\n  children,\n}: PropsWithChildren<{ context: ServerRenderContext; document: Document; cacheData: CacheData }>) {\n  const serverElements = collectServerElements(context, document, cacheData)\n\n  return <ServerElementsProvider elements={serverElements}>{children}</ServerElementsProvider>\n}\n\n/**\n * Helper for (re-)rendering an isolated server element. Updates the server\n * state with the context's API resource cache.\n */\nexport function RSCElementRenderer({\n  context,\n  cacheData,\n  children,\n}: PropsWithChildren<{ context: ServerRenderContext; cacheData: CacheData }>) {\n  const store = getStore(context)\n\n  updateApiResourceCache(store, cacheData)\n  return <>{children}</>\n}\n"],"mappings":"AAwBS,SAeA,UAfA;AAnBT,SAAmC,gBAAgB;AACnD,SAAS,6BAA6B;AACtC,SAAS,8BAA8B;AAEvC,SAAS,8BAA8B;AAOhC,SAAS,YAAY;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAkG;AAChG,QAAM,iBAAiB,sBAAsB,SAAS,UAAU,SAAS;AAEzE,SAAO,oBAAC,0BAAuB,UAAU,gBAAiB,UAAS;AACrE;AAMO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AACF,GAA8E;AAC5E,QAAM,QAAQ,SAAS,OAAO;AAE9B,yBAAuB,OAAO,SAAS;AACvC,SAAO,gCAAG,UAAS;AACrB;","names":[]}