@wix/zero-config-implementation 1.7.0 → 1.8.0

package/dist/information-extractors/react/extractors/core/index.d.ts

@@ -1,6 +1,6 @@
 export { ExtractorStore } from './store';
 export { runExtractors } from './runner';
-export type { ExtractionResult } from './runner';
+export type { ExtractionResult, RunExtractorsOptions } from './runner';
 export { buildElementTree } from './tree-builder';
 export type { ExtractedElement } from './tree-builder';
 export type { ReactExtractor, RenderContext, CreateElementEvent, RenderCompleteEvent } from './types';

package/dist/information-extractors/react/extractors/core/runner.d.ts

@@ -8,6 +8,10 @@ export interface ExtractionResult {
     store: ExtractorStore;
     elements: ExtractedElement[];
 }
+export interface RunExtractorsOptions {
+    /** Optional HOC to wrap the component before rendering (e.g. a context provider). */
+    wrapper?: (component: ComponentType<unknown>) => ComponentType<unknown>;
+}
 /**
  * Runs extractors through the full lifecycle and returns extraction results.
  *
@@ -16,4 +20,4 @@ export interface ExtractionResult {
  * @param extractors - Array of extractors to run
  * @returns Extraction results including HTML, store, and element tree
  */
-export declare function runExtractors(componentInfo: ComponentInfo, component: ComponentType<unknown>, extractors: ReactExtractor[]): ExtractionResult;
+export declare function runExtractors(componentInfo: ComponentInfo, component: ComponentType<unknown>, extractors: ReactExtractor[], options?: RunExtractorsOptions): ExtractionResult;

package/dist/information-extractors/react/extractors/index.d.ts

@@ -4,7 +4,7 @@
  * Core infrastructure and pluggable extractors for the React information extraction system.
  */
 export { ExtractorStore, runExtractors, buildElementTree, } from './core';
-export type { ExtractionResult, ExtractedElement, ReactExtractor, RenderContext, CreateElementEvent, RenderCompleteEvent, } from './core';
+export type { ExtractionResult, RunExtractorsOptions, ExtractedElement, ReactExtractor, RenderContext, CreateElementEvent, RenderCompleteEvent, } from './core';
 export { createPropTrackerExtractor } from './prop-tracker';
 export type { PropTrackerData, PropTrackerExtractorState } from './prop-tracker';
 export { createCssPropertiesExtractor } from './css-properties';

package/dist/information-extractors/react/index.d.ts

@@ -4,6 +4,6 @@
  * API: runExtractors() with pluggable extractors
  */
 export { ExtractorStore, runExtractors, buildElementTree, createPropTrackerExtractor, createCssPropertiesExtractor, } from './extractors';
-export type { ExtractionResult, ExtractedElement, ReactExtractor, RenderContext, CreateElementEvent, RenderCompleteEvent, PropTrackerData, PropTrackerExtractorState, CssPropertiesData, } from './extractors';
+export type { ExtractionResult, RunExtractorsOptions, ExtractedElement, ReactExtractor, RenderContext, CreateElementEvent, RenderCompleteEvent, PropTrackerData, PropTrackerExtractorState, CssPropertiesData, } from './extractors';
 export type { CoupledComponentInfo, CoupledProp, TrackingStores, DOMBinding, PropReadInfo, PropWriteInfo, PropSpyMeta, } from './types';
 export type { PropSpyContext } from './utils/prop-spy';

package/dist/manifest-pipeline.d.ts

@@ -1,5 +1,5 @@
 import { ComponentInfo } from './information-extractors/ts';
-import { CoupledComponentInfo } from './information-extractors/react';
+import { RunExtractorsOptions, CoupledComponentInfo } from './information-extractors/react';
 import { CSSParserAPI } from './information-extractors/css';
 import { ComponentType } from 'react';
 /** A non-fatal issue encountered during component processing. */
@@ -30,4 +30,4 @@ export interface ProcessComponentResult {
  * encountered during processing. Always returns a component, falling back
  * to minimal info (without DOM coupling) when rendering fails.
  */
-export declare function processComponent(componentInfo: ComponentInfo, loadComponent: (componentName: string) => ComponentType<unknown> | null, cssImportPaths: string[], loaderHasError?: boolean): ProcessComponentResult;
+export declare function processComponent(componentInfo: ComponentInfo, loadComponent: (componentName: string) => ComponentType<unknown> | null, cssImportPaths: string[], loaderHasError?: boolean, options?: RunExtractorsOptions): ProcessComponentResult;

package/package.json

@@ -4,7 +4,7 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Core library for extracting component manifests from JS and CSS files",
   "type": "module",
   "main": "dist/index.js",
@@ -74,5 +74,5 @@
       ]
     }
   },
-  "falconPackageHash": "95c3bb44ab2a1406f75946ef5d30cec9f4ce31059113151e31289d75"
+  "falconPackageHash": "8ca973dc7cc82c6e8d0a333de6717b866e33337ee211bd335f3fa800"
 }

package/src/index.ts

@@ -13,6 +13,7 @@ import { type NotFoundError, ParseError } from './errors'
 // Component loader helpers
 import { findComponent, loadModule } from './module-loader'
 
+import type { RunExtractorsOptions } from './information-extractors/react'
 // Pipeline orchestration
 import { processComponent } from './manifest-pipeline'
 export type {
@@ -36,6 +37,8 @@ export interface ManifestResult {
   errors: ExtractionError[]
 }
 
+export type { RunExtractorsOptions } from './information-extractors/react'
+
 export interface ExtractionError {
   componentName: string
   phase: 'render' | 'coupling' | 'css' | 'loader' | 'conversion'
@@ -59,6 +62,7 @@ export interface ExtractionError {
 export function extractComponentManifest(
   componentPath: string,
   compiledEntryPath: string,
+  options?: RunExtractorsOptions,
 ): ResultAsync<ManifestResult, InstanceType<typeof NotFoundError> | InstanceType<typeof ParseError>> {
   // Step 1: Load the compiled package module (non-fatal)
   return loadModule(compiledEntryPath)
@@ -126,7 +130,7 @@ export function extractComponentManifest(
           }
 
           // Step 5: Process the default-exported component (non-fatal)
-          const processResult = processComponent(componentInfo, loadComponent, cssImportPaths, !!loaderError)
+          const processResult = processComponent(componentInfo, loadComponent, cssImportPaths, !!loaderError, options)
           errors.push(...processResult.warnings)
           const component = toEditorReactComponent(processResult.component)
 

package/src/information-extractors/react/extractors/core/index.ts

@@ -1,6 +1,6 @@
 export { ExtractorStore } from './store'
 export { runExtractors } from './runner'
-export type { ExtractionResult } from './runner'
+export type { ExtractionResult, RunExtractorsOptions } from './runner'
 export { buildElementTree } from './tree-builder'
 export type { ExtractedElement } from './tree-builder'
 export type { ReactExtractor, RenderContext, CreateElementEvent, RenderCompleteEvent } from './types'

package/src/information-extractors/react/extractors/core/runner.ts

@@ -27,6 +27,11 @@ export interface ExtractionResult {
   elements: ExtractedElement[]
 }
 
+export interface RunExtractorsOptions {
+  /** Optional HOC to wrap the component before rendering (e.g. a context provider). */
+  wrapper?: (component: ComponentType<unknown>) => ComponentType<unknown>
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Runner
 // ─────────────────────────────────────────────────────────────────────────────
@@ -43,6 +48,7 @@ export function runExtractors(
   componentInfo: ComponentInfo,
   component: ComponentType<unknown>,
   extractors: ReactExtractor[],
+  options?: RunExtractorsOptions,
 ): ExtractionResult {
   // Reset mock counter for reproducible results
   resetMockCounter()
@@ -74,8 +80,11 @@ export function runExtractors(
     },
   ]
 
+  // Apply optional HOC wrapper before rendering
+  const renderComponent = options?.wrapper ? options.wrapper(context.component) : context.component
+
   // Phase 2: Render with element creation interception
-  const html = renderWithExtractors(context.component, context.props, listeners, store)
+  const html = renderWithExtractors(renderComponent, context.props, listeners, store)
 
   // Phase 3: renderComplete - extractors can post-process
   for (const ext of extractors) {

package/src/information-extractors/react/extractors/index.ts

@@ -12,6 +12,7 @@ export {
 } from './core'
 export type {
   ExtractionResult,
+  RunExtractorsOptions,
   ExtractedElement,
   ReactExtractor,
   RenderContext,

package/src/information-extractors/react/index.ts

@@ -21,6 +21,7 @@ export {
 export type {
   // Core types
   ExtractionResult,
+  RunExtractorsOptions,
   ExtractedElement,
   ReactExtractor,
   RenderContext,

package/src/manifest-pipeline.ts

@@ -6,6 +6,7 @@ import type { PropInfo } from './information-extractors/ts/types'
 import {
   type ExtractedElement,
   type PropTrackerData,
+  type RunExtractorsOptions,
   createCssPropertiesExtractor,
   createPropTrackerExtractor,
   runExtractors,
@@ -62,6 +63,7 @@ export function processComponent(
   loadComponent: (componentName: string) => ComponentType<unknown> | null,
   cssImportPaths: string[],
   loaderHasError?: boolean,
+  options?: RunExtractorsOptions,
 ): ProcessComponentResult {
   const warnings: ExtractionWarning[] = []
 
@@ -97,7 +99,7 @@ export function processComponent(
       const { extractor: propTracker, state } = createPropTrackerExtractor()
       const cssExtractor = createCssPropertiesExtractor()
 
-      const result = runExtractors(componentInfo, Component, [propTracker, cssExtractor])
+      const result = runExtractors(componentInfo, Component, [propTracker, cssExtractor], options)
       html = result.html
       extractedElements = result.elements