@simplysm/sd-cli 14.0.29 → 14.0.32

package/src/utils/hmr-candidates.ts

@@ -1,327 +0,0 @@
-import ts from "typescript";
-import type { NgtscProgram } from "./angular-build.js";
-
-type NgCompiler = NgtscProgram["compiler"];
-
-/**
- * HMR에서 지원하는 Angular @Component 메타데이터 필드 이름.
- * 이 필드만 변경된 경우 HMR 후보로 판정된다.
- */
-const SUPPORTED_FIELD_NAMES = new Set([
-  "template",
-  "templateUrl",
-  "styles",
-  "styleUrl",
-  "stylesUrl",
-]);
-
-const enum MetaUpdateAnalysis {
-  Supported = 0,
-  Unsupported = 1,
-  None = 2,
-}
-
-/**
- * 수정된 파일들을 분석하여 HMR 후보 컴포넌트를 수집한다.
- * 하나의 파일이라도 비지원 변경이면 전체 HMR을 취소한다 (all-or-nothing).
- */
-export function collectHmrCandidates(
-  modifiedFiles: ReadonlySet<string>,
-  compiler: NgCompiler,
-  staleSourceFiles: ReadonlyMap<string, ts.SourceFile>,
-): Set<ts.ClassDeclaration> {
-  const candidates = new Set<ts.ClassDeclaration>();
-
-  for (const file of modifiedFiles) {
-    // 템플릿 파일이면 해당 컴포넌트를 후보에 추가
-    const templateFileNodes = compiler.getComponentsWithTemplateFile(file);
-    if (templateFileNodes.size > 0) {
-      for (const node of templateFileNodes) {
-        candidates.add(node as ts.ClassDeclaration);
-      }
-      continue;
-    }
-
-    // 스타일 파일이면 해당 컴포넌트를 후보에 추가
-    const styleFileNodes = compiler.getComponentsWithStyleFile(file);
-    if (styleFileNodes.size > 0) {
-      for (const node of styleFileNodes) {
-        candidates.add(node as ts.ClassDeclaration);
-      }
-      continue;
-    }
-
-    // stale source가 없으면 전체 무효화
-    const staleSource = staleSourceFiles.get(file);
-    if (staleSource === undefined) {
-      candidates.clear();
-      break;
-    }
-
-    // current source가 없으면 전체 무효화
-    const updatedSource = compiler.getCurrentProgram().getSourceFile(file);
-    if (updatedSource === undefined) {
-      candidates.clear();
-      break;
-    }
-
-    // AST 비교로 HMR 후보 분석
-    const fileCandidates = analyzeFileUpdates(staleSource, updatedSource, compiler);
-    if (fileCandidates != null) {
-      for (const node of fileCandidates) {
-        candidates.add(node);
-      }
-    } else {
-      // 비지원 변경 → 전체 무효화
-      candidates.clear();
-      break;
-    }
-  }
-
-  return candidates;
-}
-
-/**
- * stale/current 소스 파일의 AST를 비교하여 HMR 후보를 판별한다.
- * @returns HMR 후보 ClassDeclaration 배열. null이면 비지원 변경.
- */
-export function analyzeFileUpdates(
-  stale: ts.SourceFile,
-  updated: ts.SourceFile,
-  compiler?: NgCompiler,
-): ts.ClassDeclaration[] | null {
-  if (stale.statements.length !== updated.statements.length) {
-    return null;
-  }
-
-  const candidates: ts.ClassDeclaration[] = [];
-
-  for (let i = 0; i < updated.statements.length; ++i) {
-    const updatedNode = updated.statements[i];
-    const staleNode = stale.statements[i];
-
-    if (ts.isClassDeclaration(updatedNode)) {
-      if (!ts.isClassDeclaration(staleNode)) {
-        return null;
-      }
-
-      // name 비교
-      if (updatedNode.name?.text !== staleNode.name?.text) {
-        return null;
-      }
-
-      // heritage 비교
-      if (!equalRangeText(updatedNode.heritageClauses, updated, staleNode.heritageClauses, stale)) {
-        return null;
-      }
-
-      // modifiers 비교
-      const updatedModifiers = ts.getModifiers(updatedNode);
-      const staleModifiers = ts.getModifiers(staleNode);
-      if (
-        updatedModifiers?.length !== staleModifiers?.length ||
-        !updatedModifiers?.every((updatedModifier) =>
-          staleModifiers?.some((staleModifier) => updatedModifier.kind === staleModifier.kind),
-        )
-      ) {
-        return null;
-      }
-
-      // @Component 메타 확인 (compiler 없으면 non-component로 취급)
-      if (compiler != null) {
-        const meta = (compiler as any).getMeta(updatedNode);
-        if (meta?.decorator != null && meta.isComponent === true) {
-          const updatedDecorators = ts.getDecorators(updatedNode);
-          const staleDecorators = ts.getDecorators(staleNode);
-
-          if (
-            staleDecorators == null ||
-            staleDecorators.length !== updatedDecorators?.length
-          ) {
-            return null;
-          }
-
-          // 다중 데코레이터는 미지원
-          if (staleDecorators.length > 1) {
-            return null;
-          }
-
-          // 데코레이터 인덱스 확인
-          const metaDecoratorIndex = updatedDecorators.indexOf(meta.decorator);
-          if (metaDecoratorIndex < 0) {
-            return null;
-          }
-
-          const updatedDecoratorExpression = meta.decorator.expression;
-          if (
-            !ts.isCallExpression(updatedDecoratorExpression) ||
-            updatedDecoratorExpression.arguments.length !== 1
-          ) {
-            return null;
-          }
-
-          const staleDecoratorExpression = staleDecorators[metaDecoratorIndex].expression;
-          if (
-            !ts.isCallExpression(staleDecoratorExpression) ||
-            staleDecoratorExpression.arguments.length !== 1
-          ) {
-            return null;
-          }
-
-          // 데코레이터 이름/expression 비교
-          if (
-            !equalRangeText(
-              updatedDecoratorExpression.expression,
-              updated,
-              staleDecoratorExpression.expression,
-              stale,
-            )
-          ) {
-            return null;
-          }
-
-          // 메타데이터 비교
-          const analysis = analyzeMetaUpdates(
-            staleDecoratorExpression,
-            stale,
-            updatedDecoratorExpression,
-            updated,
-          );
-          if (analysis === MetaUpdateAnalysis.Unsupported) {
-            return null;
-          }
-
-          // 클래스 멤버 비교
-          if (!equalRangeText(updatedNode.members, updated, staleNode.members, stale)) {
-            return null;
-          }
-
-          // 지원 변경이면 후보에 추가
-          if (analysis === MetaUpdateAnalysis.Supported) {
-            candidates.push(updatedNode);
-          }
-          continue;
-        }
-      }
-
-      // non-component 클래스: 텍스트 변경 확인
-      if (!equalRangeText(updatedNode, updated, staleNode, stale)) {
-        return null;
-      }
-      continue;
-    }
-
-    // 기타 statement: 텍스트 비교
-    if (!equalRangeText(updatedNode, updated, staleNode, stale)) {
-      return null;
-    }
-  }
-
-  return candidates;
-}
-
-/**
- * @Component 데코레이터의 메타데이터 필드를 비���한다.
- * 지원 필드만 변경되었으면 Supported, 비지원 필드가 변경되면 Unsupported.
- */
-function analyzeMetaUpdates(
-  staleCall: ts.CallExpression,
-  staleSource: ts.SourceFile,
-  updatedCall: ts.CallExpression,
-  updatedSource: ts.SourceFile,
-): MetaUpdateAnalysis {
-  const staleObject = staleCall.arguments[0];
-  const updatedObject = updatedCall.arguments[0];
-
-  if (
-    !ts.isObjectLiteralExpression(staleObject) ||
-    !ts.isObjectLiteralExpression(updatedObject)
-  ) {
-    return MetaUpdateAnalysis.Unsupported;
-  }
-
-  let hasSupportedUpdate = false;
-  const supportedFields = new Map<string, ts.Expression>();
-  const unsupportedFields: ts.Expression[] = [];
-
-  for (const property of staleObject.properties) {
-    if (!ts.isPropertyAssignment(property) || ts.isComputedPropertyName(property.name)) {
-      return MetaUpdateAnalysis.Unsupported;
-    }
-    const name = (property.name as ts.Identifier).text;
-    if (SUPPORTED_FIELD_NAMES.has(name)) {
-      supportedFields.set(name, property.initializer);
-      continue;
-    }
-    unsupportedFields.push(property.initializer);
-  }
-
-  let unsupportedIdx = 0;
-  for (const property of updatedObject.properties) {
-    if (!ts.isPropertyAssignment(property) || ts.isComputedPropertyName(property.name)) {
-      return MetaUpdateAnalysis.Unsupported;
-    }
-    const name = (property.name as ts.Identifier).text;
-    if (SUPPORTED_FIELD_NAMES.has(name)) {
-      const staleInitializer = supportedFields.get(name);
-      if (
-        staleInitializer == null ||
-        !equalRangeText(property.initializer, updatedSource, staleInitializer, staleSource)
-      ) {
-        hasSupportedUpdate = true;
-      }
-      supportedFields.delete(name);
-      continue;
-    }
-    if (
-      !equalRangeText(
-        property.initializer,
-        updatedSource,
-        unsupportedFields[unsupportedIdx++],
-        staleSource,
-      )
-    ) {
-      return MetaUpdateAnalysis.Unsupported;
-    }
-  }
-
-  if (unsupportedIdx !== unsupportedFields.length) {
-    return MetaUpdateAnalysis.Unsupported;
-  }
-
-  // 남은 supported field가 있으면 삭제된 것 → supported update
-  hasSupportedUpdate ||= supportedFields.size > 0;
-
-  return hasSupportedUpdate ? MetaUpdateAnalysis.Supported : MetaUpdateAnalysis.None;
-}
-
-/**
- * 두 소스 파일에서 지정된 범위의 텍스트를 비교한다.
- * 중간 문자열 복사를 피하여 효율적으로 비교한다.
- */
-function equalRangeText(
-  firstRange: ts.TextRange | ts.NodeArray<ts.Node> | undefined,
-  firstSource: ts.SourceFile,
-  secondRange: ts.TextRange | ts.NodeArray<ts.Node> | undefined,
-  secondSource: ts.SourceFile,
-): boolean {
-  if (firstRange == null || secondRange == null) {
-    return firstRange === secondRange;
-  }
-
-  const firstLength = firstRange.end - firstRange.pos;
-  const secondLength = secondRange.end - secondRange.pos;
-  if (firstLength !== secondLength) {
-    return false;
-  }
-
-  for (let i = 0; i < firstLength; ++i) {
-    if (
-      firstSource.text.charCodeAt(i + firstRange.pos) !==
-      secondSource.text.charCodeAt(i + secondRange.pos)
-    ) {
-      return false;
-    }
-  }
-  return true;
-}

package/src/utils/vite-config.ts

@@ -1,318 +0,0 @@
-import type { InlineConfig, PluginOption } from "vite";
-import path from "path";
-import tsconfigPaths from "vite-tsconfig-paths";
-import browserslistToEsbuild from "browserslist-to-esbuild";
-import { sdAngularPlugin } from "../angular/vite-angular-plugin.js";
-import solidPlugin from "vite-plugin-solid";
-import {
-  sdScopeWatchPlugin,
-  type ScopeWatchReplaceDep,
-} from "./vite-scope-watch-plugin.js";
-import { sdPostCssInlinePlugin } from "../angular/vite-postcss-inline-plugin.js";
-import type { SdPwaConfig } from "../sd-config.types.js";
-import { VitePWA } from "vite-plugin-pwa";
-import { generatePwaIcons } from "./generate-pwa-icons.js";
-import { loadSdConfig } from "./sd-config.js";
-
-/** createClientViteConfig 옵션 */
-export interface CreateClientViteConfigOptions {
-  /** 클라이언트 프레임워크 선택. 미지정 시 "angular" */
-  framework?: "angular" | "solid";
-  /** 패키지 디렉토리 경로 */
-  pkgDir: string;
-  /** 패키지명 (예: "@scope/my-client") */
-  pkgName: string;
-  /** 모드 */
-  mode: "dev" | "build";
-  /** Vite dev server 포트 (0: 자동 할당, >0: 지정) */
-  serverPort: number;
-  /** 빌드 시 치환할 환경변수 */
-  env?: Record<string, string>;
-  /** rebuild 시작 콜백 (CLI 상태 보고용) */
-  onBuildStart?: () => void;
-  /** rebuild 완료 콜백 (CLI 상태 보고용) */
-  onBuild?: (result: {
-    success: boolean;
-    errors?: string[];
-    warnings?: string[];
-  }) => void;
-  /** replaceDeps 목록 (dev 모드에서 sdScopeWatchPlugin에 전달) */
-  replaceDeps?: ScopeWatchReplaceDep[];
-  /** replaceDeps 변경 감지 콜백 */
-  onScopeRebuild?: () => void;
-  /** polyfills 경로 배열 (transformIndexHtml로 주입) */
-  polyfills?: string[];
-  /** PWA 설정. false로 비활성화. 미설정 시 기본값으로 활성화 */
-  pwa?: false | SdPwaConfig;
-  /** Vite optimizeDeps.exclude에 전달할 패키지 목록 */
-  exclude?: string[];
-  /** watch 모드 (build.watch 활성화, emptyOutDir: false) */
-  watch?: boolean;
-  /** 빌드 출력 경로 (미설정 시 pkgDir/dist) */
-  outDir?: string;
-  /** Vite base 경로 (미설정 시 /{pkgName}/) */
-  base?: string;
-}
-
-/**
- * Client Vite 설정을 생성한다. dev/build 모드에서 공용으로 사용한다.
- *
- * Angular AOT 플러그인, tsconfigPaths, env define, server/build 기본 설정,
- * browserslist, PostCSS, polyfills, legacyModule (inlineDynamicImports) 등을 통합 구성한다.
- */
-export async function createClientViteConfig(
-  options: CreateClientViteConfigOptions,
-): Promise<InlineConfig> {
-  const name = options.pkgName.replace(/^@[^/]+\//, "");
-
-  // sd.config.ts 로딩 + browserSupport 추출
-  const sdConfig = await loadSdConfig({ cwd: process.cwd(), dev: options.mode === "dev", opt: [] });
-  const pkgConfig = sdConfig.packages[name];
-  if (pkgConfig == null) {
-    throw new Error(`sd.config.ts에 패키지 "${name}"가 정의되어 있지 않습니다.`);
-  }
-  const browserSupport = pkgConfig.target === "client" ? pkgConfig.browserSupport : undefined;
-  const browserslist = browserSupport?.browserslist;
-  const postCssPlugins = browserSupport?.postCss?.plugins;
-  const legacyModule = browserSupport?.legacyModule === true;
-
-  // browserslist → esbuild target
-  let esbuildTarget: string | string[] = "es2022";
-  if (browserslist != null) {
-    const queries = Array.isArray(browserslist)
-      ? browserslist
-      : [browserslist];
-    esbuildTarget = browserslistToEsbuild(queries);
-  }
-
-  // define: 환경변수 주입 (import.meta.env.KEY → Vite가 bare import.meta.env 객체를 자동 구성)
-  const define: Record<string, string> = {};
-  if (options.env != null) {
-    for (const [key, value] of Object.entries(options.env)) {
-      define[`import.meta.env.${key}`] = JSON.stringify(value);
-    }
-  }
-
-  // plugins
-  const plugins: PluginOption[] = [
-    tsconfigPaths(),
-  ];
-
-  if (options.framework === "solid") {
-    plugins.push(solidPlugin());
-  } else {
-    plugins.push(
-      sdAngularPlugin({
-        pkg: name,
-        onBuildStart: options.onBuildStart,
-        onBuild: options.onBuild,
-      }),
-    );
-
-    // PostCSS inline plugin (Angular @Component inline styles 전용)
-    if (postCssPlugins != null && postCssPlugins.length > 0) {
-      plugins.push(
-        sdPostCssInlinePlugin({ postCssPlugins: postCssPlugins }),
-      );
-    }
-  }
-
-  // replaceDeps HMR (dev 모드 또는 watch 모드)
-  if (
-    (options.mode === "dev" || options.watch === true) &&
-    options.replaceDeps != null &&
-    options.replaceDeps.length > 0
-  ) {
-    plugins.push(
-      sdScopeWatchPlugin({
-        pkgDir: options.pkgDir,
-        replaceDeps: options.replaceDeps,
-        onScopeRebuild: options.onScopeRebuild,
-      }),
-    );
-  }
-
-  // server 설정 (dev 모드만)
-  const serverConfig =
-    options.mode === "dev"
-      ? {
-          host: options.serverPort === 0 ? "127.0.0.1" : "0.0.0.0",
-          port: options.serverPort === 0 ? undefined : options.serverPort,
-          strictPort: options.serverPort !== 0,
-        }
-      : undefined;
-
-  // css.postcss 설정 (외부 .css/.scss 파일용)
-  const cssConfig =
-    postCssPlugins != null && postCssPlugins.length > 0
-      ? { postcss: { plugins: postCssPlugins as import("postcss").AcceptedPlugin[] } }
-      : undefined;
-
-  // optimizeDeps.exclude (사용자 지정 exclude + replaceDeps 패키지)
-  const excludeList = [
-    ...(options.exclude ?? []),
-    ...(options.replaceDeps?.map((dep) => dep.packageName) ?? []),
-  ];
-  const optimizeDepsConfig =
-    excludeList.length > 0 ? { exclude: excludeList } : undefined;
-
-  const config: InlineConfig = {
-    root: options.pkgDir,
-    base: options.base ?? `/${name}/`,
-    define: Object.keys(define).length > 0 ? define : undefined,
-    plugins,
-    server: serverConfig,
-    css: cssConfig,
-    esbuild: {
-      target: esbuildTarget,
-    },
-    build: {
-      target: esbuildTarget,
-    },
-    optimizeDeps: {
-      ...optimizeDepsConfig,
-      esbuildOptions: {
-        target: esbuildTarget,
-      },
-    },
-  };
-
-  // PWA (build 모드 + pwa !== false)
-  if (options.mode === "build" && options.pwa !== false) {
-    const pwaConfig = typeof options.pwa === "object" ? options.pwa : {};
-
-    // 아이콘 자동 생성 (커스텀 icons 미설정 시)
-    let iconsConfig: Record<string, unknown> = {};
-    if (pwaConfig.manifest?.icons != null) {
-      iconsConfig = { icons: pwaConfig.manifest.icons };
-    } else {
-      const generatedIcons = await generatePwaIcons(options.pkgDir);
-      if (generatedIcons.length > 0) {
-        iconsConfig = { icons: generatedIcons };
-      }
-    }
-
-    const pwaManifest = {
-      name: pwaConfig.manifest?.name ?? name,
-      short_name: pwaConfig.manifest?.short_name ?? name,
-      display: pwaConfig.manifest?.display ?? "standalone",
-      theme_color: pwaConfig.manifest?.theme_color ?? "#ffffff",
-      background_color: pwaConfig.manifest?.background_color ?? "#ffffff",
-      ...iconsConfig,
-    };
-    const pwaWorkbox = {
-      globPatterns: pwaConfig.workbox?.globPatterns ?? [
-        "**/*.{js,css,html,ico,png,svg,woff2}",
-      ],
-    };
-    (config.plugins as PluginOption[]).push(
-      VitePWA({
-        registerType: "prompt",
-        injectRegister: "script",
-        manifest: pwaManifest,
-        workbox: pwaWorkbox,
-      }),
-    );
-  }
-
-  // polyfills plugin
-  if (options.polyfills != null && options.polyfills.length > 0) {
-    const polyfillImports = options.polyfills;
-    if (legacyModule === true) {
-      // legacyModule: 메인 엔트리의 transform에서 polyfill import를 상단에 주입한다.
-      // transformIndexHtml의 인라인 <script type="module">은 Vite 빌드에서 번들링되지 않으므로,
-      // Rollup이 처리할 수 있도록 소스 코드 레벨에서 주입한다.
-      const mainEntryPath = path.resolve(options.pkgDir, "src/main.ts");
-      (config.plugins as PluginOption[]).push({
-        name: "sd-polyfills",
-        transform(code, id) {
-          if (path.normalize(id) !== path.normalize(mainEntryPath)) return null;
-          // polyfillImports는 pkgDir 기준 상대경로 (예: "./src/polyfills.ts")
-          // main.ts는 src/ 안에 있으므로, main.ts 기준 상대경로로 변환한다
-          const mainDir = path.dirname(mainEntryPath);
-          const polyfillCode = polyfillImports
-            .map((p) => {
-              const abs = path.resolve(options.pkgDir, p);
-              this.addWatchFile(abs);
-              const rel = path.relative(mainDir, abs);
-              const posixRel = rel.replace(/\\/g, "/");
-              return "import \"./" + posixRel + "\";";
-            })
-            .join("\n");
-          return { code: polyfillCode + "\n" + code, map: null };
-        },
-      });
-    } else {
-      // dev 모드: transformIndexHtml로 인라인 스크립트 주입 (Vite dev server가 처리)
-      (config.plugins as PluginOption[]).push({
-        name: "sd-polyfills",
-        transformIndexHtml() {
-          return [
-            {
-              tag: "script",
-              attrs: { type: "module" },
-              children: polyfillImports.map((p) => `import "${p}";`).join("\n"),
-              injectTo: "head-prepend" as const,
-            },
-          ];
-        },
-      });
-    }
-  }
-
-  // legacyModule: true → 코드 스플리팅 비활성화 + esbuild import.meta 변환 + 잔여 import() 제거
-  if (legacyModule === true) {
-    config.esbuild = {
-      ...config.esbuild,
-      supported: {
-        "import-meta": false,
-      },
-    };
-    config.build = {
-      ...config.build,
-      rollupOptions: {
-        output: {
-          inlineDynamicImports: true,
-        },
-      },
-    };
-
-    // Rollup이 인라인하지 못한 잔여 dynamic import()를 제거한다.
-    // inlineDynamicImports가 정적 경로를 모두 인라인한 후에도,
-    // @vite-ignore나 런타임 계산 경로의 import()가 남을 수 있다.
-    // Chrome 61은 import() 구문을 파싱하지 못하므로 no-op 함수로 치환한다.
-    (config.plugins as PluginOption[]).push({
-      name: "sd-legacy-strip-dynamic-import",
-      enforce: "post",
-      renderChunk(code) {
-        if (!code.includes("import(")) return null;
-        return {
-          code: code.replace(
-            /\bimport\s*\(/g,
-            "(function(){return Promise.reject(new Error(\"Dynamic import not supported\"))})(",
-          ),
-          map: null,
-        };
-      },
-    });
-  }
-
-  // build 모드 설정 (프로덕션 빌드 또는 legacyModule dev)
-  if (options.mode === "build" || legacyModule === true) {
-    config.build = {
-      ...config.build,
-      outDir: options.outDir ?? path.join(options.pkgDir, "dist"),
-    };
-    if (options.watch === true) {
-      config.build.watch = {};
-      config.build.emptyOutDir = false;
-      config.build.minify = false;
-      config.build.sourcemap = true;
-    } else {
-      config.logLevel = "silent";
-      config.build.emptyOutDir = true;
-    }
-  }
-
-  return config;
-}