@gaonjs/vue 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -3,3 +3,5 @@ export declare const status: "planned";
 export { pageProps } from "./pageProps.js";
 export { serializeProps, type Serialized } from "./serialize.js";
 export { api, registerRoutes, type ApiParams, type ApiOptions, type GaonRouteInfo, } from "./api.js";
+export { createGaonApp, type CreateGaonAppOptions, type PageMap } from "./runtime.js";
+export { findDefaultLayout, resolvePageLayout } from "./layout.js";

package/dist/index.js

@@ -14,3 +14,7 @@ export { pageProps } from "./pageProps.js";
 export { serializeProps } from "./serialize.js";
 // 타입드 클라이언트 (errata E-3) — 라우트 키 → Serialized 반환
 export { api, registerRoutes, } from "./api.js";
+// Inertia SPA 부팅 (§6.4 · M3 최소 웹 레이어) — apps/<앱>/main.ts 진입점.
+export { createGaonApp } from "./runtime.js";
+// 레이아웃 자동 적용 (E-5 §2.3) — layouts/Default.vue 결정 로직.
+export { findDefaultLayout, resolvePageLayout } from "./layout.js";

package/dist/layout.d.ts

@@ -0,0 +1,17 @@
+import type { Component } from 'vue';
+/**
+ * 페이지 모듈 지도(import.meta.glob 결과)에서 `layouts/Default.vue` 를
+ * 뽑는다. glob 은 페이지 지도와 같은 root(main.ts)에서 만들어져 넘어오므로,
+ * 키는 './layouts/Default.vue' 형식이다.
+ */
+export declare function findDefaultLayout(layouts: Record<string, unknown> | undefined): Component | undefined;
+/**
+ * 페이지 컴포넌트에 레이아웃을 결정해 붙인다(E-5 §2.3).
+ *  · pageLayout === null      → 명시 opt-out. 그대로 null 유지.
+ *  · pageLayout 값 존재         → 명시 지정. 그대로.
+ *  · pageLayout === undefined → Default.vue 있으면 그것, 없으면 그대로.
+ *
+ * 반환은 실제로 붙일 레이아웃(Component) 또는 undefined(레이아웃 없음).
+ * 결정 로직만 담고, 붙이는 것은 호출자(runtime.createGaonApp)가 한다.
+ */
+export declare function resolvePageLayout(pageLayout: unknown, defaultLayout: Component | undefined): Component | undefined;

package/dist/layout.js

@@ -0,0 +1,48 @@
+// @gaonjs/vue · Vue 레이아웃 자동 적용 (v0.16 §6.6 · errata E-5 §2.3)
+//
+// 정본: "layouts/Default.vue 가 존재하면 그 앱의 모든 페이지에 자동
+// 적용된다(파일 존재 = 등록 원칙). 다른 레이아웃이 필요한 페이지만
+// 페이지 파일에서 명시적으로 바꾼다."
+//
+// 페이지 컴포넌트의 정적 프로퍼티 `layout` 이 다음 세 값을 갖는다:
+//   · 없음(undefined)  → Default.vue 가 있으면 자동 적용, 없으면 raw.
+//   · null            → 명시 opt-out(로그인 페이지처럼 레이아웃 없음).
+//   · Component       → 그 컴포넌트를 명시 지정.
+//
+// Inertia 의 persistent layout 규약과 정합 — 페이지 컴포넌트 자체가
+// `layout` 을 들고 있으면 어댑터가 페이지 전환 시 레이아웃 상태를 유지한다.
+/**
+ * 페이지 모듈 지도(import.meta.glob 결과)에서 `layouts/Default.vue` 를
+ * 뽑는다. glob 은 페이지 지도와 같은 root(main.ts)에서 만들어져 넘어오므로,
+ * 키는 './layouts/Default.vue' 형식이다.
+ */
+export function findDefaultLayout(layouts) {
+    if (!layouts)
+        return undefined;
+    const mod = layouts['./layouts/Default.vue'];
+    if (!mod)
+        return undefined;
+    return extractDefault(mod);
+}
+/**
+ * 페이지 컴포넌트에 레이아웃을 결정해 붙인다(E-5 §2.3).
+ *  · pageLayout === null      → 명시 opt-out. 그대로 null 유지.
+ *  · pageLayout 값 존재         → 명시 지정. 그대로.
+ *  · pageLayout === undefined → Default.vue 있으면 그것, 없으면 그대로.
+ *
+ * 반환은 실제로 붙일 레이아웃(Component) 또는 undefined(레이아웃 없음).
+ * 결정 로직만 담고, 붙이는 것은 호출자(runtime.createGaonApp)가 한다.
+ */
+export function resolvePageLayout(pageLayout, defaultLayout) {
+    if (pageLayout === null)
+        return undefined;
+    if (pageLayout !== undefined)
+        return pageLayout;
+    return defaultLayout;
+}
+function extractDefault(mod) {
+    if (mod && typeof mod === 'object' && 'default' in mod) {
+        return mod.default;
+    }
+    return mod;
+}

package/dist/runtime.d.ts

@@ -0,0 +1,42 @@
+import { type GaonRouteInfo } from './api.js';
+/**
+ * import.meta.glob 이 반환하는 페이지 지도.
+ * 값은 즉시(eager) 로드된 모듈이거나 지연 로드 함수다 — 둘 다 지원.
+ */
+export type PageMap = Record<string, unknown | (() => Promise<unknown>)>;
+export interface CreateGaonAppOptions {
+    /**
+     * 페이지 모듈 지도. main.ts 에서
+     *   `import.meta.glob('./pages/**\/*.vue')`  (지연 로드)
+     * 또는
+     *   `import.meta.glob('./pages/**\/*.vue', { eager: true })`
+     * 로 만들어 넘긴다. 키는 './pages/<name>.vue' 형식.
+     */
+    readonly pages: PageMap;
+    /**
+     * 레이아웃 모듈 지도. Default.vue 가 있으면 자동 적용(E-5 §2.3).
+     *   `import.meta.glob('./layouts/*.vue', { eager: true })`
+     * eager 인 편이 편하다 — 레이아웃은 소수·최초 진입에도 필요.
+     */
+    readonly layouts?: PageMap;
+    /**
+     * 앱의 라우트 매니페스트(method + path). api() 클라이언트가 소비한다
+     * (E-3 §3). .gaon/routes.manifest.ts 가 생성해 이 옵션으로 넘긴다.
+     * 미지정 시 api() 는 라우트 조회에서 명확한 에러를 던진다.
+     */
+    readonly routes?: Record<string, GaonRouteInfo>;
+    /** 브라우저 탭 타이틀 조합자. Inertia 옵션 그대로 통과. */
+    readonly title?: (title: string) => string;
+    /** Inertia 진행 표시자 옵션(색상·delay 등). false 로 끌 수 있다. */
+    readonly progress?: false | {
+        readonly color?: string;
+        readonly delay?: number;
+        readonly includeCSS?: boolean;
+        readonly showSpinner?: boolean;
+    };
+}
+/**
+ * Inertia SPA 부팅(브라우저 전용). 페이지·레이아웃 지도와 라우트 매니페스트를
+ * 받아 Vue 앱을 마운트한다. 서버는 apps/<앱>/main.ts 에서 이 함수를 부른다.
+ */
+export declare function createGaonApp(opts: CreateGaonAppOptions): Promise<void>;

package/dist/runtime.js

@@ -0,0 +1,68 @@
+/// <reference lib="dom" />
+// @gaonjs/vue · Vue 3 클라이언트 런타임 (v0.16 §6.4 · M3 최소 웹 레이어)
+//
+// 이 파일은 브라우저에서 Inertia SPA 를 부팅한다:
+//   1) apps/<앱>/main.ts 가 페이지·레이아웃 지도를 만든다(Vite 정합).
+//   2) `createGaonApp` 에 지도와 라우트 매니페스트를 넘긴다.
+//   3) 내부에서 @inertiajs/vue3 의 createInertiaApp 을 호출해 마운트.
+//
+// 정본 준수:
+//   · Inertia SPA + 서버 라우팅 · **SSR 아님** (§6.1 · CLAUDE.md 규칙 12).
+//   · 자동 import 금지 — 페이지·레이아웃 지도는 사용자 코드가 명시적으로
+//     import.meta.glob 으로 만들어 넘긴다(E-5 §2.4).
+//   · `layouts/Default.vue` 존재 = 자동 적용(E-5 §2.3, ./layout.ts).
+//
+// 서버 응답의 data-page (packages/web/src/inertia.ts) 를 Inertia 어댑터가
+// 읽어 마운트한다 — 초기 페이지 · 이후 SPA 네비게이션 모두 같은 경로.
+import { createApp, h } from 'vue';
+import { createInertiaApp } from '@inertiajs/vue3';
+import { registerRoutes } from './api.js';
+import { findDefaultLayout, resolvePageLayout } from './layout.js';
+/**
+ * Inertia SPA 부팅(브라우저 전용). 페이지·레이아웃 지도와 라우트 매니페스트를
+ * 받아 Vue 앱을 마운트한다. 서버는 apps/<앱>/main.ts 에서 이 함수를 부른다.
+ */
+export async function createGaonApp(opts) {
+    if (opts.routes)
+        registerRoutes(opts.routes);
+    const defaultLayout = findDefaultLayout(opts.layouts);
+    await createInertiaApp({
+        title: opts.title,
+        progress: opts.progress,
+        resolve: async (name) => {
+            const key = `./pages/${name}.vue`;
+            const entry = opts.pages[key];
+            if (entry === undefined) {
+                // 에러가 곧 수리 안내서(§7.5.3): 어디 파일을 만들어야 하는지 말해준다.
+                throw new Error(`[gaonjs/vue] Inertia 페이지 '${name}' 를 찾을 수 없습니다 (looked up '${key}').\n` +
+                    `→ apps/<앱>/pages/${name}.vue 를 만들거나, 컨트롤러의 this.render('${name}', ...) 인자를 확인하세요.`);
+            }
+            const mod = await loadPageModule(entry);
+            const page = mod.default;
+            // 레이아웃 자동 적용(E-5 §2.3) — 페이지가 layout 을 명시 안 했으면 Default.
+            const chosen = resolvePageLayout(page.layout, defaultLayout);
+            if (chosen !== undefined) {
+                ;
+                page.layout = chosen;
+            }
+            else if (page.layout === null) {
+                // 명시 opt-out 은 그대로 null 로 남긴다 — Inertia 는 null 을 "레이아웃 없음"으로 취급.
+            }
+            return mod;
+        },
+        setup({ el, App, props, plugin }) {
+            if (el === null)
+                return;
+            createApp({ render: () => h(App, props) })
+                .use(plugin)
+                .mount(el);
+        },
+    });
+}
+async function loadPageModule(entry) {
+    if (typeof entry === 'function') {
+        const loaded = await entry();
+        return loaded;
+    }
+    return entry;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/vue",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Gaon 프론트엔드 어댑터: Vue 3 · Inertia 브리지 · 타입 전파 · SSR (구현 예정)",
   "type": "module",
   "license": "MIT",
@@ -24,8 +24,12 @@
     "README.md"
   ],
   "dependencies": {
+    "@inertiajs/vue3": "^3.6.1",
     "@gaonjs/core": "0.1.4",
-    "@gaonjs/web": "0.3.0"
+    "@gaonjs/web": "0.5.1"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.0"
   },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json"