chore: prevent api-extractor from publishing tagsForStack (#581)

Fixes internal issue that caused a function `tagsForStack1` to be
published in the AWS CDK Toolkit Library API Reference.

Removes the following entry:
<img width="1372" alt="Screenshot 2025-06-06 at 12 13 11"
src="https://github.com/user-attachments/assets/d7c8340f-4db1-4a6a-ac16-f0ddebe0932b"
/>

---
By submitting this pull request, I confirm that my contribution is made
under the terms of the Apache-2.0 license

Author: iankhou

packages/@aws-cdk/toolkit-lib/lib/api/tags/index.ts

@@ -0,0 +1 @@
+export * from './tags';

packages/@aws-cdk/toolkit-lib/lib/api/tags/private/index.ts

@@ -0,0 +1 @@
+export * from './util';

packages/@aws-cdk/toolkit-lib/lib/api/tags.ts renamed to packages/@aws-cdk/toolkit-lib/lib/api/tags/private/util.ts

@@ -1,13 +1,9 @@
 import type * as cxapi from '@aws-cdk/cx-api';
+import type { Tag } from '../tags';
 
 /**
  * @returns an array with the tags available in the stack metadata.
  */
 export function tagsForStack(stack: cxapi.CloudFormationStackArtifact): Tag[] {
   return Object.entries(stack.tags).map(([Key, Value]) => ({ Key, Value }));
 }
-
-export interface Tag {
-  readonly Key: string;
-  readonly Value: string;
-}

packages/@aws-cdk/toolkit-lib/lib/api/tags/tags.ts

@@ -0,0 +1,4 @@
+export interface Tag {
+  readonly Key: string;
+  readonly Value: string;
+}

packages/@aws-cdk/toolkit-lib/lib/toolkit/toolkit.ts

@@ -71,7 +71,7 @@ import type { CloudFormationStack, ResourceMapping } from '../api/refactoring/cl
 import { RefactoringContext } from '../api/refactoring/context';
 import { hashObject } from '../api/refactoring/digest';
 import { ResourceMigrator } from '../api/resource-import';
-import { tagsForStack } from '../api/tags';
+import { tagsForStack } from '../api/tags/private';
 import { DEFAULT_TOOLKIT_STACK_NAME } from '../api/toolkit-info';
 import type { AssetBuildNode, AssetPublishNode, Concurrency, StackNode } from '../api/work-graph';
 import { WorkGraphBuilder } from '../api/work-graph';

packages/aws-cdk/lib/api-private.ts

@@ -2,6 +2,7 @@
 export { deployStack, DeployStackOptions as DeployStackApiOptions } from '../../@aws-cdk/toolkit-lib/lib/api/deployments/deploy-stack';
 export * as cfnApi from '../../@aws-cdk/toolkit-lib/lib/api/deployments/cfn-api';
 export * from '../../@aws-cdk/toolkit-lib/lib/api/io/private';
+export * from '../../@aws-cdk/toolkit-lib/lib/api/tags/private';
 export * from '../../@aws-cdk/toolkit-lib/lib/private/activity-printer';
 export * from '../../@aws-cdk/toolkit-lib/lib/api/cloud-assembly/private/borrowed-assembly';
 

packages/aws-cdk/lib/cli/cdk-toolkit.ts

@@ -12,15 +12,15 @@ import * as uuid from 'uuid';
 import { CliIoHost } from './io-host';
 import type { Configuration } from './user-configuration';
 import { PROJECT_CONFIG } from './user-configuration';
-import { asIoHelper, cfnApi } from '../../lib/api-private';
+import { asIoHelper, cfnApi, tagsForStack } from '../../lib/api-private';
 import type { AssetBuildNode, AssetPublishNode, Concurrency, StackNode, WorkGraph } from '../api';
 import { DEFAULT_TOOLKIT_STACK_NAME, DiffFormatter, WorkGraphBuilder, removeNonImportResources, ResourceImporter, ResourceMigrator, GarbageCollector, CloudWatchLogEventMonitor, findCloudWatchLogGroups } from '../api';
 import type { SdkProvider } from '../api/aws-auth';
 import type { BootstrapEnvironmentOptions } from '../api/bootstrap';
 import { Bootstrapper } from '../api/bootstrap';
 import { ExtendedStackSelection, StackCollection } from '../api/cloud-assembly';
 import type { Deployments, SuccessfulDeployStackResult } from '../api/deployments';
-import { type Tag, tagsForStack } from '../api/tags';
+import { type Tag } from '../api/tags';
 import { StackActivityProgress } from '../commands/deploy';
 import { listStacks } from '../commands/list-stacks';
 import type { FromScan, GenerateTemplateOutput } from '../commands/migrate';