@codepress/codepress-engine 0.9.4 → 0.10.0

package/dist/vite-plugin.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Vite plugin for CodePress visual editing
+ *
+ * Enables the browser extension's preview/HMR pipeline for Vite+React projects.
+ * In dev mode, this plugin:
+ * 1. Injects bundler detection (window.__CP_BUNDLER__ = 'vite')
+ * 2. Registers source module exports in a global map (window.__CP_VITE_MODULES__)
+ * 3. Provides a dev server endpoint for the extension to query module info
+ *
+ * The module registry uses getter-based live bindings so module exports
+ * are always up-to-date, even after HMR updates.
+ *
+ * @example
+ * // vite.config.ts
+ * import react from '@vitejs/plugin-react';
+ * import codepressVitePlugin from '@codepress/codepress-engine/vite-plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     react({ babel: { plugins: ['@codepress/codepress-engine'] } }),
+ *     codepressVitePlugin(),
+ *   ],
+ * });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseExports = parseExports;
+exports.buildRegistrationCode = buildRegistrationCode;
+exports.default = codepressVitePlugin;
+exports.CodePressVitePlugin = codepressVitePlugin;
+/**
+ * Parse export declarations from source code.
+ * Returns the local binding name and exported name for each export.
+ *
+ * Handles:
+ * - export function Foo()
+ * - export async function Foo()
+ * - export class Foo
+ * - export const/let/var Foo
+ * - export default function Foo()
+ * - export default class Foo
+ * - export { Foo, Bar } (local scope only, not re-exports)
+ * - export { Foo as Bar }
+ * - export default Identifier (simple identifier, not a call or member expression)
+ *
+ * Does NOT handle:
+ * - Anonymous default exports (export default () => ...)
+ * - Wrapped default exports (export default memo(...), export default forwardRef(...))
+ * - Re-exports (export { Foo } from './other')
+ * - export * from './other'
+ * - Destructured exports (export const { a, b } = ...)
+ *
+ * Note: This plugin runs with enforce:'post', so comments are already stripped
+ * by Babel before our transform sees the code. String false positives are
+ * theoretically possible but extremely rare in practice.
+ */
+function parseExports(code) {
+    const seen = new Set();
+    const positioned = [];
+    function add(pos, localName, exportedName) {
+        if (seen.has(exportedName))
+            return;
+        seen.add(exportedName);
+        positioned.push({ pos, localName, exportedName });
+    }
+    // export default function Foo() / export default async function Foo()
+    // export default class Foo
+    for (const m of code.matchAll(/export\s+default\s+(?:async\s+)?(?:function|class)\s+(\w+)/g)) {
+        add(m.index, m[1], "default");
+    }
+    // export default Identifier (not a function/class declaration, not a call or member access)
+    // Matches: export default Hero; export default Component;
+    // Skips:   export default memo(...); export default React.memo(...); export default 42;
+    // The \b after \w* prevents backtracking from matching a partial identifier.
+    for (const m of code.matchAll(/export\s+default\s+(?!function\b|class\b|async\b|new\b)([a-zA-Z_$]\w*)\b(?!\s*[.(])/g)) {
+        add(m.index, m[1], "default");
+    }
+    // export function Foo() (excludes "export default function")
+    for (const m of code.matchAll(/export\s+(?!default\b)(?:async\s+)?function\s+(\w+)/g)) {
+        add(m.index, m[1], m[1]);
+    }
+    // export class Foo (excludes "export default class")
+    for (const m of code.matchAll(/export\s+(?!default\b)class\s+(\w+)/g)) {
+        add(m.index, m[1], m[1]);
+    }
+    // export const/let/var Foo
+    for (const m of code.matchAll(/export\s+(?:const|let|var)\s+(\w+)/g)) {
+        add(m.index, m[1], m[1]);
+    }
+    // export { Foo, Bar } — but NOT export { Foo } from './other'
+    for (const m of code.matchAll(/export\s*\{([^}]+)\}(?!\s*from)/g)) {
+        const inner = m[1];
+        for (const binding of inner.split(",")) {
+            const trimmed = binding.trim();
+            // export { local as exported }
+            const asMatch = trimmed.match(/^(\w+)\s+as\s+(\w+)$/);
+            if (asMatch) {
+                add(m.index, asMatch[1], asMatch[2]);
+            }
+            else if (/^\w+$/.test(trimmed)) {
+                add(m.index, trimmed, trimmed);
+            }
+        }
+    }
+    // Sort by source position for predictable output
+    positioned.sort((a, b) => a.pos - b.pos);
+    return positioned.map(({ localName, exportedName }) => ({
+        localName,
+        exportedName,
+    }));
+}
+/**
+ * Generate a registration IIFE that captures module exports in
+ * window.__CP_VITE_MODULES__ using getter-based live bindings.
+ *
+ * The getters reference local variable bindings from the module scope,
+ * which means they always return the current value (important for HMR).
+ */
+function buildRegistrationCode(relativePath, bindings) {
+    if (bindings.length === 0)
+        return "";
+    const getters = bindings
+        .map((e) => `    get ${JSON.stringify(e.exportedName)}() { return ${e.localName}; }`)
+        .join(",\n");
+    return [
+        "",
+        ";(function() {",
+        '  if (typeof window === "undefined" || !window.__CP_VITE_MODULES__) return;',
+        `  window.__CP_VITE_MODULES__[${JSON.stringify(relativePath)}] = {`,
+        getters,
+        "  };",
+        "})();",
+    ].join("\n");
+}
+/**
+ * Create the CodePress Vite plugin.
+ *
+ * This plugin runs with `enforce: 'post'` so it executes after
+ * @vitejs/plugin-react (which runs the Babel instrumentation plugin
+ * and adds React Fast Refresh). By the time our transform runs,
+ * codepress-data-fp attributes are already injected and the export
+ * structure is finalized.
+ */
+function codepressVitePlugin() {
+    let projectRoot = "";
+    const moduleExports = new Map();
+    return {
+        name: "codepress",
+        enforce: "post",
+        configResolved(config) {
+            projectRoot = config.root;
+        },
+        transformIndexHtml() {
+            return [
+                {
+                    tag: "script",
+                    children: [
+                        'window.__CP_BUNDLER__ = "vite";',
+                        "window.__CP_VITE_MODULES__ = {};",
+                    ].join("\n"),
+                    injectTo: "head-prepend",
+                },
+            ];
+        },
+        transform(code, id, options) {
+            // Skip SSR builds
+            if (options === null || options === void 0 ? void 0 : options.ssr)
+                return;
+            // Skip dependencies (use path separator to avoid false positives on
+            // filenames that happen to contain "node_modules" as a substring)
+            if (id.includes("/node_modules/"))
+                return;
+            // Strip Vite query strings (e.g., ?t=123456 for HMR cache busting)
+            // Must happen before extension check since ?t= is appended to the filename
+            const cleanId = id.split("?")[0];
+            // Only process JS/TS source files
+            if (!/\.(tsx?|jsx?|mjs)$/.test(cleanId))
+                return;
+            // Compute path relative to project root
+            const relativePath = cleanId.startsWith(projectRoot + "/")
+                ? cleanId.slice(projectRoot.length + 1)
+                : cleanId;
+            const bindings = parseExports(code);
+            const previousBindings = moduleExports.get(relativePath);
+            moduleExports.set(relativePath, bindings);
+            // If file lost all exports during HMR, clean up stale registry entry
+            if (bindings.length === 0) {
+                if (previousBindings && previousBindings.length > 0) {
+                    const cleanup = `\n;(function(){if(typeof window!=="undefined"&&window.__CP_VITE_MODULES__)delete window.__CP_VITE_MODULES__[${JSON.stringify(relativePath)}];})();`;
+                    return { code: code + cleanup, map: null };
+                }
+                return;
+            }
+            const registration = buildRegistrationCode(relativePath, bindings);
+            return {
+                code: code + registration,
+                map: null,
+            };
+        },
+        configureServer(server) {
+            server.middlewares.use("/__codepress/modules", (_req, res) => {
+                const map = {};
+                for (const [filePath, bindings] of moduleExports) {
+                    map[filePath] = {
+                        path: filePath,
+                        exports: bindings.map((e) => e.exportedName),
+                    };
+                }
+                res.setHeader("Content-Type", "application/json");
+                res.end(JSON.stringify(map));
+            });
+        },
+    };
+}
+module.exports = codepressVitePlugin;
+module.exports.codepressVitePlugin = codepressVitePlugin;
+module.exports.CodePressVitePlugin = codepressVitePlugin;
+module.exports.default = codepressVitePlugin;
+module.exports.parseExports = parseExports;
+module.exports.buildRegistrationCode = buildRegistrationCode;
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"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"}

package/dist/webpack-plugin.d.ts

@@ -38,6 +38,8 @@ export default class CodePressWebpackPlugin {
      */
     readonly name = "CodePressWebpackPlugin";
     private readonly options;
+    /** Cached monorepo root (found once per build via pnpm-workspace.yaml) */
+    private monorepoRoot;
     /**
      * @param options - Plugin options for conditional execution
      */
@@ -104,7 +106,35 @@ export default class CodePressWebpackPlugin {
      * "/project/node_modules/lucide-react/dist/esm/icons/ChevronDown.js" -> "lucide-react"
      * "/project/node_modules/@radix-ui/react-dialog/dist/index.js" -> "@radix-ui/react-dialog"
      */
+    /**
+     * Parse the last node_modules/ segment from a resource path.
+     * Returns the package name and the remainder after the package name,
+     * or null if the path doesn't contain node_modules.
+     *
+     * Uses the LAST node_modules/ segment so pnpm paths like
+     * "node_modules/.pnpm/pkg@ver/node_modules/pkg/..." resolve correctly.
+     */
+    private parseNodeModulesPath;
     private extractNpmPackageName;
+    /**
+     * Extract an npm-like package name from a module's incoming import
+     * specifiers using webpack's module graph (deterministic — uses the
+     * exact string the developer wrote in the import statement).
+     *
+     * Returns the root package name (e.g., "@scope/pkg" from "@scope/pkg/sub").
+     */
+    private extractPackageNameFromImports;
+    /**
+     * Extract the full npm import specifier(s) from a module's incoming
+     * connections. Unlike extractPackageNameFromImports which returns just
+     * the root package name, this returns the complete specifiers (e.g.,
+     * "@scope/pkg/sub/path") so they can be used as MODULE_MAP keys.
+     *
+     * This is critical for workspace packages where the file system path
+     * (e.g., "apps/extension/lib/chat/models.ts") doesn't contain the
+     * npm package name, making path-based matching impossible at runtime.
+     */
+    private extractFullImportSpecifiers;
     /**
      * Derive an export name from a file path.
      * Used when we don't have explicit export mappings.
@@ -114,6 +144,23 @@ export default class CodePressWebpackPlugin {
      * "/project/node_modules/lucide-react/dist/esm/icons/chevron-down.js" -> "ChevronDown"
      */
     private deriveExportNameFromPath;
+    /**
+     * Find the monorepo root by walking up from the webpack context.
+     * Checks for common workspace markers: pnpm-workspace.yaml, lerna.json,
+     * turbo.json, nx.json, or a package.json with a "workspaces" field.
+     * Cached for the lifetime of the plugin.
+     * Falls back to the context itself if no workspace root is found.
+     */
+    private findMonorepoRoot;
+    /**
+     * Make a resource path relative to the monorepo root.
+     *
+     * @example
+     * // monorepo root = /vercel/path0 (has pnpm-workspace.yaml)
+     * makeRelativeToMonorepoRoot("/vercel/path0/apps/extension/dist/lib/chat.js", "/vercel/path0/apps/web")
+     * // => "apps/extension/dist/lib/chat.js"
+     */
+    private makeRelativeToMonorepoRoot;
     /**
      * Normalize a module path to a human-readable format
      *