@xfilecom/xframe 0.1.21 → 0.1.23

package/defaults.json

@@ -1,4 +1,4 @@
 {
-  "backendCore": "^1.0.2",
-  "frontCore": "^0.2.7"
+  "backendCore": "^1.0.4",
+  "frontCore": "^0.2.9"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfilecom/xframe",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "Scaffold full-stack app: Nest + @xfilecom/backend-core, Vite/React + @xfilecom/front-core",
   "license": "UNLICENSED",
   "bin": {
@@ -13,7 +13,8 @@
   ],
   "scripts": {
     "sync-defaults": "node scripts/sync-defaults.js",
-    "prepublishOnly": "npm run sync-defaults"
+    "sync-template-front-core": "node scripts/sync-template-front-core.js",
+    "prepublishOnly": "npm run sync-defaults && npm run sync-template-front-core"
   },
   "engines": {
     "node": ">=18"

package/template/apps/api/package.json

@@ -3,9 +3,10 @@
   "version": "0.0.1",
   "private": true,
   "scripts": {
-    "build": "nest build",
-    "start": "nest build && node --enable-source-maps dist/apps/api/src/main.js",
-    "start:dev": "tsc-watch -p tsconfig.build.json --onSuccess \"node --enable-source-maps dist/apps/api/src/main.js\" --noClear",
+    "build": "nest build && tsc-alias -p tsconfig.build.json",
+    "start": "npm run build && node --enable-source-maps dist/apps/api/src/main.js",
+    "start:dev:run": "tsc-alias -p tsconfig.build.json && node --enable-source-maps dist/apps/api/src/main.js",
+    "start:dev": "tsc-watch -p tsconfig.build.json --onSuccess \"npm run start:dev:run\" --noClear",
     "start:prod": "node --enable-source-maps dist/apps/api/src/main.js"
   },
   "dependencies": {
@@ -20,6 +21,7 @@
     "@nestjs/cli": "^10.0.0",
     "@types/express": "^4.17.21",
     "@types/node": "^20.0.0",
+    "tsc-alias": "^1.8.10",
     "tsc-watch": "^6.2.1",
     "typescript": "^5.0.0"
   }

package/template/apps/api/src/app.module.ts

@@ -5,7 +5,7 @@ import { AppController } from './app.controller';
 import { AppService } from './app.service';
 import { SqlQueryController } from './sql-query/sql-query.controller';
 import { SqlQueryService } from './sql-query/sql-query.service';
-import { schema } from '../../../shared/schema';
+import { schema } from '@shared/schema';
 
 function coreOptionsFromYaml(): CoreModuleOptions {
   const c = appConfig.core;

package/template/apps/api/src/sql-query/sql-query.controller.ts

@@ -8,7 +8,7 @@ import {
 } from '@nestjs/common';
 import { ControllerHelpers, Public } from '@xfilecom/backend-core';
 import { appConfig } from '../config.loader';
-import type { SqlDatabaseListPostBody, SqlListPostBody } from '../../../../shared/sql/sql';
+import type { SqlDatabaseListPostBody, SqlListPostBody } from '@shared/sql/sql';
 import { SqlQueryService } from './sql-query.service';
 
 /**

package/template/apps/api/src/sql-query/sql-query.service.ts

@@ -11,13 +11,13 @@ import {
   listPageableColumnNames,
   pageableFromClause,
   pickDefaultSortColumn,
-} from '../../../../shared/sql/pageable-drizzle';
+} from '@shared/sql/pageable-drizzle';
 import {
   getPageableResourceKeyByMysqlTableName,
   getPageableTable,
   getPageableTableByMysqlTableName,
   PAGEABLE_RESOURCE_OPTIONS,
-} from '../../../../shared/sql/pageable-tables';
+} from '@shared/sql/pageable-tables';
 import {
   escapeLikePattern,
   isSafeSqlIdentifier,
@@ -25,7 +25,7 @@ import {
   resolveEndpointSqlQuery,
   type SqlDatabaseListPostBody,
   type SqlListPostBody,
-} from '../../../../shared/sql/sql';
+} from '@shared/sql/sql';
 
 @Injectable()
 export class SqlQueryService {

package/template/apps/api/tsconfig.json

@@ -10,6 +10,9 @@
     "sourceMap": true,
     "outDir": "./dist",
     "baseUrl": "./",
+    "paths": {
+      "@shared/*": ["../../shared/*"]
+    },
     "incremental": true,
     "skipLibCheck": true,
     "strictNullChecks": false,

package/template/shared/README.md

@@ -10,6 +10,8 @@
 | **`sql/`** | 마이그레이션·시드·원시 SQL; **`sql/sql.ts`** (`databaseSqlManifest`) 로 경로·절차 메타 정리 |
 | **`endpoint/`** | HTTP 계약(OpenAPI yaml, 공유 DTO 타입, 라우트 메타) — 제품에 맞게 확장 |
 
+프론트 전용 공유 패키지(**`web/shared`**)는 이 루트 `shared/`와 **별도**입니다. 설명은 **[`web/shared/README.md`](../web/shared/README.md)** 를 참고하세요.
+
 `apps/api/src/config.loader.ts`는 **`shared/config/api`** 를 읽습니다.  
 `web/client/vite.config.ts` / `web/admin/vite.config.ts`는 각각 **`shared/config/web/client`**, **`shared/config/web/admin`** 을 읽습니다.
 

package/template/web/admin/src/main.tsx

@@ -1,9 +1,9 @@
 import React from 'react';
 import ReactDOM from 'react-dom/client';
 import '@xfilecom/front-core/tokens.css';
-import '../../shared/src/styles/xfc-theme.css';
+import '__WEB_SHARED_WORKSPACE__/styles/xfc-theme.css';
 import '@xfilecom/front-core/base.css';
-import '../../shared/src/styles/app.css';
+import '__WEB_SHARED_WORKSPACE__/styles/app.css';
 import { App } from './App';
 
 ReactDOM.createRoot(document.getElementById('root')!).render(

package/template/web/client/src/main.tsx

@@ -1,9 +1,9 @@
 import React from 'react';
 import ReactDOM from 'react-dom/client';
 import '@xfilecom/front-core/tokens.css';
-import '../../shared/src/styles/xfc-theme.css';
+import '__WEB_SHARED_WORKSPACE__/styles/xfc-theme.css';
 import '@xfilecom/front-core/base.css';
-import '../../shared/src/styles/app.css';
+import '__WEB_SHARED_WORKSPACE__/styles/app.css';
 import { App } from './App';
 
 ReactDOM.createRoot(document.getElementById('root')!).render(

package/template/web/shared/README.md

@@ -0,0 +1,25 @@
+# `web/shared` — 클라이언트·어드민 공유 패키지
+
+Vite 앱(`web/client`, `web/admin`)이 함께 쓰는 **React 컴포넌트, 스타일, 훅, 타입**을 두는 워크스페이스 패키지입니다.  
+프로젝트 루트의 **`shared/`**(Drizzle 스키마, `sql/`, API `config/` 등)와 **별도**입니다.
+
+## 백엔드 `@shared/*`와 겹치나요?
+
+**겹치지 않습니다.** Nest(`apps/api`)는 `@shared/*`를 루트 `shared/`로만 쓰고, 프론트는 이 패키지의 **npm 이름**(`__WEB_SHARED_WORKSPACE__` → 스캐폴드 시 실제 이름)과 **`exports`** 서브패스로만 연결합니다.
+
+## 스타일 (`main.tsx`)
+
+```ts
+import '@xfilecom/front-core/tokens.css';
+import '__WEB_SHARED_WORKSPACE__/styles/xfc-theme.css';
+import '@xfilecom/front-core/base.css';
+import '__WEB_SHARED_WORKSPACE__/styles/app.css';
+```
+
+## TS/컴포넌트
+
+```ts
+import { Shell } from '__WEB_SHARED_WORKSPACE__';
+```
+
+새 파일을 앱에서 가져오려면 `package.json`의 **`exports`**에 서브패스를 추가하세요.