@gomjellie/lazyapi 0.0.2 → 0.0.3

package/dist/services/openapi-parser.js

@@ -64,7 +64,8 @@ export class OpenAPIParserService {
                 for (const method of methods) {
                     const operation = pathItem[method];
                     if (operation) {
-                        endpoints.push(this.createEndpointV2(path, method.toUpperCase(), operation, pathItem));
+                        endpoints.push(this.createEndpointV2(path, method.toUpperCase(), operation, pathItem, document // document 인자 전달
+                        ));
                     }
                 }
             }
@@ -123,6 +124,24 @@ export class OpenAPIParserService {
                 requestBody = this.normalizeRequestBodyV3(operation.requestBody);
             }
         }
+        // Responses 정규화
+        const responses = Object.entries(operation.responses || {})
+            .map(([status, response]) => {
+            if (!response)
+                return null;
+            if (isReferenceObject(response)) {
+                if (document) {
+                    const resolved = resolveRef(response.$ref, document);
+                    if (resolved && !isReferenceObject(resolved)) {
+                        return this.normalizeResponseV3(status, resolved);
+                    }
+                }
+                // Resolve 실패 시 기본값 (설명 없음)
+                return { status, description: 'Reference not found' };
+            }
+            return this.normalizeResponseV3(status, response);
+        })
+            .filter((r) => r !== null);
         return {
             id,
             method,
@@ -132,7 +151,7 @@ export class OpenAPIParserService {
             tags: operation.tags || [],
             parameters,
             requestBody,
-            responses: operation.responses || {},
+            responses,
             operationId: operation.operationId,
             deprecated: operation.deprecated,
             security: operation.security,
@@ -141,8 +160,9 @@ export class OpenAPIParserService {
     /**
      * Swagger 2.0 Operation 객체에서 Endpoint 생성
      */
-    createEndpointV2(path, method, operation, pathItem) {
+    createEndpointV2(path, method, operation, pathItem, document) {
         const id = `${method}_${path.replace(/[^a-zA-Z0-9]/g, '_')}`;
+        // ... 파라미터 처리 (생략) ...
         // 파라미터 병합 및 정규화
         const pathParameters = pathItem.parameters || [];
         const operationParameters = operation.parameters || [];
@@ -153,23 +173,36 @@ export class OpenAPIParserService {
             if (isReferenceObject(p))
                 continue;
             const param = p;
-            // Swagger 2.0의 body 파라미터 처리
             if (param.in === 'body') {
                 const bodyParam = param;
-                // requestBody로도 저장
                 requestBody = {
                     description: bodyParam.description,
                     required: bodyParam.required,
                     schema: bodyParam.schema,
                 };
-                // UI 표시를 위해 parameters에도 포함
                 parameters.push(this.normalizeParameterV2(param));
             }
             else {
-                // 나머지 파라미터들 (path, query, header, formData)
                 parameters.push(this.normalizeParameterV2(param));
             }
         }
+        // Responses 정규화
+        const responses = Object.entries(operation.responses || {})
+            .map(([status, response]) => {
+            if (!response)
+                return null;
+            if (isReferenceObject(response)) {
+                if (document) {
+                    const resolved = resolveRef(response.$ref, document);
+                    if (resolved && !isReferenceObject(resolved)) {
+                        return this.normalizeResponseV2(status, resolved);
+                    }
+                }
+                return { status, description: 'Reference not found' };
+            }
+            return this.normalizeResponseV2(status, response);
+        })
+            .filter((r) => r !== null);
         return {
             id,
             method,
@@ -179,12 +212,73 @@ export class OpenAPIParserService {
             tags: operation.tags || [],
             parameters,
             requestBody,
-            responses: operation.responses || {},
+            responses,
             operationId: operation.operationId,
             deprecated: operation.deprecated,
             security: operation.security,
         };
     }
+    /**
+     * OpenAPI v3 Response 객체 정규화
+     */
+    normalizeResponseV3(status, response) {
+        const content = response.content
+            ? Object.entries(response.content).map(([mediaType, mediaObj]) => ({
+                mediaType,
+                schema: isReferenceObject(mediaObj.schema) ? undefined : mediaObj.schema,
+                examples: mediaObj.examples || mediaObj.example,
+            }))
+            : undefined;
+        const headers = response.headers
+            ? Object.entries(response.headers).map(([name, header]) => {
+                if (isReferenceObject(header)) {
+                    return { name, description: 'Reference header not supported yet' };
+                }
+                return {
+                    name,
+                    description: header.description,
+                    schema: isReferenceObject(header.schema) ? undefined : header.schema,
+                };
+            })
+            : undefined;
+        return {
+            status,
+            description: response.description,
+            content,
+            headers,
+        };
+    }
+    /**
+     * Swagger 2.0 Response 객체 정규화
+     */
+    normalizeResponseV2(status, response) {
+        // V2는 content가 없고 schema가 바로 있음. 이를 application/json (또는 produces) content로 변환
+        let content;
+        if (response.schema) {
+            // V2 스키마를 V3 스타일 content로 래핑
+            content = [
+                {
+                    mediaType: 'application/json', // 기본값
+                    schema: response.schema,
+                    examples: response.examples,
+                },
+            ];
+        }
+        const headers = response.headers
+            ? Object.entries(response.headers).map(([name, header]) => ({
+                name,
+                description: header.description,
+                type: header.type,
+                // V2 헤더는 schema 대신 type/format 등을 가짐. 이를 schema 형태로 변환 가능하지만 일단 type만 유지
+            }))
+            : undefined;
+        return {
+            status,
+            description: response.description,
+            content,
+            headers,
+        };
+    }
     /**
      * OpenAPI v3 파라미터를 정규화
      */
@@ -266,9 +360,9 @@ export class OpenAPIParserService {
         };
     }
     /**
-     * 엔드포인트 필터링
+     * 엔드포인트 메서드별 필터링
      */
-    filterEndpoints(endpoints, method) {
+    filterByMethod(endpoints, method) {
         if (method === 'ALL') {
             return endpoints;
         }

package/dist/store/appSlice.d.ts

@@ -3,12 +3,12 @@
  */
 import { AppState, AppMode, Screen, ApiResponse } from '../types/app-state.js';
 import { Endpoint, HttpMethod, OpenAPIDocument } from '../types/openapi.js';
-export declare const setDocument: import("@reduxjs/toolkit").ActionCreatorWithPayload<OpenAPIDocument, "app/setDocument">, setEndpoints: import("@reduxjs/toolkit").ActionCreatorWithPayload<Endpoint[], "app/setEndpoints">, setScreen: import("@reduxjs/toolkit").ActionCreatorWithPayload<Screen, "app/setScreen">, setMode: import("@reduxjs/toolkit").ActionCreatorWithPayload<AppMode, "app/setMode">, setCommandInput: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "app/setCommandInput">, setError: import("@reduxjs/toolkit").ActionCreatorWithPayload<string | null, "app/setError">, setLoading: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "app/setLoading">, listSelect: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "app/listSelect">, listSetFilter: import("@reduxjs/toolkit").ActionCreatorWithPayload<HttpMethod | "ALL", "app/listSetFilter">, listSetTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<string | null, "app/listSetTag">, listSetFocus: import("@reduxjs/toolkit").ActionCreatorWithPayload<"LIST" | "TAGS", "app/listSetFocus">, listSelectTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "app/listSelectTag">, listSetSearch: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "app/listSetSearch">, listSetTagSearch: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "app/listSetTagSearch">, listScroll: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "app/listScroll">, detailSet: import("@reduxjs/toolkit").ActionCreatorWithPayload<Endpoint, "app/detailSet">, detailSetFocus: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "app/detailSetFocus">, detailSetParam: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+export declare const setDocument: import("@reduxjs/toolkit").ActionCreatorWithPayload<OpenAPIDocument, "app/setDocument">, setEndpoints: import("@reduxjs/toolkit").ActionCreatorWithPayload<Endpoint[], "app/setEndpoints">, setScreen: import("@reduxjs/toolkit").ActionCreatorWithPayload<Screen, "app/setScreen">, setMode: import("@reduxjs/toolkit").ActionCreatorWithPayload<AppMode, "app/setMode">, setCommandInput: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "app/setCommandInput">, setNavigationCount: import("@reduxjs/toolkit").ActionCreatorWithPayload<number | null, "app/setNavigationCount">, setError: import("@reduxjs/toolkit").ActionCreatorWithPayload<string | null, "app/setError">, setLoading: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "app/setLoading">, listSelect: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "app/listSelect">, listSetMethodFilter: import("@reduxjs/toolkit").ActionCreatorWithPayload<HttpMethod | "ALL", "app/listSetMethodFilter">, listSetTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<string | null, "app/listSetTag">, listSetFocus: import("@reduxjs/toolkit").ActionCreatorWithPayload<"LIST" | "TAGS" | "METHODS", "app/listSetFocus">, listSelectTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "app/listSelectTag">, listSelectMethod: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "app/listSelectMethod">, listSetSearch: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "app/listSetSearch">, listSetTagSearch: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "app/listSetTagSearch">, listScroll: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "app/listScroll">, detailSet: import("@reduxjs/toolkit").ActionCreatorWithPayload<Endpoint, "app/detailSet">, detailSetFocus: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "app/detailSetFocus">, detailSetParam: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     key: string;
     value: string;
 }, "app/detailSetParam">, detailSetBody: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "app/detailSetBody">, detailSetHeader: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     key: string;
     value: string;
 }, "app/detailSetHeader">, detailSetPanel: import("@reduxjs/toolkit").ActionCreatorWithPayload<"left" | "request" | "response", "app/detailSetPanel">, detailSetRequestTab: import("@reduxjs/toolkit").ActionCreatorWithPayload<"headers" | "query" | "body", "app/detailSetRequestTab">, detailSetResponseTab: import("@reduxjs/toolkit").ActionCreatorWithPayload<"headers" | "body" | "cookies" | "curl", "app/detailSetResponseTab">, detailSetResponse: import("@reduxjs/toolkit").ActionCreatorWithPayload<ApiResponse | null, "app/detailSetResponse">, reset: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"app/reset">;
-declare const _default: import("@reduxjs/toolkit").Reducer<AppState>;
+declare const _default: import("redux").Reducer<AppState>;
 export default _default;

package/dist/store/appSlice.js

@@ -11,18 +11,21 @@ const initialState = {
     list: {
         selectedIndex: 0,
         filteredEndpoints: [],
-        activeFilter: 'ALL',
+        activeMethod: 'ALL',
         activeTag: null,
         focus: 'LIST',
         selectedTagIndex: 0,
+        focusedMethodIndex: 0,
         searchQuery: '',
         tagSearchQuery: '',
         scrollOffset: 0,
+        methodHistory: {},
     },
     detail: null,
     error: null,
     loading: false,
     commandInput: '',
+    navigationCount: null,
 };
 const appSlice = createSlice({
     name: 'app',
@@ -43,10 +46,15 @@ const appSlice = createSlice({
             if (action.payload === 'COMMAND') {
                 state.commandInput = '';
             }
+            // 모드 변경 시 Count 초기화
+            state.navigationCount = null;
         },
         setCommandInput: (state, action) => {
             state.commandInput = action.payload;
         },
+        setNavigationCount: (state, action) => {
+            state.navigationCount = action.payload;
+        },
         setError: (state, action) => {
             state.error = action.payload;
             state.loading = false;
@@ -56,10 +64,32 @@ const appSlice = createSlice({
         },
         listSelect: (state, action) => {
             state.list.selectedIndex = Math.max(0, Math.min(action.payload, state.list.filteredEndpoints.length - 1));
+            // 히스토리 업데이트
+            state.list.methodHistory[state.list.activeMethod] = {
+                selectedIndex: state.list.selectedIndex,
+                scrollOffset: state.list.scrollOffset,
+            };
         },
-        listSetFilter: (state, action) => {
-            state.list.activeFilter = action.payload;
-            state.list.selectedIndex = 0;
+        listSetMethodFilter: (state, action) => {
+            if (state.list.activeMethod !== action.payload) {
+                // 현재 상태 저장
+                state.list.methodHistory[state.list.activeMethod] = {
+                    selectedIndex: state.list.selectedIndex,
+                    scrollOffset: state.list.scrollOffset,
+                };
+                // 메서드 변경
+                state.list.activeMethod = action.payload;
+                // 히스토리 복원
+                const history = state.list.methodHistory[action.payload];
+                if (history) {
+                    state.list.selectedIndex = history.selectedIndex;
+                    state.list.scrollOffset = history.scrollOffset;
+                }
+                else {
+                    state.list.selectedIndex = 0;
+                    state.list.scrollOffset = 0;
+                }
+            }
         },
         listSetTag: (state, action) => {
             state.list.activeTag = action.payload;
@@ -71,6 +101,9 @@ const appSlice = createSlice({
         listSelectTag: (state, action) => {
             state.list.selectedTagIndex = action.payload;
         },
+        listSelectMethod: (state, action) => {
+            state.list.focusedMethodIndex = action.payload;
+        },
         listSetSearch: (state, action) => {
             state.list.searchQuery = action.payload;
             state.list.selectedIndex = 0;
@@ -81,6 +114,11 @@ const appSlice = createSlice({
         },
         listScroll: (state, action) => {
             state.list.scrollOffset = action.payload;
+            // 히스토리 업데이트
+            state.list.methodHistory[state.list.activeMethod] = {
+                selectedIndex: state.list.selectedIndex,
+                scrollOffset: state.list.scrollOffset,
+            };
         },
         detailSet: (state, action) => {
             const endpoint = action.payload;
@@ -140,5 +178,5 @@ const appSlice = createSlice({
         reset: () => initialState,
     },
 });
-export const { setDocument, setEndpoints, setScreen, setMode, setCommandInput, setError, setLoading, listSelect, listSetFilter, listSetTag, listSetFocus, listSelectTag, listSetSearch, listSetTagSearch, listScroll, detailSet, detailSetFocus, detailSetParam, detailSetBody, detailSetHeader, detailSetPanel, detailSetRequestTab, detailSetResponseTab, detailSetResponse, reset, } = appSlice.actions;
+export const { setDocument, setEndpoints, setScreen, setMode, setCommandInput, setNavigationCount, setError, setLoading, listSelect, listSetMethodFilter, listSetTag, listSetFocus, listSelectTag, listSelectMethod, listSetSearch, listSetTagSearch, listScroll, detailSet, detailSetFocus, detailSetParam, detailSetBody, detailSetHeader, detailSetPanel, detailSetRequestTab, detailSetResponseTab, detailSetResponse, reset, } = appSlice.actions;
 export default appSlice.reducer;

package/dist/store/hooks.d.ts

@@ -3,7 +3,7 @@
  */
 export declare const useAppDispatch: import("react-redux").UseDispatch<import("@reduxjs/toolkit").ThunkDispatch<{
     app: import("../types/app-state.js").AppState;
-}, undefined, import("@reduxjs/toolkit").UnknownAction> & import("@reduxjs/toolkit").Dispatch<import("@reduxjs/toolkit").UnknownAction>>;
+}, undefined, import("redux").UnknownAction> & import("redux").Dispatch<import("redux").UnknownAction>>;
 export declare const useAppSelector: import("react-redux").UseSelector<{
     app: import("../types/app-state.js").AppState;
 }>;

package/dist/store/index.d.ts

@@ -3,10 +3,10 @@
  */
 export declare const store: import("@reduxjs/toolkit").EnhancedStore<{
     app: import("../types/app-state.js").AppState;
-}, import("@reduxjs/toolkit").UnknownAction, import("@reduxjs/toolkit").Tuple<[import("@reduxjs/toolkit").StoreEnhancer<{
+}, import("redux").UnknownAction, import("@reduxjs/toolkit").Tuple<[import("redux").StoreEnhancer<{
     dispatch: import("@reduxjs/toolkit").ThunkDispatch<{
         app: import("../types/app-state.js").AppState;
-    }, undefined, import("@reduxjs/toolkit").UnknownAction>;
-}>, import("@reduxjs/toolkit").StoreEnhancer]>>;
+    }, undefined, import("redux").UnknownAction>;
+}>, import("redux").StoreEnhancer]>>;
 export type RootState = ReturnType<typeof store.getState>;
 export type AppDispatch = typeof store.dispatch;

package/dist/store/navigationActions.d.ts

@@ -0,0 +1,9 @@
+import { ThunkAction } from '@reduxjs/toolkit';
+import { AnyAction } from 'redux';
+import { RootState } from './index.js';
+type AppThunk = ThunkAction<void, RootState, unknown, AnyAction>;
+export declare const navigateUp: () => AppThunk;
+export declare const navigateDown: () => AppThunk;
+export declare const navigateLeft: () => AppThunk;
+export declare const navigateRight: () => AppThunk;
+export {};

package/dist/store/navigationActions.js

@@ -0,0 +1,129 @@
+import { listSetFocus, listSelectMethod, listSetMethodFilter, listSelect, listSelectTag, detailSetFocus, detailSetPanel, } from './appSlice.js';
+const METHODS = ['ALL', 'GET', 'POST', 'PUT', 'DELETE', 'PATCH'];
+// k Key (Up)
+export const navigateUp = () => (dispatch, getState) => {
+    const { app } = getState();
+    const { screen, list, detail } = app;
+    if (screen === 'LIST') {
+        if (list.focus === 'TAGS') {
+            const prevIndex = Math.max(list.selectedTagIndex - 1, 0);
+            dispatch(listSelectTag(prevIndex));
+        }
+        else if (list.focus === 'METHODS') {
+            // 아무 동작 안함
+        }
+        else {
+            // LIST
+            if (list.selectedIndex === 0) {
+                dispatch(listSetFocus('METHODS'));
+            }
+            else {
+                const prevIndex = Math.max(list.selectedIndex - 1, 0);
+                dispatch(listSelect(prevIndex));
+            }
+        }
+    }
+    else if (screen === 'DETAIL' && detail) {
+        if (detail.activePanel === 'left') {
+            const prevIndex = Math.max(detail.focusedFieldIndex - 1, 0);
+            dispatch(detailSetFocus(prevIndex));
+        }
+        // RightPanel 스크롤은 컴포넌트 내 Functional Update로 처리되므로 둠
+    }
+};
+// j Key (Down)
+export const navigateDown = () => (dispatch, getState) => {
+    const { app } = getState();
+    const { screen, list, detail, endpoints } = app;
+    if (screen === 'LIST') {
+        if (list.focus === 'TAGS') {
+            // 태그 목록 계산 (Explorer와 동일한 로직 필요)
+            const tags = new Set();
+            endpoints.forEach((ep) => ep.tags?.forEach((tag) => tags.add(tag)));
+            // Tag Search Query가 있을 경우 필터링된 개수 기준이어야 함
+            // 현재는 간단히 최대치로 제한 (ListView에서 계산된 filteredTags.length가 이상적이나 접근 불가)
+            // Thunk에서 filteredTags를 직접 계산하거나 상위에서 넘겨줘야 함. 
+            // 일단 selectedTagIndex 업데이트만 처리.
+            dispatch(listSelectTag(list.selectedTagIndex + 1));
+        }
+        else if (list.focus === 'METHODS') {
+            dispatch(listSetFocus('LIST'));
+        }
+        else {
+            // LIST
+            const nextIndex = Math.min(list.selectedIndex + 1, list.filteredEndpoints.length - 1);
+            dispatch(listSelect(nextIndex));
+        }
+    }
+    else if (screen === 'DETAIL' && detail) {
+        if (detail.activePanel === 'left') {
+            // totalFields 계산 로직 포함
+            const endpoint = detail.endpoint;
+            const pathParams = endpoint.parameters.filter((p) => p.in === 'path') || [];
+            const queryParams = endpoint.parameters.filter((p) => p.in === 'query') || [];
+            const headerParams = endpoint.parameters.filter((p) => p.in === 'header') || [];
+            const bodyParams = endpoint.parameters.filter((p) => p.in === 'body') || [];
+            const formDataParams = endpoint.parameters.filter((p) => p.in === 'formData') || [];
+            const totalFields = pathParams.length +
+                queryParams.length +
+                headerParams.length +
+                bodyParams.length +
+                formDataParams.length +
+                (endpoint.requestBody && bodyParams.length === 0 ? 1 : 0) +
+                (endpoint.responses?.length || 0);
+            const nextIndex = Math.min(detail.focusedFieldIndex + 1, totalFields - 1);
+            dispatch(detailSetFocus(nextIndex));
+        }
+    }
+};
+// h Key (Left)
+export const navigateLeft = () => (dispatch, getState) => {
+    const { app } = getState();
+    const { screen, list } = app;
+    if (screen === 'LIST') {
+        if (list.focus === 'LIST') {
+            dispatch(listSetFocus('TAGS'));
+        }
+        else if (list.focus === 'METHODS') {
+            if (list.focusedMethodIndex === 0) {
+                dispatch(listSetFocus('LIST'));
+            }
+            else {
+                const prevIndex = Math.max(list.focusedMethodIndex - 1, 0);
+                dispatch(listSelectMethod(prevIndex));
+                dispatch(listSetMethodFilter(METHODS[prevIndex]));
+            }
+        }
+    }
+    else if (screen === 'DETAIL') {
+        dispatch(detailSetPanel('left'));
+    }
+};
+// l Key (Right)
+export const navigateRight = () => (dispatch, getState) => {
+    const { app } = getState();
+    const { screen, list, detail } = app;
+    if (screen === 'LIST') {
+        if (list.focus === 'TAGS') {
+            // TAGS -> LIST (태그 선택은 ListView에서 엔터/l 로직 유지)
+            dispatch(listSelectTag(list.selectedTagIndex)); // 현재 태그 선택 유지하며 포커스만 이동
+            dispatch(listSetFocus('LIST'));
+        }
+        else if (list.focus === 'LIST') {
+            const nextIndex = (list.focusedMethodIndex + 1) % METHODS.length;
+            dispatch(listSetFocus('METHODS'));
+            dispatch(listSelectMethod(nextIndex));
+            dispatch(listSetMethodFilter(METHODS[nextIndex]));
+        }
+        else if (list.focus === 'METHODS') {
+            const nextIndex = (list.focusedMethodIndex + 1) % METHODS.length;
+            dispatch(listSelectMethod(nextIndex));
+            dispatch(listSetMethodFilter(METHODS[nextIndex]));
+        }
+    }
+    else if (screen === 'DETAIL' && detail) {
+        if (detail.activePanel === 'left') {
+            dispatch(detailSetPanel('request'));
+        }
+    }
+};

package/dist/types/app-state.d.ts

@@ -10,6 +10,7 @@ export interface AppState {
     screen: Screen;
     mode: AppMode;
     commandInput: string;
+    navigationCount: number | null;
     list: ListViewState;
     detail: DetailViewState | null;
     error: string | null;
@@ -18,13 +19,18 @@ export interface AppState {
 export interface ListViewState {
     selectedIndex: number;
     filteredEndpoints: Endpoint[];
-    activeFilter: HttpMethod | 'ALL';
+    activeMethod: HttpMethod | 'ALL';
     activeTag: string | null;
-    focus: 'TAGS' | 'LIST';
+    focus: 'TAGS' | 'LIST' | 'METHODS';
     selectedTagIndex: number;
+    focusedMethodIndex: number;
     searchQuery: string;
     tagSearchQuery: string;
     scrollOffset: number;
+    methodHistory: Record<string, {
+        selectedIndex: number;
+        scrollOffset: number;
+    }>;
 }
 export interface DetailViewState {
     endpoint: Endpoint;
@@ -68,17 +74,20 @@ export type AppAction = {
     type: 'LIST_SELECT';
     payload: number;
 } | {
-    type: 'LIST_SET_FILTER';
+    type: 'LIST_SET_METHOD_FILTER';
     payload: HttpMethod | 'ALL';
 } | {
     type: 'LIST_SET_TAG';
     payload: string | null;
 } | {
     type: 'LIST_SET_FOCUS';
-    payload: 'TAGS' | 'LIST';
+    payload: 'TAGS' | 'LIST' | 'METHODS';
 } | {
     type: 'LIST_SELECT_TAG';
     payload: number;
+} | {
+    type: 'LIST_SELECT_METHOD';
+    payload: number;
 } | {
     type: 'LIST_SET_SEARCH';
     payload: string;

package/dist/types/openapi.d.ts

@@ -42,6 +42,23 @@ export interface NormalizedParameter {
     default?: any;
     example?: any;
 }
+export interface NormalizedHeader {
+    name: string;
+    description?: string;
+    schema?: SchemaObject;
+    type?: string;
+}
+export interface NormalizedContent {
+    mediaType: string;
+    schema?: SchemaObject;
+    examples?: Record<string, any>;
+}
+export interface NormalizedResponse {
+    status: string;
+    description: string;
+    content?: NormalizedContent[];
+    headers?: NormalizedHeader[];
+}
 export interface NormalizedRequestBody {
     description?: string;
     required?: boolean;
@@ -56,7 +73,7 @@ export interface Endpoint {
     tags: string[];
     parameters: NormalizedParameter[];
     requestBody?: NormalizedRequestBody;
-    responses: ResponsesObject;
+    responses: NormalizedResponse[];
     operationId?: string;
     deprecated?: boolean;
     security?: SecurityRequirementObject[];

package/dist/utils/schema-formatter.js

@@ -138,12 +138,23 @@ function formatSchemaObject(schema, options) {
             }
             else {
                 // 단순 타입 배열
-                lines.push(`${indentStr}${refName} []`);
+                const itemType = formatType(itemsSchema);
+                if ('enum' in itemsSchema && itemsSchema.enum && Array.isArray(itemsSchema.enum)) {
+                    lines.push(`${indentStr}(${itemType}) []`);
+                }
+                else {
+                    lines.push(`${indentStr}Array<${itemType}>`);
+                }
             }
         }
         else {
             const itemType = formatType(itemsSchema);
-            lines.push(`${indentStr}Array<${itemType}>`);
+            if ('enum' in itemsSchema && itemsSchema.enum && Array.isArray(itemsSchema.enum)) {
+                lines.push(`${indentStr}(${itemType}) []`);
+            }
+            else {
+                lines.push(`${indentStr}Array<${itemType}>`);
+            }
         }
         return lines;
     }
@@ -158,8 +169,7 @@ function formatSchemaObject(schema, options) {
 function formatType(schema) {
     // Enum 타입
     if (schema.enum && Array.isArray(schema.enum)) {
-        const enumValues = schema.enum.map((v) => `'${v}'`).join(' | ');
-        return `Enum(${enumValues})`;
+        return schema.enum.map((v) => `'${v}'`).join(' | ');
     }
     // Array 타입
     if (schema.type === 'array' && schema.items) {
@@ -168,6 +178,10 @@ function formatType(schema) {
             return `Array<${refName}>`;
         }
         const itemType = formatType(schema.items);
+        // Enum 배열인 경우 괄호 추가
+        if ('enum' in schema.items && schema.items.enum && Array.isArray(schema.items.enum)) {
+            return `(${itemType}) []`;
+        }
         return `Array<${itemType}>`;
     }
     // 기본 타입
@@ -232,7 +246,7 @@ function formatComplexType(schema, options) {
 /**
  * Schema 전체를 포맷팅 (최상위 레벨)
  */
-export function formatSchemaFull(schema, document, maxDepth = 3) {
+export function formatSchemaFull(schema, document, maxDepth = 10) {
     const lines = [];
     // $ref인 경우 먼저 resolve
     let actualSchema;

package/dist/utils/schema-scaffolder.d.ts

@@ -0,0 +1,7 @@
+import { SchemaObject, ReferenceObject, OpenAPIDocument } from '../types/openapi.js';
+/**
+ * OpenAPI 스키마를 기반으로 기본값 JSON 객체를 생성합니다.
+ * @param schema 스키마 객체
+ * @param document 참조 해결을 위한 OpenAPI 문서 (선택)
+ */
+export declare const scaffoldSchema: (schema: SchemaObject | ReferenceObject | undefined, document?: OpenAPIDocument) => string | number | boolean | object | null;