@timber-js/app 0.2.0-alpha.12 → 0.2.0-alpha.121

package/dist/index.d.ts

@@ -1,202 +1,23 @@
-import type { PluginOption } from 'vite';
-import type { RouteTree } from './routing/types';
-import type { BuildManifest } from './server/build-manifest';
-import type { StartupTimer } from './utils/startup-timer';
-/** Configuration for client-side JavaScript output. */
-export interface ClientJavascriptConfig {
-    /** When true, no client JS bundles are emitted or referenced in HTML. */
-    disabled: boolean;
-    /**
-     * When `disabled` is true, still inject the Vite HMR client in dev mode
-     * so hot reloading works during development. Default: true.
-     */
-    enableHMRInDev?: boolean;
-}
-/** Fully resolved client JavaScript configuration (no optionals). */
-export interface ResolvedClientJavascript {
-    disabled: boolean;
-    enableHMRInDev: boolean;
-}
-export interface TimberUserConfig {
-    output?: 'server' | 'static';
-    /**
-     * Enable timber debug logging in production builds.
-     *
-     * When `true`, timber's own diagnostics (dev warnings, verbose logging)
-     * are active even in production mode. React stays in production mode —
-     * only timber's logs are affected.
-     *
-     * Can also be enabled at runtime via the `TIMBER_DEBUG` environment variable.
-     *
-     * Default: `false`.
-     */
-    debug?: boolean;
-    /**
-     * Control client-side JavaScript output.
-     *
-     * Boolean shorthand:
-     *   `clientJavascript: false` disables all client JS (equivalent to `{ disabled: true }`).
-     *   `clientJavascript: true` enables client JS (the default).
-     *
-     * Object form:
-     *   `clientJavascript: { disabled: true, enableHMRInDev: true }` disables client JS
-     *   in production but preserves Vite HMR in dev mode.
-     *
-     * When `disabled` is true, `enableHMRInDev` defaults to `true`.
-     * Server-side JS still runs — this only affects what is sent to the browser.
-     */
-    clientJavascript?: boolean | ClientJavascriptConfig;
-    adapter?: unknown;
-    cacheHandler?: unknown;
-    allowedOrigins?: string[];
-    csrf?: boolean;
-    limits?: {
-        actionBodySize?: string;
-        uploadBodySize?: string;
-        maxFields?: number;
-    };
-    pageExtensions?: string[];
-    /**
-     * Slow request threshold in milliseconds. Requests exceeding this emit
-     * a warning via the logger. Set to 0 to disable. Default: 3000.
-     *
-     * See design/17-logging.md §"slowRequestMs".
-     */
-    slowRequestMs?: number;
-    /** Dev-mode options. These have no effect in production builds. */
-    dev?: {
-        /** Threshold in ms to highlight slow phases in dev logging output. Default: 200. */
-        slowPhaseMs?: number;
-    };
-    /**
-     * Cookie signing configuration. See design/29-cookies.md §"Signed Cookies".
-     *
-     * Provide `secret` for a single key, or `secrets` (array) for key rotation.
-     * When `secrets` is used, index 0 is the signing key; all are tried for verification.
-     */
-    cookies?: {
-        /** Single signing secret. Shorthand for `secrets: [secret]`. */
-        secret?: string;
-        /** Array of signing secrets for key rotation. Index 0 signs; all verify. */
-        secrets?: string[];
-    };
-    /**
-     * Override the app directory location. By default, timber auto-detects
-     * `app/` at the project root, falling back to `src/app/`.
-     *
-     * Set this to a relative path from the project root (e.g. `'src/app'`)
-     * to use a custom location.
-     */
-    appDir?: string;
-    /** MDX compilation options passed to @mdx-js/rollup. See design/20-content-collections.md. */
-    mdx?: {
-        remarkPlugins?: unknown[];
-        rehypePlugins?: unknown[];
-        recmaPlugins?: unknown[];
-        remarkRehypeOptions?: Record<string, unknown>;
-    };
-    /**
-     * Built-in top-loader progress bar for client navigations.
-     * Shows an animated bar at the top of the viewport during RSC navigations.
-     * Enabled by default — set `enabled: false` to opt out.
-     *
-     * Users who want a fully custom progress indicator should disable this
-     * and use `useNavigationPending()` directly.
-     *
-     * See LOCAL-336 for design decisions.
-     */
-    topLoader?: {
-        /** Whether the top-loader is enabled. Default: true. */
-        enabled?: boolean;
-        /** Bar color. Default: '#2299DD'. */
-        color?: string;
-        /** Bar height in pixels. Default: 3. */
-        height?: number;
-        /** Show subtle glow/shadow effect. Default: true. */
-        shadow?: boolean;
-        /** Delay in ms before showing the bar (avoids flash on fast navs). Default: 0. */
-        delay?: number;
-        /** CSS z-index. Default: 1600. */
-        zIndex?: number;
-    };
-    /**
-     * Response-level caching and deduplication.
-     *
-     * When enabled, concurrent requests to the same URL share a single render
-     * (singleflight), and recently rendered responses are reused from a short-TTL
-     * LRU cache without re-executing the RSC-to-SSR pipeline.
-     *
-     * Set to `false` to disable entirely. Default: enabled with sensible defaults.
-     *
-     * See design/31-benchmarking.md for performance context.
-     */
-    responseCache?: false | {
-        /** Maximum number of entries in the LRU cache. Default: 150. */
-        maxSize?: number;
-        /** TTL for cached entries in milliseconds. Default: 5000 (5s). */
-        ttlMs?: number;
-        /**
-         * When true (default), requests with Cookie or Authorization headers
-         * bypass the cache entirely. This prevents sharing user-specific
-         * responses across requests.
-         *
-         * Set to false to cache all responses regardless of auth state.
-         * Only do this if your pages are truly public and don't vary by user.
-         */
-        publicOnly?: boolean;
-    };
-}
-/**
- * Resolve `clientJavascript` into a fully resolved config.
- */
-export declare function resolveClientJavascript(config: TimberUserConfig): ResolvedClientJavascript;
 /**
- * Shared context object passed to all sub-plugins via closure.
+ * @timber-js/app — Root entry point (public API).
  *
- * Sub-plugins communicate through this context — not through Vite's
- * plugin API or global state.
- * See design/18-build-system.md §"Shared Plugin Context".
- */
-export interface PluginContext {
-    config: TimberUserConfig;
-    /** Resolved client JavaScript configuration */
-    clientJavascript: ResolvedClientJavascript;
-    /** The scanned route tree (populated by timber-routing, consumed by timber-entries) */
-    routeTree: RouteTree | null;
-    /** Absolute path to the app/ directory */
-    appDir: string;
-    /** Absolute path to the project root */
-    root: string;
-    /** Whether the dev server is running (set by timber-root-sync in configResolved) */
-    dev: boolean;
-    /** CSS build manifest (populated by adapter after client build, null in dev) */
-    buildManifest: BuildManifest | null;
-    /** Startup timer for profiling cold start phases (active in dev, no-op in prod) */
-    timer: StartupTimer;
-}
-/**
- * Resolve the app directory. Checks (in order):
- * 1. Explicit `configAppDir` from timber.config.ts
- * 2. `<root>/app`
- * 3. `<root>/src/app`
+ * User-facing exports: timber(), defineConfig(), TimberUserConfig, Routes.
  *
- * Throws if none exist.
- */
-export declare function resolveAppDir(root: string, configAppDir?: string): string;
-/**
- * Detect config keys set in both inline (vite.config.ts) and file (timber.config.ts)
- * and warn the user. The `output` key is excluded because it defaults to 'server'
- * in createPluginContext and would always appear as an inline key.
+ * Internal helpers (PluginContext, resolveAppDir, loadTimberConfigFile,
+ * warnConfigConflicts, resolveClientJavascript) live in plugin-context.ts
+ * and are NOT re-exported here. Sub-plugins import them via relative paths.
  *
- * Returns the list of conflicting key names (for testing).
+ * Design doc: 18-build-system.md §"Plugin Architecture"
  */
-export declare function warnConfigConflicts(inline: TimberUserConfig, fileConfig: TimberUserConfig): string[];
-export declare function timber(config?: TimberUserConfig): PluginOption[];
+import type { PluginOption } from 'vite';
+import type { TimberUserConfig } from './config-types.js';
+export type { TimberUserConfig } from './config-types.js';
+export type { Metadata, MetadataRoute, MetadataHandler, MetadataResult } from './server/types.js';
 /**
  * Route map interface — augmented by the generated timber-routes.d.ts.
  *
  * Each key is a route path pattern. Values have:
- *   params: shape of URL params (e.g. { id: string })
+ *   segmentParams: shape of URL segment params (e.g. { id: string })
  *   searchParams: parsed type from search-params.ts, or {} if none
  *
  * This interface is empty by default and populated via codegen.
@@ -204,5 +25,40 @@ export declare function timber(config?: TimberUserConfig): PluginOption[];
  */
 export interface Routes {
 }
+/**
+ * Type-safe helper for timber.config.ts files.
+ *
+ * A pass-through identity function that provides autocomplete and
+ * type checking for timber configuration. No runtime validation —
+ * purely a DX convenience (same pattern as Vite's defineConfig).
+ *
+ * @example
+ * ```ts
+ * // timber.config.ts
+ * import { defineConfig } from '@timber-js/app';
+ *
+ * export default defineConfig({
+ *   output: 'server',
+ *   pageExtensions: ['tsx', 'ts', 'mdx'],
+ * });
+ * ```
+ */
+export declare function defineConfig(config: TimberUserConfig): TimberUserConfig;
+/**
+ * Create the timber Vite plugin array.
+ *
+ * Loads timber.config.ts and all dependencies synchronously before
+ * constructing the plugin array. This ensures ALL plugins — including
+ * the RSC plugin and React Compiler — see the fully merged config
+ * (inline + file-based). No async, no deferred config, no stale reads.
+ *
+ * Requires Node >= 22.12 for synchronous require() of ESM modules
+ * (@vitejs/plugin-rsc is ESM-only).
+ *
+ * Previous versions used async loading and deferred config merging,
+ * causing file-based config for reactCompiler, actionEncryption, and
+ * output mode to be silently ignored. See TIM-451.
+ */
+export declare function timber(config?: TimberUserConfig): PluginOption[];
 export default timber;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,MAAM,CAAC;AAyBjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAc1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQ1D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElG;;;;;;;;;GASG;AAEH,MAAM,WAAW,MAAM;CAAG;AAE1B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAEvE;AAgGD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CA+UhE;AAED,eAAe,MAAM,CAAC"}