@faapi/faapi 6.22.0 → 6.23.0

package/dist/cli/index.js

@@ -649,9 +649,9 @@ var init_constants = __esm({
 });
 
 // src/utils/normalizePath.ts
-function normalizePath(path34) {
-  if (!path34) return "";
-  let result = path34.replace(/\\/g, "/");
+function normalizePath(path35) {
+  if (!path35) return "";
+  let result = path35.replace(/\\/g, "/");
   result = result.replace(/\/+/g, "/");
   result = result.replace(/\/+$/, "");
   if (result && !result.startsWith("/")) {
@@ -3681,7 +3681,7 @@ async function compileSourceFiles(options) {
     cwd: rootDir,
     onlyFiles: true,
     absolute: true,
-    ignore: ["**/*.test.ts", "**/*.e2e.test.ts", "**/*.d.ts"]
+    ignore: SOURCE_IGNORE
   });
   if (entryPoints.length === 0) {
     return { compiledFiles: [] };
@@ -3719,11 +3719,13 @@ async function compileSourceFiles(options) {
   }
   return { compiledFiles: entryPoints };
 }
+var SOURCE_IGNORE;
 var init_compileSourceFiles = __esm({
   "src/cli/compileSourceFiles.ts"() {
     "use strict";
     init_aliasPlugin();
     init_prodPaths();
+    SOURCE_IGNORE = ["**/*.test.ts", "**/*.e2e.test.ts", "**/*.d.ts", `${APP_DIR}/resources/**`];
   }
 });
 
@@ -4132,7 +4134,7 @@ var init_esm = __esm({
         this._directoryFilter = normalizeFilter(opts.directoryFilter);
         const statMethod = opts.lstat ? lstat : stat;
         if (wantBigintFsStats) {
-          this._stat = (path34) => statMethod(path34, { bigint: true });
+          this._stat = (path35) => statMethod(path35, { bigint: true });
         } else {
           this._stat = statMethod;
         }
@@ -4157,8 +4159,8 @@ var init_esm = __esm({
             const par = this.parent;
             const fil = par && par.files;
             if (fil && fil.length > 0) {
-              const { path: path34, depth } = par;
-              const slice = fil.splice(0, batch).map((dirent) => this._formatEntry(dirent, path34));
+              const { path: path35, depth } = par;
+              const slice = fil.splice(0, batch).map((dirent) => this._formatEntry(dirent, path35));
               const awaited = await Promise.all(slice);
               for (const entry of awaited) {
                 if (!entry)
@@ -4198,20 +4200,20 @@ var init_esm = __esm({
           this.reading = false;
         }
       }
-      async _exploreDir(path34, depth) {
+      async _exploreDir(path35, depth) {
         let files;
         try {
-          files = await readdir(path34, this._rdOptions);
+          files = await readdir(path35, this._rdOptions);
         } catch (error) {
           this._onError(error);
         }
-        return { files, depth, path: path34 };
+        return { files, depth, path: path35 };
       }
-      async _formatEntry(dirent, path34) {
+      async _formatEntry(dirent, path35) {
         let entry;
         const basename3 = this._isDirent ? dirent.name : dirent;
         try {
-          const fullPath = presolve(pjoin(path34, basename3));
+          const fullPath = presolve(pjoin(path35, basename3));
           entry = { path: prelative(this._root, fullPath), fullPath, basename: basename3 };
           entry[this._statsProp] = this._isDirent ? dirent : await this._stat(fullPath);
         } catch (err) {
@@ -4272,16 +4274,16 @@ import { watchFile, unwatchFile, watch as fs_watch } from "fs";
 import { open, stat as stat2, lstat as lstat2, realpath as fsrealpath } from "fs/promises";
 import * as sysPath from "path";
 import { type as osType } from "os";
-function createFsWatchInstance(path34, options, listener, errHandler, emitRaw) {
+function createFsWatchInstance(path35, options, listener, errHandler, emitRaw) {
   const handleEvent = (rawEvent, evPath) => {
-    listener(path34);
-    emitRaw(rawEvent, evPath, { watchedPath: path34 });
-    if (evPath && path34 !== evPath) {
-      fsWatchBroadcast(sysPath.resolve(path34, evPath), KEY_LISTENERS, sysPath.join(path34, evPath));
+    listener(path35);
+    emitRaw(rawEvent, evPath, { watchedPath: path35 });
+    if (evPath && path35 !== evPath) {
+      fsWatchBroadcast(sysPath.resolve(path35, evPath), KEY_LISTENERS, sysPath.join(path35, evPath));
     }
   };
   try {
-    return fs_watch(path34, {
+    return fs_watch(path35, {
       persistent: options.persistent
     }, handleEvent);
   } catch (error) {
@@ -4626,12 +4628,12 @@ var init_handler = __esm({
         listener(val1, val2, val3);
       });
     };
-    setFsWatchListener = (path34, fullPath, options, handlers) => {
+    setFsWatchListener = (path35, fullPath, options, handlers) => {
       const { listener, errHandler, rawEmitter } = handlers;
       let cont = FsWatchInstances.get(fullPath);
       let watcher;
       if (!options.persistent) {
-        watcher = createFsWatchInstance(path34, options, listener, errHandler, rawEmitter);
+        watcher = createFsWatchInstance(path35, options, listener, errHandler, rawEmitter);
         if (!watcher)
           return;
         return watcher.close.bind(watcher);
@@ -4642,7 +4644,7 @@ var init_handler = __esm({
         addAndConvert(cont, KEY_RAW, rawEmitter);
       } else {
         watcher = createFsWatchInstance(
-          path34,
+          path35,
           options,
           fsWatchBroadcast.bind(null, fullPath, KEY_LISTENERS),
           errHandler,
@@ -4657,7 +4659,7 @@ var init_handler = __esm({
             cont.watcherUnusable = true;
           if (isWindows && error.code === "EPERM") {
             try {
-              const fd = await open(path34, "r");
+              const fd = await open(path35, "r");
               await fd.close();
               broadcastErr(error);
             } catch (err) {
@@ -4688,7 +4690,7 @@ var init_handler = __esm({
       };
     };
     FsWatchFileInstances = /* @__PURE__ */ new Map();
-    setFsWatchFileListener = (path34, fullPath, options, handlers) => {
+    setFsWatchFileListener = (path35, fullPath, options, handlers) => {
       const { listener, rawEmitter } = handlers;
       let cont = FsWatchFileInstances.get(fullPath);
       const copts = cont && cont.options;
@@ -4710,7 +4712,7 @@ var init_handler = __esm({
             });
             const currmtime = curr.mtimeMs;
             if (curr.size !== prev.size || currmtime > prev.mtimeMs || currmtime === 0) {
-              foreach(cont.listeners, (listener2) => listener2(path34, curr));
+              foreach(cont.listeners, (listener2) => listener2(path35, curr));
             }
           })
         };
@@ -4738,13 +4740,13 @@ var init_handler = __esm({
        * @param listener on fs change
        * @returns closer for the watcher instance
        */
-      _watchWithNodeFs(path34, listener) {
+      _watchWithNodeFs(path35, listener) {
         const opts = this.fsw.options;
-        const directory = sysPath.dirname(path34);
-        const basename3 = sysPath.basename(path34);
+        const directory = sysPath.dirname(path35);
+        const basename3 = sysPath.basename(path35);
         const parent = this.fsw._getWatchedDir(directory);
         parent.add(basename3);
-        const absolutePath = sysPath.resolve(path34);
+        const absolutePath = sysPath.resolve(path35);
         const options = {
           persistent: opts.persistent
         };
@@ -4754,12 +4756,12 @@ var init_handler = __esm({
         if (opts.usePolling) {
           const enableBin = opts.interval !== opts.binaryInterval;
           options.interval = enableBin && isBinaryPath(basename3) ? opts.binaryInterval : opts.interval;
-          closer = setFsWatchFileListener(path34, absolutePath, options, {
+          closer = setFsWatchFileListener(path35, absolutePath, options, {
             listener,
             rawEmitter: this.fsw._emitRaw
           });
         } else {
-          closer = setFsWatchListener(path34, absolutePath, options, {
+          closer = setFsWatchListener(path35, absolutePath, options, {
             listener,
             errHandler: this._boundHandleError,
             rawEmitter: this.fsw._emitRaw
@@ -4781,7 +4783,7 @@ var init_handler = __esm({
         let prevStats = stats;
         if (parent.has(basename3))
           return;
-        const listener = async (path34, newStats) => {
+        const listener = async (path35, newStats) => {
           if (!this.fsw._throttle(THROTTLE_MODE_WATCH, file, 5))
             return;
           if (!newStats || newStats.mtimeMs === 0) {
@@ -4795,11 +4797,11 @@ var init_handler = __esm({
                 this.fsw._emit(EV.CHANGE, file, newStats2);
               }
               if ((isMacos || isLinux || isFreeBSD) && prevStats.ino !== newStats2.ino) {
-                this.fsw._closeFile(path34);
+                this.fsw._closeFile(path35);
                 prevStats = newStats2;
                 const closer2 = this._watchWithNodeFs(file, listener);
                 if (closer2)
-                  this.fsw._addPathCloser(path34, closer2);
+                  this.fsw._addPathCloser(path35, closer2);
               } else {
                 prevStats = newStats2;
               }
@@ -4831,7 +4833,7 @@ var init_handler = __esm({
        * @param item basename of this item
        * @returns true if no more processing is needed for this entry.
        */
-      async _handleSymlink(entry, directory, path34, item) {
+      async _handleSymlink(entry, directory, path35, item) {
         if (this.fsw.closed) {
           return;
         }
@@ -4841,7 +4843,7 @@ var init_handler = __esm({
           this.fsw._incrReadyCount();
           let linkPath;
           try {
-            linkPath = await fsrealpath(path34);
+            linkPath = await fsrealpath(path35);
           } catch (e) {
             this.fsw._emitReady();
             return true;
@@ -4851,12 +4853,12 @@ var init_handler = __esm({
           if (dir.has(item)) {
             if (this.fsw._symlinkPaths.get(full) !== linkPath) {
               this.fsw._symlinkPaths.set(full, linkPath);
-              this.fsw._emit(EV.CHANGE, path34, entry.stats);
+              this.fsw._emit(EV.CHANGE, path35, entry.stats);
             }
           } else {
             dir.add(item);
             this.fsw._symlinkPaths.set(full, linkPath);
-            this.fsw._emit(EV.ADD, path34, entry.stats);
+            this.fsw._emit(EV.ADD, path35, entry.stats);
           }
           this.fsw._emitReady();
           return true;
@@ -4885,9 +4887,9 @@ var init_handler = __esm({
             return;
           }
           const item = entry.path;
-          let path34 = sysPath.join(directory, item);
+          let path35 = sysPath.join(directory, item);
           current.add(item);
-          if (entry.stats.isSymbolicLink() && await this._handleSymlink(entry, directory, path34, item)) {
+          if (entry.stats.isSymbolicLink() && await this._handleSymlink(entry, directory, path35, item)) {
             return;
           }
           if (this.fsw.closed) {
@@ -4896,8 +4898,8 @@ var init_handler = __esm({
           }
           if (item === target || !target && !previous.has(item)) {
             this.fsw._incrReadyCount();
-            path34 = sysPath.join(dir, sysPath.relative(dir, path34));
-            this._addToNodeFs(path34, initialAdd, wh, depth + 1);
+            path35 = sysPath.join(dir, sysPath.relative(dir, path35));
+            this._addToNodeFs(path35, initialAdd, wh, depth + 1);
           }
         }).on(EV.ERROR, this._boundHandleError);
         return new Promise((resolve3, reject) => {
@@ -4966,13 +4968,13 @@ var init_handler = __esm({
        * @param depth Child path actually targeted for watch
        * @param target Child path actually targeted for watch
        */
-      async _addToNodeFs(path34, initialAdd, priorWh, depth, target) {
+      async _addToNodeFs(path35, initialAdd, priorWh, depth, target) {
         const ready = this.fsw._emitReady;
-        if (this.fsw._isIgnored(path34) || this.fsw.closed) {
+        if (this.fsw._isIgnored(path35) || this.fsw.closed) {
           ready();
           return false;
         }
-        const wh = this.fsw._getWatchHelpers(path34);
+        const wh = this.fsw._getWatchHelpers(path35);
         if (priorWh) {
           wh.filterPath = (entry) => priorWh.filterPath(entry);
           wh.filterDir = (entry) => priorWh.filterDir(entry);
@@ -4988,8 +4990,8 @@ var init_handler = __esm({
           const follow = this.fsw.options.followSymlinks;
           let closer;
           if (stats.isDirectory()) {
-            const absPath = sysPath.resolve(path34);
-            const targetPath = follow ? await fsrealpath(path34) : path34;
+            const absPath = sysPath.resolve(path35);
+            const targetPath = follow ? await fsrealpath(path35) : path35;
             if (this.fsw.closed)
               return;
             closer = await this._handleDir(wh.watchPath, stats, initialAdd, depth, target, wh, targetPath);
@@ -4999,29 +5001,29 @@ var init_handler = __esm({
               this.fsw._symlinkPaths.set(absPath, targetPath);
             }
           } else if (stats.isSymbolicLink()) {
-            const targetPath = follow ? await fsrealpath(path34) : path34;
+            const targetPath = follow ? await fsrealpath(path35) : path35;
             if (this.fsw.closed)
               return;
             const parent = sysPath.dirname(wh.watchPath);
             this.fsw._getWatchedDir(parent).add(wh.watchPath);
             this.fsw._emit(EV.ADD, wh.watchPath, stats);
-            closer = await this._handleDir(parent, stats, initialAdd, depth, path34, wh, targetPath);
+            closer = await this._handleDir(parent, stats, initialAdd, depth, path35, wh, targetPath);
             if (this.fsw.closed)
               return;
             if (targetPath !== void 0) {
-              this.fsw._symlinkPaths.set(sysPath.resolve(path34), targetPath);
+              this.fsw._symlinkPaths.set(sysPath.resolve(path35), targetPath);
             }
           } else {
             closer = this._handleFile(wh.watchPath, stats, initialAdd);
           }
           ready();
           if (closer)
-            this.fsw._addPathCloser(path34, closer);
+            this.fsw._addPathCloser(path35, closer);
           return false;
         } catch (error) {
           if (this.fsw._handleError(error)) {
             ready();
-            return path34;
+            return path35;
           }
         }
       }
@@ -5060,26 +5062,26 @@ function createPattern(matcher) {
   }
   return () => false;
 }
-function normalizePath2(path34) {
-  if (typeof path34 !== "string")
+function normalizePath2(path35) {
+  if (typeof path35 !== "string")
     throw new Error("string expected");
-  path34 = sysPath2.normalize(path34);
-  path34 = path34.replace(/\\/g, "/");
+  path35 = sysPath2.normalize(path35);
+  path35 = path35.replace(/\\/g, "/");
   let prepend = false;
-  if (path34.startsWith("//"))
+  if (path35.startsWith("//"))
     prepend = true;
   const DOUBLE_SLASH_RE2 = /\/\//;
-  while (path34.match(DOUBLE_SLASH_RE2))
-    path34 = path34.replace(DOUBLE_SLASH_RE2, "/");
+  while (path35.match(DOUBLE_SLASH_RE2))
+    path35 = path35.replace(DOUBLE_SLASH_RE2, "/");
   if (prepend)
-    path34 = "/" + path34;
-  return path34;
+    path35 = "/" + path35;
+  return path35;
 }
 function matchPatterns(patterns, testString, stats) {
-  const path34 = normalizePath2(testString);
+  const path35 = normalizePath2(testString);
   for (let index = 0; index < patterns.length; index++) {
     const pattern = patterns[index];
-    if (pattern(path34, stats)) {
+    if (pattern(path35, stats)) {
       return true;
     }
   }
@@ -5140,19 +5142,19 @@ var init_esm2 = __esm({
       }
       return str;
     };
-    normalizePathToUnix = (path34) => toUnix(sysPath2.normalize(toUnix(path34)));
-    normalizeIgnored = (cwd = "") => (path34) => {
-      if (typeof path34 === "string") {
-        return normalizePathToUnix(sysPath2.isAbsolute(path34) ? path34 : sysPath2.join(cwd, path34));
+    normalizePathToUnix = (path35) => toUnix(sysPath2.normalize(toUnix(path35)));
+    normalizeIgnored = (cwd = "") => (path35) => {
+      if (typeof path35 === "string") {
+        return normalizePathToUnix(sysPath2.isAbsolute(path35) ? path35 : sysPath2.join(cwd, path35));
       } else {
-        return path34;
+        return path35;
       }
     };
-    getAbsolutePath = (path34, cwd) => {
-      if (sysPath2.isAbsolute(path34)) {
-        return path34;
+    getAbsolutePath = (path35, cwd) => {
+      if (sysPath2.isAbsolute(path35)) {
+        return path35;
       }
-      return sysPath2.join(cwd, path34);
+      return sysPath2.join(cwd, path35);
     };
     EMPTY_SET = Object.freeze(/* @__PURE__ */ new Set());
     DirEntry = class {
@@ -5207,10 +5209,10 @@ var init_esm2 = __esm({
     STAT_METHOD_F = "stat";
     STAT_METHOD_L = "lstat";
     WatchHelper = class {
-      constructor(path34, follow, fsw) {
+      constructor(path35, follow, fsw) {
         this.fsw = fsw;
-        const watchPath = path34;
-        this.path = path34 = path34.replace(REPLACER_RE, "");
+        const watchPath = path35;
+        this.path = path35 = path35.replace(REPLACER_RE, "");
         this.watchPath = watchPath;
         this.fullWatchPath = sysPath2.resolve(watchPath);
         this.dirParts = [];
@@ -5332,20 +5334,20 @@ var init_esm2 = __esm({
         this._closePromise = void 0;
         let paths = unifyPaths(paths_);
         if (cwd) {
-          paths = paths.map((path34) => {
-            const absPath = getAbsolutePath(path34, cwd);
+          paths = paths.map((path35) => {
+            const absPath = getAbsolutePath(path35, cwd);
             return absPath;
           });
         }
-        paths.forEach((path34) => {
-          this._removeIgnoredPath(path34);
+        paths.forEach((path35) => {
+          this._removeIgnoredPath(path35);
         });
         this._userIgnored = void 0;
         if (!this._readyCount)
           this._readyCount = 0;
         this._readyCount += paths.length;
-        Promise.all(paths.map(async (path34) => {
-          const res = await this._nodeFsHandler._addToNodeFs(path34, !_internal, void 0, 0, _origAdd);
+        Promise.all(paths.map(async (path35) => {
+          const res = await this._nodeFsHandler._addToNodeFs(path35, !_internal, void 0, 0, _origAdd);
           if (res)
             this._emitReady();
           return res;
@@ -5367,17 +5369,17 @@ var init_esm2 = __esm({
           return this;
         const paths = unifyPaths(paths_);
         const { cwd } = this.options;
-        paths.forEach((path34) => {
-          if (!sysPath2.isAbsolute(path34) && !this._closers.has(path34)) {
+        paths.forEach((path35) => {
+          if (!sysPath2.isAbsolute(path35) && !this._closers.has(path35)) {
             if (cwd)
-              path34 = sysPath2.join(cwd, path34);
-            path34 = sysPath2.resolve(path34);
+              path35 = sysPath2.join(cwd, path35);
+            path35 = sysPath2.resolve(path35);
           }
-          this._closePath(path34);
-          this._addIgnoredPath(path34);
-          if (this._watched.has(path34)) {
+          this._closePath(path35);
+          this._addIgnoredPath(path35);
+          if (this._watched.has(path35)) {
             this._addIgnoredPath({
-              path: path34,
+              path: path35,
               recursive: true
             });
           }
@@ -5441,38 +5443,38 @@ var init_esm2 = __esm({
        * @param stats arguments to be passed with event
        * @returns the error if defined, otherwise the value of the FSWatcher instance's `closed` flag
        */
-      async _emit(event, path34, stats) {
+      async _emit(event, path35, stats) {
         if (this.closed)
           return;
         const opts = this.options;
         if (isWindows)
-          path34 = sysPath2.normalize(path34);
+          path35 = sysPath2.normalize(path35);
         if (opts.cwd)
-          path34 = sysPath2.relative(opts.cwd, path34);
-        const args = [path34];
+          path35 = sysPath2.relative(opts.cwd, path35);
+        const args = [path35];
         if (stats != null)
           args.push(stats);
         const awf = opts.awaitWriteFinish;
         let pw;
-        if (awf && (pw = this._pendingWrites.get(path34))) {
+        if (awf && (pw = this._pendingWrites.get(path35))) {
           pw.lastChange = /* @__PURE__ */ new Date();
           return this;
         }
         if (opts.atomic) {
           if (event === EVENTS.UNLINK) {
-            this._pendingUnlinks.set(path34, [event, ...args]);
+            this._pendingUnlinks.set(path35, [event, ...args]);
             setTimeout(() => {
-              this._pendingUnlinks.forEach((entry, path35) => {
+              this._pendingUnlinks.forEach((entry, path36) => {
                 this.emit(...entry);
                 this.emit(EVENTS.ALL, ...entry);
-                this._pendingUnlinks.delete(path35);
+                this._pendingUnlinks.delete(path36);
               });
             }, typeof opts.atomic === "number" ? opts.atomic : 100);
             return this;
           }
-          if (event === EVENTS.ADD && this._pendingUnlinks.has(path34)) {
+          if (event === EVENTS.ADD && this._pendingUnlinks.has(path35)) {
             event = EVENTS.CHANGE;
-            this._pendingUnlinks.delete(path34);
+            this._pendingUnlinks.delete(path35);
           }
         }
         if (awf && (event === EVENTS.ADD || event === EVENTS.CHANGE) && this._readyEmitted) {
@@ -5490,16 +5492,16 @@ var init_esm2 = __esm({
               this.emitWithAll(event, args);
             }
           };
-          this._awaitWriteFinish(path34, awf.stabilityThreshold, event, awfEmit);
+          this._awaitWriteFinish(path35, awf.stabilityThreshold, event, awfEmit);
           return this;
         }
         if (event === EVENTS.CHANGE) {
-          const isThrottled = !this._throttle(EVENTS.CHANGE, path34, 50);
+          const isThrottled = !this._throttle(EVENTS.CHANGE, path35, 50);
           if (isThrottled)
             return this;
         }
         if (opts.alwaysStat && stats === void 0 && (event === EVENTS.ADD || event === EVENTS.ADD_DIR || event === EVENTS.CHANGE)) {
-          const fullPath = opts.cwd ? sysPath2.join(opts.cwd, path34) : path34;
+          const fullPath = opts.cwd ? sysPath2.join(opts.cwd, path35) : path35;
           let stats2;
           try {
             stats2 = await stat3(fullPath);
@@ -5530,23 +5532,23 @@ var init_esm2 = __esm({
        * @param timeout duration of time to suppress duplicate actions
        * @returns tracking object or false if action should be suppressed
        */
-      _throttle(actionType, path34, timeout) {
+      _throttle(actionType, path35, timeout) {
         if (!this._throttled.has(actionType)) {
           this._throttled.set(actionType, /* @__PURE__ */ new Map());
         }
         const action = this._throttled.get(actionType);
         if (!action)
           throw new Error("invalid throttle");
-        const actionPath = action.get(path34);
+        const actionPath = action.get(path35);
         if (actionPath) {
           actionPath.count++;
           return false;
         }
         let timeoutObject;
         const clear = () => {
-          const item = action.get(path34);
+          const item = action.get(path35);
           const count = item ? item.count : 0;
-          action.delete(path34);
+          action.delete(path35);
           clearTimeout(timeoutObject);
           if (item)
             clearTimeout(item.timeoutObject);
@@ -5554,7 +5556,7 @@ var init_esm2 = __esm({
         };
         timeoutObject = setTimeout(clear, timeout);
         const thr = { timeoutObject, clear, count: 0 };
-        action.set(path34, thr);
+        action.set(path35, thr);
         return thr;
       }
       _incrReadyCount() {
@@ -5568,44 +5570,44 @@ var init_esm2 = __esm({
        * @param event
        * @param awfEmit Callback to be called when ready for event to be emitted.
        */
-      _awaitWriteFinish(path34, threshold, event, awfEmit) {
+      _awaitWriteFinish(path35, threshold, event, awfEmit) {
         const awf = this.options.awaitWriteFinish;
         if (typeof awf !== "object")
           return;
         const pollInterval = awf.pollInterval;
         let timeoutHandler;
-        let fullPath = path34;
-        if (this.options.cwd && !sysPath2.isAbsolute(path34)) {
-          fullPath = sysPath2.join(this.options.cwd, path34);
+        let fullPath = path35;
+        if (this.options.cwd && !sysPath2.isAbsolute(path35)) {
+          fullPath = sysPath2.join(this.options.cwd, path35);
         }
         const now = /* @__PURE__ */ new Date();
         const writes = this._pendingWrites;
         function awaitWriteFinishFn(prevStat) {
           statcb(fullPath, (err, curStat) => {
-            if (err || !writes.has(path34)) {
+            if (err || !writes.has(path35)) {
               if (err && err.code !== "ENOENT")
                 awfEmit(err);
               return;
             }
             const now2 = Number(/* @__PURE__ */ new Date());
             if (prevStat && curStat.size !== prevStat.size) {
-              writes.get(path34).lastChange = now2;
+              writes.get(path35).lastChange = now2;
             }
-            const pw = writes.get(path34);
+            const pw = writes.get(path35);
             const df = now2 - pw.lastChange;
             if (df >= threshold) {
-              writes.delete(path34);
+              writes.delete(path35);
               awfEmit(void 0, curStat);
             } else {
               timeoutHandler = setTimeout(awaitWriteFinishFn, pollInterval, curStat);
             }
           });
         }
-        if (!writes.has(path34)) {
-          writes.set(path34, {
+        if (!writes.has(path35)) {
+          writes.set(path35, {
             lastChange: now,
             cancelWait: () => {
-              writes.delete(path34);
+              writes.delete(path35);
               clearTimeout(timeoutHandler);
               return event;
             }
@@ -5616,8 +5618,8 @@ var init_esm2 = __esm({
       /**
        * Determines whether user has asked to ignore this path.
        */
-      _isIgnored(path34, stats) {
-        if (this.options.atomic && DOT_RE.test(path34))
+      _isIgnored(path35, stats) {
+        if (this.options.atomic && DOT_RE.test(path35))
           return true;
         if (!this._userIgnored) {
           const { cwd } = this.options;
@@ -5627,17 +5629,17 @@ var init_esm2 = __esm({
           const list = [...ignoredPaths.map(normalizeIgnored(cwd)), ...ignored];
           this._userIgnored = anymatch(list, void 0);
         }
-        return this._userIgnored(path34, stats);
+        return this._userIgnored(path35, stats);
       }
-      _isntIgnored(path34, stat4) {
-        return !this._isIgnored(path34, stat4);
+      _isntIgnored(path35, stat4) {
+        return !this._isIgnored(path35, stat4);
       }
       /**
        * Provides a set of common helpers and properties relating to symlink handling.
        * @param path file or directory pattern being watched
        */
-      _getWatchHelpers(path34) {
-        return new WatchHelper(path34, this.options.followSymlinks, this);
+      _getWatchHelpers(path35) {
+        return new WatchHelper(path35, this.options.followSymlinks, this);
       }
       // Directory helpers
       // -----------------
@@ -5669,63 +5671,63 @@ var init_esm2 = __esm({
        * @param item      base path of item/directory
        */
       _remove(directory, item, isDirectory) {
-        const path34 = sysPath2.join(directory, item);
-        const fullPath = sysPath2.resolve(path34);
-        isDirectory = isDirectory != null ? isDirectory : this._watched.has(path34) || this._watched.has(fullPath);
-        if (!this._throttle("remove", path34, 100))
+        const path35 = sysPath2.join(directory, item);
+        const fullPath = sysPath2.resolve(path35);
+        isDirectory = isDirectory != null ? isDirectory : this._watched.has(path35) || this._watched.has(fullPath);
+        if (!this._throttle("remove", path35, 100))
           return;
         if (!isDirectory && this._watched.size === 1) {
           this.add(directory, item, true);
         }
-        const wp = this._getWatchedDir(path34);
+        const wp = this._getWatchedDir(path35);
         const nestedDirectoryChildren = wp.getChildren();
-        nestedDirectoryChildren.forEach((nested) => this._remove(path34, nested));
+        nestedDirectoryChildren.forEach((nested) => this._remove(path35, nested));
         const parent = this._getWatchedDir(directory);
         const wasTracked = parent.has(item);
         parent.remove(item);
         if (this._symlinkPaths.has(fullPath)) {
           this._symlinkPaths.delete(fullPath);
         }
-        let relPath = path34;
+        let relPath = path35;
         if (this.options.cwd)
-          relPath = sysPath2.relative(this.options.cwd, path34);
+          relPath = sysPath2.relative(this.options.cwd, path35);
         if (this.options.awaitWriteFinish && this._pendingWrites.has(relPath)) {
           const event = this._pendingWrites.get(relPath).cancelWait();
           if (event === EVENTS.ADD)
             return;
         }
-        this._watched.delete(path34);
+        this._watched.delete(path35);
         this._watched.delete(fullPath);
         const eventName = isDirectory ? EVENTS.UNLINK_DIR : EVENTS.UNLINK;
-        if (wasTracked && !this._isIgnored(path34))
-          this._emit(eventName, path34);
-        this._closePath(path34);
+        if (wasTracked && !this._isIgnored(path35))
+          this._emit(eventName, path35);
+        this._closePath(path35);
       }
       /**
        * Closes all watchers for a path
        */
-      _closePath(path34) {
-        this._closeFile(path34);
-        const dir = sysPath2.dirname(path34);
-        this._getWatchedDir(dir).remove(sysPath2.basename(path34));
+      _closePath(path35) {
+        this._closeFile(path35);
+        const dir = sysPath2.dirname(path35);
+        this._getWatchedDir(dir).remove(sysPath2.basename(path35));
       }
       /**
        * Closes only file-specific watchers
        */
-      _closeFile(path34) {
-        const closers = this._closers.get(path34);
+      _closeFile(path35) {
+        const closers = this._closers.get(path35);
         if (!closers)
           return;
         closers.forEach((closer) => closer());
-        this._closers.delete(path34);
+        this._closers.delete(path35);
       }
-      _addPathCloser(path34, closer) {
+      _addPathCloser(path35, closer) {
         if (!closer)
           return;
-        let list = this._closers.get(path34);
+        let list = this._closers.get(path35);
         if (!list) {
           list = [];
-          this._closers.set(path34, list);
+          this._closers.set(path35, list);
         }
         list.push(closer);
       }
@@ -5816,8 +5818,55 @@ var init_rebuildScheduler = __esm({
   }
 });
 
-// src/cli/watcher.ts
+// src/cli/copyResources.ts
 import path23 from "path";
+import fs18 from "fs";
+function isResourceSourcePath(rootDir, absPath) {
+  return isInsideDir(absPath, path23.resolve(rootDir, RESOURCES_DIR));
+}
+function resolveResourcesDir(rootDir, dist) {
+  return path23.resolve(rootDir, dist, RESOURCES_OUTPUT_DIR);
+}
+async function copyResources(rootDir, dist) {
+  const sourceDir = path23.resolve(rootDir, RESOURCES_DIR);
+  if (!fs18.existsSync(sourceDir)) return false;
+  const outDir = resolveResourcesDir(rootDir, dist);
+  await fs18.promises.rm(outDir, { recursive: true, force: true });
+  await fs18.promises.cp(sourceDir, outDir, { recursive: true });
+  return true;
+}
+async function copyResourceFile(rootDir, dist, absSourceFile) {
+  const sourceDir = path23.resolve(rootDir, RESOURCES_DIR);
+  if (!isInsideDir(absSourceFile, sourceDir)) {
+    throw new Error(`[faapi] copyResourceFile: ${absSourceFile} is not under ${RESOURCES_DIR}`);
+  }
+  if (!fs18.existsSync(absSourceFile)) return;
+  const rel = path23.relative(sourceDir, absSourceFile);
+  const dest = path23.join(resolveResourcesDir(rootDir, dist), rel);
+  await fs18.promises.mkdir(path23.dirname(dest), { recursive: true });
+  await fs18.promises.cp(absSourceFile, dest);
+}
+async function removeResourceFile(rootDir, dist, absSourceFile) {
+  const sourceDir = path23.resolve(rootDir, RESOURCES_DIR);
+  if (!isInsideDir(absSourceFile, sourceDir)) {
+    throw new Error(`[faapi] removeResourceFile: ${absSourceFile} is not under ${RESOURCES_DIR}`);
+  }
+  const rel = path23.relative(sourceDir, absSourceFile);
+  const dest = path23.join(resolveResourcesDir(rootDir, dist), rel);
+  await fs18.promises.rm(dest, { force: true });
+}
+var RESOURCES_DIR, RESOURCES_OUTPUT_DIR;
+var init_copyResources = __esm({
+  "src/cli/copyResources.ts"() {
+    "use strict";
+    init_prodPaths();
+    RESOURCES_DIR = "src/resources";
+    RESOURCES_OUTPUT_DIR = "resources";
+  }
+});
+
+// src/cli/watcher.ts
+import path24 from "path";
 import { existsSync as existsSync2 } from "fs";
 function startWatcher(options) {
   const { rootDir, app, devDist } = options;
@@ -5852,9 +5901,9 @@ function startWatcher(options) {
     }
   });
   const CONFIG_FILES = ["faapi.config.ts", "faapi.config.js"];
-  const configAbsPaths = new Set(CONFIG_FILES.map((f) => path23.resolve(rootDir, f)));
+  const configAbsPaths = new Set(CONFIG_FILES.map((f) => path24.resolve(rootDir, f)));
   const watchPaths = ["src", "tsconfig.json", ...CONFIG_FILES];
-  const scheduleOnly = /* @__PURE__ */ new Set([...configAbsPaths, path23.resolve(rootDir, "tsconfig.json")]);
+  const scheduleOnly = /* @__PURE__ */ new Set([...configAbsPaths, path24.resolve(rootDir, "tsconfig.json")]);
   const watcher = esm_default.watch(watchPaths, {
     cwd: rootDir,
     ignoreInitial: true,
@@ -5865,13 +5914,23 @@ function startWatcher(options) {
       }
       if (!stats) return false;
       if (stats.isDirectory()) return false;
+      if (isResourceSourcePath(rootDir, path24.resolve(rootDir, filePath))) return false;
       return !filePath.endsWith(".ts") && !filePath.endsWith(".js");
     }
   });
   watcher.on("add", (file) => handleFileEvent(file));
   watcher.on("change", (file) => handleFileEvent(file));
   function handleFileEvent(file) {
-    const abs = path23.resolve(rootDir, file);
+    const abs = path24.resolve(rootDir, file);
+    if (isResourceSourcePath(rootDir, abs)) {
+      void copyResourceFile(rootDir, devDist, abs).catch((err) => {
+        console.error(
+          "- Error copying resource:",
+          err instanceof Error ? err.message : String(err)
+        );
+      });
+      return;
+    }
     if (scheduleOnly.has(abs)) {
       scheduler.schedule();
       return;
@@ -5882,7 +5941,17 @@ function startWatcher(options) {
     scheduler.addFiles([abs]);
   }
   watcher.on("unlink", (file) => {
-    scheduler.removeFiles([path23.resolve(rootDir, file)]);
+    const abs = path24.resolve(rootDir, file);
+    if (isResourceSourcePath(rootDir, abs)) {
+      void removeResourceFile(rootDir, devDist, abs).catch((err) => {
+        console.error(
+          "- Error removing resource:",
+          err instanceof Error ? err.message : String(err)
+        );
+      });
+      return;
+    }
+    scheduler.removeFiles([abs]);
     scheduler.schedule();
   });
   watcher.on("error", (err) => {
@@ -5903,6 +5972,7 @@ var init_watcher = __esm({
     init_compileDevRoutes();
     init_compileConfig();
     init_rebuildScheduler();
+    init_copyResources();
   }
 });
 
@@ -5986,25 +6056,25 @@ function getWsIndex(routes) {
   wsIndexCache.set(routes, index);
   return index;
 }
-function matchRoute(routes, method, path34) {
+function matchRoute(routes, method, path35) {
   const index = getHttpIndex(routes);
   const upper = method.toUpperCase();
-  const hit = matchByMethod(index, upper, path34);
+  const hit = matchByMethod(index, upper, path35);
   if (hit) return hit;
   if (upper === "HEAD") {
-    return matchByMethod(index, "GET", path34);
+    return matchByMethod(index, "GET", path35);
   }
   return null;
 }
-function matchByMethod(index, method, path34) {
-  const staticHit = index.static.get(`${method}|${path34}`);
+function matchByMethod(index, method, path35) {
+  const staticHit = index.static.get(`${method}|${path35}`);
   if (staticHit) {
     return { route: staticHit, params: {} };
   }
   if (index.dynamics.length === 0) {
     return null;
   }
-  const pathSegments = path34.split("/").filter(Boolean);
+  const pathSegments = path35.split("/").filter(Boolean);
   for (const entry of index.dynamics) {
     const route = entry.route;
     if (route.method !== method) {
@@ -6017,31 +6087,31 @@ function matchByMethod(index, method, path34) {
   }
   return null;
 }
-function matchWsRoute(wsRoutes, path34) {
+function matchWsRoute(wsRoutes, path35) {
   const index = getWsIndex(wsRoutes);
-  const staticHit = index.static.get(path34);
+  const staticHit = index.static.get(path35);
   if (staticHit) {
     return { route: staticHit, params: {} };
   }
   for (const route of index.dynamics) {
-    const params = matchDynamicPath(route.urlPath, path34, route.paramNames, route.isCatchAll);
+    const params = matchDynamicPath(route.urlPath, path35, route.paramNames, route.isCatchAll);
     if (params !== null) {
       return { route, params };
     }
   }
   return null;
 }
-function findAllowedMethods(routes, path34) {
+function findAllowedMethods(routes, path35) {
   const index = getHttpIndex(routes);
   const methods = /* @__PURE__ */ new Set();
-  const staticMethods = index.methodsByStaticPath.get(path34);
+  const staticMethods = index.methodsByStaticPath.get(path35);
   if (staticMethods) {
     for (const method of staticMethods) {
       methods.add(method);
     }
   }
   if (index.dynamics.length > 0) {
-    const pathSegments = path34.split("/").filter(Boolean);
+    const pathSegments = path35.split("/").filter(Boolean);
     for (const entry of index.dynamics) {
       const params = matchSegments(
         entry.segments,
@@ -6059,10 +6129,10 @@ function findAllowedMethods(routes, path34) {
   }
   return Array.from(methods);
 }
-function matchDynamicPath(pattern, path34, paramNames, isCatchAll) {
+function matchDynamicPath(pattern, path35, paramNames, isCatchAll) {
   return matchSegments(
     pattern.split("/").filter(Boolean),
-    path34.split("/").filter(Boolean),
+    path35.split("/").filter(Boolean),
     paramNames,
     isCatchAll
   );
@@ -6541,14 +6611,14 @@ var init_httpErrors = __esm({
       issues;
     };
     RouteNotFoundError = class extends FaapiError {
-      constructor(path34) {
-        super("ROUTE_NOT_FOUND", `Route not found: ${path34}`, 404);
+      constructor(path35) {
+        super("ROUTE_NOT_FOUND", `Route not found: ${path35}`, 404);
         this.name = "RouteNotFoundError";
       }
     };
     MethodNotAllowedError = class extends FaapiError {
-      constructor(method, path34, allowedMethods) {
-        super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path34}`, 405);
+      constructor(method, path35, allowedMethods) {
+        super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path35}`, 405);
         this.allowedMethods = allowedMethods;
         this.name = "MethodNotAllowedError";
       }
@@ -6684,17 +6754,17 @@ var init_formatEntry = __esm({
 });
 
 // src/logger/fileSink.ts
-import fs18 from "fs";
-import path24 from "path";
+import fs19 from "fs";
+import path25 from "path";
 function createFileLogSink(options) {
-  fs18.mkdirSync(options.dir, { recursive: true });
+  fs19.mkdirSync(options.dir, { recursive: true });
   const streams = /* @__PURE__ */ new Map();
   const getStream = (name) => {
     if (streams.has(name)) return streams.get(name);
     return void 0;
   };
   const openStream = (name) => {
-    const stream = fs18.createWriteStream(path24.join(options.dir, `${name}.log`), { flags: "a" });
+    const stream = fs19.createWriteStream(path25.join(options.dir, `${name}.log`), { flags: "a" });
     stream.on("error", () => {
     });
     streams.set(name, stream);
@@ -6962,10 +7032,18 @@ function formatSetCookie(name, value, options) {
   if (options?.sameSite) cookie += `; SameSite=${options.sameSite}`;
   return cookie;
 }
-function createContext(request, params, config = {}, ip = "", registries) {
-  return createContextFromUrl(request, new URL(request.url), params, config, ip, registries);
+function createContext(request, params, config = {}, ip = "", registries, resourcesDir) {
+  return createContextFromUrl(
+    request,
+    new URL(request.url),
+    params,
+    config,
+    ip,
+    registries,
+    resourcesDir
+  );
 }
-function createContextFromUrl(request, url, params, config = {}, ip = "", registries) {
+function createContextFromUrl(request, url, params, config = {}, ip = "", registries, resourcesDir) {
   const meta = { headers: {}, setCookies: [] };
   const parsedCookies = parseCookies(request.headers.get("cookie") ?? "");
   const cookiesObj = {};
@@ -6993,6 +7071,9 @@ function createContextFromUrl(request, url, params, config = {}, ip = "", regist
     ua: request.headers.get("user-agent") ?? "",
     cookies: cookiesObj,
     config,
+    // 运行时资源根目录（HTTP/WS 链路由 createServer/handleWsUpgrade 传入；
+    // testing 直调未传时为 undefined，见 contextTypes.resourcesDir 注释）
+    resourcesDir,
     meta,
     setStatus(status) {
       meta.status = status;
@@ -7891,9 +7972,9 @@ async function validateInput(schemaPath, method, inputType, input) {
 function mapZodIssues(error) {
   return error.issues.map((issue) => {
     const code = mapZodCode(issue);
-    const path34 = issue.path.map(String).join(".") || "";
+    const path35 = issue.path.map(String).join(".") || "";
     return {
-      path: path34,
+      path: path35,
       code,
       expected: issue.expected ?? mapExpectedFromMessage(issue.message),
       received: issue.received ?? mapReceivedFromMessage(issue.message),
@@ -8417,9 +8498,9 @@ var init_wsHandler = __esm({
 });
 
 // src/server/handleWsUpgrade.ts
-import fs19 from "fs";
+import fs20 from "fs";
 import { WebSocketServer, WebSocket } from "ws";
-import path25 from "path";
+import path26 from "path";
 function getPathname(req) {
   const url = req.url ?? "/";
   const idx = url.indexOf("?");
@@ -8430,7 +8511,7 @@ async function loadWsHandler(filePath, ctx, rootDir) {
     const dist = getDevDist();
     if (dist) {
       const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs19.existsSync(sourcePath)) {
+      if (sourcePath && fs20.existsSync(sourcePath)) {
         await ensureCompiled(sourcePath, rootDir, dist);
       }
     }
@@ -8528,6 +8609,7 @@ function attachWebSocket(options) {
     trustedProxy = false,
     registries
   } = options;
+  const resourcesDir = resolveResourcesDir(rootDir, dist);
   const wss = new WebSocketServer({ noServer: true });
   server.on("upgrade", async (req, socket, head) => {
     try {
@@ -8559,12 +8641,19 @@ function attachWebSocket(options) {
     const host = req.headers.host ?? "localhost";
     const fullUrl = new URL(`http://${host}${req.url ?? "/"}`);
     const request = new Request(fullUrl.toString(), { method: "GET", headers });
-    const ctx = createContext(request, params, config, getClientIp(req, trustedProxy), registries);
+    const ctx = createContext(
+      request,
+      params,
+      config,
+      getClientIp(req, trustedProxy),
+      registries,
+      resourcesDir
+    );
     const meta = ctx.meta;
     let upgraded = false;
     const finalHandler = async () => {
       const schemaPath = getRuntimeSchemaPath(route.filePath, dist, rootDir);
-      if (fs19.existsSync(schemaPath)) {
+      if (fs20.existsSync(schemaPath)) {
         if (isDevOnDemandEnabled()) {
           const devDist = getDevDist();
           if (devDist) {
@@ -8603,7 +8692,7 @@ function attachWebSocket(options) {
       }
       let handlers;
       try {
-        const absoluteFilePath = path25.resolve(rootDir, route.filePath);
+        const absoluteFilePath = path26.resolve(rootDir, route.filePath);
         handlers = await loadWsHandler(absoluteFilePath, ctx, rootDir);
       } catch (err) {
         const reason = err instanceof Error ? err.message : String(err);
@@ -8661,6 +8750,7 @@ var init_handleWsUpgrade = __esm({
     "use strict";
     init_matchRoute();
     init_createContext();
+    init_copyResources();
     init_invokeHandler();
     init_importWithCacheBust();
     init_getClientIp();
@@ -8683,7 +8773,7 @@ import {
 import { createSecureServer as createHttp2SecureServer } from "http2";
 import { readFileSync } from "fs";
 import { Readable as Readable3 } from "stream";
-import path26 from "path";
+import path27 from "path";
 function toWebRequest(req, bodyLimit = DEFAULT_BODY_LIMIT, requestSignal) {
   const forwardedProto = req.headers["x-forwarded-proto"];
   const protocol = Array.isArray(forwardedProto) ? forwardedProto[0]?.split(",")[0]?.trim() ?? "http" : forwardedProto?.split(",")[0]?.trim() ?? "http";
@@ -8787,6 +8877,7 @@ function createServer(options) {
     trustedProxy = false
   } = options;
   const routesRef = { current: routes, wsCurrent: wsRoutes ?? [] };
+  const resourcesDir = resolveResourcesDir(rootDir, dist);
   const configMiddlewares = [];
   if (compressionOption) {
     const compOpts = typeof compressionOption === "object" ? compressionOption : {};
@@ -8833,7 +8924,8 @@ function createServer(options) {
       bodyLimit,
       trustedProxy,
       registries,
-      routesRef.wsCurrent
+      routesRef.wsCurrent,
+      resourcesDir
     ).catch((err) => {
       console.error("[faapi] Request pipeline failed after error response attempt:", err);
       try {
@@ -8859,7 +8951,7 @@ function createServer(options) {
   });
   return { server, routesRef };
 }
-function prepareRequest(req, request, url, config, trustedProxy, registries, preMatched) {
+function prepareRequest(req, request, url, config, trustedProxy, registries, preMatched, resourcesDir) {
   const method = request.method.toUpperCase();
   const urlPath = url.pathname;
   const ctx = createContextFromUrl(
@@ -8868,7 +8960,8 @@ function prepareRequest(req, request, url, config, trustedProxy, registries, pre
     preMatched?.params ?? {},
     config,
     getClientIp(req, trustedProxy),
-    registries
+    registries,
+    resourcesDir
   );
   const meta = ctx.meta;
   return { request, url, ctx, meta, method, urlPath };
@@ -8886,7 +8979,7 @@ function getRoutePaths(route, rootDir, dist) {
   let cached = routePathCache.get(route);
   if (!cached) {
     cached = {
-      absFilePath: path26.resolve(rootDir, route.filePath),
+      absFilePath: path27.resolve(rootDir, route.filePath),
       schemaPath: getRuntimeSchemaPath(route.filePath, dist, rootDir)
     };
     routePathCache.set(route, cached);
@@ -9008,7 +9101,7 @@ async function sendErrorResponse(err, meta, res, onError, ctx) {
     }
   }
 }
-async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares, onError, config, globalInjectors, bodyLimit, trustedProxy, registries, wsRoutes) {
+async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares, onError, config, globalInjectors, bodyLimit, trustedProxy, registries, wsRoutes, resourcesDir) {
   let meta = { headers: {}, setCookies: [] };
   let ctx;
   let sseEarlySent = false;
@@ -9028,7 +9121,8 @@ async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares,
       config,
       trustedProxy,
       registries,
-      preMatched
+      preMatched,
+      resourcesDir
     );
     ctx = prepared.ctx;
     meta = prepared.meta;
@@ -9097,6 +9191,7 @@ var init_createServer = __esm({
     init_handleWsUpgrade();
     init_serverUtils();
     init_generateSchemaFiles();
+    init_copyResources();
     init_compileOnDemand();
     init_loadMiddlewares();
     DEFAULT_BODY_LIMIT = 10 * 1024 * 1024;
@@ -9443,7 +9538,7 @@ function createTaskLogger(level, scope, fields) {
 });
 
 // src/task/taskQueue.ts
-import path27 from "path";
+import path28 from "path";
 function createTaskQueue(deps) {
   const { registry, rootDir, driver } = deps;
   const registriesView = deps.registries ?? createEmptyTaskRegistriesView();
@@ -9473,7 +9568,7 @@ function createTaskQueue(deps) {
   }
   const loadTaskModule = deps.loadTaskModule ?? (async (filePath) => await import(filePath));
   const loadPayloadSchema = deps.loadPayloadSchema ?? (async (filePath) => {
-    const zodPath = path27.join(path27.dirname(filePath), "zod.js");
+    const zodPath = path28.join(path28.dirname(filePath), "zod.js");
     try {
       const mod = await import(zodPath);
       const schemaKey = Object.keys(mod).find((k) => k.endsWith("Schema"));
@@ -9501,7 +9596,7 @@ function createTaskQueue(deps) {
       const meta = registry.get(name);
       schemaCache.set(
         name,
-        await loadPayloadSchema(path27.resolve(rootDir, meta.filePath)).catch(() => void 0)
+        await loadPayloadSchema(path28.resolve(rootDir, meta.filePath)).catch(() => void 0)
       );
     }
     const schema = schemaCache.get(name);
@@ -9537,7 +9632,7 @@ function createTaskQueue(deps) {
       let result;
       if (meta.timeoutMs !== void 0 && meta.timeoutMs > 0) {
         result = await (deps.runIsolated ?? runTaskInWorker)({
-          taskModulePath: path27.resolve(rootDir, meta.filePath),
+          taskModulePath: path28.resolve(rootDir, meta.filePath),
           payload: job.payload,
           taskCtx: {
             config: deps.config,
@@ -9562,7 +9657,7 @@ function createTaskQueue(deps) {
       } else {
         let mod = moduleCache2.get(job.name);
         if (!mod) {
-          mod = await loadTaskModule(path27.resolve(rootDir, meta.filePath));
+          mod = await loadTaskModule(path28.resolve(rootDir, meta.filePath));
           moduleCache2.set(job.name, mod);
         }
         if (typeof mod.run !== "function") {
@@ -9851,8 +9946,8 @@ var init_cronScheduler = __esm({
 });
 
 // src/cli/loadPlugins.ts
-import path28 from "path";
-import fs20 from "fs";
+import path29 from "path";
+import fs21 from "fs";
 import { pathToFileURL as pathToFileURL3 } from "url";
 async function loadPlugins(declarations, ctx, rootDir, dist) {
   const handlerWrappers = [];
@@ -9915,30 +10010,30 @@ async function loadPlugins(declarations, ctx, rootDir, dist) {
   return { handlerWrappers, upgradeWrappers, failures };
 }
 function resolveLocalPluginSource(specifier, baseDir) {
-  const base = path28.isAbsolute(specifier) ? specifier : path28.resolve(baseDir, specifier);
-  if ((TS_EXTS.test(base) || JS_EXTS.test(base)) && fs20.existsSync(base)) return base;
+  const base = path29.isAbsolute(specifier) ? specifier : path29.resolve(baseDir, specifier);
+  if ((TS_EXTS.test(base) || JS_EXTS.test(base)) && fs21.existsSync(base)) return base;
   for (const ext of [".ts", ".js"]) {
-    if (fs20.existsSync(base + ext)) return base + ext;
+    if (fs21.existsSync(base + ext)) return base + ext;
   }
   for (const indexExt of ["/index.ts", "/index.js"]) {
-    if (fs20.existsSync(base + indexExt)) return base + indexExt;
+    if (fs21.existsSync(base + indexExt)) return base + indexExt;
   }
   return null;
 }
 function mirrorProductPath(sourcePath, baseDir, distDir) {
-  let rel = path28.relative(baseDir, sourcePath).replace(/\\/g, "/");
+  let rel = path29.relative(baseDir, sourcePath).replace(/\\/g, "/");
   if (rel.startsWith("src/")) rel = rel.slice(4);
-  return path28.resolve(distDir, rel.replace(TS_EXTS, ".js"));
+  return path29.resolve(distDir, rel.replace(TS_EXTS, ".js"));
 }
 async function importPluginModule(specifier, baseDir, dist) {
   const isRelative = specifier.startsWith("./") || specifier.startsWith("../");
-  if (!isRelative && !path28.isAbsolute(specifier)) {
+  if (!isRelative && !path29.isAbsolute(specifier)) {
     return import(specifier);
   }
-  const distDir = dist ? path28.resolve(baseDir, dist) : null;
+  const distDir = dist ? path29.resolve(baseDir, dist) : null;
   const sourcePath = resolveLocalPluginSource(specifier, baseDir);
   const productPath = sourcePath && distDir ? mirrorProductPath(sourcePath, baseDir, distDir) : null;
-  if (productPath !== null && fs20.existsSync(productPath) && (sourcePath === null || isProductFresh(sourcePath, productPath))) {
+  if (productPath !== null && fs21.existsSync(productPath) && (sourcePath === null || isProductFresh(sourcePath, productPath))) {
     return import(pathToFileURL3(productPath).href);
   }
   if (sourcePath && TS_EXTS.test(sourcePath)) {
@@ -9947,13 +10042,13 @@ async function importPluginModule(specifier, baseDir, dist) {
         `Local plugin "${specifier}" has no up-to-date build artifact (dist is stale or missing). Run "faapi build" first, or use "faapi dev" for on-demand compilation.`
       );
     }
-    const relFromRoot = path28.relative(baseDir, sourcePath).replace(/\\/g, "/");
+    const relFromRoot = path29.relative(baseDir, sourcePath).replace(/\\/g, "/");
     if (relFromRoot.startsWith("src/")) {
       await ensureCompiled(sourcePath, baseDir, dist);
     } else {
       await compileProjectModules([sourcePath], baseDir, dist);
     }
-    if (productPath && fs20.existsSync(productPath)) {
+    if (productPath && fs21.existsSync(productPath)) {
       return import(pathToFileURL3(productPath).href);
     }
   }
@@ -9965,7 +10060,7 @@ async function importPluginModule(specifier, baseDir, dist) {
     `${specifier}/index.ts`,
     `${specifier}.js`,
     `${specifier}/index.js`
-  ].map((c) => path28.isAbsolute(c) ? c : path28.join(baseDir, c));
+  ].map((c) => path29.isAbsolute(c) ? c : path29.join(baseDir, c));
   throw new Error(
     `Cannot find local plugin "${specifier}" (resolved from ${baseDir}). Expected one of:
   ${candidates.join("\n  ")}
@@ -10000,11 +10095,11 @@ var init_loadPlugins = __esm({
 });
 
 // src/cli/manifestLoader.ts
-import fs21 from "fs";
-import path29 from "path";
+import fs22 from "fs";
+import path30 from "path";
 async function loadAndHydrateTools(rootDir, dist, registries = defaultRegistries) {
-  const toolsPath = path29.resolve(rootDir, dist, TOOLS_FILE2);
-  if (!fs21.existsSync(toolsPath)) {
+  const toolsPath = path30.resolve(rootDir, dist, TOOLS_FILE2);
+  if (!fs22.existsSync(toolsPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(toolsPath);
@@ -10013,8 +10108,8 @@ async function loadAndHydrateTools(rootDir, dist, registries = defaultRegistries
   return hydrated;
 }
 async function loadAndHydrateAgents(rootDir, dist, registries = defaultRegistries) {
-  const agentsPath = path29.resolve(rootDir, dist, AGENTS_FILE2);
-  if (!fs21.existsSync(agentsPath)) {
+  const agentsPath = path30.resolve(rootDir, dist, AGENTS_FILE2);
+  if (!fs22.existsSync(agentsPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(agentsPath);
@@ -10029,8 +10124,8 @@ function getTaskDriverOptions(config) {
   return void 0;
 }
 async function loadAndHydrateTasks(rootDir, dist, registries = defaultRegistries) {
-  const tasksPath = path29.resolve(rootDir, dist, TASKS_FILE);
-  if (!fs21.existsSync(tasksPath)) {
+  const tasksPath = path30.resolve(rootDir, dist, TASKS_FILE);
+  if (!fs22.existsSync(tasksPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(tasksPath);
@@ -10177,8 +10272,8 @@ var init_injectMock = __esm({
 });
 
 // src/cli/createAppCore.ts
-import fs22 from "fs";
-import path30 from "path";
+import fs23 from "fs";
+import path31 from "path";
 function isFaapiConfigKey(key) {
   return FAAPI_CONFIG_KEYS.has(key);
 }
@@ -10219,8 +10314,9 @@ function logStartupSummary(routes, wsRoutes, tools, agents, taskMetas, p) {
 async function createAppBase(options) {
   const rootDir = options?.rootDir ?? process.cwd();
   const dist = options?.dist ?? process.env.FAAPI_DIST ?? DEFAULT_DIST;
-  const routesPath = path30.resolve(rootDir, dist, ROUTES_FILE);
-  if (!fs22.existsSync(routesPath)) {
+  const resourcesDir = resolveResourcesDir(rootDir, dist);
+  const routesPath = path31.resolve(rootDir, dist, ROUTES_FILE);
+  if (!fs23.existsSync(routesPath)) {
     throw new Error(
       `[faapi] ${dist}/${ROUTES_FILE} \u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6267\u884C \`faapi build\`\uFF08\u6216 \`faapi dev\`\uFF09\u751F\u6210\u4EA7\u7269\u3002`
     );
@@ -10299,6 +10395,8 @@ async function createAppBase(options) {
     routes: sorted,
     wsRoutes,
     rootDir,
+    dist,
+    resourcesDir,
     tasks: taskQueue,
     async listen(listenPort) {
       const envPort = process.env.PORT ? Number(process.env.PORT) : void 0;
@@ -10310,7 +10408,8 @@ async function createAppBase(options) {
             routes: sorted,
             server,
             registries,
-            tasks: taskQueue
+            tasks: taskQueue,
+            resourcesDir
           });
           console.log("- onBoot hook executed");
         } catch (err) {
@@ -10345,7 +10444,8 @@ async function createAppBase(options) {
               routes: sorted,
               server,
               registries,
-              tasks: taskQueue
+              tasks: taskQueue,
+              resourcesDir
             });
             console.log("- onReady hook executed");
           }
@@ -10369,7 +10469,8 @@ async function createAppBase(options) {
           routes: sorted,
           server,
           registries,
-          tasks: taskQueue
+          tasks: taskQueue,
+          resourcesDir
         });
       }
       registries.tool.clear();
@@ -10451,6 +10552,7 @@ var init_createAppCore = __esm({
     init_manifestLoader();
     init_appSingleton();
     init_injectMock();
+    init_copyResources();
     init_manifestLoader();
     DEFAULT_DIST = "dist";
     DEFAULT_PORT = 3e3;
@@ -10476,7 +10578,7 @@ var init_createAppCore = __esm({
 });
 
 // src/cli/createDevApp.ts
-import path31 from "path";
+import path32 from "path";
 async function createDevApp(options) {
   const { app, ctx } = await createAppBase(options);
   const devApp = app;
@@ -10526,7 +10628,7 @@ async function createDevApp(options) {
     if (!suppressProgramInvalidation) invalidateProgramCache();
     const tasks = await scanTasks(ctx.rootDir, TASK_PATTERNS);
     for (const task of tasks) {
-      await ensureCompiled(path31.resolve(ctx.rootDir, task.filePath), ctx.rootDir, ctx.dist);
+      await ensureCompiled(path32.resolve(ctx.rootDir, task.filePath), ctx.rootDir, ctx.dist);
     }
     await generateTaskArtifacts(tasks, ctx.rootDir, ctx.dist);
     ctx.taskQueue.invalidateModules();
@@ -10583,7 +10685,7 @@ __export(devCommand_exports, {
   generateTaskArtifactsForDev: () => generateTaskArtifactsForDev,
   generateToolArtifactsForDev: () => generateToolArtifactsForDev
 });
-import path32 from "path";
+import path33 from "path";
 async function devCommand(options) {
   const rootDir = process.cwd();
   if (!process.env.NODE_ENV) process.env.NODE_ENV = "development";
@@ -10604,6 +10706,10 @@ async function devCommand(options) {
   await generateAgentArtifactsForDev(rootDir, devDist);
   console.log("- Generating task artifacts...");
   await generateTaskArtifactsForDev(rootDir, devDist);
+  console.log("- Copying resources...");
+  const copied = await copyResources(rootDir, devDist);
+  if (copied)
+    console.log(`  Copied src/resources \u2192 ${path33.resolve(rootDir, devDist, "resources")}`);
   console.log("- Starting dev app...");
   const app = await createDevApp({ rootDir, port: options?.port });
   await app.listen();
@@ -10612,7 +10718,7 @@ async function devCommand(options) {
 async function generateRouteArtifacts(rootDir, patterns, dist) {
   const { routes, wsRoutes } = await scanRoutes(rootDir, patterns, dist);
   const sorted = sortRoutes(routes);
-  const routesPath = path32.resolve(rootDir, dist, ROUTES_FILE2);
+  const routesPath = path33.resolve(rootDir, dist, ROUTES_FILE2);
   const serialized = serializeRoutes(sorted, wsRoutes, rootDir, dist);
   await writeRoutesModule(serialized, routesPath);
 }
@@ -10627,7 +10733,7 @@ async function generateAgentArtifactsForDev(rootDir, dist) {
 async function generateTaskArtifactsForDev(rootDir, dist) {
   const tasks = await scanTasks(rootDir, TASK_PATTERNS);
   for (const task of tasks) {
-    await ensureCompiled(path32.resolve(rootDir, task.filePath), rootDir, dist);
+    await ensureCompiled(path33.resolve(rootDir, task.filePath), rootDir, dist);
   }
   await generateTaskArtifacts(tasks, rootDir, dist);
 }
@@ -10653,6 +10759,7 @@ var init_devCommand = __esm({
     init_watcher();
     init_createDevApp();
     init_compileOnDemand();
+    init_copyResources();
     init_prodPaths();
     DEV_DIST = ".faapi";
     ROUTES_FILE2 = "faapi-routes.js";
@@ -10675,15 +10782,15 @@ var buildCommand_exports = {};
 __export(buildCommand_exports, {
   buildCommand: () => buildCommand
 });
-import path33 from "path";
-import fs23 from "fs";
+import path34 from "path";
+import fs24 from "fs";
 async function buildCommand(options) {
   const rootDir = options?.rootDir ?? process.cwd();
   const outdir = options?.dist ?? DEFAULT_DIST2;
-  const absOut = path33.resolve(rootDir, outdir);
-  const realRoot = toRealPath(path33.resolve(rootDir));
+  const absOut = path34.resolve(rootDir, outdir);
+  const realRoot = toRealPath(path34.resolve(rootDir));
   if (isInsideDir(toRealPath(absOut), realRoot)) {
-    fs23.rmSync(absOut, { recursive: true, force: true });
+    fs24.rmSync(absOut, { recursive: true, force: true });
   } else {
     console.warn(
       `! Output directory "${outdir}" is outside the project root, skipping clean (stale artifacts may remain)`
@@ -10691,10 +10798,10 @@ async function buildCommand(options) {
   }
   await compileConfig({ rootDir, dist: outdir });
   const _config = await loadConfig(rootDir, outdir);
-  const pkgPath = path33.resolve(rootDir, "package.json");
-  if (fs23.existsSync(pkgPath)) {
+  const pkgPath = path34.resolve(rootDir, "package.json");
+  if (fs24.existsSync(pkgPath)) {
     try {
-      const pkg = JSON.parse(fs23.readFileSync(pkgPath, "utf-8"));
+      const pkg = JSON.parse(fs24.readFileSync(pkgPath, "utf-8"));
       if (pkg.type !== "module") {
         console.warn(
           '! package.json is missing "type": "module" \u2014 build output is ESM and `node dist/main` will fail without it'
@@ -10707,7 +10814,7 @@ async function buildCommand(options) {
   console.log(`- Root: ${rootDir}`);
   console.log(`- Source: src/`);
   console.log(`- Output: ${outdir}`);
-  console.log("\n[1/8] Compiling TypeScript (bundle: false)...");
+  console.log("\n[1/9] Compiling TypeScript (bundle: false)...");
   const result = await compileBuildRoutes({
     rootDir,
     dist: outdir,
@@ -10720,9 +10827,9 @@ async function buildCommand(options) {
   }
   const localPluginSources = extractLocalPluginSources(_config?.plugins, rootDir);
   if (localPluginSources.length > 0) {
-    console.log("\n[2.5/8] Compiling local plugins...");
+    console.log("\n[2.5/9] Compiling local plugins...");
     const outside = localPluginSources.filter((p) => {
-      const rel = path33.relative(rootDir, p).replace(/\\/g, "/");
+      const rel = path34.relative(rootDir, p).replace(/\\/g, "/");
       return !rel.startsWith("src/");
     });
     if (outside.length > 0) {
@@ -10730,36 +10837,41 @@ async function buildCommand(options) {
     }
     console.log(`  Compiled ${localPluginSources.length} local plugin(s)`);
   }
-  console.log("\n[3/8] Scanning routes...");
+  console.log("\n[3/9] Scanning routes...");
   const { routes, wsRoutes } = await scanRoutes(rootDir, ROUTE_PATTERNS, outdir);
   const sorted = sortRoutes(routes);
   console.log(`  Found ${sorted.length} routes, ${wsRoutes.length} WS routes`);
   reportRouteConflicts(sorted);
-  console.log("\n[4/8] Generating schema...");
+  console.log("\n[4/9] Generating schema...");
   await generateSchemaFiles(sorted, rootDir, outdir, wsRoutes);
-  console.log(`  Schema: zod.js files under ${path33.resolve(rootDir, outdir)}`);
-  console.log("\n[5/8] Generating routes manifest...");
-  const routesPath = path33.resolve(rootDir, outdir, "faapi-routes.js");
+  console.log(`  Schema: zod.js files under ${path34.resolve(rootDir, outdir)}`);
+  console.log("\n[5/9] Generating routes manifest...");
+  const routesPath = path34.resolve(rootDir, outdir, "faapi-routes.js");
   const serialized = serializeRoutes(sorted, wsRoutes, rootDir, outdir);
   await writeRoutesModule(serialized, routesPath);
   console.log(`  Written to ${routesPath}`);
-  console.log("\n[6/8] Generating tool manifest and schema...");
+  console.log("\n[6/9] Generating tool manifest and schema...");
   const tools = await scanTools(rootDir, TOOL_PATTERNS);
   const toolMeta = await generateToolArtifacts(tools, rootDir, outdir);
   console.log(`  Found ${toolMeta.length} tool(s)`);
-  console.log(`  Tool manifest: ${path33.resolve(rootDir, outdir, "faapi-tools.js")}`);
-  console.log("\n[7/8] Generating agent manifest...");
+  console.log(`  Tool manifest: ${path34.resolve(rootDir, outdir, "faapi-tools.js")}`);
+  console.log("\n[7/9] Generating agent manifest...");
   const agents = await scanAgents(rootDir, DEFAULT_AGENT_PATTERNS);
   const agentMeta = await generateAgentArtifacts(agents, rootDir, outdir);
   console.log(`  Found ${agentMeta.length} agent(s)`);
-  console.log(`  Agent manifest: ${path33.resolve(rootDir, outdir, "faapi-agents.js")}`);
-  console.log("\n[7.5/8] Generating task manifest and schema...");
+  console.log(`  Agent manifest: ${path34.resolve(rootDir, outdir, "faapi-agents.js")}`);
+  console.log("\n[7.5/9] Generating task manifest and schema...");
   const tasks = await scanTasks(rootDir, TASK_PATTERNS);
   const taskMeta = await generateTaskArtifacts(tasks, rootDir, outdir);
   console.log(`  Found ${taskMeta.length} task(s)`);
-  console.log(`  Task manifest: ${path33.resolve(rootDir, outdir, "faapi-tasks.js")}`);
-  console.log("\n[8/8] Generating entry file...");
-  const mainPath = path33.resolve(rootDir, outdir, "main.js");
+  console.log(`  Task manifest: ${path34.resolve(rootDir, outdir, "faapi-tasks.js")}`);
+  console.log("\n[8/9] Copying resources...");
+  const resourcesCopied = await copyResources(rootDir, outdir);
+  if (resourcesCopied) {
+    console.log(`  Copied src/resources \u2192 ${path34.resolve(rootDir, outdir, "resources")}`);
+  }
+  console.log("\n[9/9] Generating entry file...");
+  const mainPath = path34.resolve(rootDir, outdir, "main.js");
   const createProdAppArgs = options?.dist && options.dist !== DEFAULT_DIST2 ? `{ dist: ${JSON.stringify(outdir)} }` : "";
   const mainContent = `// \u7531 faapi build \u81EA\u52A8\u751F\u6210\uFF0C\u8BF7\u52FF\u624B\u52A8\u7F16\u8F91
 import { createProdApp, loadEnv } from '@faapi/faapi';
@@ -10771,7 +10883,7 @@ loadEnv(process.cwd());
 const app = await createProdApp(${createProdAppArgs});
 await app.listen();
 `;
-  await fs23.promises.writeFile(mainPath, mainContent, "utf-8");
+  await fs24.promises.writeFile(mainPath, mainContent, "utf-8");
   console.log(`  Written to ${mainPath}`);
   console.log("\nfaapi build completed");
 }
@@ -10785,7 +10897,7 @@ function extractLocalPluginSources(declarations, rootDir) {
     else if (Array.isArray(decl)) specifier = decl[0];
     else if ("path" in decl) specifier = decl.path;
     if (!specifier) continue;
-    if (!specifier.startsWith("./") && !specifier.startsWith("../") && !path33.isAbsolute(specifier)) {
+    if (!specifier.startsWith("./") && !specifier.startsWith("../") && !path34.isAbsolute(specifier)) {
       continue;
     }
     const source = resolveLocalPluginSource(specifier, rootDir);
@@ -10814,6 +10926,7 @@ var init_buildCommand = __esm({
     init_generateSchemaFiles();
     init_generateRoutes();
     init_compileBuildRoutes();
+    init_copyResources();
     init_prodPaths();
     init_compileConfig();
     init_loadConfig();