@pracht/core 0.2.5 → 0.2.7

package/README.md

@@ -35,16 +35,16 @@ metadata for the failure phase and matched framework files when available.
 ### Client
 
 - `startApp()` — client-side hydration and runtime
+- `useLocation()` — access the current pathname and search string separately
 - `useRouteData()` — access loader data inside a route component
-- `useRevalidateRoute()` — trigger a revalidation of the current route's data
-- `useSubmitAction()` — submit a form action programmatically
+- `useRevalidate()` — trigger a revalidation of the current route's data
 - `<Form>` — progressive enhancement form component
 
 ### Types
 
 - `LoaderData<T>` — infer the return type of a loader
 - `RouteComponentProps<T>` — props type for route components
-- `LoaderArgs` — argument type passed to loaders and actions
+- `LoaderArgs` — argument type passed to loaders
 
 ## Rendering Modes
 

package/dist/index.d.mts

@@ -35,7 +35,9 @@ interface TimeRevalidatePolicy {
 }
 type RouteRevalidate = TimeRevalidatePolicy;
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
-type ApiRouteArgs<TContext = RegisteredContext> = BaseRouteArgs<TContext>;
+type ApiRouteArgs<TContext = RegisteredContext> = Omit<BaseRouteArgs<TContext>, "route"> & {
+  route: ResolvedApiRoute;
+};
 type ApiRouteHandler<TContext = RegisteredContext> = (args: ApiRouteArgs<TContext>) => MaybePromise<Response>;
 interface ApiRouteModule<TContext = any> {
   default?: ApiRouteHandler<TContext>;
@@ -286,10 +288,8 @@ interface HandlePrachtRequestOptions<TContext = unknown> {
   /** 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 (preferred over cssUrls). */
+  /** Per-source-file CSS map produced by the vite plugin. */
   cssManifest?: Record<string, string[]>;
-  /** @deprecated Pass cssManifest instead for per-page CSS resolution. */
-  cssUrls?: string[];
   /** Per-source-file JS chunk map produced by the vite plugin for modulepreload hints. */
   jsManifest?: Record<string, string[]>;
   apiRoutes?: ResolvedApiRoute[];
@@ -318,12 +318,14 @@ declare function PrachtRuntimeProvider<TData>({
   data,
   params,
   routeId,
+  stateVersion,
   url
 }: {
   children: ComponentChildren;
   data: TData;
   params?: RouteParams;
   routeId: string;
+  stateVersion?: number;
   url: string;
 }): _$preact.VNode<_$preact.Attributes & {
   value: PrachtRuntimeValue | undefined;
@@ -334,12 +336,11 @@ declare function readHydrationState<TData = unknown>(): PrachtHydrationState<TDa
 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>;
-/** @deprecated Use useRevalidate instead. */
-declare const useRevalidateRoute: typeof useRevalidate;
 declare function Form(props: FormProps): _$preact.VNode<_$preact.ClassAttributes<HTMLFormElement> & h.JSX.HTMLAttributes<HTMLFormElement>>;
 type RouteStateResult = {
   type: "data";
@@ -369,12 +370,10 @@ interface PrerenderAppOptions {
   app: PrachtApp;
   registry?: ModuleRegistry;
   clientEntryUrl?: string;
-  /** Per-source-file CSS map produced by the vite plugin (preferred over cssUrls). */
+  /** Per-source-file CSS map produced by the vite plugin. */
   cssManifest?: Record<string, string[]>;
   /** Per-source-file JS map produced by the vite plugin for modulepreload hints. */
   jsManifest?: Record<string, string[]>;
-  /** @deprecated Pass cssManifest instead for per-page CSS resolution. */
-  cssUrls?: string[];
 }
 declare function prerenderApp(options: PrerenderAppOptions): Promise<PrerenderResult[]>;
 declare function prerenderApp(options: PrerenderAppOptions & {
@@ -388,7 +387,7 @@ declare global {
     __PRACHT_ROUTER_READY__?: boolean;
   }
 }
-type ModuleMap = Record<string, () => Promise<any>>;
+type ModuleMap = Record<string, () => Promise<unknown>>;
 type NavigateFn = (to: string, options?: {
   replace?: boolean;
 }) => Promise<void>;
@@ -403,4 +402,4 @@ interface InitClientRouterOptions {
 }
 declare function initClientRouter(options: InitClientRouterOptions): Promise<void>;
 //#endregion
-export { type ApiConfig, type ApiRouteArgs, type ApiRouteHandler, type ApiRouteMatch, type ApiRouteModule, type BaseRouteArgs, type DataModule, type ErrorBoundaryProps, Form, type FormProps, type GroupDefinition, type GroupMeta, type HandlePrachtRequestOptions, type HeadArgs, type HeadMetadata, type HeadersArgs, type HttpMethod, type ISGManifestEntry, type InitClientRouterOptions, type LoaderArgs, type LoaderData, type LoaderFn, type Location, type MiddlewareArgs, type MiddlewareFn, type MiddlewareModule, type MiddlewareResult, type ModuleImporter, type ModuleRef, type ModuleRegistry, type NavigateFn, type PrachtApp, type PrachtAppConfig, PrachtHttpError, type PrachtHydrationState, type PrachtRuntimeDiagnosticPhase, type PrachtRuntimeDiagnostics, PrachtRuntimeProvider, type PrefetchStrategy, type PrerenderAppOptions, type PrerenderAppResult, type PrerenderResult, type Register, type RenderMode, type ResolvedApiRoute, type ResolvedPrachtApp, type ResolvedRoute, type RouteComponentProps, type RouteConfig, type RouteDefinition, type RouteMatch, type RouteMeta, type RouteModule, type RouteParams, type RouteRevalidate, type RouteStateResult, type RouteTreeNode, type SerializedRouteError, type ShellModule, type ShellProps, type StartAppOptions, Suspense, type TimeRevalidatePolicy, applyDefaultSecurityHeaders, buildPathFromSegments, defineApp, forwardRef, group, handlePrachtRequest, initClientRouter, lazy, matchApiRoute, matchAppRoute, prerenderApp, readHydrationState, resolveApiRoutes, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRevalidateRoute, useRouteData };
+export { type ApiConfig, type ApiRouteArgs, type ApiRouteHandler, type ApiRouteMatch, type ApiRouteModule, type BaseRouteArgs, type DataModule, type ErrorBoundaryProps, Form, type FormProps, type GroupDefinition, type GroupMeta, type HandlePrachtRequestOptions, type HeadArgs, type HeadMetadata, type HeadersArgs, type HttpMethod, type ISGManifestEntry, type InitClientRouterOptions, type LoaderArgs, type LoaderData, type LoaderFn, type Location, type MiddlewareArgs, type MiddlewareFn, type MiddlewareModule, type MiddlewareResult, type ModuleImporter, type ModuleRef, type ModuleRegistry, type NavigateFn, type PrachtApp, type PrachtAppConfig, PrachtHttpError, type PrachtHydrationState, type PrachtRuntimeDiagnosticPhase, type PrachtRuntimeDiagnostics, PrachtRuntimeProvider, type PrefetchStrategy, type PrerenderAppOptions, type PrerenderAppResult, type PrerenderResult, type Register, type RenderMode, type ResolvedApiRoute, type ResolvedPrachtApp, type ResolvedRoute, type RouteComponentProps, type RouteConfig, type RouteDefinition, type RouteMatch, type RouteMeta, type RouteModule, type RouteParams, type RouteRevalidate, type RouteStateResult, type RouteTreeNode, type SerializedRouteError, type ShellModule, type ShellProps, type StartAppOptions, Suspense, type TimeRevalidatePolicy, applyDefaultSecurityHeaders, buildPathFromSegments, defineApp, forwardRef, group, handlePrachtRequest, initClientRouter, lazy, matchApiRoute, matchAppRoute, prerenderApp, readHydrationState, resolveApiRoutes, resolveApp, route, startApp, timeRevalidate, useIsHydrated, useLocation, useNavigate, useParams, useRevalidate, useRouteData };