@codepress/codepress-engine 0.7.11-dev.refactor-cpprovider.20251203054856 → 0.8.0-dev.jsmap.20251204045505

package/dist/CPRefreshProvider.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CPRefreshProvider - Root-level refresh provider for CodePress HMR
+ *
+ * NOTE: By default, you don't need to manually add this provider.
+ * The CodePress SWC/Babel plugin automatically injects it at app entry points:
+ * - Next.js Pages Router: pages/_app.tsx
+ * - Next.js App Router: app/layout.tsx
+ * - Vite/CRA: src/main.tsx or src/index.tsx
+ *
+ * When `window.__CP_triggerRefresh()` is called, all components under this provider will re-render.
+ *
+ * To disable auto-injection, set `autoInjectRefreshProvider: false` in the plugin config:
+ * ```js
+ * // next.config.js
+ * experimental: {
+ *   swcPlugins: [['@codepress/codepress-engine/swc', { autoInjectRefreshProvider: false }]]
+ * }
+ * ```
+ *
+ * Then manually add the provider:
+ * ```tsx
+ * import { CPRefreshProvider } from '@codepress/codepress-engine/refresh-provider';
+ *
+ * export default function App({ children }) {
+ *   return <CPRefreshProvider>{children}</CPRefreshProvider>;
+ * }
+ * ```
+ */
+import React, { ReactNode } from 'react';
+export declare const CPRefreshContext: React.Context<number>;
+interface CPRefreshProviderProps {
+    children: ReactNode;
+}
+/**
+ * Root-level provider that triggers re-renders when CP_PREVIEW_REFRESH event fires.
+ * Only one instance of this provider is needed at the app root.
+ */
+export declare function CPRefreshProvider({ children }: CPRefreshProviderProps): import("react/jsx-runtime").JSX.Element;
+declare global {
+    interface Window {
+        __CP_triggerRefresh?: () => void;
+    }
+}
+export default CPRefreshProvider;

package/dist/CPRefreshProvider.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CPRefreshContext = void 0;
+exports.CPRefreshProvider = CPRefreshProvider;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * CPRefreshProvider - Root-level refresh provider for CodePress HMR
+ *
+ * NOTE: By default, you don't need to manually add this provider.
+ * The CodePress SWC/Babel plugin automatically injects it at app entry points:
+ * - Next.js Pages Router: pages/_app.tsx
+ * - Next.js App Router: app/layout.tsx
+ * - Vite/CRA: src/main.tsx or src/index.tsx
+ *
+ * When `window.__CP_triggerRefresh()` is called, all components under this provider will re-render.
+ *
+ * To disable auto-injection, set `autoInjectRefreshProvider: false` in the plugin config:
+ * ```js
+ * // next.config.js
+ * experimental: {
+ *   swcPlugins: [['@codepress/codepress-engine/swc', { autoInjectRefreshProvider: false }]]
+ * }
+ * ```
+ *
+ * Then manually add the provider:
+ * ```tsx
+ * import { CPRefreshProvider } from '@codepress/codepress-engine/refresh-provider';
+ *
+ * export default function App({ children }) {
+ *   return <CPRefreshProvider>{children}</CPRefreshProvider>;
+ * }
+ * ```
+ */
+const react_1 = require("react");
+// Module-level version counter that persists across renders
+let __cpVersion = 0;
+// Context for components that want to subscribe to refresh events
+exports.CPRefreshContext = (0, react_1.createContext)(0);
+/**
+ * Root-level provider that triggers re-renders when CP_PREVIEW_REFRESH event fires.
+ * Only one instance of this provider is needed at the app root.
+ */
+function CPRefreshProvider({ children }) {
+    const version = (0, react_1.useSyncExternalStore)((callback) => {
+        if (typeof window === 'undefined') {
+            return () => { };
+        }
+        const handler = () => {
+            __cpVersion = __cpVersion + 1;
+            callback();
+        };
+        window.addEventListener('CP_PREVIEW_REFRESH', handler);
+        // Also expose the trigger function globally
+        if (!window.__CP_triggerRefresh) {
+            window.__CP_triggerRefresh = () => {
+                window.dispatchEvent(new CustomEvent('CP_PREVIEW_REFRESH'));
+            };
+            // Mark that this function dispatches the preview event
+            window.__CP_triggerRefresh.__cp_dispatches_preview = true;
+        }
+        return () => {
+            window.removeEventListener('CP_PREVIEW_REFRESH', handler);
+        };
+    }, () => __cpVersion, () => 0 // Server snapshot
+    );
+    return ((0, jsx_runtime_1.jsx)(exports.CPRefreshContext.Provider, { value: version, children: children }));
+}
+exports.default = CPRefreshProvider;
+//# sourceMappingURL=CPRefreshProvider.js.map

package/dist/CPRefreshProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CPRefreshProvider.js","sourceRoot":"","sources":["../src/CPRefreshProvider.tsx"],"names":[],"mappings":";;;AA6CA,8CAoCC;;AAjFD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,iCAA8E;AAE9E,4DAA4D;AAC5D,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,kEAAkE;AACrD,QAAA,gBAAgB,GAAG,IAAA,qBAAa,EAAS,CAAC,CAAC,CAAC;AAMzD;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAA0B;IACpE,MAAM,OAAO,GAAG,IAAA,4BAAoB,EAClC,CAAC,QAAoB,EAAE,EAAE;QACvB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,WAAW,GAAG,WAAW,GAAG,CAAC,CAAC;YAC9B,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAEvD,4CAA4C;QAC5C,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAChC,MAAM,CAAC,mBAAmB,GAAG,GAAG,EAAE;gBAChC,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAC9D,CAAC,CAAC;YACF,uDAAuD;YACtD,MAAM,CAAC,mBAA2B,CAAC,uBAAuB,GAAG,IAAI,CAAC;QACrE,CAAC;QAED,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC,EACD,GAAG,EAAE,CAAC,WAAW,EACjB,GAAG,EAAE,CAAC,CAAC,CAAC,kBAAkB;KAC3B,CAAC;IAEF,OAAO,CACL,uBAAC,wBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YACtC,QAAQ,GACiB,CAC7B,CAAC;AACJ,CAAC;AASD,kBAAe,iBAAiB,CAAC"}

package/dist/esbuild-plugin.d.ts

@@ -1,6 +1,9 @@
 /**
- * CodePress esbuild plugin - Injects tracking attributes and provider wrappers into JSX
- * Replaces the Rust SWC plugin with a pure JavaScript implementation
+ * CodePress esbuild plugin - Injects tracking attributes into JSX
+ *
+ * This plugin adds codepress-data-fp attributes to JSX elements for element identification.
+ * HMR is handled separately by a single root-level provider (CPRefreshProvider) that users
+ * add to their app entry point, rather than wrapping every component.
  */
 import type { Plugin } from 'esbuild';
 interface CodePressPluginOptions {

package/dist/esbuild-plugin.js

@@ -1,7 +1,10 @@
 "use strict";
 /**
- * CodePress esbuild plugin - Injects tracking attributes and provider wrappers into JSX
- * Replaces the Rust SWC plugin with a pure JavaScript implementation
+ * CodePress esbuild plugin - Injects tracking attributes into JSX
+ *
+ * This plugin adds codepress-data-fp attributes to JSX elements for element identification.
+ * HMR is handled separately by a single root-level provider (CPRefreshProvider) that users
+ * add to their app entry point, rather than wrapping every component.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -95,60 +98,6 @@ function injectJSXAttributes(source, encoded, repoName, branchName) {
     }
     return output.join('\n');
 }
-/**
- * Wrap exported components with __CPProvider
- */
-function wrapWithProvider(source) {
-    var _a;
-    // Find default export component
-    const defaultExportMatch = source.match(/export\s+default\s+function\s+(\w+)/);
-    if (!defaultExportMatch) {
-        // Try: export default ComponentName;
-        const namedMatch = source.match(/export\s+default\s+(\w+);/);
-        if (!namedMatch)
-            return source;
-    }
-    const componentName = (defaultExportMatch === null || defaultExportMatch === void 0 ? void 0 : defaultExportMatch[1]) || ((_a = source.match(/export\s+default\s+(\w+);/)) === null || _a === void 0 ? void 0 : _a[1]);
-    if (!componentName)
-        return source;
-    // Inject provider wrapper code at the top
-    const providerCode = `
-import { useSyncExternalStore } from 'react';
-
-// Module-level version counter for HMR
-let __cpvVersion = 0;
-
-// Provider component that wraps the default export
-function __CPProvider({ value, children }: { value?: any; children: React.ReactNode }) {
-  const __cpv = useSyncExternalStore(
-    (cb) => {
-      const h = () => {
-        __cpvVersion = __cpvVersion + 1;
-        cb();
-      };
-      if (typeof window !== 'undefined') {
-        window.addEventListener("CP_PREVIEW_REFRESH", h);
-        return () => { window.removeEventListener("CP_PREVIEW_REFRESH", h); };
-      }
-      return () => {};
-    },
-    () => __cpvVersion,
-    () => 0
-  );
-
-  return <CPX.Provider value={value} key={__cpv}>{children}</CPX.Provider>;
-}
-
-// Context for passing data through provider
-const CPX = { Provider: ({ value, children }: any) => children };
-`;
-    // Wrap the default export
-    const wrappedSource = source.replace(new RegExp(`export\\s+default\\s+${componentName}`), `const __Original${componentName} = ${componentName};
-export default function ${componentName}(props: any) {
-  return <__CPProvider><__Original${componentName} {...props} /></__CPProvider>;
-}`);
-    return providerCode + '\n' + wrappedSource;
-}
 function createCodePressPlugin(options = {}) {
     const { repo_name = '', branch_name = '', repo_root = process.cwd(), } = options;
     return {
@@ -167,12 +116,9 @@ function createCodePressPlugin(options = {}) {
                     if (!encoded) {
                         return { contents: source, loader: 'tsx' };
                     }
-                    // Step 1: Inject JSX attributes
-                    let transformed = injectJSXAttributes(source, encoded, repo_name, branch_name);
-                    // Step 2: Wrap with provider (for default exports)
-                    if (transformed.includes('export default')) {
-                        transformed = wrapWithProvider(transformed);
-                    }
+                    // Inject JSX attributes (codepress-data-fp)
+                    // HMR is handled by a root-level CPRefreshProvider, not per-component wrapping
+                    const transformed = injectJSXAttributes(source, encoded, repo_name, branch_name);
                     return {
                         contents: transformed,
                         loader: 'tsx',

package/dist/esbuild-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"esbuild-plugin.js","sourceRoot":"","sources":["../src/esbuild-plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"esbuild-plugin.js","sourceRoot":"","sources":["../src/esbuild-plugin.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgFH,sDAyCC;AAvHD,uCAAyB;AACzB,2CAA6B;AAS7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;AAEzD,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG;SACP,QAAQ,CAAC,QAAQ,CAAC;SAClB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAAc,EAAE,OAAe,EAAE,QAAiB,EAAE,UAAmB;IAClG,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;QAEV,kEAAkE;QAClE,+CAA+C;QAC/C,IACE,iDAAiD,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5D,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;YAChC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,2CAA2C;UAC9E,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QAED,gDAAgD;QAChD,qGAAqG;QACrG,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAC/B,0EAA0E,EAC1E,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,mBAAmB;YACnB,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,sBAAsB,OAAO,IAAI,OAAO,IAAI,OAAO,GAAG,CAAC,CAAC;YAEnE,oEAAoE;YACpE,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,IAAI,QAAQ,EAAE,CAAC;oBACb,KAAK,CAAC,IAAI,CAAC,+BAA+B,QAAQ,GAAG,CAAC,CAAC;gBACzD,CAAC;gBACD,IAAI,UAAU,EAAE,CAAC;oBACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,UAAU,GAAG,CAAC,CAAC;gBACxD,CAAC;YACH,CAAC;YAED,OAAO,GAAG,MAAM,IAAI,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC;QAC3D,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,SAAgB,qBAAqB,CAAC,UAAkC,EAAE;IACxE,MAAM,EACJ,SAAS,GAAG,EAAE,EACd,WAAW,GAAG,EAAE,EAChB,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,GAC1B,GAAG,OAAO,CAAC;IAEZ,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,KAAK,CAAC,KAAK;YACT,0BAA0B;YAC1B,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACnD,IAAI,CAAC;oBACH,oBAAoB;oBACpB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;wBACvC,OAAO,IAAI,CAAC;oBACd,CAAC;oBAED,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;oBAEvC,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;oBAC7C,CAAC;oBAED,4CAA4C;oBAC5C,+EAA+E;oBAC/E,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;oBAEjF,OAAO;wBACL,QAAQ,EAAE,WAAW;wBACrB,MAAM,EAAE,KAAK;qBACd,CAAC;gBACJ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;oBACvE,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kBAAe,qBAAqB,CAAC"}

package/dist/types.d.ts

@@ -14,4 +14,48 @@ export interface CodePressPluginOptions {
      * Used by CodePress HMR to substitute env vars in dynamically built modules.
      */
     env_vars?: Record<string, string>;
+    /**
+     * Store metadata in window.__CODEPRESS_MAP__ instead of DOM attributes.
+     * When true, only codepress-data-fp attribute is added to DOM.
+     * This avoids React reconciliation issues and keeps DOM clean.
+     * Defaults to true.
+     */
+    useJsMetadataMap?: boolean;
+    /**
+     * Automatically inject the refresh provider at detected app entry points.
+     * Defaults to true.
+     *
+     * When enabled, the plugin detects and wraps these entry points:
+     * - Next.js Pages Router: pages/_app.tsx
+     * - Next.js App Router: app/layout.tsx (root layout)
+     * - Vite/CRA: src/main.tsx or src/index.tsx
+     *
+     * Set to false to disable auto-injection. You'll need to manually add
+     * the refresh provider:
+     *
+     * ```tsx
+     * import { CPRefreshProvider } from '@codepress/codepress-engine/refresh-provider';
+     *
+     * export default function App({ children }) {
+     *   return <CPRefreshProvider>{children}</CPRefreshProvider>;
+     * }
+     * ```
+     *
+     * Reasons to disable:
+     * - Monorepos with library packages that match entry point patterns
+     * - Custom entry points not detected automatically
+     * - Full control over where the provider is placed
+     */
+    autoInjectRefreshProvider?: boolean;
+    /**
+     * Skip wrapping custom components with __CPProvider.
+     * When useJsMetadataMap is true (the default), this is automatically set to true.
+     * @deprecated This is now automatically determined by useJsMetadataMap
+     */
+    skipProviderWrap?: boolean;
+    /**
+     * Skip wrapping custom components with <codepress-marker>.
+     * Only used when useJsMetadataMap is false.
+     */
+    skipMarkerWrap?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codepress/codepress-engine",
-  "version": "0.7.11-dev.refactor-cpprovider.20251203054856",
+  "version": "0.8.0-dev.jsmap.20251204045505",
   "packageManager": "pnpm@10.22.0",
   "description": "CodePress engine - Babel and SWC plug-ins",
   "main": "./dist/index.js",
@@ -41,6 +41,11 @@
       "require": "./dist/webpack-plugin.js",
       "default": "./dist/webpack-plugin.js"
     },
+    "./refresh-provider": {
+      "types": "./dist/CPRefreshProvider.d.ts",
+      "require": "./dist/CPRefreshProvider.js",
+      "default": "./dist/CPRefreshProvider.js"
+    },
     "./swc/wasm": "./swc/codepress_engine.v42.wasm",
     "./swc/wasm-v42": "./swc/codepress_engine.v42.wasm",
     "./swc/wasm-v26": "./swc/codepress_engine.v26.wasm",
@@ -89,7 +94,16 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@babel/core": "^7.0.0"
+    "@babel/core": "^7.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@babel/core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@babel/cli": "^7.26.0",
@@ -105,6 +119,7 @@
     "@types/babel__core": "^7.20.5",
     "@types/jest": "^30.0.0",
     "@types/node": "^22.9.0",
+    "@types/react": "^19.0.0",
     "@types/node-fetch": "^2.6.11",
     "@types/webpack": "^5.28.5",
     "babel-jest": "^30.2.0",