@fougere/next 0.9.3-alpha.0 → 0.11.0-alpha.0

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAIvC,wBAAgB,WAAW,CAAC,MAAM,GAAE,UAAe,GAAG,UAAU,CAkC/D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAmCvC,wBAAgB,WAAW,CAAC,MAAM,GAAE,UAAe,GAAG,UAAU,CA8C/D"}

package/dist/config.js

@@ -1,8 +1,40 @@
 /** `withFougere(config)` — what Next has to be told so a Fougere app builds. */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 import TerserPlugin from 'terser-webpack-plugin';
 import { RUNTIME_PACKAGES } from '@fougere/compiler';
+/** Where the facades land, and what a page imports them by. */
+const FACADE = '.fougere/facade.generated.ts';
+const SPECIFIER = '@fronds/facade';
+/**
+ * The facades this app serves, written when the config is read.
+ *
+ * Synchronously and not in a hook: a Next config is evaluated before anything resolves a
+ * module, and the alias below points at a file a page imports. The scan LOADS a frond's own
+ * sources, so a TS-aware loader is installed first — without it `scanProject` throws and the
+ * module is silently never written.
+ */
+async function writeFacades(root) {
+    try {
+        const { scanProject, emitFacade, frondAliases } = await import('@fougere/compiler');
+        const { setModuleLoader } = await import('@fougere/core/node');
+        const { resolveConventions } = await import('@fougere/core');
+        const { createJiti } = await import('jiti');
+        const jiti = createJiti(import.meta.url, {
+            interopDefault: true,
+            alias: await frondAliases(root, resolveConventions()),
+        });
+        setModuleLoader((filePath) => jiti.import(filePath));
+        const out = join(root, FACADE);
+        mkdirSync(dirname(out), { recursive: true });
+        writeFileSync(out, emitFacade(await scanProject(root), { outFile: out }));
+    }
+    catch { /* a host with no fronds, or a scan that could not run */ }
+}
 export function withFougere(config = {}) {
     const userWebpack = config.webpack;
+    const root = process.cwd();
+    const written = writeFacades(root);
     return {
         ...config,
         // Additive: whatever the app already listed is kept.
@@ -11,10 +43,19 @@ export function withFougere(config = {}) {
             // fact about Next and not about a Fougere boot, so it is added here and not to the list.
             ...new Set([...(config.serverExternalPackages ?? []), ...RUNTIME_PACKAGES, '@fougere/next']),
         ],
+        // A page IMPORTS its facade, so the alias sits beside the file `writeFacades` writes: a
+        // project that never generated it fails to resolve rather than losing its types in silence.
+        turbopack: {
+            ...config.turbopack,
+            resolveAlias: { ...config.turbopack?.resolveAlias, [SPECIFIER]: join(root, FACADE) },
+        },
         webpack: (webpackConfig, context) => {
             // The app's own webpack function runs FIRST, so it sees an untouched config
             // and this never silently discards what it did.
             const base = userWebpack ? userWebpack(webpackConfig, context) : webpackConfig;
+            void written;
+            base.resolve ??= {};
+            base.resolve.alias = { ...base.resolve.alias, [SPECIFIER]: join(root, FACADE) };
             base.optimization ??= {};
             // ONLY the JS minifier is replaced. Next's minimizers are plain functions with
             // no readable options, so they are told apart by their source: index 0 loads

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,YAAY,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,UAAU,WAAW,CAAC,MAAM,GAAe,EAAE;IACjD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC;IAEnC,OAAO;QACL,GAAG,MAAM;QACT,qDAAqD;QACrD,sBAAsB,EAAE;YACtB,mFAAmF;YACnF,yFAAyF;YACzF,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,sBAAsB,IAAI,EAAE,CAAC,EAAE,GAAG,gBAAgB,EAAE,eAAe,CAAC,CAAC;SAC7F;QACD,OAAO,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE;YAClC,4EAA4E;YAC5E,gDAAgD;YAChD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAE/E,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;YACzB,+EAA+E;YAC/E,6EAA6E;YAC7E,gFAAgF;YAChF,gFAAgF;YAChF,yDAAyD;YACzD,MAAM,YAAY,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;YACjF,IAAI,CAAC,YAAY,CAAC,SAAS,GAAG;gBAC5B,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAC/E,2EAA2E;gBAC3E,0EAA0E;gBAC1E,+DAA+D;gBAC/D,IAAI,YAAY,CAAC,EAAE,aAAa,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC;aAC/D,CAAC;YAEF,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -3,7 +3,7 @@ export { invoke, getSession } from './invoke.js';
 // `withFougere` is deliberately NOT re-exported here. It is build-time config and
 // it pulls terser in; the root entry is imported by pages, so re-exporting it sent
 // a bundler into the browser bundle (measured: `esbuild/lib/main.d.ts` failed to
-// parse inside `app/page.tsx`). Build-time and runtime do not share a door:
+// parse inside `app/page.tsx`). Build-time and runtime do not share a facade:
 // `@fougere/next/config`.
 // The boot, so an app can override its data layer from `instrumentation.ts` the way
 // a Nuxt app does from a Nitro plugin.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjD,kFAAkF;AAClF,mFAAmF;AACnF,iFAAiF;AACjF,4EAA4E;AAC5E,0BAA0B;AAE1B,oFAAoF;AACpF,uCAAuC;AACvC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,QAAQ,GAGT,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjD,kFAAkF;AAClF,mFAAmF;AACnF,iFAAiF;AACjF,8EAA8E;AAC9E,0BAA0B;AAE1B,oFAAoF;AACpF,uCAAuC;AACvC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,QAAQ,GAGT,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/next",
-  "version": "0.9.3-alpha.0",
+  "version": "0.11.0-alpha.0",
   "description": "The Next.js adapter: mounting, and the one import that is genuinely Next.",
   "keywords": [
     "fougere",
@@ -44,13 +44,15 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "template"
   ],
   "dependencies": {
+    "jiti": "^2.7.0",
     "terser-webpack-plugin": "^5.3.14",
-    "@fougere/core": "0.9.3-alpha.0",
-    "@fougere/compiler": "0.9.3-alpha.0",
-    "@fougere/app": "0.9.3-alpha.0"
+    "@fougere/app": "0.11.0-alpha.0",
+    "@fougere/compiler": "0.11.0-alpha.0",
+    "@fougere/core": "0.11.0-alpha.0"
   },
   "devDependencies": {
     "next": "^15.5.7",

package/src/config.ts

@@ -1,11 +1,46 @@
 /** `withFougere(config)` — what Next has to be told so a Fougere app builds. */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 import TerserPlugin from 'terser-webpack-plugin';
 import type { NextConfig } from 'next';
 
 import { RUNTIME_PACKAGES } from '@fougere/compiler';
 
+/** Where the facades land, and what a page imports them by. */
+const FACADE = '.fougere/facade.generated.ts';
+const SPECIFIER = '@fronds/facade';
+
+/**
+ * The facades this app serves, written when the config is read.
+ *
+ * Synchronously and not in a hook: a Next config is evaluated before anything resolves a
+ * module, and the alias below points at a file a page imports. The scan LOADS a frond's own
+ * sources, so a TS-aware loader is installed first — without it `scanProject` throws and the
+ * module is silently never written.
+ */
+async function writeFacades(root: string): Promise<void> {
+  try {
+    const { scanProject, emitFacade, frondAliases } = await import('@fougere/compiler');
+    const { setModuleLoader } = await import('@fougere/core/node');
+    const { resolveConventions } = await import('@fougere/core');
+    const { createJiti } = await import('jiti');
+
+    const jiti = createJiti(import.meta.url, {
+      interopDefault: true,
+      alias: await frondAliases(root, resolveConventions()),
+    });
+    setModuleLoader((filePath: string) => jiti.import(filePath) as Promise<Record<string, unknown>>);
+
+    const out = join(root, FACADE);
+    mkdirSync(dirname(out), { recursive: true });
+    writeFileSync(out, emitFacade(await scanProject(root), { outFile: out }));
+  } catch { /* a host with no fronds, or a scan that could not run */ }
+}
+
 export function withFougere(config: NextConfig = {}): NextConfig {
   const userWebpack = config.webpack;
+  const root = process.cwd();
+  const written = writeFacades(root);
 
   return {
     ...config,
@@ -15,11 +50,21 @@ export function withFougere(config: NextConfig = {}): NextConfig {
       // fact about Next and not about a Fougere boot, so it is added here and not to the list.
       ...new Set([...(config.serverExternalPackages ?? []), ...RUNTIME_PACKAGES, '@fougere/next']),
     ],
+    // A page IMPORTS its facade, so the alias sits beside the file `writeFacades` writes: a
+    // project that never generated it fails to resolve rather than losing its types in silence.
+    turbopack: {
+      ...config.turbopack,
+      resolveAlias: { ...config.turbopack?.resolveAlias, [SPECIFIER]: join(root, FACADE) },
+    },
     webpack: (webpackConfig, context) => {
       // The app's own webpack function runs FIRST, so it sees an untouched config
       // and this never silently discards what it did.
       const base = userWebpack ? userWebpack(webpackConfig, context) : webpackConfig;
 
+      void written;
+      base.resolve ??= {};
+      base.resolve.alias = { ...base.resolve.alias, [SPECIFIER]: join(root, FACADE) };
+
       base.optimization ??= {};
       // ONLY the JS minifier is replaced. Next's minimizers are plain functions with
       // no readable options, so they are told apart by their source: index 0 loads

package/src/index.ts

@@ -4,7 +4,7 @@ export { invoke, getSession } from './invoke.js';
 // `withFougere` is deliberately NOT re-exported here. It is build-time config and
 // it pulls terser in; the root entry is imported by pages, so re-exporting it sent
 // a bundler into the browser bundle (measured: `esbuild/lib/main.d.ts` failed to
-// parse inside `app/page.tsx`). Build-time and runtime do not share a door:
+// parse inside `app/page.tsx`). Build-time and runtime do not share a facade:
 // `@fougere/next/config`.
 
 // The boot, so an app can override its data layer from `instrumentation.ts` the way

package/template/app/layout.tsx

@@ -0,0 +1,3 @@
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return <html lang="en"><body>{children}</body></html>;
+}

package/template/app/page.tsx

@@ -0,0 +1,21 @@
+import { invoke } from '@fougere/next';
+// Replace with an entity your own frond declares.
+import Post from '@fronds/blog/entities/Post';
+
+/**
+ * A server component reading a Frond directly — no fetch, no endpoint, no route.
+ *
+ * `invoke` names the call and the runner places it: in memory here, over JSON-RPC the day
+ * `remotes:` names the frond in `fougere.config.ts`. A page that needs reactivity uses
+ * `useQuery` from `@fougere/react` instead, with a facade from `@fronds/facade`.
+ */
+export default async function Home() {
+  const rows = await invoke<Post[]>(Post, 'list');
+
+  return (
+    <main style={{ maxWidth: 720, margin: '3rem auto', fontFamily: 'system-ui' }}>
+      <h1>Fougere</h1>
+      {rows.map((row) => <pre key={row.id}>{JSON.stringify(row, null, 2)}</pre>)}
+    </main>
+  );
+}

package/template/next.config.mjs

@@ -0,0 +1,11 @@
+import { withFougere } from '@fougere/next/config';
+
+/**
+ * `.mjs` and not `.ts`: Next loads a TypeScript config through a CommonJS require, and
+ * `@fougere/next` is ESM-only — the subpath does not resolve there. An `.mjs` config goes
+ * through Node's ESM loader, which resolves it fine.
+ *
+ * `withFougere` states the two things Next has to know: the packages a boot loads at runtime,
+ * and a minifier that keeps class names. Your own config goes in the object, untouched.
+ */
+export default withFougere();

package/template/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "fougere-app",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build"
+  },
+  "dependencies": {
+    "@fougere/core": "latest",
+    "@fougere/next": "latest",
+    "@fougere/react": "latest",
+    "@fougere/schema": "latest",
+    "@fougere/defaults": "latest",
+    "@fougere/container": "latest",
+    "better-sqlite3": "^13.0.3",
+    "kysely": "^0.28.17",
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  }
+}

package/template/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "preserve",
+    "strict": true,
+    "noEmit": true,
+    "types": [
+      "node",
+      "react"
+    ],
+    "paths": {
+      "@fronds/facade": [
+        "./.fougere/facade.generated.ts"
+      ]
+    }
+  },
+  "include": [
+    "app",
+    "next-env.d.ts"
+  ]
+}