@pracht/core 0.2.7 → 0.4.0

package/dist/index.d.mts

@@ -76,6 +76,14 @@ interface GroupMeta {
 }
 interface ApiConfig {
   middleware?: string[];
+  /**
+   * When `true` (the default), state-changing API requests
+   * (POST/PUT/PATCH/DELETE) are rejected unless the browser signals a
+   * same-origin/same-site fetch (Sec-Fetch-Site) or the request Origin
+   * matches the request URL's origin. Set to `false` to opt out if you
+   * build your own CSRF protection into middleware.
+   */
+  requireSameOrigin?: boolean;
 }
 interface RouteConfig extends RouteMeta {
   component: ModuleRef;
@@ -181,6 +189,7 @@ interface RouteModule<TContext = any, TLoader extends LoaderLike = undefined> {
   default?: FunctionComponent<RouteComponentProps<TLoader>>;
   ErrorBoundary?: FunctionComponent<ErrorBoundaryProps>;
   getStaticPaths?: () => MaybePromise<RouteParams[]>;
+  markdown?: string;
 }
 interface ShellModule<TContext = any> {
   Shell: FunctionComponent<ShellProps>;
@@ -190,6 +199,7 @@ interface ShellModule<TContext = any> {
 }
 type MiddlewareResult<TContext = any> = void | Response | {
   redirect: string;
+  status?: number;
 } | {
   context: Partial<TContext>;
 };
@@ -227,6 +237,7 @@ declare function buildPathFromSegments(segments: RouteSegment[], params: RoutePa
  *
  * Example: `"/src/api/health.ts"` → path `/api/health`
  *          `"/src/api/users/[id].ts"` → path `/api/users/:id`
+ *          `"/src/api/files/[...path].ts"` → path `/api/files/*`
  *          `"/src/api/index.ts"` → path `/api`
  */
 declare function resolveApiRoutes(files: string[], apiDir?: string): ResolvedApiRoute[];
@@ -252,7 +263,10 @@ declare function forwardRef<P = {}>(fn: ((props: P, ref: any) => any) & {
  */
 declare function useIsHydrated(): boolean;
 //#endregion
-//#region src/runtime.d.ts
+//#region src/runtime-headers.d.ts
+declare function applyDefaultSecurityHeaders(headers: Headers): Headers;
+//#endregion
+//#region src/runtime-errors.d.ts
 type PrachtRuntimeDiagnosticPhase = "match" | "middleware" | "loader" | "action" | "render" | "api";
 interface PrachtRuntimeDiagnostics {
   phase: PrachtRuntimeDiagnosticPhase;
@@ -264,6 +278,14 @@ interface PrachtRuntimeDiagnostics {
   middlewareFiles?: string[];
   status: number;
 }
+interface SerializedRouteError {
+  message: string;
+  name: string;
+  status: number;
+  diagnostics?: PrachtRuntimeDiagnostics;
+}
+//#endregion
+//#region src/runtime-hooks.d.ts
 interface PrachtHydrationState<TData = unknown> {
   url: string;
   routeId: string;
@@ -271,33 +293,17 @@ interface PrachtHydrationState<TData = unknown> {
   error?: SerializedRouteError | null;
   pending?: boolean;
 }
-interface SerializedRouteError {
-  message: string;
-  name: string;
-  status: number;
-  diagnostics?: PrachtRuntimeDiagnostics;
-}
 interface StartAppOptions<TData = unknown> {
   initialData?: TData;
 }
-interface HandlePrachtRequestOptions<TContext = unknown> {
-  app: PrachtApp;
-  request: Request;
-  context?: TContext;
-  registry?: ModuleRegistry;
-  /** Expose raw server error details in rendered HTML and route-state JSON. */
-  debugErrors?: boolean;
-  clientEntryUrl?: string;
-  /** Per-source-file CSS map produced by the vite plugin. */
-  cssManifest?: Record<string, string[]>;
-  /** Per-source-file JS chunk map produced by the vite plugin for modulepreload hints. */
-  jsManifest?: Record<string, string[]>;
-  apiRoutes?: ResolvedApiRoute[];
-}
 interface FormProps extends Omit<JSX.HTMLAttributes<HTMLFormElement>, "action" | "method"> {
   action?: string;
   method?: string;
 }
+interface Location {
+  pathname: string;
+  search: string;
+}
 declare global {
   interface Window {
     __PRACHT_STATE__?: PrachtHydrationState;
@@ -334,14 +340,12 @@ declare function PrachtRuntimeProvider<TData>({
 declare function startApp<TData = unknown>(options?: StartAppOptions<TData>): TData | undefined;
 declare function readHydrationState<TData = unknown>(): PrachtHydrationState<TData> | undefined;
 declare function useRouteData<TData = unknown>(): TData;
-interface Location {
-  pathname: string;
-  search: string;
-}
 declare function useLocation(): Location;
 declare function useParams(): RouteParams;
 declare function useRevalidate(): () => Promise<unknown>;
 declare function Form(props: FormProps): _$preact.VNode<_$preact.ClassAttributes<HTMLFormElement> & h.JSX.HTMLAttributes<HTMLFormElement>>;
+//#endregion
+//#region src/runtime-client-fetch.d.ts
 type RouteStateResult = {
   type: "data";
   data: unknown;
@@ -352,8 +356,25 @@ type RouteStateResult = {
   type: "error";
   error: SerializedRouteError;
 };
+//#endregion
+//#region src/runtime.d.ts
+interface HandlePrachtRequestOptions<TContext = unknown> {
+  app: PrachtApp;
+  request: Request;
+  context?: TContext;
+  registry?: ModuleRegistry;
+  /** Expose raw server error details in rendered HTML and route-state JSON. */
+  debugErrors?: boolean;
+  clientEntryUrl?: string;
+  /** Per-source-file CSS map produced by the vite plugin. */
+  cssManifest?: Record<string, string[]>;
+  /** Per-source-file JS chunk map produced by the vite plugin for modulepreload hints. */
+  jsManifest?: Record<string, string[]>;
+  apiRoutes?: ResolvedApiRoute[];
+}
 declare function handlePrachtRequest<TContext>(options: HandlePrachtRequestOptions<TContext>): Promise<Response>;
-declare function applyDefaultSecurityHeaders(headers: Headers): Headers;
+//#endregion
+//#region src/prerender.d.ts
 interface PrerenderResult {
   path: string;
   html: string;