@gaonjs/vue 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -1,2 +1,4 @@
 export declare const version: string;
 export declare const status: "planned";
+export { pageProps } from "./pageProps.js";
+export { serializeProps, type Serialized } from "./serialize.js";

package/dist/index.js

@@ -1,8 +1,14 @@
 /**
  * @gaonjs/vue — Gaon 프론트엔드 어댑터 첫 구현 (Vue 3 · Inertia 브리지 · SSR).
  *
- * 구현은 웹/데이터 조각 이후 마일스톤. 현재는 개발 상태만 노출하는 스텁이다.
+ * 전체 어댑터(Inertia 브리지·SSR)는 후속 마일스톤이다. M3 에서는 타입
+ * 브리지의 Vue 쪽 끝인 pageProps 를 제공한다(§6.2) — 스키마→.vue 타입
+ * 체인의 마지막 고리.
  */
 import { VERSION } from "@gaonjs/core";
 export const version = VERSION;
 export const status = "planned";
+// 타입 브리지 (M3) — GaonRouteMap[K] → 페이지 props 타입
+export { pageProps } from "./pageProps.js";
+// 직렬화 경계 (M4) — Rec → JSON-safe 페이지 props (Date/bigint→string, hidden 제외)
+export { serializeProps } from "./serialize.js";

package/dist/pageProps.d.ts

@@ -0,0 +1,15 @@
+import type { Rendered } from '@gaonjs/web';
+import type { Serialized } from './serialize.js';
+declare global {
+    interface GaonRouteMap {
+    }
+}
+type PropsOf<F> = F extends (...args: never[]) => infer R ? Awaited<R> extends Rendered<infer P> ? P : never : never;
+/**
+ * 페이지의 props 타입을 라우트 이름으로 가져온다.
+ * `const { posts } = pageProps<'posts#index'>()`
+ * 런타임 값은 Inertia 가 주입한 실제 페이지 props 로 대체된다(M4 브리지 —
+ * serializeProps 를 통과한 JSON-safe 값).
+ */
+export declare function pageProps<K extends keyof GaonRouteMap>(): Serialized<PropsOf<GaonRouteMap[K]>>;
+export {};

package/dist/pageProps.js

@@ -0,0 +1,23 @@
+// @gaonjs/vue · pageProps — 라우트 이름 문자열 → 컨트롤러 반환 props 타입.
+//
+// 타입 브리지의 Vue 쪽 끝(§6.2). `.gaon/routes.d.ts` 가 declaration
+// merging 으로 GaonRouteMap 을 채우면(라우트 이름 → 컨트롤러 액션 타입),
+// pageProps<'posts#index'>() 가 그 액션의 render props 타입을 돌려준다.
+//
+// 스키마→모델→컨트롤러→(생성된 라우트 지도)→페이지로 이어지는 타입
+// 체인의 마지막 고리다. 스키마에서 컬럼을 지우면 .vue 템플릿의 사용
+// 지점에서 vue-tsc 가 에러를 낸다(완료 기준).
+//
+// 반환 타입은 깊은 직렬화 경계 Serialized<P> 로 승격된다(M4). 컨트롤러가
+// 넘긴 raw props(Date·bigint·모델 메서드·hidden 포함)가 아니라, 페이지가
+// 실제로 받는 JSON-safe 모양이다 — Date/bigint 는 문자열, hidden 컬럼은
+// 존재하지 않으므로 접근 시 컴파일 에러가 난다(§4.2 완료 기준).
+/**
+ * 페이지의 props 타입을 라우트 이름으로 가져온다.
+ * `const { posts } = pageProps<'posts#index'>()`
+ * 런타임 값은 Inertia 가 주입한 실제 페이지 props 로 대체된다(M4 브리지 —
+ * serializeProps 를 통과한 JSON-safe 값).
+ */
+export function pageProps() {
+    return undefined;
+}

package/dist/serialize.d.ts

@@ -0,0 +1,17 @@
+import type { IsHidden } from '@gaonjs/core';
+/**
+ * 서버 타입 `T`(Date·bigint·메서드·hidden 포함) → 페이지가 받는 JSON-safe 타입.
+ *
+ * 규칙: Date→string, bigint→string, 함수→제외, 배열·객체는 재귀.
+ * 객체에서 hidden 브랜드가 붙은 키와 함수 값 키는 결과에서 빠진다.
+ */
+export type Serialized<T> = T extends Date ? string : T extends bigint ? string : T extends (...args: never[]) => unknown ? never : T extends ReadonlyArray<infer U> ? Array<Serialized<U>> : T extends object ? SerializedObject<T> : T;
+type SerializedObject<T> = {
+    [K in keyof T as IsHidden<T[K]> extends true ? never : T[K] extends (...args: never[]) => unknown ? never : K]: Serialized<T[K]>;
+};
+/**
+ * 컨트롤러 props 를 JSON-safe 페이지 props 로 변환한다(Inertia 브리지).
+ * Date→ISO 문자열, bigint→문자열, 함수 제거, hidden 컬럼 제외, 중첩 재귀.
+ */
+export declare function serializeProps<T>(value: T): Serialized<T>;
+export {};

package/dist/serialize.js

@@ -0,0 +1,51 @@
+// @gaonjs/vue · 직렬화 경계 (M4 — Rec → Serialized 깊은 매핑 + 런타임)
+//
+// 서버의 레코드는 그대로 JSON 이 아니다(§4.4). 모델 메서드·관계 함수가
+// 붙어 있고, Date·bigint 는 JSON 위에서 문자열이 되며(bigint 는 애초에
+// JSON.stringify 가 던진다), hidden 컬럼은 노출되면 안 된다(§4.2).
+//
+// 이 경계에서 두 가지가 맞물린다:
+//  · 타입: Serialized<P> 가 페이지가 실제로 받는 JSON-safe 모양을 계산한다
+//    (Date/bigint → string, 함수·hidden 제외, 중첩·배열 재귀). pageProps<K>()
+//    의 반환 타입을 이 매핑으로 승격한다.
+//  · 런타임: serializeProps() 가 컨트롤러 props 를 같은 규칙으로 변환한다.
+//    Inertia 브리지가 페이지에 넘기기 직전 이 함수를 통과시킨다.
+//
+// hidden 지식의 출처는 @gaonjs/data 다(RowOf 브랜딩 + 레코드의 HIDDEN_COLUMNS
+// 마커). 여기서는 그 브랜드/마커를 감지해 떨구기만 한다 — 책임 분리(§13.5 M4).
+import { HIDDEN_COLUMNS } from '@gaonjs/core';
+// ── 런타임 ────────────────────────────────────────────────────
+/**
+ * 컨트롤러 props 를 JSON-safe 페이지 props 로 변환한다(Inertia 브리지).
+ * Date→ISO 문자열, bigint→문자열, 함수 제거, hidden 컬럼 제외, 중첩 재귀.
+ */
+export function serializeProps(value) {
+    return serialize(value);
+}
+function serialize(value) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value))
+        return value.map(serialize);
+    if (typeof value === 'object') {
+        // 모델 레코드는 HIDDEN_COLUMNS 마커(비열거)로 제외할 컬럼명을 싣는다.
+        const hidden = value[HIDDEN_COLUMNS];
+        const out = {};
+        for (const key of Object.keys(value)) {
+            if (hidden && hidden.includes(key))
+                continue;
+            const v = value[key];
+            if (typeof v === 'function')
+                continue; // 메서드·관계 함수는 직렬화하지 않는다
+            out[key] = serialize(v);
+        }
+        return out;
+    }
+    if (typeof value === 'function')
+        return undefined;
+    return value;
+}

package/package.json

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