@fragno-dev/create 0.1.1 → 0.1.3

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "@fragno-dev/create",
   "description": "A library for creating Fragno fragments",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
@@ -13,26 +12,32 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "scripts": {
-    "test": "vitest run",
-    "build": "tsdown",
-    "build:watch": "tsdown --watch",
-    "types:check": "tsc --noEmit"
-  },
   "type": "module",
   "dependencies": {
     "zod": "^4.1.12"
   },
   "devDependencies": {
-    "@fragno-private/typescript-config": "0.0.1",
-    "@fragno-private/vitest-config": "0.0.0",
-    "@types/node": "^20",
-    "@types/bun": "latest",
+    "@types/node": "^22",
     "@vitest/coverage-istanbul": "^3.2.4",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@fragno-private/typescript-config": "0.0.1",
+    "@fragno-private/vitest-config": "0.0.0"
   },
   "private": false,
   "peerDependencies": {
     "typescript": "^5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rejot-dev/fragno.git",
+    "directory": "packages/create"
+  },
+  "homepage": "https://fragno.dev",
+  "license": "MIT",
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsdown",
+    "build:watch": "tsdown --watch",
+    "types:check": "tsc --noEmit"
   }
-}
+}

package/src/integration.test.ts

@@ -54,8 +54,8 @@ function createFragmentTestSuite(buildTool: BuildTool, withDatabase: boolean) {
         await expect(fs.access(agentFile)).resolves.toBeUndefined();
       });
 
-      test("installs", { timeout: 10000 }, async () => {
-        const { stdout } = await execAsync("bun install", {
+      test("installs", { timeout: 30000 }, async () => {
+        const { stdout } = await execAsync("pnpm install", {
           cwd: tempDir,
           encoding: "utf8",
         });
@@ -63,7 +63,7 @@ function createFragmentTestSuite(buildTool: BuildTool, withDatabase: boolean) {
       });
 
       test("compiles", { timeout: 30000 }, async () => {
-        const { stdout } = await execAsync("bun run types:check", {
+        const { stdout } = await execAsync("pnpm run types:check", {
           cwd: tempDir,
           encoding: "utf8",
         });
@@ -72,12 +72,12 @@ function createFragmentTestSuite(buildTool: BuildTool, withDatabase: boolean) {
       });
       /*
       FIXME: Skipping this test for rollup:
-        When running rollup directly through bun run build or npm run build the build succeeds,
+        When running rollup directly through pnpm run build or npm run build the build succeeds,
         but somehow when running through vitest the module resolution mechanism changes causing
         the build to fail.
       */
       test.skipIf(buildTool === "rollup")("builds", { timeout: 50000 }, async () => {
-        const result = await execAsync("bun run build", {
+        const result = await execAsync("pnpm run build", {
           cwd: tempDir,
           encoding: "utf8",
         });
@@ -95,6 +95,9 @@ function createFragmentTestSuite(buildTool: BuildTool, withDatabase: boolean) {
         // However, the peerDependencies of @fragno-dev/core must not be included
         expect(reactBundleContent).toMatch(/from\s*['"]react['"]/);
 
+        // db should also not be included in the frontend
+        expect(reactBundleContent).not.toMatch(/import\s+.*?\s+from\s+['"]@fragno-dev\/db/);
+
         // Vite builds only the browser bundle
         if (buildTool !== "vite") {
           await expect(fs.access(path.join(tempDir, "dist", "node"))).resolves.toBeUndefined();

package/src/package-json.ts

@@ -1,21 +1,21 @@
 import type { BuildTools } from "./index";
 
-const fragnoCoreVersion = "^0.1.2";
-const fragnoDbVersion = "^0.1.2";
-const unpluginFragnoVersion = "^0.0.2";
-const fragnoCliVersion = "^0.1.3";
+const fragnoCoreVersion = "^0.1.7";
+const fragnoDbVersion = "^0.1.13";
+const unpluginFragnoVersion = "^0.0.3";
+const fragnoCliVersion = "^0.1.16";
 
 export const basePkg: Record<string, unknown> = {
   dependencies: {
     "@fragno-dev/core": fragnoCoreVersion,
-    zod: "^4.0.5",
+    zod: "^4.1.12",
   },
   devDependencies: {
-    "@fragno-dev/cli": fragnoCliVersion,
     "@types/node": "^22",
+    "@fragno-dev/cli": fragnoCliVersion,
   },
   peerDependencies: {
-    typescript: "^5",
+    typescript: ">=5",
     react: ">=18.0.0",
     svelte: ">=4.0.0",
     "solid-js": ">=1.0.0",
@@ -24,7 +24,10 @@ export const basePkg: Record<string, unknown> = {
 };
 
 export const databasePkg: Record<string, unknown> = {
-  dependencies: {
+  devDependencies: {
+    "@fragno-dev/db": fragnoDbVersion,
+  },
+  peerDependencies: {
     "@fragno-dev/db": fragnoDbVersion,
   },
 };
@@ -34,7 +37,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   tsdown: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      tsdown: "^0.11.9",
+      tsdown: "^0.12.0",
     },
     scripts: {
       build: "tsdown",
@@ -43,7 +46,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   esbuild: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      esbuild: "^0.25.10",
+      esbuild: "^0.25.12",
     },
     scripts: {
       build: "./esbuild.config.js",
@@ -52,7 +55,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   vite: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      vite: "^6.0.0",
+      vite: "^6.3.5",
     },
     scripts: {
       build: "vite build",
@@ -64,7 +67,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
       "@rollup/plugin-node-resolve": "^16.0.2",
       "@rollup/plugin-typescript": "^12.1.4",
       tslib: "^2.8.1",
-      rollup: "^4.52.4",
+      rollup: "^4.41.0",
     },
     scripts: {
       build: "rollup -c",
@@ -73,7 +76,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   webpack: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      webpack: "^5.102.0",
+      webpack: "^5.99.9",
       "webpack-cli": "^6.0.1",
       "ts-loader": "^9.5.1",
     },
@@ -84,8 +87,8 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   rspack: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      "@rspack/core": "^1.5.8",
-      "@rspack/cli": "^1.5.8",
+      "@rspack/core": "^1.6.1",
+      "@rspack/cli": "^1.6.1",
     },
     scripts: {
       build: "rspack build",

package/templates/fragment/src/index.ts

@@ -61,7 +61,7 @@ const exampleFragmentDefinition = defineFragment<ExampleConfig>("example-fragmen
       serverSideData: { value: config.initialData ?? "Hello World! This is a server-side data." },
     };
   })
-  .withServices(({ deps }) => {
+  .providesService(({ deps }) => {
     return {
       getData: () => deps.serverSideData.value,
     };

package/templates/optional/agent/AGENTS.md

@@ -40,7 +40,7 @@ export function createMyFragment(
 ```
 
 For complete database documentation, see:
-https://fragno.dev/docs/for-library-authors/database-integration/overview.md
+https://fragno.dev/docs/fragno/for-library-authors/database-integration/overview.md
 
 ## File Structure & Core Concepts
 
@@ -96,9 +96,9 @@ client builder.
 
 Each framework requires a separate client file that wraps the generic client builder with the
 framework-specific `useFragno` hook. Check the `src/client/` directory for existing framework
-implementations. Use the frameworks page on https://fragno.dev/docs/frameworks to see if all clients
-have their stubs defined. Make sure to include new frameworks in the exports section of
-package.json.
+implementations. Use the frameworks page on https://fragno.dev/docs/fragno/reference/frameworks to
+see if all clients have their stubs defined. Make sure to include new frameworks in the exports
+section of package.json.
 
 ### `package.json` - Package Configuration
 
@@ -131,17 +131,32 @@ Use `defineFragmentWithDatabase()` when your Fragment needs to:
 Database schemas are defined in a separate `schema.ts` file using the Fragno schema builder:
 
 ```typescript
-import { column, idColumn, schema } from "@fragno-dev/db/schema";
+import { column, idColumn, referenceColumn, schema } from "@fragno-dev/db/schema";
 
 export const noteSchema = schema((s) => {
-  return s.addTable("note", (t) => {
-    return t
-      .addColumn("id", idColumn()) // Auto-generated ID
-      .addColumn("content", column("string"))
-      .addColumn("userId", column("string"))
-      .addColumn("createdAt", column("timestamp").defaultTo$("now"))
-      .createIndex("idx_note_user", ["userId"]); // Index for efficient queries
-  });
+  return s
+    .addTable("users", (t) => {
+      return t.addColumn("id", idColumn()).addColumn("name", column("string"));
+    })
+    .addTable("note", (t) => {
+      return t
+        .addColumn("id", idColumn()) // Auto-generated ID
+        .addColumn("content", column("string"))
+        .addColumn("userId", referenceColumn())
+        .addColumn("createdAt", column("timestamp").defaultTo$("now"))
+        .createIndex("idx_note_user", ["userId"]);
+    })
+    .addReference("author", {
+      from: {
+        table: "note",
+        column: "userId",
+      },
+      to: {
+        table: "user",
+        column: "id",
+      },
+      type: "one",
+    });
 });
 ```
 
@@ -247,7 +262,7 @@ Fragments require code splitting between client and server bundles using
 ### Type Checking
 
 ```bash
-bun run types:check
+pnpm run types:check
 ```
 
 ## Common Patterns

package/templates/optional/builder/esbuild.config.js

@@ -9,6 +9,7 @@ build({
     "./src/client/svelte.ts",
     "./src/client/vanilla.ts",
     "./src/client/vue.ts",
+    "./src/client/solid.ts",
   ],
   outdir: "./dist/browser",
   bundle: true,
@@ -18,7 +19,7 @@ build({
   splitting: true,
   sourcemap: true,
   plugins: [unpluginFragno({ platform: "browser" })],
-  external: ["react", "svelte", "vue", "zod"],
+  external: ["react", "svelte", "vue", "solid-js", "@fragno-dev/db"],
 });
 
 build({
@@ -27,8 +28,7 @@ build({
   bundle: true,
   format: "esm",
   platform: "node",
-  target: "node18",
+  target: "node22",
   sourcemap: true,
   plugins: [unpluginFragno({ platform: "node" })],
-  external: ["zod"],
 });

package/templates/optional/builder/rollup.config.js

@@ -11,6 +11,7 @@ export default [
       "client/svelte": "./src/client/svelte.ts",
       "client/vanilla": "./src/client/vanilla.ts",
       "client/vue": "./src/client/vue.ts",
+      "client/solid": "./src/client/solid.ts",
     },
     output: {
       dir: "./dist/browser",
@@ -18,7 +19,7 @@ export default [
       sourcemap: true,
     },
     // https://rollupjs.org/tools/#peer-dependencies
-    external: ["zod", "react", "svelte", "vue"],
+    external: ["zod", "react", "svelte", "vue", "solid-js", /^@fragno-dev\/db/],
     plugins: [
       resolve({
         moduleDirectories: ["node_modules"],
@@ -41,7 +42,6 @@ export default [
       format: "es",
       sourcemap: true,
     },
-    external: ["zod"],
     plugins: [
       resolve({
         moduleDirectories: ["node_modules"],

package/templates/optional/builder/rspack.config.js

@@ -16,6 +16,7 @@ export default [
       "client/svelte": "./src/client/svelte.ts",
       "client/vanilla": "./src/client/vanilla.ts",
       "client/vue": "./src/client/vue.ts",
+      "client/solid": "./src/client/solid.ts",
     },
     output: {
       path: path.resolve(__dirname, "dist/browser"),
@@ -48,7 +49,7 @@ export default [
     },
     plugins: [unpluginFragno({ platform: "browser" })],
     devtool: "source-map",
-    externals: ["zod", "react", "vue", "svelte"],
+    externals: ["zod", "react", "vue", "svelte", "solid-js", /^@fragno-dev\/db/],
   },
   // Node build
   {
@@ -88,6 +89,6 @@ export default [
     },
     plugins: [unpluginFragno({ platform: "node" })],
     devtool: "source-map",
-    externals: ["zod"],
+    externals: ["zod", /^@fragno-dev\/core/, /^@fragno-dev\/db/],
   },
 ];

package/templates/optional/builder/vite.config.ts

@@ -12,11 +12,12 @@ export default defineConfig({
         "client/svelte": "./src/client/svelte.ts",
         "client/vanilla": "./src/client/vanilla.ts",
         "client/vue": "./src/client/vue.ts",
+        "client/solid": "./src/client/solid.ts",
       },
       formats: ["es"],
     },
     rollupOptions: {
-      external: ["react", "vue", "svelte", "zod"],
+      external: ["react", "vue", "svelte", "solid-js", "zod", /^@fragno-dev\/db/],
     },
     outDir: "./dist/browser",
     sourcemap: true,

package/templates/optional/builder/webpack.config.js

@@ -16,6 +16,7 @@ export default [
       "client/svelte": "./src/client/svelte.ts",
       "client/vanilla": "./src/client/vanilla.ts",
       "client/vue": "./src/client/vue.ts",
+      "client/solid": "./src/client/solid.ts",
     },
     output: {
       path: path.resolve(__dirname, "dist/browser"),
@@ -41,7 +42,7 @@ export default [
     },
     plugins: [unpluginFragno({ platform: "browser" })],
     devtool: "source-map",
-    externals: ["react", "vue", "svelte", "zod"],
+    externals: ["react", "vue", "svelte", "solid-js", "zod", /^@fragno-dev\/db/],
   },
   // Node build
   {
@@ -74,6 +75,6 @@ export default [
     },
     plugins: [unpluginFragno({ platform: "node" })],
     devtool: "source-map",
-    externals: ["zod"],
+    externals: ["zod", /^@fragno-dev\/core/, /^@fragno-dev\/db/],
   },
 ];

package/templates/optional/database/index.ts

@@ -9,7 +9,7 @@ import {
   defineFragmentWithDatabase,
   type FragnoPublicConfigWithDatabase,
 } from "@fragno-dev/db/fragment";
-import type { AbstractQuery, TableToInsertValues } from "@fragno-dev/db/query";
+import type { TableToInsertValues } from "@fragno-dev/db/query";
 import { noteSchema } from "./schema";
 
 // NOTE: We use zod here for defining schemas, but any StandardSchema library can be used!
@@ -46,11 +46,7 @@ type ExampleServices = {
   >;
 };
 
-type ExampleDeps = {
-  orm: AbstractQuery<typeof noteSchema>;
-};
-
-const exampleRoutesFactory = defineRoutes<ExampleConfig, ExampleDeps, ExampleServices>().create(
+const exampleRoutesFactory = defineRoutes<ExampleConfig, {}, ExampleServices>().create(
   ({ services }) => {
     return [
       defineRoute({
@@ -102,10 +98,10 @@ const exampleRoutesFactory = defineRoutes<ExampleConfig, ExampleDeps, ExampleSer
 
 const exampleFragmentDefinition = defineFragmentWithDatabase<ExampleConfig>("example-fragment")
   .withDatabase(noteSchema)
-  .withServices(({ orm }) => {
+  .providesService(({ db }) => {
     return {
       createNote: async (note: TableToInsertValues<typeof noteSchema.tables.note>) => {
-        const id = await orm.create("note", note);
+        const id = await db.create("note", note);
         return {
           ...note,
           id: id.toJSON(),
@@ -113,10 +109,10 @@ const exampleFragmentDefinition = defineFragmentWithDatabase<ExampleConfig>("exa
         };
       },
       getNotes: () => {
-        return orm.find("note", (b) => b);
+        return db.find("note", (b) => b);
       },
       getNotesByUser: (userId: string) => {
-        return orm.find("note", (b) =>
+        return db.find("note", (b) =>
           b.whereIndex("idx_note_user", (eb) => eb("userId", "=", userId)),
         );
       },