veryfront 0.1.48 → 0.1.49

package/src/src/build/compiler/mdx-to-js.ts

@@ -2,10 +2,7 @@ import { compile as compileMdx } from "@mdx-js/mdx";
 import { bundlerLogger as logger } from "../../utils/index.js";
 import * as esbuild from "esbuild";
 import { extract } from "../../platform/compat/std/front-matter-yaml.js";
-import { dirname, join } from "../../platform/compat/path/index.js";
 import type { RuntimeAdapter } from "../../platform/adapters/base.js";
-import { createFileSystem } from "../../platform/compat/fs.js";
-import { createSecureFs } from "../../security/index.js";
 import { createError, toError } from "../../errors/veryfront-error.js";
 
 export interface MDXFrontmatter {
@@ -22,8 +19,6 @@ export interface CompileToJSOptions {
   adapter: RuntimeAdapter;
 }
 
-const fs = createFileSystem();
-
 function getComponentName(imp: { name: string; path: string }): string {
   return imp.path.split("/").pop()?.replace(/\.(jsx?|tsx?)$/, "") ?? imp.name;
 }
@@ -143,99 +138,3 @@ export default function MDXPage({ components = {} }) {
 
   return { code: result.code, frontmatter };
 }
-
-export async function compileMDXFile(
-  mdxPath: string,
-  outputDir: string,
-  options: CompileToJSOptions,
-): Promise<void> {
-  const secureFs = createSecureFs({
-    baseDir: options.projectDir,
-    adapter: options.adapter,
-    context: "build",
-    throwOnError: true,
-  });
-
-  try {
-    const content = await secureFs.readFile(mdxPath);
-    const { code } = await compileMDXToJS(mdxPath, content, options);
-
-    const relativePath = mdxPath.replace(options.projectDir, "").replace(/^\//, "");
-    const outputPath = join(outputDir, relativePath.replace(".mdx", ".mdx.js"));
-
-    await secureFs.mkdir(dirname(outputPath), { recursive: true });
-    await secureFs.writeFile(outputPath, code);
-
-    logger.info(`Compiled MDX: ${mdxPath} -> ${outputPath}`);
-  } catch (error) {
-    logger.error(`Failed to compile MDX file ${mdxPath}:`, error);
-    throw error;
-  }
-}
-
-export async function compileProjectMDX(
-  projectDir: string,
-  outputDir: string,
-  options: Omit<CompileToJSOptions, "projectDir">,
-): Promise<void> {
-  const compileOptions: CompileToJSOptions = { ...options, projectDir };
-
-  const componentsDir = join(projectDir, "components");
-  const components: string[] = [];
-
-  try {
-    for await (const entry of fs.readDir(componentsDir)) {
-      if (!entry.isFile || !/\.(jsx?|tsx?)$/.test(entry.name)) continue;
-      components.push(entry.name.replace(/\.(jsx?|tsx?)$/, ""));
-    }
-  } catch {
-    // Components directory might not exist
-  }
-
-  compileOptions.components = components;
-
-  const mdxFiles: string[] = [];
-  const VERYFRONT_EXCLUDED_DIRS = new Set([
-    "cache",
-    "compiled",
-    "tmp",
-    "temp",
-    "output",
-    "optimized-images",
-    "css",
-  ]);
-
-  async function findMDXFiles(dir: string): Promise<void> {
-    try {
-      for await (const entry of fs.readDir(dir)) {
-        const path = join(dir, entry.name);
-
-        if (entry.isFile && (entry.name.endsWith(".mdx") || entry.name.endsWith(".md"))) {
-          mdxFiles.push(path);
-          continue;
-        }
-
-        if (!entry.isDirectory || entry.name === "node_modules") continue;
-        if (entry.name.startsWith(".") && entry.name !== ".veryfront") continue;
-        if (dir.includes(".veryfront") && VERYFRONT_EXCLUDED_DIRS.has(entry.name)) continue;
-
-        await findMDXFiles(path);
-      }
-    } catch {
-      // Directory might not exist
-    }
-  }
-
-  await findMDXFiles(join(projectDir, "pages"));
-  await findMDXFiles(join(projectDir, "layouts"));
-  await findMDXFiles(join(projectDir, "providers"));
-  await findMDXFiles(join(projectDir, ".veryfront"));
-
-  logger.info(`Found ${mdxFiles.length} MDX files to compile`);
-
-  for (const mdxFile of mdxFiles) {
-    await compileMDXFile(mdxFile, outputDir, compileOptions);
-  }
-
-  logger.info(`Compiled ${mdxFiles.length} MDX files to ${outputDir}`);
-}

package/src/src/build/index.ts

@@ -9,11 +9,3 @@ export { compileMDXToJS } from "./compiler/mdx-to-js.js";
 export { compileAllMDX, watchMDX } from "./compiler/mdx-compiler/index.js";
 export { buildProduction } from "./production-build/build/build-orchestrator.js";
 export { buildEmbeddedPreset } from "./embedded/preset.js";
-
-export interface EmbeddedPresetOptions {
-  projectDir: string;
-  outDir: string;
-  runtime: "deno" | "node" | "bun";
-}
-
-export const EMBEDDED_PRESET_ID = "veryfront-embedded";

package/src/src/build/production-build/build/route-collector.ts

@@ -38,11 +38,9 @@ export async function collectAllRoutes(
 
   logger.info(`Collected routes: ${pages.length} pages, ${app.length} app`);
 
-  if (app.length === 0) {
-    return { pages, app };
+  if (app.length > 0) {
+    logger.info(`App routes: ${app.map((r) => r.path).join(", ")}`);
   }
 
-  logger.info(`App routes: ${app.map((r) => r.path).join(", ")}`);
-
   return { pages, app };
 }

package/src/src/build/production-build/templates.ts

@@ -1,26 +1,17 @@
 /**
  * Embedded templates for production builds
  * These are embedded as strings to avoid file system dependencies in npm bundle
+ *
+ * AUTO-GENERATED by scripts/build/prebundle-client-scripts.ts
+ * Do not edit manually — run `deno task build` to regenerate.
  * @module
  */
 
-/**
- * Client-side CSS styles for error display in production builds
- */
-export const CLIENT_STYLES = `.error-container {
-  max-width: 600px;
-  margin: 2rem auto;
-  padding: 2rem;
-  background: #fee;
-  border: 1px solid #fcc;
-  border-radius: 8px;
-  color: #c00;
-}`;
+export const CLIENT_STYLES =
+  ".error-container {\n  max-width: 600px;\n  margin: 2rem auto;\n  padding: 2rem;\n  background: #fee;\n  border: 1px solid #fcc;\n  border-radius: 8px;\n  color: #c00;\n}";
 
-/**
- * Pre-bundled client router script for npm builds
- * Placeholder - this is auto-generated during build:npm
- */
-export let CLIENT_ROUTER_BUNDLE: string | undefined;
+export const CLIENT_ROUTER_BUNDLE: string | undefined =
+  'var __defProp = Object.defineProperty;\nvar __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;\nvar __publicField = (obj, key, value) => {\n  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);\n  return value;\n};\n\n// src/rendering/client/router.ts\nimport { rendererLogger } from "#veryfront/utils";\nimport ReactDOM from "react-dom/client";\nimport {\n  extractPageDataFromScript,\n  NavigationHandlers,\n  PageLoader,\n  PageTransition,\n  ViewportPrefetch\n} from "#veryfront/routing";\nvar logger = rendererLogger.component("veryfront");\nvar VeryfrontRouter = class {\n  constructor(options = {}) {\n    __publicField(this, "baseUrl");\n    __publicField(this, "currentPath");\n    __publicField(this, "root", null);\n    __publicField(this, "options");\n    __publicField(this, "spaMode");\n    __publicField(this, "spaNavigationHandler", null);\n    __publicField(this, "pageLoader");\n    __publicField(this, "navigationHandlers");\n    __publicField(this, "pageTransition");\n    __publicField(this, "viewportPrefetch");\n    __publicField(this, "handleClick");\n    __publicField(this, "handlePopState");\n    __publicField(this, "handleMouseOver");\n    const globalOptions = this.loadGlobalOptions();\n    this.options = { ...globalOptions, ...options };\n    this.baseUrl = this.options.baseUrl || globalThis.location.origin;\n    this.currentPath = globalThis.location.pathname;\n    this.spaMode = this.options.spaMode ?? globalThis.__VERYFRONT_SPA_MODE__ ?? false;\n    this.pageLoader = new PageLoader();\n    this.navigationHandlers = new NavigationHandlers(\n      this.options.prefetchDelay,\n      this.options.prefetch\n    );\n    this.pageTransition = new PageTransition((root) => this.viewportPrefetch.setup(root));\n    this.viewportPrefetch = new ViewportPrefetch(\n      (path) => this.prefetch(path),\n      this.options.prefetch\n    );\n    this.handleClick = this.navigationHandlers.createClickHandler({\n      onNavigate: (url) => this.navigate(url),\n      onPrefetch: (url) => this.prefetch(url)\n    });\n    this.handlePopState = this.navigationHandlers.createPopStateHandler({\n      onNavigate: (url) => this.navigate(url, false),\n      onPrefetch: (url) => this.prefetch(url)\n    });\n    this.handleMouseOver = this.navigationHandlers.createMouseOverHandler({\n      onNavigate: (url) => this.navigate(url),\n      onPrefetch: (url) => this.prefetch(url)\n    });\n  }\n  registerNavigationHandler(handler) {\n    logger.debug("Registering SPA navigation handler");\n    this.spaNavigationHandler = handler;\n    this.spaMode = true;\n  }\n  loadGlobalOptions() {\n    try {\n      const options = globalThis.__VERYFRONT_ROUTER_OPTS__;\n      if (!options) {\n        logger.debug("No global options configured");\n        return {};\n      }\n      return options;\n    } catch (error) {\n      logger.error("Failed to read global options:", error);\n      return {};\n    }\n  }\n  init() {\n    logger.debug("Initializing client-side router");\n    const rootElement = document.getElementById("root");\n    if (!rootElement) {\n      logger.error("Root element not found");\n      return;\n    }\n    const ReactDOMToUse = globalThis.ReactDOM ?? ReactDOM;\n    this.root = ReactDOMToUse.createRoot(rootElement);\n    document.addEventListener("click", this.handleClick);\n    globalThis.addEventListener("popstate", this.handlePopState);\n    document.addEventListener("mouseover", this.handleMouseOver);\n    this.viewportPrefetch.setup(document);\n    this.cacheCurrentPage();\n  }\n  cacheCurrentPage() {\n    const pageData = extractPageDataFromScript();\n    if (pageData)\n      this.pageLoader.setCache(this.currentPath, pageData);\n  }\n  async navigate(url, pushState = true) {\n    logger.debug(`Navigating to ${url} (SPA mode: ${this.spaMode})`);\n    this.navigationHandlers.saveScrollPosition(this.currentPath);\n    this.options.onStart?.(url);\n    if (pushState)\n      globalThis.history.pushState({}, "", url);\n    if (this.spaMode && this.spaNavigationHandler) {\n      await this.loadSpaPage(url);\n    } else {\n      await this.loadPage(url);\n    }\n    this.options.onNavigate?.(url);\n  }\n  async loadSpaPage(path) {\n    logger.debug(`Loading SPA page: ${path}`);\n    try {\n      const spaData = await this.pageLoader.loadSpaPageData(path);\n      await this.spaNavigationHandler?.(spaData);\n      this.currentPath = path;\n      this.handleScrollAfterNavigation();\n      this.options.onComplete?.(path);\n    } catch (error) {\n      const normalizedError = error instanceof Error ? error : new Error(String(error));\n      logger.error(`Failed to load SPA page ${path}`, normalizedError);\n      this.options.onError?.(normalizedError);\n      this.pageTransition.showError(normalizedError);\n    }\n  }\n  handleScrollAfterNavigation() {\n    const isPopState = this.navigationHandlers.isPopState();\n    const scrollY = this.navigationHandlers.getScrollPosition(this.currentPath);\n    try {\n      globalThis.scrollTo(0, isPopState ? scrollY : 0);\n    } catch (error) {\n      logger.warn("scroll handling failed", error);\n    }\n    this.navigationHandlers.clearPopStateFlag();\n  }\n  async loadPage(path, updateUI = true) {\n    if (this.pageLoader.isCached(path)) {\n      logger.debug(`Loading ${path} from cache`);\n      const data = this.pageLoader.getCached(path);\n      if (data) {\n        if (updateUI)\n          this.updatePage(data);\n        return;\n      }\n      logger.warn(`Cache entry for ${path} was unexpectedly null, fetching fresh data`);\n    }\n    this.pageTransition.setLoadingState(true);\n    try {\n      const data = await this.pageLoader.loadPage(path);\n      if (updateUI)\n        this.updatePage(data);\n      this.currentPath = path;\n      this.options.onComplete?.(path);\n    } catch (error) {\n      const normalizedError = error instanceof Error ? error : new Error(String(error));\n      logger.error(`Failed to load ${path}`, normalizedError);\n      this.options.onError?.(normalizedError);\n      this.pageTransition.showError(normalizedError);\n    } finally {\n      this.pageTransition.setLoadingState(false);\n    }\n  }\n  async prefetch(path) {\n    if (this.spaMode) {\n      await this.pageLoader.prefetchSpaPageData(path);\n      return;\n    }\n    await this.pageLoader.prefetch(path);\n  }\n  updatePage(data) {\n    if (!this.root)\n      return;\n    const isPopState = this.navigationHandlers.isPopState();\n    const scrollY = this.navigationHandlers.getScrollPosition(this.currentPath);\n    this.pageTransition.updatePage(data, isPopState, scrollY);\n    this.navigationHandlers.clearPopStateFlag();\n  }\n  destroy() {\n    document.removeEventListener("click", this.handleClick);\n    globalThis.removeEventListener("popstate", this.handlePopState);\n    document.removeEventListener("mouseover", this.handleMouseOver);\n    this.viewportPrefetch.disconnect();\n    this.pageLoader.clearCache();\n    this.navigationHandlers.clear();\n    this.pageTransition.destroy();\n  }\n};\nif (typeof window !== "undefined" && globalThis.document) {\n  const router = new VeryfrontRouter();\n  if (document.readyState === "loading") {\n    document.addEventListener("DOMContentLoaded", () => router.init());\n  } else {\n    router.init();\n  }\n  globalThis.veryFrontRouter = router;\n}\nexport {\n  VeryfrontRouter\n};\n';
 
-export let CLIENT_PREFETCH_BUNDLE: string | undefined;
+export const CLIENT_PREFETCH_BUNDLE: string | undefined =
+  'var __defProp = Object.defineProperty;\nvar __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;\nvar __publicField = (obj, key, value) => {\n  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);\n  return value;\n};\n\n// src/rendering/client/browser-logger.ts\nvar ConditionalBrowserLogger = class {\n  constructor(prefix, level) {\n    this.prefix = prefix;\n    this.level = level;\n  }\n  log(minLevel, fn, message, ...args) {\n    if (this.level > minLevel)\n      return;\n    fn?.(message, ...args);\n  }\n  debug(message, ...args) {\n    this.log(\n      0 /* DEBUG */,\n      console.debug,\n      `[${this.prefix}] DEBUG: ${message}`,\n      ...args\n    );\n  }\n  info(message, ...args) {\n    this.log(1 /* INFO */, console.log, `[${this.prefix}] ${message}`, ...args);\n  }\n  warn(message, ...args) {\n    this.log(\n      2 /* WARN */,\n      console.warn,\n      `[${this.prefix}] WARN: ${message}`,\n      ...args\n    );\n  }\n  error(message, ...args) {\n    this.log(\n      3 /* ERROR */,\n      console.error,\n      `[${this.prefix}] ERROR: ${message}`,\n      ...args\n    );\n  }\n};\nfunction getBrowserLogLevel() {\n  if (typeof window === "undefined")\n    return 2 /* WARN */;\n  const g = globalThis;\n  const isDevelopment = g.__VERYFRONT_DEV__ || g.__RSC_DEV__;\n  if (!isDevelopment)\n    return 2 /* WARN */;\n  const isDebugEnabled = g.__VERYFRONT_DEBUG__ || g.__RSC_DEBUG__;\n  return isDebugEnabled ? 0 /* DEBUG */ : 1 /* INFO */;\n}\nvar defaultLevel = getBrowserLogLevel();\nvar rscLogger = new ConditionalBrowserLogger("RSC", defaultLevel);\nvar prefetchLogger = new ConditionalBrowserLogger("PREFETCH", defaultLevel);\nvar hydrateLogger = new ConditionalBrowserLogger("HYDRATE", defaultLevel);\nvar browserLogger = new ConditionalBrowserLogger("VERYFRONT", defaultLevel);\n\n// src/rendering/client/prefetch/link-observer.ts\nfunction isAnchorElement(element) {\n  return typeof HTMLAnchorElement !== "undefined" ? element instanceof HTMLAnchorElement : element.tagName === "A";\n}\nvar LinkObserver = class {\n  constructor(options, prefetchedUrls) {\n    __publicField(this, "options");\n    __publicField(this, "intersectionObserver", null);\n    __publicField(this, "mutationObserver", null);\n    __publicField(this, "prefetchedUrls");\n    __publicField(this, "pendingTimeouts", /* @__PURE__ */ new Map());\n    __publicField(this, "elementTimeoutMap", /* @__PURE__ */ new WeakMap());\n    __publicField(this, "timeoutCounter", 0);\n    this.options = options;\n    this.prefetchedUrls = prefetchedUrls;\n  }\n  init() {\n    this.createIntersectionObserver();\n    this.observeLinks();\n    this.setupMutationObserver();\n  }\n  createIntersectionObserver() {\n    this.intersectionObserver = new IntersectionObserver(\n      (entries) => this.handleIntersection(entries),\n      { rootMargin: this.options.rootMargin }\n    );\n  }\n  handleIntersection(entries) {\n    for (const entry of entries) {\n      if (!entry.isIntersecting)\n        continue;\n      if (!isAnchorElement(entry.target))\n        continue;\n      const link = entry.target;\n      if (this.timeoutCounter > 1e6)\n        this.timeoutCounter = 0;\n      const timeoutKey = this.timeoutCounter++;\n      const timeoutId = setTimeout(() => {\n        this.pendingTimeouts.delete(timeoutKey);\n        this.elementTimeoutMap.delete(link);\n        this.options.onLinkVisible(link);\n      }, this.options.delay);\n      this.pendingTimeouts.set(timeoutKey, timeoutId);\n      this.elementTimeoutMap.set(link, timeoutKey);\n    }\n  }\n  observeLinks() {\n    this.observeAnchors(document.querySelectorAll(\'a[href^="/"], a[href^="./"]\'));\n  }\n  setupMutationObserver() {\n    this.mutationObserver = new MutationObserver((mutations) => {\n      for (const mutation of mutations) {\n        if (mutation.type !== "childList")\n          continue;\n        for (const node of mutation.addedNodes) {\n          if (node.nodeType !== Node.ELEMENT_NODE)\n            continue;\n          this.observeElement(node);\n        }\n        for (const node of mutation.removedNodes) {\n          if (node.nodeType !== Node.ELEMENT_NODE)\n            continue;\n          this.clearElementTimeouts(node);\n        }\n      }\n    });\n    this.mutationObserver.observe(document.body, { childList: true, subtree: true });\n  }\n  clearTimeoutForElement(element) {\n    const timeoutKey = this.elementTimeoutMap.get(element);\n    if (timeoutKey === void 0)\n      return;\n    const timeoutId = this.pendingTimeouts.get(timeoutKey);\n    if (timeoutId !== void 0) {\n      clearTimeout(timeoutId);\n      this.pendingTimeouts.delete(timeoutKey);\n    }\n    this.elementTimeoutMap.delete(element);\n  }\n  clearElementTimeouts(element) {\n    if (isAnchorElement(element))\n      this.clearTimeoutForElement(element);\n    for (const link of element.querySelectorAll("a")) {\n      this.clearTimeoutForElement(link);\n    }\n  }\n  observeElement(element) {\n    if (isAnchorElement(element) && this.isValidLink(element)) {\n      this.intersectionObserver?.observe(element);\n    }\n    this.observeAnchors(element.querySelectorAll(\'a[href^="/"], a[href^="./"]\'));\n  }\n  observeAnchors(links) {\n    for (const link of links) {\n      if (!isAnchorElement(link))\n        continue;\n      if (!this.isValidLink(link))\n        continue;\n      this.intersectionObserver?.observe(link);\n    }\n  }\n  isValidLink(link) {\n    if (link.hostname !== globalThis.location.hostname)\n      return false;\n    if (link.hasAttribute("download"))\n      return false;\n    if (link.target === "_blank")\n      return false;\n    const url = link.href;\n    if (this.prefetchedUrls.has(url))\n      return false;\n    if (url === globalThis.location.href)\n      return false;\n    if (link.hash && link.pathname === globalThis.location.pathname)\n      return false;\n    if (link.dataset.noPrefetch)\n      return false;\n    return true;\n  }\n  destroy() {\n    for (const timeoutId of this.pendingTimeouts.values()) {\n      clearTimeout(timeoutId);\n    }\n    this.pendingTimeouts.clear();\n    this.timeoutCounter = 0;\n    this.intersectionObserver?.disconnect();\n    this.intersectionObserver = null;\n    this.mutationObserver?.disconnect();\n    this.mutationObserver = null;\n  }\n};\n\n// src/rendering/client/prefetch/network-utils.ts\nvar NetworkUtils = class {\n  constructor(allowedNetworks = ["4g", "wifi", "ethernet"]) {\n    __publicField(this, "networkInfo");\n    __publicField(this, "allowedNetworks");\n    this.allowedNetworks = allowedNetworks;\n    this.networkInfo = this.getNetworkConnection();\n  }\n  getNavigatorWithConnection() {\n    if (typeof globalThis.navigator === "undefined")\n      return null;\n    return globalThis.navigator;\n  }\n  getNetworkConnection() {\n    const nav = this.getNavigatorWithConnection();\n    return nav?.connection ?? nav?.mozConnection ?? nav?.webkitConnection ?? null;\n  }\n  shouldPrefetch() {\n    if (this.networkInfo?.saveData)\n      return false;\n    const effectiveType = this.networkInfo?.effectiveType;\n    if (effectiveType != null && !this.allowedNetworks.includes(effectiveType))\n      return false;\n    return true;\n  }\n  onNetworkChange(callback) {\n    this.networkInfo?.addEventListener?.("change", callback);\n  }\n  getNetworkInfo() {\n    return this.networkInfo;\n  }\n};\n\n// src/rendering/client/prefetch/prefetch-queue.ts\nimport { PREFETCH_QUEUE_MAX_SIZE_BYTES } from "#veryfront/utils/constants/index.ts";\nvar DEFAULT_OPTIONS = {\n  maxConcurrent: 4,\n  maxSize: PREFETCH_QUEUE_MAX_SIZE_BYTES,\n  timeout: 5e3\n};\nfunction isAbortError(error) {\n  if (typeof error !== "object" || error === null)\n    return false;\n  if (!("name" in error))\n    return false;\n  return error.name === "AbortError";\n}\nvar PrefetchQueue = class {\n  constructor(options = {}, prefetchedUrls) {\n    __publicField(this, "options");\n    __publicField(this, "controllers", /* @__PURE__ */ new Map());\n    __publicField(this, "prefetchedUrls");\n    __publicField(this, "concurrent", 0);\n    __publicField(this, "stopped", false);\n    __publicField(this, "onResourcesFetched");\n    this.options = { ...DEFAULT_OPTIONS, ...options };\n    this.prefetchedUrls = prefetchedUrls ?? /* @__PURE__ */ new Set();\n  }\n  setResourceCallback(callback) {\n    this.onResourcesFetched = callback;\n  }\n  enqueue(url) {\n    void this.prefetch(url);\n  }\n  has(url) {\n    return this.prefetchedUrls.has(url) || this.controllers.has(url);\n  }\n  get size() {\n    return this.controllers.size;\n  }\n  clear() {\n    this.stopAll();\n    this.prefetchedUrls.clear();\n  }\n  start() {\n    this.stopped = false;\n  }\n  stop() {\n    this.stopped = true;\n    this.stopAll();\n  }\n  getQueueSize() {\n    return this.controllers.size;\n  }\n  getConcurrentCount() {\n    return this.concurrent;\n  }\n  async prefetchLink(link) {\n    if (this.stopped)\n      return;\n    const url = link.href;\n    if (!url || this.controllers.has(url) || this.prefetchedUrls.has(url))\n      return;\n    if (this.concurrent >= this.options.maxConcurrent) {\n      prefetchLogger.debug?.(`Prefetch queue full, skipping ${url}`);\n      return;\n    }\n    let parsedUrl;\n    try {\n      parsedUrl = new URL(url);\n    } catch {\n      prefetchLogger.debug?.(`Invalid prefetch URL ${url}`);\n      return;\n    }\n    const controller = new AbortController();\n    this.controllers.set(url, controller);\n    this.concurrent += 1;\n    const timeoutId = this.options.timeout > 0 ? setTimeout(() => controller.abort(), this.options.timeout) : void 0;\n    try {\n      const response = await fetch(parsedUrl.toString(), {\n        method: "GET",\n        signal: controller.signal,\n        headers: { "X-Veryfront-Prefetch": "1" }\n      });\n      if (!response.ok)\n        return;\n      if (this.isResponseTooLarge(response)) {\n        prefetchLogger.debug?.(`Prefetch too large, skipping ${url}`);\n        return;\n      }\n      this.prefetchedUrls.add(url);\n      if (!this.onResourcesFetched)\n        return;\n      try {\n        await this.onResourcesFetched(response, url);\n      } catch (callbackError) {\n        prefetchLogger.error?.(`Prefetch callback failed for ${url}`, callbackError);\n      }\n    } catch (error) {\n      if (!isAbortError(error)) {\n        prefetchLogger.error?.(`Failed to prefetch ${url}`, error);\n      }\n    } finally {\n      if (timeoutId !== void 0)\n        clearTimeout(timeoutId);\n      this.controllers.delete(url);\n      this.concurrent = Math.max(0, this.concurrent - 1);\n    }\n  }\n  async prefetch(url) {\n    const link = typeof document !== "undefined" ? document.createElement("a") : { href: url };\n    link.href = url;\n    await this.prefetchLink(link);\n  }\n  stopAll() {\n    for (const controller of this.controllers.values()) {\n      controller.abort();\n    }\n    this.controllers.clear();\n    this.concurrent = 0;\n  }\n  isResponseTooLarge(response) {\n    const rawLength = response.headers.get("content-length");\n    if (rawLength === null)\n      return false;\n    const size = Number.parseInt(rawLength, 10);\n    if (!Number.isFinite(size))\n      return false;\n    return size > this.options.maxSize;\n  }\n};\nvar prefetchQueue = new PrefetchQueue();\n\n// src/rendering/client/prefetch/resource-hints.ts\nvar ResourceHintsManager = class {\n  constructor() {\n    __publicField(this, "appliedHints", /* @__PURE__ */ new Set());\n  }\n  applyResourceHints(hints) {\n    for (const hint of hints) {\n      const key = `${hint.type}:${hint.href}`;\n      if (this.appliedHints.has(key))\n        continue;\n      const existing = document.querySelector(\n        `link[rel="${hint.type}"][href="${hint.href}"]`\n      );\n      if (existing) {\n        this.appliedHints.add(key);\n        continue;\n      }\n      this.createAndAppendHint(hint);\n      this.appliedHints.add(key);\n      prefetchLogger.debug(`Added resource hint: ${hint.type} ${hint.href}`);\n    }\n  }\n  createAndAppendHint(hint) {\n    if (!document.head) {\n      prefetchLogger.warn("document.head is not available, skipping resource hint");\n      return;\n    }\n    const link = document.createElement("link");\n    link.rel = hint.type;\n    link.href = hint.href;\n    if (hint.as)\n      link.setAttribute("as", hint.as);\n    if (hint.crossOrigin)\n      link.setAttribute("crossorigin", hint.crossOrigin);\n    if (hint.media)\n      link.setAttribute("media", hint.media);\n    document.head.appendChild(link);\n  }\n  extractResourceHints(html, prefetchedUrls) {\n    try {\n      const doc = new DOMParser().parseFromString(html, "text/html");\n      const hints = [];\n      this.extractPreloadLinks(doc, prefetchedUrls, hints);\n      this.extractScripts(doc, prefetchedUrls, hints);\n      this.extractStylesheets(doc, prefetchedUrls, hints);\n      return hints;\n    } catch (error) {\n      prefetchLogger.error("Failed to parse prefetched page", error);\n      return [];\n    }\n  }\n  isValidResourceHintType(rel) {\n    switch (rel) {\n      case "prefetch":\n      case "preload":\n      case "preconnect":\n      case "dns-prefetch":\n        return true;\n      default:\n        return false;\n    }\n  }\n  extractPreloadLinks(doc, prefetchedUrls, hints) {\n    const links = doc.querySelectorAll(\n      \'link[rel="preload"], link[rel="prefetch"]\'\n    );\n    for (const link of links) {\n      const href = link.href;\n      if (!href)\n        continue;\n      if (prefetchedUrls.has(href))\n        continue;\n      if (!this.isValidResourceHintType(link.rel))\n        continue;\n      hints.push({\n        type: link.rel,\n        href,\n        as: link.getAttribute("as") ?? void 0\n      });\n    }\n  }\n  extractScripts(doc, prefetchedUrls, hints) {\n    for (const script of doc.querySelectorAll("script[src]")) {\n      const src = script.src;\n      if (!src || prefetchedUrls.has(src))\n        continue;\n      hints.push({ type: "prefetch", href: src, as: "script" });\n    }\n  }\n  extractStylesheets(doc, prefetchedUrls, hints) {\n    for (const link of doc.querySelectorAll(\'link[rel="stylesheet"]\')) {\n      const href = link.href;\n      if (!href || prefetchedUrls.has(href))\n        continue;\n      hints.push({ type: "prefetch", href, as: "style" });\n    }\n  }\n  static generateResourceHints(_route, assets) {\n    const hints = [\n      \'<link rel="dns-prefetch" href="https://cdn.jsdelivr.net">\',\n      \'<link rel="dns-prefetch" href="https://esm.sh">\',\n      \'<link rel="preconnect" href="https://cdn.jsdelivr.net" crossorigin>\'\n    ];\n    for (const asset of assets) {\n      if (asset.endsWith(".js")) {\n        hints.push(`<link rel="modulepreload" href="${asset}">`);\n        continue;\n      }\n      if (asset.endsWith(".css")) {\n        hints.push(`<link rel="preload" as="style" href="${asset}">`);\n        continue;\n      }\n      if (/\\.(woff2?|ttf|otf)$/.test(asset)) {\n        hints.push(`<link rel="preload" as="font" href="${asset}" crossorigin>`);\n      }\n    }\n    return hints.join("\\n");\n  }\n};\n\n// src/rendering/client/prefetch.ts\nimport {\n  PREFETCH_DEFAULT_DELAY_MS,\n  PREFETCH_DEFAULT_TIMEOUT_MS,\n  PREFETCH_MAX_SIZE_BYTES\n} from "#veryfront/utils";\nvar PrefetchManager = class {\n  constructor(options = {}) {\n    __publicField(this, "options");\n    __publicField(this, "prefetchedUrls", /* @__PURE__ */ new Set());\n    __publicField(this, "networkUtils");\n    __publicField(this, "linkObserver", null);\n    __publicField(this, "resourceHintsManager");\n    __publicField(this, "prefetchQueue");\n    this.options = {\n      rootMargin: options.rootMargin ?? "50px",\n      delay: options.delay ?? PREFETCH_DEFAULT_DELAY_MS,\n      maxConcurrent: options.maxConcurrent ?? 2,\n      allowedNetworks: options.allowedNetworks ?? ["4g", "wifi", "ethernet"],\n      maxSize: options.maxSize ?? PREFETCH_MAX_SIZE_BYTES,\n      timeout: options.timeout ?? PREFETCH_DEFAULT_TIMEOUT_MS\n    };\n    this.networkUtils = new NetworkUtils(this.options.allowedNetworks);\n    this.resourceHintsManager = new ResourceHintsManager();\n    this.prefetchQueue = new PrefetchQueue(\n      {\n        maxConcurrent: this.options.maxConcurrent,\n        maxSize: this.options.maxSize,\n        timeout: this.options.timeout\n      },\n      this.prefetchedUrls\n    );\n    this.prefetchQueue.setResourceCallback(\n      (response, url) => this.prefetchPageResources(response, url)\n    );\n  }\n  init() {\n    prefetchLogger.info("Initializing prefetch manager");\n    if (!this.networkUtils.shouldPrefetch()) {\n      prefetchLogger.info("Prefetching disabled due to network conditions");\n      return;\n    }\n    this.linkObserver = new LinkObserver(\n      {\n        rootMargin: this.options.rootMargin,\n        delay: this.options.delay,\n        onLinkVisible: (link) => this.prefetchQueue.prefetchLink(link)\n      },\n      this.prefetchedUrls\n    );\n    this.linkObserver.init();\n    this.networkUtils.onNetworkChange(() => {\n      if (!this.networkUtils.shouldPrefetch())\n        this.prefetchQueue.stopAll();\n    });\n  }\n  async prefetchPageResources(response, _pageUrl) {\n    const html = await response.text();\n    const hints = this.resourceHintsManager.extractResourceHints(html, this.prefetchedUrls);\n    this.resourceHintsManager.applyResourceHints(hints);\n  }\n  applyResourceHints(hints) {\n    this.resourceHintsManager.applyResourceHints(hints);\n  }\n  async prefetch(url) {\n    await this.prefetchQueue.prefetch(url);\n  }\n  static generateResourceHints(route, assets) {\n    return ResourceHintsManager.generateResourceHints(route, assets);\n  }\n  destroy() {\n    this.linkObserver?.destroy();\n    this.prefetchQueue.stopAll();\n    this.prefetchedUrls.clear();\n  }\n};\nfunction initPrefetch(options) {\n  const prefetchManager = new PrefetchManager(options);\n  if (document.readyState === "loading") {\n    document.addEventListener("DOMContentLoaded", () => prefetchManager.init());\n  } else {\n    prefetchManager.init();\n  }\n  globalThis.veryFrontPrefetch = prefetchManager;\n  return prefetchManager;\n}\nfunction resolveAutoInitOptions() {\n  const setting = globalThis.__VERYFRONT_PREFETCH__;\n  if (!setting)\n    return null;\n  if (setting === true)\n    return {};\n  if (typeof setting === "object")\n    return setting;\n  return null;\n}\nfunction shouldAutoInitPrefetch(options) {\n  if (!options)\n    return false;\n  if (typeof window === "undefined" || typeof document === "undefined")\n    return false;\n  const win = window;\n  const doc = document;\n  if (win.__veryfrontSSRStub || doc.__veryfrontSSRStub)\n    return false;\n  if (typeof IntersectionObserver === "undefined")\n    return false;\n  if (typeof MutationObserver === "undefined")\n    return false;\n  return true;\n}\nvar autoInitOptions = resolveAutoInitOptions();\nif (shouldAutoInitPrefetch(autoInitOptions))\n  initPrefetch(autoInitOptions);\nexport {\n  PrefetchManager,\n  initPrefetch\n};\n';

package/src/src/build/vendor-cache.ts

@@ -80,14 +80,8 @@ function isLruIntervalDisabled(): boolean {
   return globalFlag === true || getDisableLruIntervalEnv();
 }
 
-// Default singleton instance for backward compatibility
 let defaultInstance: VendorCacheManager | undefined;
 
-function _getDefaultInstance(): VendorCacheManager {
-  defaultInstance ??= new VendorCacheManager();
-  return defaultInstance;
-}
-
 const TRANSFORM_VERSION = "3";
 
 export async function generateVendorCacheKey(

package/src/src/cache/tokenizing-gateway.ts

@@ -15,12 +15,7 @@
 
 import { logger } from "../utils/index.js";
 import type { CacheBackend } from "./types.js";
-import {
-  assertPortableCode,
-  CACHE_INVARIANT_VIOLATION,
-  detokenizeAllCachePaths,
-  tokenizeAllVeryFrontPaths,
-} from "./paths.js";
+import { assertPortableCode, detokenizeAllCachePaths, tokenizeAllVeryFrontPaths } from "./paths.js";
 
 /**
  * Gateway interface for code storage in distributed cache.
@@ -281,6 +276,3 @@ export function createTokenizingGateway(
 ): TokenizingCacheGateway {
   return new TokenizingCacheGateway(backend, name);
 }
-
-// Re-export error definition for consumers
-export { CACHE_INVARIANT_VIOLATION };

package/src/src/chat/index.ts

@@ -133,6 +133,7 @@ export {
   InferenceBadge,
   InlineCitation,
   isReasoningPart,
+  isSkillToolPart,
   isToolPart,
   Loader,
   MessageActions,
@@ -143,6 +144,7 @@ export {
   ReasoningCard,
   RichCodeBlock,
   Shimmer,
+  SkillBadge,
   Sources,
   StepIndicator,
   Suggestion,
@@ -186,6 +188,7 @@ export type {
   PartGroup,
   QuickAction,
   QuickActionsProps,
+  SkillBadgeProps,
   Source,
   SourcesProps,
   StepIndicatorProps,

package/src/src/config/define-config.ts

@@ -20,48 +20,49 @@ export function mergeConfigs(...configs: Partial<VeryfrontConfig>[]): VeryfrontC
 export async function validateConfig(config: unknown): Promise<void> {
   if (!config || typeof config !== "object") {
     throw toError(
-      createError({
-        type: "config",
-        message: "Configuration must be an object",
-      }),
+      createError({ type: "config", message: "Configuration must be an object" }),
     );
   }
 
   const cfg = config as Record<string, unknown>;
 
+  await validatePort(cfg);
+  validateOutDir(cfg);
+}
+
+async function validatePort(cfg: Record<string, unknown>): Promise<void> {
   const dev = cfg.dev;
   const port = dev && typeof dev === "object" ? (dev as Record<string, unknown>).port : undefined;
+  if (port === undefined) return;
 
-  if (port !== undefined) {
-    const { MIN_PORT, MAX_PORT } = await import("../utils/constants/index.js");
+  const { MIN_PORT, MAX_PORT } = await import("../utils/constants/index.js");
+  if (typeof port === "number" && port >= MIN_PORT && port <= MAX_PORT) return;
 
-    if (typeof port !== "number" || port < MIN_PORT || port > MAX_PORT) {
-      throw toError(
-        createError({
-          type: "config",
-          message: `dev.port must be a number between ${MIN_PORT} and ${MAX_PORT}`,
-          context: {
-            field: "dev.port",
-            value: port,
-            expected: `number between ${MIN_PORT} and ${MAX_PORT}`,
-          },
-        }),
-      );
-    }
-  }
+  throw toError(
+    createError({
+      type: "config",
+      message: `dev.port must be a number between ${MIN_PORT} and ${MAX_PORT}`,
+      context: {
+        field: "dev.port",
+        value: port,
+        expected: `number between ${MIN_PORT} and ${MAX_PORT}`,
+      },
+    }),
+  );
+}
 
+function validateOutDir(cfg: Record<string, unknown>): void {
   const build = cfg.build;
   const outDir = build && typeof build === "object"
     ? (build as Record<string, unknown>).outDir
     : undefined;
+  if (outDir === undefined || typeof outDir === "string") return;
 
-  if (outDir !== undefined && typeof outDir !== "string") {
-    throw toError(
-      createError({
-        type: "config",
-        message: "build.outDir must be a string",
-        context: { field: "build.outDir", value: outDir, expected: "string" },
-      }),
-    );
-  }
+  throw toError(
+    createError({
+      type: "config",
+      message: "build.outDir must be a string",
+      context: { field: "build.outDir", value: outDir, expected: "string" },
+    }),
+  );
 }

package/src/src/config/loader.ts

@@ -141,18 +141,19 @@ let cacheRevision = 0;
 function validateCorsConfig(userConfig: unknown): void {
   if (!userConfig || typeof userConfig !== "object") return;
 
-  const security = (userConfig as Record<string, unknown>).security as
-    | Record<string, unknown>
-    | undefined;
-  const cors = security?.cors;
+  const cfg = userConfig as Record<string, unknown>;
+  const security = cfg.security as Record<string, unknown> | undefined;
+  if (!security) return;
+
+  const cors = security.cors;
   if (!cors || typeof cors !== "object" || Array.isArray(cors)) return;
 
   const origin = (cors as Record<string, unknown>).origin;
-  if (origin !== undefined && typeof origin !== "string") {
-    throw CONFIG_VALIDATION_FAILED.create({
-      detail: "security.cors.origin must be a string. Expected boolean or { origin?: string }",
-    });
-  }
+  if (origin === undefined || typeof origin === "string") return;
+
+  throw CONFIG_VALIDATION_FAILED.create({
+    detail: "security.cors.origin must be a string. Expected boolean or { origin?: string }",
+  });
 }
 
 function validateConfigShape(userConfig: unknown): void {

package/src/src/config/schemas/config.schema.ts

@@ -397,6 +397,18 @@ export const veryfrontConfigSchema = z
           })
           .partial()
           .optional(),
+        skills: z
+          .object({
+            discovery: z
+              .object({
+                enabled: z.boolean().optional(),
+                paths: z.array(z.string()).optional(),
+              })
+              .partial()
+              .optional(),
+          })
+          .partial()
+          .optional(),
         mcp: z
           .object({
             enabled: z.boolean().optional(),

package/src/src/data/data-fetcher.ts

@@ -1,5 +1,3 @@
-// Direct import from base.ts to avoid circular dependency through barrel
-import type { RuntimeAdapter } from "../platform/adapters/base.js";
 import { withSpan } from "../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../observability/tracing/span-names.js";
 import { CacheManager } from "./data-fetching-cache.js";
@@ -14,10 +12,11 @@ export class DataFetcher {
   private staticFetcher: StaticDataFetcher;
   private pathsFetcher: StaticPathsFetcher;
 
-  constructor(adapter?: RuntimeAdapter) {
+  // deno-lint-ignore no-unused-vars -- adapter kept for public API compatibility
+  constructor(adapter?: unknown) {
     this.cacheManager = new CacheManager();
-    this.serverFetcher = new ServerDataFetcher(adapter);
-    this.staticFetcher = new StaticDataFetcher(this.cacheManager, adapter);
+    this.serverFetcher = new ServerDataFetcher();
+    this.staticFetcher = new StaticDataFetcher(this.cacheManager);
     this.pathsFetcher = new StaticPathsFetcher();
   }
 
@@ -27,26 +26,21 @@ export class DataFetcher {
     mode: "development" | "production" = "development",
   ): Promise<DataResult> {
     const preferServerData = mode === "development" || !pageModule.getStaticData;
+    const useServer = preferServerData && !!pageModule.getServerData;
+    const useStatic = !useServer && !!pageModule.getStaticData;
 
-    let fetchType: "server" | "static" | "none" = "none";
-    if (preferServerData && pageModule.getServerData) {
-      fetchType = "server";
-    } else if (pageModule.getStaticData) {
-      fetchType = "static";
-    }
+    const fetchType: "server" | "static" | "none" = useServer
+      ? "server"
+      : useStatic
+      ? "static"
+      : "none";
 
     return withSpan(
       SpanNames.DATA_FETCH,
-      async () => {
-        if (preferServerData && pageModule.getServerData) {
-          return this.serverFetcher.fetch(pageModule, context);
-        }
-
-        if (pageModule.getStaticData) {
-          return this.staticFetcher.fetch(pageModule, context);
-        }
-
-        return { props: {} };
+      () => {
+        if (useServer) return this.serverFetcher.fetch(pageModule, context);
+        if (useStatic) return this.staticFetcher.fetch(pageModule, context);
+        return Promise.resolve({ props: {} });
       },
       {
         "data.fetch_type": fetchType,

package/src/src/data/server-data-fetcher.ts

@@ -1,5 +1,3 @@
-// Direct import from base.ts to avoid circular dependency through barrel
-import type { RuntimeAdapter } from "../platform/adapters/base.js";
 import type { DataContext, DataResult, PageWithData } from "./types.js";
 import { serverLogger } from "../utils/index.js";
 import { DATA_FETCH_TIMEOUT_MS } from "../config/defaults.js";
@@ -8,8 +6,6 @@ import { withSpan } from "../observability/tracing/otlp-setup.js";
 import { CircuitBreakerOpen, getCircuitBreaker } from "../utils/circuit-breaker.js";
 
 export class ServerDataFetcher {
-  constructor(private adapter?: RuntimeAdapter) {}
-
   fetch(pageModule: PageWithData, context: DataContext): Promise<DataResult> {
     if (typeof pageModule.getServerData !== "function") {
       return Promise.resolve({ props: {} });
@@ -30,12 +26,9 @@ export class ServerDataFetcher {
         const start = performance.now();
 
         try {
-          const getServerData = pageModule.getServerData;
-          if (!getServerData) throw new Error(`No getServerData function on ${pathname}`);
-
           const result = await circuitBreaker.execute(() =>
             withTimeoutThrow(
-              Promise.resolve(getServerData(context)),
+              Promise.resolve(pageModule.getServerData!(context)),
               DATA_FETCH_TIMEOUT_MS,
               `getServerData for ${pathname}`,
             )

package/src/src/data/static-data-fetcher.ts

@@ -1,5 +1,3 @@
-// Direct import from base.ts to avoid circular dependency through barrel
-import type { RuntimeAdapter } from "../platform/adapters/base.js";
 import type { CacheManager } from "./data-fetching-cache.js";
 import type { DataContext, DataResult, PageWithData } from "./types.js";
 import { serverLogger } from "../utils/index.js";
@@ -56,10 +54,7 @@ function getProjectId(context: DataContext, fallback: string): string {
 export class StaticDataFetcher {
   private pendingRevalidations = new Map<string, Promise<void>>();
 
-  constructor(
-    private cacheManager: CacheManager,
-    private adapter?: RuntimeAdapter,
-  ) {}
+  constructor(private cacheManager: CacheManager) {}
 
   async fetch(pageModule: PageWithData, context: DataContext): Promise<DataResult> {
     if (typeof pageModule.getStaticData !== "function") return { props: {} };

package/src/src/discovery/discovery-engine.ts

@@ -8,6 +8,7 @@
 import { detectPlatform } from "../platform/core-platform.js";
 import { agentLogger } from "../utils/logger/logger.js";
 import { ensureError } from "../errors/veryfront-error.js";
+import { registerSkill, skillRegistry } from "../skill/registry.js";
 import type {
   DiscoveryConfig,
   DiscoveryHandler,
@@ -18,12 +19,14 @@ import { importModule } from "./transpiler.js";
 import { findTypeScriptFiles } from "./file-discovery.js";
 import {
   agentHandler,
+  discoverSkills,
   promptHandler,
   resourceHandler,
   taskHandler,
   toolHandler,
   workflowHandler,
 } from "./handlers/index.js";
+import { join } from "../platform/compat/path/index.js";
 
 const logger = agentLogger.component("discovery");
 
@@ -87,6 +90,7 @@ export async function discoverAll(config: DiscoveryConfig): Promise<DiscoveryRes
   const result: DiscoveryResult = {
     tools: new Map(),
     agents: new Map(),
+    skills: new Map(),
     resources: new Map(),
     prompts: new Map(),
     workflows: new Map(),
@@ -124,5 +128,28 @@ export async function discoverAll(config: DiscoveryConfig): Promise<DiscoveryRes
     await discoverItems(`${baseDir}/${dir}`, result, context, taskHandler, config.verbose);
   }
 
+  // Clear stale skills before rediscovery so deleted/renamed skills are removed.
+  skillRegistry.clear();
+
+  // Discover skills (parallel path — markdown-based, not TypeScript import)
+  for (const dir of config.skillDirs ?? ["skills"]) {
+    const skillResult = await discoverSkills(
+      join(baseDir, dir),
+      context,
+      config.verbose,
+    );
+    for (const [id, skill] of skillResult.skills) {
+      if (result.skills.has(id)) {
+        logger.warn(`Duplicate skill "${id}" across discovery roots; keeping first registration`);
+        continue;
+      }
+      registerSkill(id, skill);
+      result.skills.set(id, skill);
+    }
+    result.errors.push(
+      ...skillResult.errors.map((e) => ({ file: e.file, error: e.error })),
+    );
+  }
+
   return result;
 }

package/src/src/discovery/discovery-utils.ts

@@ -36,13 +36,6 @@ export function trackAgentPath(id: string, filePath: string): void {
   discoveredAgentPaths.set(id, filePath);
 }
 
-/**
- * Get all tracked agent paths
- */
-export function getTrackedAgentPaths(): Map<string, string> {
-  return discoveredAgentPaths;
-}
-
 /**
  * Clear tracked agent paths
  */

package/src/src/discovery/file-discovery.ts

@@ -58,21 +58,15 @@ export async function findTypeScriptFiles(
 }
 
 /**
- * Get Node.js fs and path modules (cached on context)
+ * Get Node.js fs and path modules (cached on context).
+ *
+ * Only called when no fsAdapter is present — callers must guard accordingly.
  */
 export async function getNodeDeps(
   context: FileDiscoveryContext,
 ): Promise<{ fs: typeof import("node:fs"); path: typeof import("node:path") }> {
   if (context.nodeDeps) return context.nodeDeps;
 
-  if (context.fsAdapter) {
-    context.nodeDeps = {
-      fs: {} as typeof import("node:fs"),
-      path: {} as typeof import("node:path"),
-    };
-    return context.nodeDeps;
-  }
-
   const [fsModule, pathModule] = await Promise.all([import("node:fs"), import("node:path")]);
   context.nodeDeps = { fs: fsModule, path: pathModule };
   return context.nodeDeps;

package/src/src/discovery/handlers/index.ts

@@ -10,3 +10,4 @@ export { resourceHandler } from "./resource-handler.js";
 export { promptHandler } from "./prompt-handler.js";
 export { workflowHandler } from "./workflow-handler.js";
 export { taskHandler } from "./task-handler.js";
+export { discoverSkills } from "./skill-handler.js";