@fuzionx/framework 0.1.8 → 0.1.20

package/lib/core/Config.js

@@ -5,6 +5,7 @@
  * dot-notation으로 접근: config.get('app.auth.secret')
  *
  * .env 자동 로드 + ${VAR:default} 환경변수 치환.
+ * YAML 파일 직접 파싱 지원 (외부 의존 없이 내장 파서 사용).
  *
  * @see docs/framework/17-config.md
  */
@@ -26,6 +27,108 @@ export default class Config {
         this._cache = new Map();
     }
 
+    /**
+     * YAML 파일에서 설정 로드.
+     * configPath가 지정된 경우 Application 생성자에서 호출.
+     * bridge 섹션은 Rust에서 파싱하므로 JS 쪽은 database/app/themes 등을 로드.
+     * @param {string} configPath - 절대 경로
+     */
+    loadYaml(configPath) {
+        if (!existsSync(configPath)) return;
+
+        try {
+            const content = readFileSync(configPath, 'utf-8');
+            const parsed = Config.parseYaml(content);
+
+            // _raw에 병합 (기존 opts.config 우선)
+            for (const [key, value] of Object.entries(parsed)) {
+                if (this._raw[key] === undefined) {
+                    this._raw[key] = value;
+                }
+            }
+
+            // 섹션 별칭 갱신
+            if (!Object.keys(this.bridge).length && parsed.bridge) this.bridge = parsed.bridge;
+            if (!Object.keys(this.database).length && parsed.database) this.database = parsed.database;
+            if (!Object.keys(this.app).length && parsed.app) this.app = parsed.app;
+
+            // 캐시 초기화
+            this._cache.clear();
+        } catch (err) {
+            console.error(`[Config] YAML 파일 로드 실패 (${configPath}):`, err.message);
+        }
+    }
+
+    /**
+     * 간이 YAML 파서 — 외부 의존 없이 fuzionx.yaml 구조 파싱.
+     * 지원: 중첩 객체, 문자열, 숫자, boolean, 배열(인라인), 인용 문자열.
+     * @param {string} content
+     * @returns {object}
+     */
+    static parseYaml(content) {
+        const result = {};
+        const lines = content.split('\n');
+        const stack = [{ indent: -1, obj: result }];
+
+        for (const rawLine of lines) {
+            // 주석/빈 줄 무시
+            const line = rawLine.replace(/#.*$/, '');
+            if (!line.trim()) continue;
+
+            const indent = line.search(/\S/);
+            const match = line.match(/^(\s*)([-\w.]+)\s*:\s*(.*)$/);
+            if (!match) continue;
+
+            const [, , key, rawValue] = match;
+
+            // 스택에서 현재 indent보다 깊거나 같은 레벨 제거
+            while (stack.length > 1 && stack[stack.length - 1].indent >= indent) {
+                stack.pop();
+            }
+
+            const parent = stack[stack.length - 1].obj;
+            const value = rawValue.trim();
+
+            if (!value) {
+                // 하위 객체 시작
+                parent[key] = {};
+                stack.push({ indent, obj: parent[key] });
+            } else {
+                // 값 파싱
+                parent[key] = Config._parseYamlValue(value);
+            }
+        }
+
+        return result;
+    }
+
+    /**
+     * YAML 값 파싱 (문자열, 숫자, boolean, 배열)
+     * @private
+     */
+    static _parseYamlValue(raw) {
+        // 인용 문자열
+        const quoted = raw.match(/^(['"])(.*)\1$/);
+        if (quoted) return quoted[2];
+
+        // boolean
+        if (raw === 'true') return true;
+        if (raw === 'false') return false;
+        if (raw === 'null' || raw === '~') return null;
+
+        // 인라인 배열 [a, b, c]
+        if (raw.startsWith('[') && raw.endsWith(']')) {
+            return raw.slice(1, -1).split(',').map(s => Config._parseYamlValue(s.trim()));
+        }
+
+        // 숫자
+        const num = Number(raw);
+        if (!isNaN(num) && raw !== '') return num;
+
+        // 기본: 문자열
+        return raw;
+    }
+
     /**
      * .env 파일 로드 (17-config.md)
      * 부트 시 자동 호출. 이미 설정된 환경변수는 덮어쓰지 않음.

package/lib/core/Context.js

@@ -313,19 +313,13 @@ export default class Context {
             ...data,
         };
 
-        // Bridge SSR (i18n.render → bridge.ssrRenderString)
-        if (this.app?._bridge && typeof this.app._bridge.ssrRenderString === 'function') {
-            try {
-                const html = this.app._bridge.ssrRenderString(view, globals, this.locale);
-                return this.html(html);
-            } catch {} // Bridge SSR 실패 시 View 폴백
+        // Bridge Tera SSR — 폴백 없음
+        if (!this.app?._view) {
+            throw new Error('View not initialized — Bridge not available');
         }
 
-        if (this.app?._view) {
-            const html = this.app._view.render(view, globals);
-            return this.html(html);
-        }
-        return this.send(`View '${view}' not found`);
+        const html = this.app._view.render(view, globals);
+        return this.html(html);
     }
 
     // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

package/lib/view/View.js

@@ -1,8 +1,10 @@
 /**
- * View — 뷰 렌더링 (Bridge SSR)
+ * View — 뷰 렌더링 (Bridge Tera SSR)
  *
- * ctx.theme에 따른 테마 경로 해석.
- * Bridge renderTemplateFile N-API로 렌더링.
+ * Bridge의 ssrRenderFile N-API로 Tera 파일 기반 렌더링.
+ * {% extends %}, {% block %}, {% include %}, {{ t(key="...") }} 완전 지원.
+ *
+ * Bridge 없으면 반드시 에러 — 폴백 없음.
  *
  * @see docs/framework/03-views-templates.md
  */
@@ -32,10 +34,10 @@ export default class View {
     }
 
     /**
-     * 템플릿 렌더링 — Bridge renderTemplateFile N-API 사용
+     * 템플릿 렌더링 — Bridge ssrRenderFile N-API 사용
      *
      * 테마 경로 해석 (03-views-templates.md):
-     * 'home' → {viewsPath}/{theme}/pages/home.html
+     * 'home' → ssrRenderFile(viewsPath/{theme}, 'pages/home.html', context, locale)
      *
      * @param {string} template - 'home', 'users/index' 등
      * @param {object} [data] - 템플릿 변수
@@ -43,30 +45,39 @@ export default class View {
      * @returns {string} - 렌더링된 HTML
      */
     render(template, data = {}, theme) {
+        if (!this._bridge) {
+            throw new Error('Bridge not available — cannot render view');
+        }
+
+        if (typeof this._bridge.ssrRenderFile !== 'function') {
+            throw new Error('Bridge ssrRenderFile not available — rebuild with ssr feature');
+        }
+
         const activeTheme = theme || data.theme || this.theme;
         const mergedData = { ...this._globals, ...data, theme: activeTheme };
+        const locale = data.locale || 'ko';
+
+        // Tera glob 루트: views/{theme}/
+        const templateDir = join(this.viewsPath, activeTheme);
+        const contextJson = JSON.stringify(mergedData);
 
-        // 파일 경로 해석: pages/{name}.html 우선
+        // 후보 이름: pages/{template}.html → {template}.html
         const candidates = [
-            join(this.viewsPath, activeTheme, 'pages', `${template}.html`),
-            join(this.viewsPath, activeTheme, `${template}.html`),
+            `pages/${template}.html`,
+            `${template}.html`,
         ];
 
-        // Bridge renderTemplateFile N-API 호출
-        if (this._bridge && typeof this._bridge.renderTemplateFile === 'function') {
-            const contextJson = JSON.stringify(mergedData);
-
-            for (const filePath of candidates) {
-                try {
-                    return this._bridge.renderTemplateFile(filePath, contextJson);
-                } catch {
-                    // 파일 없음 → 다음 후보
+        for (const templateName of candidates) {
+            try {
+                return this._bridge.ssrRenderFile(templateDir, templateName, contextJson, locale);
+            } catch (err) {
+                // 파일 없음 → 다음 후보 (Tera init 에러는 파일 미존재)
+                if (!err.message?.includes('not found') && !err.message?.includes('init failed')) {
+                    throw err; // 렌더링 에러는 그대로 전파
                 }
             }
-
-            throw new Error(`View '${template}' not found. Searched: ${candidates.join(', ')}`);
         }
 
-        throw new Error(`Bridge not available — cannot render view '${template}'`);
+        throw new Error(`View '${template}' not found in theme '${activeTheme}'. Searched: ${candidates.join(', ')}`);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzionx/framework",
-  "version": "0.1.8",
+  "version": "0.1.20",
   "type": "module",
   "description": "Full-stack MVC framework built on @fuzionx/core — Controller, Service, Model, Middleware, DI, EventBus",
   "main": "index.js",
@@ -34,7 +34,7 @@
     "url": "https://github.com/saytohenry/fuzionx"
   },
   "dependencies": {
-    "@fuzionx/core": "^0.1.8",
+    "@fuzionx/core": "^0.1.20",
     "better-sqlite3": "^12.8.0",
     "knex": "^3.2.5",
     "mongoose": "^9.3.2",
@@ -46,6 +46,8 @@
   },
   "files": [
     "index.js",
+    "bin/",
+    "cli/",
     "lib/",
     "testing/"
   ]