@wix/zero-config-implementation 1.56.0 → 1.58.0

package/package.json

@@ -4,7 +4,7 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "1.56.0",
+  "version": "1.58.0",
   "description": "Core library for extracting component manifests from JS and CSS files",
   "type": "module",
   "main": "dist/index.js",
@@ -44,7 +44,7 @@
     }
   },
   "dependencies": {
-    "@wix/react-component-schema": "1.4.0"
+    "@wix/react-component-schema": "1.5.0"
   },
   "devDependencies": {
     "@faker-js/faker": "^10.2.0",
@@ -85,5 +85,5 @@
       ]
     }
   },
-  "falconPackageHash": "c722dc94711a8f4d847418798ee8cd054109120e9f3075d641f33fa5"
+  "falconPackageHash": "f7fcdc7c7a9bd8348098a4e3301700ca40fb26281cd6352c13146b45"
 }

package/src/component-renderer.ts

@@ -30,8 +30,11 @@
  *    location on disk — a separate React module instance. To cover this case,
  *    the renderer also calls `createRequire(compiledEntryPath)` to obtain the
  *    user-bundle's React (and `react/jsx-runtime` / `react/jsx-dev-runtime`)
- *    and applies the same interceptors to those modules' exports. Identity
- *    guards keep the single-React case a no-op.
+ *    and applies the same interceptors to those modules' exports. It also
+ *    drives SSR with the user-bundle's `react-dom/server` so the dispatcher
+ *    lands on the user React's internals — the same instance the user
+ *    component reads from — and hooks like `useState` work naturally.
+ *    Identity guards keep the single-React case a no-op.
  *
  * ## Intercepted Functions
  *
@@ -134,8 +137,9 @@ function createInterceptor(
  * @param store - Shared ExtractorStore, included in each CreateElementEvent
  * @param compiledEntryPath - Optional path to the user's compiled bundle. When
  *        provided, the renderer additionally patches the React module instance
- *        that the bundle resolves from its own `node_modules` (covers cases
- *        where the host bundles its own React separately from the user's).
+ *        that the bundle resolves from its own `node_modules` and drives SSR
+ *        with the user-bundle's `react-dom/server` (required when the host
+ *        bundles its own React; otherwise hooks crash).
  * @returns Static HTML string with trace IDs on DOM elements
  *
  * @example
@@ -174,9 +178,11 @@ export function renderWithExtractors(
   // Resolve the user-bundle's React (and jsx-runtime variants) from the bundle's
   // own location on disk. When the host (e.g. a CLI) bundled its own React, this
   // resolves to a different module instance and must be patched separately.
-  // Identity guards below skip patching when the resolved modules are the same
-  // objects already covered by the host-side patches.
+  // When the user's React is distinct, also resolve its `react-dom/server` and
+  // drive SSR with that — the dispatcher then lands on the same React instance
+  // the user component reads from, so hooks like `useState` work naturally.
   let userReact: { createElement: ElementCreator } | undefined
+  let userRenderToStaticMarkup: typeof renderToStaticMarkup | undefined
   let userJsxRuntime: Record<string, unknown> | undefined
   let userJsxDevRuntime: Record<string, unknown> | undefined
   let origUserCreateElement: ElementCreator | undefined
@@ -191,6 +197,16 @@ export function renderWithExtractors(
       if (candidateReact !== (React as unknown as typeof candidateReact)) {
         userReact = candidateReact
         origUserCreateElement = candidateReact.createElement
+        try {
+          userRenderToStaticMarkup = (
+            userRequire('react-dom/server') as { renderToStaticMarkup: typeof renderToStaticMarkup }
+          ).renderToStaticMarkup
+        } catch (cause) {
+          throw new Error(
+            `Component bundle at "${compiledEntryPath}" resolves a different React than the host; install "react-dom" alongside "react" so SSR can run against the user's React.`,
+            { cause: cause as Error },
+          )
+        }
       }
       const candidateJsx = userRequire('react/jsx-runtime') as Record<string, unknown>
       if (candidateJsx !== cjsRuntime) {
@@ -203,8 +219,10 @@ export function renderWithExtractors(
         userJsxDevRuntime = candidateJsxDev
         origUserJsxDEV = candidateJsxDev.jsxDEV
       }
-    } catch {
-      // user bundle path doesn't resolve react locally — nothing to patch
+    } catch (error) {
+      // The wrapped react-dom error has userReact set; rethrow it.
+      // Otherwise the user bundle path doesn't resolve react locally — nothing to patch.
+      if (userReact) throw error
     }
   }
 
@@ -245,8 +263,9 @@ export function renderWithExtractors(
       userJsxDevRuntime.jsxDEV = interceptedJsxDEV
     }
 
-    const element = React.createElement(Component, componentProps as Record<string, unknown>)
-    return renderToStaticMarkup(element)
+    const renderingReact = userReact ?? React
+    const element = renderingReact.createElement(Component, componentProps as Record<string, unknown>)
+    return (userRenderToStaticMarkup ?? renderToStaticMarkup)(element)
   } finally {
     // Restore originals
     React.createElement = originalCreateElement

package/src/converters/data-item-builder.test.ts

@@ -49,7 +49,7 @@ describe('buildDataItem — arrayItems oneof branching', () => {
     const semanticImage: ResolvedType = {
       kind: 'semantic',
       value: 'Image',
-      source: '@wix/public-schemas',
+      source: '@wix/editor-react-types',
     }
     const result = buildDataItem(buildArrayProp(semanticImage))
     expect(result.isOk()).toBe(true)

package/src/converters/data-item-builder.ts

@@ -344,7 +344,7 @@ function handleUnionType(
 }
 
 /**
- * Handles semantic types from React and @wix/public-schemas packages.
+ * Handles semantic types from React and @wix/editor-react-types packages.
  * Unknown semantic sources or types silently fall back to text.
  */
 function handleSemanticType({
@@ -372,8 +372,8 @@ function handleSemanticType({
     return
   }
 
-  // Wix public-schemas (Builder) types - map directly to DATA_TYPE via explicit lookup
-  if (source === '@wix/public-schemas' || source === '@wix/editor-react-types') {
+  // Wix editor-react-types (Builder) types - map directly to DATA_TYPE via explicit lookup
+  if (source === '@wix/editor-react-types') {
     const dataTypeKey = WIX_TYPE_TO_DATA_TYPE[semanticValue]
     if (dataTypeKey) {
       dataItem.dataType = DATA_TYPE[dataTypeKey]

package/src/information-extractors/react/utils/mock-generator.ts

@@ -383,7 +383,7 @@ function generateMockLink(): Record<string, unknown> {
   }
 }
 
-// String fields and string-literal-union fields of @wix/public-schemas A11y.
+// String fields and string-literal-union fields of @wix/editor-react-types A11y.
 // These are emitted as unique trackable strings — DOM/React will accept any
 // string for `aria-*` attributes regardless of the TS type union, so the spy
 // markers flow through unchanged and the prop-tracker can detect usage.
@@ -412,7 +412,7 @@ const A11Y_STRING_FIELDS = [
   'ariaInvalid',
 ] as const
 
-// Numeric fields of @wix/public-schemas A11y.
+// Numeric fields of @wix/editor-react-types A11y.
 const A11Y_NUMBER_FIELDS = ['tabIndex', 'ariaLevel'] as const
 
 // Pure-boolean A11y fields (e.g. `multiline`) are intentionally omitted: the

package/src/information-extractors/ts/utils/semantic-type-resolver.ts

@@ -74,7 +74,7 @@ function checkForSemanticType(
   }
 
   // Check Wix types - only ones that map to DATA_TYPE keys
-  if (packageName === '@wix/public-schemas' || packageName === '@wix/editor-react-types') {
+  if (packageName === '@wix/editor-react-types') {
     if (isValidWixSemanticType(symbolName)) {
       return { kind: 'semantic', value: symbolName, source: packageName }
     }
@@ -196,7 +196,7 @@ function resolveTypeBody({
     }
 
     // Check Wix types - only ones that map to DATA_TYPE keys
-    if (packageName === '@wix/public-schemas' || packageName === '@wix/editor-react-types') {
+    if (packageName === '@wix/editor-react-types') {
       if (isValidWixSemanticType(typeString)) {
         return {
           kind: 'semantic',

package/src/wix-type-to-data-type.ts

@@ -1,8 +1,8 @@
 import type { DATA } from '@wix/react-component-schema'
 
 /**
- * Maps @wix/public-schemas type names (PascalCase) to their DATA_TYPE keys.
- * Derived from the exports of @wix/public-schemas.
+ * Maps @wix/editor-react-types type names (PascalCase) to their DATA_TYPE keys.
+ * Derived from the exports of @wix/editor-react-types.
  */
 export const WIX_TYPE_TO_DATA_TYPE: Record<string, keyof typeof DATA.DATA_TYPE> = {
   Link: 'link',