@fougere/vite 0.2.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import type { Plugin } from 'vite';
+/**
+ * The entity names a build must not rename, read off the filesystem.
+ *
+ * `fronds/blog/entities/Post.ts` IS the declaration of an entity called `Post` —
+ * the scan already treats the file name that way. So the list needs no config and
+ * no annotation: it is derived from the same convention the framework already
+ * relies on, which is why this feint costs the developer nothing.
+ */
+export declare function entityNamesIn(root: string): string[];
+/** Packages a Fougere boot loads at runtime — they must not be bundled. */
+export declare const RUNTIME_PACKAGES: string[];
+export interface FougereViteOptions {
+    /** Extra packages the boot loads at runtime, added to the defaults. */
+    external?: string[];
+    /**
+     * Set false to keep the host's own minifier. Only do this if something else in
+     * the build already preserves class names — otherwise production designates a
+     * renamed class and the call is refused.
+     */
+    keepClassNames?: boolean;
+    /** Extra identifiers to reserve, for entities that do not live under `fronds/`. */
+    reserved?: string[];
+}
+export declare function fougere(options?: FougereViteOptions): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAepD;AAED,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,UAU5B,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CA2ChE"}

package/dist/index.js

@@ -0,0 +1,127 @@
+/**
+ * `@fougere/vite` — the one place a Vite-built host is told what a Fougere app needs.
+ *
+ * ```ts
+ * // vite.config.ts
+ * import { fougere } from '@fougere/vite';
+ *
+ * export default defineConfig({ plugins: [fougere(), sveltekit()] });
+ * ```
+ *
+ * One plugin, three hosts: TanStack Start, React Router and SvelteKit all build with
+ * Vite, so none of them needs a package of its own. That was the hole in the first
+ * version of this fix — it lived in `@fougere/next`, and the three hosts that have
+ * no adapter package had nowhere to put it.
+ *
+ * ## What it states, and why each one
+ *
+ * **1. The entity's name survives minification.** Designation is class + verb, so
+ * `useQuery(Post, 'list')` reads `Post.name`, and that name travels — it is the
+ * JSON-RPC method (`post.list`) and the REST path.
+ *
+ * Getting there took measuring what actually happens, because the obvious setting
+ * is not enough. Rollup cannot keep `class Post extends entity({…})` as a hoisted
+ * declaration — its heritage clause is a CALL — so it emits `var Post = class
+ * extends entity({…})`. The class is ANONYMOUS; `Post.name` works only through
+ * JavaScript's name inference from the variable. So `keep_classnames` protects
+ * nothing (there is no class name to keep), in `compress` or in `mangle` — both
+ * measured, both `Ot`.
+ *
+ * What works is reserving the IDENTIFIER: `mangle.reserved`. The variable keeps its
+ * name, inference keeps working, and everything else is still mangled. Measured:
+ * `var Post=class extends…` in the production client bundle.
+ *
+ * And the list is not config — `entityNamesIn` reads it from `fronds/<frond>/entities/`,
+ * the same convention the scan already uses. The developer writes nothing.
+ *
+ * **2. The scan's dependencies stay out of the server bundle.** A boot reads frond
+ * sources off disk through jiti, so those packages are loaded at runtime instead.
+ * The three demos each copied this list into their own config; it belongs here.
+ *
+ * The rule this encodes is not "Vite is special", it is: **any bundler that carries
+ * a Fougere entity class must preserve its name.**
+ */
+import { readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * The entity names a build must not rename, read off the filesystem.
+ *
+ * `fronds/blog/entities/Post.ts` IS the declaration of an entity called `Post` —
+ * the scan already treats the file name that way. So the list needs no config and
+ * no annotation: it is derived from the same convention the framework already
+ * relies on, which is why this feint costs the developer nothing.
+ */
+export function entityNamesIn(root) {
+    const frondsDir = join(root, 'fronds');
+    if (!existsSync(frondsDir))
+        return [];
+    const names = new Set();
+    for (const frond of readdirSync(frondsDir, { withFileTypes: true })) {
+        if (!frond.isDirectory())
+            continue;
+        const entities = join(frondsDir, frond.name, 'entities');
+        if (!existsSync(entities))
+            continue;
+        for (const file of readdirSync(entities)) {
+            const match = /^(.+)\.tsx?$/.exec(file);
+            if (match)
+                names.add(match[1]);
+        }
+    }
+    return [...names];
+}
+/** Packages a Fougere boot loads at runtime — they must not be bundled. */
+export const RUNTIME_PACKAGES = [
+    '@fougere/app',
+    '@fougere/core',
+    '@fougere/schema',
+    '@fougere/schema-sql',
+    '@fougere/schema-graphql',
+    '@fougere/auth-better',
+    'better-sqlite3',
+    'jiti',
+    'typescript',
+];
+export function fougere(options = {}) {
+    const external = [...new Set([...RUNTIME_PACKAGES, ...(options.external ?? [])])];
+    return {
+        name: 'fougere',
+        /**
+         * `order: 'post'` and a MUTATION, not a returned patch — and both halves were
+         * measured.
+         *
+         * Returning `{ build: { minify: 'terser' } }` is the idiomatic form, and it did
+         * not work: Vite deep-merges those patches, and the framework plugins
+         * (`tanstackStart()`, `reactRouter()`, `sveltekit()`) set their own `build`
+         * afterwards, so all three demos still shipped `C=class extends…`. Running last
+         * and writing the value directly is what makes the setting hold whatever the
+         * host declares.
+         *
+         * The app keeps the last word anyway: `keepClassNames: false` turns this off.
+         */
+        config: {
+            order: 'post',
+            handler(config) {
+                config.ssr ??= {};
+                config.ssr.external = [...new Set([...(config.ssr.external ?? []), ...external])];
+                if (options.keepClassNames === false)
+                    return;
+                const reserved = [...(options.reserved ?? []), ...entityNamesIn(config.root ?? process.cwd())];
+                if (reserved.length === 0)
+                    return;
+                config.build ??= {};
+                // Vite's default minifier is esbuild, which has no per-name option; terser does.
+                config.build.minify = 'terser';
+                config.build.terserOptions = {
+                    ...config.build.terserOptions,
+                    keep_classnames: true,
+                    mangle: {
+                        ...(config.build.terserOptions?.mangle ?? {}),
+                        reserved: [...new Set([...(config.build.terserOptions?.mangle?.reserved ?? []), ...reserved])],
+                    },
+                };
+            },
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@fougere/vite",
+  "version": "0.2.0-alpha.0",
+  "description": "The Vite plugin: what any Vite-built host must know to run a Fougere app.",
+  "keywords": [
+    "fougere",
+    "vite",
+    "plugin",
+    "sveltekit",
+    "tanstack",
+    "react-router"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chok/fougere.git",
+    "directory": "packages/app/vite"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "terser": "^5.44.0"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "^4.1.0"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json"
+  }
+}