@fragno-dev/create 0.0.2 → 0.0.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fragno-dev/create",
   "description": "A library for creating Fragno fragments",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "exports": {
     ".": {
       "bun": "./src/index.ts",
@@ -21,7 +21,7 @@
   },
   "type": "module",
   "dependencies": {
-    "zod": "^4.0.5"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
     "@fragno-private/typescript-config": "0.0.1",

package/src/index.ts

@@ -3,17 +3,34 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { copy, merge } from "./utils.ts";
 import { buildToolPkg } from "./package-json.ts";
+import { z } from "zod";
 
-type TemplateTypes = "fragment";
-// TODO: the others
-export type BuildTools = "esbuild" | "tsdown" | "vite" | "rollup" | "webpack" | "rspack" | "none";
+const templateTypesSchema = z.literal("fragment");
+export type TemplateTypes = z.infer<typeof templateTypesSchema>;
 
-interface CreateOptions {
-  path: string;
-  buildTool: BuildTools;
-  name: string;
-  template: TemplateTypes;
-}
+const buildToolsSchema = z.enum([
+  "esbuild",
+  "tsdown",
+  "vite",
+  "rollup",
+  "webpack",
+  "rspack",
+  "none",
+]);
+export type BuildTools = z.infer<typeof buildToolsSchema>;
+
+const agentDocsSchema = z.enum(["AGENTS.md", "CLAUDE.md", "none"]);
+export type AgentDocs = z.infer<typeof agentDocsSchema>;
+
+export const createOptionsSchema = z.object({
+  path: z.string(),
+  buildTool: buildToolsSchema,
+  name: z.string(),
+  template: templateTypesSchema,
+  agentDocs: agentDocsSchema,
+});
+
+type CreateOptions = z.infer<typeof createOptionsSchema>;
 
 export function create(options: CreateOptions) {
   let pkgOverride: Record<string, unknown> = { name: options.name };
@@ -49,6 +66,17 @@ export function create(options: CreateOptions) {
     case "none":
       break;
   }
+
+  switch (options.agentDocs) {
+    case "AGENTS.md":
+      writeOptionalTemplate(options.path, "agent/AGENTS.md");
+      break;
+    case "CLAUDE.md":
+      writeOptionalTemplate(options.path, "agent/AGENTS.md", "CLAUDE.md");
+      break;
+    case "none":
+      break;
+  }
 }
 
 function getTemplateDir(): string {
@@ -56,9 +84,10 @@ function getTemplateDir(): string {
   return path.join(__dirname, "..", "templates");
 }
 
-function writeOptionalTemplate(targetPath: string, template: string) {
+function writeOptionalTemplate(targetPath: string, template: string, rename?: string) {
   const templatePath = path.join(getTemplateDir(), "optional", template);
-  const targetFile = path.join(targetPath, path.basename(template));
+  const targetFileName = rename ? rename : path.basename(template);
+  const targetFile = path.join(targetPath, targetFileName);
 
   copy(templatePath, targetFile);
 }

package/src/integration.test.ts

@@ -27,6 +27,7 @@ describe.concurrent.each(["tsdown", "esbuild", "vite", "rollup", "webpack", "rsp
       name: "@myorg/test",
       template: "fragment" as const,
       buildTool,
+      agentDocs: "AGENTS.md" as const,
     };
 
     beforeAll(async () => {
@@ -46,6 +47,11 @@ describe.concurrent.each(["tsdown", "esbuild", "vite", "rollup", "webpack", "rsp
         expect(pkgContent).toContain(testConfig.name);
       });
 
+      test("agent file copied", async () => {
+        const agentFile = path.join(tempDir, "AGENTS.md");
+        await expect(fs.access(agentFile)).resolves.toBeUndefined();
+      });
+
       test("installs", { timeout: 10000 }, async () => {
         const { stdout } = await execAsync("bun install", {
           cwd: tempDir,

package/templates/fragment/package.template.json

@@ -2,7 +2,7 @@
   "description": "A Fragno fragment",
   "version": "0.0.1",
   "files": ["dist"],
-  "keywords": ["fragno", "typescript", "react", "vue", "svelte"],
+  "keywords": ["fragno", "typescript", "react", "vue", "svelte", "solidjs"],
   "exports": {
     ".": {
       "types": "./dist/node/index.d.ts",
@@ -32,6 +32,14 @@
       "types": "./dist/browser/client/svelte.d.ts",
       "default": "./dist/browser/client/svelte.js"
     },
+    "./solid": {
+      "development": {
+        "browser": "./dist/browser/client/solid.js",
+        "default": "./src/client/solid.ts"
+      },
+      "types": "./dist/browser/client/solid.d.ts",
+      "default": "./dist/browser/client/solid.js"
+    },
     "./vanilla": {
       "development": {
         "browser": "./dist/browser/client/vanilla.js",
@@ -49,7 +57,7 @@
   },
   "type": "module",
   "dependencies": {
-    "@fragno-dev/core": "^0.0.6",
+    "@fragno-dev/core": "^0.0.7",
     "zod": "^4.0.5"
   },
   "devDependencies": {
@@ -60,6 +68,7 @@
     "typescript": "^5",
     "react": ">=18.0.0",
     "svelte": ">=4.0.0",
+    "solid-js": ">=1.0.0",
     "vue": ">=3.0.0"
   }
 }

package/templates/fragment/src/client/solid.ts

@@ -0,0 +1,7 @@
+import { useFragno } from "@fragno-dev/core/solid";
+import { createExampleFragmentClients } from "..";
+import type { FragnoPublicClientConfig } from "@fragno-dev/core";
+
+export function createExampleFragmentClient(config: FragnoPublicClientConfig = {}) {
+  return useFragno(createExampleFragmentClients(config));
+}

package/templates/fragment/src/index.ts

@@ -13,19 +13,19 @@ import { createClientBuilder } from "@fragno-dev/core/client";
 // https://github.com/standard-schema/standard-schema#what-schema-libraries-implement-the-spec
 import { z } from "zod";
 
-export interface ExampleFragmentServerConfig {
+export interface ExampleConfig {
   initialData?: string;
 }
 
-type ExampleRouteConfig = {
-  initialData: string;
+type ExampleServices = {
+  getData: () => string;
 };
 
-type ExampleRouteDeps = {
+type ExampleDeps = {
   serverSideData: { value: string };
 };
 
-const exampleRoutesFactory = defineRoutes<ExampleRouteConfig, ExampleRouteDeps>().create(
+const exampleRoutesFactory = defineRoutes<ExampleConfig, ExampleDeps, ExampleServices>().create(
   ({ deps }) => {
     const { serverSideData } = deps;
 
@@ -55,8 +55,8 @@ const exampleRoutesFactory = defineRoutes<ExampleRouteConfig, ExampleRouteDeps>(
   },
 );
 
-const exampleFragmentDefinition = defineFragment<ExampleFragmentServerConfig>("example-fragment")
-  .withDependencies((config: ExampleFragmentServerConfig) => {
+const exampleFragmentDefinition = defineFragment<ExampleConfig>("example-fragment")
+  .withDependencies((config: ExampleConfig) => {
     return {
       serverSideData: { value: config.initialData ?? "Hello World! This is a server-side data." },
     };
@@ -68,19 +68,10 @@ const exampleFragmentDefinition = defineFragment<ExampleFragmentServerConfig>("e
   });
 
 export function createExampleFragment(
-  serverConfig: ExampleFragmentServerConfig = {},
+  config: ExampleConfig = {},
   fragnoConfig: FragnoPublicConfig = {},
 ) {
-  const config: ExampleRouteConfig = {
-    initialData: serverConfig.initialData ?? "Hello World! This is a server-side data.",
-  };
-
-  return createFragment(
-    exampleFragmentDefinition,
-    { ...serverConfig, ...config },
-    [exampleRoutesFactory],
-    fragnoConfig,
-  );
+  return createFragment(exampleFragmentDefinition, config, [exampleRoutesFactory], fragnoConfig);
 }
 
 export function createExampleFragmentClients(fragnoConfig: FragnoPublicClientConfig) {

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

@@ -9,6 +9,7 @@ export default defineConfig([
       "./src/index.ts",
       "./src/client/react.ts",
       "./src/client/svelte.ts",
+      "./src/client/solid.ts",
       "./src/client/vanilla.ts",
       "./src/client/vue.ts",
     ],