@aws/nx-plugin 1.0.0-rc.95 → 1.0.0-rc.97

package/src/ts/react-website/agui/generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/agui/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n} from '@nx/devkit';\nimport { addAgentRuntimeToConnectionNamespace } from '../../../connection/agent-runtime-config.js';\nimport { addTsDependencies } from '../../../utils/add-dependencies.js';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  applyGritQL,\n} from '../../../utils/ast.js';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies.js';\nimport { kebabCase } from '../../../utils/names.js';\nimport { getNpmScopePrefix } from '../../../utils/npm-scope.js';\nimport { registerPnpmBuiltDependencies } from '../../../utils/pnpm-workspace.js';\nimport {\n  addSharedShadcnDependency,\n  SHADCN_DEPENDENCIES,\n  sharedShadcnGenerator,\n} from '../../../utils/shared-shadcn.js';\nimport { runtimeConfigGenerator } from '../runtime-config/generator.js';\n\n/**\n * The values this helper's predicates read. Its callers record them, so the\n * theme and auth branches taken here can be confirmed at upgrade time.\n */\nexport interface AgUiMetadata {\n  readonly theme: string;\n  readonly auth: string;\n}\n\n// Each entry names the theme or auth branch it belongs to, so the same\n// declaration drives both adding and the version sync.\nexport const DEPENDENCIES = declareDependencies<AgUiMetadata>()({\n  ts: [\n    { name: '@copilotkit/react-core' },\n    { name: '@ag-ui/client' },\n    {\n      name: '@cloudscape-design/chat-components',\n      when: (m) => m.theme === 'cloudscape',\n    },\n    { name: 'lucide-react', when: (m) => m.theme === 'shadcn' },\n    { name: 'oidc-client-ts', when: (m) => m.auth === 'iam' },\n    { name: 'aws4fetch', when: (m) => m.auth === 'iam' },\n    {\n      name: '@aws-sdk/credential-provider-cognito-identity',\n      when: (m) => m.auth === 'iam',\n    },\n    {\n      name: 'react-oidc-context',\n      when: (m) => m.auth === 'iam' || m.auth === 'cognito',\n    },\n    { name: '@smithy/types', when: (m) => m.auth === 'iam', dev: true },\n    // `sharedShadcnGenerator` adds these to the shared shadcn project it\n    // creates, not to the website.\n    ...ownedElsewhere(SHADCN_DEPENDENCIES),\n  ],\n});\n\nexport type AgUiAuth = 'iam' | 'cognito' | 'none';\n\nexport type AgUiTheme = 'cloudscape' | 'shadcn' | 'default';\n\nexport interface AgUiReactConnectionOptions {\n  /** The React website project to connect FROM */\n  frontendProjectConfig: ProjectConfiguration;\n  /** The AG-UI agent's exposed name (used as CopilotKit's agent key) */\n  agentName: string;\n  /** PascalCase class name used for component names and runtime config keys */\n  agentNameClassName: string;\n  /** Auth scheme used by the agent */\n  auth: AgUiAuth;\n  /**\n   * When set, the generated hook reads the gateway's URL from\n   * runtimeConfig.gateways and routes to the agent via the gateway's\n   * path-based `/<targetName>/invocations` route instead of invoking the\n   * runtime directly. The gateway publishes its own URL to the website, so\n   * the agent's construct is left unpatched.\n   */\n  gatewayRoute?: {\n    gatewayClassName: string;\n    targetName: string;\n  };\n}\n\n/**\n * Wires a React website up to an AG-UI agent using CopilotKit and\n * @ag-ui/client's HttpAgent. Agent-server-language agnostic.\n *\n * On first invocation creates a shared `AguiProvider` component (with an empty\n * `selfManagedAgents` registry) and wraps `<App />` in it. Each invocation\n * AST-patches `AguiProvider` to register one more agent hook — running the\n * generator multiple times is idempotent and additive.\n *\n * Also vends a `src/components/copilot` theme module picked from the\n * website's `metadata.ux` (cloudscape / shadcn / default).\n */\nexport const addAgUiReactConnection = async (\n  tree: Tree,\n  options: AgUiReactConnectionOptions,\n) => {\n  const {\n    frontendProjectConfig,\n    agentName,\n    agentNameClassName,\n    auth,\n    gatewayRoute,\n  } = options;\n\n  const theme = resolveAgUiTheme(frontendProjectConfig);\n  // The values the declaration's predicates read. Callers record the same pair,\n  // so what is added here is exactly what the version sync owns.\n  const metadata: AgUiMetadata = { theme, auth };\n  const scopeAlias = getNpmScopePrefix(tree);\n\n  // Generates `src/components/AguiProvider.tsx` (if absent) and\n  // `src/hooks/useAgui<AgentName>.tsx`. Existing files are kept so re-running\n  // the generator is idempotent.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'common'),\n    frontendProjectConfig.root,\n    { agentName, agentNameClassName, auth, gatewayRoute },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // Shadcn theme imports from the shared shadcn library, so it must exist.\n  if (theme === 'shadcn') {\n    await sharedShadcnGenerator(tree, DEPENDENCIES);\n    addSharedShadcnDependency(tree, frontendProjectConfig.root);\n  }\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', theme),\n    frontendProjectConfig.root,\n    { scopeAlias },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  if (auth === 'iam') {\n    generateFiles(\n      tree,\n      joinPathFragments(\n        import.meta.dirname,\n        '../../../utils/files/website/hooks/sigv4',\n      ),\n      joinPathFragments(frontendProjectConfig.sourceRoot, 'hooks'),\n      {},\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n  }\n\n  await runtimeConfigGenerator(tree, {\n    project: frontendProjectConfig.name,\n  });\n\n  // AST-patch AguiProvider to register this agent's hook\n  await registerAgentHookInProvider(\n    tree,\n    frontendProjectConfig,\n    agentNameClassName,\n  );\n\n  // Wrap <App /> in <AguiProvider> in main.tsx (idempotent)\n  const mainTsxPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'main.tsx',\n  );\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    'AguiProvider',\n    './components/AguiProvider',\n  );\n  await applyGritQL(\n    tree,\n    mainTsxPath,\n    `\\`<App />\\` => \\`<AguiProvider><App /></AguiProvider>\\` where { $program <: not contains \\`<AguiProvider>$_</AguiProvider>\\` }`,\n  );\n\n  // @copilotkit/react-core transitively pulls in @scarf/scarf (telemetry),\n  // which has a postinstall script. Under pnpm 11's default\n  // `strictDepBuilds=true` that script is treated as an unreviewed build and\n  // fails the install. Register it as an explicitly-rejected build so pnpm\n  // knows we've seen it and will skip it instead of erroring.\n  registerPnpmBuiltDependencies(tree, { '@scarf/scarf': false });\n\n  addTsDependencies(tree, DEPENDENCIES, {\n    metadata,\n    projectRoot: frontendProjectConfig.root,\n  });\n\n  // Agents only publish their runtime ARN to the 'agentcore' namespace by\n  // default, which isn't exposed to the website. Patch the agent's CDK/TF\n  // construct to also publish under 'connection' so the browser can read it\n  // from runtime-config.json. When routing via a gateway, the gateway\n  // publishes its own URL instead.\n  if (!gatewayRoute) {\n    await addAgentRuntimeToConnectionNamespace(tree, {\n      agentNameKebabCase: kebabCase(agentNameClassName),\n      agentNameClassName,\n    });\n  }\n};\n\n/**\n * The theme module this helper vends, from the website's `metadata.ux`. Callers\n * record the resolved value, so the theme predicates read what the code branches\n * on.\n */\nexport const resolveAgUiTheme = (\n  frontendProjectConfig: ProjectConfiguration,\n): AgUiTheme => {\n  const ux = (\n    (frontendProjectConfig.metadata as any)?.ux as string | undefined\n  )?.toLowerCase();\n  switch (ux) {\n    case 'cloudscape':\n      return 'cloudscape';\n    case 'shadcn':\n      return 'shadcn';\n    default:\n      return 'default';\n  }\n};\n\n/**\n * Register this agent's hook in the shared `AguiProvider` using GritQL AST\n * patches. The provider starts out with an empty `selfManagedAgents` registry\n * (from the template); each call appends:\n *   - `import { useAgui<Name> } from '../hooks/useAgui<Name>';`\n *   - `const <varName> = useAgui<Name>();` before the `useMemo` call\n *   - `...<varName>` into the memoised object literal\n *   - `<varName>` into the `useMemo` deps array\n *\n * All steps are guarded so re-running produces byte-identical output.\n */\nconst registerAgentHookInProvider = async (\n  tree: Tree,\n  frontendProjectConfig: ProjectConfiguration,\n  agentNameClassName: string,\n) => {\n  const providerPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'components',\n    'AguiProvider.tsx',\n  );\n  const hookName = `useAgui${agentNameClassName}`;\n  // useAguiStoryAgent -> storyAgentAgents\n  const varName = `${agentNameClassName.charAt(0).toLowerCase()}${agentNameClassName.slice(1)}Agents`;\n\n  // 1. Add the hook import\n  await addDestructuredImport(\n    tree,\n    providerPath,\n    [hookName],\n    `../hooks/${hookName}`,\n  );\n\n  // 2. Insert `const <varName> = <hookName>();` before the useMemo declaration\n  await applyGritQL(\n    tree,\n    providerPath,\n    `\\`const selfManagedAgents = useMemo<Record<string, AbstractAgent>>($body, $deps);\\` => ` +\n      `\\`const ${varName} = ${hookName}();\\nconst selfManagedAgents = useMemo<Record<string, AbstractAgent>>($body, $deps);\\` ` +\n      `where { $program <: not contains \\`const ${varName} = ${hookName}()\\` }`,\n  );\n\n  // 3. Spread `...<varName>` into the memoised object and add `<varName>` to\n  //    the deps array. Branches on `{}`/`[]` vs populated so both the\n  //    first-agent and nth-agent cases produce clean output.\n  await applyGritQL(\n    tree,\n    providerPath,\n    `\\`useMemo<Record<string, AbstractAgent>>(() => ($obj), $deps)\\` where {` +\n      ` $obj <: not contains \\`...${varName}\\`,` +\n      ` if ($obj <: \\`{}\\`) { $obj => \\`{ ...${varName} }\\` }` +\n      ` else { $obj <: \\`{$items}\\` where { $items += \\`, ...${varName}\\` } },` +\n      ` if ($deps <: \\`[]\\`) { $deps => \\`[${varName}]\\` }` +\n      ` else { $deps <: \\`[$dd]\\` where { $dd += \\`, ${varName}\\` } }` +\n      ` }`,\n  );\n};\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","addAgentRuntimeToConnectionNamespace","addTsDependencies","addDestructuredImport","addSingleImport","applyGritQL","declareDependencies","ownedElsewhere","kebabCase","getNpmScopePrefix","registerPnpmBuiltDependencies","addSharedShadcnDependency","SHADCN_DEPENDENCIES","sharedShadcnGenerator","runtimeConfigGenerator","DEPENDENCIES","ts","name","when","m","theme","auth","dev","addAgUiReactConnection","tree","options","frontendProjectConfig","agentName","agentNameClassName","gatewayRoute","resolveAgUiTheme","metadata","scopeAlias","dirname","root","overwriteStrategy","KeepExisting","sourceRoot","project","registerAgentHookInProvider","mainTsxPath","projectRoot","agentNameKebabCase","ux","toLowerCase","providerPath","hookName","varName","charAt","slice"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/agui/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n} from '@nx/devkit';\nimport { addAgentRuntimeToConnectionNamespace } from '../../../connection/agent-runtime-config.js';\nimport { addTsDependencies } from '../../../utils/add-dependencies.js';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  applyGritQL,\n} from '../../../utils/ast.js';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies.js';\nimport { kebabCase, snakeCase } from '../../../utils/names.js';\nimport { getNpmScopePrefix } from '../../../utils/npm-scope.js';\nimport { registerPnpmBuiltDependencies } from '../../../utils/pnpm-workspace.js';\nimport {\n  addSharedShadcnDependency,\n  SHADCN_DEPENDENCIES,\n  sharedShadcnGenerator,\n} from '../../../utils/shared-shadcn.js';\nimport { runtimeConfigGenerator } from '../runtime-config/generator.js';\n\n/**\n * The values this helper's predicates read. Its callers record them, so the\n * theme and auth branches taken here can be confirmed at upgrade time.\n */\nexport interface AgUiMetadata {\n  readonly theme: string;\n  readonly auth: string;\n}\n\n// Each entry names the theme or auth branch it belongs to, so the same\n// declaration drives both adding and the version sync.\nexport const DEPENDENCIES = declareDependencies<AgUiMetadata>()({\n  ts: [\n    { name: '@copilotkit/react-core' },\n    { name: '@ag-ui/client' },\n    {\n      name: '@cloudscape-design/chat-components',\n      when: (m) => m.theme === 'cloudscape',\n    },\n    { name: 'lucide-react', when: (m) => m.theme === 'shadcn' },\n    { name: 'oidc-client-ts', when: (m) => m.auth === 'iam' },\n    { name: 'aws4fetch', when: (m) => m.auth === 'iam' },\n    {\n      name: '@aws-sdk/credential-provider-cognito-identity',\n      when: (m) => m.auth === 'iam',\n    },\n    {\n      name: 'react-oidc-context',\n      when: (m) => m.auth === 'iam' || m.auth === 'cognito',\n    },\n    { name: '@smithy/types', when: (m) => m.auth === 'iam', dev: true },\n    // `sharedShadcnGenerator` adds these to the shared shadcn project it\n    // creates, not to the website.\n    ...ownedElsewhere(SHADCN_DEPENDENCIES),\n  ],\n});\n\nexport type AgUiAuth = 'iam' | 'cognito' | 'none';\n\nexport type AgUiTheme = 'cloudscape' | 'shadcn' | 'default';\n\nexport interface AgUiReactConnectionOptions {\n  /** The React website project to connect FROM */\n  frontendProjectConfig: ProjectConfiguration;\n  /** The AG-UI agent's exposed name (used as CopilotKit's agent key) */\n  agentName: string;\n  /** PascalCase class name used for component names and runtime config keys */\n  agentNameClassName: string;\n  /** Auth scheme used by the agent */\n  auth: AgUiAuth;\n  /**\n   * When set, the generated hook reads the gateway's URL from\n   * runtimeConfig.gateways and routes to the agent via the gateway's\n   * path-based `/<targetName>/invocations` route instead of invoking the\n   * runtime directly. The gateway publishes its own URL to the website, so\n   * the agent's construct is left unpatched.\n   */\n  gatewayRoute?: {\n    gatewayClassName: string;\n    targetName: string;\n  };\n}\n\n/**\n * Wires a React website up to an AG-UI agent using CopilotKit and\n * @ag-ui/client's HttpAgent. Agent-server-language agnostic.\n *\n * On first invocation creates a shared `AguiProvider` component (with an empty\n * `selfManagedAgents` registry) and wraps `<App />` in it. Each invocation\n * AST-patches `AguiProvider` to register one more agent hook — running the\n * generator multiple times is idempotent and additive.\n *\n * Also vends a `src/components/copilot` theme module picked from the\n * website's `metadata.ux` (cloudscape / shadcn / default).\n */\nexport const addAgUiReactConnection = async (\n  tree: Tree,\n  options: AgUiReactConnectionOptions,\n) => {\n  const {\n    frontendProjectConfig,\n    agentName,\n    agentNameClassName,\n    auth,\n    gatewayRoute,\n  } = options;\n\n  const theme = resolveAgUiTheme(frontendProjectConfig);\n  // The values the declaration's predicates read. Callers record the same pair,\n  // so what is added here is exactly what the version sync owns.\n  const metadata: AgUiMetadata = { theme, auth };\n  const scopeAlias = getNpmScopePrefix(tree);\n\n  // Generates `src/components/AguiProvider.tsx` (if absent),\n  // `src/components/<agent-name>-chat.tsx` and\n  // `src/hooks/useAgui<AgentName>.tsx`. Existing files are kept so re-running\n  // the generator is idempotent.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'common'),\n    frontendProjectConfig.root,\n    {\n      agentName,\n      agentNameClassName,\n      agentNameKebabCase: kebabCase(agentNameClassName),\n      // STORY_AGENT, naming the exported `<name>_ID` constant\n      agentNameConstantName: snakeCase(agentNameClassName).toUpperCase(),\n      auth,\n      gatewayRoute,\n    },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // Shadcn theme imports from the shared shadcn library, so it must exist.\n  if (theme === 'shadcn') {\n    await sharedShadcnGenerator(tree, DEPENDENCIES);\n    addSharedShadcnDependency(tree, frontendProjectConfig.root);\n  }\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', theme),\n    frontendProjectConfig.root,\n    { scopeAlias },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  if (auth === 'iam') {\n    generateFiles(\n      tree,\n      joinPathFragments(\n        import.meta.dirname,\n        '../../../utils/files/website/hooks/sigv4',\n      ),\n      joinPathFragments(frontendProjectConfig.sourceRoot, 'hooks'),\n      {},\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n  }\n\n  await runtimeConfigGenerator(tree, {\n    project: frontendProjectConfig.name,\n  });\n\n  // AST-patch AguiProvider to register this agent's hook\n  await registerAgentHookInProvider(\n    tree,\n    frontendProjectConfig,\n    agentNameClassName,\n  );\n\n  // Wrap <App /> in <AguiProvider> in main.tsx (idempotent)\n  const mainTsxPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'main.tsx',\n  );\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    'AguiProvider',\n    './components/AguiProvider',\n  );\n  await applyGritQL(\n    tree,\n    mainTsxPath,\n    `\\`<App />\\` => \\`<AguiProvider><App /></AguiProvider>\\` where { $program <: not contains \\`<AguiProvider>$_</AguiProvider>\\` }`,\n  );\n\n  // @copilotkit/react-core transitively pulls in @scarf/scarf (telemetry),\n  // which has a postinstall script. Under pnpm 11's default\n  // `strictDepBuilds=true` that script is treated as an unreviewed build and\n  // fails the install. Register it as an explicitly-rejected build so pnpm\n  // knows we've seen it and will skip it instead of erroring.\n  registerPnpmBuiltDependencies(tree, { '@scarf/scarf': false });\n\n  addTsDependencies(tree, DEPENDENCIES, {\n    metadata,\n    projectRoot: frontendProjectConfig.root,\n  });\n\n  // Agents only publish their runtime ARN to the 'agentcore' namespace by\n  // default, which isn't exposed to the website. Patch the agent's CDK/TF\n  // construct to also publish under 'connection' so the browser can read it\n  // from runtime-config.json. When routing via a gateway, the gateway\n  // publishes its own URL instead.\n  if (!gatewayRoute) {\n    await addAgentRuntimeToConnectionNamespace(tree, {\n      agentNameKebabCase: kebabCase(agentNameClassName),\n      agentNameClassName,\n    });\n  }\n};\n\n/**\n * The theme module this helper vends, from the website's `metadata.ux`. Callers\n * record the resolved value, so the theme predicates read what the code branches\n * on.\n */\nexport const resolveAgUiTheme = (\n  frontendProjectConfig: ProjectConfiguration,\n): AgUiTheme => {\n  const ux = (\n    (frontendProjectConfig.metadata as any)?.ux as string | undefined\n  )?.toLowerCase();\n  switch (ux) {\n    case 'cloudscape':\n      return 'cloudscape';\n    case 'shadcn':\n      return 'shadcn';\n    default:\n      return 'default';\n  }\n};\n\n/**\n * Register this agent's hook in the shared `AguiProvider` using GritQL AST\n * patches. The provider starts out with an empty `selfManagedAgents` registry\n * (from the template); each call appends:\n *   - `import { useAgui<Name> } from '../hooks/useAgui<Name>';`\n *   - `const <varName> = useAgui<Name>();` before the `useMemo` call\n *   - `...<varName>` into the memoised object literal\n *   - `<varName>` into the `useMemo` deps array\n *\n * All steps are guarded so re-running produces byte-identical output.\n */\nconst registerAgentHookInProvider = async (\n  tree: Tree,\n  frontendProjectConfig: ProjectConfiguration,\n  agentNameClassName: string,\n) => {\n  const providerPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'components',\n    'AguiProvider.tsx',\n  );\n  const hookName = `useAgui${agentNameClassName}`;\n  // useAguiStoryAgent -> storyAgentAgents\n  const varName = `${agentNameClassName.charAt(0).toLowerCase()}${agentNameClassName.slice(1)}Agents`;\n\n  // 1. Add the hook import\n  await addDestructuredImport(\n    tree,\n    providerPath,\n    [hookName],\n    `../hooks/${hookName}`,\n  );\n\n  // 2. Insert `const <varName> = <hookName>();` before the useMemo declaration\n  await applyGritQL(\n    tree,\n    providerPath,\n    `\\`const selfManagedAgents = useMemo<Record<string, AbstractAgent>>($body, $deps);\\` => ` +\n      `\\`const ${varName} = ${hookName}();\\nconst selfManagedAgents = useMemo<Record<string, AbstractAgent>>($body, $deps);\\` ` +\n      `where { $program <: not contains \\`const ${varName} = ${hookName}()\\` }`,\n  );\n\n  // 3. Spread `...<varName>` into the memoised object and add `<varName>` to\n  //    the deps array. Branches on `{}`/`[]` vs populated so both the\n  //    first-agent and nth-agent cases produce clean output.\n  await applyGritQL(\n    tree,\n    providerPath,\n    `\\`useMemo<Record<string, AbstractAgent>>(() => ($obj), $deps)\\` where {` +\n      ` $obj <: not contains \\`...${varName}\\`,` +\n      ` if ($obj <: \\`{}\\`) { $obj => \\`{ ...${varName} }\\` }` +\n      ` else { $obj <: \\`{$items}\\` where { $items += \\`, ...${varName}\\` } },` +\n      ` if ($deps <: \\`[]\\`) { $deps => \\`[${varName}]\\` }` +\n      ` else { $deps <: \\`[$dd]\\` where { $dd += \\`, ${varName}\\` } }` +\n      ` }`,\n  );\n};\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","addAgentRuntimeToConnectionNamespace","addTsDependencies","addDestructuredImport","addSingleImport","applyGritQL","declareDependencies","ownedElsewhere","kebabCase","snakeCase","getNpmScopePrefix","registerPnpmBuiltDependencies","addSharedShadcnDependency","SHADCN_DEPENDENCIES","sharedShadcnGenerator","runtimeConfigGenerator","DEPENDENCIES","ts","name","when","m","theme","auth","dev","addAgUiReactConnection","tree","options","frontendProjectConfig","agentName","agentNameClassName","gatewayRoute","resolveAgUiTheme","metadata","scopeAlias","dirname","root","agentNameKebabCase","agentNameConstantName","toUpperCase","overwriteStrategy","KeepExisting","sourceRoot","project","registerAgentHookInProvider","mainTsxPath","projectRoot","ux","toLowerCase","providerPath","hookName","varName","charAt","slice"],"mappings":"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"}

package/src/ts/react-website/app/__snapshots__/generator.spec.ts.snap

@@ -1058,8 +1058,6 @@ vitest.config.*.timestamp*
 runtime-config.json"
 `;
 
-exports[`react-website generator > Tanstack router integration > should generate website with no router correctly > .prettierrc 1`] = `"{"singleQuote":true}"`;
-
 exports[`react-website generator > Tanstack router integration > should generate website with no router correctly > biome.json 1`] = `
 "{
   "$schema": "https://biomejs.dev/schemas/2.5.11/schema.json",
@@ -1243,11 +1241,11 @@ exports[`react-website generator > Tanstack router integration > should generate
   "name": "@proj/source",
   "dependencies": {},
   "devDependencies": {
-    "@nx/js": "23.1.2",
+    "@nx/js": "23.2.0",
     "@nx/react": "catalog:",
-    "@nx/vite": "23.1.2",
-    "@nx/vitest": "23.1.2",
-    "@nx/web": "23.1.2",
+    "@nx/vite": "23.2.0",
+    "@nx/vitest": "catalog:",
+    "@nx/web": "23.2.0",
     "@swc/helpers": "~0.5.18",
     "@tailwindcss/vite": "catalog:",
     "@testing-library/dom": "10.4.0",
@@ -1259,7 +1257,7 @@ exports[`react-website generator > Tanstack router integration > should generate
     "@vitest/coverage-v8": "catalog:",
     "@vitest/ui": "catalog:",
     "jiti": "2.4.2",
-    "jsdom": "^27.1.0",
+    "jsdom": "catalog:",
     "typescript": "~6.0.3",
     "vite": "catalog:",
     "vitest": "catalog:"
@@ -2327,19 +2325,21 @@ exports[`react-website generator > Tanstack router integration > should generate
   - test-app
   - packages/common/*
 catalog:
+  '@types/node': 26.4.0
   vite: 8.2.2
   vitest: 4.1.11
   '@vitest/coverage-v8': 4.1.11
+  jsdom: 27.4.0
+  '@nx/vitest': 23.2.0
   constructs: 10.8.1
   aws-cdk-lib: 2.267.0
-  '@types/node': 26.4.0
   react: 19.2.8
   react-dom: 19.2.8
   '@cloudscape-design/components': 3.0.1356
   '@cloudscape-design/board-components': 3.0.221
   '@cloudscape-design/global-styles': 1.0.67
   tailwindcss: 4.3.3
-  '@nx/react': 23.1.2
+  '@nx/react': 23.2.0
   '@vitest/ui': 4.1.11
   '@tailwindcss/vite': 4.3.3
 "
@@ -2429,7 +2429,9 @@ exports[`react-website generator > Tanstack router integration > should generate
     "react-dom": "catalog:",
     "tailwindcss": "catalog:"
   },
-  "devDependencies": {}
+  "devDependencies": {
+    "@types/node": "catalog:"
+  }
 }
 "
 `;
@@ -2908,7 +2910,7 @@ exports[`react-website generator > Tanstack router integration > should generate
 "
 `;
 
-exports[`react-website generator > Tanstack router integration > should generate website with no router correctly > vitest.config.ts 1`] = `
+exports[`react-website generator > Tanstack router integration > should generate website with no router correctly > vitest.config.mts 1`] = `
 "import { defineConfig } from 'vitest/config';
 
 export default defineConfig({
@@ -2932,8 +2934,6 @@ vitest.config.*.timestamp*
 runtime-config.json"
 `;
 
-exports[`react-website generator > Tanstack router integration > should generate website with router correctly > .prettierrc 1`] = `"{"singleQuote":true}"`;
-
 exports[`react-website generator > Tanstack router integration > should generate website with router correctly > biome.json 1`] = `
 "{
   "$schema": "https://biomejs.dev/schemas/2.5.11/schema.json",
@@ -3117,11 +3117,11 @@ exports[`react-website generator > Tanstack router integration > should generate
   "name": "@proj/source",
   "dependencies": {},
   "devDependencies": {
-    "@nx/js": "23.1.2",
+    "@nx/js": "23.2.0",
     "@nx/react": "catalog:",
-    "@nx/vite": "23.1.2",
-    "@nx/vitest": "23.1.2",
-    "@nx/web": "23.1.2",
+    "@nx/vite": "23.2.0",
+    "@nx/vitest": "catalog:",
+    "@nx/web": "23.2.0",
     "@swc/helpers": "~0.5.18",
     "@tailwindcss/vite": "catalog:",
     "@tanstack/router-generator": "catalog:",
@@ -3137,7 +3137,7 @@ exports[`react-website generator > Tanstack router integration > should generate
     "@vitest/coverage-v8": "catalog:",
     "@vitest/ui": "catalog:",
     "jiti": "2.4.2",
-    "jsdom": "^27.1.0",
+    "jsdom": "catalog:",
     "typescript": "~6.0.3",
     "vite": "catalog:",
     "vitest": "catalog:"
@@ -4205,12 +4205,14 @@ exports[`react-website generator > Tanstack router integration > should generate
   - test-app
   - packages/common/*
 catalog:
+  '@types/node': 26.4.0
   vite: 8.2.2
   vitest: 4.1.11
   '@vitest/coverage-v8': 4.1.11
+  jsdom: 27.4.0
+  '@nx/vitest': 23.2.0
   constructs: 10.8.1
   aws-cdk-lib: 2.267.0
-  '@types/node': 26.4.0
   react: 19.2.8
   react-dom: 19.2.8
   '@cloudscape-design/components': 3.0.1356
@@ -4218,7 +4220,7 @@ catalog:
   '@cloudscape-design/global-styles': 1.0.67
   tailwindcss: 4.3.3
   '@tanstack/react-router': 1.170.32
-  '@nx/react': 23.1.2
+  '@nx/react': 23.2.0
   '@vitest/ui': 4.1.11
   '@tailwindcss/vite': 4.3.3
   '@tanstack/router-plugin': 1.168.35
@@ -4313,7 +4315,9 @@ exports[`react-website generator > Tanstack router integration > should generate
     "react-dom": "catalog:",
     "tailwindcss": "catalog:"
   },
-  "devDependencies": {}
+  "devDependencies": {
+    "@types/node": "catalog:"
+  }
 }
 "
 `;
@@ -4985,7 +4989,7 @@ exports[`react-website generator > Tanstack router integration > should generate
 "
 `;
 
-exports[`react-website generator > Tanstack router integration > should generate website with router correctly > vitest.config.ts 1`] = `
+exports[`react-website generator > Tanstack router integration > should generate website with router correctly > vitest.config.mts 1`] = `
 "import { defineConfig } from 'vitest/config';
 
 export default defineConfig({

package/src/ts/react-website/app/generator.d.ts

@@ -72,6 +72,17 @@ export declare const DEPENDENCIES: import("../../../utils/declared-dependencies.
 }, {
     readonly name: "express";
     readonly versionOnly: true;
+}, {
+    readonly name: "@types/node";
+    readonly dev: true;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@types/node";
+    readonly dev: true;
+    readonly root: true;
+} & {
+    versionOnly: true;
 }, {
     readonly name: "react";
 } & {
@@ -116,6 +127,27 @@ export declare const DEPENDENCIES: import("../../../utils/declared-dependencies.
     readonly name: "@vitest/coverage-v8";
 } & {
     versionOnly: true;
+}, {
+    readonly name: "jsdom";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@nx/vitest";
+    readonly dev: true;
+    readonly root: true;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@types/node";
+    readonly dev: true;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@types/node";
+    readonly dev: true;
+    readonly root: true;
+} & {
+    versionOnly: true;
 }, {
     readonly name: "vite";
 } & {
@@ -128,6 +160,16 @@ export declare const DEPENDENCIES: import("../../../utils/declared-dependencies.
     readonly name: "@vitest/coverage-v8";
 } & {
     versionOnly: true;
+}, {
+    readonly name: "jsdom";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@nx/vitest";
+    readonly dev: true;
+    readonly root: true;
+} & {
+    versionOnly: true;
 }, {
     readonly name: "constructs";
     readonly when: (m: IacMetadata) => boolean;

package/src/ts/react-website/app/generator.js

@@ -23,7 +23,7 @@ import { PACKAGES_DIR, SHARED_SHADCN_DIR, TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE
 import { addSharedShadcnDependency, SHADCN_DEPENDENCIES, sharedShadcnGenerator } from "../../../utils/shared-shadcn.js";
 import { withVersions } from "../../../utils/versions.js";
 import { addWebsiteInfra, WEBSITE_CONSTRUCTS_PY_DEPENDENCIES } from "../../../utils/website-constructs/website-constructs.js";
-import { configureTsProject } from "../../lib/ts-project-utils.js";
+import { configureTsProject, mergeTsProjectDirReference, TS_PROJECT_DEPENDENCIES } from "../../lib/ts-project-utils.js";
 import { VITEST_DEPENDENCIES } from "../../lib/vitest.js";
 // Each entry names the branch it belongs to, so the same declaration drives both
 // adding and the version sync.
@@ -108,6 +108,7 @@ export const DEPENDENCIES = declareDependencies()({
             name: 'express',
             versionOnly: true
         },
+        ...ownedElsewhere(TS_PROJECT_DEPENDENCIES),
         ...ownedElsewhere(SHADCN_DEPENDENCIES),
         ...ownedElsewhere(VITEST_DEPENDENCIES),
         ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES)
@@ -311,7 +312,7 @@ export async function tsReactWebsiteGenerator(tree, schema) {
     const projectConfig = readProjectConfiguration(tree, fullyQualifiedName);
     const libraryRoot = projectConfig.root;
     const sharedShadcnStylesImport = relative(joinPathFragments(libraryRoot, 'src'), joinPathFragments(PACKAGES_DIR, SHARED_SHADCN_DIR, 'src', 'styles', 'globals.css')).split(sep).join('/');
-    const sharedShadcnTsconfigRef = relative(joinPathFragments(tree.root, websiteContentPath), joinPathFragments(tree.root, PACKAGES_DIR, SHARED_SHADCN_DIR, 'tsconfig.json')).split(sep).join('/');
+    const sharedShadcnProjectRef = relative(joinPathFragments(tree.root, websiteContentPath), joinPathFragments(tree.root, PACKAGES_DIR, SHARED_SHADCN_DIR)).split(sep).join('/');
     const templateOptions = {
         ...schema,
         fullyQualifiedName,
@@ -422,12 +423,7 @@ export async function tsReactWebsiteGenerator(tree, schema) {
                     'DOM'
                 ]
             },
-            references: ux === 'shadcn' ? [
-                ...(tsconfig.references ?? []).filter((ref)=>ref.path !== sharedShadcnTsconfigRef),
-                {
-                    path: sharedShadcnTsconfigRef
-                }
-            ] : tsconfig.references
+            references: ux === 'shadcn' ? mergeTsProjectDirReference(tsconfig.references, sharedShadcnProjectRef) : tsconfig.references
         }));
     addTsDependencies(tree, DEPENDENCIES, {
         metadata,

package/src/ts/react-website/app/generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/app/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  detectPackageManager,\n  generateFiles,\n  joinPathFragments,\n  names,\n  OverwriteStrategy,\n  readProjectConfiguration,\n  removeDependenciesFromPackageJson,\n  type Tree,\n  updateJson,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { applicationGenerator } from '@nx/react';\nimport { relative, sep } from 'path';\nimport { addTsDependencies } from '../../../utils/add-dependencies.js';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  appendToArrayViaGritQL,\n  applyGritQL,\n} from '../../../utils/ast.js';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies.js';\nimport { formatFilesInSubtree } from '../../../utils/format.js';\nimport { resolveIac } from '../../../utils/iac.js';\nimport { installDependencies } from '../../../utils/install.js';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics.js';\nimport { kebabCase, toClassName, toKebabCase } from '../../../utils/names.js';\nimport { getNpmScopePrefix } from '../../../utils/npm-scope.js';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n} from '../../../utils/nx.js';\nimport { sortObjectKeys } from '../../../utils/object.js';\nimport { getRelativePathToRoot } from '../../../utils/paths.js';\nimport { getPackageManagerDisplayCommands } from '../../../utils/pkg-manager.js';\nimport { assignPort } from '../../../utils/port.js';\nimport {\n  SHARED_CONSTRUCTS_DEPENDENCIES,\n  sharedConstructsGenerator,\n} from '../../../utils/shared-constructs.js';\nimport {\n  type IacMetadata,\n  PACKAGES_DIR,\n  SHARED_SHADCN_DIR,\n  TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE,\n} from '../../../utils/shared-constructs-constants.js';\nimport {\n  addSharedShadcnDependency,\n  SHADCN_DEPENDENCIES,\n  sharedShadcnGenerator,\n} from '../../../utils/shared-shadcn.js';\nimport { withVersions } from '../../../utils/versions.js';\nimport {\n  addWebsiteInfra,\n  WEBSITE_CONSTRUCTS_PY_DEPENDENCIES,\n} from '../../../utils/website-constructs/website-constructs.js';\nimport { configureTsProject } from '../../lib/ts-project-utils.js';\nimport { VITEST_DEPENDENCIES } from '../../lib/vitest.js';\n// typescript factory imports removed — now using GritQL for vite config transforms\nimport type {\n  TsReactWebsiteGeneratorSchema,\n  WebsiteInfraOption,\n} from './schema';\n\n/** The metadata this generator records, which its predicates read. */\nexport interface TsReactWebsiteMetadata extends IacMetadata {\n  readonly ux: UxOption;\n  readonly framework: string;\n  readonly infra: WebsiteInfraOption;\n  readonly tailwind: boolean;\n  readonly tanstackRouter: boolean;\n}\n\n// Each entry names the branch it belongs to, so the same declaration drives both\n// adding and the version sync.\nexport const DEPENDENCIES = declareDependencies<TsReactWebsiteMetadata>()({\n  ts: [\n    { name: 'react' },\n    { name: 'react-dom' },\n    // Build/test tooling imported only from vite.config.mts stays at the root.\n    { name: '@nx/react', dev: true, root: true },\n    { name: '@vitest/ui', dev: true, root: true },\n    {\n      name: '@cloudscape-design/components',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    {\n      name: '@cloudscape-design/board-components',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    {\n      name: '@cloudscape-design/global-styles',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    // Shared shadcn components live in the common/shadcn package, but the\n    // website's own generated components (e.g. the tanstack-router sidebar)\n    // import lucide-react directly, so the website must declare it.\n    {\n      name: 'lucide-react',\n      when: (m) => m.ux === 'shadcn' && m.tanstackRouter,\n    },\n    { name: 'tailwindcss', when: (m) => m.tailwind },\n    {\n      name: '@tailwindcss/vite',\n      when: (m) => m.tailwind,\n      dev: true,\n      root: true,\n    },\n    { name: '@tanstack/react-router', when: (m) => m.tanstackRouter },\n    {\n      name: '@tanstack/router-plugin',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/router-generator',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/virtual-file-routes',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/router-utils',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    // Declared for its pinned version, which goes into npm's `overrides` below.\n    { name: 'express', versionOnly: true },\n    ...ownedElsewhere(SHADCN_DEPENDENCIES),\n    ...ownedElsewhere(VITEST_DEPENDENCIES),\n    ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES),\n  ],\n  py: ownedElsewhere(WEBSITE_CONSTRUCTS_PY_DEPENDENCIES),\n});\n\nexport const SUPPORTED_UX_PROVIDERS = ['none', 'cloudscape', 'shadcn'] as const;\n\nexport type UxOption = (typeof SUPPORTED_UX_PROVIDERS)[number];\n\nexport type Ux = UxOption;\n\nexport const REACT_WEBSITE_APP_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport async function tsReactWebsiteGenerator(\n  tree: Tree,\n  schema: TsReactWebsiteGeneratorSchema,\n) {\n  const tailwind = schema.tailwind ?? true;\n  const tanstackRouter = schema.tanstackRouter ?? true;\n  const ux: Ux = schema.ux ?? 'shadcn';\n  if (ux === 'shadcn' && !tailwind) {\n    throw new Error('Shadcn requires TailwindCSS to be enabled.');\n  }\n  const npmScopePrefix = getNpmScopePrefix(tree);\n  const scopeAlias = npmScopePrefix;\n  const websiteNameClassName = toClassName(schema.name);\n  const websiteNameKebabCase = toKebabCase(schema.name);\n  const fullyQualifiedName = `${npmScopePrefix}${websiteNameKebabCase}`;\n  // NB: interactive nx generator cli can pass empty string\n  const websiteContentPath = joinPathFragments(\n    schema.directory || '.',\n    schema.subDirectory || websiteNameKebabCase,\n  );\n\n  const projectAlreadyExists = tree.exists(\n    joinPathFragments(websiteContentPath, 'project.json'),\n  );\n\n  // TODO: consider exposing and supporting e2e tests\n  const e2eTestRunner = 'none';\n\n  if (!projectAlreadyExists) {\n    await applicationGenerator(tree, {\n      ...schema,\n      name: fullyQualifiedName,\n      directory: websiteContentPath,\n      routing: false,\n      e2eTestRunner,\n      linter: 'none',\n      bundler: 'vite',\n      unitTestRunner: 'vitest',\n      useProjectJson: true,\n      style: 'css',\n      // Register the @nx/vite and @nx/vitest plugins so build/serve/test\n      // targets are inferred rather than emitting deprecated executor targets.\n      addPlugin: true,\n    });\n\n    // Pin the inferred target names. The vite production build is exposed as\n    // `bundle` (which produces the deployable artifact), leaving `build` as an\n    // aggregator over lint/compile/test/bundle. vite's own typecheck is dropped\n    // in favour of the tsc `compile`.\n    updateJson(tree, 'nx.json', (nxJson) => {\n      for (const plugin of nxJson.plugins ?? []) {\n        if (typeof plugin === 'string') continue;\n        if (plugin.plugin === '@nx/vite/plugin') {\n          plugin.options = {\n            ...plugin.options,\n            buildTargetName: 'bundle',\n            // Map both of vite's inferred dev-server targets onto `serve` so the\n            // plugin doesn't emit a separate `dev`; we author our own `dev`\n            // below running the local-dev vite mode.\n            serveTargetName: 'serve',\n            devTargetName: 'serve',\n            previewTargetName: 'preview',\n            serveStaticTargetName: 'serve-static',\n            typecheckTargetName: 'vite:typecheck',\n          };\n        } else if (plugin.plugin === '@nx/vitest') {\n          plugin.options = {\n            ...plugin.options,\n            testTargetName: 'test',\n          };\n        }\n      }\n      return nxJson;\n    });\n\n    // Replace with simpler sample source code\n    tree.delete(joinPathFragments(websiteContentPath, 'src'));\n  }\n\n  const projectConfiguration = readProjectConfiguration(\n    tree,\n    fullyQualifiedName,\n  );\n\n  const targets = projectConfiguration.targets;\n\n  // Each website gets its own explicit dev-server port. Vite itself already\n  // auto-increments past a port already in use, so two websites don't actually\n  // collide — but which port each one lands on then depends on start order and\n  // can't be known ahead of time. An explicit, per-project port is what lets\n  // the Cognito callback URL allow-list (added when auth is configured) be\n  // computed deterministically instead.\n  const port = assignPort(tree, projectConfiguration, 4200);\n  // @nx/react's vite config defaults to 4200 for the dev server and 4300 for\n  // preview; keep that +100 relationship so the pair stays predictable.\n  const previewPort = port + 100;\n\n  const infra = schema.infra ?? 'cloudfront-s3';\n\n  // Configure load-runtime-config target based on IaC provider (only when infra is not none)\n  const iac = infra !== 'none' ? await resolveIac(tree, schema.iac) : undefined;\n\n  if (iac === 'cdk') {\n    targets['load-runtime-config'] = {\n      executor: 'nx:run-commands',\n      metadata: {\n        description: `Load runtime config from your deployed stack for dev purposes. You must set your AWS CLI credentials whilst calling '${getPackageManagerDisplayCommands().exec} nx load-runtime-config ${fullyQualifiedName}'`,\n      },\n      options: {\n        command: `aws s3 cp s3://\\`aws cloudformation describe-stacks --query \"Stacks[?starts_with(StackName, '${kebabCase(npmScopePrefix)}-')][].Outputs[] | [?contains(OutputKey, '${websiteNameClassName}WebsiteBucketName')].OutputValue\" --output text\\`/runtime-config.json \"{projectRoot}/public/runtime-config.json\"`,\n      },\n    };\n  } else if (iac === 'terraform') {\n    targets['load-runtime-config'] = {\n      executor: 'nx:run-commands',\n      metadata: {\n        description:\n          \"Load runtime config from most recently applied terraform env for dev purposes. Copies the runtime config from the Terraform dist directory to the website's public directory.\",\n      },\n      options: {\n        command:\n          'node -e \"const fs=require(\\'fs\\');fs.mkdirSync(process.env.DEST_DIR,{recursive:true});fs.copyFileSync(process.env.SRC_FILE,process.env.DEST_FILE);\"',\n        env: {\n          SRC_FILE: TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE,\n          DEST_DIR: `{projectRoot}/public`,\n          DEST_FILE: `{projectRoot}/public/runtime-config.json`,\n        },\n      },\n    };\n  }\n\n  if (!projectAlreadyExists) {\n    targets['compile'] = {\n      // `tsc` needs its dependencies' declarations, which `compile` emits — not\n      // their lint or test results.\n      dependsOn: ['^compile'],\n      executor: 'nx:run-commands',\n      outputs: ['{workspaceRoot}/dist/{projectRoot}/tsc'],\n      options: {\n        command: 'tsc --build tsconfig.app.json',\n        cwd: '{projectRoot}',\n      },\n    };\n    // bundle is the @nx/vite/plugin inferred `vite build` (writing to the\n    // bundle dir configured in vite.config) — it produces the deployable\n    // artifact. build aggregates lint/compile/test/bundle.\n    targets['build'] = {\n      dependsOn: ['lint', 'compile', 'test', 'bundle'],\n    };\n    targets['assemble'] = {\n      dependsOn: ['compile', 'bundle'],\n    };\n\n    // Run the website and its connected dependencies locally. Mirrors the\n    // inferred `serve` target but with the local-dev vite mode.\n    targets['dev'] = {\n      executor: 'nx:run-commands',\n      continuous: true,\n      options: {\n        command: 'vite --mode local-dev',\n        cwd: '{projectRoot}',\n      },\n    };\n  }\n\n  projectConfiguration.targets = sortObjectKeys(targets);\n\n  updateProjectConfiguration(tree, fullyQualifiedName, projectConfiguration);\n\n  // Recorded here and read by the declaration's predicates, so the packages\n  // added below are exactly the ones the version sync will own.\n  const metadata: TsReactWebsiteMetadata = {\n    ux,\n    framework: 'react',\n    infra,\n    tailwind,\n    tanstackRouter,\n    // Undefined when no infrastructure was generated, so neither provider's\n    // packages were added.\n    ...(iac ? { iac } : {}),\n  };\n  addGeneratorMetadata(\n    tree,\n    projectConfiguration.name,\n    REACT_WEBSITE_APP_GENERATOR_INFO,\n    metadata,\n  );\n\n  await configureTsProject(\n    tree,\n    {\n      dir: websiteContentPath,\n      fullyQualifiedName,\n    },\n    DEPENDENCIES,\n  );\n\n  if (ux === 'shadcn') {\n    await sharedShadcnGenerator(tree, DEPENDENCIES);\n    addSharedShadcnDependency(tree, websiteContentPath);\n  }\n\n  if (iac) {\n    await sharedConstructsGenerator(\n      tree,\n      {\n        iac,\n      },\n      DEPENDENCIES,\n    );\n\n    await addWebsiteInfra(tree, {\n      iac,\n      websiteProjectName: fullyQualifiedName,\n      scopeAlias,\n      websiteContentPath: joinPathFragments('dist', websiteContentPath),\n      websiteNameKebabCase,\n      websiteNameClassName,\n    });\n  }\n\n  const projectConfig = readProjectConfiguration(tree, fullyQualifiedName);\n  const libraryRoot = projectConfig.root;\n  const sharedShadcnStylesImport = relative(\n    joinPathFragments(libraryRoot, 'src'),\n    joinPathFragments(\n      PACKAGES_DIR,\n      SHARED_SHADCN_DIR,\n      'src',\n      'styles',\n      'globals.css',\n    ),\n  )\n    .split(sep)\n    .join('/');\n  const sharedShadcnTsconfigRef = relative(\n    joinPathFragments(tree.root, websiteContentPath),\n    joinPathFragments(\n      tree.root,\n      PACKAGES_DIR,\n      SHARED_SHADCN_DIR,\n      'tsconfig.json',\n    ),\n  )\n    .split(sep)\n    .join('/');\n  const templateOptions = {\n    ...schema,\n    fullyQualifiedName,\n    pkgMgrCmd: getPackageManagerDisplayCommands().exec,\n    tailwind,\n    tanstackRouter,\n    scopeAlias,\n    sharedShadcnStylesImport,\n  };\n  tree.delete(joinPathFragments(libraryRoot, 'src', 'app'));\n  const appCommonTemplatePath = joinPathFragments(\n    import.meta.dirname,\n    './files/app/common',\n  );\n  const appTemplatePath = joinPathFragments(\n    import.meta.dirname,\n    `./files/app/${ux.toLowerCase()}`,\n  );\n\n  generateFiles(\n    tree, // the virtual file system\n    appCommonTemplatePath, // path to the file templates\n    libraryRoot, // destination path of the files\n    templateOptions, // config object to replace variable in file templates\n    {\n      // User-editable source - preserve any edits on re-run\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  generateFiles(\n    tree, // the virtual file system\n    appTemplatePath, // path to the file templates\n    libraryRoot, // destination path of the files\n    templateOptions, // config object to replace variable in file templates\n    {\n      // User-editable source - preserve any edits on re-run\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  if (tanstackRouter) {\n    const routerCommonTemplatePath = joinPathFragments(\n      import.meta.dirname,\n      './files/tanstack-router/common',\n    );\n    const routerTemplatePath = joinPathFragments(\n      import.meta.dirname,\n      `./files/tanstack-router/${ux.toLowerCase()}`,\n    );\n\n    generateFiles(\n      tree,\n      routerCommonTemplatePath,\n      libraryRoot,\n      templateOptions,\n      {\n        // User-editable source (and the TanStack-managed route tree) - preserve on re-run\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n\n    generateFiles(\n      tree,\n      routerTemplatePath,\n      libraryRoot,\n      templateOptions, // config object to replace variable in file templates\n      {\n        // User-editable source - preserve any edits on re-run\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n    tree.delete(joinPathFragments(websiteContentPath, 'src', 'app.tsx'));\n  }\n\n  if (e2eTestRunner !== 'none') {\n    const e2eFullyQualifiedName = `${fullyQualifiedName}-e2e`;\n    const e2eRoot = readProjectConfiguration(tree, e2eFullyQualifiedName).root;\n    generateFiles(\n      tree, // the virtual file system\n      joinPathFragments(import.meta.dirname, `./files/e2e/${e2eTestRunner}`), // path to the file templates\n      e2eRoot, // destination path of the files\n      { ...schema, ...names(fullyQualifiedName) },\n      {\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n    await configureTsProject(\n      tree,\n      {\n        fullyQualifiedName: e2eFullyQualifiedName,\n        dir: e2eRoot,\n      },\n      DEPENDENCIES,\n    );\n  }\n  const viteConfigPath = joinPathFragments(libraryRoot, 'vite.config.mts');\n\n  if (tree.exists(viteConfigPath)) {\n    // Add Tanstack Router import if enabled\n    if (tanstackRouter) {\n      await addDestructuredImport(\n        tree,\n        viteConfigPath,\n        ['tanstackRouter'],\n        '@tanstack/router-plugin/vite',\n      );\n\n      await addDestructuredImport(tree, viteConfigPath, ['resolve'], 'path');\n    }\n\n    // Add TailwindCSS import if enabled\n    if (tailwind) {\n      await addSingleImport(\n        tree,\n        viteConfigPath,\n        'tailwindcss',\n        '@tailwindcss/vite',\n      );\n    }\n\n    // Update build.outDir. The inferred `vite build` target writes here, so\n    // point it at the bundle dir the website infrastructure consumes.\n    const outDir = joinPathFragments(\n      getRelativePathToRoot(tree, fullyQualifiedName),\n      'dist',\n      websiteContentPath,\n      'bundle',\n    );\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`build: { $bprops }\\` where { $bprops <: contains \\`outDir: $_\\` => \\`outDir: '${outDir}'\\` }`,\n    );\n\n    // Replace @nx/react's default dev-server port (4200) with the one assigned above.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`server: { $sprops }\\` where { $sprops <: contains \\`port: $_\\` => \\`port: ${port}\\` }`,\n    );\n\n    // Likewise for the preview port (@nx/react's default is 4300), so `vite preview`\n    // doesn't collide across websites either.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`preview: { $pprops }\\` where { $pprops <: contains \\`port: $_\\` => \\`port: ${previewPort}\\` }`,\n    );\n\n    // Add plugins to the plugins array\n    if (tanstackRouter) {\n      // Prepend tanstackRouter (must be first plugin) — rewrite works for both single/multi-element\n      await applyGritQL(\n        tree,\n        viteConfigPath,\n        \"`plugins: [$items]` => `plugins: [tanstackRouter({ routesDirectory: resolve(import.meta.dirname, 'src/routes'), generatedRouteTree: resolve(import.meta.dirname, 'src/routeTree.gen.ts') }), $items]` where { $items <: within `defineConfig($_)`, $items <: not contains `tanstackRouter` }\",\n      );\n    }\n\n    if (tailwind) {\n      await appendToArrayViaGritQL(\n        tree,\n        viteConfigPath,\n        'plugins:',\n        'tailwindcss()',\n        { scope: 'defineConfig($_)' },\n      );\n    }\n\n    // Use Vite's native tsconfig paths resolution (replaces vite-tsconfig-paths).\n    // `dedupe` forces a single copy of react/react-dom into the bundle: each\n    // project declares its own react dependency, so without this a workspace\n    // library's hoisted copy can produce a second React instance and the\n    // \"Invalid hook call\" runtime crash.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      \"or { `defineConfig(() => ({ $props }))` where { $props <: not some `resolve: $_`, $props += `resolve: { tsconfigPaths: true, dedupe: ['react', 'react-dom'] }` }, `defineConfig({ $props })` where { $props <: not some `resolve: $_`, $props += `resolve: { tsconfigPaths: true, dedupe: ['react', 'react-dom'] }` } }\",\n    );\n\n    // Add define: { global: {} } to the config (handles both callback and direct forms)\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      'or { `defineConfig(() => ({ $props }))` where { $props <: not contains `define`, $props += `define: { global: {} }` }, `defineConfig({ $props })` where { $props <: not contains `define`, $props += `define: { global: {} }` } }',\n    );\n  }\n\n  updateJson(\n    tree,\n    joinPathFragments(websiteContentPath, 'tsconfig.json'),\n    (tsconfig) => ({\n      ...tsconfig,\n      compilerOptions: {\n        ...tsconfig.compilerOptions,\n        moduleResolution: 'Bundler',\n        module: 'Preserve',\n      },\n    }),\n  );\n  const outDirToRootRelativePath = relative(\n    joinPathFragments(tree.root, websiteContentPath),\n    tree.root,\n  );\n  const distDir = joinPathFragments(\n    outDirToRootRelativePath,\n    'dist',\n    websiteContentPath,\n    'tsc',\n  );\n  updateJson(\n    tree,\n    joinPathFragments(websiteContentPath, 'tsconfig.app.json'),\n    (tsconfig) => ({\n      ...tsconfig,\n      compilerOptions: {\n        ...tsconfig.compilerOptions,\n        outDir: distDir,\n        tsBuildInfoFile: joinPathFragments(distDir, 'tsconfig.lib.tsbuildinfo'),\n        lib: ['DOM'],\n      },\n      references:\n        ux === 'shadcn'\n          ? [\n              ...(tsconfig.references ?? []).filter(\n                (ref) => ref.path !== sharedShadcnTsconfigRef,\n              ),\n              {\n                path: sharedShadcnTsconfigRef,\n              },\n            ]\n          : tsconfig.references,\n    }),\n  );\n\n  addTsDependencies(tree, DEPENDENCIES, { metadata, projectRoot: libraryRoot });\n\n  // @nx/react declares an optional `express` peer on the major behind the one\n  // vended here, for a module-federation dev-server this never runs. npm alone\n  // fails the whole install on an optional peer it cannot satisfy, so it gets a\n  // scoped override; the other package managers only warn.\n  if (detectPackageManager() === 'npm') {\n    updateJson(tree, 'package.json', (packageJson) => {\n      packageJson.overrides = {\n        ...packageJson.overrides,\n        '@nx/react': {\n          ...packageJson.overrides?.['@nx/react'],\n          ...withVersions(DEPENDENCIES, ['express']),\n        },\n      };\n      return packageJson;\n    });\n  }\n\n  // @nx/react's applicationGenerator seeds react/react-dom into the root\n  // manifest. The website now declares its own pinned versions, so drop the\n  // root copies: without catalogs (npm) the root's floating range resolves to\n  // a different version than the website's pin, installing a second React and\n  // producing the \"Invalid hook call\" runtime crash.\n  removeDependenciesFromPackageJson(tree, ['react', 'react-dom'], []);\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    REACT_WEBSITE_APP_GENERATOR_INFO,\n  ]);\n\n  // TanStack Router's vite plugin owns this website's route tree and rewrites it\n  // in its own (unformatted) shape whenever the config is loaded — including when\n  // Nx computes the project graph — so formatting it here would only make\n  // generation non-idempotent. The vended biome config excludes `**/*.gen.*`, so\n  // the workspace's own `format` target leaves it alone too.\n  await formatFilesInSubtree(tree, undefined, {\n    ignore: tanstackRouter\n      ? [joinPathFragments(libraryRoot, 'src', 'routeTree.gen.ts')]\n      : [],\n  });\n  // The generated vite.config.mts imports these, and Nx's inferred `@nx/vite`\n  // plugin loads that config when computing the project graph — so they must be\n  // installed even if the caller would otherwise prefer to defer.\n  return () =>\n    installDependencies(tree, schema.preferInstallDependencies, {\n      languages: ['typescript'],\n      ensureResolvable: [\n        ...(tailwind ? (['@tailwindcss/vite'] as const) : []),\n        ...(tanstackRouter ? (['@tanstack/router-plugin'] as const) : []),\n      ],\n    });\n}\nexport default tsReactWebsiteGenerator;\n"],"names":["detectPackageManager","generateFiles","joinPathFragments","names","OverwriteStrategy","readProjectConfiguration","removeDependenciesFromPackageJson","updateJson","updateProjectConfiguration","applicationGenerator","relative","sep","addTsDependencies","addDestructuredImport","addSingleImport","appendToArrayViaGritQL","applyGritQL","declareDependencies","ownedElsewhere","formatFilesInSubtree","resolveIac","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","toKebabCase","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","sortObjectKeys","getRelativePathToRoot","getPackageManagerDisplayCommands","assignPort","SHARED_CONSTRUCTS_DEPENDENCIES","sharedConstructsGenerator","PACKAGES_DIR","SHARED_SHADCN_DIR","TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE","addSharedShadcnDependency","SHADCN_DEPENDENCIES","sharedShadcnGenerator","withVersions","addWebsiteInfra","WEBSITE_CONSTRUCTS_PY_DEPENDENCIES","configureTsProject","VITEST_DEPENDENCIES","DEPENDENCIES","ts","name","dev","root","when","m","ux","tanstackRouter","tailwind","versionOnly","py","SUPPORTED_UX_PROVIDERS","REACT_WEBSITE_APP_GENERATOR_INFO","filename","tsReactWebsiteGenerator","tree","schema","Error","npmScopePrefix","scopeAlias","websiteNameClassName","websiteNameKebabCase","fullyQualifiedName","websiteContentPath","directory","subDirectory","projectAlreadyExists","exists","e2eTestRunner","routing","linter","bundler","unitTestRunner","useProjectJson","style","addPlugin","nxJson","plugin","plugins","options","buildTargetName","serveTargetName","devTargetName","previewTargetName","serveStaticTargetName","typecheckTargetName","testTargetName","delete","projectConfiguration","targets","port","previewPort","infra","iac","undefined","executor","metadata","description","exec","command","env","SRC_FILE","DEST_DIR","DEST_FILE","dependsOn","outputs","cwd","continuous","framework","dir","websiteProjectName","projectConfig","libraryRoot","sharedShadcnStylesImport","split","join","sharedShadcnTsconfigRef","templateOptions","pkgMgrCmd","appCommonTemplatePath","dirname","appTemplatePath","toLowerCase","overwriteStrategy","KeepExisting","routerCommonTemplatePath","routerTemplatePath","e2eFullyQualifiedName","e2eRoot","viteConfigPath","outDir","scope","tsconfig","compilerOptions","moduleResolution","module","outDirToRootRelativePath","distDir","tsBuildInfoFile","lib","references","filter","ref","path","projectRoot","packageJson","overrides","ignore","preferInstallDependencies","languages","ensureResolvable"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/app/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  detectPackageManager,\n  generateFiles,\n  joinPathFragments,\n  names,\n  OverwriteStrategy,\n  readProjectConfiguration,\n  removeDependenciesFromPackageJson,\n  type Tree,\n  updateJson,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { applicationGenerator } from '@nx/react';\nimport { relative, sep } from 'path';\nimport { addTsDependencies } from '../../../utils/add-dependencies.js';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  appendToArrayViaGritQL,\n  applyGritQL,\n} from '../../../utils/ast.js';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies.js';\nimport { formatFilesInSubtree } from '../../../utils/format.js';\nimport { resolveIac } from '../../../utils/iac.js';\nimport { installDependencies } from '../../../utils/install.js';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics.js';\nimport { kebabCase, toClassName, toKebabCase } from '../../../utils/names.js';\nimport { getNpmScopePrefix } from '../../../utils/npm-scope.js';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n} from '../../../utils/nx.js';\nimport { sortObjectKeys } from '../../../utils/object.js';\nimport { getRelativePathToRoot } from '../../../utils/paths.js';\nimport { getPackageManagerDisplayCommands } from '../../../utils/pkg-manager.js';\nimport { assignPort } from '../../../utils/port.js';\nimport {\n  SHARED_CONSTRUCTS_DEPENDENCIES,\n  sharedConstructsGenerator,\n} from '../../../utils/shared-constructs.js';\nimport {\n  type IacMetadata,\n  PACKAGES_DIR,\n  SHARED_SHADCN_DIR,\n  TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE,\n} from '../../../utils/shared-constructs-constants.js';\nimport {\n  addSharedShadcnDependency,\n  SHADCN_DEPENDENCIES,\n  sharedShadcnGenerator,\n} from '../../../utils/shared-shadcn.js';\nimport { withVersions } from '../../../utils/versions.js';\nimport {\n  addWebsiteInfra,\n  WEBSITE_CONSTRUCTS_PY_DEPENDENCIES,\n} from '../../../utils/website-constructs/website-constructs.js';\nimport {\n  configureTsProject,\n  mergeTsProjectDirReference,\n  TS_PROJECT_DEPENDENCIES,\n} from '../../lib/ts-project-utils.js';\nimport { VITEST_DEPENDENCIES } from '../../lib/vitest.js';\n// typescript factory imports removed — now using GritQL for vite config transforms\nimport type {\n  TsReactWebsiteGeneratorSchema,\n  WebsiteInfraOption,\n} from './schema';\n\n/** The metadata this generator records, which its predicates read. */\nexport interface TsReactWebsiteMetadata extends IacMetadata {\n  readonly ux: UxOption;\n  readonly framework: string;\n  readonly infra: WebsiteInfraOption;\n  readonly tailwind: boolean;\n  readonly tanstackRouter: boolean;\n}\n\n// Each entry names the branch it belongs to, so the same declaration drives both\n// adding and the version sync.\nexport const DEPENDENCIES = declareDependencies<TsReactWebsiteMetadata>()({\n  ts: [\n    { name: 'react' },\n    { name: 'react-dom' },\n    // Build/test tooling imported only from vite.config.mts stays at the root.\n    { name: '@nx/react', dev: true, root: true },\n    { name: '@vitest/ui', dev: true, root: true },\n    {\n      name: '@cloudscape-design/components',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    {\n      name: '@cloudscape-design/board-components',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    {\n      name: '@cloudscape-design/global-styles',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    // Shared shadcn components live in the common/shadcn package, but the\n    // website's own generated components (e.g. the tanstack-router sidebar)\n    // import lucide-react directly, so the website must declare it.\n    {\n      name: 'lucide-react',\n      when: (m) => m.ux === 'shadcn' && m.tanstackRouter,\n    },\n    { name: 'tailwindcss', when: (m) => m.tailwind },\n    {\n      name: '@tailwindcss/vite',\n      when: (m) => m.tailwind,\n      dev: true,\n      root: true,\n    },\n    { name: '@tanstack/react-router', when: (m) => m.tanstackRouter },\n    {\n      name: '@tanstack/router-plugin',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/router-generator',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/virtual-file-routes',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/router-utils',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    // Declared for its pinned version, which goes into npm's `overrides` below.\n    { name: 'express', versionOnly: true },\n    ...ownedElsewhere(TS_PROJECT_DEPENDENCIES),\n    ...ownedElsewhere(SHADCN_DEPENDENCIES),\n    ...ownedElsewhere(VITEST_DEPENDENCIES),\n    ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES),\n  ],\n  py: ownedElsewhere(WEBSITE_CONSTRUCTS_PY_DEPENDENCIES),\n});\n\nexport const SUPPORTED_UX_PROVIDERS = ['none', 'cloudscape', 'shadcn'] as const;\n\nexport type UxOption = (typeof SUPPORTED_UX_PROVIDERS)[number];\n\nexport type Ux = UxOption;\n\nexport const REACT_WEBSITE_APP_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport async function tsReactWebsiteGenerator(\n  tree: Tree,\n  schema: TsReactWebsiteGeneratorSchema,\n) {\n  const tailwind = schema.tailwind ?? true;\n  const tanstackRouter = schema.tanstackRouter ?? true;\n  const ux: Ux = schema.ux ?? 'shadcn';\n  if (ux === 'shadcn' && !tailwind) {\n    throw new Error('Shadcn requires TailwindCSS to be enabled.');\n  }\n  const npmScopePrefix = getNpmScopePrefix(tree);\n  const scopeAlias = npmScopePrefix;\n  const websiteNameClassName = toClassName(schema.name);\n  const websiteNameKebabCase = toKebabCase(schema.name);\n  const fullyQualifiedName = `${npmScopePrefix}${websiteNameKebabCase}`;\n  // NB: interactive nx generator cli can pass empty string\n  const websiteContentPath = joinPathFragments(\n    schema.directory || '.',\n    schema.subDirectory || websiteNameKebabCase,\n  );\n\n  const projectAlreadyExists = tree.exists(\n    joinPathFragments(websiteContentPath, 'project.json'),\n  );\n\n  // TODO: consider exposing and supporting e2e tests\n  const e2eTestRunner = 'none';\n\n  if (!projectAlreadyExists) {\n    await applicationGenerator(tree, {\n      ...schema,\n      name: fullyQualifiedName,\n      directory: websiteContentPath,\n      routing: false,\n      e2eTestRunner,\n      linter: 'none',\n      bundler: 'vite',\n      unitTestRunner: 'vitest',\n      useProjectJson: true,\n      style: 'css',\n      // Register the @nx/vite and @nx/vitest plugins so build/serve/test\n      // targets are inferred rather than emitting deprecated executor targets.\n      addPlugin: true,\n    });\n\n    // Pin the inferred target names. The vite production build is exposed as\n    // `bundle` (which produces the deployable artifact), leaving `build` as an\n    // aggregator over lint/compile/test/bundle. vite's own typecheck is dropped\n    // in favour of the tsc `compile`.\n    updateJson(tree, 'nx.json', (nxJson) => {\n      for (const plugin of nxJson.plugins ?? []) {\n        if (typeof plugin === 'string') continue;\n        if (plugin.plugin === '@nx/vite/plugin') {\n          plugin.options = {\n            ...plugin.options,\n            buildTargetName: 'bundle',\n            // Map both of vite's inferred dev-server targets onto `serve` so the\n            // plugin doesn't emit a separate `dev`; we author our own `dev`\n            // below running the local-dev vite mode.\n            serveTargetName: 'serve',\n            devTargetName: 'serve',\n            previewTargetName: 'preview',\n            serveStaticTargetName: 'serve-static',\n            typecheckTargetName: 'vite:typecheck',\n          };\n        } else if (plugin.plugin === '@nx/vitest') {\n          plugin.options = {\n            ...plugin.options,\n            testTargetName: 'test',\n          };\n        }\n      }\n      return nxJson;\n    });\n\n    // Replace with simpler sample source code\n    tree.delete(joinPathFragments(websiteContentPath, 'src'));\n  }\n\n  const projectConfiguration = readProjectConfiguration(\n    tree,\n    fullyQualifiedName,\n  );\n\n  const targets = projectConfiguration.targets;\n\n  // Each website gets its own explicit dev-server port. Vite itself already\n  // auto-increments past a port already in use, so two websites don't actually\n  // collide — but which port each one lands on then depends on start order and\n  // can't be known ahead of time. An explicit, per-project port is what lets\n  // the Cognito callback URL allow-list (added when auth is configured) be\n  // computed deterministically instead.\n  const port = assignPort(tree, projectConfiguration, 4200);\n  // @nx/react's vite config defaults to 4200 for the dev server and 4300 for\n  // preview; keep that +100 relationship so the pair stays predictable.\n  const previewPort = port + 100;\n\n  const infra = schema.infra ?? 'cloudfront-s3';\n\n  // Configure load-runtime-config target based on IaC provider (only when infra is not none)\n  const iac = infra !== 'none' ? await resolveIac(tree, schema.iac) : undefined;\n\n  if (iac === 'cdk') {\n    targets['load-runtime-config'] = {\n      executor: 'nx:run-commands',\n      metadata: {\n        description: `Load runtime config from your deployed stack for dev purposes. You must set your AWS CLI credentials whilst calling '${getPackageManagerDisplayCommands().exec} nx load-runtime-config ${fullyQualifiedName}'`,\n      },\n      options: {\n        command: `aws s3 cp s3://\\`aws cloudformation describe-stacks --query \"Stacks[?starts_with(StackName, '${kebabCase(npmScopePrefix)}-')][].Outputs[] | [?contains(OutputKey, '${websiteNameClassName}WebsiteBucketName')].OutputValue\" --output text\\`/runtime-config.json \"{projectRoot}/public/runtime-config.json\"`,\n      },\n    };\n  } else if (iac === 'terraform') {\n    targets['load-runtime-config'] = {\n      executor: 'nx:run-commands',\n      metadata: {\n        description:\n          \"Load runtime config from most recently applied terraform env for dev purposes. Copies the runtime config from the Terraform dist directory to the website's public directory.\",\n      },\n      options: {\n        command:\n          'node -e \"const fs=require(\\'fs\\');fs.mkdirSync(process.env.DEST_DIR,{recursive:true});fs.copyFileSync(process.env.SRC_FILE,process.env.DEST_FILE);\"',\n        env: {\n          SRC_FILE: TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE,\n          DEST_DIR: `{projectRoot}/public`,\n          DEST_FILE: `{projectRoot}/public/runtime-config.json`,\n        },\n      },\n    };\n  }\n\n  if (!projectAlreadyExists) {\n    targets['compile'] = {\n      // `tsc` needs its dependencies' declarations, which `compile` emits — not\n      // their lint or test results.\n      dependsOn: ['^compile'],\n      executor: 'nx:run-commands',\n      outputs: ['{workspaceRoot}/dist/{projectRoot}/tsc'],\n      options: {\n        command: 'tsc --build tsconfig.app.json',\n        cwd: '{projectRoot}',\n      },\n    };\n    // bundle is the @nx/vite/plugin inferred `vite build` (writing to the\n    // bundle dir configured in vite.config) — it produces the deployable\n    // artifact. build aggregates lint/compile/test/bundle.\n    targets['build'] = {\n      dependsOn: ['lint', 'compile', 'test', 'bundle'],\n    };\n    targets['assemble'] = {\n      dependsOn: ['compile', 'bundle'],\n    };\n\n    // Run the website and its connected dependencies locally. Mirrors the\n    // inferred `serve` target but with the local-dev vite mode.\n    targets['dev'] = {\n      executor: 'nx:run-commands',\n      continuous: true,\n      options: {\n        command: 'vite --mode local-dev',\n        cwd: '{projectRoot}',\n      },\n    };\n  }\n\n  projectConfiguration.targets = sortObjectKeys(targets);\n\n  updateProjectConfiguration(tree, fullyQualifiedName, projectConfiguration);\n\n  // Recorded here and read by the declaration's predicates, so the packages\n  // added below are exactly the ones the version sync will own.\n  const metadata: TsReactWebsiteMetadata = {\n    ux,\n    framework: 'react',\n    infra,\n    tailwind,\n    tanstackRouter,\n    // Undefined when no infrastructure was generated, so neither provider's\n    // packages were added.\n    ...(iac ? { iac } : {}),\n  };\n  addGeneratorMetadata(\n    tree,\n    projectConfiguration.name,\n    REACT_WEBSITE_APP_GENERATOR_INFO,\n    metadata,\n  );\n\n  await configureTsProject(\n    tree,\n    {\n      dir: websiteContentPath,\n      fullyQualifiedName,\n    },\n    DEPENDENCIES,\n  );\n\n  if (ux === 'shadcn') {\n    await sharedShadcnGenerator(tree, DEPENDENCIES);\n    addSharedShadcnDependency(tree, websiteContentPath);\n  }\n\n  if (iac) {\n    await sharedConstructsGenerator(\n      tree,\n      {\n        iac,\n      },\n      DEPENDENCIES,\n    );\n\n    await addWebsiteInfra(tree, {\n      iac,\n      websiteProjectName: fullyQualifiedName,\n      scopeAlias,\n      websiteContentPath: joinPathFragments('dist', websiteContentPath),\n      websiteNameKebabCase,\n      websiteNameClassName,\n    });\n  }\n\n  const projectConfig = readProjectConfiguration(tree, fullyQualifiedName);\n  const libraryRoot = projectConfig.root;\n  const sharedShadcnStylesImport = relative(\n    joinPathFragments(libraryRoot, 'src'),\n    joinPathFragments(\n      PACKAGES_DIR,\n      SHARED_SHADCN_DIR,\n      'src',\n      'styles',\n      'globals.css',\n    ),\n  )\n    .split(sep)\n    .join('/');\n  const sharedShadcnProjectRef = relative(\n    joinPathFragments(tree.root, websiteContentPath),\n    joinPathFragments(tree.root, PACKAGES_DIR, SHARED_SHADCN_DIR),\n  )\n    .split(sep)\n    .join('/');\n  const templateOptions = {\n    ...schema,\n    fullyQualifiedName,\n    pkgMgrCmd: getPackageManagerDisplayCommands().exec,\n    tailwind,\n    tanstackRouter,\n    scopeAlias,\n    sharedShadcnStylesImport,\n  };\n  tree.delete(joinPathFragments(libraryRoot, 'src', 'app'));\n  const appCommonTemplatePath = joinPathFragments(\n    import.meta.dirname,\n    './files/app/common',\n  );\n  const appTemplatePath = joinPathFragments(\n    import.meta.dirname,\n    `./files/app/${ux.toLowerCase()}`,\n  );\n\n  generateFiles(\n    tree, // the virtual file system\n    appCommonTemplatePath, // path to the file templates\n    libraryRoot, // destination path of the files\n    templateOptions, // config object to replace variable in file templates\n    {\n      // User-editable source - preserve any edits on re-run\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  generateFiles(\n    tree, // the virtual file system\n    appTemplatePath, // path to the file templates\n    libraryRoot, // destination path of the files\n    templateOptions, // config object to replace variable in file templates\n    {\n      // User-editable source - preserve any edits on re-run\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  if (tanstackRouter) {\n    const routerCommonTemplatePath = joinPathFragments(\n      import.meta.dirname,\n      './files/tanstack-router/common',\n    );\n    const routerTemplatePath = joinPathFragments(\n      import.meta.dirname,\n      `./files/tanstack-router/${ux.toLowerCase()}`,\n    );\n\n    generateFiles(\n      tree,\n      routerCommonTemplatePath,\n      libraryRoot,\n      templateOptions,\n      {\n        // User-editable source (and the TanStack-managed route tree) - preserve on re-run\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n\n    generateFiles(\n      tree,\n      routerTemplatePath,\n      libraryRoot,\n      templateOptions, // config object to replace variable in file templates\n      {\n        // User-editable source - preserve any edits on re-run\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n    tree.delete(joinPathFragments(websiteContentPath, 'src', 'app.tsx'));\n  }\n\n  if (e2eTestRunner !== 'none') {\n    const e2eFullyQualifiedName = `${fullyQualifiedName}-e2e`;\n    const e2eRoot = readProjectConfiguration(tree, e2eFullyQualifiedName).root;\n    generateFiles(\n      tree, // the virtual file system\n      joinPathFragments(import.meta.dirname, `./files/e2e/${e2eTestRunner}`), // path to the file templates\n      e2eRoot, // destination path of the files\n      { ...schema, ...names(fullyQualifiedName) },\n      {\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n    await configureTsProject(\n      tree,\n      {\n        fullyQualifiedName: e2eFullyQualifiedName,\n        dir: e2eRoot,\n      },\n      DEPENDENCIES,\n    );\n  }\n  const viteConfigPath = joinPathFragments(libraryRoot, 'vite.config.mts');\n\n  if (tree.exists(viteConfigPath)) {\n    // Add Tanstack Router import if enabled\n    if (tanstackRouter) {\n      await addDestructuredImport(\n        tree,\n        viteConfigPath,\n        ['tanstackRouter'],\n        '@tanstack/router-plugin/vite',\n      );\n\n      await addDestructuredImport(tree, viteConfigPath, ['resolve'], 'path');\n    }\n\n    // Add TailwindCSS import if enabled\n    if (tailwind) {\n      await addSingleImport(\n        tree,\n        viteConfigPath,\n        'tailwindcss',\n        '@tailwindcss/vite',\n      );\n    }\n\n    // Update build.outDir. The inferred `vite build` target writes here, so\n    // point it at the bundle dir the website infrastructure consumes.\n    const outDir = joinPathFragments(\n      getRelativePathToRoot(tree, fullyQualifiedName),\n      'dist',\n      websiteContentPath,\n      'bundle',\n    );\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`build: { $bprops }\\` where { $bprops <: contains \\`outDir: $_\\` => \\`outDir: '${outDir}'\\` }`,\n    );\n\n    // Replace @nx/react's default dev-server port (4200) with the one assigned above.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`server: { $sprops }\\` where { $sprops <: contains \\`port: $_\\` => \\`port: ${port}\\` }`,\n    );\n\n    // Likewise for the preview port (@nx/react's default is 4300), so `vite preview`\n    // doesn't collide across websites either.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`preview: { $pprops }\\` where { $pprops <: contains \\`port: $_\\` => \\`port: ${previewPort}\\` }`,\n    );\n\n    // Add plugins to the plugins array\n    if (tanstackRouter) {\n      // Prepend tanstackRouter (must be first plugin) — rewrite works for both single/multi-element\n      await applyGritQL(\n        tree,\n        viteConfigPath,\n        \"`plugins: [$items]` => `plugins: [tanstackRouter({ routesDirectory: resolve(import.meta.dirname, 'src/routes'), generatedRouteTree: resolve(import.meta.dirname, 'src/routeTree.gen.ts') }), $items]` where { $items <: within `defineConfig($_)`, $items <: not contains `tanstackRouter` }\",\n      );\n    }\n\n    if (tailwind) {\n      await appendToArrayViaGritQL(\n        tree,\n        viteConfigPath,\n        'plugins:',\n        'tailwindcss()',\n        { scope: 'defineConfig($_)' },\n      );\n    }\n\n    // Use Vite's native tsconfig paths resolution (replaces vite-tsconfig-paths).\n    // `dedupe` forces a single copy of react/react-dom into the bundle: each\n    // project declares its own react dependency, so without this a workspace\n    // library's hoisted copy can produce a second React instance and the\n    // \"Invalid hook call\" runtime crash.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      \"or { `defineConfig(() => ({ $props }))` where { $props <: not some `resolve: $_`, $props += `resolve: { tsconfigPaths: true, dedupe: ['react', 'react-dom'] }` }, `defineConfig({ $props })` where { $props <: not some `resolve: $_`, $props += `resolve: { tsconfigPaths: true, dedupe: ['react', 'react-dom'] }` } }\",\n    );\n\n    // Add define: { global: {} } to the config (handles both callback and direct forms)\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      'or { `defineConfig(() => ({ $props }))` where { $props <: not contains `define`, $props += `define: { global: {} }` }, `defineConfig({ $props })` where { $props <: not contains `define`, $props += `define: { global: {} }` } }',\n    );\n  }\n\n  updateJson(\n    tree,\n    joinPathFragments(websiteContentPath, 'tsconfig.json'),\n    (tsconfig) => ({\n      ...tsconfig,\n      compilerOptions: {\n        ...tsconfig.compilerOptions,\n        moduleResolution: 'Bundler',\n        module: 'Preserve',\n      },\n    }),\n  );\n  const outDirToRootRelativePath = relative(\n    joinPathFragments(tree.root, websiteContentPath),\n    tree.root,\n  );\n  const distDir = joinPathFragments(\n    outDirToRootRelativePath,\n    'dist',\n    websiteContentPath,\n    'tsc',\n  );\n  updateJson(\n    tree,\n    joinPathFragments(websiteContentPath, 'tsconfig.app.json'),\n    (tsconfig) => ({\n      ...tsconfig,\n      compilerOptions: {\n        ...tsconfig.compilerOptions,\n        outDir: distDir,\n        tsBuildInfoFile: joinPathFragments(distDir, 'tsconfig.lib.tsbuildinfo'),\n        lib: ['DOM'],\n      },\n      references:\n        ux === 'shadcn'\n          ? mergeTsProjectDirReference(\n              tsconfig.references,\n              sharedShadcnProjectRef,\n            )\n          : tsconfig.references,\n    }),\n  );\n\n  addTsDependencies(tree, DEPENDENCIES, { metadata, projectRoot: libraryRoot });\n\n  // @nx/react declares an optional `express` peer on the major behind the one\n  // vended here, for a module-federation dev-server this never runs. npm alone\n  // fails the whole install on an optional peer it cannot satisfy, so it gets a\n  // scoped override; the other package managers only warn.\n  if (detectPackageManager() === 'npm') {\n    updateJson(tree, 'package.json', (packageJson) => {\n      packageJson.overrides = {\n        ...packageJson.overrides,\n        '@nx/react': {\n          ...packageJson.overrides?.['@nx/react'],\n          ...withVersions(DEPENDENCIES, ['express']),\n        },\n      };\n      return packageJson;\n    });\n  }\n\n  // @nx/react's applicationGenerator seeds react/react-dom into the root\n  // manifest. The website now declares its own pinned versions, so drop the\n  // root copies: without catalogs (npm) the root's floating range resolves to\n  // a different version than the website's pin, installing a second React and\n  // producing the \"Invalid hook call\" runtime crash.\n  removeDependenciesFromPackageJson(tree, ['react', 'react-dom'], []);\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    REACT_WEBSITE_APP_GENERATOR_INFO,\n  ]);\n\n  // TanStack Router's vite plugin owns this website's route tree and rewrites it\n  // in its own (unformatted) shape whenever the config is loaded — including when\n  // Nx computes the project graph — so formatting it here would only make\n  // generation non-idempotent. The vended biome config excludes `**/*.gen.*`, so\n  // the workspace's own `format` target leaves it alone too.\n  await formatFilesInSubtree(tree, undefined, {\n    ignore: tanstackRouter\n      ? [joinPathFragments(libraryRoot, 'src', 'routeTree.gen.ts')]\n      : [],\n  });\n\n  // The generated vite.config.mts imports these, and Nx's inferred `@nx/vite`\n  // plugin loads that config when computing the project graph — so they must be\n  // installed even if the caller would otherwise prefer to defer.\n  return () =>\n    installDependencies(tree, schema.preferInstallDependencies, {\n      languages: ['typescript'],\n      ensureResolvable: [\n        ...(tailwind ? (['@tailwindcss/vite'] as const) : []),\n        ...(tanstackRouter ? (['@tanstack/router-plugin'] as const) : []),\n      ],\n    });\n}\nexport default tsReactWebsiteGenerator;\n"],"names":["detectPackageManager","generateFiles","joinPathFragments","names","OverwriteStrategy","readProjectConfiguration","removeDependenciesFromPackageJson","updateJson","updateProjectConfiguration","applicationGenerator","relative","sep","addTsDependencies","addDestructuredImport","addSingleImport","appendToArrayViaGritQL","applyGritQL","declareDependencies","ownedElsewhere","formatFilesInSubtree","resolveIac","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","toKebabCase","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","sortObjectKeys","getRelativePathToRoot","getPackageManagerDisplayCommands","assignPort","SHARED_CONSTRUCTS_DEPENDENCIES","sharedConstructsGenerator","PACKAGES_DIR","SHARED_SHADCN_DIR","TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE","addSharedShadcnDependency","SHADCN_DEPENDENCIES","sharedShadcnGenerator","withVersions","addWebsiteInfra","WEBSITE_CONSTRUCTS_PY_DEPENDENCIES","configureTsProject","mergeTsProjectDirReference","TS_PROJECT_DEPENDENCIES","VITEST_DEPENDENCIES","DEPENDENCIES","ts","name","dev","root","when","m","ux","tanstackRouter","tailwind","versionOnly","py","SUPPORTED_UX_PROVIDERS","REACT_WEBSITE_APP_GENERATOR_INFO","filename","tsReactWebsiteGenerator","tree","schema","Error","npmScopePrefix","scopeAlias","websiteNameClassName","websiteNameKebabCase","fullyQualifiedName","websiteContentPath","directory","subDirectory","projectAlreadyExists","exists","e2eTestRunner","routing","linter","bundler","unitTestRunner","useProjectJson","style","addPlugin","nxJson","plugin","plugins","options","buildTargetName","serveTargetName","devTargetName","previewTargetName","serveStaticTargetName","typecheckTargetName","testTargetName","delete","projectConfiguration","targets","port","previewPort","infra","iac","undefined","executor","metadata","description","exec","command","env","SRC_FILE","DEST_DIR","DEST_FILE","dependsOn","outputs","cwd","continuous","framework","dir","websiteProjectName","projectConfig","libraryRoot","sharedShadcnStylesImport","split","join","sharedShadcnProjectRef","templateOptions","pkgMgrCmd","appCommonTemplatePath","dirname","appTemplatePath","toLowerCase","overwriteStrategy","KeepExisting","routerCommonTemplatePath","routerTemplatePath","e2eFullyQualifiedName","e2eRoot","viteConfigPath","outDir","scope","tsconfig","compilerOptions","moduleResolution","module","outDirToRootRelativePath","distDir","tsBuildInfoFile","lib","references","projectRoot","packageJson","overrides","ignore","preferInstallDependencies","languages","ensureResolvable"],"mappings":"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"}

package/src/utils/agent-connection/agent-connection.d.ts

@@ -181,7 +181,8 @@ export interface PyMcpFamilyConnection extends PyClientNaming {
 export declare const PY_MCP_FAMILY_CONNECTIONS: Record<AgentFramework, PyMcpFamilyConnection>;
 /**
  * Add a re-export to the Python agent-connection module's __init__.py.
- * Equivalent to addStarExport for TS.
+ * Equivalent to addStarExport for TS, including creating the file when it does
+ * not yet exist in the tree.
  * Uses `__all__` to mark re-exports as public (satisfies ruff F401).
  * Uses GritQL for AST-aware transforms where possible.
  */

package/src/utils/agent-connection/agent-connection.js

@@ -569,7 +569,8 @@ export const PY_MCP_FAMILY_CONNECTIONS = {
 };
 /**
  * Add a re-export to the Python agent-connection module's __init__.py.
- * Equivalent to addStarExport for TS.
+ * Equivalent to addStarExport for TS, including creating the file when it does
+ * not yet exist in the tree.
  * Uses `__all__` to mark re-exports as public (satisfies ruff F401).
  * Uses GritQL for AST-aware transforms where possible.
  */ export async function addPythonReExport(tree, initFilePath, fromModule, importName) {
@@ -579,6 +580,10 @@ export const PY_MCP_FAMILY_CONNECTIONS = {
     }
     const importLine = `from ${fromModule} import ${importName}`;
     const allEntry = `"${importName}"`;
+    if (!tree.exists(initFilePath)) {
+        tree.write(initFilePath, `${importLine}\n\n__all__ = [${allEntry}]\n`);
+        return;
+    }
     // If there's already an import from the same module, merge into its name list
     // (ruff I001 rejects two `from X import ...` lines for the same module).
     const mergedImport = await applyGritQL(tree, initFilePath, py(`\`from ${fromModule} import $names\` where {