@warlock.js/core 5.30.0 → 5.32.0

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

@@ -1 +1 @@
-{"version":3,"file":"notifications.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/notifications.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { dirname } from \"node:path\";\nimport {\n  directoryExistsAsync,\n  ensureDirectoryAsync,\n  fileExistsAsync,\n  getFileAsync,\n  putFileAsync,\n} from \"@warlock.js/fs\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { srcPath } from \"../../utils\";\nimport {\n  listNotificationsControllerStub,\n  listNotificationsSchemaStub,\n  markAllNotificationsReadControllerStub,\n  markNotificationReadControllerStub,\n  markNotificationReadServiceStub,\n  notificationControllerSpecStub,\n  notificationLocalesStub,\n  notificationMigrationStub,\n  notificationModelStub,\n  notificationResourceStub,\n  notificationRoutesStub,\n  notificationsConfigStub,\n  notificationsRequestTypeStub,\n  unreadNotificationsCountControllerStub,\n} from \"../stubs\";\nimport { migrationTimestamp } from \"./shared/migration-timestamp\";\nimport { type FeatureDefinition, INSTALLED_WARLOCK_VERSION } from \"./types\";\n\n/**\n * The module's controllers, with the route each one serves. A spec per\n * controller is written next to it when the app has the test feature.\n */\nconst notificationControllers = [\n  {\n    file: \"list-notifications.controller\",\n    stub: listNotificationsControllerStub,\n    method: \"GET\",\n    path: \"/notifications\",\n  },\n  {\n    file: \"unread-notifications-count.controller\",\n    stub: unreadNotificationsCountControllerStub,\n    method: \"GET\",\n    path: \"/notifications/unread-count\",\n  },\n  {\n    file: \"mark-notification-read.controller\",\n    stub: markNotificationReadControllerStub,\n    method: \"PATCH\",\n    path: \"/notifications/1/read\",\n  },\n  {\n    file: \"mark-all-notifications-read.controller\",\n    stub: markAllNotificationsReadControllerStub,\n    method: \"PATCH\",\n    path: \"/notifications/read-all\",\n  },\n] as const;\n\n/** The model's import path in the ejected config, before and since 5.30. */\nconst MODEL_IMPORT = \"app/notifications/models/notification/notification.model\";\nconst LEGACY_MODEL_IMPORT = \"app/notifications/notification.model\";\n\n/**\n * Write one module file unless it already exists. A file the app already has\n * is the app's own code: it is reported and left alone, never overwritten.\n */\nasync function writeModuleFile(relativePath: string, content: string, skipped: string[]) {\n  const path = srcPath(\"app/notifications\", relativePath);\n\n  if (await fileExistsAsync(path)) {\n    skipped.push(relativePath);\n    return;\n  }\n\n  await ensureDirectoryAsync(dirname(path));\n  await putFileAsync(path, content);\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/${relativePath}`);\n}\n\n/**\n * Add the module's `notFound` message to an existing utils/locales.json, or\n * create the file. Existing keys win; a file that is not a JSON object, or\n * that renames its group, is left for the app to update by hand.\n */\nasync function registerNotificationLocales(skipped: string[]) {\n  const localesPath = srcPath(\"app/notifications/utils/locales.json\");\n\n  if (!(await fileExistsAsync(localesPath))) {\n    await writeModuleFile(\"utils/locales.json\", notificationLocalesStub, skipped);\n    return;\n  }\n\n  const defaults = JSON.parse(notificationLocalesStub) as Record<string, unknown>;\n  let dictionary: Record<string, unknown>;\n\n  try {\n    const parsed: unknown = JSON.parse(await getFileAsync(localesPath));\n\n    if (parsed === null || Array.isArray(parsed) || typeof parsed !== \"object\") throw new Error();\n\n    dictionary = parsed as Record<string, unknown>;\n  } catch {\n    console.log(\n      `${colors.yellowBright(\"notifications\")} locale JSON is invalid; add notFound to src/app/notifications/utils/locales.json manually.`,\n    );\n    return;\n  }\n\n  // A root `$group` renames the file's namespace, so the service's\n  // t(\"notifications.notFound\") would not find a key merged here.\n  if (dictionary.$group !== undefined && dictionary.$group !== \"notifications\") {\n    console.log(\n      `${colors.yellowBright(\"notifications\")} locale JSON declares a different $group; add notifications.notFound manually.`,\n    );\n    return;\n  }\n\n  const missing = Object.keys(defaults).filter((key) => dictionary[key] === undefined);\n\n  if (missing.length === 0) return;\n\n  for (const key of missing) dictionary[key] = defaults[key];\n\n  await putFileAsync(localesPath, `${JSON.stringify(dictionary, null, 2)}\\n`);\n  console.log(\n    `${colors.green(\"✓\")} Added ${missing.join(\", \")} to src/app/notifications/utils/locales.json`,\n  );\n}\n\n/**\n * The config ejected just before this runs imports the 5.30 model path. In an\n * app scaffolded by 5.29 the model is still at the module root, so point the\n * import there instead of at a file that does not exist.\n */\nasync function pointConfigAtLegacyModel() {\n  const configPath = srcPath(\"config/notifications.ts\");\n\n  if (!(await fileExistsAsync(configPath))) return;\n\n  const config = await getFileAsync(configPath);\n\n  if (!config.includes(`\"${MODEL_IMPORT}\"`)) return;\n\n  await putFileAsync(configPath, config.replace(`\"${MODEL_IMPORT}\"`, `\"${LEGACY_MODEL_IMPORT}\"`));\n  console.log(\n    `${colors.green(\"✓\")} src/config/notifications.ts imports the existing model at ${LEGACY_MODEL_IMPORT}`,\n  );\n}\n\nasync function completeNotificationsInstallation(_options: CommandActionData) {\n  const modelPath = srcPath(\"app/notifications/models/notification/notification.model.ts\");\n  // Where 5.29 and earlier wrote the model.\n  const legacyModelPath = srcPath(\"app/notifications/notification.model.ts\");\n\n  // The model file is the sentinel for \"notifications already scaffolded\" —\n  // its presence means the migration was created too (timestamped, so we must\n  // not re-emit a duplicate on a second run).\n  if (await fileExistsAsync(legacyModelPath)) {\n    if (!(await fileExistsAsync(modelPath))) await pointConfigAtLegacyModel();\n\n    console.log(\n      `${colors.yellowBright(\"src/app/notifications\")} already scaffolded (5.29 layout), skipping...`,\n    );\n    return;\n  }\n\n  if (await fileExistsAsync(modelPath)) {\n    console.log(`${colors.yellowBright(\"src/app/notifications\")} already scaffolded, skipping...`);\n    return;\n  }\n\n  const skipped: string[] = [];\n  // An app that already has its own notifications module may keep its model\n  // anywhere in it; a second Notification model would collide with it.\n  const moduleExists = await directoryExistsAsync(srcPath(\"app/notifications\"));\n\n  // 1. Model + migration under models/notification/, like every other module.\n  //    The migration's MM-DD-YYYY_HH-MM-SS prefix lets cascade infer its\n  //    createdAt and order it deterministically.\n  if (moduleExists) {\n    console.log(\n      `${colors.yellowBright(\"src/app/notifications\")} already exists: not adding a Notification model or migration. config/notifications.ts must import your model.`,\n    );\n  } else {\n    await writeModuleFile(\n      \"models/notification/notification.model.ts\",\n      notificationModelStub,\n      skipped,\n    );\n    await writeModuleFile(\n      `models/notification/migrations/${migrationTimestamp()}-notification.migration.ts`,\n      notificationMigrationStub,\n      skipped,\n    );\n  }\n\n  // 2. One responsibility per file: output resource, validated list query,\n  //    guarded request type, service, translations.\n  await writeModuleFile(\"resources/notification.resource.ts\", notificationResourceStub, skipped);\n  await writeModuleFile(\n    \"schema/list-notifications.schema.ts\",\n    listNotificationsSchemaStub,\n    skipped,\n  );\n  await writeModuleFile(\n    \"types/notifications-request.type.ts\",\n    notificationsRequestTypeStub,\n    skipped,\n  );\n  await writeModuleFile(\n    \"services/mark-notification-read.service.ts\",\n    markNotificationReadServiceStub,\n    skipped,\n  );\n  await registerNotificationLocales(skipped);\n\n  // 3. HTTP surface — list, unread count, mark read, mark all read, one\n  //    controller per file, gated by authMiddleware in routes.ts.\n  const withSpecs = await fileExistsAsync(srcPath(\"test-setup.ts\"));\n\n  for (const controller of notificationControllers) {\n    await writeModuleFile(`controllers/${controller.file}.ts`, controller.stub, skipped);\n\n    if (withSpecs) {\n      await writeModuleFile(\n        `controllers/${controller.file}.spec.ts`,\n        notificationControllerSpecStub(controller.method, controller.path),\n        skipped,\n      );\n    }\n  }\n\n  await writeModuleFile(\"routes.ts\", notificationRoutesStub, skipped);\n\n  if (skipped.length > 0) {\n    console.log(\n      `${colors.yellowBright(\"Kept your existing files\")} (not overwritten): ${skipped\n        .map((file) => `src/app/notifications/${file}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\nexport const notificationsFeature: FeatureDefinition = {\n  description:\n    \"Installs @warlock.js/notifications — multi-channel notifications (mail + in-app database). Pulls the mail feature, ejects config/notifications.ts, and scaffolds src/app/notifications: the Notification model + migration, a resource, a validated list query, and the recipient-scoped list / unread-count / mark-read / mark-all-read endpoints (one controller per file, a spec each when tests are set up)\",\n  // The ejected config wires a `mail` channel by default (needs nodemailer,\n  // via the `mail` feature); the scaffolded routes are gated by\n  // `authMiddleware`, so `@warlock.js/auth` is pulled in too.\n  requires: [\"mail\"],\n  dependencies: {\n    \"@warlock.js/notifications\": INSTALLED_WARLOCK_VERSION,\n    \"@warlock.js/auth\": INSTALLED_WARLOCK_VERSION,\n  },\n  ejectConfig: {\n    content: notificationsConfigStub,\n    name: \"notifications\",\n  },\n  onExecuting: completeNotificationsInstallation,\n};\n"],"mappings":"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"}
+{"version":3,"file":"notifications.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/notifications.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { dirname } from \"node:path\";\nimport {\n  directoryExistsAsync,\n  ensureDirectoryAsync,\n  fileExistsAsync,\n  getFileAsync,\n  putFileAsync,\n  recordSkippedFile,\n} from \"../generation-fs\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { srcPath } from \"../../utils\";\nimport {\n  listNotificationsControllerStub,\n  listNotificationsSchemaStub,\n  markAllNotificationsReadControllerStub,\n  markNotificationReadControllerStub,\n  markNotificationReadServiceStub,\n  notificationControllerSpecStub,\n  notificationTestFixtureStub,\n  notificationLocalesStub,\n  notificationMigrationStub,\n  notificationModelStub,\n  notificationResourceStub,\n  notificationRoutesStub,\n  notificationsConfigStub,\n  notificationsRequestTypeStub,\n  unreadNotificationsCountControllerStub,\n} from \"../stubs\";\nimport { migrationTimestamp } from \"./shared/migration-timestamp\";\nimport { type FeatureDefinition, INSTALLED_WARLOCK_VERSION } from \"./types\";\n\n/**\n * The module's controllers, with the route each one serves. A spec per\n * controller is written next to it when the app has the test feature.\n */\nconst notificationControllers = [\n  {\n    file: \"list-notifications.controller\",\n    stub: listNotificationsControllerStub,\n    method: \"GET\",\n    path: \"/notifications\",\n  },\n  {\n    file: \"unread-notifications-count.controller\",\n    stub: unreadNotificationsCountControllerStub,\n    method: \"GET\",\n    path: \"/notifications/unread-count\",\n  },\n  {\n    file: \"mark-notification-read.controller\",\n    stub: markNotificationReadControllerStub,\n    method: \"PATCH\",\n    path: \"/notifications/1/read\",\n  },\n  {\n    file: \"mark-all-notifications-read.controller\",\n    stub: markAllNotificationsReadControllerStub,\n    method: \"PATCH\",\n    path: \"/notifications/read-all\",\n  },\n] as const;\n\n/** The model's import path in the ejected config, before and since 5.30. */\nconst MODEL_IMPORT = \"app/notifications/models/notification/notification.model\";\nconst LEGACY_MODEL_IMPORT = \"app/notifications/notification.model\";\n\n/**\n * Write one module file unless it already exists. A file the app already has\n * is the app's own code: it is reported and left alone, never overwritten.\n */\nasync function writeModuleFile(relativePath: string, content: string, skipped: string[]) {\n  const path = srcPath(\"app/notifications\", relativePath);\n\n  if (await fileExistsAsync(path)) {\n    skipped.push(relativePath);\n    recordSkippedFile(path, \"exists\");\n    return;\n  }\n\n  await ensureDirectoryAsync(dirname(path));\n  await putFileAsync(path, content);\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/${relativePath}`);\n}\n\n/**\n * Add the module's `notFound` message to an existing utils/locales.json, or\n * create the file. Existing keys win; a file that is not a JSON object, or\n * that renames its group, is left for the app to update by hand.\n */\nasync function registerNotificationLocales(skipped: string[]) {\n  const localesPath = srcPath(\"app/notifications/utils/locales.json\");\n\n  if (!(await fileExistsAsync(localesPath))) {\n    await writeModuleFile(\"utils/locales.json\", notificationLocalesStub, skipped);\n    return;\n  }\n\n  const defaults = JSON.parse(notificationLocalesStub) as Record<string, unknown>;\n  let dictionary: Record<string, unknown>;\n\n  try {\n    const parsed: unknown = JSON.parse(await getFileAsync(localesPath));\n\n    if (parsed === null || Array.isArray(parsed) || typeof parsed !== \"object\") throw new Error();\n\n    dictionary = parsed as Record<string, unknown>;\n  } catch {\n    console.log(\n      `${colors.yellowBright(\"notifications\")} locale JSON is invalid; add notFound to src/app/notifications/utils/locales.json manually.`,\n    );\n    return;\n  }\n\n  // A root `$group` renames the file's namespace, so the service's\n  // t(\"notifications.notFound\") would not find a key merged here.\n  if (dictionary.$group !== undefined && dictionary.$group !== \"notifications\") {\n    console.log(\n      `${colors.yellowBright(\"notifications\")} locale JSON declares a different $group; add notifications.notFound manually.`,\n    );\n    return;\n  }\n\n  const missing = Object.keys(defaults).filter((key) => dictionary[key] === undefined);\n\n  if (missing.length === 0) return;\n\n  for (const key of missing) dictionary[key] = defaults[key];\n\n  await putFileAsync(localesPath, `${JSON.stringify(dictionary, null, 2)}\\n`);\n  console.log(\n    `${colors.green(\"✓\")} Added ${missing.join(\", \")} to src/app/notifications/utils/locales.json`,\n  );\n}\n\n/**\n * The config ejected just before this runs imports the 5.30 model path. In an\n * app scaffolded by 5.29 the model is still at the module root, so point the\n * import there instead of at a file that does not exist.\n */\nasync function pointConfigAtLegacyModel() {\n  const configPath = srcPath(\"config/notifications.ts\");\n\n  if (!(await fileExistsAsync(configPath))) return;\n\n  const config = await getFileAsync(configPath);\n\n  if (!config.includes(`\"${MODEL_IMPORT}\"`)) return;\n\n  await putFileAsync(configPath, config.replace(`\"${MODEL_IMPORT}\"`, `\"${LEGACY_MODEL_IMPORT}\"`));\n  console.log(\n    `${colors.green(\"✓\")} src/config/notifications.ts imports the existing model at ${LEGACY_MODEL_IMPORT}`,\n  );\n}\n\nasync function completeNotificationsInstallation(_options: CommandActionData) {\n  const modelPath = srcPath(\"app/notifications/models/notification/notification.model.ts\");\n  // Where 5.29 and earlier wrote the model.\n  const legacyModelPath = srcPath(\"app/notifications/notification.model.ts\");\n\n  // The model file is the sentinel for \"notifications already scaffolded\" —\n  // its presence means the migration was created too (timestamped, so we must\n  // not re-emit a duplicate on a second run).\n  if (await fileExistsAsync(legacyModelPath)) {\n    if (!(await fileExistsAsync(modelPath))) await pointConfigAtLegacyModel();\n\n    console.log(\n      `${colors.yellowBright(\"src/app/notifications\")} already scaffolded (5.29 layout), skipping...`,\n    );\n    return;\n  }\n\n  if (await fileExistsAsync(modelPath)) {\n    console.log(`${colors.yellowBright(\"src/app/notifications\")} already scaffolded, skipping...`);\n    return;\n  }\n\n  const skipped: string[] = [];\n  // An app that already has its own notifications module may keep its model\n  // anywhere in it; a second Notification model would collide with it.\n  const moduleExists = await directoryExistsAsync(srcPath(\"app/notifications\"));\n\n  // 1. Model + migration under models/notification/, like every other module.\n  //    The migration's MM-DD-YYYY_HH-MM-SS prefix lets cascade infer its\n  //    createdAt and order it deterministically.\n  if (moduleExists) {\n    console.log(\n      `${colors.yellowBright(\"src/app/notifications\")} already exists: not adding a Notification model or migration. config/notifications.ts must import your model.`,\n    );\n  } else {\n    await writeModuleFile(\n      \"models/notification/notification.model.ts\",\n      notificationModelStub,\n      skipped,\n    );\n    await writeModuleFile(\n      `models/notification/migrations/${migrationTimestamp()}-notification.migration.ts`,\n      notificationMigrationStub,\n      skipped,\n    );\n  }\n\n  // 2. One responsibility per file: output resource, validated list query,\n  //    guarded request type, service, translations.\n  await writeModuleFile(\"resources/notification.resource.ts\", notificationResourceStub, skipped);\n  await writeModuleFile(\n    \"schema/list-notifications.schema.ts\",\n    listNotificationsSchemaStub,\n    skipped,\n  );\n  await writeModuleFile(\n    \"types/notifications-request.type.ts\",\n    notificationsRequestTypeStub,\n    skipped,\n  );\n  await writeModuleFile(\n    \"services/mark-notification-read.service.ts\",\n    markNotificationReadServiceStub,\n    skipped,\n  );\n  await registerNotificationLocales(skipped);\n\n  // 3. HTTP surface — list, unread count, mark read, mark all read, one\n  //    controller per file, gated by authMiddleware in routes.ts.\n  const withSpecs = await fileExistsAsync(srcPath(\"test-setup.ts\"));\n  if (withSpecs) {\n    await writeModuleFile(\"tests/notifications.fixture.ts\", notificationTestFixtureStub, skipped);\n  }\n\n  for (const controller of notificationControllers) {\n    await writeModuleFile(`controllers/${controller.file}.ts`, controller.stub, skipped);\n\n    if (withSpecs) {\n      await writeModuleFile(\n        `controllers/${controller.file}.spec.ts`,\n        notificationControllerSpecStub(controller.method, controller.path),\n        skipped,\n      );\n    }\n  }\n\n  await writeModuleFile(\"routes.ts\", notificationRoutesStub, skipped);\n\n  if (skipped.length > 0) {\n    console.log(\n      `${colors.yellowBright(\"Kept your existing files\")} (not overwritten): ${skipped\n        .map((file) => `src/app/notifications/${file}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\nexport const notificationsFeature: FeatureDefinition = {\n  description:\n    \"Installs @warlock.js/notifications — multi-channel notifications (mail + in-app database). Pulls the mail feature, ejects config/notifications.ts, and scaffolds src/app/notifications: the Notification model + migration, a resource, a validated list query, and the recipient-scoped list / unread-count / mark-read / mark-all-read endpoints (one controller per file, a spec each when tests are set up)\",\n  // The ejected config wires a `mail` channel by default (needs nodemailer,\n  // via the `mail` feature); the scaffolded routes are gated by\n  // `authMiddleware`, so `@warlock.js/auth` is pulled in too.\n  requires: [\"mail\"],\n  dependencies: {\n    \"@warlock.js/notifications\": INSTALLED_WARLOCK_VERSION,\n    \"@warlock.js/auth\": INSTALLED_WARLOCK_VERSION,\n  },\n  ejectConfig: {\n    content: notificationsConfigStub,\n    name: \"notifications\",\n  },\n  onExecuting: completeNotificationsInstallation,\n};\n"],"mappings":";;;;;;;;;;;;;;;AAoCA,MAAM,0BAA0B;CAC9B;EACE,MAAM;EACN,MAAM;EACN,QAAQ;EACR,MAAM;CACR;CACA;EACE,MAAM;EACN,MAAM;EACN,QAAQ;EACR,MAAM;CACR;CACA;EACE,MAAM;EACN,MAAM;EACN,QAAQ;EACR,MAAM;CACR;CACA;EACE,MAAM;EACN,MAAM;EACN,QAAQ;EACR,MAAM;CACR;AACF;;AAGA,MAAM,eAAe;AACrB,MAAM,sBAAsB;;;;;AAM5B,eAAe,gBAAgB,cAAsB,SAAiB,SAAmB;CACvF,MAAM,OAAO,QAAQ,qBAAqB,YAAY;CAEtD,IAAI,MAAM,gBAAgB,IAAI,GAAG;EAC/B,QAAQ,KAAK,YAAY;EACzB,kBAAkB,MAAM,QAAQ;EAChC;CACF;CAEA,MAAM,qBAAqB,QAAQ,IAAI,CAAC;CACxC,MAAM,aAAa,MAAM,OAAO;CAChC,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,iCAAiC,cAAc;AAClF;;;;;;AAOA,eAAe,4BAA4B,SAAmB;CAC5D,MAAM,cAAc,QAAQ,sCAAsC;CAElE,IAAI,CAAE,MAAM,gBAAgB,WAAW,GAAI;EACzC,MAAM,gBAAgB,sBAAsB,yBAAyB,OAAO;EAC5E;CACF;CAEA,MAAM,WAAW,KAAK,MAAM,uBAAuB;CACnD,IAAI;CAEJ,IAAI;EACF,MAAM,SAAkB,KAAK,MAAM,MAAM,aAAa,WAAW,CAAC;EAElE,IAAI,WAAW,QAAQ,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,UAAU,MAAM,IAAI,MAAM;EAE5F,aAAa;CACf,QAAQ;EACN,QAAQ,IACN,GAAG,OAAO,aAAa,eAAe,EAAE,4FAC1C;EACA;CACF;CAIA,IAAI,WAAW,WAAW,UAAa,WAAW,WAAW,iBAAiB;EAC5E,QAAQ,IACN,GAAG,OAAO,aAAa,eAAe,EAAE,+EAC1C;EACA;CACF;CAEA,MAAM,UAAU,OAAO,KAAK,QAAQ,CAAC,CAAC,QAAQ,QAAQ,WAAW,SAAS,MAAS;CAEnF,IAAI,QAAQ,WAAW,GAAG;CAE1B,KAAK,MAAM,OAAO,SAAS,WAAW,OAAO,SAAS;CAEtD,MAAM,aAAa,aAAa,GAAG,KAAK,UAAU,YAAY,MAAM,CAAC,EAAE,GAAG;CAC1E,QAAQ,IACN,GAAG,OAAO,MAAM,GAAG,EAAE,SAAS,QAAQ,KAAK,IAAI,EAAE,6CACnD;AACF;;;;;;AAOA,eAAe,2BAA2B;CACxC,MAAM,aAAa,QAAQ,yBAAyB;CAEpD,IAAI,CAAE,MAAM,gBAAgB,UAAU,GAAI;CAE1C,MAAM,SAAS,MAAM,aAAa,UAAU;CAE5C,IAAI,CAAC,OAAO,SAAS,IAAI,aAAa,EAAE,GAAG;CAE3C,MAAM,aAAa,YAAY,OAAO,QAAQ,IAAI,aAAa,IAAI,IAAI,oBAAoB,EAAE,CAAC;CAC9F,QAAQ,IACN,GAAG,OAAO,MAAM,GAAG,EAAE,6DAA6D,qBACpF;AACF;AAEA,eAAe,kCAAkC,UAA6B;CAC5E,MAAM,YAAY,QAAQ,6DAA6D;CAEvF,MAAM,kBAAkB,QAAQ,yCAAyC;CAKzE,IAAI,MAAM,gBAAgB,eAAe,GAAG;EAC1C,IAAI,CAAE,MAAM,gBAAgB,SAAS,GAAI,MAAM,yBAAyB;EAExE,QAAQ,IACN,GAAG,OAAO,aAAa,uBAAuB,EAAE,+CAClD;EACA;CACF;CAEA,IAAI,MAAM,gBAAgB,SAAS,GAAG;EACpC,QAAQ,IAAI,GAAG,OAAO,aAAa,uBAAuB,EAAE,iCAAiC;EAC7F;CACF;CAEA,MAAM,UAAoB,CAAC;CAQ3B,IAAI,MALuB,qBAAqB,QAAQ,mBAAmB,CAAC,GAM1E,QAAQ,IACN,GAAG,OAAO,aAAa,uBAAuB,EAAE,+GAClD;MACK;EACL,MAAM,gBACJ,6CACA,uBACA,OACF;EACA,MAAM,gBACJ,kCAAkC,mBAAmB,EAAE,6BACvD,2BACA,OACF;CACF;CAIA,MAAM,gBAAgB,sCAAsC,0BAA0B,OAAO;CAC7F,MAAM,gBACJ,uCACA,6BACA,OACF;CACA,MAAM,gBACJ,uCACA,8BACA,OACF;CACA,MAAM,gBACJ,8CACA,iCACA,OACF;CACA,MAAM,4BAA4B,OAAO;CAIzC,MAAM,YAAY,MAAM,gBAAgB,QAAQ,eAAe,CAAC;CAChE,IAAI,WACF,MAAM,gBAAgB,kCAAkC,6BAA6B,OAAO;CAG9F,KAAK,MAAM,cAAc,yBAAyB;EAChD,MAAM,gBAAgB,eAAe,WAAW,KAAK,MAAM,WAAW,MAAM,OAAO;EAEnF,IAAI,WACF,MAAM,gBACJ,eAAe,WAAW,KAAK,WAC/B,+BAA+B,WAAW,QAAQ,WAAW,IAAI,GACjE,OACF;CAEJ;CAEA,MAAM,gBAAgB,aAAa,wBAAwB,OAAO;CAElE,IAAI,QAAQ,SAAS,GACnB,QAAQ,IACN,GAAG,OAAO,aAAa,0BAA0B,EAAE,sBAAsB,QACtE,KAAK,SAAS,yBAAyB,MAAM,CAAC,CAC9C,KAAK,IAAI,GACd;AAEJ;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/queue.feature.mjs

@@ -1,9 +1,9 @@
 import { rootPath } from "../../utils/paths.mjs";
 import "../../utils/index.mjs";
+import { fileExistsAsync, getFileAsync, putFileAsync } from "../generation-fs.mjs";
 import { INSTALLED_WARLOCK_VERSION } from "./types.mjs";
 import { insertConnectorEntry } from "./shared/insert-connector-entry.mjs";
 import { colors } from "@mongez/copper";
-import { fileExistsAsync, getFileAsync, putFileAsync } from "@warlock.js/fs";
 
 //#region ../../packages/core/src/generations/features/queue.feature.ts
 const queueConfigStub = `import { env } from "@warlock.js/core";

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

@@ -1 +1 @@
-{"version":3,"file":"queue.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/queue.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getFileAsync, putFileAsync } from \"@warlock.js/fs\";\nimport { rootPath } from \"../../utils\";\nimport { insertConnectorEntry } from \"./shared/insert-connector-entry\";\nimport { type FeatureDefinition, INSTALLED_WARLOCK_VERSION } from \"./types\";\n\nconst queueConfigStub = `import { env } from \"@warlock.js/core\";\nimport type { QueueConfig } from \"@warlock.js/queue\";\n\n/** Durable job queue configuration. Redis is required by BullMQ. */\nconst queueConfig: QueueConfig = {\n  connection: {\n    host: env(\"REDIS_HOST\", \"127.0.0.1\"),\n    port: env(\"REDIS_PORT\", 6379),\n  },\n  defaultJobOptions: {\n    attempts: 3,\n    backoff: { type: \"exponential\", delay: 1000 },\n  },\n  workers: {\n    enabled: true,\n    concurrency: 5,\n    shutdownTimeout: 30_000,\n  },\n};\n\nexport default queueConfig;\n`;\n\n/** Register the queue connector in the app-owned configuration without reformatting it. */\nasync function registerQueueConnector(): Promise<void> {\n  const configPath = rootPath(\"warlock.config.ts\");\n\n  if (!(await fileExistsAsync(configPath))) {\n    console.log(\n      `${colors.yellowBright(\"warlock.config.ts\")} not found — add this yourself:\\n` +\n        `  import { queueConnector } from \"@warlock.js/queue\";\\n` +\n        `  export default defineConfig({ connectors: [queueConnector()] });`,\n    );\n\n    return;\n  }\n\n  const current = await getFileAsync(configPath);\n\n  if (current.includes(\"queueConnector\")) {\n    console.log(`${colors.yellowBright(\"queueConnector\")} already registered, skipping...`);\n\n    return;\n  }\n\n  const importLine = 'import { queueConnector } from \"@warlock.js/queue\";';\n  let next = current.includes(importLine) ? current : `${importLine}\\n${current}`;\n\n  const insertion = insertConnectorEntry(next, \"queueConnector()\");\n\n  if (insertion.status === \"already-present\") {\n    return;\n  }\n\n  if (insertion.status === \"added\") {\n    next = insertion.next;\n  } else if (next.includes(\"defineConfig({\")) {\n    next = next.replace(\"defineConfig({\", \"defineConfig({\\n  connectors: [queueConnector()],\\n\");\n  } else {\n    console.log(\n      `${colors.yellowBright(\"warlock.config.ts\")} has no recognisable defineConfig({...}) — ` +\n        \"add `connectors: [queueConnector()]` yourself.\",\n    );\n\n    return;\n  }\n\n  await putFileAsync(configPath, next);\n  console.log(`${colors.green(\"✓\")} Registered queueConnector in warlock.config.ts`);\n  console.log(\n    \"Next: start Redis, then define jobs with defineJob() in an application module before boot.\",\n  );\n}\n\n/** `warlock add queue` — durable BullMQ jobs backed by the app's Redis server. */\nexport const queueFeature: FeatureDefinition = {\n  description:\n    \"Installs @warlock.js/queue — durable BullMQ jobs backed by Redis. Creates src/config/queue.ts and registers queueConnector() in warlock.config.ts.\",\n  dependencies: {\n    \"@warlock.js/queue\": INSTALLED_WARLOCK_VERSION,\n  },\n  ejectConfig: {\n    content: queueConfigStub,\n    name: \"queue\",\n  },\n  onExecuting: registerQueueConnector,\n};\n"],"mappings":";;;;;;;;AAMA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;AAwBxB,eAAe,yBAAwC;CACrD,MAAM,aAAa,SAAS,mBAAmB;CAE/C,IAAI,CAAE,MAAM,gBAAgB,UAAU,GAAI;EACxC,QAAQ,IACN,GAAG,OAAO,aAAa,mBAAmB,EAAE,2JAG9C;EAEA;CACF;CAEA,MAAM,UAAU,MAAM,aAAa,UAAU;CAE7C,IAAI,QAAQ,SAAS,gBAAgB,GAAG;EACtC,QAAQ,IAAI,GAAG,OAAO,aAAa,gBAAgB,EAAE,iCAAiC;EAEtF;CACF;CAEA,MAAM,aAAa;CACnB,IAAI,OAAO,QAAQ,SAAS,UAAU,IAAI,UAAU,GAAG,WAAW,IAAI;CAEtE,MAAM,YAAY,qBAAqB,MAAM,kBAAkB;CAE/D,IAAI,UAAU,WAAW,mBACvB;CAGF,IAAI,UAAU,WAAW,SACvB,OAAO,UAAU;MACZ,IAAI,KAAK,SAAS,gBAAgB,GACvC,OAAO,KAAK,QAAQ,kBAAkB,qDAAqD;MACtF;EACL,QAAQ,IACN,GAAG,OAAO,aAAa,mBAAmB,EAAE,4FAE9C;EAEA;CACF;CAEA,MAAM,aAAa,YAAY,IAAI;CACnC,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,gDAAgD;CACjF,QAAQ,IACN,4FACF;AACF;;AAGA,MAAa,eAAkC;CAC7C,aACE;CACF,cAAc,EACZ,qBAAqB,0BACvB;CACA,aAAa;EACX,SAAS;EACT,MAAM;CACR;CACA,aAAa;AACf"}
+{"version":3,"file":"queue.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/queue.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getFileAsync, putFileAsync } from \"../generation-fs\";\nimport { rootPath } from \"../../utils\";\nimport { insertConnectorEntry } from \"./shared/insert-connector-entry\";\nimport { type FeatureDefinition, INSTALLED_WARLOCK_VERSION } from \"./types\";\n\nconst queueConfigStub = `import { env } from \"@warlock.js/core\";\nimport type { QueueConfig } from \"@warlock.js/queue\";\n\n/** Durable job queue configuration. Redis is required by BullMQ. */\nconst queueConfig: QueueConfig = {\n  connection: {\n    host: env(\"REDIS_HOST\", \"127.0.0.1\"),\n    port: env(\"REDIS_PORT\", 6379),\n  },\n  defaultJobOptions: {\n    attempts: 3,\n    backoff: { type: \"exponential\", delay: 1000 },\n  },\n  workers: {\n    enabled: true,\n    concurrency: 5,\n    shutdownTimeout: 30_000,\n  },\n};\n\nexport default queueConfig;\n`;\n\n/** Register the queue connector in the app-owned configuration without reformatting it. */\nasync function registerQueueConnector(): Promise<void> {\n  const configPath = rootPath(\"warlock.config.ts\");\n\n  if (!(await fileExistsAsync(configPath))) {\n    console.log(\n      `${colors.yellowBright(\"warlock.config.ts\")} not found — add this yourself:\\n` +\n        `  import { queueConnector } from \"@warlock.js/queue\";\\n` +\n        `  export default defineConfig({ connectors: [queueConnector()] });`,\n    );\n\n    return;\n  }\n\n  const current = await getFileAsync(configPath);\n\n  if (current.includes(\"queueConnector\")) {\n    console.log(`${colors.yellowBright(\"queueConnector\")} already registered, skipping...`);\n\n    return;\n  }\n\n  const importLine = 'import { queueConnector } from \"@warlock.js/queue\";';\n  let next = current.includes(importLine) ? current : `${importLine}\\n${current}`;\n\n  const insertion = insertConnectorEntry(next, \"queueConnector()\");\n\n  if (insertion.status === \"already-present\") {\n    return;\n  }\n\n  if (insertion.status === \"added\") {\n    next = insertion.next;\n  } else if (next.includes(\"defineConfig({\")) {\n    next = next.replace(\"defineConfig({\", \"defineConfig({\\n  connectors: [queueConnector()],\\n\");\n  } else {\n    console.log(\n      `${colors.yellowBright(\"warlock.config.ts\")} has no recognisable defineConfig({...}) — ` +\n        \"add `connectors: [queueConnector()]` yourself.\",\n    );\n\n    return;\n  }\n\n  await putFileAsync(configPath, next);\n  console.log(`${colors.green(\"✓\")} Registered queueConnector in warlock.config.ts`);\n  console.log(\n    \"Next: start Redis, then define jobs with defineJob() in an application module before boot.\",\n  );\n}\n\n/** `warlock add queue` — durable BullMQ jobs backed by the app's Redis server. */\nexport const queueFeature: FeatureDefinition = {\n  description:\n    \"Installs @warlock.js/queue — durable BullMQ jobs backed by Redis. Creates src/config/queue.ts and registers queueConnector() in warlock.config.ts.\",\n  dependencies: {\n    \"@warlock.js/queue\": INSTALLED_WARLOCK_VERSION,\n  },\n  ejectConfig: {\n    content: queueConfigStub,\n    name: \"queue\",\n  },\n  onExecuting: registerQueueConnector,\n};\n"],"mappings":";;;;;;;;AAMA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;AAwBxB,eAAe,yBAAwC;CACrD,MAAM,aAAa,SAAS,mBAAmB;CAE/C,IAAI,CAAE,MAAM,gBAAgB,UAAU,GAAI;EACxC,QAAQ,IACN,GAAG,OAAO,aAAa,mBAAmB,EAAE,2JAG9C;EAEA;CACF;CAEA,MAAM,UAAU,MAAM,aAAa,UAAU;CAE7C,IAAI,QAAQ,SAAS,gBAAgB,GAAG;EACtC,QAAQ,IAAI,GAAG,OAAO,aAAa,gBAAgB,EAAE,iCAAiC;EAEtF;CACF;CAEA,MAAM,aAAa;CACnB,IAAI,OAAO,QAAQ,SAAS,UAAU,IAAI,UAAU,GAAG,WAAW,IAAI;CAEtE,MAAM,YAAY,qBAAqB,MAAM,kBAAkB;CAE/D,IAAI,UAAU,WAAW,mBACvB;CAGF,IAAI,UAAU,WAAW,SACvB,OAAO,UAAU;MACZ,IAAI,KAAK,SAAS,gBAAgB,GACvC,OAAO,KAAK,QAAQ,kBAAkB,qDAAqD;MACtF;EACL,QAAQ,IACN,GAAG,OAAO,aAAa,mBAAmB,EAAE,4FAE9C;EAEA;CACF;CAEA,MAAM,aAAa,YAAY,IAAI;CACnC,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,gDAAgD;CACjF,QAAQ,IACN,4FACF;AACF;;AAGA,MAAa,eAAkC;CAC7C,aACE;CACF,cAAc,EACZ,qBAAqB,0BACvB;CACA,aAAa;EACX,SAAS;EACT,MAAM;CACR;CACA,aAAa;AACf"}

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

@@ -1,8 +1,8 @@
 import { rootPath } from "../../utils/paths.mjs";
 import "../../utils/index.mjs";
+import { ensureDirectoryAsync, fileExistsAsync, putFileAsync } from "../generation-fs.mjs";
 import { patchTsconfigInclude } from "./shared/patch-tsconfig-include.mjs";
 import { colors } from "@mongez/copper";
-import { ensureDirectoryAsync, fileExistsAsync, putFileAsync } from "@warlock.js/fs";
 
 //#region ../../packages/core/src/generations/features/react-email.feature.ts
 async function completeReactEmailInstallation(_options) {

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

@@ -1 +1 @@
-{"version":3,"file":"react-email.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/react-email.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { ensureDirectoryAsync, fileExistsAsync, putFileAsync } from \"@warlock.js/fs\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { rootPath } from \"../../utils\";\nimport { patchTsconfigInclude } from \"./shared/patch-tsconfig-include\";\nimport type { FeatureDefinition } from \"./types\";\n\nasync function completeReactEmailInstallation(_options: CommandActionData) {\n  // 1. Create emails/ folder with a sample component\n  const emailsFolderPath = rootPath(\"emails\");\n  const sampleEmailPath = rootPath(\"emails/welcome-email.tsx\");\n\n  if (!(await fileExistsAsync(sampleEmailPath))) {\n    await ensureDirectoryAsync(emailsFolderPath);\n    await putFileAsync(\n      sampleEmailPath,\n      `import { Body, Container, Head, Html, Text } from \"@react-email/components\";\nimport { Tailwind } from \"@react-email/tailwind\";\n\ninterface WelcomeEmailProps {\n  name: string;\n}\n\n/**\n * Sample welcome email component.\n * Preview with: yarn email:preview\n */\nexport default function WelcomeEmail({ name }: WelcomeEmailProps) {\n  return (\n    <Html>\n      <Head />\n      <Tailwind>\n        <Body className=\"bg-gray-100 font-sans\">\n          <Container className=\"mx-auto max-w-xl py-8 px-4\">\n            <Text className=\"text-2xl font-bold text-gray-900\">\n              Welcome, {name}!\n            </Text>\n            <Text className=\"text-gray-600 mt-2\">\n              You're all set. We're glad to have you on board.\n            </Text>\n          </Container>\n        </Body>\n      </Tailwind>\n    </Html>\n  );\n}\n`,\n    );\n    console.log(`${colors.green(\"✓\")} Created emails/welcome-email.tsx`);\n  }\n\n  // 2. Patch tsconfig.json — add \"emails\" to include if missing.\n  await patchTsconfigInclude(\n    \"emails\",\n    \"Without it, the email components under emails/ are outside the project and do not typecheck.\",\n  );\n}\n\nexport const reactEmailFeature: FeatureDefinition = {\n  description: \"Installs react-email for building email templates with React and Tailwind\",\n  requires: [\"mail\", \"react\"],\n  dependencies: {\n    \"react-email\": \"^5.2.10\",\n    \"@react-email/components\": \"^1.0.11\",\n    \"@react-email/render\": \"^2.0.5\",\n    \"@react-email/tailwind\": \"^2.0.7\",\n  },\n  devDependencies: {\n    \"@react-email/preview-server\": \"5.2.10\",\n  },\n  script: {\n    \"email:preview\": \"npx react-email dev\",\n  },\n  onExecuting: completeReactEmailInstallation,\n};\n"],"mappings":";;;;;;;AAOA,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,qBACJ,UACA,8FACF;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"}
+{"version":3,"file":"react-email.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/react-email.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { ensureDirectoryAsync, fileExistsAsync, putFileAsync } from \"../generation-fs\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { rootPath } from \"../../utils\";\nimport { patchTsconfigInclude } from \"./shared/patch-tsconfig-include\";\nimport type { FeatureDefinition } from \"./types\";\n\nasync function completeReactEmailInstallation(_options: CommandActionData) {\n  // 1. Create emails/ folder with a sample component\n  const emailsFolderPath = rootPath(\"emails\");\n  const sampleEmailPath = rootPath(\"emails/welcome-email.tsx\");\n\n  if (!(await fileExistsAsync(sampleEmailPath))) {\n    await ensureDirectoryAsync(emailsFolderPath);\n    await putFileAsync(\n      sampleEmailPath,\n      `import { Body, Container, Head, Html, Text } from \"@react-email/components\";\nimport { Tailwind } from \"@react-email/tailwind\";\n\ninterface WelcomeEmailProps {\n  name: string;\n}\n\n/**\n * Sample welcome email component.\n * Preview with: yarn email:preview\n */\nexport default function WelcomeEmail({ name }: WelcomeEmailProps) {\n  return (\n    <Html>\n      <Head />\n      <Tailwind>\n        <Body className=\"bg-gray-100 font-sans\">\n          <Container className=\"mx-auto max-w-xl py-8 px-4\">\n            <Text className=\"text-2xl font-bold text-gray-900\">\n              Welcome, {name}!\n            </Text>\n            <Text className=\"text-gray-600 mt-2\">\n              You're all set. We're glad to have you on board.\n            </Text>\n          </Container>\n        </Body>\n      </Tailwind>\n    </Html>\n  );\n}\n`,\n    );\n    console.log(`${colors.green(\"✓\")} Created emails/welcome-email.tsx`);\n  }\n\n  // 2. Patch tsconfig.json — add \"emails\" to include if missing.\n  await patchTsconfigInclude(\n    \"emails\",\n    \"Without it, the email components under emails/ are outside the project and do not typecheck.\",\n  );\n}\n\nexport const reactEmailFeature: FeatureDefinition = {\n  description: \"Installs react-email for building email templates with React and Tailwind\",\n  requires: [\"mail\", \"react\"],\n  dependencies: {\n    \"react-email\": \"^5.2.10\",\n    \"@react-email/components\": \"^1.0.11\",\n    \"@react-email/render\": \"^2.0.5\",\n    \"@react-email/tailwind\": \"^2.0.7\",\n  },\n  devDependencies: {\n    \"@react-email/preview-server\": \"5.2.10\",\n  },\n  script: {\n    \"email:preview\": \"npx react-email dev\",\n  },\n  onExecuting: completeReactEmailInstallation,\n};\n"],"mappings":";;;;;;;AAOA,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,qBACJ,UACA,8FACF;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/shadcn.feature.mjs

@@ -1,7 +1,7 @@
 import { rootPath, srcPath } from "../../utils/paths.mjs";
 import "../../utils/index.mjs";
+import { ensureDirectoryAsync, fileExistsAsync, getFileAsync, putFileAsync } from "../generation-fs.mjs";
 import { colors } from "@mongez/copper";
-import { ensureDirectoryAsync, fileExistsAsync, getFileAsync, putFileAsync } from "@warlock.js/fs";
 
 //#region ../../packages/core/src/generations/features/shadcn.feature.ts
 /**

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

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

package/esm/generations/features/shared/link-ai-package-import.mjs

@@ -1,7 +1,7 @@
 import { srcPath } from "../../../utils/paths.mjs";
 import "../../../utils/index.mjs";
+import { fileExistsAsync, getFileAsync, putFileAsync } from "../../generation-fs.mjs";
 import { colors } from "@mongez/copper";
-import { fileExistsAsync, getFileAsync, putFileAsync } from "@warlock.js/fs";
 
 //#region ../../packages/core/src/generations/features/shared/link-ai-package-import.ts
 /**

package/esm/generations/features/shared/link-ai-package-import.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"link-ai-package-import.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/generations/features/shared/link-ai-package-import.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getFileAsync, putFileAsync } from \"@warlock.js/fs\";\nimport { srcPath } from \"../../../utils\";\n\n/**\n * Link a satellite AI package into src/config/ai.ts via a side-effect import.\n *\n * The satellites (@warlock.js/ai-tools, ai-panoptic, ai-workspace) augment the\n * `ai` object on import — they register their runtime surface (ai.tools / ai.mcp,\n * ai.workspace, panoptic's ai.config({ panoptic }) wiring) AND the matching TS\n * declaration-merging so ai.* members resolve. config-loader runs config/ai.ts at\n * boot, so dropping a bare `import \"<specifier>\";` at the top of that file is what\n * actually loads the augmentation before the ai connector applies the config.\n *\n * No-op if config/ai.ts is missing (the `ai` feature ejects it) or the import is\n * already present. Inserts right after the `warlock:ai-packages` marker when it\n * exists so the satellite imports stay grouped; otherwise prepends to the top.\n */\nexport async function linkAiPackageImport(specifier: string): Promise<void> {\n  const aiConfigPath = srcPath(\"config/ai.ts\");\n\n  if (!(await fileExistsAsync(aiConfigPath))) {\n    return;\n  }\n\n  const current = await getFileAsync(aiConfigPath);\n  const importLine = `import \"${specifier}\";`;\n\n  if (current.includes(importLine)) {\n    return;\n  }\n\n  const marker = \"// >>> warlock:ai-packages (auto-managed) >>>\";\n  let next: string;\n\n  if (current.includes(marker)) {\n    next = current.replace(marker, `${marker}\\n${importLine}`);\n  } else {\n    next = `${importLine}\\n${current}`;\n  }\n\n  await putFileAsync(aiConfigPath, next);\n\n  console.log(`${colors.green(\"✓\")} Linked ${specifier} in src/config/ai.ts`);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAkBA,eAAsB,oBAAoB,WAAkC;CAC1E,MAAM,eAAe,QAAQ,cAAc;CAE3C,IAAI,CAAE,MAAM,gBAAgB,YAAY,GACtC;CAGF,MAAM,UAAU,MAAM,aAAa,YAAY;CAC/C,MAAM,aAAa,WAAW,UAAU;CAExC,IAAI,QAAQ,SAAS,UAAU,GAC7B;CAGF,MAAM,SAAS;CACf,IAAI;CAEJ,IAAI,QAAQ,SAAS,MAAM,GACzB,OAAO,QAAQ,QAAQ,QAAQ,GAAG,OAAO,IAAI,YAAY;MAEzD,OAAO,GAAG,WAAW,IAAI;CAG3B,MAAM,aAAa,cAAc,IAAI;CAErC,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,UAAU,UAAU,qBAAqB;AAC5E"}
+{"version":3,"file":"link-ai-package-import.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/generations/features/shared/link-ai-package-import.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getFileAsync, putFileAsync } from \"../../generation-fs\";\nimport { srcPath } from \"../../../utils\";\n\n/**\n * Link a satellite AI package into src/config/ai.ts via a side-effect import.\n *\n * The satellites (@warlock.js/ai-tools, ai-panoptic, ai-workspace) augment the\n * `ai` object on import — they register their runtime surface (ai.tools / ai.mcp,\n * ai.workspace, panoptic's ai.config({ panoptic }) wiring) AND the matching TS\n * declaration-merging so ai.* members resolve. config-loader runs config/ai.ts at\n * boot, so dropping a bare `import \"<specifier>\";` at the top of that file is what\n * actually loads the augmentation before the ai connector applies the config.\n *\n * No-op if config/ai.ts is missing (the `ai` feature ejects it) or the import is\n * already present. Inserts right after the `warlock:ai-packages` marker when it\n * exists so the satellite imports stay grouped; otherwise prepends to the top.\n */\nexport async function linkAiPackageImport(specifier: string): Promise<void> {\n  const aiConfigPath = srcPath(\"config/ai.ts\");\n\n  if (!(await fileExistsAsync(aiConfigPath))) {\n    return;\n  }\n\n  const current = await getFileAsync(aiConfigPath);\n  const importLine = `import \"${specifier}\";`;\n\n  if (current.includes(importLine)) {\n    return;\n  }\n\n  const marker = \"// >>> warlock:ai-packages (auto-managed) >>>\";\n  let next: string;\n\n  if (current.includes(marker)) {\n    next = current.replace(marker, `${marker}\\n${importLine}`);\n  } else {\n    next = `${importLine}\\n${current}`;\n  }\n\n  await putFileAsync(aiConfigPath, next);\n\n  console.log(`${colors.green(\"✓\")} Linked ${specifier} in src/config/ai.ts`);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAkBA,eAAsB,oBAAoB,WAAkC;CAC1E,MAAM,eAAe,QAAQ,cAAc;CAE3C,IAAI,CAAE,MAAM,gBAAgB,YAAY,GACtC;CAGF,MAAM,UAAU,MAAM,aAAa,YAAY;CAC/C,MAAM,aAAa,WAAW,UAAU;CAExC,IAAI,QAAQ,SAAS,UAAU,GAC7B;CAGF,MAAM,SAAS;CACf,IAAI;CAEJ,IAAI,QAAQ,SAAS,MAAM,GACzB,OAAO,QAAQ,QAAQ,QAAQ,GAAG,OAAO,IAAI,YAAY;MAEzD,OAAO,GAAG,WAAW,IAAI;CAG3B,MAAM,aAAa,cAAc,IAAI;CAErC,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,UAAU,UAAU,qBAAqB;AAC5E"}

package/esm/generations/features/shared/merge-web-sitemap-config.mjs

@@ -1,4 +1,5 @@
-import ts from "typescript";
+import { isExportAssignment, isIdentifier, isNumericLiteral, isObjectLiteralExpression, isPropertyAssignment, isShorthandPropertyAssignment, isStringLiteral, isVariableStatement, nameNode, parseSourceFile, topLevelDeclarations, valueText } from "../../../tooling/syntax/ast.mjs";
+import { parseSync } from "oxc-parser";
 
 //#region ../../packages/core/src/generations/features/shared/merge-web-sitemap-config.ts
 /**
@@ -35,12 +36,11 @@ import ts from "typescript";
 * @returns What happened, and the new text when there is any.
 */
 function mergeWebSitemapConfig(source) {
-	const sourceFile = ts.createSourceFile("web.ts", source, ts.ScriptTarget.ESNext, true, ts.ScriptKind.TS);
-	const objectLiteral = findExportedConfigObjectLiteral(sourceFile);
+	const objectLiteral = findExportedConfigObjectLiteral(parseSourceFile("web.ts", source));
 	if (!objectLiteral) return { status: "unrecognised" };
 	if (hasTopLevelSitemapProperty(objectLiteral)) return { status: "already-present" };
-	const bodyStart = objectLiteral.getStart(sourceFile) + 1;
-	const closingBraceIndex = objectLiteral.getEnd() - 1;
+	const bodyStart = objectLiteral.start + 1;
+	const closingBraceIndex = objectLiteral.end - 1;
 	const body = source.slice(bodyStart, closingBraceIndex);
 	const indentMatch = /\n([ \t]*)\S/.exec(body);
 	const indent = indentMatch ? indentMatch[1] : "  ";
@@ -55,14 +55,7 @@ function mergeWebSitemapConfig(source) {
 }
 /** Whether TEXT fails to parse as TypeScript source. */
 function hasSyntaxErrors(text) {
-	const { diagnostics } = ts.transpileModule(text, {
-		compilerOptions: {
-			module: ts.ModuleKind.ESNext,
-			target: ts.ScriptTarget.ESNext
-		},
-		reportDiagnostics: true
-	});
-	return Boolean(diagnostics && diagnostics.length > 0);
+	return parseSync("web.ts", text).errors.length > 0;
 }
 /**
 * Whether the exported config object literal already has a `sitemap`
@@ -71,11 +64,11 @@ function hasSyntaxErrors(text) {
 * and must not block adding the top-level one.
 */
 function hasTopLevelSitemapProperty(objectLiteral) {
-	return objectLiteral.properties.some((property) => (ts.isPropertyAssignment(property) || ts.isShorthandPropertyAssignment(property)) && propertyKeyName(property.name) === "sitemap");
+	return objectLiteral.properties.some((property) => (isPropertyAssignment(property) || isShorthandPropertyAssignment(property)) && propertyKeyName(nameNode(property)) === "sitemap");
 }
 /** The literal text of a property name node, when it is one of the plain shapes we care about. */
 function propertyKeyName(name) {
-	if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) return name.text;
+	if (isIdentifier(name) || isStringLiteral(name) || isNumericLiteral(name)) return valueText(name);
 }
 /**
 * Find the object literal a source file's default export ultimately points
@@ -83,15 +76,15 @@ function propertyKeyName(name) {
 * file.
 */
 function findExportedConfigObjectLiteral(sourceFile) {
-	const exportAssignment = sourceFile.statements.find((statement) => ts.isExportAssignment(statement) && !statement.isExportEquals);
+	const exportAssignment = sourceFile.body.find((statement) => isExportAssignment(statement));
 	if (!exportAssignment) return void 0;
-	const { expression } = exportAssignment;
-	if (ts.isObjectLiteralExpression(expression)) return expression;
-	if (!ts.isIdentifier(expression)) return void 0;
-	const identifier = expression.text;
-	for (const statement of sourceFile.statements) {
-		if (!ts.isVariableStatement(statement)) continue;
-		for (const declaration of statement.declarationList.declarations) if (ts.isIdentifier(declaration.name) && declaration.name.text === identifier && declaration.initializer && ts.isObjectLiteralExpression(declaration.initializer)) return declaration.initializer;
+	const expression = exportAssignment.declaration;
+	if (isObjectLiteralExpression(expression)) return expression;
+	if (!isIdentifier(expression)) return void 0;
+	const identifier = valueText(expression);
+	for (const statement of topLevelDeclarations(sourceFile)) {
+		if (!isVariableStatement(statement)) continue;
+		for (const declaration of statement.declarations) if (isIdentifier(nameNode(declaration)) && valueText(declaration.id) === identifier && declaration.init && isObjectLiteralExpression(declaration.init)) return declaration.init;
 	}
 }
 /**

package/esm/generations/features/shared/merge-web-sitemap-config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"merge-web-sitemap-config.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/generations/features/shared/merge-web-sitemap-config.ts"],"sourcesContent":["import ts from \"typescript\";\n\n/** What {@link mergeWebSitemapConfig} did, or could not do, to the source it was given. */\nexport type WebSitemapMergeResult =\n  { status: \"merged\"; next: string } | { status: \"already-present\" } | { status: \"unrecognised\" };\n\n/**\n * Merge a disabled `sitemap` section into `src/config/web.ts` SOURCE TEXT.\n *\n * **String surgery, never parse-and-print** — same rationale as\n * `insertConnectorEntry`: `web.ts` is app-owned and may carry any formatting\n * or comments a parse-and-print would discard. The TypeScript AST is used to\n * *find where to cut*, never to regenerate the file — the splice below still\n * copies the original source's bytes verbatim.\n *\n * Recognises the exported config object two ways: an inline `export default\n * {...}`, or `export default <identifier>;` pointing back at a `const\n * <identifier> = {...}` (or `const <identifier>: SomeType = {...}`) declared\n * earlier in the file — the shape this generator itself scaffolds, and the\n * shape every other generated config file in this project uses. Any other\n * shape (a function call, a re-export, no default export at all) returns\n * `\"unrecognised\"` rather than guessing at where to cut — clobbering an\n * app-owned file the merge could not actually understand is worse than\n * refusing.\n *\n * A `sitemap` property already present anywhere in the source (by key, so one\n * a human has since hand-edited is still found) is left unchanged — that is\n * what makes a second `warlock add sitemap` a no-op instead of a duplicate\n * block. Detection walks the AST rather than regex-matching `sitemap\\s*:`, so\n * a comment like `// sitemap: TODO` — text, not a property — does not count.\n *\n * Before returning a merge, the resulting text is re-parsed and checked for\n * syntax errors; a merge that would not itself parse is refused (as\n * `\"unrecognised\"`) instead of written, since a matched-but-corrupt splice is\n * worse than doing nothing.\n *\n * @param source The config file's current text.\n * @returns What happened, and the new text when there is any.\n */\nexport function mergeWebSitemapConfig(source: string): WebSitemapMergeResult {\n  const sourceFile = ts.createSourceFile(\n    \"web.ts\",\n    source,\n    ts.ScriptTarget.ESNext,\n    /* setParentNodes */ true,\n    ts.ScriptKind.TS,\n  );\n\n  const objectLiteral = findExportedConfigObjectLiteral(sourceFile);\n\n  if (!objectLiteral) {\n    return { status: \"unrecognised\" };\n  }\n\n  if (hasTopLevelSitemapProperty(objectLiteral)) {\n    return { status: \"already-present\" };\n  }\n\n  const bodyStart = objectLiteral.getStart(sourceFile) + 1;\n  const closingBraceIndex = objectLiteral.getEnd() - 1;\n  const body = source.slice(bodyStart, closingBraceIndex);\n\n  const indentMatch = /\\n([ \\t]*)\\S/.exec(body);\n  const indent = indentMatch ? indentMatch[1] : \"  \";\n\n  const block =\n    `${indent}sitemap: {\\n` +\n    `${indent}${indent}enabled: false,\\n` +\n    `${indent}${indent}path: \"/sitemap.xml\",\\n` +\n    `${indent}${indent}defaults: { changefreq: \"weekly\", priority: 0.5 },\\n` +\n    `${indent}},\\n`;\n\n  const { index: insertionPoint, needsComma } = lastPropertyEnd(source, closingBraceIndex);\n\n  const next =\n    `${source.slice(0, insertionPoint)}` +\n    `${needsComma ? \",\\n\" : \"\"}` +\n    `${block}` +\n    `${source.slice(closingBraceIndex)}`;\n\n  if (hasSyntaxErrors(next)) {\n    return { status: \"unrecognised\" };\n  }\n\n  return { status: \"merged\", next };\n}\n\n/** Whether TEXT fails to parse as TypeScript source. */\nfunction hasSyntaxErrors(text: string): boolean {\n  const { diagnostics } = ts.transpileModule(text, {\n    compilerOptions: { module: ts.ModuleKind.ESNext, target: ts.ScriptTarget.ESNext },\n    reportDiagnostics: true,\n  });\n\n  return Boolean(diagnostics && diagnostics.length > 0);\n}\n\n/**\n * Whether the exported config object literal already has a `sitemap`\n * property directly on it — a `sitemap` key nested under some other\n * property (e.g. `seo: { sitemap: true }`) is a different feature's field\n * and must not block adding the top-level one.\n */\nfunction hasTopLevelSitemapProperty(objectLiteral: ts.ObjectLiteralExpression): boolean {\n  return objectLiteral.properties.some(\n    (property) =>\n      (ts.isPropertyAssignment(property) || ts.isShorthandPropertyAssignment(property)) &&\n      propertyKeyName(property.name) === \"sitemap\",\n  );\n}\n\n/** The literal text of a property name node, when it is one of the plain shapes we care about. */\nfunction propertyKeyName(name: ts.PropertyName): string | undefined {\n  if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) {\n    return name.text;\n  }\n\n  return undefined;\n}\n\n/**\n * Find the object literal a source file's default export ultimately points\n * at, whether the export is inline or an identifier declared earlier in the\n * file.\n */\nfunction findExportedConfigObjectLiteral(\n  sourceFile: ts.SourceFile,\n): ts.ObjectLiteralExpression | undefined {\n  const exportAssignment = sourceFile.statements.find(\n    (statement): statement is ts.ExportAssignment =>\n      ts.isExportAssignment(statement) && !statement.isExportEquals,\n  );\n\n  if (!exportAssignment) return undefined;\n\n  const { expression } = exportAssignment;\n\n  if (ts.isObjectLiteralExpression(expression)) {\n    return expression;\n  }\n\n  if (!ts.isIdentifier(expression)) return undefined;\n\n  const identifier = expression.text;\n\n  for (const statement of sourceFile.statements) {\n    if (!ts.isVariableStatement(statement)) continue;\n\n    for (const declaration of statement.declarationList.declarations) {\n      if (\n        ts.isIdentifier(declaration.name) &&\n        declaration.name.text === identifier &&\n        declaration.initializer &&\n        ts.isObjectLiteralExpression(declaration.initializer)\n      ) {\n        return declaration.initializer;\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Where to insert a new property right before a closing brace, and whether\n * the property immediately before it (if any) needs a trailing comma added —\n * an object literal with two properties and no comma between them does not\n * parse.\n */\nfunction lastPropertyEnd(\n  source: string,\n  closingBraceIndex: number,\n): { index: number; needsComma: boolean } {\n  let cursor = closingBraceIndex - 1;\n\n  while (cursor >= 0 && /\\s/.test(source.charAt(cursor))) {\n    cursor--;\n  }\n\n  if (cursor < 0 || source[cursor] === \"{\" || source[cursor] === \",\") {\n    return { index: closingBraceIndex, needsComma: false };\n  }\n\n  return { index: cursor + 1, needsComma: true };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,sBAAsB,QAAuC;CAC3E,MAAM,aAAa,GAAG,iBACpB,UACA,QACA,GAAG,aAAa,QACK,MACrB,GAAG,WAAW,EAChB;CAEA,MAAM,gBAAgB,gCAAgC,UAAU;CAEhE,IAAI,CAAC,eACH,OAAO,EAAE,QAAQ,eAAe;CAGlC,IAAI,2BAA2B,aAAa,GAC1C,OAAO,EAAE,QAAQ,kBAAkB;CAGrC,MAAM,YAAY,cAAc,SAAS,UAAU,IAAI;CACvD,MAAM,oBAAoB,cAAc,OAAO,IAAI;CACnD,MAAM,OAAO,OAAO,MAAM,WAAW,iBAAiB;CAEtD,MAAM,cAAc,eAAe,KAAK,IAAI;CAC5C,MAAM,SAAS,cAAc,YAAY,KAAK;CAE9C,MAAM,QACJ,GAAG,OAAO,cACP,SAAS,OAAO,mBAChB,SAAS,OAAO,yBAChB,SAAS,OAAO,sDAChB,OAAO;CAEZ,MAAM,EAAE,OAAO,gBAAgB,eAAe,gBAAgB,QAAQ,iBAAiB;CAEvF,MAAM,OACJ,GAAG,OAAO,MAAM,GAAG,cAAc,IAC9B,aAAa,QAAQ,KACrB,QACA,OAAO,MAAM,iBAAiB;CAEnC,IAAI,gBAAgB,IAAI,GACtB,OAAO,EAAE,QAAQ,eAAe;CAGlC,OAAO;EAAE,QAAQ;EAAU;CAAK;AAClC;;AAGA,SAAS,gBAAgB,MAAuB;CAC9C,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,MAAM;EAC/C,iBAAiB;GAAE,QAAQ,GAAG,WAAW;GAAQ,QAAQ,GAAG,aAAa;EAAO;EAChF,mBAAmB;CACrB,CAAC;CAED,OAAO,QAAQ,eAAe,YAAY,SAAS,CAAC;AACtD;;;;;;;AAQA,SAAS,2BAA2B,eAAoD;CACtF,OAAO,cAAc,WAAW,MAC7B,cACE,GAAG,qBAAqB,QAAQ,KAAK,GAAG,8BAA8B,QAAQ,MAC/E,gBAAgB,SAAS,IAAI,MAAM,SACvC;AACF;;AAGA,SAAS,gBAAgB,MAA2C;CAClE,IAAI,GAAG,aAAa,IAAI,KAAK,GAAG,gBAAgB,IAAI,KAAK,GAAG,iBAAiB,IAAI,GAC/E,OAAO,KAAK;AAIhB;;;;;;AAOA,SAAS,gCACP,YACwC;CACxC,MAAM,mBAAmB,WAAW,WAAW,MAC5C,cACC,GAAG,mBAAmB,SAAS,KAAK,CAAC,UAAU,cACnD;CAEA,IAAI,CAAC,kBAAkB,OAAO;CAE9B,MAAM,EAAE,eAAe;CAEvB,IAAI,GAAG,0BAA0B,UAAU,GACzC,OAAO;CAGT,IAAI,CAAC,GAAG,aAAa,UAAU,GAAG,OAAO;CAEzC,MAAM,aAAa,WAAW;CAE9B,KAAK,MAAM,aAAa,WAAW,YAAY;EAC7C,IAAI,CAAC,GAAG,oBAAoB,SAAS,GAAG;EAExC,KAAK,MAAM,eAAe,UAAU,gBAAgB,cAClD,IACE,GAAG,aAAa,YAAY,IAAI,KAChC,YAAY,KAAK,SAAS,cAC1B,YAAY,eACZ,GAAG,0BAA0B,YAAY,WAAW,GAEpD,OAAO,YAAY;CAGzB;AAGF;;;;;;;AAQA,SAAS,gBACP,QACA,mBACwC;CACxC,IAAI,SAAS,oBAAoB;CAEjC,OAAO,UAAU,KAAK,KAAK,KAAK,OAAO,OAAO,MAAM,CAAC,GACnD;CAGF,IAAI,SAAS,KAAK,OAAO,YAAY,OAAO,OAAO,YAAY,KAC7D,OAAO;EAAE,OAAO;EAAmB,YAAY;CAAM;CAGvD,OAAO;EAAE,OAAO,SAAS;EAAG,YAAY;CAAK;AAC/C"}
+{"version":3,"file":"merge-web-sitemap-config.mjs","names":["ast.parseSourceFile","ast.isPropertyAssignment","ast.isShorthandPropertyAssignment","ast.nameNode","ast.isIdentifier","ast.isStringLiteral","ast.isNumericLiteral","ast.valueText","ast.isExportAssignment","ast.isObjectLiteralExpression","ast.topLevelDeclarations","ast.isVariableStatement"],"sources":["../../../../../../../../../../packages/core/src/generations/features/shared/merge-web-sitemap-config.ts"],"sourcesContent":["import { parseSync } from \"oxc-parser\";\nimport * as ast from \"../../../tooling/syntax/ast\";\n\n/** What {@link mergeWebSitemapConfig} did, or could not do, to the source it was given. */\nexport type WebSitemapMergeResult =\n  | { status: \"merged\"; next: string }\n  | { status: \"already-present\" }\n  | { status: \"unrecognised\" };\n\n/**\n * Merge a disabled `sitemap` section into `src/config/web.ts` SOURCE TEXT.\n *\n * **String surgery, never parse-and-print** — same rationale as\n * `insertConnectorEntry`: `web.ts` is app-owned and may carry any formatting\n * or comments a parse-and-print would discard. The TypeScript AST is used to\n * *find where to cut*, never to regenerate the file — the splice below still\n * copies the original source's bytes verbatim.\n *\n * Recognises the exported config object two ways: an inline `export default\n * {...}`, or `export default <identifier>;` pointing back at a `const\n * <identifier> = {...}` (or `const <identifier>: SomeType = {...}`) declared\n * earlier in the file — the shape this generator itself scaffolds, and the\n * shape every other generated config file in this project uses. Any other\n * shape (a function call, a re-export, no default export at all) returns\n * `\"unrecognised\"` rather than guessing at where to cut — clobbering an\n * app-owned file the merge could not actually understand is worse than\n * refusing.\n *\n * A `sitemap` property already present anywhere in the source (by key, so one\n * a human has since hand-edited is still found) is left unchanged — that is\n * what makes a second `warlock add sitemap` a no-op instead of a duplicate\n * block. Detection walks the AST rather than regex-matching `sitemap\\s*:`, so\n * a comment like `// sitemap: TODO` — text, not a property — does not count.\n *\n * Before returning a merge, the resulting text is re-parsed and checked for\n * syntax errors; a merge that would not itself parse is refused (as\n * `\"unrecognised\"`) instead of written, since a matched-but-corrupt splice is\n * worse than doing nothing.\n *\n * @param source The config file's current text.\n * @returns What happened, and the new text when there is any.\n */\nexport function mergeWebSitemapConfig(source: string): WebSitemapMergeResult {\n  const sourceFile = ast.parseSourceFile(\"web.ts\", source);\n\n  const objectLiteral = findExportedConfigObjectLiteral(sourceFile);\n\n  if (!objectLiteral) {\n    return { status: \"unrecognised\" };\n  }\n\n  if (hasTopLevelSitemapProperty(objectLiteral)) {\n    return { status: \"already-present\" };\n  }\n\n  const bodyStart = objectLiteral.start + 1;\n  const closingBraceIndex = objectLiteral.end - 1;\n  const body = source.slice(bodyStart, closingBraceIndex);\n\n  const indentMatch = /\\n([ \\t]*)\\S/.exec(body);\n  const indent = indentMatch ? indentMatch[1] : \"  \";\n\n  const block =\n    `${indent}sitemap: {\\n` +\n    `${indent}${indent}enabled: false,\\n` +\n    `${indent}${indent}path: \"/sitemap.xml\",\\n` +\n    `${indent}${indent}defaults: { changefreq: \"weekly\", priority: 0.5 },\\n` +\n    `${indent}},\\n`;\n\n  const { index: insertionPoint, needsComma } = lastPropertyEnd(source, closingBraceIndex);\n\n  const next =\n    `${source.slice(0, insertionPoint)}` +\n    `${needsComma ? \",\\n\" : \"\"}` +\n    `${block}` +\n    `${source.slice(closingBraceIndex)}`;\n\n  if (hasSyntaxErrors(next)) {\n    return { status: \"unrecognised\" };\n  }\n\n  return { status: \"merged\", next };\n}\n\n/** Whether TEXT fails to parse as TypeScript source. */\nfunction hasSyntaxErrors(text: string): boolean {\n  return parseSync(\"web.ts\", text).errors.length > 0;\n}\n\n/**\n * Whether the exported config object literal already has a `sitemap`\n * property directly on it — a `sitemap` key nested under some other\n * property (e.g. `seo: { sitemap: true }`) is a different feature's field\n * and must not block adding the top-level one.\n */\nfunction hasTopLevelSitemapProperty(objectLiteral: ast.ObjectExpression): boolean {\n  return objectLiteral.properties.some(\n    (property) =>\n      (ast.isPropertyAssignment(property) || ast.isShorthandPropertyAssignment(property)) &&\n      propertyKeyName(ast.nameNode(property)) === \"sitemap\",\n  );\n}\n\n/** The literal text of a property name node, when it is one of the plain shapes we care about. */\nfunction propertyKeyName(name: ast.Node): string | undefined {\n  if (ast.isIdentifier(name) || ast.isStringLiteral(name) || ast.isNumericLiteral(name)) {\n    return ast.valueText(name);\n  }\n\n  return undefined;\n}\n\n/**\n * Find the object literal a source file's default export ultimately points\n * at, whether the export is inline or an identifier declared earlier in the\n * file.\n */\nfunction findExportedConfigObjectLiteral(\n  sourceFile: ast.SourceFile,\n): ast.ObjectExpression | undefined {\n  const exportAssignment = sourceFile.body.find(\n    (statement): statement is ast.ExportDefaultDeclaration => ast.isExportAssignment(statement),\n  );\n\n  if (!exportAssignment) return undefined;\n\n  const expression = exportAssignment.declaration;\n\n  if (ast.isObjectLiteralExpression(expression)) {\n    return expression;\n  }\n\n  if (!ast.isIdentifier(expression)) return undefined;\n\n  const identifier = ast.valueText(expression);\n\n  for (const statement of ast.topLevelDeclarations(sourceFile)) {\n    if (!ast.isVariableStatement(statement)) continue;\n\n    for (const declaration of statement.declarations) {\n      if (\n        ast.isIdentifier(ast.nameNode(declaration)) &&\n        ast.valueText(declaration.id) === identifier &&\n        declaration.init &&\n        ast.isObjectLiteralExpression(declaration.init)\n      ) {\n        return declaration.init;\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Where to insert a new property right before a closing brace, and whether\n * the property immediately before it (if any) needs a trailing comma added —\n * an object literal with two properties and no comma between them does not\n * parse.\n */\nfunction lastPropertyEnd(\n  source: string,\n  closingBraceIndex: number,\n): { index: number; needsComma: boolean } {\n  let cursor = closingBraceIndex - 1;\n\n  while (cursor >= 0 && /\\s/.test(source.charAt(cursor))) {\n    cursor--;\n  }\n\n  if (cursor < 0 || source[cursor] === \"{\" || source[cursor] === \",\") {\n    return { index: closingBraceIndex, needsComma: false };\n  }\n\n  return { index: cursor + 1, needsComma: true };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,sBAAsB,QAAuC;CAG3E,MAAM,gBAAgB,gCAFHA,gBAAoB,UAAU,MAEc,CAAC;CAEhE,IAAI,CAAC,eACH,OAAO,EAAE,QAAQ,eAAe;CAGlC,IAAI,2BAA2B,aAAa,GAC1C,OAAO,EAAE,QAAQ,kBAAkB;CAGrC,MAAM,YAAY,cAAc,QAAQ;CACxC,MAAM,oBAAoB,cAAc,MAAM;CAC9C,MAAM,OAAO,OAAO,MAAM,WAAW,iBAAiB;CAEtD,MAAM,cAAc,eAAe,KAAK,IAAI;CAC5C,MAAM,SAAS,cAAc,YAAY,KAAK;CAE9C,MAAM,QACJ,GAAG,OAAO,cACP,SAAS,OAAO,mBAChB,SAAS,OAAO,yBAChB,SAAS,OAAO,sDAChB,OAAO;CAEZ,MAAM,EAAE,OAAO,gBAAgB,eAAe,gBAAgB,QAAQ,iBAAiB;CAEvF,MAAM,OACJ,GAAG,OAAO,MAAM,GAAG,cAAc,IAC9B,aAAa,QAAQ,KACrB,QACA,OAAO,MAAM,iBAAiB;CAEnC,IAAI,gBAAgB,IAAI,GACtB,OAAO,EAAE,QAAQ,eAAe;CAGlC,OAAO;EAAE,QAAQ;EAAU;CAAK;AAClC;;AAGA,SAAS,gBAAgB,MAAuB;CAC9C,OAAO,UAAU,UAAU,IAAI,CAAC,CAAC,OAAO,SAAS;AACnD;;;;;;;AAQA,SAAS,2BAA2B,eAA8C;CAChF,OAAO,cAAc,WAAW,MAC7B,cACEC,qBAAyB,QAAQ,KAAKC,8BAAkC,QAAQ,MACjF,gBAAgBC,SAAa,QAAQ,CAAC,MAAM,SAChD;AACF;;AAGA,SAAS,gBAAgB,MAAoC;CAC3D,IAAIC,aAAiB,IAAI,KAAKC,gBAAoB,IAAI,KAAKC,iBAAqB,IAAI,GAClF,OAAOC,UAAc,IAAI;AAI7B;;;;;;AAOA,SAAS,gCACP,YACkC;CAClC,MAAM,mBAAmB,WAAW,KAAK,MACtC,cAAyDC,mBAAuB,SAAS,CAC5F;CAEA,IAAI,CAAC,kBAAkB,OAAO;CAE9B,MAAM,aAAa,iBAAiB;CAEpC,IAAIC,0BAA8B,UAAU,GAC1C,OAAO;CAGT,IAAI,CAACL,aAAiB,UAAU,GAAG,OAAO;CAE1C,MAAM,aAAaG,UAAc,UAAU;CAE3C,KAAK,MAAM,aAAaG,qBAAyB,UAAU,GAAG;EAC5D,IAAI,CAACC,oBAAwB,SAAS,GAAG;EAEzC,KAAK,MAAM,eAAe,UAAU,cAClC,IACEP,aAAiBD,SAAa,WAAW,CAAC,KAC1CI,UAAc,YAAY,EAAE,MAAM,cAClC,YAAY,QACZE,0BAA8B,YAAY,IAAI,GAE9C,OAAO,YAAY;CAGzB;AAGF;;;;;;;AAQA,SAAS,gBACP,QACA,mBACwC;CACxC,IAAI,SAAS,oBAAoB;CAEjC,OAAO,UAAU,KAAK,KAAK,KAAK,OAAO,OAAO,MAAM,CAAC,GACnD;CAGF,IAAI,SAAS,KAAK,OAAO,YAAY,OAAO,OAAO,YAAY,KAC7D,OAAO;EAAE,OAAO;EAAmB,YAAY;CAAM;CAGvD,OAAO;EAAE,OAAO,SAAS;EAAG,YAAY;CAAK;AAC/C"}

package/esm/generations/features/shared/patch-tsconfig-include.mjs

@@ -1,7 +1,7 @@
 import { rootPath } from "../../../utils/paths.mjs";
 import "../../../utils/index.mjs";
+import { fileExistsAsync, getFileAsync, putFileAsync } from "../../generation-fs.mjs";
 import { colors } from "@mongez/copper";
-import { fileExistsAsync, getFileAsync, putFileAsync } from "@warlock.js/fs";
 
 //#region ../../packages/core/src/generations/features/shared/patch-tsconfig-include.ts
 /**
@@ -81,5 +81,5 @@ function escapeForRegExp(value) {
 }
 
 //#endregion
-export { patchTsconfigInclude };
+export { insertIncludeEntry, patchTsconfigInclude };
 //# sourceMappingURL=patch-tsconfig-include.mjs.map

package/esm/generations/features/shared/patch-tsconfig-include.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"patch-tsconfig-include.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/generations/features/shared/patch-tsconfig-include.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getFileAsync, putFileAsync } from \"@warlock.js/fs\";\nimport { rootPath } from \"../../../utils\";\n\n/** What {@link insertIncludeEntry} did, or could not do, to the source it was given. */\nexport type IncludeInsertion =\n  { status: \"added\"; next: string } | { status: \"already-present\" } | { status: \"unrecognised\" };\n\n/**\n * Insert one entry into the `include` array of a tsconfig's SOURCE TEXT.\n *\n * **String surgery, never parse-and-write.** The project template's\n * `tsconfig.json` carries `//` comments — it is JSONC, which TypeScript accepts\n * and `JSON.parse` rejects. A parse-first patch therefore throws on exactly the\n * projects a feature is generated into: `warlock add react-email` failed on\n * every freshly scaffolded app with\n *\n * ```\n * ✖ add <features...> failed\n * Expected double-quoted property name in JSON at position 454 (line 17 column 5)\n * ```\n *\n * where line 17 is the comment explaining the project's `moduleResolution`. And\n * even where a parse succeeded, writing the object back would silently delete\n * every comment in the file — comments that are load-bearing documentation\n * there.\n *\n * `shadcn.feature.ts`'s `addWebPathAlias` already reached this conclusion for\n * `compilerOptions.paths`; this is the same rule for `include`, kept in one\n * place so the next feature that needs it cannot get it wrong again.\n *\n * @param source The tsconfig file's current text.\n * @param entry The include entry to add, e.g. `\"emails\"`.\n * @returns What happened, and the new text when there is any.\n */\nexport function insertIncludeEntry(source: string, entry: string): IncludeInsertion {\n  // Matches the entry whichever quote style the file uses, so a re-run against a\n  // hand-edited tsconfig does not stack a second copy.\n  if (new RegExp(`[\"']${escapeForRegExp(entry)}[\"']`).test(source)) {\n    return { status: \"already-present\" };\n  }\n\n  const includeArray = /\"include\"\\s*:\\s*\\[/.exec(source);\n\n  if (!includeArray) {\n    return { status: \"unrecognised\" };\n  }\n\n  const insertAt = includeArray.index + includeArray[0].length;\n\n  return {\n    status: \"added\",\n    next: `${source.slice(0, insertAt)}${JSON.stringify(entry)}, ${source.slice(insertAt)}`,\n  };\n}\n\n/**\n * Add one entry to the project's `tsconfig.json` `include` array.\n *\n * Never throws. A tsconfig this cannot patch produces a printed instruction the\n * developer can follow by hand — a feature must not abort a whole `add` because\n * one optional convenience could not be applied.\n *\n * @param entry The include entry to add, e.g. `\"emails\"`.\n * @param reason One line explaining what breaks without it, printed when the\n *               patch has to be handed back to the developer.\n */\nexport async function patchTsconfigInclude(entry: string, reason: string): Promise<void> {\n  const tsconfigPath = rootPath(\"tsconfig.json\");\n\n  const printManualInstruction = (problem: string) => {\n    console.log(\n      `${colors.yellowBright(\"!\")} ${colors.yellowBright(\"tsconfig.json\")} ${problem} — ` +\n        `add ${JSON.stringify(entry)} to its \\`include\\` array yourself.\\n  ${reason}`,\n    );\n  };\n\n  if (!(await fileExistsAsync(tsconfigPath))) {\n    printManualInstruction(\"not found\");\n\n    return;\n  }\n\n  const insertion = insertIncludeEntry(await getFileAsync(tsconfigPath), entry);\n\n  if (insertion.status === \"already-present\") {\n    return;\n  }\n\n  if (insertion.status === \"unrecognised\") {\n    printManualInstruction(\"has no recognisable `include` array\");\n\n    return;\n  }\n\n  await putFileAsync(tsconfigPath, insertion.next);\n  console.log(`${colors.green(\"✓\")} Added ${JSON.stringify(entry)} to tsconfig.json include`);\n}\n\n/**\n * Escape a literal string for embedding in a regular expression.\n *\n * @param value The literal to escape.\n * @returns The escaped literal.\n */\nfunction escapeForRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,mBAAmB,QAAgB,OAAiC;CAGlF,IAAI,IAAI,OAAO,OAAO,gBAAgB,KAAK,EAAE,KAAK,CAAC,CAAC,KAAK,MAAM,GAC7D,OAAO,EAAE,QAAQ,kBAAkB;CAGrC,MAAM,eAAe,qBAAqB,KAAK,MAAM;CAErD,IAAI,CAAC,cACH,OAAO,EAAE,QAAQ,eAAe;CAGlC,MAAM,WAAW,aAAa,QAAQ,aAAa,EAAE,CAAC;CAEtD,OAAO;EACL,QAAQ;EACR,MAAM,GAAG,OAAO,MAAM,GAAG,QAAQ,IAAI,KAAK,UAAU,KAAK,EAAE,IAAI,OAAO,MAAM,QAAQ;CACtF;AACF;;;;;;;;;;;;AAaA,eAAsB,qBAAqB,OAAe,QAA+B;CACvF,MAAM,eAAe,SAAS,eAAe;CAE7C,MAAM,0BAA0B,YAAoB;EAClD,QAAQ,IACN,GAAG,OAAO,aAAa,GAAG,EAAE,GAAG,OAAO,aAAa,eAAe,EAAE,GAAG,QAAQ,SACtE,KAAK,UAAU,KAAK,EAAE,yCAAyC,QAC1E;CACF;CAEA,IAAI,CAAE,MAAM,gBAAgB,YAAY,GAAI;EAC1C,uBAAuB,WAAW;EAElC;CACF;CAEA,MAAM,YAAY,mBAAmB,MAAM,aAAa,YAAY,GAAG,KAAK;CAE5E,IAAI,UAAU,WAAW,mBACvB;CAGF,IAAI,UAAU,WAAW,gBAAgB;EACvC,uBAAuB,qCAAqC;EAE5D;CACF;CAEA,MAAM,aAAa,cAAc,UAAU,IAAI;CAC/C,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,SAAS,KAAK,UAAU,KAAK,EAAE,0BAA0B;AAC5F;;;;;;;AAQA,SAAS,gBAAgB,OAAuB;CAC9C,OAAO,MAAM,QAAQ,uBAAuB,MAAM;AACpD"}
+{"version":3,"file":"patch-tsconfig-include.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/generations/features/shared/patch-tsconfig-include.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getFileAsync, putFileAsync } from \"../../generation-fs\";\nimport { rootPath } from \"../../../utils\";\n\n/** What {@link insertIncludeEntry} did, or could not do, to the source it was given. */\nexport type IncludeInsertion =\n  | { status: \"added\"; next: string }\n  | { status: \"already-present\" }\n  | { status: \"unrecognised\" };\n\n/**\n * Insert one entry into the `include` array of a tsconfig's SOURCE TEXT.\n *\n * **String surgery, never parse-and-write.** The project template's\n * `tsconfig.json` carries `//` comments — it is JSONC, which TypeScript accepts\n * and `JSON.parse` rejects. A parse-first patch therefore throws on exactly the\n * projects a feature is generated into: `warlock add react-email` failed on\n * every freshly scaffolded app with\n *\n * ```\n * ✖ add <features...> failed\n * Expected double-quoted property name in JSON at position 454 (line 17 column 5)\n * ```\n *\n * where line 17 is the comment explaining the project's `moduleResolution`. And\n * even where a parse succeeded, writing the object back would silently delete\n * every comment in the file — comments that are load-bearing documentation\n * there.\n *\n * `shadcn.feature.ts`'s `addWebPathAlias` already reached this conclusion for\n * `compilerOptions.paths`; this is the same rule for `include`, kept in one\n * place so the next feature that needs it cannot get it wrong again.\n *\n * @param source The tsconfig file's current text.\n * @param entry The include entry to add, e.g. `\"emails\"`.\n * @returns What happened, and the new text when there is any.\n */\nexport function insertIncludeEntry(source: string, entry: string): IncludeInsertion {\n  // Matches the entry whichever quote style the file uses, so a re-run against a\n  // hand-edited tsconfig does not stack a second copy.\n  if (new RegExp(`[\"']${escapeForRegExp(entry)}[\"']`).test(source)) {\n    return { status: \"already-present\" };\n  }\n\n  const includeArray = /\"include\"\\s*:\\s*\\[/.exec(source);\n\n  if (!includeArray) {\n    return { status: \"unrecognised\" };\n  }\n\n  const insertAt = includeArray.index + includeArray[0].length;\n\n  return {\n    status: \"added\",\n    next: `${source.slice(0, insertAt)}${JSON.stringify(entry)}, ${source.slice(insertAt)}`,\n  };\n}\n\n/**\n * Add one entry to the project's `tsconfig.json` `include` array.\n *\n * Never throws. A tsconfig this cannot patch produces a printed instruction the\n * developer can follow by hand — a feature must not abort a whole `add` because\n * one optional convenience could not be applied.\n *\n * @param entry The include entry to add, e.g. `\"emails\"`.\n * @param reason One line explaining what breaks without it, printed when the\n *               patch has to be handed back to the developer.\n */\nexport async function patchTsconfigInclude(entry: string, reason: string): Promise<void> {\n  const tsconfigPath = rootPath(\"tsconfig.json\");\n\n  const printManualInstruction = (problem: string) => {\n    console.log(\n      `${colors.yellowBright(\"!\")} ${colors.yellowBright(\"tsconfig.json\")} ${problem} — ` +\n        `add ${JSON.stringify(entry)} to its \\`include\\` array yourself.\\n  ${reason}`,\n    );\n  };\n\n  if (!(await fileExistsAsync(tsconfigPath))) {\n    printManualInstruction(\"not found\");\n\n    return;\n  }\n\n  const insertion = insertIncludeEntry(await getFileAsync(tsconfigPath), entry);\n\n  if (insertion.status === \"already-present\") {\n    return;\n  }\n\n  if (insertion.status === \"unrecognised\") {\n    printManualInstruction(\"has no recognisable `include` array\");\n\n    return;\n  }\n\n  await putFileAsync(tsconfigPath, insertion.next);\n  console.log(`${colors.green(\"✓\")} Added ${JSON.stringify(entry)} to tsconfig.json include`);\n}\n\n/**\n * Escape a literal string for embedding in a regular expression.\n *\n * @param value The literal to escape.\n * @returns The escaped literal.\n */\nfunction escapeForRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,mBAAmB,QAAgB,OAAiC;CAGlF,IAAI,IAAI,OAAO,OAAO,gBAAgB,KAAK,EAAE,KAAK,CAAC,CAAC,KAAK,MAAM,GAC7D,OAAO,EAAE,QAAQ,kBAAkB;CAGrC,MAAM,eAAe,qBAAqB,KAAK,MAAM;CAErD,IAAI,CAAC,cACH,OAAO,EAAE,QAAQ,eAAe;CAGlC,MAAM,WAAW,aAAa,QAAQ,aAAa,EAAE,CAAC;CAEtD,OAAO;EACL,QAAQ;EACR,MAAM,GAAG,OAAO,MAAM,GAAG,QAAQ,IAAI,KAAK,UAAU,KAAK,EAAE,IAAI,OAAO,MAAM,QAAQ;CACtF;AACF;;;;;;;;;;;;AAaA,eAAsB,qBAAqB,OAAe,QAA+B;CACvF,MAAM,eAAe,SAAS,eAAe;CAE7C,MAAM,0BAA0B,YAAoB;EAClD,QAAQ,IACN,GAAG,OAAO,aAAa,GAAG,EAAE,GAAG,OAAO,aAAa,eAAe,EAAE,GAAG,QAAQ,SACtE,KAAK,UAAU,KAAK,EAAE,yCAAyC,QAC1E;CACF;CAEA,IAAI,CAAE,MAAM,gBAAgB,YAAY,GAAI;EAC1C,uBAAuB,WAAW;EAElC;CACF;CAEA,MAAM,YAAY,mBAAmB,MAAM,aAAa,YAAY,GAAG,KAAK;CAE5E,IAAI,UAAU,WAAW,mBACvB;CAGF,IAAI,UAAU,WAAW,gBAAgB;EACvC,uBAAuB,qCAAqC;EAE5D;CACF;CAEA,MAAM,aAAa,cAAc,UAAU,IAAI;CAC/C,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,SAAS,KAAK,UAAU,KAAK,EAAE,0BAA0B;AAC5F;;;;;;;AAQA,SAAS,gBAAgB,OAAuB;CAC9C,OAAO,MAAM,QAAQ,uBAAuB,MAAM;AACpD"}

package/esm/generations/features/shared/relocate-conflicting-home-route.mjs

@@ -1,6 +1,6 @@
 import { srcPath } from "../../../utils/paths.mjs";
 import "../../../utils/index.mjs";
-import { getFileAsync, putFileAsync } from "@warlock.js/fs";
+import { getFileAsync, putFileAsync } from "../../generation-fs.mjs";
 import glob from "fast-glob";
 
 //#region ../../packages/core/src/generations/features/shared/relocate-conflicting-home-route.ts
@@ -154,5 +154,5 @@ async function relocateConflictingHomeRoute() {
 }
 
 //#endregion
-export { relocateConflictingHomeRoute };
+export { relocateConflictingHomeRoute, resolveHomeRouteCollision };
 //# sourceMappingURL=relocate-conflicting-home-route.mjs.map

package/esm/generations/features/shared/relocate-conflicting-home-route.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"relocate-conflicting-home-route.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/generations/features/shared/relocate-conflicting-home-route.ts"],"sourcesContent":["import { getFileAsync, putFileAsync } from \"@warlock.js/fs\";\nimport glob from \"fast-glob\";\nimport { srcPath } from \"../../../utils\";\n\n/**\n * A TOP-LEVEL `router.get(\"/\", ...)` — anchored at column 0 on purpose.\n *\n * Routes nested in a `router.group({ prefix: \"/x\" }, ...)` are indented by every\n * formatter this codebase runs, and their real path is `/x`, not `/`. Anchoring\n * is what keeps the notifications feature's own `router.get(\"/\", ...)` (inside\n * the `/notifications` group) from reading as a homepage collision.\n *\n * Only the path literal is captured. The handler — a bare identifier in the\n * template, but possibly an inline arrow spanning lines — is never matched, so\n * the rewrite below cannot damage it.\n */\nconst TOP_LEVEL_ROOT_GET = /^router\\s*\\.\\s*get\\(\\s*([\"'`])\\/\\1/gm;\n\n/**\n * Whether `/welcome` is already spoken for, so relocating onto it would trade\n * one duplicate-route 500 for another.\n */\nconst TOP_LEVEL_WELCOME_GET = /^router\\s*\\.\\s*get\\(\\s*([\"'`])\\/welcome\\1/m;\n\nexport type HomeRouteCollision =\n  /** Nothing under `src/app` claims a top-level `/` — write the page as normal. */\n  | { outcome: \"absent\" }\n  /** The one file that claimed `/` was moved to `/welcome`; the page is safe to write. */\n  | { outcome: \"relocated\"; relativePath: string }\n  /** Something claims `/` that we will not rewrite. The page is NOT written. */\n  | { outcome: \"conflict\"; reason: string }\n  /** We tried to relocate and could not. The page is NOT written. */\n  | { outcome: \"failed\"; reason: string };\n\n/** One routes source file, as read from disk (or handed to the pure resolver in a test). */\nexport type RoutesFileSource = {\n  relativePath: string;\n  source: string;\n};\n\n/** What {@link resolveHomeRouteCollision} decided, plus the sources it rewrote. */\nexport type HomeRouteResolution = {\n  collision: HomeRouteCollision;\n  rewrites: RoutesFileSource[];\n};\n\n/**\n * Decide what to do about `src/app/**\\/routes.{ts,tsx}` claiming `/`, and\n * produce the rewritten source when exactly one file does.\n *\n * Pure by design: no filesystem access here, so this is the part a test can\n * exercise directly without touching disk. {@link relocateConflictingHomeRoute}\n * is the thin I/O wrapper — it reads the files, calls this, and writes back\n * whatever this returns in `rewrites`.\n *\n * @param files Every `routes.{ts,tsx}` file under `src/app`, with its current text.\n * @returns The collision outcome, and the (possibly empty) list of files to write back.\n */\nexport function resolveHomeRouteCollision(files: RoutesFileSource[]): HomeRouteResolution {\n  const claimants = files\n    .map((file) => ({ file, matches: file.source.match(TOP_LEVEL_ROOT_GET) ?? [] }))\n    .filter(({ matches }) => matches.length > 0);\n\n  if (claimants.length === 0) {\n    return { collision: { outcome: \"absent\" }, rewrites: [] };\n  }\n\n  if (claimants.length > 1) {\n    const names = claimants.map(({ file }) => file.relativePath).join(\", \");\n\n    return {\n      collision: {\n        outcome: \"conflict\",\n        reason: `multiple files declare a top-level GET \"/\" (${names})`,\n      },\n      rewrites: [],\n    };\n  }\n\n  const claimant = claimants[0];\n\n  // The two guards above establish exactly one claimant, but the compiler does\n  // not narrow a destructured element from a length check. Reporting \"absent\"\n  // is the same answer the empty case gives, and the honest one: with no\n  // claimant there is no conflicting home route to relocate.\n  if (claimant === undefined) {\n    return { collision: { outcome: \"absent\" }, rewrites: [] };\n  }\n\n  const { file, matches } = claimant;\n\n  if (matches.length > 1) {\n    return {\n      collision: {\n        outcome: \"conflict\",\n        reason: `${file.relativePath} declares ${matches.length} top-level GET \"/\" routes`,\n      },\n      rewrites: [],\n    };\n  }\n\n  if (TOP_LEVEL_WELCOME_GET.test(file.source)) {\n    return {\n      collision: {\n        outcome: \"conflict\",\n        reason: `${file.relativePath} already declares GET \"/welcome\", so the usual relocation target is taken`,\n      },\n      rewrites: [],\n    };\n  }\n\n  const next = file.source.replace(TOP_LEVEL_ROOT_GET, (match: string, quote: string) =>\n    match.replace(`${quote}/${quote}`, `${quote}/welcome${quote}`),\n  );\n\n  if (next === file.source) {\n    return {\n      collision: {\n        outcome: \"conflict\",\n        reason: `${file.relativePath}'s GET \"/\" route could not be rewritten`,\n      },\n      rewrites: [],\n    };\n  }\n\n  return {\n    collision: { outcome: \"relocated\", relativePath: file.relativePath },\n    rewrites: [{ relativePath: file.relativePath, source: next }],\n  };\n}\n\n/**\n * Make room for a page that declares `route.path = \"/\"`.\n *\n * The project template registers `router.get(\"/\", homePageController)` and the\n * page stub declares `route.path = \"/\"`. Fastify rejects the second registration\n * (`Method 'GET' already declared for route '/'`) and the homepage 500s at\n * request time — so `warlock add web` cannot just write the page and hope.\n *\n * This used to check exactly one hardcoded path, `src/app/shared/routes.ts`.\n * That guard never fired on a real scaffold: the template registers the home\n * route at `src/app/home/routes.ts`, `fileExistsAsync` on the wrong path always\n * failed, and every call silently returned `absent` — the collision-avoidance\n * logic below existed and was correct, but was pointed at a file that does not\n * exist, so it never ran. It now scans every `src/app/**\\/routes.{ts,tsx}`\n * instead of trusting one filename, so renaming the template's routes file\n * again cannot reintroduce the same silent no-op.\n *\n * Of the three ways out, this RELOCATES the JSON route to `/welcome` rather than\n * deleting it or refusing to scaffold:\n *\n * - Deleting the controller is what the scaffolder's own `react` feature does,\n *   but it may do that: it owns the file it is deleting, seconds after writing\n *   it. `warlock add web` runs against a project a human has been living in, and\n *   silently unlinking their code is not a thing an `add` command gets to do.\n * - Writing the page anyway and printing a warning ships a project whose\n *   homepage 500s. A warning above a broken app is still a broken app.\n * - Relocating keeps BOTH surfaces working: the React homepage takes `/`, the\n *   JSON welcome answers at `/welcome`, and no line of user code disappears.\n *\n * Only the exact top-level shape is rewritten, and only the path literal inside\n * it. Anything else that claims `/` is reported and left completely alone — we\n * do not guess at code we cannot recognise.\n */\nexport async function relocateConflictingHomeRoute(): Promise<HomeRouteCollision> {\n  const relativePaths = await glob(\"**/routes.{ts,tsx}\", {\n    cwd: srcPath(\"app\"),\n    absolute: false,\n  });\n\n  if (relativePaths.length === 0) {\n    return { outcome: \"absent\" };\n  }\n\n  let files: RoutesFileSource[];\n\n  try {\n    files = await Promise.all(\n      relativePaths.map(async (relativePath) => ({\n        relativePath: `app/${relativePath}`,\n        source: await getFileAsync(srcPath(\"app\", relativePath)),\n      })),\n    );\n  } catch (error) {\n    return {\n      outcome: \"failed\",\n      reason: `could not be read (${(error as Error).message})`,\n    };\n  }\n\n  const { collision, rewrites } = resolveHomeRouteCollision(files);\n\n  if (rewrites.length === 0) {\n    return collision;\n  }\n\n  try {\n    await Promise.all(\n      rewrites.map((file) => putFileAsync(srcPath(file.relativePath), file.source)),\n    );\n  } catch (error) {\n    return {\n      outcome: \"failed\",\n      reason: `could not be written (${(error as Error).message})`,\n    };\n  }\n\n  return collision;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,MAAM,qBAAqB;;;;;AAM3B,MAAM,wBAAwB;;;;;;;;;;;;;AAoC9B,SAAgB,0BAA0B,OAAgD;CACxF,MAAM,YAAY,MACf,KAAK,UAAU;EAAE;EAAM,SAAS,KAAK,OAAO,MAAM,kBAAkB,KAAK,CAAC;CAAE,EAAE,CAAC,CAC/E,QAAQ,EAAE,cAAc,QAAQ,SAAS,CAAC;CAE7C,IAAI,UAAU,WAAW,GACvB,OAAO;EAAE,WAAW,EAAE,SAAS,SAAS;EAAG,UAAU,CAAC;CAAE;CAG1D,IAAI,UAAU,SAAS,GAGrB,OAAO;EACL,WAAW;GACT,SAAS;GACT,QAAQ,+CALE,UAAU,KAAK,EAAE,WAAW,KAAK,YAAY,CAAC,CAAC,KAAK,IAKH,EAAE;EAC/D;EACA,UAAU,CAAC;CACb;CAGF,MAAM,WAAW,UAAU;CAM3B,IAAI,aAAa,QACf,OAAO;EAAE,WAAW,EAAE,SAAS,SAAS;EAAG,UAAU,CAAC;CAAE;CAG1D,MAAM,EAAE,MAAM,YAAY;CAE1B,IAAI,QAAQ,SAAS,GACnB,OAAO;EACL,WAAW;GACT,SAAS;GACT,QAAQ,GAAG,KAAK,aAAa,YAAY,QAAQ,OAAO;EAC1D;EACA,UAAU,CAAC;CACb;CAGF,IAAI,sBAAsB,KAAK,KAAK,MAAM,GACxC,OAAO;EACL,WAAW;GACT,SAAS;GACT,QAAQ,GAAG,KAAK,aAAa;EAC/B;EACA,UAAU,CAAC;CACb;CAGF,MAAM,OAAO,KAAK,OAAO,QAAQ,qBAAqB,OAAe,UACnE,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,UAAU,OAAO,CAC/D;CAEA,IAAI,SAAS,KAAK,QAChB,OAAO;EACL,WAAW;GACT,SAAS;GACT,QAAQ,GAAG,KAAK,aAAa;EAC/B;EACA,UAAU,CAAC;CACb;CAGF,OAAO;EACL,WAAW;GAAE,SAAS;GAAa,cAAc,KAAK;EAAa;EACnE,UAAU,CAAC;GAAE,cAAc,KAAK;GAAc,QAAQ;EAAK,CAAC;CAC9D;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,eAAsB,+BAA4D;CAChF,MAAM,gBAAgB,MAAM,KAAK,sBAAsB;EACrD,KAAK,QAAQ,KAAK;EAClB,UAAU;CACZ,CAAC;CAED,IAAI,cAAc,WAAW,GAC3B,OAAO,EAAE,SAAS,SAAS;CAG7B,IAAI;CAEJ,IAAI;EACF,QAAQ,MAAM,QAAQ,IACpB,cAAc,IAAI,OAAO,kBAAkB;GACzC,cAAc,OAAO;GACrB,QAAQ,MAAM,aAAa,QAAQ,OAAO,YAAY,CAAC;EACzD,EAAE,CACJ;CACF,SAAS,OAAO;EACd,OAAO;GACL,SAAS;GACT,QAAQ,sBAAuB,MAAgB,QAAQ;EACzD;CACF;CAEA,MAAM,EAAE,WAAW,aAAa,0BAA0B,KAAK;CAE/D,IAAI,SAAS,WAAW,GACtB,OAAO;CAGT,IAAI;EACF,MAAM,QAAQ,IACZ,SAAS,KAAK,SAAS,aAAa,QAAQ,KAAK,YAAY,GAAG,KAAK,MAAM,CAAC,CAC9E;CACF,SAAS,OAAO;EACd,OAAO;GACL,SAAS;GACT,QAAQ,yBAA0B,MAAgB,QAAQ;EAC5D;CACF;CAEA,OAAO;AACT"}
+{"version":3,"file":"relocate-conflicting-home-route.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/generations/features/shared/relocate-conflicting-home-route.ts"],"sourcesContent":["import { getFileAsync, putFileAsync } from \"../../generation-fs\";\nimport glob from \"fast-glob\";\nimport { srcPath } from \"../../../utils\";\n\n/**\n * A TOP-LEVEL `router.get(\"/\", ...)` — anchored at column 0 on purpose.\n *\n * Routes nested in a `router.group({ prefix: \"/x\" }, ...)` are indented by every\n * formatter this codebase runs, and their real path is `/x`, not `/`. Anchoring\n * is what keeps the notifications feature's own `router.get(\"/\", ...)` (inside\n * the `/notifications` group) from reading as a homepage collision.\n *\n * Only the path literal is captured. The handler — a bare identifier in the\n * template, but possibly an inline arrow spanning lines — is never matched, so\n * the rewrite below cannot damage it.\n */\nconst TOP_LEVEL_ROOT_GET = /^router\\s*\\.\\s*get\\(\\s*([\"'`])\\/\\1/gm;\n\n/**\n * Whether `/welcome` is already spoken for, so relocating onto it would trade\n * one duplicate-route 500 for another.\n */\nconst TOP_LEVEL_WELCOME_GET = /^router\\s*\\.\\s*get\\(\\s*([\"'`])\\/welcome\\1/m;\n\nexport type HomeRouteCollision =\n  /** Nothing under `src/app` claims a top-level `/` — write the page as normal. */\n  | { outcome: \"absent\" }\n  /** The one file that claimed `/` was moved to `/welcome`; the page is safe to write. */\n  | { outcome: \"relocated\"; relativePath: string }\n  /** Something claims `/` that we will not rewrite. The page is NOT written. */\n  | { outcome: \"conflict\"; reason: string }\n  /** We tried to relocate and could not. The page is NOT written. */\n  | { outcome: \"failed\"; reason: string };\n\n/** One routes source file, as read from disk (or handed to the pure resolver in a test). */\nexport type RoutesFileSource = {\n  relativePath: string;\n  source: string;\n};\n\n/** What {@link resolveHomeRouteCollision} decided, plus the sources it rewrote. */\nexport type HomeRouteResolution = {\n  collision: HomeRouteCollision;\n  rewrites: RoutesFileSource[];\n};\n\n/**\n * Decide what to do about `src/app/**\\/routes.{ts,tsx}` claiming `/`, and\n * produce the rewritten source when exactly one file does.\n *\n * Pure by design: no filesystem access here, so this is the part a test can\n * exercise directly without touching disk. {@link relocateConflictingHomeRoute}\n * is the thin I/O wrapper — it reads the files, calls this, and writes back\n * whatever this returns in `rewrites`.\n *\n * @param files Every `routes.{ts,tsx}` file under `src/app`, with its current text.\n * @returns The collision outcome, and the (possibly empty) list of files to write back.\n */\nexport function resolveHomeRouteCollision(files: RoutesFileSource[]): HomeRouteResolution {\n  const claimants = files\n    .map((file) => ({ file, matches: file.source.match(TOP_LEVEL_ROOT_GET) ?? [] }))\n    .filter(({ matches }) => matches.length > 0);\n\n  if (claimants.length === 0) {\n    return { collision: { outcome: \"absent\" }, rewrites: [] };\n  }\n\n  if (claimants.length > 1) {\n    const names = claimants.map(({ file }) => file.relativePath).join(\", \");\n\n    return {\n      collision: {\n        outcome: \"conflict\",\n        reason: `multiple files declare a top-level GET \"/\" (${names})`,\n      },\n      rewrites: [],\n    };\n  }\n\n  const claimant = claimants[0];\n\n  // The two guards above establish exactly one claimant, but the compiler does\n  // not narrow a destructured element from a length check. Reporting \"absent\"\n  // is the same answer the empty case gives, and the honest one: with no\n  // claimant there is no conflicting home route to relocate.\n  if (claimant === undefined) {\n    return { collision: { outcome: \"absent\" }, rewrites: [] };\n  }\n\n  const { file, matches } = claimant;\n\n  if (matches.length > 1) {\n    return {\n      collision: {\n        outcome: \"conflict\",\n        reason: `${file.relativePath} declares ${matches.length} top-level GET \"/\" routes`,\n      },\n      rewrites: [],\n    };\n  }\n\n  if (TOP_LEVEL_WELCOME_GET.test(file.source)) {\n    return {\n      collision: {\n        outcome: \"conflict\",\n        reason: `${file.relativePath} already declares GET \"/welcome\", so the usual relocation target is taken`,\n      },\n      rewrites: [],\n    };\n  }\n\n  const next = file.source.replace(TOP_LEVEL_ROOT_GET, (match: string, quote: string) =>\n    match.replace(`${quote}/${quote}`, `${quote}/welcome${quote}`),\n  );\n\n  if (next === file.source) {\n    return {\n      collision: {\n        outcome: \"conflict\",\n        reason: `${file.relativePath}'s GET \"/\" route could not be rewritten`,\n      },\n      rewrites: [],\n    };\n  }\n\n  return {\n    collision: { outcome: \"relocated\", relativePath: file.relativePath },\n    rewrites: [{ relativePath: file.relativePath, source: next }],\n  };\n}\n\n/**\n * Make room for a page that declares `route.path = \"/\"`.\n *\n * The project template registers `router.get(\"/\", homePageController)` and the\n * page stub declares `route.path = \"/\"`. Fastify rejects the second registration\n * (`Method 'GET' already declared for route '/'`) and the homepage 500s at\n * request time — so `warlock add web` cannot just write the page and hope.\n *\n * This used to check exactly one hardcoded path, `src/app/shared/routes.ts`.\n * That guard never fired on a real scaffold: the template registers the home\n * route at `src/app/home/routes.ts`, `fileExistsAsync` on the wrong path always\n * failed, and every call silently returned `absent` — the collision-avoidance\n * logic below existed and was correct, but was pointed at a file that does not\n * exist, so it never ran. It now scans every `src/app/**\\/routes.{ts,tsx}`\n * instead of trusting one filename, so renaming the template's routes file\n * again cannot reintroduce the same silent no-op.\n *\n * Of the three ways out, this RELOCATES the JSON route to `/welcome` rather than\n * deleting it or refusing to scaffold:\n *\n * - Deleting the controller is what the scaffolder's own `react` feature does,\n *   but it may do that: it owns the file it is deleting, seconds after writing\n *   it. `warlock add web` runs against a project a human has been living in, and\n *   silently unlinking their code is not a thing an `add` command gets to do.\n * - Writing the page anyway and printing a warning ships a project whose\n *   homepage 500s. A warning above a broken app is still a broken app.\n * - Relocating keeps BOTH surfaces working: the React homepage takes `/`, the\n *   JSON welcome answers at `/welcome`, and no line of user code disappears.\n *\n * Only the exact top-level shape is rewritten, and only the path literal inside\n * it. Anything else that claims `/` is reported and left completely alone — we\n * do not guess at code we cannot recognise.\n */\nexport async function relocateConflictingHomeRoute(): Promise<HomeRouteCollision> {\n  const relativePaths = await glob(\"**/routes.{ts,tsx}\", {\n    cwd: srcPath(\"app\"),\n    absolute: false,\n  });\n\n  if (relativePaths.length === 0) {\n    return { outcome: \"absent\" };\n  }\n\n  let files: RoutesFileSource[];\n\n  try {\n    files = await Promise.all(\n      relativePaths.map(async (relativePath) => ({\n        relativePath: `app/${relativePath}`,\n        source: await getFileAsync(srcPath(\"app\", relativePath)),\n      })),\n    );\n  } catch (error) {\n    return {\n      outcome: \"failed\",\n      reason: `could not be read (${(error as Error).message})`,\n    };\n  }\n\n  const { collision, rewrites } = resolveHomeRouteCollision(files);\n\n  if (rewrites.length === 0) {\n    return collision;\n  }\n\n  try {\n    await Promise.all(\n      rewrites.map((file) => putFileAsync(srcPath(file.relativePath), file.source)),\n    );\n  } catch (error) {\n    return {\n      outcome: \"failed\",\n      reason: `could not be written (${(error as Error).message})`,\n    };\n  }\n\n  return collision;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,MAAM,qBAAqB;;;;;AAM3B,MAAM,wBAAwB;;;;;;;;;;;;;AAoC9B,SAAgB,0BAA0B,OAAgD;CACxF,MAAM,YAAY,MACf,KAAK,UAAU;EAAE;EAAM,SAAS,KAAK,OAAO,MAAM,kBAAkB,KAAK,CAAC;CAAE,EAAE,CAAC,CAC/E,QAAQ,EAAE,cAAc,QAAQ,SAAS,CAAC;CAE7C,IAAI,UAAU,WAAW,GACvB,OAAO;EAAE,WAAW,EAAE,SAAS,SAAS;EAAG,UAAU,CAAC;CAAE;CAG1D,IAAI,UAAU,SAAS,GAGrB,OAAO;EACL,WAAW;GACT,SAAS;GACT,QAAQ,+CALE,UAAU,KAAK,EAAE,WAAW,KAAK,YAAY,CAAC,CAAC,KAAK,IAKH,EAAE;EAC/D;EACA,UAAU,CAAC;CACb;CAGF,MAAM,WAAW,UAAU;CAM3B,IAAI,aAAa,QACf,OAAO;EAAE,WAAW,EAAE,SAAS,SAAS;EAAG,UAAU,CAAC;CAAE;CAG1D,MAAM,EAAE,MAAM,YAAY;CAE1B,IAAI,QAAQ,SAAS,GACnB,OAAO;EACL,WAAW;GACT,SAAS;GACT,QAAQ,GAAG,KAAK,aAAa,YAAY,QAAQ,OAAO;EAC1D;EACA,UAAU,CAAC;CACb;CAGF,IAAI,sBAAsB,KAAK,KAAK,MAAM,GACxC,OAAO;EACL,WAAW;GACT,SAAS;GACT,QAAQ,GAAG,KAAK,aAAa;EAC/B;EACA,UAAU,CAAC;CACb;CAGF,MAAM,OAAO,KAAK,OAAO,QAAQ,qBAAqB,OAAe,UACnE,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,UAAU,OAAO,CAC/D;CAEA,IAAI,SAAS,KAAK,QAChB,OAAO;EACL,WAAW;GACT,SAAS;GACT,QAAQ,GAAG,KAAK,aAAa;EAC/B;EACA,UAAU,CAAC;CACb;CAGF,OAAO;EACL,WAAW;GAAE,SAAS;GAAa,cAAc,KAAK;EAAa;EACnE,UAAU,CAAC;GAAE,cAAc,KAAK;GAAc,QAAQ;EAAK,CAAC;CAC9D;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,eAAsB,+BAA4D;CAChF,MAAM,gBAAgB,MAAM,KAAK,sBAAsB;EACrD,KAAK,QAAQ,KAAK;EAClB,UAAU;CACZ,CAAC;CAED,IAAI,cAAc,WAAW,GAC3B,OAAO,EAAE,SAAS,SAAS;CAG7B,IAAI;CAEJ,IAAI;EACF,QAAQ,MAAM,QAAQ,IACpB,cAAc,IAAI,OAAO,kBAAkB;GACzC,cAAc,OAAO;GACrB,QAAQ,MAAM,aAAa,QAAQ,OAAO,YAAY,CAAC;EACzD,EAAE,CACJ;CACF,SAAS,OAAO;EACd,OAAO;GACL,SAAS;GACT,QAAQ,sBAAuB,MAAgB,QAAQ;EACzD;CACF;CAEA,MAAM,EAAE,WAAW,aAAa,0BAA0B,KAAK;CAE/D,IAAI,SAAS,WAAW,GACtB,OAAO;CAGT,IAAI;EACF,MAAM,QAAQ,IACZ,SAAS,KAAK,SAAS,aAAa,QAAQ,KAAK,YAAY,GAAG,KAAK,MAAM,CAAC,CAC9E;CACF,SAAS,OAAO;EACd,OAAO;GACL,SAAS;GACT,QAAQ,yBAA0B,MAAgB,QAAQ;EAC5D;CACF;CAEA,OAAO;AACT"}

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

@@ -1,9 +1,9 @@
 import { srcPath } from "../../utils/paths.mjs";
 import "../../utils/index.mjs";
+import { fileExistsAsync, getFileAsync, putFileAsync } from "../generation-fs.mjs";
 import { INSTALLED_WARLOCK_VERSION } from "./types.mjs";
 import { mergeWebSitemapConfig } from "./shared/merge-web-sitemap-config.mjs";
 import { colors } from "@mongez/copper";
-import { fileExistsAsync, getFileAsync, putFileAsync } from "@warlock.js/fs";
 
 //#region ../../packages/core/src/generations/features/sitemap.feature.ts
 const NEXT_STEPS = "Next: set `app.publicUrl` (src/config/app.ts) or the PUBLIC_APP_URL environment variable, then flip `sitemap.enabled` to true in src/config/web.ts.";
@@ -49,7 +49,8 @@ async function installSitemapConfig() {
 		console.log(NEXT_STEPS);
 		return;
 	}
-	const merge = mergeWebSitemapConfig(await getFileAsync(configPath));
+	const current = await getFileAsync(configPath);
+	const merge = mergeWebSitemapConfig(current);
 	if (merge.status === "already-present") {
 		console.log(`${colors.yellowBright("sitemap")} already configured in src/config/web.ts, skipping...`);
 		return;