catalyst-core 0.2.0-beta.3 → 0.3.0-beta.2

package/dist/server/renderer/render.js

@@ -0,0 +1,47 @@
+/**
+ * Returns data used by the Head component for page rendering.
+ */
+export const renderStart = ({
+    inlineCss,
+    deferredRouteInlineCss,
+    jsScripts,
+    criticalPreloadLinks,
+    deferredPreloadLinks,
+    metaTags,
+    isBot,
+    fetcherData,
+}) => {
+    const { IS_DEV_COMMAND, WEBPACK_DEV_SERVER_HOSTNAME, WEBPACK_DEV_SERVER_PORT } = process.env
+
+    let publicAssetPath = `${process.env.PUBLIC_STATIC_ASSET_URL}${process.env.PUBLIC_STATIC_ASSET_PATH}`
+
+    if (JSON.parse(IS_DEV_COMMAND)) {
+        publicAssetPath = `http://${WEBPACK_DEV_SERVER_HOSTNAME}:${WEBPACK_DEV_SERVER_PORT}/assets/`
+    }
+
+    return {
+        inlineCss,
+        deferredRouteInlineCss,
+        jsScripts,
+        criticalPreloadLinks,
+        deferredPreloadLinks,
+        metaTags,
+        isBot,
+        publicAssetPath,
+        fetcherData,
+    }
+}
+
+/**
+ * Returns data used by the Body component for page rendering.
+ */
+export const renderEnd = (initialState = {}, res, jsx, errorCode, fetcherData) => {
+    return {
+        initialState,
+        firstFoldCss: "",
+        firstFoldJS: "",
+        jsx,
+        errorCode,
+        fetcherData,
+    }
+}

package/dist/server/utils/botDetectionMiddleware.js

@@ -0,0 +1,29 @@
+import { getUserAgentDetails } from "./userAgentUtil.js"
+
+// Loaded once at startup when OTEL is enabled; null otherwise.
+let _context, _trace, _IS_BOT_KEY
+if (process.env.OTEL_ENABLE === true) {
+    try {
+        const { context, trace } = await import("@opentelemetry/api")
+        const { IS_BOT_KEY } = await import("../../otel.js")
+        _context = context
+        _trace = trace
+        _IS_BOT_KEY = IS_BOT_KEY
+    } catch {
+        // otel packages not installed — context injection skipped
+    }
+}
+
+export function botDetectionMiddleware(req, res, next) {
+    const ua = req.headers["user-agent"] || ""
+    const { googleBot, aiBot, statusCakeBot } = getUserAgentDetails(ua)
+    const isBot = !!(googleBot || aiBot || statusCakeBot)
+    res.locals.is_bot = isBot
+
+    if (_context && _IS_BOT_KEY) {
+        _trace?.getActiveSpan()?.setAttribute("http.response.is_bot", isBot)
+        _context.with(_context.active().setValue(_IS_BOT_KEY, isBot), next)
+    } else {
+        next()
+    }
+}

package/dist/server/utils/cjsRequire.js

@@ -0,0 +1,10 @@
+import { createRequire } from "module"
+
+/**
+ * Shared helper to bridge ESM server entry files with legacy CommonJS helpers.
+ *
+ * Usage (in an ESM server file):
+ *   import { cjsRequire } from "catalyst-core/server/cjsRequire"
+ *   const legacyHelper = cjsRequire("./legacy/helper")
+ */
+export const cjsRequire = createRequire(import.meta.url)

package/dist/server/utils/userAgentUtil.js

@@ -1,15 +1,93 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.getUserAgentDetails=void 0;var _uaParserJs=_interopRequireDefault(require("ua-parser-js"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const googleBots={"APIs-Google":"APIs-Google",AdSense:"Mediapartners-Google","AdsBot Mobile Web Android":"AdsBot-Google-Mobile","AdsBot Mobile Web":"AdsBot-Google-Mobile",AdsBot:"AdsBot-Google","Mobile AdSense":"Mediapartners-Google","Mobile Apps Android":"AdsBot-Google-Mobile-Apps",Feedfetcher:"FeedFetcher-Google","Google Read Aloud":"Google-Read-Aloud","Duplex on the Web":"DuplexWeb-Google","Google Favicon":"Google Favicon","Web Light":"googleweblight","Amp crawler":"Google-AMPHTM",Googlebot:"Googlebot","Google Inspection Tool":"Google-InspectionTool","Google Agent":"Google-Agent"};// AI Crawler bots - for improved SEO with AI search engines
-const aiCrawlerBots={// OpenAI/ChatGPT bots
-GPTBot:"GPTBot","ChatGPT-User":"ChatGPT-User","OAI-SearchBot":"OAI-SearchBot",// Anthropic/Claude bots
-ClaudeBot:"ClaudeBot","Claude-User":"Claude-User","Claude-SearchBot":"Claude-SearchBot",// Perplexity bots
-PerplexityBot:"PerplexityBot","Perplexity-User":"Perplexity-User",// Microsoft Bing bot (also powers Bing Chat/Copilot)
-Bingbot:"bingbot",// Meta Crawler bot
-MetaBot:"meta-externalagent"};/**
+import parser from "ua-parser-js"
+
+const googleBots = {
+    "APIs-Google": "APIs-Google",
+    AdSense: "Mediapartners-Google",
+    "AdsBot Mobile Web Android": "AdsBot-Google-Mobile",
+    "AdsBot Mobile Web": "AdsBot-Google-Mobile",
+    AdsBot: "AdsBot-Google",
+    "Mobile AdSense": "Mediapartners-Google",
+    "Mobile Apps Android": "AdsBot-Google-Mobile-Apps",
+    Feedfetcher: "FeedFetcher-Google",
+    "Google Read Aloud": "Google-Read-Aloud",
+    "Duplex on the Web": "DuplexWeb-Google",
+    "Google Favicon": "Google Favicon",
+    "Web Light": "googleweblight",
+    "Amp crawler": "Google-AMPHTM",
+    Googlebot: "Googlebot",
+    "Google Inspection Tool": "Google-InspectionTool",
+    "Google Agent": "Google-Agent",
+}
+
+// AI Crawler bots - for improved SEO with AI search engines
+const aiCrawlerBots = {
+    // OpenAI/ChatGPT bots
+    GPTBot: "GPTBot",
+    "ChatGPT-User": "ChatGPT-User",
+    "OAI-SearchBot": "OAI-SearchBot",
+
+    // Anthropic/Claude bots
+    ClaudeBot: "ClaudeBot",
+    "Claude-User": "Claude-User",
+    "Claude-SearchBot": "Claude-SearchBot",
+
+    // Perplexity bots
+    PerplexityBot: "PerplexityBot",
+    "Perplexity-User": "Perplexity-User",
+
+    // Microsoft Bing bot (also powers Bing Chat/Copilot)
+    Bingbot: "bingbot",
+
+    // Meta Crawler bot
+    MetaBot: "meta-externalagent",
+}
+
+// StatusCake synthetic monitoring user agents.
+// STATUS_CAKE_USER_AGENT_MOBILE matches the mobile pagespeed monitor — kept as a
+// named export so apps that compare UAs directly (mweb's document.js, App/index.js)
+// can import the same constant catalyst uses for its bot detection.
+export const STATUS_CAKE_USER_AGENT_MOBILE = "StatusCake_Pagespeed_Indev"
+const statusCakeBots = {
+    "StatusCake Pagespeed Mobile": STATUS_CAKE_USER_AGENT_MOBILE,
+    StatusCake: "StatusCake",
+}
+
+/**
  * check if user agent contains bot data
  * @param {string} ua - user agent
  * @return {string|null}
- */const getGoogleBot=ua=>{for(let key in googleBots){if(ua.includes(googleBots[key]))return key;}return null;};const getAICrawlerBot=ua=>{for(let key in aiCrawlerBots){if(ua.includes(aiCrawlerBots[key]))return key;}return null;};/**
+ */
+const getGoogleBot = (ua) => {
+    for (let key in googleBots) {
+        if (ua.includes(googleBots[key])) return key
+    }
+    return null
+}
+
+const getAICrawlerBot = (ua) => {
+    for (let key in aiCrawlerBots) {
+        if (ua.includes(aiCrawlerBots[key])) return key
+    }
+    return null
+}
+
+const getStatusCakeBot = (ua) => {
+    for (let key in statusCakeBots) {
+        if (ua.includes(statusCakeBots[key])) return key
+    }
+    return null
+}
+
+/**
  * returns object which contains google bot and user-agent info
  * @param {string} ua - user agent
  * @return {object} - returns user agent
- */const getUserAgentDetails=ua=>{const agentDetails=(0,_uaParserJs.default)(ua);const googleBot=getGoogleBot(ua);const aiBot=getAICrawlerBot(ua);return{...agentDetails,googleBot,aiBot};};exports.getUserAgentDetails=getUserAgentDetails;
+ */
+export const getUserAgentDetails = (ua) => {
+    const agentDetails = parser(ua)
+    const googleBot = getGoogleBot(ua)
+    const aiBot = getAICrawlerBot(ua)
+    const statusCakeBot = getStatusCakeBot(ua)
+
+    return { ...agentDetails, googleBot, aiBot, statusCakeBot }
+}

package/dist/server/utils/validator.js

@@ -1 +1,164 @@
-"use strict";const pc=require("picocolors");const handleError=e=>{console.log(pc.red("Failed to start server: "),e);};const safeCall=(fn,...args)=>{try{if(!fn)return;if(typeof fn!=="function"){console.log(pc.red("Invalid lifecycle method defined in server/index.js"));return;}fn(...args);}catch(e){console.log(pc.red("Failed to execute lifecycle method: "),fn.name,e);}};const validatePreInitServer=fn=>{try{if(!fn)throw new Error("preServerInit named function should be defined in server/index.js");if(typeof fn!=="function")throw new Error("preServerInit should be function present in server/index.js");return true;}catch(e){handleError(e);}};const validateMiddleware=fn=>{try{if(!fn)throw new Error("addMiddlewares named function not found in server/server.js");if(typeof fn!=="function")throw new Error("addMiddlewares should be function present in server/server.js");return true;}catch(e){handleError(e);}};const validateReducerFunction=fn=>{try{if(!fn)throw new Error("reducer not found in src/js/containers/App/reducer");if(typeof fn!=="function")throw new Error("reducer should present in src/js/containers/App/reducer");return true;}catch(e){handleError(e);}};const validateConfigFile=obj=>{try{if(!obj)throw new Error("config not found in config folder");if(typeof obj!=="object")throw new Error("config object should be exported from config folder inside your project root directory");if(typeof obj==="object"){const requiredConfigKeys={NODE_SERVER_HOSTNAME:"",NODE_SERVER_PORT:"",WEBPACK_DEV_SERVER_HOSTNAME:"",WEBPACK_DEV_SERVER_PORT:"",BUILD_OUTPUT_PATH:"",PUBLIC_STATIC_ASSET_PATH:"",PUBLIC_STATIC_ASSET_URL:"",CLIENT_ENV_VARIABLES:[],ANALYZE_BUNDLE:""};for(let key in requiredConfigKeys){if(!(key in obj))throw new Error(`${key} key not found inside config.json`);}}return true;}catch(e){handleError(e);}};const validatePackageJson=obj=>{try{if(!obj)throw new Error("package.json not found in the project");if(typeof obj!=="object")throw new Error("package.json should be defined in project root directory");return true;}catch(e){handleError(e);}};const validateModuleAlias=obj=>{try{if(!obj)throw new Error("moduleAliases not found in package.json file present in root directory.");if(typeof obj!=="object")throw new Error("moduleAliases named object should be exported from package.json");if(typeof obj==="object"){const requiredModuleAliases={"@api":"api.js","@containers":"src/js/containers","@server":"server","@config":"config","@css":"src/static/css","@routes":"src/js/routes/"};for(let key in requiredModuleAliases){if(key.includes("catalyst"))throw new Error(`Catalyst keyword is restricted for defining aliases`);if(!(key in obj))throw new Error(`${key} module alias not defined inside package.json`);}}return true;}catch(e){handleError(e);}};const validateConfigureStore=fn=>{try{if(!fn)throw new Error("configureStore not found in file src/js/store/index.js");if(typeof fn!=="function")throw new Error("configureStore should be function exported from src/js/store/index.js");return true;}catch(e){handleError(e);}};const validateGetRoutes=fn=>{try{if(!fn)throw new Error("getRoutes not found in file src/js/routes/utils.js");if(typeof fn!=="function")throw new Error("getRoutes should be function exported from src/js/routers/index.js");return true;}catch(e){handleError(e);}};const validateCustomDocument=fn=>{try{if(!fn)throw new Error("document not found in file server/document.js");if(typeof fn!=="function")throw new Error("document should be a react component exported from server/document.js");return true;}catch(e){handleError(e);}};module.exports={safeCall,validateConfigFile,validateConfigureStore,validateCustomDocument,validateGetRoutes,validatePackageJson,validateReducerFunction,validateModuleAlias,validatePreInitServer,validateMiddleware};
+import pc from "picocolors"
+
+const handleError = (e) => {
+    console.log(pc.red("Failed to start server: "), e)
+}
+
+const validatePreInitServer = (fn) => {
+    try {
+        if (!fn) throw new Error("preServerInit named function should be defined in server/index.js")
+        if (typeof fn !== "function")
+            throw new Error("preServerInit should be function present in server/index.js")
+        return true
+    } catch (e) {
+        handleError(e)
+    }
+}
+
+const validateMiddleware = (fn) => {
+    try {
+        if (!fn) throw new Error("addMiddlewares named function not found in server/server.js")
+        if (typeof fn !== "function")
+            throw new Error("addMiddlewares should be function present in server/server.js")
+        return true
+    } catch (e) {
+        handleError(e)
+    }
+}
+
+const validateReducerFunction = (fn) => {
+    try {
+        if (!fn) throw new Error("reducer not found in src/js/containers/App/reducer")
+        if (typeof fn !== "function")
+            throw new Error("reducer should present in src/js/containers/App/reducer")
+        return true
+    } catch (e) {
+        handleError(e)
+    }
+}
+
+const validateConfigFile = (obj) => {
+    try {
+        if (!obj) throw new Error("config not found in config folder")
+        if (typeof obj !== "object")
+            throw new Error(
+                "config object should be exported from config folder inside your project root directory"
+            )
+        if (typeof obj === "object") {
+            const requiredConfigKeys = {
+                NODE_SERVER_HOSTNAME: "",
+                NODE_SERVER_PORT: "",
+                WEBPACK_DEV_SERVER_HOSTNAME: "",
+                WEBPACK_DEV_SERVER_PORT: "",
+                BUILD_OUTPUT_PATH: "",
+                PUBLIC_STATIC_ASSET_PATH: "",
+                PUBLIC_STATIC_ASSET_URL: "",
+                CLIENT_ENV_VARIABLES: [],
+                ANALYZE_BUNDLE: "",
+            }
+            for (let key in requiredConfigKeys) {
+                if (!(key in obj)) throw new Error(`${key} key not found inside config.json`)
+            }
+        }
+        return true
+    } catch (e) {
+        handleError(e)
+    }
+}
+
+const validatePackageJson = (obj) => {
+    try {
+        if (!obj) throw new Error("package.json not found in the project")
+        if (typeof obj !== "object")
+            throw new Error("package.json should be defined in project root directory")
+        return true
+    } catch (e) {
+        handleError(e)
+    }
+}
+
+const validateModuleAlias = (obj) => {
+    try {
+        if (!obj) throw new Error("moduleAliases not found in package.json file present in root directory.")
+        if (typeof obj !== "object")
+            throw new Error("moduleAliases named object should be exported from package.json")
+        if (typeof obj === "object") {
+            const requiredModuleAliases = {
+                "@api": "api.js",
+                "@containers": "src/js/containers",
+                "@server": "server",
+                "@config": "config",
+                "@css": "src/static/css",
+                "@routes": "src/js/routes/",
+            }
+            for (let key in requiredModuleAliases) {
+                if (key.includes("catalyst"))
+                    throw new Error(`Catalyst keyword is restricted for defining aliases`)
+                if (!(key in obj)) throw new Error(`${key} module alias not defined inside package.json`)
+            }
+        }
+        return true
+    } catch (e) {
+        handleError(e)
+    }
+}
+
+const validateConfigureStore = (fn) => {
+    try {
+        if (!fn) throw new Error("configureStore not found in file src/js/store/index.js")
+        if (typeof fn !== "function")
+            throw new Error("configureStore should be function exported from src/js/store/index.js")
+        return true
+    } catch (e) {
+        handleError(e)
+    }
+}
+
+const validateGetRoutes = (fn) => {
+    try {
+        if (!fn) throw new Error("getRoutes not found in file src/js/routes/utils.js")
+        if (typeof fn !== "function")
+            throw new Error("getRoutes should be function exported from src/js/routers/index.js")
+        return true
+    } catch (e) {
+        handleError(e)
+    }
+}
+
+const validateCustomDocument = (fn) => {
+    try {
+        if (!fn) throw new Error("document not found in file server/document.js")
+        if (typeof fn !== "function")
+            throw new Error("document should be a react component exported from server/document.js")
+        return true
+    } catch (e) {
+        handleError(e)
+    }
+}
+
+/**
+ * Safely call a function, catching and logging any errors.
+ * Used for user-defined hooks (onRouteMatch, onFetcherError, etc.)
+ * that should never crash the SSR pipeline.
+ */
+const safeCall = (fn, ...args) => {
+    if (typeof fn !== "function") return
+    try {
+        return fn(...args)
+    } catch (e) {
+        console.error("Error in user hook:", e)
+    }
+}
+
+export {
+    validateConfigFile,
+    validateConfigureStore,
+    validateCustomDocument,
+    validateGetRoutes,
+    validatePackageJson,
+    validateReducerFunction,
+    validateModuleAlias,
+    validatePreInitServer,
+    validateMiddleware,
+    safeCall,
+}

package/dist/vite/FastRefresh.jsx

@@ -0,0 +1,20 @@
+import React from "react"
+
+const FastRefresh = () => {
+    return (
+        <script
+            type="module"
+            // eslint-disable-next-line risxss/catch-potential-xss-react
+            dangerouslySetInnerHTML={{
+                __html: `
+        import { injectIntoGlobalHook } from "/@react-refresh";
+        injectIntoGlobalHook(window);
+        window.$RefreshReg$ = () => {};
+        window.$RefreshSig$ = () => (type) => type;
+        `,
+            }}
+        />
+    )
+}
+
+export default FastRefresh

package/dist/vite/inject-cache-key-plugin.js

@@ -0,0 +1,276 @@
+import path from "path"
+import { readFileSync, existsSync, statSync } from "fs"
+import { fileURLToPath } from "url"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+// Cache for loaded aliases
+let aliasCache = null
+
+/**
+ * Load and resolve module aliases from both the consuming app and catalyst-core,
+ * using the same algorithm as node-loader.mjs.
+ */
+function loadAliases() {
+    if (aliasCache) {
+        return aliasCache
+    }
+
+    const appRoot = process.env.src_path || process.cwd()
+    const appPackageJsonConfig = path.resolve(appRoot, "package.json")
+    const catalystPackageJsonConfig = path.resolve(__dirname, "../../package.json")
+
+    let appModuleAliases = {}
+    let catalystModuleAliases = {}
+
+    try {
+        const appPackageJson = JSON.parse(readFileSync(appPackageJsonConfig, "utf8"))
+        appModuleAliases = appPackageJson._moduleAliases || {}
+    } catch {
+        // Silently fail if app package.json doesn't exist or is invalid
+    }
+
+    try {
+        const catalystPackageJson = JSON.parse(readFileSync(catalystPackageJsonConfig, "utf8"))
+        catalystModuleAliases = catalystPackageJson._moduleAliases || {}
+    } catch {
+        // Silently fail if catalyst package.json doesn't exist or is invalid
+    }
+
+    // Application aliases take precedence over catalyst-core aliases
+    const allAliases = { ...catalystModuleAliases, ...appModuleAliases }
+
+    aliasCache = {}
+    for (const [alias, aliasPath] of Object.entries(allAliases)) {
+        if (aliasPath && typeof aliasPath === "string") {
+            try {
+                const resolvedPath = path.resolve(appRoot, ...aliasPath.split("/"))
+                aliasCache[alias] = resolvedPath
+            } catch (error) {
+                console.warn(`Failed to resolve alias ${alias}:`, error.message)
+            }
+        }
+    }
+
+    return aliasCache
+}
+
+/**
+ * Try to resolve a path by applying common JS/TS/ESM extensions and index fallbacks,
+ * matching the same resolution order as node-loader.mjs.
+ */
+function resolveWithExtensions(basePath) {
+    if (existsSync(basePath) && statSync(basePath).isFile()) {
+        return basePath
+    }
+
+    const extensions = [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".scss"]
+
+    for (const ext of extensions) {
+        const candidate = `${basePath}${ext}`
+        if (existsSync(candidate)) {
+            return candidate
+        }
+    }
+
+    const currentExt = path.extname(basePath)
+    if (currentExt) {
+        const withoutExt = basePath.slice(0, -currentExt.length)
+        for (const ext of extensions) {
+            if (ext === currentExt) continue
+            const candidate = `${withoutExt}${ext}`
+            if (existsSync(candidate)) {
+                return candidate
+            }
+        }
+    }
+
+    for (const ext of extensions) {
+        const candidate = path.join(basePath, `index${ext}`)
+        if (existsSync(candidate)) {
+            return candidate
+        }
+    }
+
+    return null
+}
+
+/**
+ * Resolve import path to an absolute file path using the same alias algorithm as node-loader.mjs.
+ * Falls back to relative resolution when no alias matches.
+ */
+function resolveToAbsolutePath(importPath, importerId) {
+    const aliases = loadAliases()
+
+    // 1. Try alias resolution (same logic as node-loader resolveAlias)
+    for (const [alias, aliasPath] of Object.entries(aliases)) {
+        if (importPath === alias || importPath.startsWith(alias + "/")) {
+            const remainingPath = importPath === alias ? "" : importPath.slice(alias.length + 1)
+            const rawResolved = path.join(aliasPath, remainingPath)
+            const finalResolved = resolveWithExtensions(rawResolved)
+            if (finalResolved) {
+                return path.resolve(finalResolved)
+            }
+        }
+    }
+
+    // 2. Relative imports — resolve from the importer's directory
+    if (importPath.startsWith("./") || importPath.startsWith("../")) {
+        const importerDir = path.dirname(importerId)
+        const absolutePath = path.resolve(importerDir, importPath)
+        const resolved = resolveWithExtensions(absolutePath)
+        if (resolved) {
+            return resolved
+        }
+        return absolutePath
+    }
+
+    return null
+}
+
+/**
+ * Resolve import path to a manifest key
+ * @param {string} importPath - The import path to resolve
+ * @param {string} importerId - The file ID that imports this path
+ * @returns {string} - The resolved manifest key (relative to manifest location: build/.vite/)
+ */
+function resolveImportPath(importPath, importerId) {
+    try {
+        const absolutePath = resolveToAbsolutePath(importPath, importerId)
+
+        if (absolutePath && process.env.src_path) {
+            // Manifest is located at: build/.vite/manifest.json
+            const manifestDir = path.join(process.env.src_path, "build", ".vite")
+            const relativePath = path.relative(manifestDir, absolutePath)
+            return relativePath.replace(/\\/g, "/")
+        }
+
+        // Fallback: strip leading ./ and return as-is
+        return importPath.replace(/^\.\//, "")
+    } catch (error) {
+        console.warn(`Error resolving import path ${importPath}:`, error.message)
+        return importPath.replace(/^\.\//, "")
+    }
+}
+
+/**
+ * Walk an AST node and invoke the visitor for every node.
+ */
+function walk(node, visitor) {
+    if (!node || typeof node !== "object") return
+
+    visitor(node)
+
+    for (const key of Object.keys(node)) {
+        const child = node[key]
+        if (Array.isArray(child)) {
+            for (const item of child) {
+                if (item && typeof item.type === "string") {
+                    walk(item, visitor)
+                }
+            }
+        } else if (child && typeof child.type === "string") {
+            walk(child, visitor)
+        }
+    }
+}
+
+/**
+ * Vite plugin to add cacheKey to split calls with manifest keys.
+ * Uses Rollup's this.parse() for robust AST-based detection instead of regex.
+ */
+export function injectCacheKeyPlugin() {
+    return {
+        name: "split-cache-key",
+
+        async transform(code, id) {
+            if (!/\.(js|jsx|ts|tsx)$/.test(id)) return null
+            if (id.includes("node_modules")) return null
+            if (!code.includes("split")) return null
+
+            let ast
+            try {
+                ast = this.parse(code)
+            } catch {
+                return null
+            }
+
+            // Collect split() call sites that need a cacheKey injected.
+            // Process in reverse source order so earlier indices stay valid after splicing.
+            const sites = []
+
+            walk(ast, (node) => {
+                // Match: split(<arrow>, <options?>, <cacheKey?>)
+                // Also supports: split(<arrow>, <options?>, <rootOptions>, <cacheKey?>)
+                if (node.type !== "CallExpression") return
+                if (node.callee.type !== "Identifier" || node.callee.name !== "split") return
+
+                const args = node.arguments
+                if (args.length === 0) return
+
+                // First arg must be a function that returns import("...")
+                // Supports both: () => import("...") and function() { return import("...") }
+                const loader = args[0]
+                let importExpr
+
+                if (loader.type === "ArrowFunctionExpression") {
+                    // () => import("...")
+                    importExpr = loader.body
+                } else if (loader.type === "FunctionExpression") {
+                    // function() { return import("...") }
+                    const stmts = loader.body.body
+                    if (stmts.length !== 1 || stmts[0].type !== "ReturnStatement") return
+                    importExpr = stmts[0].argument
+                } else {
+                    return
+                }
+
+                if (!importExpr || importExpr.type !== "ImportExpression") return
+                if (importExpr.source.type !== "Literal" || typeof importExpr.source.value !== "string")
+                    return
+
+                const importPath = importExpr.source.value
+
+                // Already has a cacheKey (3rd or 4th arg) -> skip
+                if (args.length >= 4) {
+                    const fourth = args[3]
+                    if (fourth?.type === "Literal" && typeof fourth.value === "string") return
+                }
+                if (args.length >= 3) {
+                    const third = args[2]
+                    if (third?.type === "Literal" && typeof third.value === "string") return
+                }
+
+                sites.push({
+                    importPath,
+                    callEnd: node.end, // position of the closing )
+                    argCount: args.length,
+                })
+            })
+
+            if (sites.length === 0) return null
+
+            // Sort descending by position so splicing doesn't shift earlier indices
+            sites.sort((a, b) => b.callEnd - a.callEnd)
+
+            let transformed = code
+            for (const { importPath, callEnd, argCount } of sites) {
+                let manifestKey = resolveImportPath(importPath, id)
+                if (manifestKey && !manifestKey.endsWith(".js")) {
+                    manifestKey = manifestKey + ".js"
+                }
+
+                // Insert just before the closing ) of the split() call
+                let insertion = `, "${manifestKey}"`
+                if (argCount === 1) {
+                    insertion = `, {}, "${manifestKey}"`
+                }
+
+                transformed = transformed.slice(0, callEnd - 1) + insertion + transformed.slice(callEnd - 1)
+            }
+
+            return { code: transformed, map: null }
+        },
+    }
+}

package/dist/vite/loadCustomViteConfig.js

@@ -0,0 +1,22 @@
+import { existsSync } from "fs"
+import path from "path"
+import { pathToFileURL } from "url"
+
+const emptyConfig = {
+    ssrPlugins: [],
+    clientPlugins: [],
+}
+
+export async function loadCustomViteConfig() {
+    const configNames = ["buildConfig.js", "webpackConfig.js"]
+    const configPath = configNames
+        .map((configName) => path.join(process.env.src_path, configName))
+        .find((candidatePath) => existsSync(candidatePath))
+
+    if (!configPath) {
+        return emptyConfig
+    }
+
+    const configModule = await import(pathToFileURL(configPath).href)
+    return configModule.default || configModule
+}