sh-ui-cli 0.97.0 → 0.98.1

package/README.md

@@ -22,7 +22,7 @@ npx sh-ui-cli create
 
 # 비대화형 (에이전트 / CI)
 npx sh-ui-cli create my-app --platform next --structure standalone --yes
-npx sh-ui-cli create my-app --platform next --structure monorepo --plugins sentry,next-intl,auth-jwt --yes
+npx sh-ui-cli create my-app --platform next --structure monorepo --plugins next-intl --yes
 npx sh-ui-cli create my-app --platform flutter --yes
 ```
 

package/data/changelog/versions.json

@@ -2,6 +2,31 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.98.1",
+      "date": "2026-05-19",
+      "title": "크로스컴포넌트 상대 import 를 aliases.components 로 재작성 — NodeNext 소비자 호환",
+      "type": "patch",
+      "highlights": [
+        "**크로스컴포넌트 import 가 이제 `aliases.components` 경유로 emit** — `sidebar`(→popover), `calendar`(→select), `date-picker`(→calendar), `markdown-editor`(→code-editor), `code-tabs`(→tabs/code-panel), `form-rhf`/`form-tanstack`/`form-yup`(→form) 등 형제 컴포넌트를 import 하던 모든 컴포넌트가, registry 의 `import … from \"../popover\"` 상대경로 대신 사용자 `sh-ui.config.json` 의 `aliases.components`(예: `@workspace/ui-core/components/popover`)로 재작성된다. `@SH_UI_UTILS@` → `aliases.utils` 치환과 동일한 add-time 변환.",
+        "**`moduleResolution: \"NodeNext\"`/`\"Node16\"` 소비자 깨짐 수정** — 상대경로/디렉터리 import 는 NodeNext 가 거부하고, 과거 일부 버전이 emit 한 `\"../popover/index.tsx\"` 의 명시적 `.tsx` 확장자는 TS5097 을 유발해 소비자가 `allowImportingTsExtensions`+`noEmit`(패키지 전체 declaration emit 비활성화) 같은 침습적 tsconfig 변경을 강요당했다. 이제 `\"Bundler\"`·`\"NodeNext\"` 양쪽에서 소비자 tsconfig 변경 없이 resolve 된다.",
+        "**add/remove 대칭 + registry 불변** — `remove` 의 unmodified 판정도 같은 재작성을 replay 해 형제-import 컴포넌트 삭제 시 '사용자 수정됨' false positive 가 나지 않는다. registry 소스·docs 듀얼카피·generated 산출물은 변경 없음(CLI 변환만). `aliases.components` 미설정 시 `@SH_UI_UTILS@` 와 동일한 톤의 친절 에러로 사전 안내. 회귀 단위 테스트 추가(전 스위트 407 통과, dual-copy drift 47 components 0)."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.98.1"
+    },
+    {
+      "version": "0.98.0",
+      "date": "2026-05-16",
+      "title": "auth-jwt · sentry 플러그인 제거 — 스캐폴더에서 두 통합 완전 삭제 (breaking)",
+      "type": "minor",
+      "highlights": [
+        "**`sentry` 플러그인 + `--observability` 옵션 제거 (breaking)** — Next 의 `--plugins sentry` 와 vite 전용 `--observability sentry` 를 둘 다 삭제. `sh_ui_create_project` · `sh_ui_add_app` · `sh_ui_describe_template` 의 `observability` 인자, `DescribeTemplateOptions.observability` 타입, `emitSentry()` 도 함께 제거. 이제 `--observability` 는 '알 수 없는 플래그', `--plugins sentry` 는 '알 수 없는 플러그인' 으로 거부된다.",
+        "**`auth-jwt` 플러그인 제거 (breaking)** — `--plugins auth-jwt` 및 auth-jwt+next-intl proxy.ts 병합 로직 삭제. `next-intl` 단독 scaffold 는 자체 proxy.ts 를 그대로 emit (회귀 가드 smoke 유지).",
+        "**유지: i18n / next-intl** — `--plugins next-intl` 과 vite `--i18n react-i18next` / `--locales` 는 그대로. 스캐폴더 플러그인은 이제 `next-intl` 단일. Sentry/JWT 는 프로젝트마다 설정이 갈려 baked-in scaffold 가치가 낮고, 특히 Sentry 의 Next 통합은 버전 churn 유지보수 부채라 의도적으로 축소.",
+        "**마이그레이션** — Sentry 가 필요하면 생성 후 공식 `@sentry/nextjs` 또는 `@sentry/react` 를 직접 추가. 인증은 프로젝트 백엔드 명세에 맞춰 직접 구성. docs `/plugins/sentry`·`/plugins/auth-jwt` 페이지 및 `/create` UI 토글 제거, smoke 시나리오 정리."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.98.0"
+    },
     {
       "version": "0.97.0",
       "date": "2026-05-16",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.97.0",
+  "version": "0.98.1",
   "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {

package/src/add.mjs

@@ -16,6 +16,8 @@ import {
   stripStylesImport,
   isStyleFile,
   isTsxFile,
+  hasCrossComponentImport,
+  rewriteCrossComponentImports,
 } from "./css-bundle.mjs";
 
 /**
@@ -96,26 +98,49 @@ function resolveDest(template, config) {
 }
 
 /**
- * registry source 안의 placeholder 를 사용자 config 값으로 치환.
- * 현재 지원: `@SH_UI_UTILS@` → `aliases.utils` (예: `@/src/shared/lib/utils`).
+ * registry source 안의 placeholder / 상대 import 를 사용자 config 값으로 치환.
  *
- * registry 컴포넌트는 cn 유틸을 `import { cn } from "@SH_UI_UTILS@"` 로 import 한다 —
- * CLI 가 add 시점에 사용자 프로젝트의 alias 로 치환해 TS module resolution 이 동작.
+ * 1) `@SH_UI_UTILS@` → `aliases.utils` (예: `@/src/shared/lib/utils`).
+ *    registry 컴포넌트는 cn 유틸을 `import { cn } from "@SH_UI_UTILS@"` 로
+ *    import 한다 — add 시점에 사용자 프로젝트 alias 로 치환해 module resolution 동작.
+ * 2) 크로스컴포넌트 상대 import (`from "../popover"` /
+ *    `from "../popover/index.tsx"` / `from "../form/types"`) →
+ *    `aliases.components` 경유 (예: `@workspace/ui-core/components/popover`).
+ *    상대경로/명시적 `.tsx` 확장자가 그대로 emit 되면 NodeNext 소비자가 깨지므로
+ *    (TS5097 → `allowImportingTsExtensions`+`noEmit` 강요), utils 와 동일하게
+ *    add 시점에 alias 로 정규화한다. 변환 규칙은 css-bundle.mjs 의
+ *    rewriteCrossComponentImports 참조 (remove.mjs 가 동일 함수로 대칭 replay).
  *
- * aliases.utils 가 미설정인데 placeholder 가 등장하면 친절 에러로 안내. 사용자가 매 컴포넌트
- * 추가 후 import 깨진 것을 발견하기 전에 시점에 잡는다.
+ * 해당 alias 가 미설정인데 placeholder/상대 import 가 등장하면 친절 에러로
+ * 안내 — 사용자가 매 컴포넌트 추가 후 import 깨진 것을 발견하기 전에 잡는다.
  */
 function substitutePlaceholders(content, config, srcRel) {
+  let out = content;
+
   const PLACEHOLDER = "@SH_UI_UTILS@";
-  if (!content.includes(PLACEHOLDER)) return content;
-  const alias = config.aliases?.utils;
-  if (!alias) {
-    throw new Error(
-      `${srcRel} 가 cn 유틸을 import 합니다. sh-ui.config.json 에 aliases.utils 를 설정하세요.\n` +
-        `  예: "aliases": { "utils": "@/src/lib/utils" }`,
-    );
+  if (out.includes(PLACEHOLDER)) {
+    const alias = config.aliases?.utils;
+    if (!alias) {
+      throw new Error(
+        `${srcRel} 가 cn 유틸을 import 합니다. sh-ui.config.json 에 aliases.utils 를 설정하세요.\n` +
+          `  예: "aliases": { "utils": "@/src/lib/utils" }`,
+      );
+    }
+    out = out.replaceAll(PLACEHOLDER, alias);
   }
-  return content.replaceAll(PLACEHOLDER, alias);
+
+  if (hasCrossComponentImport(out)) {
+    const componentsAlias = config.aliases?.components;
+    if (!componentsAlias) {
+      throw new Error(
+        `${srcRel} 가 다른 sh-ui 컴포넌트를 import 합니다. sh-ui.config.json 에 aliases.components 를 설정하세요.\n` +
+          `  예: "aliases": { "components": "@/src/components" }`,
+      );
+    }
+    out = rewriteCrossComponentImports(out, componentsAlias);
+  }
+
+  return out;
 }
 
 async function ensureDir(filePath) {

package/src/api.d.ts

@@ -143,8 +143,6 @@ export interface DescribeTemplateOptions {
   i18n?: 'none' | 'react-i18next';
   /** i18n 활성화 시 생성할 locale 코드 (comma-separated). 기본 'ko,en' */
   locales?: string;
-  /** vite 전용 — Sentry observability opt-in. v0.93.0+ */
-  observability?: 'none' | 'sentry';
 }
 
 export interface DescribeTemplateGroup {

package/src/constants.js

@@ -60,8 +60,3 @@ export const INIT_DEFAULTS = {
 export const I18N_LIBRARIES = ['none', 'react-i18next'];
 export const I18N_DEFAULT = 'none';
 export const I18N_DEFAULT_LOCALES = 'ko,en';
-
-// ─── observability (vite preset 전용 — v0.93.0+) ───
-// 'none' 디폴트 — opt-in 으로 @sentry/react + @sentry/vite-plugin 설치 + 셋업.
-// GlitchTip self-hosted 도 같은 SDK — DSN 만 변경. 향후 bugsnag 등 추가 시 enum 확장.
-export const OBSERVABILITY_PROVIDERS = ['none', 'sentry'];

package/src/create/cli-args.js

@@ -4,7 +4,6 @@ import {
   CSS_FRAMEWORKS_SUPPORTED,
   CSS_FRAMEWORKS_PLANNED,
   I18N_LIBRARIES,
-  OBSERVABILITY_PROVIDERS,
 } from '../constants.js';
 import { allPlugins } from './plugins/index.js';
 import { allArchitectures } from './architectures/index.js';
@@ -14,7 +13,7 @@ const VALID_STRUCTURES = CREATE_STRUCTURES;
 const VALID_PLUGINS = allPlugins.map((p) => p.name);
 const VALID_ARCHES = allArchitectures.map((a) => a.name);
 
-const VALUE_FLAGS = ['platform', 'structure', 'plugins', 'theme', 'app', 'css', 'arch', 'port', 'i18n', 'locales', 'observability'];
+const VALUE_FLAGS = ['platform', 'structure', 'plugins', 'theme', 'app', 'css', 'arch', 'port', 'i18n', 'locales'];
 const BOOL_FLAGS = ['yes', 'help', 'dry-run'];
 
 const SUBCOMMANDS = ['add-app', 'add-component'];
@@ -80,9 +79,6 @@ export const parseArgs = (argv) => {
     if (name === 'i18n' && !I18N_LIBRARIES.includes(value)) {
       throw new Error(`--i18n 은 ${I18N_LIBRARIES.join('/')} 중 하나여야 함 (받은 값: ${value})`);
     }
-    if (name === 'observability' && !OBSERVABILITY_PROVIDERS.includes(value)) {
-      throw new Error(`--observability 는 ${OBSERVABILITY_PROVIDERS.join('/')} 중 하나여야 함 (받은 값: ${value})`);
-    }
     if (name === 'css' && !CSS_FRAMEWORKS_SUPPORTED.includes(value)) {
       // planned 값은 '곧 옵니다' 신호로 분기 — 사용자 의도가 더 명확히 전달.
       if (CSS_FRAMEWORKS_PLANNED.includes(value)) {

package/src/create/describeTemplate.js

@@ -31,13 +31,12 @@ import { CSS_FRAMEWORK_DEFAULT } from '../constants.js';
  * @property {'next'|'flutter'|'vite'} [platform]
  * @property {'standalone'|'monorepo'} [structure]   next/vite 일 때만 의미
  * @property {string} [arch]                          next 일 때 'fsd'|'flat'|'mes'
- * @property {string[]} [plugins]                     ['sentry', 'next-intl', 'auth-jwt']
+ * @property {string[]} [plugins]                     ['next-intl']
  * @property {'tailwind'|'plain'|'css-modules'} [cssFramework]
  * @property {string} [projectName]
  * @property {string} [appName]                       monorepo 첫 앱 이름. 기본 'web'
  * @property {'none'|'react-i18next'} [i18n]          vite 전용 — react-i18next 셋업
  * @property {string} [locales]                       i18n 활성화 시 생성할 locale 코드 (comma-separated, default 'ko,en')
- * @property {'none'|'sentry'} [observability]        vite 전용 — Sentry 셋업 (v0.93.0+)
  */
 
 /**
@@ -67,7 +66,6 @@ export function describeTemplate(opts = {}) {
     appName: rawAppName = 'web',
     i18n = 'none',
     locales = 'ko,en',
-    observability = 'none',
   } = opts;
 
   if (platform === 'flutter') {
@@ -108,17 +106,6 @@ export function describeTemplate(opts = {}) {
         ];
         groups.push(makeGroup('i18n', `i18n (${i18n})`, i18nFiles));
       }
-      if (observability === 'sentry') {
-        const isFsd = safeArchName === 'fsd';
-        const obsBase = isFsd ? 'src/shared/observability' : 'src/lib/observability';
-        const providersBase = isFsd ? 'src/app/providers' : 'src/components/providers';
-        groups.push(makeGroup('sentry', `Sentry observability`, [
-          `${obsBase}/sentry.ts`,
-          `${obsBase}/index.ts`,
-          `${providersBase}/SentryProvider.tsx`,
-          '.env.example',
-        ]));
-      }
       return finalize(groups);
     }
 
@@ -174,18 +161,6 @@ export function describeTemplate(opts = {}) {
       groups.push(makeGroup('i18n', `i18n (${i18n}, apps/${appName}/)`, i18nFiles));
     }
 
-    if (observability === 'sentry') {
-      const isFsd = safeArchName === 'fsd';
-      const obsBase = isFsd ? 'src/shared/observability' : 'src/lib/observability';
-      const providersBase = isFsd ? 'src/app/providers' : 'src/components/providers';
-      groups.push(makeGroup('sentry', `Sentry observability (apps/${appName}/)`, [
-        `apps/${appName}/${obsBase}/sentry.ts`,
-        `apps/${appName}/${obsBase}/index.ts`,
-        `apps/${appName}/${providersBase}/SentryProvider.tsx`,
-        `apps/${appName}/.env.example`,
-      ]));
-    }
-
     return finalize(groups);
   }
 
@@ -280,13 +255,9 @@ function buildNextGroups({ prefix, templateKey, arch, plugins, cssFramework }) {
   // generator.js applyCssFrameworkVariant 와 동일한 분기 — intl 활성 시 [locale]/, 아니면 app/.
   if (cssFramework === 'css-modules') {
     const intlActive = plugins.some((p) => p.name === 'next-intl');
-    const sentryActive = plugins.some((p) => p.name === 'sentry');
     const cssPaths = [];
     const pageDir = intlActive ? 'app/[locale]' : 'app';
     cssPaths.push(`${prefix}${pageDir}/page.module.css`);
-    if (sentryActive) {
-      cssPaths.push(`${prefix}${pageDir}/error.module.css`);
-    }
     groups.push(makeGroup(
       'css',
       'CSS: css-modules 변종',
@@ -337,7 +308,7 @@ function applyMovesAndDeletes(groups, moves, deletes) {
   const added = [];
   for (const { from, to } of moves) {
     const removed = removeFromAllGroups(groups, from);
-    // 원본이 어디에도 없었다면 (예: sentry 비활성 상태에서 error.tsx 이동) — 새로
+    // 원본이 어디에도 없었다면 (move 소스가 현재 file-plan 에 없음) — 새로
     // 추가하지 않는다. generator.js 의 `if (await fs.pathExists(fromPath))` 시맨틱.
     if (removed) added.push(to);
   }