@warlock.js/core 5.0.1 → 5.1.0

package/esm/generations/features/mysql.feature.mjs

@@ -0,0 +1,9 @@
+//#region ../core/src/generations/features/mysql.feature.ts
+const mysqlFeature = {
+	description: "Installs mysql2 for MySQL database driver (Cascade Package)",
+	dependencies: { mysql2: "^3.5.0" }
+};
+
+//#endregion
+export { mysqlFeature };
+//# sourceMappingURL=mysql.feature.mjs.map

package/esm/generations/features/mysql.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.feature.mjs","names":[],"sources":["../../../../../../../../core/src/generations/features/mysql.feature.ts"],"sourcesContent":["import { FeatureDefinition } from \"./types\";\r\n\r\nexport const mysqlFeature: FeatureDefinition = {\r\n  description: \"Installs mysql2 for MySQL database driver (Cascade Package)\",\r\n  dependencies: {\r\n    mysql2: \"^3.5.0\",\r\n  },\r\n};\r\n"],"mappings":";AAEA,MAAa,eAAkC;CAC7C,aAAa;CACb,cAAc,EACZ,QAAQ,SACV;AACF"}

package/esm/generations/features/notifications.feature.mjs

@@ -0,0 +1,43 @@
+import { srcPath } from "../../utils/paths.mjs";
+import "../../utils/index.mjs";
+import { notificationControllersStub, notificationMigrationStub, notificationModelStub, notificationRoutesStub, notificationsConfigStub } from "../stubs.mjs";
+import { migrationTimestamp } from "./shared/migration-timestamp.mjs";
+import { colors } from "@mongez/copper";
+import { ensureDirectoryAsync, fileExistsAsync, putFileAsync } from "@warlock.js/fs";
+
+//#region ../core/src/generations/features/notifications.feature.ts
+async function completeNotificationsInstallation(_options) {
+	const modelPath = srcPath("app/notifications/notification.model.ts");
+	if (await fileExistsAsync(modelPath)) {
+		console.log(`${colors.yellowBright("src/app/notifications")} already scaffolded, skipping model + migration...`);
+		return;
+	}
+	await ensureDirectoryAsync(srcPath("app/notifications"));
+	await putFileAsync(modelPath, notificationModelStub);
+	console.log(`${colors.green("✓")} Created src/app/notifications/notification.model.ts`);
+	await ensureDirectoryAsync(srcPath("app/notifications/migrations"));
+	const migrationFile = `${migrationTimestamp()}-notification.migration.ts`;
+	await putFileAsync(srcPath("app/notifications/migrations", migrationFile), notificationMigrationStub);
+	console.log(`${colors.green("✓")} Created src/app/notifications/migrations/${migrationFile}`);
+	await ensureDirectoryAsync(srcPath("app/notifications/controllers"));
+	await putFileAsync(srcPath("app/notifications/controllers/notifications.controller.ts"), notificationControllersStub);
+	await putFileAsync(srcPath("app/notifications/routes.ts"), notificationRoutesStub);
+	console.log(`${colors.green("✓")} Created src/app/notifications/routes.ts + controllers`);
+}
+const notificationsFeature = {
+	description: "Installs @warlock.js/notifications — multi-channel notifications (mail + in-app database). Pulls the mail feature, ejects config/notifications.ts, and scaffolds the Notification model + migration plus the recipient-scoped read/dismiss routes + controllers into src/app/notifications",
+	requires: ["mail"],
+	dependencies: {
+		"@warlock.js/notifications": "~4.0.0",
+		"@warlock.js/auth": "~4.0.0"
+	},
+	ejectConfig: {
+		content: notificationsConfigStub,
+		name: "notifications"
+	},
+	onExecuting: completeNotificationsInstallation
+};
+
+//#endregion
+export { notificationsFeature };
+//# sourceMappingURL=notifications.feature.mjs.map

package/esm/generations/features/notifications.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.feature.mjs","names":[],"sources":["../../../../../../../../core/src/generations/features/notifications.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { ensureDirectoryAsync, fileExistsAsync, putFileAsync } from \"@warlock.js/fs\";\r\nimport { CommandActionData } from \"../../commands/types\";\r\nimport { srcPath } from \"../../utils\";\r\nimport {\r\n  notificationControllersStub,\r\n  notificationMigrationStub,\r\n  notificationModelStub,\r\n  notificationRoutesStub,\r\n  notificationsConfigStub,\r\n} from \"../stubs\";\r\nimport { migrationTimestamp } from \"./shared/migration-timestamp\";\r\nimport { FeatureDefinition } from \"./types\";\r\n\r\nasync function completeNotificationsInstallation(_options: CommandActionData) {\r\n  const modelPath = srcPath(\"app/notifications/notification.model.ts\");\r\n\r\n  // The model file is the sentinel for \"notifications already scaffolded\" —\r\n  // its presence means the migration was created too (timestamped, so we must\r\n  // not re-emit a duplicate on a second run).\r\n  if (await fileExistsAsync(modelPath)) {\r\n    console.log(\r\n      `${colors.yellowBright(\"src/app/notifications\")} already scaffolded, skipping model + migration...`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  // 1. Notification model — extends the package's DatabaseNotification base.\r\n  await ensureDirectoryAsync(srcPath(\"app/notifications\"));\r\n  await putFileAsync(modelPath, notificationModelStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/notification.model.ts`);\r\n\r\n  // 2. Migration — timestamped MM-DD-YYYY_HH-MM-SS prefix so cascade infers its\r\n  //    createdAt and orders it deterministically (migrate-action discovers\r\n  //    src/app/*/migrations/*).\r\n  await ensureDirectoryAsync(srcPath(\"app/notifications/migrations\"));\r\n\r\n  const migrationFile = `${migrationTimestamp()}-notification.migration.ts`;\r\n\r\n  await putFileAsync(\r\n    srcPath(\"app/notifications/migrations\", migrationFile),\r\n    notificationMigrationStub,\r\n  );\r\n  console.log(\r\n    `${colors.green(\"✓\")} Created src/app/notifications/migrations/${migrationFile}`,\r\n  );\r\n\r\n  // 3. HTTP surface — the in-app read/dismiss endpoints (routes + controllers),\r\n  //    gated by authMiddleware. Delete if the app exposes notifications another way.\r\n  await ensureDirectoryAsync(srcPath(\"app/notifications/controllers\"));\r\n  await putFileAsync(\r\n    srcPath(\"app/notifications/controllers/notifications.controller.ts\"),\r\n    notificationControllersStub,\r\n  );\r\n  await putFileAsync(srcPath(\"app/notifications/routes.ts\"), notificationRoutesStub);\r\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/routes.ts + controllers`);\r\n}\r\n\r\nexport const notificationsFeature: FeatureDefinition = {\r\n  description:\r\n    \"Installs @warlock.js/notifications — multi-channel notifications (mail + in-app database). Pulls the mail feature, ejects config/notifications.ts, and scaffolds the Notification model + migration plus the recipient-scoped read/dismiss routes + controllers into src/app/notifications\",\r\n  // The ejected config wires a `mail` channel by default (needs nodemailer,\r\n  // via the `mail` feature); the scaffolded routes are gated by\r\n  // `authMiddleware`, so `@warlock.js/auth` is pulled in too.\r\n  requires: [\"mail\"],\r\n  dependencies: {\r\n    \"@warlock.js/notifications\": \"~4.0.0\",\r\n    \"@warlock.js/auth\": \"~4.0.0\",\r\n  },\r\n  ejectConfig: {\r\n    content: notificationsConfigStub,\r\n    name: \"notifications\",\r\n  },\r\n  onExecuting: completeNotificationsInstallation,\r\n};\r\n"],"mappings":";;;;;;;;AAcA,eAAe,kCAAkC,UAA6B;CAC5E,MAAM,YAAY,QAAQ,yCAAyC;CAKnE,IAAI,MAAM,gBAAgB,SAAS,GAAG;EACpC,QAAQ,IACN,GAAG,OAAO,aAAa,uBAAuB,EAAE,mDAClD;EACA;CACF;CAGA,MAAM,qBAAqB,QAAQ,mBAAmB,CAAC;CACvD,MAAM,aAAa,WAAW,qBAAqB;CACnD,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,qDAAqD;CAKtF,MAAM,qBAAqB,QAAQ,8BAA8B,CAAC;CAElE,MAAM,gBAAgB,GAAG,mBAAmB,EAAE;CAE9C,MAAM,aACJ,QAAQ,gCAAgC,aAAa,GACrD,yBACF;CACA,QAAQ,IACN,GAAG,OAAO,MAAM,GAAG,EAAE,4CAA4C,eACnE;CAIA,MAAM,qBAAqB,QAAQ,+BAA+B,CAAC;CACnE,MAAM,aACJ,QAAQ,2DAA2D,GACnE,2BACF;CACA,MAAM,aAAa,QAAQ,6BAA6B,GAAG,sBAAsB;CACjF,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,uDAAuD;AAC1F;AAEA,MAAa,uBAA0C;CACrD,aACE;CAIF,UAAU,CAAC,MAAM;CACjB,cAAc;EACZ,6BAA6B;EAC7B,oBAAoB;CACtB;CACA,aAAa;EACX,SAAS;EACT,MAAM;CACR;CACA,aAAa;AACf"}

package/esm/generations/features/postgres.feature.mjs

@@ -0,0 +1,9 @@
+//#region ../core/src/generations/features/postgres.feature.ts
+const postgresFeature = {
+	description: "Installs pg for Postgres database (Cascade Package)",
+	dependencies: { pg: "^8.11.0" }
+};
+
+//#endregion
+export { postgresFeature };
+//# sourceMappingURL=postgres.feature.mjs.map

package/esm/generations/features/postgres.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.feature.mjs","names":[],"sources":["../../../../../../../../core/src/generations/features/postgres.feature.ts"],"sourcesContent":["import { FeatureDefinition } from \"./types\";\r\n\r\nexport const postgresFeature: FeatureDefinition = {\r\n  description: \"Installs pg for Postgres database (Cascade Package)\",\r\n  dependencies: {\r\n    pg: \"^8.11.0\",\r\n  },\r\n};\r\n"],"mappings":";AAEA,MAAa,kBAAqC;CAChD,aAAa;CACb,cAAc,EACZ,IAAI,UACN;AACF"}

package/esm/generations/features/react-email.feature.mjs

@@ -0,0 +1,70 @@
+import { rootPath } from "../../utils/paths.mjs";
+import "../../utils/index.mjs";
+import { colors } from "@mongez/copper";
+import { ensureDirectoryAsync, fileExistsAsync, getJsonFileAsync, putFileAsync, putJsonFileAsync } from "@warlock.js/fs";
+
+//#region ../core/src/generations/features/react-email.feature.ts
+async function completeReactEmailInstallation(_options) {
+	const emailsFolderPath = rootPath("emails");
+	const sampleEmailPath = rootPath("emails/welcome-email.tsx");
+	if (!await fileExistsAsync(sampleEmailPath)) {
+		await ensureDirectoryAsync(emailsFolderPath);
+		await putFileAsync(sampleEmailPath, `import { Body, Container, Head, Html, Text } from "@react-email/components";
+import { Tailwind } from "@react-email/tailwind";
+
+interface WelcomeEmailProps {
+  name: string;
+}
+
+/**
+ * Sample welcome email component.
+ * Preview with: yarn email:preview
+ */
+export default function WelcomeEmail({ name }: WelcomeEmailProps) {
+  return (
+    <Html>
+      <Head />
+      <Tailwind>
+        <Body className="bg-gray-100 font-sans">
+          <Container className="mx-auto max-w-xl py-8 px-4">
+            <Text className="text-2xl font-bold text-gray-900">
+              Welcome, {name}!
+            </Text>
+            <Text className="text-gray-600 mt-2">
+              You're all set. We're glad to have you on board.
+            </Text>
+          </Container>
+        </Body>
+      </Tailwind>
+    </Html>
+  );
+}
+`);
+		console.log(`${colors.green("✓")} Created emails/welcome-email.tsx`);
+	}
+	const tsconfigPath = rootPath("tsconfig.json");
+	const tsconfig = await getJsonFileAsync(tsconfigPath);
+	if (!tsconfig.include) tsconfig.include = [];
+	if (!tsconfig.include.includes("emails")) {
+		tsconfig.include.push("emails");
+		await putJsonFileAsync(tsconfigPath, tsconfig);
+		console.log(`${colors.green("✓")} Added "emails" to tsconfig.json include`);
+	}
+}
+const reactEmailFeature = {
+	description: "Installs react-email for building email templates with React and Tailwind",
+	requires: ["mail", "react"],
+	dependencies: {
+		"react-email": "^5.2.10",
+		"@react-email/components": "^1.0.11",
+		"@react-email/render": "^2.0.5",
+		"@react-email/tailwind": "^2.0.7"
+	},
+	devDependencies: { "@react-email/preview-server": "5.2.10" },
+	script: { "email:preview": "npx react-email dev" },
+	onExecuting: completeReactEmailInstallation
+};
+
+//#endregion
+export { reactEmailFeature };
+//# sourceMappingURL=react-email.feature.mjs.map

package/esm/generations/features/react-email.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-email.feature.mjs","names":[],"sources":["../../../../../../../../core/src/generations/features/react-email.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport {\r\n  ensureDirectoryAsync,\r\n  fileExistsAsync,\r\n  getJsonFileAsync,\r\n  putFileAsync,\r\n  putJsonFileAsync,\r\n} from \"@warlock.js/fs\";\r\nimport { CommandActionData } from \"../../commands/types\";\r\nimport { rootPath } from \"../../utils\";\r\nimport { FeatureDefinition } from \"./types\";\r\n\r\n/**\r\n * The part of a project `tsconfig.json` this action patches.\r\n */\r\ntype ProjectTsConfig = {\r\n  include?: string[];\r\n};\r\n\r\nasync function completeReactEmailInstallation(_options: CommandActionData) {\r\n  // 1. Create emails/ folder with a sample component\r\n  const emailsFolderPath = rootPath(\"emails\");\r\n  const sampleEmailPath = rootPath(\"emails/welcome-email.tsx\");\r\n\r\n  if (!(await fileExistsAsync(sampleEmailPath))) {\r\n    await ensureDirectoryAsync(emailsFolderPath);\r\n    await putFileAsync(\r\n      sampleEmailPath,\r\n      `import { Body, Container, Head, Html, Text } from \"@react-email/components\";\r\nimport { Tailwind } from \"@react-email/tailwind\";\r\n\r\ninterface WelcomeEmailProps {\r\n  name: string;\r\n}\r\n\r\n/**\r\n * Sample welcome email component.\r\n * Preview with: yarn email:preview\r\n */\r\nexport default function WelcomeEmail({ name }: WelcomeEmailProps) {\r\n  return (\r\n    <Html>\r\n      <Head />\r\n      <Tailwind>\r\n        <Body className=\"bg-gray-100 font-sans\">\r\n          <Container className=\"mx-auto max-w-xl py-8 px-4\">\r\n            <Text className=\"text-2xl font-bold text-gray-900\">\r\n              Welcome, {name}!\r\n            </Text>\r\n            <Text className=\"text-gray-600 mt-2\">\r\n              You're all set. We're glad to have you on board.\r\n            </Text>\r\n          </Container>\r\n        </Body>\r\n      </Tailwind>\r\n    </Html>\r\n  );\r\n}\r\n`,\r\n    );\r\n    console.log(`${colors.green(\"✓\")} Created emails/welcome-email.tsx`);\r\n  }\r\n\r\n  // 2. Patch tsconfig.json — add \"emails\" to include if missing\r\n  const tsconfigPath = rootPath(\"tsconfig.json\");\r\n  const tsconfig = await getJsonFileAsync<ProjectTsConfig>(tsconfigPath);\r\n\r\n  if (!tsconfig.include) {\r\n    tsconfig.include = [];\r\n  }\r\n\r\n  if (!tsconfig.include.includes(\"emails\")) {\r\n    tsconfig.include.push(\"emails\");\r\n    await putJsonFileAsync(tsconfigPath, tsconfig);\r\n    console.log(`${colors.green(\"✓\")} Added \"emails\" to tsconfig.json include`);\r\n  }\r\n}\r\n\r\nexport const reactEmailFeature: FeatureDefinition = {\r\n  description: \"Installs react-email for building email templates with React and Tailwind\",\r\n  requires: [\"mail\", \"react\"],\r\n  dependencies: {\r\n    \"react-email\": \"^5.2.10\",\r\n    \"@react-email/components\": \"^1.0.11\",\r\n    \"@react-email/render\": \"^2.0.5\",\r\n    \"@react-email/tailwind\": \"^2.0.7\",\r\n  },\r\n  devDependencies: {\r\n    \"@react-email/preview-server\": \"5.2.10\",\r\n  },\r\n  script: {\r\n    \"email:preview\": \"npx react-email dev\",\r\n  },\r\n  onExecuting: completeReactEmailInstallation,\r\n};\r\n"],"mappings":";;;;;;AAmBA,eAAe,+BAA+B,UAA6B;CAEzE,MAAM,mBAAmB,SAAS,QAAQ;CAC1C,MAAM,kBAAkB,SAAS,0BAA0B;CAE3D,IAAI,CAAE,MAAM,gBAAgB,eAAe,GAAI;EAC7C,MAAM,qBAAqB,gBAAgB;EAC3C,MAAM,aACJ,iBACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BF;EACA,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,kCAAkC;CACrE;CAGA,MAAM,eAAe,SAAS,eAAe;CAC7C,MAAM,WAAW,MAAM,iBAAkC,YAAY;CAErE,IAAI,CAAC,SAAS,SACZ,SAAS,UAAU,CAAC;CAGtB,IAAI,CAAC,SAAS,QAAQ,SAAS,QAAQ,GAAG;EACxC,SAAS,QAAQ,KAAK,QAAQ;EAC9B,MAAM,iBAAiB,cAAc,QAAQ;EAC7C,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,yCAAyC;CAC5E;AACF;AAEA,MAAa,oBAAuC;CAClD,aAAa;CACb,UAAU,CAAC,QAAQ,OAAO;CAC1B,cAAc;EACZ,eAAe;EACf,2BAA2B;EAC3B,uBAAuB;EACvB,yBAAyB;CAC3B;CACA,iBAAiB,EACf,+BAA+B,SACjC;CACA,QAAQ,EACN,iBAAiB,sBACnB;CACA,aAAa;AACf"}

package/esm/generations/features/react.feature.mjs

@@ -0,0 +1,16 @@
+//#region ../core/src/generations/features/react.feature.ts
+const reactFeature = {
+	description: "Installs React and React dom for rendering React components (non-interactive), useful for sending mails and generating HTML",
+	dependencies: {
+		react: "^19.2.3",
+		"react-dom": "^19.2.3"
+	},
+	devDependencies: {
+		"@types/react": "^19.2.7",
+		"@types/react-dom": "^19.2.3"
+	}
+};
+
+//#endregion
+export { reactFeature };
+//# sourceMappingURL=react.feature.mjs.map

package/esm/generations/features/react.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.feature.mjs","names":[],"sources":["../../../../../../../../core/src/generations/features/react.feature.ts"],"sourcesContent":["import { FeatureDefinition } from \"./types\";\r\n\r\nexport const reactFeature: FeatureDefinition = {\r\n  description:\r\n    \"Installs React and React dom for rendering React components (non-interactive), useful for sending mails and generating HTML\",\r\n  dependencies: {\r\n    react: \"^19.2.3\",\r\n    \"react-dom\": \"^19.2.3\",\r\n  },\r\n  devDependencies: {\r\n    \"@types/react\": \"^19.2.7\",\r\n    \"@types/react-dom\": \"^19.2.3\",\r\n  },\r\n};\r\n"],"mappings":";AAEA,MAAa,eAAkC;CAC7C,aACE;CACF,cAAc;EACZ,OAAO;EACP,aAAa;CACf;CACA,iBAAiB;EACf,gBAAgB;EAChB,oBAAoB;CACtB;AACF"}

package/esm/generations/features/redis.feature.mjs

@@ -0,0 +1,9 @@
+//#region ../core/src/generations/features/redis.feature.ts
+const redisFeature = {
+	description: "Installs redis for Redis cache driver (Cache Package)",
+	dependencies: { redis: "^4.6.13" }
+};
+
+//#endregion
+export { redisFeature };
+//# sourceMappingURL=redis.feature.mjs.map

package/esm/generations/features/redis.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.feature.mjs","names":[],"sources":["../../../../../../../../core/src/generations/features/redis.feature.ts"],"sourcesContent":["import { FeatureDefinition } from \"./types\";\r\n\r\nexport const redisFeature: FeatureDefinition = {\r\n  description: \"Installs redis for Redis cache driver (Cache Package)\",\r\n  dependencies: {\r\n    redis: \"^4.6.13\",\r\n  },\r\n};\r\n"],"mappings":";AAEA,MAAa,eAAkC;CAC7C,aAAa;CACb,cAAc,EACZ,OAAO,UACT;AACF"}

package/esm/generations/features/s3.feature.mjs

@@ -0,0 +1,13 @@
+//#region ../core/src/generations/features/s3.feature.ts
+const s3Feature = {
+	description: "Installs AWS SDK for Cloud storage (Storage Package)",
+	dependencies: {
+		"@aws-sdk/client-s3": "^3.955.0",
+		"@aws-sdk/lib-storage": "^3.955.0",
+		"@aws-sdk/s3-request-presigner": "^3.955.0"
+	}
+};
+
+//#endregion
+export { s3Feature };
+//# sourceMappingURL=s3.feature.mjs.map

package/esm/generations/features/s3.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.feature.mjs","names":[],"sources":["../../../../../../../../core/src/generations/features/s3.feature.ts"],"sourcesContent":["import { FeatureDefinition } from \"./types\";\r\n\r\nexport const s3Feature: FeatureDefinition = {\r\n  description: \"Installs AWS SDK for Cloud storage (Storage Package)\",\r\n  dependencies: {\r\n    \"@aws-sdk/client-s3\": \"^3.955.0\",\r\n    \"@aws-sdk/lib-storage\": \"^3.955.0\",\r\n    \"@aws-sdk/s3-request-presigner\": \"^3.955.0\",\r\n  },\r\n};\r\n"],"mappings":";AAEA,MAAa,YAA+B;CAC1C,aAAa;CACb,cAAc;EACZ,sBAAsB;EACtB,wBAAwB;EACxB,iCAAiC;CACnC;AACF"}

package/esm/generations/features/scheduler.feature.mjs

@@ -0,0 +1,9 @@
+//#region ../core/src/generations/features/scheduler.feature.ts
+const schedulerFeature = {
+	description: "Installs warlock scheduler for scheduling tasks",
+	dependencies: { "@warlock.js/scheduler": "~4.0.0" }
+};
+
+//#endregion
+export { schedulerFeature };
+//# sourceMappingURL=scheduler.feature.mjs.map

package/esm/generations/features/scheduler.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.feature.mjs","names":[],"sources":["../../../../../../../../core/src/generations/features/scheduler.feature.ts"],"sourcesContent":["import { FeatureDefinition } from \"./types\";\r\n\r\nexport const schedulerFeature: FeatureDefinition = {\r\n  description: \"Installs warlock scheduler for scheduling tasks\",\r\n  dependencies: {\r\n    \"@warlock.js/scheduler\": \"~4.0.0\",\r\n  },\r\n};\r\n"],"mappings":";AAEA,MAAa,mBAAsC;CACjD,aAAa;CACb,cAAc,EACZ,yBAAyB,SAC3B;AACF"}

package/esm/generations/features/ses.feature.mjs

@@ -0,0 +1,9 @@
+//#region ../core/src/generations/features/ses.feature.ts
+const sesFeature = {
+	description: "Installs AWS SES SDK for sending emails via Amazon SES",
+	dependencies: { "@aws-sdk/client-sesv2": "^3.1025.0" }
+};
+
+//#endregion
+export { sesFeature };
+//# sourceMappingURL=ses.feature.mjs.map

package/esm/generations/features/ses.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ses.feature.mjs","names":[],"sources":["../../../../../../../../core/src/generations/features/ses.feature.ts"],"sourcesContent":["import { FeatureDefinition } from \"./types\";\r\n\r\nexport const sesFeature: FeatureDefinition = {\r\n  description: \"Installs AWS SES SDK for sending emails via Amazon SES\",\r\n  dependencies: {\r\n    \"@aws-sdk/client-sesv2\": \"^3.1025.0\",\r\n  },\r\n};\r\n"],"mappings":";AAEA,MAAa,aAAgC;CAC3C,aAAa;CACb,cAAc,EACZ,yBAAyB,YAC3B;AACF"}

package/esm/generations/features/shadcn.feature.mjs

@@ -0,0 +1,397 @@
+import { rootPath, srcPath } from "../../utils/paths.mjs";
+import "../../utils/index.mjs";
+import { colors } from "@mongez/copper";
+import { ensureDirectoryAsync, fileExistsAsync, getFileAsync, putFileAsync } from "@warlock.js/fs";
+
+//#region ../core/src/generations/features/shadcn.feature.ts
+/**
+* `warlock add shadcn` installs the PREREQUISITES for shadcn/ui. It does not
+* wrap `shadcn add`, and it never will.
+*
+* shadcn/ui is a copy-in generator with its own CLI and its own registry, not a
+* dependency: components are written into your source tree and become yours the
+* moment they land. Wrapping their CLI would make their moving target our bug
+* reports, for a command that adds nothing but a rename.
+*
+* What is worth owning is the part their CLI gets wrong here. Measured against
+* this framework's layout on 2026-08-25, `shadcn add button card` exited 0 and
+* produced components that rendered COMPLETELY UNSTYLED. It writes components
+* that import `cn` and reference `bg-primary` / `ring-ring`, but only
+* `shadcn init` creates `lib/utils` and the theme tokens those names resolve
+* against. The class was in the generated CSS and the element carried it, and
+* the rule still evaluated to an empty `var()` — a silent failure with a zero
+* exit code, which is the worst kind to hand a user.
+*
+* So this feature ships the five things that make `npx shadcn add <component>`
+* work the first time:
+*
+*   1. `components.json` written for OUR layout (their defaults assume `src/app`
+*      or a bare `components/`, neither of which is where pages live here).
+*   2. `src/web/lib/utils.ts` exporting `cn`.
+*   3. The design tokens appended to `src/web/app.css`.
+*   4. A `web/*` entry in tsconfig `paths`, so the generated imports typecheck.
+*   5. The packages `init` would have installed — see `printNextStep` below.
+*      Skipping `init` is correct; skipping its dependency list was a bug, and
+*      it cost a generated button that imports `cva` and cannot compile.
+*
+* After that, the user talks to shadcn directly, and their docs are true.
+*/
+/**
+* The aliases shadcn's CLI rewrites every generated import against.
+*
+* These are the whole reason this feature exists. shadcn's defaults do not fit
+* `src/web`, and no user would guess this mapping: the alias keys are shadcn's
+* vocabulary, the values are tsconfig `paths` prefixes (hence `web/...`, not
+* `src/web/...`), and `tailwind.css` is a real path from the project root
+* (hence `src/web/app.css`, WITH the `src`). Getting one of them wrong produces
+* components in the wrong folder importing `cn` from somewhere that does not
+* exist.
+*
+* `tailwind.config` is deliberately empty: v4 is CSS-first and there is no
+* config file for it to point at. `rsc: false` because these are SSR React
+* pages rendered by the Warlock HTTP server, not React Server Components.
+*/
+const componentsJsonStub = `{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/web/app.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "web/components",
+    "utils": "web/lib/utils",
+    "ui": "web/components/ui",
+    "lib": "web/lib",
+    "hooks": "web/hooks"
+  },
+  "iconLibrary": "lucide"
+}
+`;
+/**
+* `cn` — the one import every single shadcn component makes.
+*
+* `clsx` resolves the conditional/array/object class syntax, and `tailwind-merge`
+* then de-duplicates conflicting Tailwind utilities so a caller's `className`
+* actually beats the component's own default rather than depending on which one
+* happens to come later in the generated stylesheet. Both halves are required:
+* clsx alone leaves `px-2 px-4` in the attribute and the loser wins at random.
+*/
+const cnUtilStub = `import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/**
+ * Merge class names, with later Tailwind utilities winning over earlier ones.
+ *
+ * Every shadcn/ui component imports this. Keep the export name and signature.
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+`;
+/**
+* Marker for "the tokens are already in this stylesheet".
+*
+* A comment rather than a token name, because a user is free to retune every
+* value below and we must still recognise our own block on a re-run.
+*/
+const SHADCN_TOKENS_MARKER = "shadcn/ui design tokens";
+/**
+* The shadcn token set, as a plain `@theme` block with LITERAL values.
+*
+* Not `@theme inline` over `:root` custom properties, which is what shadcn's own
+* `init` writes. That form was verified against this stylesheet pipeline on
+* 2026-08-25 and it produces utilities that resolve to nothing: the class is in
+* the generated CSS, the class is on the element, and the rule still evaluates
+* to an empty `var()`. Literal values in `@theme` are what make `bg-primary`
+* emit a colour instead of a dangling reference.
+*
+* Dark mode still works, and works the way shadcn expects: `@theme` emits these
+* as real custom properties, so the `.dark` block re-declares the same
+* `--color-*` names and the cascade does the rest. `@custom-variant dark` is
+* what points Tailwind's `dark:` prefix at that class instead of the OS setting.
+*
+* Values are shadcn's `neutral` base. They are the starting point, not the
+* answer — this is the block to edit when the project gets a real palette.
+*/
+const shadcnTokensStub = `
+/* ${SHADCN_TOKENS_MARKER} — edit freely, this is your palette now.
+
+   These are LITERAL values in a plain @theme block, on purpose. shadcn's own
+   \`init\` writes \`@theme inline\` over :root custom properties; that form emits
+   utilities which resolve to an empty var() here, so every component renders
+   unstyled while the class sits right there on the element. Do not convert it.
+*/
+@custom-variant dark (&:is(.dark *));
+
+@theme {
+  --color-background: oklch(1 0 0);
+  --color-foreground: oklch(0.145 0 0);
+  --color-card: oklch(1 0 0);
+  --color-card-foreground: oklch(0.145 0 0);
+  --color-popover: oklch(1 0 0);
+  --color-popover-foreground: oklch(0.145 0 0);
+  --color-primary: oklch(0.205 0 0);
+  --color-primary-foreground: oklch(0.985 0 0);
+  --color-secondary: oklch(0.97 0 0);
+  --color-secondary-foreground: oklch(0.205 0 0);
+  --color-muted: oklch(0.97 0 0);
+  --color-muted-foreground: oklch(0.556 0 0);
+  --color-accent: oklch(0.97 0 0);
+  --color-accent-foreground: oklch(0.205 0 0);
+  --color-destructive: oklch(0.577 0.245 27.325);
+  --color-destructive-foreground: oklch(0.985 0 0);
+  --color-border: oklch(0.922 0 0);
+  --color-input: oklch(0.922 0 0);
+  --color-ring: oklch(0.708 0 0);
+
+  --color-chart-1: oklch(0.646 0.222 41.116);
+  --color-chart-2: oklch(0.6 0.118 184.704);
+  --color-chart-3: oklch(0.398 0.07 227.392);
+  --color-chart-4: oklch(0.828 0.189 84.429);
+  --color-chart-5: oklch(0.769 0.188 70.08);
+
+  --color-sidebar: oklch(0.985 0 0);
+  --color-sidebar-foreground: oklch(0.145 0 0);
+  --color-sidebar-primary: oklch(0.205 0 0);
+  --color-sidebar-primary-foreground: oklch(0.985 0 0);
+  --color-sidebar-accent: oklch(0.97 0 0);
+  --color-sidebar-accent-foreground: oklch(0.205 0 0);
+  --color-sidebar-border: oklch(0.922 0 0);
+  --color-sidebar-ring: oklch(0.708 0 0);
+
+  /* shadcn components reach for rounded-lg/md/sm and expect them to track one
+     radius. Changing --radius-lg here also retunes Tailwind's own rounded-lg,
+     which is the intended trade: one radius scale per project, not two. */
+  --radius-sm: 0.375rem;
+  --radius-md: 0.5rem;
+  --radius-lg: 0.625rem;
+  --radius-xl: 1rem;
+}
+
+.dark {
+  --color-background: oklch(0.145 0 0);
+  --color-foreground: oklch(0.985 0 0);
+  --color-card: oklch(0.205 0 0);
+  --color-card-foreground: oklch(0.985 0 0);
+  --color-popover: oklch(0.205 0 0);
+  --color-popover-foreground: oklch(0.985 0 0);
+  --color-primary: oklch(0.922 0 0);
+  --color-primary-foreground: oklch(0.205 0 0);
+  --color-secondary: oklch(0.269 0 0);
+  --color-secondary-foreground: oklch(0.985 0 0);
+  --color-muted: oklch(0.269 0 0);
+  --color-muted-foreground: oklch(0.708 0 0);
+  --color-accent: oklch(0.269 0 0);
+  --color-accent-foreground: oklch(0.985 0 0);
+  --color-destructive: oklch(0.704 0.191 22.216);
+  --color-destructive-foreground: oklch(0.985 0 0);
+  --color-border: oklch(1 0 0 / 10%);
+  --color-input: oklch(1 0 0 / 15%);
+  --color-ring: oklch(0.556 0 0);
+
+  --color-chart-1: oklch(0.488 0.243 264.376);
+  --color-chart-2: oklch(0.696 0.17 162.48);
+  --color-chart-3: oklch(0.769 0.188 70.08);
+  --color-chart-4: oklch(0.627 0.265 303.9);
+  --color-chart-5: oklch(0.645 0.246 16.439);
+
+  --color-sidebar: oklch(0.205 0 0);
+  --color-sidebar-foreground: oklch(0.985 0 0);
+  --color-sidebar-primary: oklch(0.488 0.243 264.376);
+  --color-sidebar-primary-foreground: oklch(0.985 0 0);
+  --color-sidebar-accent: oklch(0.269 0 0);
+  --color-sidebar-accent-foreground: oklch(0.985 0 0);
+  --color-sidebar-border: oklch(1 0 0 / 10%);
+  --color-sidebar-ring: oklch(0.556 0 0);
+}
+`;
+/**
+* Write `components.json` — the sentinel for "this feature already ran".
+*
+* Nothing in the project template creates this file, so its presence means
+* `add shadcn` has been here and a human may since have retuned the aliases,
+* the style, or the base colour. It is never rewritten: shadcn's CLI reads this
+* file on every `add`, so overwriting it would silently relocate a project's
+* component folder out from under the components already in it.
+*/
+async function writeComponentsJson() {
+	const componentsJsonPath = rootPath("components.json");
+	if (await fileExistsAsync(componentsJsonPath)) {
+		console.log(`${colors.yellowBright("components.json")} already exists, skipping...`);
+		return;
+	}
+	await putFileAsync(componentsJsonPath, componentsJsonStub);
+	console.log(`${colors.green("✓")} Created components.json`);
+}
+/**
+* Write `src/web/lib/utils.ts`.
+*
+* Guarded on its own rather than on the sentinel above, because `lib/utils` is
+* a name a project may well already own — and if it does, whatever is in there
+* is user code with other callers. We print instead of merging.
+*/
+async function writeCnUtil() {
+	const utilsFile = srcPath("web/lib/utils.ts");
+	if (await fileExistsAsync(utilsFile)) {
+		const current = await getFileAsync(utilsFile).catch(() => "");
+		if (/export\s+(function|const)\s+cn\b/.test(current)) console.log(`${colors.yellowBright("src/web/lib/utils.ts")} already exports cn, skipping...`);
+		else console.log(`${colors.yellowBright("!")} ${colors.yellowBright("src/web/lib/utils.ts")} exists but does not export ${colors.yellowBright("cn")} — add it yourself:\n  export function cn(...inputs: ClassValue[]) { return twMerge(clsx(inputs)); }
+  Every shadcn component imports it, and none of them will compile until it is there.`);
+		return;
+	}
+	await ensureDirectoryAsync(srcPath("web/lib"));
+	await putFileAsync(utilsFile, cnUtilStub);
+	console.log(`${colors.green("✓")} Created src/web/lib/utils.ts`);
+}
+/**
+* Append the token block to `src/web/app.css`.
+*
+* The stylesheet is guaranteed to exist by the time this runs: `requires:
+* ["tailwind"]` makes the add command resolve `tailwind` first and run its
+* `onExecuting` ahead of this one, and that is what creates the file. The check
+* below is for a stylesheet a human has since moved or deleted — worth a
+* printed instruction, not a failure.
+*
+* Appended, never rewritten. Everything already in that file is either
+* Tailwind's own `@import` or the project's design system.
+*/
+async function appendThemeTokens() {
+	const cssFile = srcPath("web/app.css");
+	if (!await fileExistsAsync(cssFile)) {
+		console.log(`${colors.yellowBright("!")} ${colors.yellowBright("src/web/app.css")} not found — append the shadcn token block to your Tailwind stylesheet yourself.
+  Without the tokens, shadcn components render unstyled: the classes are emitted and applied, but \`bg-primary\` and friends resolve to an empty var().`);
+		return;
+	}
+	const current = await getFileAsync(cssFile);
+	if (current.includes(SHADCN_TOKENS_MARKER) || current.includes("--color-primary-foreground")) {
+		console.log(`${colors.yellowBright("src/web/app.css")} already has the tokens, skipping...`);
+		return;
+	}
+	await putFileAsync(cssFile, `${current.trimEnd()}\n${shadcnTokensStub}`);
+	console.log(`${colors.green("✓")} Appended the shadcn tokens to src/web/app.css`);
+}
+/** The tsconfig `paths` entry the generated imports resolve through. */
+const WEB_PATH_ALIAS = "\"web/*\": [\"./src/web/*\"]";
+/**
+* Add `web/*` to tsconfig `compilerOptions.paths`.
+*
+* The template declares only `app/*`, so every import shadcn generates against
+* the aliases above (`web/lib/utils`, `web/components/ui/button`) would fail to
+* typecheck the moment it lands. This is the first `add` feature to patch
+* `paths` rather than `include`.
+*
+* String surgery, and NOT the parse-and-write that the `include` patches use.
+* The project template's `tsconfig.json` carries `//` comments — it is JSONC,
+* and `JSON.parse` throws on it — so a parse-first patch would fail on exactly
+* the projects this feature is for. Editing the text also preserves those
+* comments, which are load-bearing documentation in that file.
+*/
+async function addWebPathAlias() {
+	const tsconfigPath = rootPath("tsconfig.json");
+	const printManualInstruction = (reason) => {
+		console.log(`${colors.yellowBright("!")} ${colors.yellowBright("tsconfig.json")} ${reason} — add this to \`compilerOptions.paths\` yourself:
+  ${WEB_PATH_ALIAS}\n  Without it, every import shadcn generates against the \`web/*\` aliases fails to typecheck.`);
+	};
+	if (!await fileExistsAsync(tsconfigPath)) {
+		printManualInstruction("not found");
+		return;
+	}
+	const current = await getFileAsync(tsconfigPath);
+	if (/["']web\/\*["']\s*:/.test(current)) {
+		console.log(`${colors.yellowBright("tsconfig.json")} already maps web/*, skipping...`);
+		return;
+	}
+	let next;
+	if (/"paths"\s*:\s*\{/.test(current)) next = current.replace(/"paths"\s*:\s*\{/, `$&\n      ${WEB_PATH_ALIAS},`);
+	else if (/"compilerOptions"\s*:\s*\{/.test(current)) next = current.replace(/"compilerOptions"\s*:\s*\{/, `$&\n    "paths": {\n      ${WEB_PATH_ALIAS}\n    },`);
+	else {
+		printManualInstruction("has no recognisable compilerOptions block");
+		return;
+	}
+	await putFileAsync(tsconfigPath, next);
+	console.log(`${colors.green("✓")} Added ${WEB_PATH_ALIAS} to tsconfig.json paths`);
+}
+/**
+* Tell the user the next command is theirs to run.
+*
+* This is the seam. Everything above is prerequisite; from here the shadcn docs
+* apply verbatim, which is the entire point of not wrapping their CLI.
+*
+* WHY THIS FEATURE DECLARES cva AND lucide-react, and where the list came from.
+*
+* shadcn's registry splits dependencies across two levels. Each component item
+* (`.../new-york-v4/button.json`) declares only what that file pulls beyond the
+* baseline — for button, `radix-ui` and nothing else. Everything the baseline
+* assumes lives on the STYLE INDEX (`.../new-york-v4/index.json`), which is
+* fetched by `init` and only by `init`:
+*
+*   dependencies:    class-variance-authority, lucide-react, radix-ui
+*   devDependencies: tw-animate-css, shadcn
+*
+* We skip `init` on purpose — it would rewrite components.json and replace the
+* literal tokens with the `@theme inline` block that resolves to nothing here.
+* Skipping it is right; inheriting nothing from it was the bug. `shadcn add
+* button` exits 0 and writes `import { cva } from "class-variance-authority"`
+* against a package no one installed. Zero exit code, TS2307, blank page.
+*
+* `radix-ui` stays off our list: it is the one style-index dependency that is
+* ALSO declared per-component, so `add` really does install it on demand, and
+* declaring it here would pull the whole primitive set into projects using two
+* components. `shadcn` itself stays off too — it is the CLI, and the user is
+* invoking it via `npx`.
+*
+* `tw-animate-css` was checked and deliberately EXCLUDED. It is not imported by
+* any component; it is a plain stylesheet whose only entry point is the
+* `@import "tw-animate-css"` line that `init` writes into the CSS — and we do
+* not write that line, so the package would install and never load. Nothing
+* fails to compile or render without it. What you lose is the enter/exit
+* animation on overlay components (dialog, dropdown, tooltip, sheet): their
+* `animate-in` / `fade-in-0` classes are simply never generated, so the overlay
+* appears instantly instead of fading. That is opt-in, and the note below is how
+* a user opts in — the `@import` has to go at the TOP of app.css, next to
+* Tailwind's own, which is why this feature cannot append it to the token block.
+*/
+function printNextStep() {
+	console.log(`\n${colors.green("✓")} shadcn/ui prerequisites are in place. Add components with shadcn's own CLI:\n  ${colors.yellowBright("npx shadcn@latest add button card")}\n  Skip \`shadcn init\` — this feature did its job, and running it would rewrite components.json
+  and replace the theme tokens with an \`@theme inline\` block that resolves to nothing here.
+  ${colors.yellowBright("class-variance-authority")} and ${colors.yellowBright("lucide-react")} are already installed: shadcn declares\n  them on the style index that only \`init\` reads, so \`add\` would never install them for you.
+  ${colors.yellowBright("radix-ui")} (the unified package, not @radix-ui/react-*) IS declared per component,\n  so shadcn's CLI installs that one itself as each component needs it.
+  For overlay animations, add ${colors.yellowBright("tw-animate-css")} and put ${colors.yellowBright("@import \"tw-animate-css\";")}\n  at the TOP of src/web/app.css, under the Tailwind import. Without it dialogs and dropdowns
+  still work, they just appear instantly instead of animating.`);
+}
+/**
+* Lay the ground shadcn's CLI expects to find, and nothing more.
+*
+* Four files, none of which needs `node_modules` to be populated: on the
+* `create-warlock` path this runs under `--no-install`, so the dependencies
+* declared below are only recorded in `package.json` and nothing here may
+* import, resolve, or execute shadcn, clsx, or Tailwind.
+*/
+async function completeShadcnInstallation(_options) {
+	await writeComponentsJson();
+	await writeCnUtil();
+	await appendThemeTokens();
+	await addWebPathAlias();
+	printNextStep();
+}
+const shadcnFeature = {
+	description: "Sets up the prerequisites for shadcn/ui so `npx shadcn add <component>` works first time: components.json aliased to src/web, src/web/lib/utils.ts (cn), the design tokens in src/web/app.css, and a web/* tsconfig path. It does NOT wrap shadcn's CLI — components stay theirs to generate and yours to own.",
+	requires: ["tailwind"],
+	dependencies: {
+		clsx: "^2.1.1",
+		"tailwind-merge": "^3.3.1",
+		"class-variance-authority": "^0.7.1",
+		"lucide-react": "^1.34.0"
+	},
+	onExecuting: completeShadcnInstallation
+};
+
+//#endregion
+export { shadcnFeature };
+//# sourceMappingURL=shadcn.feature.mjs.map