@codedrifters/configulator 0.0.240 → 0.0.242

package/lib/index.d.mts

@@ -3597,6 +3597,37 @@ declare class ProjectMetadata extends Component {
     private autoDetectRepository;
 }
 
+/**
+ * Resolve a sub-project's `outdir` from its package name.
+ *
+ * Given a scoped package name like `@codedrifters/foo`, returns
+ * `<root>/@codedrifters/foo` where `<root>` comes from
+ * {@link MONOREPO_LAYOUT}. The scope segment is preserved verbatim —
+ * including the leading `@` — so the resulting path mirrors the npm
+ * name exactly (e.g. `packages/@codedrifters/foo`).
+ *
+ * Throws when the package name is unscoped or empty. Callers must
+ * either supply a scoped name or pass `outdir` explicitly.
+ *
+ * @param packageName - The npm package name. Typically sourced from
+ *   `userOptions.packageName ?? userOptions.name` — both are valid
+ *   inputs because projen itself falls back from `packageName` to
+ *   `name` when rendering `package.json`.
+ * @param root - Which top-level monorepo folder to place the
+ *   sub-project under (e.g. `packages`, `apps`, `sites`).
+ */
+declare function resolveOutdirFromPackageName(packageName: string | undefined, root: MonorepoLayoutRoot): string;
+/**
+ * Convenience wrapper that resolves an `outdir` for a `TypeScriptProject`
+ * under the canonical `packages/` root.
+ */
+declare function resolveTypeScriptProjectOutdir(packageName: string | undefined): string;
+/**
+ * Convenience wrapper that resolves an `outdir` for an `AwsCdkProject`
+ * under the canonical `apps/` root.
+ */
+declare function resolveAwsCdkProjectOutdir(packageName: string | undefined): string;
+
 /**
  * A single Starlight social icon link.
  */
@@ -3738,4 +3769,4 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightSidebarItem, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightSidebarItem, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, vitestBundle };

package/lib/index.d.ts

@@ -3646,6 +3646,37 @@ declare class ProjectMetadata extends Component {
     private autoDetectRepository;
 }
 
+/**
+ * Resolve a sub-project's `outdir` from its package name.
+ *
+ * Given a scoped package name like `@codedrifters/foo`, returns
+ * `<root>/@codedrifters/foo` where `<root>` comes from
+ * {@link MONOREPO_LAYOUT}. The scope segment is preserved verbatim —
+ * including the leading `@` — so the resulting path mirrors the npm
+ * name exactly (e.g. `packages/@codedrifters/foo`).
+ *
+ * Throws when the package name is unscoped or empty. Callers must
+ * either supply a scoped name or pass `outdir` explicitly.
+ *
+ * @param packageName - The npm package name. Typically sourced from
+ *   `userOptions.packageName ?? userOptions.name` — both are valid
+ *   inputs because projen itself falls back from `packageName` to
+ *   `name` when rendering `package.json`.
+ * @param root - Which top-level monorepo folder to place the
+ *   sub-project under (e.g. `packages`, `apps`, `sites`).
+ */
+declare function resolveOutdirFromPackageName(packageName: string | undefined, root: MonorepoLayoutRoot): string;
+/**
+ * Convenience wrapper that resolves an `outdir` for a `TypeScriptProject`
+ * under the canonical `packages/` root.
+ */
+declare function resolveTypeScriptProjectOutdir(packageName: string | undefined): string;
+/**
+ * Convenience wrapper that resolves an `outdir` for an `AwsCdkProject`
+ * under the canonical `apps/` root.
+ */
+declare function resolveAwsCdkProjectOutdir(packageName: string | undefined): string;
+
 /**
  * A single Starlight social icon link.
  */
@@ -3787,5 +3818,5 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, vitestBundle };
 export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, LayoutEnforcement, LayoutViolation, McpServerConfig, McpTransport, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightSidebarItem, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };

package/lib/index.js

@@ -244,8 +244,11 @@ __export(index_exports, {
   requirementsReviewerBundle: () => requirementsReviewerBundle,
   requirementsWriterBundle: () => requirementsWriterBundle,
   researchPipelineBundle: () => researchPipelineBundle,
+  resolveAwsCdkProjectOutdir: () => resolveAwsCdkProjectOutdir,
   resolveModelAlias: () => resolveModelAlias,
+  resolveOutdirFromPackageName: () => resolveOutdirFromPackageName,
   resolveTemplateVariables: () => resolveTemplateVariables,
+  resolveTypeScriptProjectOutdir: () => resolveTypeScriptProjectOutdir,
   slackBundle: () => slackBundle,
   softwareProfileBundle: () => softwareProfileBundle,
   turborepoBundle: () => turborepoBundle,
@@ -16492,6 +16495,43 @@ var MonorepoProject = class extends import_typescript3.TypeScriptAppProject {
   }
 };
 
+// src/projects/resolve-outdir.ts
+function parseScopedName(input) {
+  if (!input.startsWith("@")) {
+    return void 0;
+  }
+  const slashIndex = input.indexOf("/");
+  if (slashIndex < 2) {
+    return void 0;
+  }
+  const scope = input.slice(0, slashIndex);
+  const name = input.slice(slashIndex + 1);
+  if (name.length === 0 || name.includes("/")) {
+    return void 0;
+  }
+  return { scope, name };
+}
+function resolveOutdirFromPackageName(packageName, root) {
+  if (packageName === void 0 || packageName.length === 0) {
+    throw new Error(
+      "Cannot derive outdir: packageName (or name) is required when outdir is omitted. Either pass a scoped `packageName` / `name` like `@scope/foo`, or set `outdir` explicitly."
+    );
+  }
+  const parsed = parseScopedName(packageName);
+  if (parsed === void 0) {
+    throw new Error(
+      `Cannot derive outdir from unscoped packageName "${packageName}". Either use a scoped name like \`@scope/foo\`, or set \`outdir\` explicitly. Configulator places sub-projects at "${root}/<scope>/<name>".`
+    );
+  }
+  return `${root}/${parsed.scope}/${parsed.name}`;
+}
+function resolveTypeScriptProjectOutdir(packageName) {
+  return resolveOutdirFromPackageName(packageName, MONOREPO_LAYOUT.PACKAGES);
+}
+function resolveAwsCdkProjectOutdir(packageName) {
+  return resolveOutdirFromPackageName(packageName, MONOREPO_LAYOUT.APPS);
+}
+
 // src/projects/typescript-project.ts
 var TestRunner = {
   JEST: "jest",
@@ -16507,6 +16547,9 @@ var TypeScriptProject = class extends import_projen16.typescript.TypeScriptProje
     const parent = userOptions.parent;
     const pnpmVersion = parent.pnpmVersion;
     const pnpmWorkspace = PnpmWorkspace.of(parent);
+    const resolvedOutdir = userOptions.outdir ?? resolveTypeScriptProjectOutdir(
+      userOptions.packageName ?? userOptions.name
+    );
     const testRunner = userOptions.testRunner ?? TestRunner.JEST;
     const useJest = testRunner === TestRunner.JEST;
     const defaultOptions = {
@@ -16514,6 +16557,12 @@ var TypeScriptProject = class extends import_projen16.typescript.TypeScriptProje
        * This is a standard, so don't require it to passed in everywhere.
        */
       defaultReleaseBranch: "main",
+      /**
+       * Outdir defaults to `packages/<scope>/<name>` when the caller
+       * omits it. Explicit overrides in `userOptions` always win via
+       * the merge below.
+       */
+      outdir: resolvedOutdir,
       /**
        * Enable reset task by default.
        */
@@ -16584,10 +16633,7 @@ var TypeScriptProject = class extends import_projen16.typescript.TypeScriptProje
        * (version, dependencies) changes.
        */
       releaseTrigger: import_release.ReleaseTrigger.continuous({
-        paths: [
-          `${userOptions.outdir}/src/**`,
-          `${userOptions.outdir}/package.json`
-        ]
+        paths: [`${resolvedOutdir}/src/**`, `${resolvedOutdir}/package.json`]
       })
     };
     const options = (0, import_ts_deepmerge2.merge)(defaultOptions, userOptions);
@@ -17263,10 +17309,17 @@ var AwsCdkProject = class extends import_projen20.awscdk.AwsCdkTypeScriptApp {
     const parent = userOptions.parent;
     const pnpmVersion = parent.pnpmVersion;
     const pnpmWorkspace = PnpmWorkspace.of(parent);
+    const resolvedOutdir = userOptions.outdir ?? resolveAwsCdkProjectOutdir(userOptions.packageName ?? userOptions.name);
     const testRunner = userOptions.testRunner ?? TestRunner.JEST;
     const useJest = testRunner === TestRunner.JEST;
     const defaultOptions = {
       defaultReleaseBranch: "main",
+      /**
+       * Outdir defaults to `apps/<scope>/<name>` when the caller omits
+       * it. Explicit overrides in `userOptions` always win via the
+       * merge below.
+       */
+      outdir: resolvedOutdir,
       /**
        * Enable reset task by default.
        */
@@ -17336,10 +17389,7 @@ var AwsCdkProject = class extends import_projen20.awscdk.AwsCdkTypeScriptApp {
        * Only release when the package source content or package.json changes.
        */
       releaseTrigger: import_release2.ReleaseTrigger.continuous({
-        paths: [
-          `${userOptions.outdir}/src/**`,
-          `${userOptions.outdir}/package.json`
-        ]
+        paths: [`${resolvedOutdir}/src/**`, `${resolvedOutdir}/package.json`]
       })
     };
     const options = (0, import_ts_deepmerge3.merge)(defaultOptions, userOptions);
@@ -17630,8 +17680,11 @@ var TypeScriptConfig = class extends import_projen22.Component {
   requirementsReviewerBundle,
   requirementsWriterBundle,
   researchPipelineBundle,
+  resolveAwsCdkProjectOutdir,
   resolveModelAlias,
+  resolveOutdirFromPackageName,
   resolveTemplateVariables,
+  resolveTypeScriptProjectOutdir,
   slackBundle,
   softwareProfileBundle,
   turborepoBundle,