@timber-js/app 0.1.0

package/dist/shims/navigation-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shim: next/navigation (client environment only)
+ *
+ * Re-exports only the client-side hooks from timber's navigation shims.
+ * Server-only functions (redirect, notFound, etc.) are excluded to prevent
+ * server/primitives.ts from being pulled into the browser bundle.
+ *
+ * The full shim (navigation.ts) is still used in the RSC and SSR environments
+ * where both client hooks and server functions are needed.
+ *
+ * See design/14-ecosystem.md §"next/navigation" for the full shim audit.
+ */
+export { useParams } from '#/client/use-params.js';
+export { usePathname } from '#/client/use-pathname.js';
+export { useSearchParams } from '#/client/use-search-params.js';
+export { useRouter } from '#/client/use-router.js';
+export { useSelectedLayoutSegment, useSelectedLayoutSegments, } from '#/client/use-selected-layout-segment.js';
+export declare const RedirectType: {
+    readonly push: "push";
+    readonly replace: "replace";
+};
+export declare function redirect(): never;
+export declare function permanentRedirect(): never;
+export declare function notFound(): never;
+//# sourceMappingURL=navigation-client.d.ts.map

package/dist/shims/navigation-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-client.d.ts","sourceRoot":"","sources":["../../src/shims/navigation-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,yCAAyC,CAAC;AAIjD,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAKX,wBAAgB,QAAQ,IAAI,KAAK,CAKhC;AAED,wBAAgB,iBAAiB,IAAI,KAAK,CAKzC;AAED,wBAAgB,QAAQ,IAAI,KAAK,CAIhC"}

package/dist/shims/navigation.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shim: next/navigation → timber navigation primitives
+ *
+ * Re-exports timber's navigation hooks and functions for libraries
+ * that import from next/navigation. Covers the App Router API surface
+ * used by ecosystem libraries (nuqs, next-intl, etc.).
+ *
+ * Note: nuqs imports next/navigation.js (with .js extension).
+ * The timber-shims plugin strips .js before matching.
+ *
+ * Intentional divergences from Next.js:
+ * - useRouter().replace() currently uses pushState (same as push) —
+ *   timber's router doesn't distinguish push/replace yet.
+ * - redirect() does not accept a RedirectType argument — timber
+ *   always uses replace semantics for redirects.
+ * - permanentRedirect() delegates to redirect(path, 308).
+ * See design/14-ecosystem.md for the full shim audit.
+ */
+export { useParams } from '#/client/use-params.js';
+export { usePathname } from '#/client/use-pathname.js';
+export { useSearchParams } from '#/client/use-search-params.js';
+export { useRouter } from '#/client/use-router.js';
+export { useSelectedLayoutSegment, useSelectedLayoutSegments, } from '#/client/use-selected-layout-segment.js';
+export { redirect, permanentRedirect, notFound, RedirectType } from '#/server/primitives.js';
+//# sourceMappingURL=navigation.d.ts.map

package/dist/shims/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/shims/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/utils/directive-parser.d.ts

@@ -0,0 +1,70 @@
+/**
+ * AST-based directive detection for 'use cache', 'use dynamic',
+ * 'use client', and 'use server'.
+ *
+ * Uses acorn to parse source code and detect directives properly,
+ * avoiding false positives from regex matching inside string literals,
+ * comments, or template expressions.
+ *
+ * @module
+ */
+export interface FileDirective {
+    /** The directive value, e.g. 'use client', 'use server' */
+    directive: string;
+    /** 1-based line number where the directive appears */
+    line: number;
+}
+export interface FunctionWithDirective {
+    /** Function name (or 'default' for anonymous default exports) */
+    name: string;
+    /** The directive found in the function body */
+    directive: string;
+    /** 1-based line number of the directive */
+    directiveLine: number;
+    /** Start offset of the function in the source */
+    start: number;
+    /** End offset of the function in the source */
+    end: number;
+    /** Start offset of the function body block (after the '{') */
+    bodyStart: number;
+    /** End offset of the function body block (the '}') */
+    bodyEnd: number;
+    /** Content between { and } of the function body */
+    bodyContent: string;
+    /** 'export ', 'export default ', or '' */
+    prefix: string;
+    /** Whether this is an arrow function */
+    isArrow: boolean;
+    /** The function signature (everything before the body '{') */
+    declaration: string;
+}
+/**
+ * Detect a file-level directive ('use client', 'use server', etc.).
+ *
+ * Per the ECMAScript spec, directives are string literal expression
+ * statements at the start of a program body (before any non-directive
+ * statements). This function checks the AST `Program.body` for
+ * `ExpressionStatement` nodes whose expression is a `Literal` string
+ * matching a known directive.
+ *
+ * Returns the first matching directive, or null if none found.
+ */
+export declare function detectFileDirective(code: string, directives?: string[]): FileDirective | null;
+/**
+ * Find all functions in the source code that contain a directive
+ * (e.g. 'use cache', 'use dynamic') as their first body statement.
+ *
+ * Parses the source with acorn and walks the AST looking for function
+ * declarations and arrow function expressions whose body is a
+ * BlockStatement with a directive prologue.
+ *
+ * Returns an array of function info objects, sorted by position
+ * (descending) for safe end-to-start replacement.
+ */
+export declare function findFunctionsWithDirective(code: string, directive: string): FunctionWithDirective[];
+/**
+ * Quick regex check for whether code contains a directive string.
+ * Use as a fast bail-out before calling the AST-based functions.
+ */
+export declare function containsDirective(code: string, directive: string): boolean;
+//# sourceMappingURL=directive-parser.d.ts.map

package/dist/utils/directive-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-parser.d.ts","sourceRoot":"","sources":["../../src/utils/directive-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAM,EAAiC,GAClD,aAAa,GAAG,IAAI,CAmCtB;AAiED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,qBAAqB,EAAE,CAqBzB;AA4TD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1E"}

package/dist/utils/format.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared formatting utilities.
+ */
+/** Format a byte count as a human-readable string (e.g. "1.50 kB"). */
+export declare function formatSize(bytes: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD"}

package/dist/utils/startup-timer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Startup timer — records named phases with their durations.
+ *
+ * Used by the plugin system to instrument cold start and report a
+ * timing breakdown in dev mode. Zero overhead in production (disabled).
+ *
+ * See design/18-build-system.md, TIM-155.
+ */
+export interface PhaseRecord {
+    name: string;
+    startMs: number;
+    durationMs: number;
+}
+export interface StartupTimer {
+    /** Mark the beginning of a named phase. */
+    start(phase: string): void;
+    /** Mark the end of a named phase. Returns duration in ms. */
+    end(phase: string): number;
+    /** Get all completed phase records, ordered by start time. */
+    getPhases(): PhaseRecord[];
+    /** Total elapsed time from first start() to last end(). */
+    totalMs(): number;
+    /** Format a human-readable summary string. */
+    formatSummary(): string;
+}
+/**
+ * Create a startup timer that records phase durations.
+ */
+export declare function createStartupTimer(): StartupTimer;
+/**
+ * No-op timer for production builds — all methods are empty.
+ */
+export declare function createNoopTimer(): StartupTimer;
+//# sourceMappingURL=startup-timer.d.ts.map

package/dist/utils/startup-timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-timer.d.ts","sourceRoot":"","sources":["../../src/utils/startup-timer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6DAA6D;IAC7D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,SAAS,IAAI,WAAW,EAAE,CAAC;IAC3B,2DAA2D;IAC3D,OAAO,IAAI,MAAM,CAAC;IAClB,8CAA8C;IAC9C,aAAa,IAAI,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CA+CjD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAgB9C"}

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "@timber-js/app",
+  "version": "0.1.0",
+  "description": "Vite-native React framework for Cloudflare Workers — correct HTTP semantics, real status codes, pages that work without JavaScript",
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/switz/timber.js.git",
+    "directory": "packages/timber-app"
+  },
+  "homepage": "https://github.com/switz/timber.js",
+  "keywords": [
+    "react",
+    "vite",
+    "rsc",
+    "react-server-components",
+    "cloudflare-workers",
+    "framework",
+    "ssr",
+    "streaming"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "timber": "./bin/timber.mjs"
+  },
+  "imports": {
+    "#/*": "./src/*"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./server": "./src/server/index.ts",
+    "./client": "./src/client/index.ts",
+    "./cache": "./src/cache/index.ts",
+    "./content": "./src/content/index.ts",
+    "./cookies": "./src/cookies/index.ts",
+    "./search-params": "./src/search-params/index.ts",
+    "./routing": "./src/routing/index.ts",
+    "./adapters/cloudflare": "./src/adapters/cloudflare.ts",
+    "./adapters/nitro": "./src/adapters/nitro.ts",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "bin": {
+      "timber": "./bin/timber.mjs"
+    },
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      },
+      "./server": {
+        "types": "./dist/server/index.d.ts",
+        "import": "./dist/server/index.js"
+      },
+      "./client": {
+        "types": "./dist/client/index.d.ts",
+        "import": "./dist/client/index.js"
+      },
+      "./cache": {
+        "types": "./dist/cache/index.d.ts",
+        "import": "./dist/cache/index.js"
+      },
+      "./content": {
+        "types": "./dist/content/index.d.ts",
+        "import": "./dist/content/index.js"
+      },
+      "./cookies": {
+        "types": "./dist/cookies/index.d.ts",
+        "import": "./dist/cookies/index.js"
+      },
+      "./search-params": {
+        "types": "./dist/search-params/index.d.ts",
+        "import": "./dist/search-params/index.js"
+      },
+      "./routing": {
+        "types": "./dist/routing/index.d.ts",
+        "import": "./dist/routing/index.js"
+      },
+      "./adapters/cloudflare": {
+        "types": "./dist/adapters/cloudflare.d.ts",
+        "import": "./dist/adapters/cloudflare.js"
+      },
+      "./adapters/nitro": {
+        "types": "./dist/adapters/nitro.d.ts",
+        "import": "./dist/adapters/nitro.js"
+      },
+      "./package.json": "./package.json"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "vite build --config vite.lib.config.ts && tsc --emitDeclarationOnly --project tsconfig.json --outDir dist",
+    "typecheck": "tsgo --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/context-async-hooks": "^2.6.0",
+    "@opentelemetry/sdk-trace-base": "^2.6.0",
+    "@vitejs/plugin-react": "^6.0.0",
+    "@vitejs/plugin-rsc": "~0.5.21"
+  },
+  "peerDependencies": {
+    "@content-collections/core": "^0.14.0",
+    "@content-collections/mdx": "^0.2.0",
+    "@content-collections/vite": "^0.2.0",
+    "@mdx-js/rollup": "^3.0.0",
+    "nuqs": "^2.0.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "vite": "^8.0.0",
+    "zod": "^3.22.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@content-collections/core": {
+      "optional": true
+    },
+    "@content-collections/mdx": {
+      "optional": true
+    },
+    "@content-collections/vite": {
+      "optional": true
+    },
+    "@mdx-js/rollup": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  }
+}