@bractjs/bractjs 0.1.28 → 0.1.29

package/types/route.d.ts

@@ -63,6 +63,32 @@ export type ActionFunction<T = unknown> = (
 
 export type MetaFunction<T = unknown> = (args: MetaArgs<T>) => MetaDescriptor[];
 
+export interface HeadersArgs<T = unknown> {
+  loaderData: T;
+  params: Record<string, string>;
+  request: Request;
+  /** Headers merged from ancestors in the chain (root → layout → this route). */
+  parentHeaders: Headers;
+}
+
+/**
+ * A module's optional `headers` export — set response headers (`Cache-Control`,
+ * `ETag`, `Vary`, …) on the document and `/_data` responses. Runs in chain
+ * order (root → layout → route); innermost wins per key.
+ */
+export type HeadersFunction<T = unknown> = (args: HeadersArgs<T>) => HeadersInit;
+
+/**
+ * A nested route-middleware function. Runs on the server in chain order
+ * (root → layout → route) before `beforeLoad`/action/loaders, with a shared
+ * mutable `context`. Return a `Response` to short-circuit; call `next()` to
+ * continue.
+ */
+export type RouteMiddlewareFunction = (
+  ctx: { request: Request; params: Record<string, string>; context: Record<string, unknown> },
+  next: () => Promise<Response>,
+) => Promise<Response>;
+
 export interface BeforeLoadArgs {
   params: Record<string, string>;
   context: Record<string, unknown>;
@@ -90,10 +116,38 @@ export interface ShouldRevalidateArgs {
 
 export type ShouldRevalidateFunction = (args: ShouldRevalidateArgs) => boolean;
 
+/** A route's browser-side loader (RR7-style). See the package docs. */
+export interface ClientLoaderFunction<T = unknown> {
+  (args: {
+    request: Request;
+    params: Record<string, string>;
+    search: Record<string, unknown>;
+    serverLoader: () => Promise<unknown>;
+  }): Promise<T> | T;
+  /** Run on initial hydration too (default: only on client navigation). */
+  hydrate?: boolean;
+}
+
+/** A route's browser-side action (RR7-style). See the package docs. */
+export type ClientActionFunction<T = unknown> = (args: {
+  request: Request;
+  params: Record<string, string>;
+  formData: FormData;
+  serverAction: () => Promise<unknown>;
+}) => Promise<T> | T;
+
 export interface RouteModule<TLoader = unknown, TAction = unknown> {
   loader?: LoaderFunction<TLoader>;
   action?: ActionFunction<TAction>;
+  /** Browser-side loader; see {@link ClientLoaderFunction}. */
+  clientLoader?: ClientLoaderFunction<TLoader>;
+  /** Browser-side action; see {@link ClientActionFunction}. */
+  clientAction?: ClientActionFunction<TAction>;
   meta?: MetaFunction<TLoader>;
+  /** Set response headers (Cache-Control/ETag/Vary/…) for this route's document and `/_data` responses. Chain order, innermost wins. */
+  headers?: HeadersFunction<TLoader>;
+  /** Nested middleware (root → layout → route), shared mutable `context`, runs before beforeLoad/action/loaders. A single fn or an array. */
+  middleware?: RouteMiddlewareFunction | RouteMiddlewareFunction[];
   beforeLoad?: BeforeLoadFunction;
   shouldRevalidate?: ShouldRevalidateFunction;
   /** Zod/Valibot-compatible schema validating search params before loaders run (400 on failure). */
@@ -111,7 +165,28 @@ export interface RouteModule<TLoader = unknown, TAction = unknown> {
   default?: ComponentType;
 }
 
-export type Segment = string | { param: string } | { catchAll: string };
+/**
+ * One entry in the matched route chain (see `useMatches`), outermost → innermost:
+ * root, layouts, then the leaf route.
+ */
+export interface RouteMatch<TData = unknown, THandle = Record<string, unknown>> {
+  /** Stable id of the matched module — its appDir-relative file path. */
+  id: string;
+  /** The active URL pathname (shared across the chain). */
+  pathname: string;
+  /** The matched route params (shared across the chain). */
+  params: Record<string, string>;
+  /** This module's loader data slice. */
+  data: TData;
+  /** This module's static `handle` export, or `undefined`. */
+  handle: THandle | undefined;
+}
+
+export type Segment =
+  | string
+  | { param: string }
+  | { optional: string }
+  | { catchAll: string };
 
 export interface RouteFile {
   filePath: string;

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 YOUR_NAME
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.