clawfire 0.1.0 → 0.2.1

package/dist/dev.d.cts

@@ -4,74 +4,65 @@ import './schema-BJsictSV.cjs';
 import 'zod';
 
 interface DevServerOptions {
-    /** 프로젝트 루트 경로 */
+    /** Project root path */
     projectDir?: string;
-    /** 서버 포트 (기본: 3456) */
+    /** Frontend server port (default: 3000) */
     port?: number;
-    /** 라우터 옵션 */
+    /** API server port (default: 3456) */
+    apiPort?: number;
+    /** Router options */
     routerOptions?: Partial<RouterOptions>;
-    /** 핫 리로드 활성화 (기본: true) */
+    /** Hot reload enabled (default: true) */
     hotReload?: boolean;
-    /** 변경 감지 디바운스 ms (기본: 150) */
+    /** Change detection debounce ms (default: 150) */
     debounceMs?: number;
-    /** 라우트를 수동으로 등록하는 콜백 (파일 기반 대신) */
+    /** Callback to manually register routes (instead of file-based) */
     onSetupRoutes?: (router: ClawfireRouter) => void | Promise<void>;
 }
 declare class DevServer {
-    private server;
+    private frontendServer;
+    private apiServer;
     private router;
     private watcher;
-    private sseClients;
+    private frontendSseClients;
+    private apiSseClients;
     private sseIdCounter;
     private options;
     private routesDir;
     private schemasDir;
+    private publicDir;
+    private pagesDir;
+    private componentsDir;
     private playgroundHtml;
     private importCounter;
     private isReloading;
+    private pageCompiler;
     constructor(options?: DevServerOptions);
-    /**
-     * 개발 서버 시작
-     */
     start(): Promise<void>;
-    /**
-     * 서버 종료
-     */
     stop(): Promise<void>;
-    /**
-     * 라우트 파일 로딩 (또는 수동 콜백)
-     */
     private loadRoutes;
-    /**
-     * 라우트 핫 리로드
-     */
     private reloadRoutes;
+    private handleFrontendChange;
     private startWatcher;
     private handleSSE;
     private broadcastSSE;
     private regeneratePlayground;
-    private handleHttpRequest;
+    /**
+     * Inject HMR and (optionally) client-side router scripts before </body>.
+     */
+    private injectScripts;
+    private serveStaticFile;
+    private proxyToApiServer;
+    private handleFrontendRequest;
+    private handleApiRequest;
     private printStartupBanner;
 }
 /**
- * 개발 서버 생성 및 시작 (원라인 헬퍼)
- *
- * @example
- * ```ts
- * import { startDevServer } from "clawfire/dev";
- *
- * startDevServer({
- *   port: 3456,
- *   onSetupRoutes: (router) => {
- *     router.register("/health", healthRoute);
- *     router.register("/products/list", listRoute);
- *   }
- * });
- * ```
+ * Create and start dev server (one-line helper)
  */
 declare function startDevServer(options?: DevServerOptions): Promise<DevServer>;
 
-type WatchEventType = "route-change" | "schema-change" | "config-change" | "any-change";
+type WatchEventType = "route-change" | "schema-change" | "config-change" | "frontend-change" | "css-change" | "page-change" | "component-change" | "any-change";
 interface WatchEvent {
     type: WatchEventType;
     filePath: string;
@@ -90,6 +81,14 @@ declare class FileWatcher extends EventEmitter {
      * 단일 파일 감시
      */
     watchFile(filePath: string, eventType: WatchEventType): this;
+    /**
+     * 프론트엔드 디렉터리 감시 (확장자별 이벤트 타입 자동 결정)
+     */
+    watchDirFrontend(dir: string): this;
+    /**
+     * Linux fallback: 프론트엔드 디렉터리 수동 재귀 감시
+     */
+    private watchDirFrontendRecursiveManual;
     /**
      * Linux fallback: 디렉터리 수동 재귀 감시
      */

package/dist/dev.d.ts

@@ -4,74 +4,65 @@ import './schema-BJsictSV.js';
 import 'zod';
 
 interface DevServerOptions {
-    /** 프로젝트 루트 경로 */
+    /** Project root path */
     projectDir?: string;
-    /** 서버 포트 (기본: 3456) */
+    /** Frontend server port (default: 3000) */
     port?: number;
-    /** 라우터 옵션 */
+    /** API server port (default: 3456) */
+    apiPort?: number;
+    /** Router options */
     routerOptions?: Partial<RouterOptions>;
-    /** 핫 리로드 활성화 (기본: true) */
+    /** Hot reload enabled (default: true) */
     hotReload?: boolean;
-    /** 변경 감지 디바운스 ms (기본: 150) */
+    /** Change detection debounce ms (default: 150) */
     debounceMs?: number;
-    /** 라우트를 수동으로 등록하는 콜백 (파일 기반 대신) */
+    /** Callback to manually register routes (instead of file-based) */
     onSetupRoutes?: (router: ClawfireRouter) => void | Promise<void>;
 }
 declare class DevServer {
-    private server;
+    private frontendServer;
+    private apiServer;
     private router;
     private watcher;
-    private sseClients;
+    private frontendSseClients;
+    private apiSseClients;
     private sseIdCounter;
     private options;
     private routesDir;
     private schemasDir;
+    private publicDir;
+    private pagesDir;
+    private componentsDir;
     private playgroundHtml;
     private importCounter;
     private isReloading;
+    private pageCompiler;
     constructor(options?: DevServerOptions);
-    /**
-     * 개발 서버 시작
-     */
     start(): Promise<void>;
-    /**
-     * 서버 종료
-     */
     stop(): Promise<void>;
-    /**
-     * 라우트 파일 로딩 (또는 수동 콜백)
-     */
     private loadRoutes;
-    /**
-     * 라우트 핫 리로드
-     */
     private reloadRoutes;
+    private handleFrontendChange;
     private startWatcher;
     private handleSSE;
     private broadcastSSE;
     private regeneratePlayground;
-    private handleHttpRequest;
+    /**
+     * Inject HMR and (optionally) client-side router scripts before </body>.
+     */
+    private injectScripts;
+    private serveStaticFile;
+    private proxyToApiServer;
+    private handleFrontendRequest;
+    private handleApiRequest;
     private printStartupBanner;
 }
 /**
- * 개발 서버 생성 및 시작 (원라인 헬퍼)
- *
- * @example
- * ```ts
- * import { startDevServer } from "clawfire/dev";
- *
- * startDevServer({
- *   port: 3456,
- *   onSetupRoutes: (router) => {
- *     router.register("/health", healthRoute);
- *     router.register("/products/list", listRoute);
- *   }
- * });
- * ```
+ * Create and start dev server (one-line helper)
  */
 declare function startDevServer(options?: DevServerOptions): Promise<DevServer>;
 
-type WatchEventType = "route-change" | "schema-change" | "config-change" | "any-change";
+type WatchEventType = "route-change" | "schema-change" | "config-change" | "frontend-change" | "css-change" | "page-change" | "component-change" | "any-change";
 interface WatchEvent {
     type: WatchEventType;
     filePath: string;
@@ -90,6 +81,14 @@ declare class FileWatcher extends EventEmitter {
      * 단일 파일 감시
      */
     watchFile(filePath: string, eventType: WatchEventType): this;
+    /**
+     * 프론트엔드 디렉터리 감시 (확장자별 이벤트 타입 자동 결정)
+     */
+    watchDirFrontend(dir: string): this;
+    /**
+     * Linux fallback: 프론트엔드 디렉터리 수동 재귀 감시
+     */
+    private watchDirFrontendRecursiveManual;
     /**
      * Linux fallback: 디렉터리 수동 재귀 감시
      */