vorma 0.85.0-pre.9 → 0.86.0-pre.1

package/.dist/core/_index.d.ts

@@ -0,0 +1,739 @@
+import { ReadonlySignal } from "@preact/signals";
+
+//#region packages/vorma/core/types.d.ts
+type ViewBase = {
+  params?: ReadonlyArray<string>;
+  parents?: ReadonlyArray<string>;
+  pattern: string;
+  __i?: unknown;
+  __o?: unknown;
+};
+type ResourceBase = {
+  method: string;
+  params?: ReadonlyArray<string>;
+  pattern: string;
+  kind?: ResourceKind;
+  __i?: unknown;
+  __o?: unknown;
+};
+type ResourceKind = "query" | "mutation";
+type RevalidationResult = {
+  ok: true;
+} | {
+  ok: false;
+  reason: "build_skew" | "max_retries_exhausted";
+};
+type RouteErrorState = {
+  idx: number;
+  error: unknown;
+  source: "server" | "clientLoader";
+};
+type RouteMatchState = {
+  pattern: string;
+  input: unknown;
+  viewData: unknown;
+  clientLoaderData: unknown;
+};
+type RouteState = {
+  href: string;
+  historyState: unknown;
+  clientBuildId: string;
+  params: Record<string, string>;
+  splatValues: string[];
+  matches: RouteMatchState[];
+  error: RouteErrorState | null;
+};
+type RouteUpdateReason = "boot" | "navigation" | "popstate" | "revalidation";
+type BeforeRouteTransitionArgs = {
+  trigger: Exclude<RouteUpdateReason, "boot">;
+  signal: AbortSignal;
+  current: RouteState;
+  next: RouteState;
+};
+type BeforeRouteCommitFn = (args: BeforeRouteTransitionArgs) => void | Promise<void>;
+type BeforeRouteYieldFn = (args: BeforeRouteTransitionArgs) => void | Promise<void>;
+type ApiResultBase<T> = {
+  success: true;
+  data: T;
+  response: Response;
+  revalidationPromise: Promise<RevalidationResult>;
+} | {
+  success: false;
+  error: string;
+  response?: Response;
+  revalidationPromise: Promise<RevalidationResult>;
+};
+type LinkAttributeMatchRules = {
+  skip?: false;
+  includeSearch?: boolean;
+  includeHash?: boolean;
+} | {
+  skip: true;
+  includeSearch?: never;
+  includeHash?: never;
+};
+type LinkPropsBase = {
+  prefetch?: "intent" | "none";
+  prefetchDelayMs?: number;
+  attributeMatchRules?: LinkAttributeMatchRules;
+  visitOnPointerDown?: boolean;
+  replace?: boolean;
+  scrollToTop?: boolean;
+  skipWorkIndicator?: boolean;
+};
+type AppConfig = {
+  apiMountRoot: string;
+  __vorma_views: readonly ViewBase[];
+  __vorma_resources: readonly ResourceBase[];
+};
+type AppView<A extends AppConfig> = A["__vorma_views"][number];
+type AppResource<A extends AppConfig> = A["__vorma_resources"][number];
+type ViewByPattern<A extends AppConfig, P extends string> = Extract<AppView<A>, {
+  pattern: P;
+}>;
+type ResourceByMethodAndPattern<A extends AppConfig, M extends string, P extends string> = Extract<AppResource<A>, {
+  method: M;
+  pattern: P;
+}>;
+type ResolvedResourceKind<Act> = Act extends {
+  kind: infer T extends ResourceKind;
+} ? T : Act extends {
+  method: "GET" | "HEAD";
+} ? "query" : "mutation";
+type IsSplat<P extends string> = P extends `${string}/*` ? true : false;
+type ConditionalSplat<P extends string> = IsSplat<P> extends true ? {
+  splatValues: Array<string>;
+} : {};
+type ConditionalViewParams<A extends AppConfig, P extends string> = ViewByPattern<A, P> extends {
+  params: ReadonlyArray<infer Params>;
+} ? Params extends string ? {
+  params: { [K in Params]: string };
+} : {} : {};
+type ConditionalResourceParams<Act> = Act extends {
+  params: ReadonlyArray<infer Params>;
+} ? Params extends string ? {
+  params: { [K in Params]: string };
+} : {} : {};
+type ViewParamsRecord<A extends AppConfig, P extends string> = ViewByPattern<A, P> extends {
+  params: ReadonlyArray<infer Params>;
+} ? Params extends string ? { [K in Params]: string } : Record<string, string> : Record<string, string>;
+type ViewParents<A extends AppConfig, P extends string> = ViewByPattern<A, P> extends {
+  parents: ReadonlyArray<infer Parent>;
+} ? Extract<Parent, ToViewPattern<A>> : never;
+type ViewInputWithParentViews<A extends AppConfig, P extends ToViewPattern<A>> = (P | ViewParents<A, P> extends infer Pattern ? Pattern extends ToViewPattern<A> ? (input: ToViewInput<A, Pattern>) => void : never : never) extends ((input: infer Input) => void) ? Input : never;
+type IsEmptyInput<T> = [T] extends [null | undefined] ? true : false;
+type IsUnion<T, U = T> = [T] extends [never] ? false : T extends unknown ? [U] extends [T] ? false : true : false;
+type ResourceInputField<Input> = IsEmptyInput<Input> extends true ? {
+  input?: Input;
+} : {
+  input: Input;
+};
+type ResourceMethodsForPattern<A extends AppConfig, P extends string> = Extract<AppResource<A>, {
+  pattern: P;
+}>["method"];
+type ResourceMethodField<A extends AppConfig, P extends string, M extends string> = ResourceMethodsForPattern<A, P> extends "GET" ? IsUnion<ResourceMethodsForPattern<A, P>> extends true ? {
+  method: M;
+} : {
+  method?: M;
+} : {
+  method: M;
+};
+type PermissiveViewPattern<A extends AppConfig, P extends ToViewPattern<A>> = P extends `${infer Prefix}/_index` ? P | (Prefix extends "" ? "/" : Prefix) : P;
+type ToViewPattern<A extends AppConfig> = AppView<A>["pattern"];
+type ResourceMethod<A extends AppConfig> = AppResource<A>["method"];
+type ResourcePattern<A extends AppConfig, M extends ResourceMethod<A> = ResourceMethod<A>> = Extract<AppResource<A>, {
+  method: M;
+}>["pattern"];
+type ResourcesByKind<A extends AppConfig, T extends ResourceKind> = AppResource<A> extends infer Route ? Route extends unknown ? ResolvedResourceKind<Route> extends T ? Route : never : never : never;
+type ResourceMethodByKind<A extends AppConfig, T extends ResourceKind> = ResourcesByKind<A, T> extends infer Route ? Route extends {
+  method: infer M extends string;
+} ? M : never : never;
+type ResourcePatternByKind<A extends AppConfig, T extends ResourceKind, M extends ResourceMethodByKind<A, T> = ResourceMethodByKind<A, T>> = Extract<ResourcesByKind<A, T>, {
+  method: M;
+}> extends infer Route ? Route extends {
+  pattern: infer P extends string;
+} ? P : never : never;
+type ResourceByKindMethodAndPattern<A extends AppConfig, T extends ResourceKind, M extends ResourceMethodByKind<A, T>, P extends ResourcePatternByKind<A, T, M>> = Extract<ResourcesByKind<A, T>, {
+  method: M;
+  pattern: P;
+}>;
+type ToQueryMethod<A extends AppConfig> = ResourceMethodByKind<A, "query">;
+type ToQueryPattern<A extends AppConfig, M extends ToQueryMethod<A> = ToQueryMethod<A>> = ResourcePatternByKind<A, "query", M>;
+type ToMutationMethod<A extends AppConfig> = ResourceMethodByKind<A, "mutation">;
+type ToMutationPattern<A extends AppConfig, M extends ToMutationMethod<A> = ToMutationMethod<A>> = ResourcePatternByKind<A, "mutation", M>;
+type ToViewOutput<A extends AppConfig, P extends ToViewPattern<A>> = ViewByPattern<A, P> extends {
+  __o: infer O;
+} ? O : never;
+type ToViewInput<A extends AppConfig, P extends ToViewPattern<A>> = ViewByPattern<A, P> extends {
+  __i: infer I;
+} ? I : never;
+type ToQueryInput<A extends AppConfig, M extends ToQueryMethod<A>, P extends ToQueryPattern<A, M>> = ResourceByKindMethodAndPattern<A, "query", M, P> extends {
+  __i: infer I;
+} ? I : never;
+type ToQueryOutput<A extends AppConfig, M extends ToQueryMethod<A>, P extends ToQueryPattern<A, M>> = ResourceByKindMethodAndPattern<A, "query", M, P> extends {
+  __o: infer O;
+} ? O : never;
+type ToMutationInput<A extends AppConfig, M extends ToMutationMethod<A>, P extends ToMutationPattern<A, M>> = ResourceByKindMethodAndPattern<A, "mutation", M, P> extends {
+  __i: infer I;
+} ? I : never;
+type ToMutationOutput<A extends AppConfig, M extends ToMutationMethod<A>, P extends ToMutationPattern<A, M>> = ResourceByKindMethodAndPattern<A, "mutation", M, P> extends {
+  __o: infer O;
+} ? O : never;
+type ToRouteDestination<A extends AppConfig, P extends ToViewPattern<A>> = {
+  href?: never;
+  pattern: PermissiveViewPattern<A, P>;
+  search?: ViewInputWithParentViews<A, P>;
+  hash?: string;
+} & ConditionalViewParams<A, P> & ConditionalSplat<P>;
+type ToNavigationTarget<A extends AppConfig, P extends ToViewPattern<A>> = {
+  href: string;
+  pattern?: never;
+  params?: never;
+  splatValues?: never;
+  search?: never;
+  hash?: never;
+} | ToRouteDestination<A, P>;
+type ToNavigateArgs<A extends AppConfig, P extends ToViewPattern<A>> = ToNavigationTarget<A, P> & {
+  replace?: boolean;
+  scrollToTop?: boolean;
+  state?: unknown;
+  skipWorkIndicator?: boolean;
+};
+type ToRouteSyncArgs<A extends AppConfig, P extends ToViewPattern<A>> = ToRouteDestination<A, P> & {
+  enabled?: boolean;
+  debounceMs?: number;
+  replace?: boolean;
+  scrollToTop?: boolean;
+};
+type ApiClientArgsForResource<A extends AppConfig, Act> = Act extends {
+  method: infer M;
+  pattern: infer P;
+  __i?: infer Input;
+} ? M extends ResourceMethod<A> ? P extends ResourcePattern<A, M> ? Omit<RequestInit, "body" | "method"> & {
+  dedupeKey?: string;
+  pattern: P;
+  revalidate?: boolean;
+  skipWorkIndicator?: boolean;
+} & ResourceMethodField<A, P, M> & ConditionalResourceParams<Act> & ConditionalSplat<P> & ResourceInputField<Input> : never : never : never;
+type ApiClientArgs<A extends AppConfig> = AppResource<A> extends infer Act ? Act extends unknown ? ApiClientArgsForResource<A, Act> : never : never;
+type ApiClientArgsByKind<A extends AppConfig, T extends ResourceKind> = AppResource<A> extends infer Act ? Act extends unknown ? ResolvedResourceKind<Act> extends T ? ApiClientArgsForResource<A, Act> : never : never : never;
+type ApiClientOutput<A extends AppConfig, Args extends ApiClientArgs<A>> = Args extends {
+  method: infer M;
+  pattern: infer P;
+} ? M extends ResourceMethod<A> ? P extends ResourcePattern<A, M> ? ResourceByMethodAndPattern<A, M, P> extends {
+  __o: infer O;
+} ? O : never : never : never : Args extends {
+  pattern: infer P;
+} ? "GET" extends ResourceMethod<A> ? P extends ResourcePattern<A, "GET"> ? ResourceByMethodAndPattern<A, "GET", P> extends {
+  __o: infer O;
+} ? O : never : never : never : never;
+type ToQueryArgs<A extends AppConfig> = ApiClientArgsByKind<A, "query">;
+type ToQueryError<A extends AppConfig, Args extends ToQueryArgs<A>> = QueryError<ApiClientOutput<A, Args>>;
+type ToMutationArgs<A extends AppConfig> = ApiClientArgsByKind<A, "mutation">;
+type ToMutationError<A extends AppConfig, Args extends ToMutationArgs<A>> = MutationError<ApiClientOutput<A, Args>>;
+type QueryResult<T> = ApiResultBase<T>;
+type MutationResult<T> = ApiResultBase<T>;
+type ToViewComponentProps<A extends AppConfig, P extends ToViewPattern<A>, ClientLoaderData = unknown> = {
+  idx: number;
+  Outlet: (local?: Record<string, unknown>) => any;
+  __phantom_pattern?: P;
+  __phantom_client_loader_data?: ClientLoaderData;
+};
+type ClientLoaderKnownMatch = {
+  pattern: string;
+  input: unknown;
+};
+type ClientLoaderServerState<A extends AppConfig, P extends ToViewPattern<A>> = {
+  clientBuildId: string;
+  matches: Array<{
+    pattern: string;
+    input: unknown;
+    viewData: unknown;
+  }>;
+  outermostServerError: null | {
+    idx: number;
+    error: unknown;
+  };
+  viewData: ToViewOutput<A, P>;
+};
+type ToClientLoaderArgs<A extends AppConfig, P extends ToViewPattern<A>> = {
+  trigger: "boot" | "navigation" | "revalidation" | "prefetch";
+  href: string;
+  historyState: unknown;
+  pattern: P;
+  params: ViewParamsRecord<A, P>;
+  splatValues: string[];
+  input: ToViewInput<A, P>;
+  knownMatches: ClientLoaderKnownMatch[];
+  serverPromise: Promise<ClientLoaderServerState<A, P>>;
+  signal: AbortSignal;
+};
+type ToDefineViewArgs<A extends AppConfig, P extends ToViewPattern<A>, T = any, Element = unknown> = {
+  pattern: P;
+  component: (props: ToViewComponentProps<A, P, T>) => Element;
+  errorBoundary?: (props: {
+    error: unknown;
+  }) => Element;
+  clientLoader?: (args: ToClientLoaderArgs<A, P>) => Promise<T>;
+  beforeRouteCommit?: BeforeRouteCommitFn;
+  beforeRouteYield?: BeforeRouteYieldFn;
+  runClientLoaderOnHmr?: boolean;
+};
+type ToLinkProps<A extends AppConfig, P extends ToViewPattern<A>> = LinkPropsBase & ToNavigationTarget<A, P> & {
+  state?: unknown;
+};
+type ToApiDecoratorContext<A extends AppConfig> = ApiClientArgs<A> extends infer Args ? Args extends ApiClientArgs<A> ? {
+  input?: Args extends {
+    input: infer Input;
+  } ? Input : Args extends {
+    input?: infer Input;
+  } ? Input : never;
+  method: Args extends {
+    method: infer M extends string;
+  } ? M : "GET";
+  pattern: Args["pattern"];
+  requestInit: Omit<RequestInit, "body" | "method">;
+} : never : never;
+type ToApiDecorator<A extends AppConfig> = (context: ToApiDecoratorContext<A>) => Omit<RequestInit, "method" | "body"> | undefined | Promise<Omit<RequestInit, "method" | "body"> | undefined>;
+type ToApiClient<A extends AppConfig> = {
+  query: <Args extends ToQueryArgs<A>>(args: Args) => Promise<QueryResult<ApiClientOutput<A, Args>>>;
+  queryOrThrow: <Args extends ToQueryArgs<A>>(args: Args) => Promise<ApiClientOutput<A, Args>>;
+  mutate: <Args extends ToMutationArgs<A>>(args: Args) => Promise<MutationResult<ApiClientOutput<A, Args>>>;
+  mutateOrThrow: <Args extends ToMutationArgs<A>>(args: Args) => Promise<ApiClientOutput<A, Args>>;
+  toIdentityArray: <Args extends ApiClientArgs<A>>(args: Args) => unknown[];
+};
+//#endregion
+//#region packages/vorma/core/api_client.d.ts
+type SubmitFn = <T>(url: string | URL, request_init?: RequestInit, options?: {
+  resourceKind?: ResourceKind;
+  dedupeKey?: string;
+  revalidate?: boolean;
+  skipWorkIndicator?: boolean;
+}) => Promise<QueryResult<T> | MutationResult<T>>;
+declare class ApiErrorBase<T = never> extends Error {
+  result: Extract<QueryResult<T> | MutationResult<T>, {
+    success: false;
+  }>;
+  constructor(result: Extract<QueryResult<T> | MutationResult<T>, {
+    success: false;
+  }>);
+}
+declare class QueryError<T = never> extends ApiErrorBase<T> {
+  constructor(result: Extract<QueryResult<T>, {
+    success: false;
+  }>);
+}
+declare class MutationError<T = never> extends ApiErrorBase<T> {
+  constructor(result: Extract<MutationResult<T>, {
+    success: false;
+  }>);
+}
+declare function create_typed_api_client<A extends AppConfig>(api_mount_root: string, submit_fn: SubmitFn, decorator?: ToApiDecorator<A>): ToApiClient<A>;
+//#endregion
+//#region packages/vorma/core/client_wasm/matcher.d.ts
+type ClientMatcherNestedMatch = {
+  params: Record<string, string>;
+  splat_values: string[];
+  patterns: string[];
+};
+type ClientMatcher = {
+  register_pattern: (pattern: string) => void;
+  find_nested_matches: (path: string) => ClientMatcherNestedMatch | null;
+  free: () => void;
+};
+//#endregion
+//#region packages/vorma/core/constants.d.ts
+declare const DATA_SCRIPT_ID = "vorma-data-json";
+declare const BUILD_ID_HEADER = "X-Vorma-Client-Build-Id";
+declare const LINK_ACTIVE_EXACT_ATTR = "data-vorma-active-exact";
+declare const LINK_ACTIVE_ANCESTOR_ATTR = "data-vorma-active-ancestor";
+declare const LINK_PENDING_EXACT_ATTR = "data-vorma-pending-exact";
+declare const LINK_PENDING_ANCESTOR_ATTR = "data-vorma-pending-ancestor";
+//#endregion
+//#region packages/vorma/.dist/kit/result/result.d.ts
+//#region packages/vorma/kit/result/result.d.ts
+type Result<T> = {
+  ok: true;
+  val: T;
+} | {
+  ok: false;
+  err: string;
+};
+//#endregion
+//#region packages/vorma/core/create_client_core.d.ts
+type ScrollState = {
+  x: number;
+  y: number;
+} | {
+  hash: string;
+};
+type ScrollIntent = {
+  scroll: ScrollState;
+  target_entry_id: string;
+};
+type RouteRenderEntry = {
+  pattern: string;
+  input: unknown;
+  module_url: string;
+  module: Record<string, unknown>;
+  view_data: unknown;
+  client_loader_data: unknown;
+};
+type RouteRenderState = {
+  entries: RouteRenderEntry[];
+  error: RouteErrorState | null;
+  params: Record<string, string>;
+  splat_values: string[];
+  client_build_id: string;
+  history_state: unknown;
+};
+type WorkState = {
+  navigation: null | {
+    href: string;
+    replace: boolean;
+    source: "navigate" | "popstate" | "redirect";
+  };
+  revalidation: null | {
+    status: "debouncing" | "running" | "retrying";
+    attempt: number;
+  };
+  prefetch: null | {
+    href: string;
+  };
+  apiRequests: Array<{
+    key: string;
+    method: string;
+    href: string;
+  }>;
+};
+type RevalidationReason = "manual" | "retry" | "apiRequest" | "windowFocus";
+type BuildSkewDetectedEvent = {
+  activeClientBuildId: string;
+  serverBuildId: string;
+  triggeringResponse: {
+    kind: "route";
+    trigger: "navigation" | "popstate" | "prefetch";
+    requestedHref: string;
+    status: number;
+    ok: boolean;
+  } | {
+    kind: "route";
+    trigger: "revalidation";
+    revalidationReason: RevalidationReason;
+    requestedHref: string;
+    status: number;
+    ok: boolean;
+  } | {
+    kind: "resource";
+    resourceKind: ResourceKind;
+    requestedHref: string;
+    method: string;
+    status: number;
+    ok: boolean;
+  };
+  currentRouteState: RouteState;
+  currentWorkState: WorkState;
+};
+type WorkIndicator = {
+  track: <T>(promise: PromiseLike<T>) => Promise<T>;
+  isActive: () => boolean;
+};
+type WorkIndicatorOptions = {
+  start: () => void;
+  stop: () => void;
+  startDelayMs?: number;
+  stopDelayMs?: number;
+  skipNavigations?: boolean;
+  skipApiRequests?: boolean;
+  skipRevalidations?: boolean;
+};
+type ClientOptions = {
+  render?: () => void | Promise<void>;
+  workIndicator?: WorkIndicatorOptions;
+  revalidateOnWindowFocus?: boolean | {
+    staleTimeMs: number;
+    skipWorkIndicator?: boolean;
+  };
+  defaultErrorBoundary?: (props: {
+    error: unknown;
+  }) => any;
+  useViewTransitions?: boolean;
+  onRouteUpdate?: (route: RouteState, previousRoute: RouteState | null, reason: RouteUpdateReason) => void;
+  onWorkUpdate?: (work: WorkState) => void;
+  onBuildSkewDetected?: (event: BuildSkewDetectedEvent) => void;
+};
+type ClientCommit = {
+  route_render?: {
+    state: RouteRenderState;
+    scroll_intent?: ScrollIntent;
+  };
+  route_update?: {
+    previous_route: RouteState | null;
+    reason: RouteUpdateReason;
+    route: RouteState;
+  };
+  work?: WorkState;
+};
+type CommitFn = (commit: ClientCommit) => void;
+type ViewDefinition = {
+  pattern: string;
+  component: (props: any) => any;
+  error_boundary?: (props: {
+    error: unknown;
+  }) => any;
+  client_loader?: ClientLoaderFn;
+  before_route_commit?: BeforeRouteCommitFn;
+  before_route_yield?: BeforeRouteYieldFn;
+};
+type ClientLoaderFn = (args: {
+  trigger: "boot" | "navigation" | "revalidation" | "prefetch";
+  href: string;
+  historyState: unknown;
+  pattern: string;
+  params: Record<string, string>;
+  splatValues: string[];
+  input: unknown;
+  knownMatches: ClientLoaderKnownMatch$1[];
+  serverPromise: Promise<ClientLoaderServerState$1>;
+  signal: AbortSignal;
+}) => Promise<unknown>;
+type ClientLoaderKnownMatch$1 = {
+  pattern: string;
+  input: unknown;
+};
+type ClientLoaderServerState$1 = {
+  clientBuildId: string;
+  matches: Array<{
+    pattern: string;
+    input: unknown;
+    viewData: unknown;
+  }>;
+  outermostServerError: null | {
+    idx: number;
+    error: unknown;
+  };
+  viewData: unknown;
+};
+type ApiResult<T> = {
+  success: true;
+  data: T;
+  response: Response;
+  revalidationPromise: Promise<RevalidationResult>;
+} | {
+  success: false;
+  error: string;
+  response?: Response;
+  revalidationPromise: Promise<RevalidationResult>;
+};
+type ClientCore = {
+  boot: (options: ClientOptions) => Promise<Result<void>>;
+  workIndicator: WorkIndicator;
+  navigate: (href: string | URL, options?: {
+    replace?: boolean;
+    scrollToTop?: boolean;
+    state?: unknown;
+    skipWorkIndicator?: boolean;
+  }) => Promise<{
+    didNavigate: boolean;
+  }>;
+  revalidate: () => Promise<RevalidationResult>;
+  submit_inner: <T = unknown>(url: string | URL, requestInit?: RequestInit, options?: {
+    resourceKind?: ResourceKind;
+    dedupeKey?: string;
+    revalidate?: boolean;
+    skipWorkIndicator?: boolean;
+  }) => Promise<ApiResult<T>>;
+  getRouteState: () => RouteState;
+  getWorkState: () => WorkState;
+  getClientBuildId: () => string;
+  getRootEl: () => HTMLElement;
+  defineView: <T = any>(input: {
+    pattern: string;
+    component: (props: any) => any;
+    errorBoundary?: (props: {
+      error: unknown;
+    }) => any;
+    clientLoader?: (props: any) => Promise<T>;
+    beforeRouteCommit?: BeforeRouteCommitFn;
+    beforeRouteYield?: BeforeRouteYieldFn;
+    runClientLoaderOnHmr?: boolean;
+  }) => ViewDefinition & {
+    __phantom_client_loader_data?: T;
+  };
+  start_prefetch: (href: string) => void;
+  stop_prefetch: (href: string) => void;
+  save_current_scroll: () => void;
+  get_default_error_boundary: () => ((props: {
+    error: unknown;
+  }) => any) | undefined;
+};
+type TestOptions = {
+  reload?: () => void;
+  hard_redirect?: (url: string) => void;
+  scroll_to?: (x: number, y: number) => void;
+};
+declare function apply_scroll(scroll: ScrollState | undefined, test_options?: TestOptions): void;
+declare function make_entry_id(idx: number, pattern: string): string;
+declare function create_client_core(_: Omit<AppConfig, "__vorma_views" | "__vorma_resources">, commit: CommitFn, test_options?: TestOptions): Result<ClientCore>;
+declare global {
+  interface Window {
+    __vorma_hmr_view_update?: (raw_url: string, mod: Record<string, unknown>) => Promise<void>;
+  }
+}
+//#endregion
+//#region packages/vorma/core/make_link_props.d.ts
+type LinkRouteState = {
+  href: string;
+  matched_patterns: string[];
+};
+type LinkWorkState = {
+  navigation_href: string | null;
+};
+type LinkPropsResult = {
+  is_external: boolean;
+  anchor_props: Record<string, unknown>;
+  onClick?: (e: unknown) => void;
+  onPointerDown?: (e: unknown) => void;
+  onPointerEnter?: (e: unknown) => void;
+  onFocus?: (e: unknown) => void;
+  onPointerLeave?: (e: unknown) => void;
+  onBlur?: (e: unknown) => void;
+  onTouchCancel?: (e: unknown) => void;
+};
+type LinkNavFns = {
+  navigate: (args: {
+    href: string;
+    replace?: boolean;
+    scrollToTop?: boolean;
+    skipWorkIndicator?: boolean;
+    state?: unknown;
+  }) => Promise<{
+    didNavigate: boolean;
+  }>;
+  start_prefetch: (href: string) => void;
+  stop_prefetch: (href: string) => void;
+  save_current_scroll: () => void;
+  register_link_pattern: (pattern: string) => void;
+  get_link_state_version: () => number;
+  subscribe_link_state: (listener: () => void) => () => void;
+  get_link_attribute_state: (href: string, match_rules: LinkPropsBase["attributeMatchRules"], route_state: LinkRouteState | null, work_state: LinkWorkState) => {
+    active_exact: boolean;
+    active_ancestor: boolean;
+    pending_exact: boolean;
+    pending_ancestor: boolean;
+  };
+};
+declare function select_link_route_state(route: RouteState): LinkRouteState;
+declare function select_link_work_state(work: WorkState): LinkWorkState;
+declare function make_link_props(props: Record<string, unknown>, nav: LinkNavFns, route_state?: LinkRouteState | null, work_state?: LinkWorkState): LinkPropsResult;
+//#endregion
+//#region packages/vorma/core/resolve_outlet_slot.d.ts
+type OutletSlot = {
+  kind: "component";
+  component: (props: any) => any;
+} | {
+  kind: "error";
+  error: unknown;
+  boundary: (props: {
+    error: unknown;
+  }) => any;
+} | {
+  kind: "pass_through";
+} | {
+  kind: "empty";
+};
+declare function resolve_outlet_slot(entries: RouteRenderEntry[], error: RouteErrorState | null, idx: number, default_error_boundary: ((props: {
+  error: unknown;
+}) => any) | undefined): OutletSlot;
+declare function get_entry_key(entry: RouteRenderEntry): string;
+//#endregion
+//#region packages/vorma/core/ui_adapter_core.d.ts
+type ClientMatcherFactory = () => Promise<ClientMatcher>;
+type DecomposedState = {
+  entries: RouteRenderEntry[];
+  error: RouteErrorState | null;
+  views_data: unknown[];
+  client_loaders_data: unknown[];
+  matched_patterns: string[];
+  import_urls: string[];
+  entry_keys: string[];
+  params: Record<string, string>;
+  splat_values: string[];
+  client_build_id: string;
+  history_state: unknown;
+};
+type DecomposedCommit = {
+  link_state_version?: number;
+  route?: RouteState;
+  route_reason?: RouteUpdateReason;
+  scroll_intent?: ScrollIntent;
+  state?: DecomposedState;
+  work?: WorkState;
+};
+type DecomposedCommitFn = (commit: DecomposedCommit) => void;
+declare function set_client_matcher_factory_for_test(factory: ClientMatcherFactory | null): () => void;
+type AdapterRenderArgs<App> = {
+  RootOutlet: App;
+  rootEl: HTMLElement;
+};
+type AdapterClientOptions<App> = Omit<ClientOptions, "render"> & {
+  render?: (args: AdapterRenderArgs<App>) => void | Promise<void>;
+};
+type AdapterBase<A extends AppConfig> = {
+  core: ClientCore;
+  nav_fns: LinkNavFns;
+  passthrough: Pick<ClientCore, "revalidate" | "getRouteState" | "getWorkState" | "workIndicator"> & {
+    navigate: <P extends ToViewPattern<A>>(args: ToNavigateArgs<A, P>) => Promise<{
+      didNavigate: boolean;
+    }>;
+    prefetch: <P extends ToViewPattern<A>>(target: ToNavigationTarget<A, P>) => void;
+    cancelPrefetch: <P extends ToViewPattern<A>>(target: ToNavigationTarget<A, P>) => void;
+    toHref: <P extends ToViewPattern<A>>(destination: ToRouteDestination<A, P>) => string;
+    apiClient: ToApiClient<A>;
+  };
+};
+declare function create_adapter_base<A extends AppConfig>(app_config: A, on_commit: DecomposedCommitFn, api_decorator?: ToApiDecorator<A>): Result<AdapterBase<A>>;
+type HookReturn<T, Mode extends "value" | "accessor" | "signal"> = Mode extends "accessor" ? () => T : Mode extends "signal" ? ReadonlySignal<T> : T;
+type StateSelector<State, Selected> = (state: State) => Selected;
+type VormaClient<A extends AppConfig, Element, AnchorProps extends object, HookReturnMode extends "value" | "accessor" | "signal" = "value"> = AdapterBase<A>["passthrough"] & {
+  boot: () => Promise<Result<void>>;
+  defineView: <P extends ToViewPattern<A>, T = any>(input: ToDefineViewArgs<A, P, T, Element>) => ViewDefinition;
+  RootOutlet: (props: {
+    idx?: number;
+  } & Record<string, unknown>) => Element | null;
+  Link: <P extends ToViewPattern<A>>(props: Omit<AnchorProps, "href"> & ToLinkProps<A, P>) => Element;
+  useRouteSync: <P extends ToViewPattern<A>>(args: ToRouteSyncArgs<A, P>) => void;
+  useRouteState: {
+    (): HookReturn<RouteState, HookReturnMode>;
+    <T>(selector: StateSelector<RouteState, T>): HookReturn<T, HookReturnMode>;
+  };
+  useWorkState: {
+    (): HookReturn<WorkState, HookReturnMode>;
+    <T>(selector: StateSelector<WorkState, T>): HookReturn<T, HookReturnMode>;
+  };
+  useViewData: <P extends ToViewPattern<A>>(args: ToViewComponentProps<A, P>) => HookReturn<ToViewOutput<A, P>, HookReturnMode>;
+  usePatternViewData: <P extends ToViewPattern<A>>(pattern: P) => HookReturn<ToViewOutput<A, P> | undefined, HookReturnMode>;
+  useClientLoaderData: <P extends ToViewPattern<A>, T>(args: ToViewComponentProps<A, P, T>) => HookReturn<T, HookReturnMode>;
+  usePatternClientLoaderData: <T>(pattern: ToViewPattern<A>) => HookReturn<T | undefined, HookReturnMode>;
+};
+//#endregion
+//#region packages/vorma/core/url.d.ts
+declare function resolve_path(type: "view" | "resource", pattern: string, params?: Record<string, string>, splat_values?: string[]): string;
+declare function to_typed_href(pattern: string, params?: Record<string, string>, splat_values?: string[], search?: unknown, hash?: string): string;
+declare function build_resource_url(api_mount_root: string, pattern: string, params?: Record<string, string>, splat_values?: string[], input?: unknown): URL;
+declare function create_typed_to_href<A extends AppConfig>(): <P extends ToViewPattern<A>>(destination: ToRouteDestination<A, P>) => string;
+declare function resolve_body(input: unknown): BodyInit | null | undefined;
+declare function create_typed_navigate<A extends AppConfig>(navigate_fn: (href: string | URL, options?: {
+  replace?: boolean;
+  scrollToTop?: boolean;
+  state?: unknown;
+  skipWorkIndicator?: boolean;
+}) => Promise<{
+  didNavigate: boolean;
+}>): <P extends ToViewPattern<A>>(args: ToNavigateArgs<A, P>) => Promise<{
+  didNavigate: boolean;
+}>;
+declare function create_typed_prefetch<A extends AppConfig>(prefetch_fn: (href: string) => void): <P extends ToViewPattern<A>>(target: ToNavigationTarget<A, P>) => void;
+//#endregion
+export { type AdapterClientOptions, type AdapterRenderArgs, type AppConfig, BUILD_ID_HEADER, type BeforeRouteCommitFn, type BeforeRouteTransitionArgs, type BeforeRouteYieldFn, type BuildSkewDetectedEvent, type ClientCommit, type ClientLoaderKnownMatch, type ClientLoaderServerState, type ClientMatcher, type ClientMatcherNestedMatch, type ClientOptions, type CommitFn, DATA_SCRIPT_ID, type DecomposedCommit, type DecomposedCommitFn, type DecomposedState, LINK_ACTIVE_ANCESTOR_ATTR, LINK_ACTIVE_EXACT_ATTR, LINK_PENDING_ANCESTOR_ATTR, LINK_PENDING_EXACT_ATTR, type LinkNavFns, type LinkPropsResult, type LinkRouteState, type LinkWorkState, MutationError, type MutationResult, type OutletSlot, QueryError, type QueryResult, type RevalidationReason, type RevalidationResult, type RouteErrorState, type RouteMatchState, type RouteRenderEntry, type RouteRenderState, type RouteState, type RouteUpdateReason, type ScrollIntent, type ScrollState, type ToApiClient, type ToApiDecorator, type ToApiDecoratorContext, type ToClientLoaderArgs, type ToDefineViewArgs, type ToLinkProps, type ToMutationArgs, type ToMutationError, type ToMutationInput, type ToMutationMethod, type ToMutationOutput, type ToMutationPattern, type ToNavigateArgs, type ToNavigationTarget, type ToQueryArgs, type ToQueryError, type ToQueryInput, type ToQueryMethod, type ToQueryOutput, type ToQueryPattern, type ToRouteDestination, type ToRouteSyncArgs, type ToViewComponentProps, type ToViewInput, type ToViewOutput, type ToViewPattern, type ViewDefinition, type VormaClient, type WorkIndicator, type WorkIndicatorOptions, type WorkState, apply_scroll, build_resource_url, create_adapter_base, create_client_core, create_typed_api_client, create_typed_navigate, create_typed_prefetch, create_typed_to_href, get_entry_key, make_entry_id, make_link_props, resolve_body, resolve_outlet_slot, resolve_path, select_link_route_state, select_link_work_state, set_client_matcher_factory_for_test, to_typed_href };
+//# sourceMappingURL=_index.d.ts.map