refactor: split plugin definition

pi0 · Copilot · pi0 · commit 40bddfffeee1 · 2026-05-01T20:50:33.000+02:00
allows better dist bundling

Co-authored-by: Copilot &lt;copilot@github.com&gt;
diff --git a/src/h3.ts b/src/h3.ts
@@ -5,7 +5,8 @@ import { callMiddleware, normalizeMiddleware } from "./middleware.ts";
 import { requestWithBaseURL } from "./utils/request.ts";
 
 import type { ServerRequest } from "srvx";
-import type { H3Config, H3CoreConfig, H3Plugin, MatchedRoute, RouterContext } from "./types/h3.ts";
+import type { H3Config, H3CoreConfig, MatchedRoute, RouterContext } from "./types/h3.ts";
+import type { H3Plugin } from "./plugin.ts";
 import type { H3EventContext } from "./types/context.ts";
 import type {
   EventHandler,
diff --git a/src/index.ts b/src/index.ts
@@ -3,7 +3,6 @@
 export type {
   H3Config,
   H3CoreConfig,
-  H3Plugin,
   H3Route,
   H3RouteMeta,
   HTTPMethod,
@@ -14,10 +13,13 @@ export type {
   MatchedRoute,
 } from "./types/h3.ts";
 
-export { definePlugin } from "./types/h3.ts";
-
 export { H3Core, H3 } from "./h3.ts";
 
+// Plugins
+
+export type { H3Plugin } from "./plugin.ts";
+export { definePlugin } from "./plugin.ts";
+
 // Event
 
 export type { H3EventContext } from "./types/context.ts";
diff --git a/src/plugin.ts b/src/plugin.ts
@@ -0,0 +1,9 @@
+import type { H3 } from "./h3.ts";
+
+export type H3Plugin = (h3: H3) => void;
+
+export function definePlugin<T = unknown>(
+  def: (h3: H3, options: T) => void,
+): undefined extends T ? (options?: T) => H3Plugin : (options: T) => H3Plugin {
+  return ((opts?: any) => (h3: H3) => def(h3, opts)) as any;
+}
diff --git a/src/tracing.ts b/src/tracing.ts
@@ -1,6 +1,7 @@
 import type { H3Event } from "./event.ts";
 import type { H3, H3Core } from "./h3.ts";
-import { type H3Plugin, type H3Route, type MiddlewareOptions } from "./types/h3.ts";
+import type { H3Plugin } from "./plugin.ts";
+import type { H3Route, MiddlewareOptions } from "./types/h3.ts";
 import type { EventHandler, Middleware } from "./types/handler.ts";
 
 /**
diff --git a/src/types/h3.ts b/src/types/h3.ts
@@ -5,6 +5,7 @@ import type { MaybePromise } from "./_utils.ts";
 import type { FetchHandler, ServerRequest } from "srvx";
 // import type { MatchedRoute, RouterContext } from "rou3";
 import type { H3Event } from "../event.ts";
+import type { H3Plugin } from "../plugin.ts";
 
 // Inlined from rou3 for type portability
 export interface RouterContext {
@@ -57,16 +58,6 @@ export interface H3Route {
   handler: EventHandler;
 }
 
-// --- H3 Plugins ---
-
-export type H3Plugin = (h3: H3) => void;
-
-export function definePlugin<T = unknown>(
-  def: (h3: H3, options: T) => void,
-): undefined extends T ? (options?: T) => H3Plugin : (options: T) => H3Plugin {
-  return ((opts?: any) => (h3: H3) => def(h3, opts)) as any;
-}
-
 // --- H3 App ---
 
 export type RouteOptions = {
diff --git a/src/utils/route.ts b/src/utils/route.ts
@@ -1,6 +1,7 @@
 import type { H3RouteMeta, HTTPMethod } from "../types/h3.ts";
 import type { EventHandler, Middleware } from "../types/handler.ts";
-import type { H3Plugin, H3 } from "../types/h3.ts";
+import type { H3 } from "../types/h3.ts";
+import type { H3Plugin } from "../plugin.ts";
 import type { StandardSchemaV1 } from "./internal/standard-schema.ts";
 import { removeRoute as _removeRoute } from "rou3";
 import { defineValidatedHandler } from "../handler.ts";
