@simplysm/sd-cli 13.0.99 → 14.0.1

package/src/utils/vite-config.ts

@@ -1,390 +0,0 @@
-import fs from "fs";
-import { createRequire } from "module";
-import path from "path";
-import type { Plugin, UserConfig as ViteUserConfig } from "vite";
-import tsconfigPaths from "vite-tsconfig-paths";
-import solidPlugin from "vite-plugin-solid";
-import { VitePWA } from "vite-plugin-pwa";
-import tailwindcss from "tailwindcss";
-import type esbuild from "esbuild";
-import { getTailwindConfigDeps } from "./tailwind-config-deps.js";
-import { FsWatcher, pathx } from "@simplysm/core-node";
-
-/**
- * Vite plugin that watches scope package dependencies of a Tailwind config.
- *
- * Tailwind CSS's built-in dependency tracking only handles relative path imports,
- * so it cannot detect config changes in scope packages referenced via presets.
- * This plugin watches those files and invalidates the Tailwind cache on change.
- */
-function sdTailwindConfigDepsPlugin(pkgDir: string, replaceDeps: string[]): Plugin {
-  return {
-    name: "sd-tailwind-config-deps",
-    configureServer(server) {
-      const configPath = path.join(pkgDir, "tailwind.config.ts");
-      if (!fs.existsSync(configPath)) return;
-
-      const allDeps = getTailwindConfigDeps(configPath, replaceDeps);
-      const configAbsolute = path.resolve(configPath);
-      const externalDeps = allDeps.filter((d) => d !== configAbsolute);
-      if (externalDeps.length === 0) return;
-
-      for (const dep of externalDeps) {
-        server.watcher.add(dep);
-      }
-
-      server.watcher.on("change", (changed) => {
-        if (externalDeps.some((d) => pathx.norm(d) === pathx.norm(changed))) {
-          // Clear require cache used by jiti (Tailwind's config loader)
-          // so changed files are re-read on config reload
-          const _require = createRequire(import.meta.url);
-          for (const dep of allDeps) {
-            delete _require.cache[dep];
-          }
-
-          // Invalidate Tailwind cache: update config mtime to trigger reload
-          const now = new Date();
-          fs.utimesSync(configPath, now, now);
-          server.ws.send({ type: "full-reload" });
-        }
-      });
-    },
-  };
-}
-
-/**
- * Check if a package is subpath-only export (no "." in exports field)
- *
- * e.g., @tiptap/pm only exports "./state", "./view" etc., so pre-bundling is not possible.
- * Tries two paths in pnpm structure:
- * 1. Follow realpath to find in .pnpm node_modules
- * 2. Fallback to symlinked workspace package's node_modules
- */
-function isSubpathOnlyPackage(pkgJsonPath: string): boolean {
-  try {
-    const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8")) as {
-      exports?: Record<string, unknown> | string;
-      main?: string;
-      module?: string;
-    };
-    if (
-      pkgJson.exports != null &&
-      typeof pkgJson.exports === "object" &&
-      !("." in pkgJson.exports) &&
-      pkgJson.main == null &&
-      pkgJson.module == null
-    ) {
-      return true;
-    }
-  } catch {
-    // Return false on read failure (include in pre-bundling)
-  }
-  return false;
-}
-
-/** Common MIME types for web assets served from public-dev/ */
-const MIME_TYPES: Record<string, string> = {
-  ".html": "text/html",
-  ".css": "text/css",
-  ".js": "text/javascript",
-  ".mjs": "text/javascript",
-  ".json": "application/json",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".ico": "image/x-icon",
-  ".webp": "image/webp",
-  ".avif": "image/avif",
-  ".woff": "font/woff",
-  ".woff2": "font/woff2",
-  ".ttf": "font/ttf",
-  ".mp4": "video/mp4",
-  ".webm": "video/webm",
-};
-
-/** @internal Exported for testing */
-export function getMimeType(ext: string): string {
-  return MIME_TYPES[ext.toLowerCase()] ?? "application/octet-stream";
-}
-
-/**
- * Vite plugin that serves files from public-dev/ directory with priority over public/ in dev mode.
- * Keeps Vite's default publicDir (public/) while giving precedence to public-dev/ files at the same path.
- */
-function sdPublicDevPlugin(pkgDir: string): Plugin {
-  const publicDevDir = path.join(pkgDir, "public-dev");
-
-  return {
-    name: "sd-public-dev",
-    configureServer(server) {
-      if (!fs.existsSync(publicDevDir)) return;
-
-      // Check public-dev/ files before Vite's default static serving
-      server.middlewares.use((req, res, next) => {
-        if (req.url == null) {
-          next();
-          return;
-        }
-
-        // Strip base path
-        const base = server.config.base || "/";
-        let urlPath = req.url.split("?")[0];
-        if (urlPath.startsWith(base)) {
-          urlPath = urlPath.slice(base.length);
-        }
-        if (urlPath.startsWith("/")) {
-          urlPath = urlPath.slice(1);
-        }
-
-        // Path traversal defense: block access to files outside publicDevDir
-        const decodedPath = decodeURIComponent(urlPath);
-        const filePath = path.resolve(publicDevDir, decodedPath);
-        const normalizedRoot = path.resolve(publicDevDir);
-        if (!filePath.startsWith(normalizedRoot + path.sep) && filePath !== normalizedRoot) {
-          next();
-          return;
-        }
-
-        if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
-          const ext = path.extname(filePath);
-          res.setHeader("Content-Type", getMimeType(ext));
-          const stream = fs.createReadStream(filePath);
-          stream.on("error", () => {
-            if (!res.headersSent) {
-              next();
-            } else {
-              res.destroy();
-            }
-          });
-          stream.pipe(res);
-        } else {
-          next();
-        }
-      });
-    },
-  };
-}
-
-/**
- * Vite plugin that detects changes in scope packages' dist directories.
- *
- * Vite excludes node_modules from watch by default, so dist file changes
- * in scope packages do not trigger HMR/rebuild.
- * This plugin uses a separate FsWatcher to monitor scope packages' dist directories
- * and triggers Vite's internal HMR pipeline on change.
- * Excludes from optimizeDeps to prevent changes being ignored due to pre-bundled cache.
- */
-function sdScopeWatchPlugin(
-  pkgDir: string,
-  replaceDeps: string[],
-  onScopeRebuild?: () => void,
-): Plugin {
-  return {
-    name: "sd-scope-watch",
-    config() {
-      const excluded: string[] = [];
-      const nestedDepsToInclude: string[] = [];
-
-      for (const pkg of replaceDeps) {
-        excluded.push(pkg);
-
-        const pkgParts = pkg.split("/");
-        const depPkgJsonPath = path.join(pkgDir, "node_modules", ...pkgParts, "package.json");
-        try {
-          const depPkgJson = JSON.parse(fs.readFileSync(depPkgJsonPath, "utf-8")) as {
-            dependencies?: Record<string, string>;
-          };
-          for (const dep of Object.keys(depPkgJson.dependencies ?? {})) {
-            if (replaceDeps.includes(dep)) continue;
-            if (dep === "solid-js" || dep.startsWith("@solidjs/") || dep.startsWith("solid-"))
-              continue;
-            if (dep === "tailwindcss") continue;
-
-            const realPkgPath = fs.realpathSync(path.join(pkgDir, "node_modules", ...pkgParts));
-            const pnpmNodeModules = path.resolve(realPkgPath, "../..");
-            const depPkgJsonResolved = path.join(pnpmNodeModules, dep, "package.json");
-            if (isSubpathOnlyPackage(depPkgJsonResolved)) continue;
-
-            const depPkgJsonFallback = path.join(
-              pkgDir,
-              "node_modules",
-              ...pkgParts,
-              "node_modules",
-              dep,
-              "package.json",
-            );
-            if (isSubpathOnlyPackage(depPkgJsonFallback)) continue;
-
-            nestedDepsToInclude.push(`${pkg} > ${dep}`);
-          }
-        } catch {
-          // Skip on package.json read failure
-        }
-      }
-
-      return {
-        optimizeDeps: {
-          force: true,
-          exclude: excluded,
-          include: [...new Set(nestedDepsToInclude)],
-        },
-      };
-    },
-    async configureServer(server) {
-      const watchPaths: string[] = [];
-
-      for (const pkg of replaceDeps) {
-        const pkgParts = pkg.split("/");
-        const pkgRoot = path.join(pkgDir, "node_modules", ...pkgParts);
-        if (!fs.existsSync(pkgRoot)) continue;
-
-        const distDir = path.join(pkgRoot, "dist");
-        if (fs.existsSync(distDir)) {
-          watchPaths.push(distDir);
-        }
-
-        for (const file of fs.readdirSync(pkgRoot)) {
-          if (
-            file.endsWith(".css") ||
-            file === "tailwind.config.ts" ||
-            file === "tailwind.config.js"
-          ) {
-            watchPaths.push(path.join(pkgRoot, file));
-          }
-        }
-      }
-
-      if (watchPaths.length === 0) return;
-
-      const scopeWatcher = await FsWatcher.watch(watchPaths);
-      scopeWatcher.onChange({ delay: 300 }, (changeInfos) => {
-        for (const { path: changedPath } of changeInfos) {
-          let realPath: string;
-          try {
-            realPath = fs.realpathSync(changedPath);
-          } catch {
-            continue;
-          }
-          server.watcher.emit("change", realPath);
-        }
-        onScopeRebuild?.();
-      });
-
-      server.httpServer?.on("close", () => void scopeWatcher.close());
-    },
-  };
-}
-
-/**
- * Vite config generation options
- */
-export interface ViteConfigOptions {
-  pkgDir: string;
-  name: string;
-  tsconfigPath: string;
-  compilerOptions: Record<string, unknown>;
-  env?: Record<string, string>;
-  mode: "build" | "dev";
-  /** Server port in dev mode (0 for auto-assign) */
-  serverPort?: number;
-  /** Array of replaceDeps package names (resolved state) */
-  replaceDeps?: string[];
-  /** Callback when replaceDeps package dist changes */
-  onScopeRebuild?: () => void;
-  /** Override build.outDir (e.g. ".capacitor/www" for Capacitor builds) */
-  outDir?: string;
-  /** Override base path (e.g. "./" for Capacitor builds) */
-  base?: string;
-  /** Packages to exclude from Vite optimizeDeps pre-bundling */
-  exclude?: string[];
-}
-
-/**
- * Create Vite config
- *
- * Configuration for building/dev server for client packages based on SolidJS + TailwindCSS.
- * - build mode: production build (logLevel: silent)
- * - dev mode: dev server (env substitution via define, server configuration)
- */
-export function createViteConfig(options: ViteConfigOptions): ViteUserConfig {
-  const { pkgDir, name, tsconfigPath, compilerOptions, env, mode, serverPort, replaceDeps } =
-    options;
-
-  // Read package.json to extract app name for PWA manifest
-  const pkgJsonPath = path.join(pkgDir, "package.json");
-  const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8")) as { name: string };
-  const appName = pkgJson.name.replace(/^@[^/]+\//, "");
-
-  // Process.env substitution (applied to both build and dev modes)
-  const envDefine: Record<string, string> = {};
-  if (env != null) {
-    envDefine["process.env"] = JSON.stringify(env);
-  }
-
-  const config: ViteUserConfig = {
-    root: pkgDir,
-    base: options.base ?? `/${name}/`,
-    plugins: [
-      tsconfigPaths({ projects: [tsconfigPath] }),
-      solidPlugin(),
-      VitePWA({
-        registerType: "prompt",
-        injectRegister: "script",
-        manifest: {
-          name: appName,
-          short_name: appName,
-          display: "standalone",
-          theme_color: "#ffffff",
-          background_color: "#ffffff",
-        },
-        workbox: {
-          globPatterns: ["**/*.{js,css,html,ico,png,svg,woff2}"],
-        },
-      }),
-      ...(replaceDeps != null && replaceDeps.length > 0
-        ? [sdTailwindConfigDepsPlugin(pkgDir, replaceDeps)]
-        : []),
-      ...(replaceDeps != null && replaceDeps.length > 0
-        ? [sdScopeWatchPlugin(pkgDir, replaceDeps, options.onScopeRebuild)]
-        : []),
-      ...(mode === "dev" ? [sdPublicDevPlugin(pkgDir)] : []),
-    ],
-    css: {
-      postcss: {
-        plugins: [tailwindcss({ config: path.join(pkgDir, "tailwind.config.ts") })],
-      },
-    },
-    esbuild: {
-      tsconfigRaw: { compilerOptions: compilerOptions as esbuild.TsconfigRaw["compilerOptions"] },
-    },
-  };
-
-  // Process.env substitution (applied to both build and dev modes)
-  config.define = envDefine;
-
-  if (options.outDir != null) {
-    config.build = { outDir: options.outDir };
-  }
-
-  if (options.exclude != null && options.exclude.length > 0) {
-    config.optimizeDeps = { exclude: options.exclude };
-  }
-
-  if (mode === "build") {
-    config.logLevel = "silent";
-  } else {
-    // Dev mode
-    config.server = {
-      // serverPort === 0: server-connected client (proxy target)
-      // → explicitly set host to 127.0.0.1 to ensure IPv4 binding
-      //   (On Windows, if localhost resolves to ::1 (IPv6), proxy connection to 127.0.0.1 causes ECONNREFUSED)
-      host: serverPort === 0 ? "127.0.0.1" : undefined,
-      port: serverPort === 0 ? undefined : serverPort,
-      strictPort: serverPort !== 0 && serverPort !== undefined,
-    };
-  }
-
-  return config;
-}

package/src/workers/client.worker.ts

@@ -1,250 +0,0 @@
-import path from "path";
-import fs from "fs";
-import { build as viteBuild, createServer, type ViteDevServer } from "vite";
-import { createWorker } from "@simplysm/core-node";
-import { err as errNs } from "@simplysm/core-common";
-import { consola } from "consola";
-import type { SdClientPackageConfig } from "../sd-config.types";
-import { parseRootTsconfig, getCompilerOptionsForPackage } from "../utils/tsconfig";
-import { createViteConfig } from "../utils/vite-config";
-import { collectDeps } from "../utils/package-utils";
-import { registerCleanupHandlers, createOnceGuard, applyDebugLevel } from "../utils/worker-utils";
-
-applyDebugLevel();
-
-//#region Types
-
-/**
- * Client build information (for one-time build)
- */
-export interface ClientBuildInfo {
-  name: string;
-  config: SdClientPackageConfig;
-  cwd: string;
-  pkgDir: string;
-}
-
-/**
- * Client build result
- */
-export interface ClientBuildResult {
-  success: boolean;
-  errors?: string[];
-}
-
-/**
- * Client watch information
- */
-export interface ClientWatchInfo {
-  name: string;
-  config: SdClientPackageConfig;
-  cwd: string;
-  pkgDir: string;
-  /** replaceDeps configuration from sd.config.ts */
-  replaceDeps?: Record<string, string>;
-}
-
-/**
- * Build event
- */
-export interface ClientBuildEvent {
-  success: boolean;
-  errors?: string[];
-}
-
-/**
- * Server ready event
- */
-export interface ClientServerReadyEvent {
-  port: number;
-}
-
-/**
- * Error event
- */
-export interface ClientErrorEvent {
-  message: string;
-}
-
-/**
- * Worker event types
- */
-export interface ClientWorkerEvents extends Record<string, unknown> {
-  buildStart: Record<string, never>;
-  build: ClientBuildEvent;
-  serverReady: ClientServerReadyEvent;
-  error: ClientErrorEvent;
-  scopeRebuild: Record<string, never>;
-}
-
-//#endregion
-
-//#region Resource Management
-
-const logger = consola.withTag("sd:cli:client:worker");
-
-/** Vite dev server (to be cleaned up) */
-let viteServer: ViteDevServer | undefined;
-
-/**
- * Clean up resources
- */
-async function cleanup(): Promise<void> {
-  // Capture global variable to temporary variable and initialize
-  // (other calls can modify global variable while Promise.all is waiting)
-  const serverToClose = viteServer;
-  viteServer = undefined;
-
-  if (serverToClose != null) {
-    await serverToClose.close();
-  }
-}
-
-// Clean up resources before process termination (SIGTERM/SIGINT)
-// Note: worker.terminate() terminates immediately without calling these handlers.
-// However, normal shutdown in watch mode is done through SIGINT/SIGTERM of main process, so no issues.
-registerCleanupHandlers(cleanup, logger);
-
-//#endregion
-
-//#region Worker
-
-/**
- * One-time build
- */
-async function build(info: ClientBuildInfo): Promise<ClientBuildResult> {
-  try {
-    // Parse tsconfig
-    const parsedConfig = parseRootTsconfig(info.cwd);
-    const tsconfigPath = path.join(info.cwd, "tsconfig.json");
-
-    // Create compilerOptions for browser target
-    const compilerOptions = await getCompilerOptionsForPackage(
-      parsedConfig.options,
-      "browser",
-      info.pkgDir,
-    );
-
-    // Create Vite configuration and build
-    const isCapacitor = info.config.capacitor != null;
-    const outDir = isCapacitor
-      ? path.join(info.pkgDir, ".capacitor", "www")
-      : undefined;
-
-    const viteConfig = createViteConfig({
-      pkgDir: info.pkgDir,
-      name: info.name,
-      tsconfigPath,
-      compilerOptions,
-      env: info.config.env,
-      mode: "build",
-      outDir,
-      base: isCapacitor ? "./" : undefined,
-      exclude: info.config.exclude,
-    });
-
-    await viteBuild(viteConfig);
-
-    // Generate .config.json
-    const confDistDir = outDir ?? path.join(info.pkgDir, "dist");
-    const confDistPath = path.join(confDistDir, ".config.json");
-    fs.writeFileSync(confDistPath, JSON.stringify(info.config.configs ?? {}, undefined, 2));
-
-    return { success: true };
-  } catch (err) {
-    return {
-      success: false,
-      errors: [errNs.message(err)],
-    };
-  }
-}
-
-const guardStartWatch = createOnceGuard("startWatch");
-
-/**
- * Start watch (Vite dev server)
- * @remarks This function should be called only once per worker.
- * @throws If watch is already started
- */
-async function startWatch(info: ClientWatchInfo): Promise<void> {
-  guardStartWatch();
-
-  try {
-    // Parse tsconfig
-    const parsedConfig = parseRootTsconfig(info.cwd);
-    const tsconfigPath = path.join(info.cwd, "tsconfig.json");
-
-    // Create compilerOptions for browser target
-    const compilerOptions = await getCompilerOptionsForPackage(
-      parsedConfig.options,
-      "browser",
-      info.pkgDir,
-    );
-
-    // If server is 0, auto-assign port (server-connected client)
-    // If server is a number, use that port (standalone client)
-    const serverPort = typeof info.config.server === "number" ? info.config.server : 0;
-
-    // Collect replaceDeps based on dependencies
-    const { replaceDeps } = collectDeps(info.pkgDir, info.cwd, info.replaceDeps);
-
-    // Create Vite configuration
-    const viteConfig = createViteConfig({
-      pkgDir: info.pkgDir,
-      name: info.name,
-      tsconfigPath,
-      compilerOptions,
-      env: info.config.env,
-      mode: "dev",
-      serverPort,
-      replaceDeps,
-      onScopeRebuild: () => sender.send("scopeRebuild", {}),
-      exclude: info.config.exclude,
-    });
-
-    // Start Vite dev server
-    viteServer = await createServer(viteConfig);
-    await viteServer.listen();
-
-    // Generate .config.json
-    const confDistPath = path.join(info.pkgDir, "dist", ".config.json");
-    fs.mkdirSync(path.dirname(confDistPath), { recursive: true });
-    fs.writeFileSync(confDistPath, JSON.stringify(info.config.configs ?? {}, undefined, 2));
-
-    // Get actual assigned port (config.server.port is the configured value, so get actual port from httpServer)
-    const address = viteServer.httpServer?.address();
-    const actualPort = typeof address === "object" && address != null ? address.port : undefined;
-
-    if (actualPort == null) {
-      sender.send("error", { message: "Unable to determine Vite dev server port." });
-      return;
-    }
-
-    sender.send("serverReady", { port: actualPort });
-  } catch (err) {
-    sender.send("error", {
-      message: errNs.message(err),
-    });
-  }
-}
-
-/**
- * Stop watch
- * @remarks Clean up Vite dev server.
- */
-async function stopWatch(): Promise<void> {
-  await cleanup();
-}
-
-const sender = createWorker<
-  { build: typeof build; startWatch: typeof startWatch; stopWatch: typeof stopWatch },
-  ClientWorkerEvents
->({
-  build,
-  startWatch,
-  stopWatch,
-});
-
-export default sender;
-
-//#endregion