dinou 8.0.1 → 8.0.3

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [8.0.3] - 2026-10-22
+
+### Fixed
+- **Type-Safe Route Pattern Autocompletion in Segment Configs**: Added generic constraints (`TRouteOrParams extends DinouRoutePattern | object = any`) to `PageFunctions` and `LayoutFunctions`, as well as `RouteParams<T extends DinouRoutePattern = DinouRoutePattern>`. This enables immediate IDE / TypeScript autocompletion for known project routes when typing string literals (`PageFunctions<"..."`) and strict compile-time validation against typos in route strings, while preserving full backward compatibility for parameter dictionaries and custom interfaces (`PageFunctions<CustomParams>`).
+- **Direct `defineConfig` Import from `"dinou"`**: Added an esbuild resolution plugin (`dinou-config-alias`) in `load-dinou-config.js` to alias exact `"dinou"` specifier imports to `"dinou/config"` when bundling configuration files (`dinou.config.ts`, `dinou.config.mjs`, etc.). This allows importing `defineConfig` directly from `"dinou"` (`import { defineConfig } from "dinou"`) without triggering Node.js native ESM `ERR_UNKNOWN_FILE_EXTENSION` errors from unbundled React JSX components (`redirect.jsx`, `link.jsx`) in `dinou/index.js`, while keeping all other subpath imports (`dinou/adapters/*`, `dinou/config`) intact.
+
+## [8.0.2] - 2026-10-22
+
+### Fixed
+- **Type-Safe Routing Ambient Inclusions**: Dinou no longer modifies `dinou-env.d.ts` at runtime. Ambient route declarations (`.dinou/types/routes.d.ts`) are now consumed directly via `tsconfig.json` (`".dinou/types/**/*.d.ts"`), preventing `TS6053` errors on fresh clones and keeping Git working trees clean.
+
 ## [8.0.1] - 2026-10-21
 
 ### Fixed

package/README.md

@@ -1,6 +1,6 @@
 # **Dinou**
 
-[![Documentation](https://img.shields.io/badge/docs-dinou.dev-blue?style=flat-square)](https://dinou.dev) [![Version](https://img.shields.io/badge/version-8.0.1-orange?style=flat-square)](https://www.npmjs.com/package/dinou)
+[![Documentation](https://img.shields.io/badge/docs-dinou.dev-blue?style=flat-square)](https://dinou.dev) [![Version](https://img.shields.io/badge/version-8.0.3-orange?style=flat-square)](https://www.npmjs.com/package/dinou)
 
 ### **Full-Stack React 19 Framework**
 
@@ -539,7 +539,8 @@ Dinou does not force you to use TypeScript—you are completely free to write yo
   },
   "include": [
     "src",
-    "dinou-env.d.ts"
+    "dinou-env.d.ts",
+    ".dinou/types/**/*.d.ts"
   ]
 }
 ```
@@ -2221,12 +2222,24 @@ export interface RouteSegmentConfig<TParams = any, TProps = any> {
 /**
  * Concrete semantic alias to import and use in 'page_functions.ts'
  */
-export type PageFunctions<TParams = any, TProps = any> = RouteSegmentConfig<TParams, TProps>;
+export type PageFunctions<
+  TRouteOrParams extends DinouRoutePattern | object = any,
+  TProps = any
+> = RouteSegmentConfig<
+  [TRouteOrParams] extends [string] ? RouteParams<TRouteOrParams> : TRouteOrParams,
+  TProps
+>;
 
 /**
  * Concrete semantic alias to import and use in 'layout_functions.ts'
  */
-export type LayoutFunctions<TParams = any, TProps = any> = RouteSegmentConfig<TParams, TProps>;
+export type LayoutFunctions<
+  TRouteOrParams extends DinouRoutePattern | object = any,
+  TProps = any
+> = RouteSegmentConfig<
+  [TRouteOrParams] extends [string] ? RouteParams<TRouteOrParams> : TRouteOrParams,
+  TProps
+>;
 ```
 
 | Where to use | Type to import | Purpose |
@@ -6148,7 +6161,8 @@ Ensure your `tsconfig.json` includes the declaration file and specifies `"module
   },
   "include": [
     "src",
-    "dinou-env.d.ts"
+    "dinou-env.d.ts",
+    ".dinou/types/**/*.d.ts"
   ]
 }
 ```
@@ -6426,7 +6440,8 @@ And confirm your `tsconfig.json` includes the reference:
   },
   "include": [
     "src",
-    "dinou-env.d.ts"
+    "dinou-env.d.ts",
+    ".dinou/types/**/*.d.ts"
   ]
 }
 ```
@@ -6698,7 +6713,8 @@ To enable the standard `@/*` alias pointing to your `src/` directory, configure
   },
   "include": [
     "src",
-    "dinou-env.d.ts"
+    "dinou-env.d.ts",
+    ".dinou/types/**/*.d.ts"
   ]
 }
 ```

package/dinou/core/generate-route-types.js

@@ -134,7 +134,7 @@ function generateRouteDefinitions(routes) {
 }
 
 /**
- * Generates the .dinou/types/routes.d.ts file and ensures dinou-env.d.ts references it.
+ * Generates the .dinou/types/routes.d.ts ambient definitions file.
  * @param {string} projectRoot Root directory of the project (default process.cwd())
  */
 function generateRouteTypes(projectRoot = process.cwd()) {
@@ -225,19 +225,6 @@ ${paramsEntries}
     }
   }
 
-  // Ensure dinou-env.d.ts references .dinou/types/routes.d.ts
-  const envFile = path.resolve(projectRoot, "dinou-env.d.ts");
-  try {
-    if (fs.existsSync(envFile)) {
-      let envContent = fs.readFileSync(envFile, "utf8");
-      const refLine = '/// <reference path="./.dinou/types/routes.d.ts" />';
-      if (!envContent.includes(refLine)) {
-        envContent = envContent.trimEnd() + "\n" + refLine + "\n";
-        fs.writeFileSync(envFile, envContent, "utf8");
-      }
-    }
-  } catch (e) {}
-
   return {
     staticCount: staticRoutes.length,
     dynamicCount: dynamicRoutes.length,

package/dinou/core/load-dinou-config.js

@@ -51,6 +51,16 @@ async function getDinouConfig() {
               platform: "node",
               packages: "external",
               sourcemap: "inline",
+              plugins: [
+                {
+                  name: "dinou-config-alias",
+                  setup(build) {
+                    build.onResolve({ filter: /^dinou$/ }, () => {
+                      return { path: "dinou/config", external: true };
+                    });
+                  },
+                },
+              ],
             });
             loaded = await import(pathToFileURL(bundledPath).href + (isDev ? `?t=${Date.now()}` : ""));
           } else if (p.endsWith(".mjs")) {

package/dinou/index.d.ts

@@ -288,7 +288,10 @@ export interface RouteSegmentConfig<TParams = any, TProps = any> {
  * Type-safe interface representing the available exports in `page_functions.ts`.
  * Accepts either a route pattern string (e.g. `"/products/[id]"`) or a direct parameters dictionary.
  */
-export type PageFunctions<TRouteOrParams = any, TProps = any> = RouteSegmentConfig<
+export type PageFunctions<
+  TRouteOrParams extends DinouRoutePattern | object = any,
+  TProps = any
+> = RouteSegmentConfig<
   [TRouteOrParams] extends [string] ? RouteParams<TRouteOrParams> : TRouteOrParams,
   TProps
 >;
@@ -297,7 +300,10 @@ export type PageFunctions<TRouteOrParams = any, TProps = any> = RouteSegmentConf
  * Type-safe interface representing the available exports in `layout_functions.ts`.
  * Accepts either a route pattern string (e.g. `"/[organization]"`) or a direct parameters dictionary.
  */
-export type LayoutFunctions<TRouteOrParams = any, TProps = any> = RouteSegmentConfig<
+export type LayoutFunctions<
+  TRouteOrParams extends DinouRoutePattern | object = any,
+  TProps = any
+> = RouteSegmentConfig<
   [TRouteOrParams] extends [string] ? RouteParams<TRouteOrParams> : TRouteOrParams,
   TProps
 >;
@@ -479,7 +485,7 @@ export type CleanRoutePath<T extends string> = T extends `/${string}` ? T : `/${
  * Prioritizes the generated route parameters map from .dinou/types/routes.d.ts,
  * and falls back to template literal extraction.
  */
-export type RouteParams<T extends string = string> =
+export type RouteParams<T extends DinouRoutePattern = DinouRoutePattern> =
   DinouRouter.Register extends { params: infer P }
     ? (CleanRoutePath<T> extends keyof P
         ? P[CleanRoutePath<T>]

package/dinou/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dinou-ejected",
-  "version": "8.0.1",
+  "version": "8.0.3",
   "type": "module",
   "main": "index.js",
   "private": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dinou",
-  "version": "8.0.1",
+  "version": "8.0.3",
   "description": "Full-stack React 19 framework with native RSC, Server Functions, progressive streaming, and zero vendor lock-in.",
   "type": "module",
   "main": "./dinou/index.js",