create-warlock 5.2.3 → 5.3.0

package/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../create-warlock/src/index.ts"],"sourcesContent":["import { getJsonFile } from \"@warlock.js/fs\";\nimport createNewApp from \"./commands/create-new-app\";\nimport { CliFlags } from \"./commands/create-new-app/types\";\nimport { NO_DATABASE } from \"./features/database-drivers\";\nimport { packageRoot } from \"./helpers/paths\";\n\nconst valueFlags = [\"name\", \"db\", \"pm\", \"features\", \"ai\"];\n\nconst HELP_TEXT = `\n  create-warlock — scaffold a new Warlock.js project\n\n  Usage\n    $ create-warlock [project-name] [options]\n\n  Options\n    --name              Project name (or pass it as the first positional arg)\n    --db=<driver>        Database driver (e.g. postgres, mongodb)\n    --no-db               Skip database selection entirely\n    --features=<list>    Comma-separated feature keys (e.g. test,herald)\n    --ai=<list>           Comma-separated AI provider keys (e.g. openai,anthropic)\n    --pm=<manager>        Package manager to use (npm, yarn, pnpm)\n    --git / --no-git      Force-enable or force-disable git initialization\n    --jwt / --no-jwt      Force-enable or force-disable JWT secret generation\n    -y, --yes             Skip prompts and accept defaults for anything unset\n    -h, --help            Show this help message and exit\n    -v, --version         Show the installed create-warlock version and exit\n\n  Example\n    $ create-warlock my-app --db=postgres --features=test,herald --yes\n`;\n\n/**\n * Parse the scaffolder's own CLI flags for non-interactive mode.\n *\n * @example\n * create-warlock my-app --db=postgres --features=test,herald --ai=openai,anthropic --yes\n */\nexport function parseFlags(argv: string[]): CliFlags {\n  const flags: CliFlags = {};\n  const positionals: string[] = [];\n\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n\n    if (!arg.startsWith(\"-\")) {\n      positionals.push(arg);\n      continue;\n    }\n\n    const equalIndex = arg.indexOf(\"=\");\n    const key = (equalIndex === -1 ? arg : arg.slice(0, equalIndex)).replace(/^-+/, \"\");\n    let value: string | undefined = equalIndex === -1 ? undefined : arg.slice(equalIndex + 1);\n\n    // Value-taking flags may use either `--key=value` or `--key value`.\n    if (valueFlags.includes(key) && value === undefined) {\n      const next = argv[i + 1];\n\n      if (next && !next.startsWith(\"-\")) {\n        value = next;\n        i++;\n      }\n    }\n\n    switch (key) {\n      case \"help\":\n      case \"h\":\n        flags.help = true;\n        break;\n      case \"version\":\n      case \"v\":\n        flags.version = true;\n        break;\n      case \"yes\":\n      case \"y\":\n        flags.yes = true;\n        break;\n      case \"git\":\n        flags.git = true;\n        break;\n      case \"no-git\":\n        flags.git = false;\n        break;\n      case \"jwt\":\n        flags.jwt = true;\n        break;\n      case \"no-jwt\":\n        flags.jwt = false;\n        break;\n      case \"name\":\n        flags.name = value;\n        break;\n      case \"db\":\n        flags.db = value;\n        break;\n      case \"no-db\":\n        // Opt out of a database entirely — equivalent to `--db=none`.\n        flags.db = NO_DATABASE;\n        break;\n      case \"pm\":\n        flags.pm = value;\n        break;\n      case \"features\":\n        flags.features = splitList(value);\n        break;\n      case \"ai\":\n        flags.ai = splitList(value);\n        break;\n    }\n  }\n\n  if (!flags.name && positionals.length > 0) {\n    flags.name = positionals[0];\n  }\n\n  return flags;\n}\n\nfunction splitList(value: string | undefined): string[] {\n  if (!value) return [];\n\n  return value\n    .split(\",\")\n    .map(item => item.trim())\n    .filter(Boolean);\n}\n\n/**\n * Read this package's own `version` field. A plain JSON read — no network\n * call, no write, nothing else touched — so `--version` stays a pure,\n * side-effect-free exit.\n */\nexport function packageVersion(): string {\n  return (getJsonFile(packageRoot(\"package.json\")) as { version: string })\n    .version;\n}\n\nexport default function createApp() {\n  const flags = parseFlags(process.argv.slice(2));\n\n  // `--help` and `--version` must exit before anything that touches the\n  // filesystem, the network, or a prompt — they win over every other flag,\n  // including a positional project name.\n  if (flags.help) {\n    console.log(HELP_TEXT);\n    process.exit(0);\n    return;\n  }\n\n  if (flags.version) {\n    console.log(packageVersion());\n    process.exit(0);\n    return;\n  }\n\n  // An unexpected throw must surface as a readable error AND a non-zero exit\n  // code — never as a stack trace the user scrolls past on the way to a green\n  // banner (there is no banner after this point).\n  Promise.resolve(createNewApp(flags)).catch((error: unknown) => {\n    console.error();\n    console.error(\n      `  create-warlock failed: ${(error as Error)?.message ?? String(error)}`,\n    );\n    console.error();\n\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;AAMA,MAAM,aAAa;CAAC;CAAQ;CAAM;CAAM;CAAY;AAAI;AAExD,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BlB,SAAgB,WAAW,MAA0B;CACnD,MAAM,QAAkB,CAAC;CACzB,MAAM,cAAwB,CAAC;CAE/B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;EAEjB,IAAI,CAAC,IAAI,WAAW,GAAG,GAAG;GACxB,YAAY,KAAK,GAAG;GACpB;EACF;EAEA,MAAM,aAAa,IAAI,QAAQ,GAAG;EAClC,MAAM,OAAO,eAAe,KAAK,MAAM,IAAI,MAAM,GAAG,UAAU,GAAG,QAAQ,OAAO,EAAE;EAClF,IAAI,QAA4B,eAAe,KAAK,SAAY,IAAI,MAAM,aAAa,CAAC;EAGxF,IAAI,WAAW,SAAS,GAAG,KAAK,UAAU,QAAW;GACnD,MAAM,OAAO,KAAK,IAAI;GAEtB,IAAI,QAAQ,CAAC,KAAK,WAAW,GAAG,GAAG;IACjC,QAAQ;IACR;GACF;EACF;EAEA,QAAQ,KAAR;GACE,KAAK;GACL,KAAK;IACH,MAAM,OAAO;IACb;GACF,KAAK;GACL,KAAK;IACH,MAAM,UAAU;IAChB;GACF,KAAK;GACL,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,OAAO;IACb;GACF,KAAK;IACH,MAAM,KAAK;IACX;GACF,KAAK;IAEH,MAAM,KAAK;IACX;GACF,KAAK;IACH,MAAM,KAAK;IACX;GACF,KAAK;IACH,MAAM,WAAW,UAAU,KAAK;IAChC;GACF,KAAK;IACH,MAAM,KAAK,UAAU,KAAK;IAC1B;EACJ;CACF;CAEA,IAAI,CAAC,MAAM,QAAQ,YAAY,SAAS,GACtC,MAAM,OAAO,YAAY;CAG3B,OAAO;AACT;AAEA,SAAS,UAAU,OAAqC;CACtD,IAAI,CAAC,OAAO,OAAO,CAAC;CAEpB,OAAO,MACJ,MAAM,GAAG,EACT,KAAI,SAAQ,KAAK,KAAK,CAAC,EACvB,OAAO,OAAO;AACnB;;;;;;AAOA,SAAgB,iBAAyB;CACvC,OAAQ,YAAY,YAAY,cAAc,CAAC,EAC5C;AACL;AAEA,SAAwB,YAAY;CAClC,MAAM,QAAQ,WAAW,QAAQ,KAAK,MAAM,CAAC,CAAC;CAK9C,IAAI,MAAM,MAAM;EACd,QAAQ,IAAI,SAAS;EACrB,QAAQ,KAAK,CAAC;EACd;CACF;CAEA,IAAI,MAAM,SAAS;EACjB,QAAQ,IAAI,eAAe,CAAC;EAC5B,QAAQ,KAAK,CAAC;EACd;CACF;CAKA,QAAQ,QAAQ,aAAa,KAAK,CAAC,EAAE,OAAO,UAAmB;EAC7D,QAAQ,MAAM;EACd,QAAQ,MACN,4BAA6B,OAAiB,WAAW,OAAO,KAAK,GACvE;EACA,QAAQ,MAAM;EAEd,QAAQ,KAAK,CAAC;CAChB,CAAC;AACH"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../create-warlock/src/index.ts"],"sourcesContent":["import { getJsonFile } from \"@warlock.js/fs\";\nimport createNewApp from \"./commands/create-new-app\";\nimport { CliFlags } from \"./commands/create-new-app/types\";\nimport { NO_DATABASE } from \"./features/database-drivers\";\nimport { packageRoot } from \"./helpers/paths\";\n\nconst valueFlags = [\"name\", \"db\", \"pm\", \"features\", \"ai\"];\n\nconst HELP_TEXT = `\n  create-warlock — scaffold a new Warlock.js project\n\n  Usage\n    $ create-warlock [project-name] [options]\n\n  Options\n    --name              Project name (or pass it as the first positional arg)\n    --db=<driver>        Database driver (e.g. postgres, mongodb)\n    --no-db               Skip database selection entirely\n    --features=<list>    Comma-separated feature keys (e.g. test,herald)\n    --ai=<list>           Comma-separated AI provider keys (e.g. openai,anthropic)\n    --pm=<manager>        Package manager to use (npm, yarn, pnpm)\n    --git / --no-git      Force-enable or force-disable git initialization\n    --jwt / --no-jwt      Force-enable or force-disable JWT secret generation\n    -y, --yes             Skip prompts and accept defaults for anything unset\n    -h, --help            Show this help message and exit\n    -v, --version         Show the installed create-warlock version and exit\n\n  Example\n    $ create-warlock my-app --db=postgres --features=test,herald --yes\n`;\n\n/**\n * Parse the scaffolder's own CLI flags for non-interactive mode.\n *\n * @example\n * create-warlock my-app --db=postgres --features=test,herald --ai=openai,anthropic --yes\n */\nexport function parseFlags(argv: string[]): CliFlags {\n  const flags: CliFlags = {};\n  const positionals: string[] = [];\n\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n\n    if (!arg.startsWith(\"-\")) {\n      positionals.push(arg);\n      continue;\n    }\n\n    const equalIndex = arg.indexOf(\"=\");\n    const key = (equalIndex === -1 ? arg : arg.slice(0, equalIndex)).replace(/^-+/, \"\");\n    let value: string | undefined = equalIndex === -1 ? undefined : arg.slice(equalIndex + 1);\n\n    // Value-taking flags may use either `--key=value` or `--key value`.\n    if (valueFlags.includes(key) && value === undefined) {\n      const next = argv[i + 1];\n\n      if (next && !next.startsWith(\"-\")) {\n        value = next;\n        i++;\n      }\n    }\n\n    switch (key) {\n      case \"help\":\n      case \"h\":\n        flags.help = true;\n        break;\n      case \"version\":\n      case \"v\":\n        flags.version = true;\n        break;\n      case \"yes\":\n      case \"y\":\n        flags.yes = true;\n        break;\n      case \"git\":\n        flags.git = true;\n        break;\n      case \"no-git\":\n        flags.git = false;\n        break;\n      case \"jwt\":\n        flags.jwt = true;\n        break;\n      case \"no-jwt\":\n        flags.jwt = false;\n        break;\n      case \"name\":\n        flags.name = value;\n        break;\n      case \"db\":\n        flags.db = value;\n        break;\n      case \"no-db\":\n        // Opt out of a database entirely — equivalent to `--db=none`.\n        flags.db = NO_DATABASE;\n        break;\n      case \"pm\":\n        flags.pm = value;\n        break;\n      case \"features\":\n        flags.features = splitList(value);\n        break;\n      case \"ai\":\n        flags.ai = splitList(value);\n        break;\n    }\n  }\n\n  if (!flags.name && positionals.length > 0) {\n    flags.name = positionals[0];\n  }\n\n  return flags;\n}\n\nfunction splitList(value: string | undefined): string[] {\n  if (!value) return [];\n\n  return value\n    .split(\",\")\n    .map(item => item.trim())\n    .filter(Boolean);\n}\n\n/**\n * Read this package's own `version` field. A plain JSON read — no network\n * call, no write, nothing else touched — so `--version` stays a pure,\n * side-effect-free exit.\n */\nexport function packageVersion(): string {\n  return (getJsonFile(packageRoot(\"package.json\")) as { version: string })\n    .version;\n}\n\nexport default function createApp() {\n  const flags = parseFlags(process.argv.slice(2));\n\n  // `--help` and `--version` must exit before anything that touches the\n  // filesystem, the network, or a prompt — they win over every other flag,\n  // including a positional project name.\n  if (flags.help) {\n    console.log(HELP_TEXT);\n    process.exit(0);\n    return;\n  }\n\n  if (flags.version) {\n    console.log(packageVersion());\n    process.exit(0);\n    return;\n  }\n\n  // An unexpected throw must surface as a readable error AND a non-zero exit\n  // code — never as a stack trace the user scrolls past on the way to a green\n  // banner (there is no banner after this point).\n  Promise.resolve(createNewApp(flags)).catch((error: unknown) => {\n    console.error();\n    console.error(\n      `  create-warlock failed: ${(error as Error)?.message ?? String(error)}`,\n    );\n    console.error();\n\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;AAMA,MAAM,aAAa;CAAC;CAAQ;CAAM;CAAM;CAAY;AAAI;AAExD,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BlB,SAAgB,WAAW,MAA0B;CACnD,MAAM,QAAkB,CAAC;CACzB,MAAM,cAAwB,CAAC;CAE/B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;EAEjB,IAAI,CAAC,IAAI,WAAW,GAAG,GAAG;GACxB,YAAY,KAAK,GAAG;GACpB;EACF;EAEA,MAAM,aAAa,IAAI,QAAQ,GAAG;EAClC,MAAM,OAAO,eAAe,KAAK,MAAM,IAAI,MAAM,GAAG,UAAU,EAAC,CAAE,QAAQ,OAAO,EAAE;EAClF,IAAI,QAA4B,eAAe,KAAK,SAAY,IAAI,MAAM,aAAa,CAAC;EAGxF,IAAI,WAAW,SAAS,GAAG,KAAK,UAAU,QAAW;GACnD,MAAM,OAAO,KAAK,IAAI;GAEtB,IAAI,QAAQ,CAAC,KAAK,WAAW,GAAG,GAAG;IACjC,QAAQ;IACR;GACF;EACF;EAEA,QAAQ,KAAR;GACE,KAAK;GACL,KAAK;IACH,MAAM,OAAO;IACb;GACF,KAAK;GACL,KAAK;IACH,MAAM,UAAU;IAChB;GACF,KAAK;GACL,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,MAAM;IACZ;GACF,KAAK;IACH,MAAM,OAAO;IACb;GACF,KAAK;IACH,MAAM,KAAK;IACX;GACF,KAAK;IAEH,MAAM,KAAK;IACX;GACF,KAAK;IACH,MAAM,KAAK;IACX;GACF,KAAK;IACH,MAAM,WAAW,UAAU,KAAK;IAChC;GACF,KAAK;IACH,MAAM,KAAK,UAAU,KAAK;IAC1B;EACJ;CACF;CAEA,IAAI,CAAC,MAAM,QAAQ,YAAY,SAAS,GACtC,MAAM,OAAO,YAAY;CAG3B,OAAO;AACT;AAEA,SAAS,UAAU,OAAqC;CACtD,IAAI,CAAC,OAAO,OAAO,CAAC;CAEpB,OAAO,MACJ,MAAM,GAAG,CAAC,CACV,KAAI,SAAQ,KAAK,KAAK,CAAC,CAAC,CACxB,OAAO,OAAO;AACnB;;;;;;AAOA,SAAgB,iBAAyB;CACvC,OAAQ,YAAY,YAAY,cAAc,CAAC,CAAC,CAC7C;AACL;AAEA,SAAwB,YAAY;CAClC,MAAM,QAAQ,WAAW,QAAQ,KAAK,MAAM,CAAC,CAAC;CAK9C,IAAI,MAAM,MAAM;EACd,QAAQ,IAAI,SAAS;EACrB,QAAQ,KAAK,CAAC;EACd;CACF;CAEA,IAAI,MAAM,SAAS;EACjB,QAAQ,IAAI,eAAe,CAAC;EAC5B,QAAQ,KAAK,CAAC;EACd;CACF;CAKA,QAAQ,QAAQ,aAAa,KAAK,CAAC,CAAC,CAAC,OAAO,UAAmB;EAC7D,QAAQ,MAAM;EACd,QAAQ,MACN,4BAA6B,OAAiB,WAAW,OAAO,KAAK,GACvE;EACA,QAAQ,MAAM;EAEd,QAAQ,KAAK,CAAC;CAChB,CAAC;AACH"}

package/package.json

@@ -12,13 +12,13 @@
   "dependencies": {
     "@clack/prompts": "^0.7.0",
     "@mongez/copper": "^2.1.2",
-    "@warlock.js/fs": "5.2.3",
+    "@warlock.js/fs": "5.3.0",
     "@mongez/reinforcements": "^4.0.1",
     "cross-spawn": "^7.0.3",
     "rimraf": "^6.0.1",
     "which-pm-runs": "^1.1.0"
   },
-  "version": "5.2.3",
+  "version": "5.3.0",
   "type": "module",
   "main": "./esm/index.mjs",
   "module": "./esm/index.mjs",

package/templates/warlock/eslint.config.js

@@ -1,98 +1,98 @@
-import tsPlugin from "@typescript-eslint/eslint-plugin";
-import tsParser from "@typescript-eslint/parser";
-import prettierConfig from "eslint-config-prettier";
-import prettierPlugin from "eslint-plugin-prettier";
-import unusedImports from "eslint-plugin-unused-imports";
-
-export default [
-  // Global configuration
-  {
-    languageOptions: {
-      ecmaVersion: "latest",
-      sourceType: "module",
-      globals: {
-        // Node.js globals
-        console: "readonly",
-        process: "readonly",
-        Buffer: "readonly",
-        __dirname: "readonly",
-        __filename: "readonly",
-        global: "readonly",
-        module: "readonly",
-        require: "readonly",
-        exports: "readonly",
-        // ES2021 globals
-        Promise: "readonly",
-        // Jest globals
-        describe: "readonly",
-        it: "readonly",
-        test: "readonly",
-        expect: "readonly",
-        beforeEach: "readonly",
-        afterEach: "readonly",
-        beforeAll: "readonly",
-        afterAll: "readonly",
-        jest: "readonly",
-      },
-    },
-  },
-
-  // TypeScript files configuration
-  {
-    files: ["**/*.ts", "**/*.tsx", "**/*.css"],
-    languageOptions: {
-      parser: tsParser,
-      parserOptions: {
-        ecmaVersion: "latest",
-        sourceType: "module",
-      },
-    },
-    plugins: {
-      "@typescript-eslint": tsPlugin,
-      prettier: prettierPlugin,
-      "unused-imports": unusedImports,
-    },
-    rules: {
-      // Prettier integration
-      ...prettierConfig.rules,
-      "prettier/prettier": "error",
-
-      // TypeScript rules
-      "@typescript-eslint/no-explicit-any": "off",
-      "@typescript-eslint/no-unused-vars": "off",
-      "no-unused-vars": "off",
-      "unused-imports/no-unused-vars": [
-        "warn",
-        {
-          vars: "all",
-          varsIgnorePattern: "^_",
-          args: "after-used",
-          argsIgnorePattern: "^_",
-        },
-      ],
-      "unused-imports/no-unused-imports": "error",
-      "@typescript-eslint/explicit-member-accessibility": [
-        "error",
-        { accessibility: "explicit" },
-      ],
-      "@typescript-eslint/consistent-type-imports": [
-        "error",
-        {
-          prefer: "type-imports",
-          disallowTypeAnnotations: false,
-        },
-      ],
-    },
-  },
-
-  // Ignore patterns
-  {
-    ignores: [
-      "dist/",
-      "node_modules/",
-      "**/*.js",
-      "!**/*.config.js",
-      "!eslint.config.js",
-    ],
-  },
-];
+import tsPlugin from "@typescript-eslint/eslint-plugin";
+import tsParser from "@typescript-eslint/parser";
+import prettierConfig from "eslint-config-prettier";
+import prettierPlugin from "eslint-plugin-prettier";
+import unusedImports from "eslint-plugin-unused-imports";
+
+export default [
+  // Global configuration
+  {
+    languageOptions: {
+      ecmaVersion: "latest",
+      sourceType: "module",
+      globals: {
+        // Node.js globals
+        console: "readonly",
+        process: "readonly",
+        Buffer: "readonly",
+        __dirname: "readonly",
+        __filename: "readonly",
+        global: "readonly",
+        module: "readonly",
+        require: "readonly",
+        exports: "readonly",
+        // ES2021 globals
+        Promise: "readonly",
+        // Jest globals
+        describe: "readonly",
+        it: "readonly",
+        test: "readonly",
+        expect: "readonly",
+        beforeEach: "readonly",
+        afterEach: "readonly",
+        beforeAll: "readonly",
+        afterAll: "readonly",
+        jest: "readonly",
+      },
+    },
+  },
+
+  // TypeScript files configuration
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "module",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin,
+      prettier: prettierPlugin,
+      "unused-imports": unusedImports,
+    },
+    rules: {
+      // Prettier integration
+      ...prettierConfig.rules,
+      "prettier/prettier": "error",
+
+      // TypeScript rules
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-unused-vars": "off",
+      "no-unused-vars": "off",
+      "unused-imports/no-unused-vars": [
+        "warn",
+        {
+          vars: "all",
+          varsIgnorePattern: "^_",
+          args: "after-used",
+          argsIgnorePattern: "^_",
+        },
+      ],
+      "unused-imports/no-unused-imports": "error",
+      "@typescript-eslint/explicit-member-accessibility": [
+        "error",
+        { accessibility: "explicit" },
+      ],
+      "@typescript-eslint/consistent-type-imports": [
+        "error",
+        {
+          prefer: "type-imports",
+          disallowTypeAnnotations: false,
+        },
+      ],
+    },
+  },
+
+  // Ignore patterns
+  {
+    ignores: [
+      "dist/",
+      "node_modules/",
+      "**/*.js",
+      "!**/*.config.js",
+      "!eslint.config.js",
+    ],
+  },
+];

package/templates/warlock/postcss.config.mjs

@@ -0,0 +1,6 @@
+/** Tailwind v4's PostCSS adapter is used by the imported web root stylesheet. */
+export default {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};

package/templates/warlock/src/app/contact/controllers/contact.controller.ts

@@ -0,0 +1,21 @@
+import { contactSchema } from "@shared/contact.schema";
+import { type Request, type RequestHandler } from "@warlock.js/core";
+import { type Infer } from "@warlock.js/seal";
+
+export type ContactSchema = Infer.Output<typeof contactSchema>;
+
+/** POST /api/contact — validates the starter contact form. */
+export const contactController: RequestHandler<Request<ContactSchema>> = async ({
+  request,
+  response,
+}) => {
+  const contact = request.validated();
+
+  // Replace this with delivery/persistence for your app. Keeping the accepted
+  // payload visible makes the endpoint useful while remaining side-effect free.
+  return response.success({
+    message: "Thanks, " + contact.name + ". Your message has been received.",
+  });
+};
+
+contactController.validation = { schema: contactSchema };

package/templates/warlock/src/app/contact/routes.ts

@@ -0,0 +1,4 @@
+import { router } from "@warlock.js/core";
+import { contactController } from "./controllers/contact.controller";
+
+router.post("/api/contact", contactController);

package/templates/warlock/src/app/{shared → home}/controllers/home-page.controller.ts

@@ -1,12 +1,6 @@
 import { Application, type RequestHandler } from "@warlock.js/core";
 
-/**
- * Default welcome route — a dependency-free JSON response.
- *
- * Projects scaffolded with the `react` feature get the richer HTML welcome
- * page (`home-page.controller.tsx` + `HomePageComponent.tsx`) instead; this
- * plain controller is removed at scaffold time when React is selected.
- */
+/** The dependency-free home response for applications without the web feature. */
 export const homePageController: RequestHandler = async ({ response }) => {
   return response.success({
     message: "Welcome to Warlock 🧙 — your app is up and running!",

package/templates/warlock/src/app/home/services/home.service.ts

@@ -0,0 +1,86 @@
+const capabilities = [
+  {
+    index: "01",
+    eyebrow: "Runtime",
+    title: "One server. Every layer.",
+    body: "HTTP, SSR React, queues, schedules, and agents share one typed runtime instead of a stack of disconnected tools.",
+  },
+  {
+    index: "02",
+    eyebrow: "Types",
+    title: "Confidence at the edges.",
+    body: "Validation, request data, page loaders, and tool calls stay typed from input to response.",
+  },
+  {
+    index: "03",
+    eyebrow: "Architecture",
+    title: "Packages that compose.",
+    body: "Start with Core, then reach for Cascade, Auth, Cache, Scheduler, Seal, or AI only when the product needs them.",
+  },
+  {
+    index: "04",
+    eyebrow: "Developer loop",
+    title: "Fast where it matters.",
+    body: "File-based pages, hot updates, generators, and project-local skills keep momentum inside the codebase.",
+  },
+] as const;
+
+const packages = [
+  {
+    name: "core",
+    area: "Foundation",
+    description:
+      "The application runtime for configuration, commands, connectors, and the development loop.",
+  },
+  {
+    name: "web",
+    area: "Full-stack React",
+    description:
+      "Server-rendered pages, loaders, metadata, layouts, and client-side navigation in one package.",
+  },
+  {
+    name: "cascade",
+    area: "Data",
+    description:
+      "Models, queries, relationships, and migrations for applications that need durable data.",
+  },
+  {
+    name: "seal",
+    area: "Validation",
+    description: "Composable schemas that validate and shape data at every application boundary.",
+  },
+  {
+    name: "auth",
+    area: "Identity",
+    description:
+      "Authentication primitives for protecting routes and carrying user identity through requests.",
+  },
+  {
+    name: "cache",
+    area: "Performance",
+    description:
+      "A consistent caching layer with replaceable drivers and predictable key management.",
+  },
+  {
+    name: "scheduler",
+    area: "Automation",
+    description:
+      "Declare recurring application work and run it alongside the same Warlock runtime.",
+  },
+  {
+    name: "ai",
+    area: "Intelligence",
+    description:
+      "Build agents, tool-driven workflows, and model-backed product capabilities with typed contracts.",
+  },
+] as const;
+
+export async function getHomeService() {
+  return {
+    packages,
+    capabilities,
+    statusMessage: "Ready to build.",
+  };
+}
+
+export type HomePageData = Awaited<ReturnType<typeof getHomeService>>;

package/templates/warlock/src/app/locale/controllers/locale.controller.ts

@@ -0,0 +1,16 @@
+import { localeSchema, type LocaleSchema } from "@shared/locale.schema";
+import { type Request, type RequestHandler } from "@warlock.js/core";
+
+/** POST /api/locale — persists the visitor's locale preference in a cookie. */
+export const localeController: RequestHandler<Request<LocaleSchema>> = async ({
+  request,
+  response,
+}) => {
+  const { locale } = request.validated();
+
+  response.cookie("locale", locale, { raw: true, path: "/" });
+
+  return response.success({ locale });
+};
+
+localeController.validation = { schema: localeSchema };

package/templates/warlock/src/app/locale/routes.ts

@@ -0,0 +1,4 @@
+import { router } from "@warlock.js/core";
+import { localeController } from "./controllers/locale.controller";
+
+router.post("/api/locale", localeController);

package/templates/warlock/src/shared/contact.schema.ts

@@ -0,0 +1,7 @@
+import { v } from "@warlock.js/seal";
+
+export const contactSchema = v.object({
+  name: v.string().min(2),
+  email: v.email(),
+  message: v.string().min(10),
+});

package/templates/warlock/src/shared/locale.schema.ts

@@ -0,0 +1,11 @@
+import { v, type Infer } from "@warlock.js/seal";
+import { localeCodes } from "./locales";
+
+export const localeSchema = v.object({
+  locale: v
+    .string()
+    .in([...localeCodes])
+    .required(),
+});
+
+export type LocaleSchema = Infer.Output<typeof localeSchema>;

package/templates/warlock/src/shared/locales.ts

@@ -0,0 +1,7 @@
+export const localeCodes = ["en", "ar"] as const;
+
+export type LocaleCode = (typeof localeCodes)[number];
+
+export function isLocaleCode(locale: string): locale is LocaleCode {
+  return localeCodes.includes(locale as LocaleCode);
+}

package/templates/warlock/src/web/404.css

@@ -0,0 +1,113 @@
+.not-found,
+.not-found *,
+.not-found *::before,
+.not-found *::after {
+  box-sizing: border-box;
+}
+
+.not-found {
+  display: grid;
+  min-block-size: 100vh;
+  min-block-size: 100dvb;
+  align-items: center;
+  padding-block: clamp(2rem, 8vh, 6rem);
+  padding-inline: clamp(1.5rem, 7vw, 8rem);
+  background: #fafafa;
+  color: #18181b;
+  font-family:
+    system-ui,
+    -apple-system,
+    BlinkMacSystemFont,
+    "Segoe UI",
+    sans-serif;
+}
+
+.not-found__content {
+  inline-size: min(100%, 62rem);
+  margin-inline-start: clamp(0rem, 7vw, 8rem);
+}
+
+.not-found__title,
+.not-found__description {
+  margin: 0;
+}
+
+.not-found h1 {
+  margin: 0;
+  color: #facc15;
+  font-size: clamp(8rem, 25vw, 22rem);
+  font-weight: 800;
+  letter-spacing: -0.09em;
+  line-height: 0.72;
+}
+
+.not-found__title {
+  margin-block-start: clamp(2rem, 6vw, 5rem);
+  font-size: clamp(1.5rem, 3vw, 2.5rem);
+  font-weight: 680;
+  letter-spacing: -0.035em;
+  line-height: 1.1;
+}
+
+.not-found__description {
+  max-inline-size: 30rem;
+  margin-block-start: 0.75rem;
+  color: #52525b;
+  font-size: clamp(1rem, 1.4vw, 1.125rem);
+  line-height: 1.55;
+}
+
+.not-found__action {
+  display: inline-block;
+  margin-block-start: clamp(1.5rem, 3vw, 2.5rem);
+  padding-block: 0.65rem;
+  padding-inline: 1rem;
+  background: #facc15;
+  color: #18181b;
+  font-weight: 700;
+  text-decoration: none;
+}
+
+.not-found__action:hover {
+  text-decoration: underline;
+  text-underline-offset: 0.18em;
+}
+
+.not-found__action:focus-visible {
+  outline: 3px solid #18181b;
+  outline-offset: 4px;
+}
+
+:dir(rtl) .not-found__content {
+  margin-inline-start: 0;
+  margin-inline-end: clamp(0rem, 7vw, 8rem);
+}
+
+@media (max-width: 40rem) {
+  .not-found__content {
+    margin-inline-start: 0;
+  }
+
+  :dir(rtl) .not-found__content {
+    margin-inline-end: 0;
+  }
+}
+
+@media (prefers-color-scheme: dark) {
+  .not-found {
+    background: #18181b;
+    color: #fafafa;
+  }
+
+  .not-found__description {
+    color: #d4d4d8;
+  }
+
+  .not-found__action {
+    color: #18181b;
+  }
+
+  .not-found__action:focus-visible {
+    outline-color: #fafafa;
+  }
+}

package/templates/warlock/src/web/404.page.tsx

@@ -0,0 +1,23 @@
+import "./404.css";
+
+export const metadata = {
+  title: "Page not found",
+  robots: "noindex",
+};
+
+export default function NotFoundPage() {
+  return (
+    <main className="not-found">
+      <div className="not-found__content">
+        <h1>404</h1>
+        <p className="not-found__title">Page not found.</p>
+        <p className="not-found__description">
+          The link may be outdated, or the page may have moved.
+        </p>
+        <a className="not-found__action" href="/">
+          Return home
+        </a>
+      </div>
+    </main>
+  );
+}

package/templates/warlock/src/web/app.css

@@ -0,0 +1,3 @@
+@import "tailwindcss";
+
+/* Page-level styles live with their pages; this root owns only Tailwind's base layer. */

package/templates/warlock/src/web/home/components/contact-form-controls.tsx

@@ -0,0 +1,42 @@
+import { type FormControlProps, useFormControl, useSubmitButton } from "@mongez/react-form";
+import { type ReactNode } from "react";
+
+type ContactFieldProps = FormControlProps & {
+  label: ReactNode;
+  multiline?: boolean;
+  rows?: number;
+};
+
+export function ContactField({ label, multiline, rows, ...props }: ContactFieldProps) {
+  const { error, getErrorProps, getInputProps, id } = useFormControl(props);
+  const inputProps = getInputProps(rows ? { rows } : undefined);
+
+  return (
+    <label htmlFor={id}>
+      <span>{label}</span>
+      {multiline ? <textarea {...inputProps} /> : <input {...inputProps} />}
+      {error ? (
+        <small className="warlock-field-error" {...getErrorProps()}>
+          {error}
+        </small>
+      ) : null}
+    </label>
+  );
+}
+
+export function ContactSubmitButton({
+  idleLabel,
+  submittingLabel,
+}: {
+  idleLabel: ReactNode;
+  submittingLabel: ReactNode;
+}) {
+  const { disabled, isSubmitting } = useSubmitButton();
+
+  return (
+    <button className="warlock-contact-submit" type="submit" disabled={disabled}>
+      {isSubmitting ? submittingLabel : idleLabel}
+      <span aria-hidden="true">→</span>
+    </button>
+  );
+}