@timber-js/app 0.1.0

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// timber.js CLI\n//\n// Wraps Vite commands with timber-specific behavior.\n// See design/18-build-system.md §\"CLI\".\n//\n// Commands:\n//   timber dev      — Start Vite dev server with HMR\n//   timber build    — Run multi-environment build via createBuilder/buildApp\n//   timber preview  — Serve the production build\n//   timber check    — Validate types + routes without building\n\nconst COMMANDS = ['dev', 'build', 'preview', 'check'] as const;\ntype Command = (typeof COMMANDS)[number];\n\nexport interface ParsedArgs {\n  command: Command;\n  config: string | undefined;\n}\n\nexport interface CommandOptions {\n  config?: string;\n}\n\n/**\n * Parse CLI arguments into a structured command + options.\n * Accepts: timber <command> [--config|-c <path>]\n */\nexport function parseArgs(args: string[]): ParsedArgs {\n  if (args.length === 0) {\n    throw new Error(\n      'No command provided. Usage: timber <dev|build|preview|check> [--config <path>]'\n    );\n  }\n\n  const command = args[0];\n  if (!COMMANDS.includes(command as Command)) {\n    throw new Error(`Unknown command: ${command}. Available commands: ${COMMANDS.join(', ')}`);\n  }\n\n  let config: string | undefined;\n  for (let i = 1; i < args.length; i++) {\n    if (args[i] === '--config' || args[i] === '-c') {\n      config = args[++i];\n      if (!config) {\n        throw new Error('--config requires a path argument');\n      }\n    }\n  }\n\n  return { command: command as Command, config };\n}\n\n// ─── Command Implementations ─────────────────────────────────────────────────\n\n/**\n * Start the Vite dev server.\n * Middleware re-runs on file change via HMR wiring in timber-routing.\n */\nexport async function runDev(options: CommandOptions): Promise<void> {\n  const { createServer } = await import('vite');\n  const server = await createServer({\n    configFile: options.config,\n  });\n  await server.listen();\n  server.printUrls();\n}\n\n/**\n * Run the production build using createBuilder + buildApp.\n * Direct build() calls do NOT trigger the RSC plugin's multi-environment\n * pipeline — createBuilder/buildApp is required.\n */\nexport async function runBuild(options: CommandOptions): Promise<void> {\n  const { createBuilder } = await import('vite');\n  const builder = await createBuilder({\n    configFile: options.config,\n  });\n  await builder.buildApp();\n}\n\n/**\n * Determine whether to use the adapter's preview or Vite's built-in preview.\n * Exported for testing — the actual runPreview function uses this internally.\n */\nexport function resolvePreviewStrategy(\n  adapter: import('./adapters/types').TimberPlatformAdapter | undefined\n): 'adapter' | 'vite' {\n  if (adapter && typeof adapter.preview === 'function') {\n    return 'adapter';\n  }\n  return 'vite';\n}\n\n/**\n * Load timber.config.ts from the project root.\n * Returns the config object with adapter, output, etc.\n * Returns null if no config file is found.\n */\nasync function loadTimberConfig(\n  root: string\n): Promise<{ adapter?: import('./adapters/types').TimberPlatformAdapter; output?: string } | null> {\n  const { existsSync } = await import('node:fs');\n  const { join } = await import('node:path');\n  const { pathToFileURL } = await import('node:url');\n\n  const configNames = ['timber.config.ts', 'timber.config.js', 'timber.config.mjs'];\n\n  for (const name of configNames) {\n    const configPath = join(root, name);\n    if (existsSync(configPath)) {\n      // Use Vite's built-in config loading to handle TypeScript\n      const mod = await import(pathToFileURL(configPath).href);\n      return mod.default ?? mod;\n    }\n  }\n  return null;\n}\n\n/**\n * Serve the production build for local testing.\n * If the adapter provides a preview() method, it takes priority.\n * Otherwise falls back to Vite's built-in preview server.\n */\nexport async function runPreview(options: CommandOptions): Promise<void> {\n  const { join } = await import('node:path');\n\n  // Try to load timber config for adapter-specific preview\n  const root = process.cwd();\n  const config = await loadTimberConfig(root).catch(() => null);\n  const adapter = config?.adapter as import('./adapters/types').TimberPlatformAdapter | undefined;\n\n  if (resolvePreviewStrategy(adapter) === 'adapter') {\n    const buildDir = join(root, '.timber', 'build');\n    const timberConfig = { output: (config?.output ?? 'server') as 'server' | 'static' };\n    await adapter!.preview!(timberConfig, buildDir);\n    return;\n  }\n\n  // Fallback: Vite's built-in preview server\n  const { preview } = await import('vite');\n  const server = await preview({\n    configFile: options.config,\n  });\n  server.printUrls();\n}\n\n/**\n * Validate types and routes without producing build output.\n * Runs tsgo --noEmit for type checking.\n */\nexport async function runCheck(options: CommandOptions): Promise<void> {\n  const { execFile } = await import('node:child_process');\n\n  await new Promise<void>((resolve, reject) => {\n    const configArgs = options.config ? ['--project', options.config] : [];\n    execFile('tsgo', ['--noEmit', ...configArgs], (err, stdout, stderr) => {\n      if (stdout) process.stdout.write(stdout);\n      if (stderr) process.stderr.write(stderr);\n      if (err) {\n        reject(new Error(`Type check failed with exit code ${err.code}`));\n      } else {\n        resolve();\n      }\n    });\n  });\n}\n\n// ─── Main Entry Point ────────────────────────────────────────────────────────\n\nasync function main(): Promise<void> {\n  const parsed = parseArgs(process.argv.slice(2));\n  const options: CommandOptions = { config: parsed.config };\n\n  switch (parsed.command) {\n    case 'dev':\n      await runDev(options);\n      break;\n    case 'build':\n      await runBuild(options);\n      break;\n    case 'preview':\n      await runPreview(options);\n      break;\n    case 'check':\n      await runCheck(options);\n      break;\n  }\n}\n\n// Only run main when executed directly (not imported in tests)\nconst isDirectExecution =\n  typeof process !== 'undefined' && process.argv[1] && import.meta.url.endsWith(process.argv[1]);\n\nif (isDirectExecution) {\n  main().catch((err) => {\n    console.error(err.message);\n    process.exit(1);\n  });\n}\n"],"mappings":"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"}

package/dist/client/browser-entry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Browser Entry — Client-side hydration and navigation bootstrap.
+ *
+ * This is a real TypeScript file, not codegen. It initializes the
+ * client navigation runtime: segment router, prefetch cache, and
+ * history stack.
+ *
+ * Hydration works by:
+ * 1. Decoding the RSC payload embedded in the initial HTML response
+ *    via createFromReadableStream from @vitejs/plugin-rsc/browser
+ * 2. Hydrating the decoded React tree via hydrateRoot
+ * 3. Setting up client-side navigation for subsequent page transitions
+ *
+ * After hydration, the browser entry:
+ * - Intercepts clicks on <a data-timber-link> for SPA navigation
+ * - Listens for mouseenter on <a data-timber-prefetch> for hover prefetch
+ * - Listens for popstate events for back/forward navigation
+ *
+ * Design docs: 18-build-system.md §"Entry Files", 19-client-navigation.md
+ */
+export {};
+//# sourceMappingURL=browser-entry.d.ts.map

package/dist/client/browser-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-entry.d.ts","sourceRoot":"","sources":["../../src/client/browser-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/client/error-boundary.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Framework-injected React error boundary.
+ *
+ * Catches errors thrown by children and renders a fallback component
+ * with the appropriate props based on error type:
+ *   - DenySignal (4xx) → { status, dangerouslyPassData }
+ *   - RenderError (5xx) → { error, digest, reset }
+ *   - Unhandled error → { error, digest: null, reset }
+ *
+ * The `status` prop controls which errors this boundary catches:
+ *   - Specific code (e.g. 403) → only that status
+ *   - Category (400) → any 4xx
+ *   - Category (500) → any 5xx
+ *   - Omitted → catches everything (error.tsx behavior)
+ *
+ * See design/10-error-handling.md §"Status-Code Files"
+ */
+import { Component, type ReactNode } from 'react';
+export interface TimberErrorBoundaryProps {
+    /** The component to render when an error is caught. */
+    fallbackComponent: (...args: unknown[]) => ReactNode;
+    /**
+     * Status code filter. If set, only catches errors matching this status.
+     * 400 = any 4xx, 500 = any 5xx, specific number = exact match.
+     */
+    status?: number;
+    children: ReactNode;
+}
+interface TimberErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+export declare class TimberErrorBoundary extends Component<TimberErrorBoundaryProps, TimberErrorBoundaryState> {
+    constructor(props: TimberErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): TimberErrorBoundaryState;
+    componentDidUpdate(prevProps: TimberErrorBoundaryProps): void;
+    /** Reset the error state so children re-render. */
+    private reset;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/client/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../src/client/error-boundary.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA4CjE,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,iBAAiB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,SAAS,CAAC;IACrD;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,UAAU,wBAAwB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAID,qBAAa,mBAAoB,SAAQ,SAAS,CAChD,wBAAwB,EACxB,wBAAwB,CACzB;gBACa,KAAK,EAAE,wBAAwB;IAK3C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,wBAAwB;IAWvE,kBAAkB,CAAC,SAAS,EAAE,wBAAwB,GAAG,IAAI;IAS7D,mDAAmD;IACnD,OAAO,CAAC,KAAK,CAEX;IAEF,MAAM,IAAI,SAAS;CA2CpB"}

package/dist/client/form.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Client-side form utilities for server actions.
+ *
+ * Exports a typed `useActionState` that understands the action builder's result shape.
+ * Result is typed to:
+ *   { data: T } | { validationErrors: Record<string, string[]> } | { serverError: { code, data? } } | null
+ *
+ * The action builder emits a function that satisfies both the direct call signature
+ * and React's `(prevState, formData) => Promise<State>` contract.
+ *
+ * See design/08-forms-and-actions.md §"Client-Side Form Mechanics"
+ */
+import type { ActionResult, ValidationErrors } from '#/server/action-client';
+import type { FormFlashData } from '#/server/form-flash';
+/**
+ * The action function type accepted by useActionState.
+ * Must satisfy React's (prevState, formData) => Promise<State> contract.
+ */
+export type UseActionStateFn<TData> = (prevState: ActionResult<TData> | null, formData: FormData) => Promise<ActionResult<TData>>;
+/**
+ * Return type of useActionState — matches React 19's useActionState return.
+ * [result, formAction, isPending]
+ */
+export type UseActionStateReturn<TData> = [
+    result: ActionResult<TData> | null,
+    formAction: (formData: FormData) => void,
+    isPending: boolean
+];
+/**
+ * Typed wrapper around React 19's `useActionState` that understands
+ * the timber action builder's result shape.
+ *
+ * @param action - A server action created with createActionClient or a raw 'use server' function.
+ * @param initialState - Initial state, typically `null`. Pass `getFormFlash()` for no-JS
+ *   progressive enhancement — the flash seeds the initial state so the form has a
+ *   single source of truth for both with-JS and no-JS paths.
+ * @param permalink - Optional permalink for progressive enhancement (no-JS fallback URL).
+ *
+ * @example
+ * ```tsx
+ * 'use client'
+ * import { useActionState } from '@timber/app/client'
+ * import { createTodo } from './actions'
+ *
+ * export function NewTodoForm({ flash }) {
+ *   const [result, action, isPending] = useActionState(createTodo, flash)
+ *   return (
+ *     <form action={action}>
+ *       <input name="title" />
+ *       {result?.validationErrors?.title && <p>{result.validationErrors.title}</p>}
+ *       <button disabled={isPending}>Add</button>
+ *     </form>
+ *   )
+ * }
+ * ```
+ */
+export declare function useActionState<TData>(action: UseActionStateFn<TData>, initialState: ActionResult<TData> | FormFlashData | null, permalink?: string): UseActionStateReturn<TData>;
+/**
+ * Hook for calling a server action imperatively (not via a form).
+ * Returns [execute, isPending] where execute accepts the input directly.
+ *
+ * @example
+ * ```tsx
+ * const [deleteTodo, isPending] = useFormAction(deleteTodoAction)
+ * <button onClick={() => deleteTodo({ id: todo.id })} disabled={isPending}>
+ *   Delete
+ * </button>
+ * ```
+ */
+export declare function useFormAction<TData>(action: (input: unknown) => Promise<ActionResult<TData>>): [(input?: unknown) => Promise<ActionResult<TData>>, boolean];
+/** Return type of useFormErrors(). */
+export interface FormErrorsResult {
+    /** Per-field validation errors keyed by field name. */
+    fieldErrors: Record<string, string[]>;
+    /** Form-level errors (from `_root` key). */
+    formErrors: string[];
+    /** Server error if the action threw an ActionError. */
+    serverError: {
+        code: string;
+        data?: Record<string, unknown>;
+    } | null;
+    /** Whether any errors are present. */
+    hasErrors: boolean;
+    /** Get the first error message for a field, or null. */
+    getFieldError: (field: string) => string | null;
+}
+/**
+ * Extract per-field and form-level errors from an ActionResult.
+ *
+ * Pure function (no internal hooks) — follows React naming convention
+ * since it's used in render. Accepts the result from `useActionState`
+ * or flash data from `getFormFlash()`.
+ *
+ * @example
+ * ```tsx
+ * const [result, action, isPending] = useActionState(createTodo, null)
+ * const errors = useFormErrors(result)
+ *
+ * return (
+ *   <form action={action}>
+ *     <input name="title" />
+ *     {errors.getFieldError('title') && <p>{errors.getFieldError('title')}</p>}
+ *     {errors.formErrors.map(e => <p key={e}>{e}</p>)}
+ *   </form>
+ * )
+ * ```
+ */
+export declare function useFormErrors<TData>(result: ActionResult<TData> | {
+    validationErrors?: ValidationErrors;
+    serverError?: {
+        code: string;
+        data?: Record<string, unknown>;
+    };
+} | null): FormErrorsResult;
+//# sourceMappingURL=form.d.ts.map

package/dist/client/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/client/form.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,KAAK,IAAI,CACpC,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI,EACrC,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,KAAK,IAAI;IACxC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI;IAClC,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI;IACxC,SAAS,EAAE,OAAO;CACnB,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAClC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAC/B,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,aAAa,GAAG,IAAI,EACxD,SAAS,CAAC,EAAE,MAAM,GACjB,oBAAoB,CAAC,KAAK,CAAC,CAI7B;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EACjC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GACvD,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAa9D;AAID,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,4CAA4C;IAC5C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,uDAAuD;IACvD,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACrE,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EACjC,MAAM,EACF,YAAY,CAAC,KAAK,CAAC,GACnB;IACE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAChE,GACD,IAAI,GACP,gBAAgB,CA6ClB"}

package/dist/client/head.d.ts

@@ -0,0 +1,16 @@
+/** A rendered head element descriptor (matches server-side HeadElement from metadata.ts). */
+export interface HeadElement {
+    tag: 'title' | 'meta' | 'link';
+    content?: string;
+    attrs?: Record<string, string>;
+}
+/**
+ * Apply resolved head elements to the DOM.
+ *
+ * - Sets document.title for <title> elements
+ * - Creates <meta> and <link> tags with a data-timber-head marker
+ * - Removes previous timber-managed tags to prevent accumulation
+ * - Replaces existing SSR-rendered tags with the same name/property
+ */
+export declare function applyHeadElements(elements: HeadElement[]): void;
+//# sourceMappingURL=head.d.ts.map

package/dist/client/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../src/client/head.ts"],"names":[],"mappings":"AAaA,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CA8B/D"}

package/dist/client/history.d.ts

@@ -0,0 +1,29 @@
+import type { HeadElement } from './head';
+export interface HistoryEntry {
+    /** The complete segment tree payload at the time of navigation */
+    payload: unknown;
+    /** Resolved head elements for this page (title, meta tags). Null for SSR'd initial page. */
+    headElements?: HeadElement[] | null;
+    /** Route params for this page (for useParams). Null for SSR'd initial page. */
+    params?: Record<string, string | string[]> | null;
+}
+/**
+ * Session-lived history stack keyed by URL. Enables instant back/forward
+ * navigation without a server roundtrip.
+ *
+ * On forward navigation, the new page's payload is pushed onto the stack.
+ * On popstate, the cached payload is replayed instantly.
+ *
+ * Scroll positions are stored in history.state (browser History API),
+ * not in this stack — see design/19-client-navigation.md §Scroll Restoration.
+ *
+ * Entries persist for the session duration (no expiry) and are cleared
+ * when the tab is closed — matching browser back-button behavior.
+ */
+export declare class HistoryStack {
+    private entries;
+    push(url: string, entry: HistoryEntry): void;
+    get(url: string): HistoryEntry | undefined;
+    has(url: string): boolean;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/client/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/client/history.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI1C,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACpC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CACnD;AAID;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAmC;IAElD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAI5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG1B"}

package/dist/client/index.d.ts

@@ -0,0 +1,32 @@
+export type { RenderErrorDigest } from './types';
+export { Link, interpolateParams, resolveHref, validateLinkHref, buildLinkProps } from './link';
+export type { LinkProps, LinkPropsWithHref, LinkPropsWithParams } from './link';
+export type { OnNavigateHandler, OnNavigateEvent } from './link-navigate-interceptor';
+export { createRouter } from './router';
+export type { RouterInstance, NavigationOptions, RouterDeps, RscDecoder, RootRenderer, } from './router';
+export { useNavigationPending } from './use-navigation-pending';
+export { useLinkStatus, LinkStatusContext } from './use-link-status';
+export type { LinkStatus } from './use-link-status';
+export { getRouter } from './router-ref';
+export { useRouter } from './use-router';
+export type { AppRouterInstance } from './use-router';
+export { usePathname } from './use-pathname';
+export { useSearchParams } from './use-search-params';
+export { useSelectedLayoutSegment, useSelectedLayoutSegments } from './use-selected-layout-segment';
+export { SegmentProvider, useSegmentContext } from './segment-context';
+export type { SegmentContextValue } from './segment-context';
+export { SegmentCache, PrefetchCache } from './segment-cache';
+export type { SegmentNode, StateTree } from './segment-cache';
+export { HistoryStack } from './history';
+export type { HistoryEntry } from './history';
+export { useActionState, useFormAction, useFormErrors } from './form';
+export type { UseActionStateFn, UseActionStateReturn, FormErrorsResult } from './form';
+export { useParams, setCurrentParams } from './use-params';
+export { useQueryStates, bindUseQueryStates } from './use-query-states';
+export { useCookie } from './use-cookie';
+export type { ClientCookieOptions, CookieSetter } from './use-cookie';
+export { setSsrData, clearSsrData, getSsrData } from './ssr-data';
+export type { SsrData } from './ssr-data';
+export { TimberErrorBoundary } from './error-boundary';
+export type { TimberErrorBoundaryProps } from './error-boundary';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAChG,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAGpG,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGvF,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}