@atlaskit/forge-react-types 0.59.0 → 0.61.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @atlaskit/forge-react-types
 
+## 0.61.0
+
+### Minor Changes
+
+- [`50d654b213b1b`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/50d654b213b1b) -
+  Export types for Global, GlobalMain, GlobalSidebar
+
+## 0.60.0
+
+### Minor Changes
+
+- [`cc1ec16a6b6f3`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/cc1ec16a6b6f3) -
+  Add type codegen support for global components
+- [`cc1ec16a6b6f3`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/cc1ec16a6b6f3) -
+  Export Global component prop types
+
 ## 0.59.0
 
 ### Minor Changes

package/README.md

@@ -33,3 +33,13 @@ yarn workspace @atlaskit/forge-react-types codegen Button
 
 NOTE: Make sure any new component prop types are being exported from
 `packages/forge/forge-react-types/src/components/__generated__/index.ts`
+
+### Generating global component types
+
+To generate global component types, run the following command:
+
+```bash
+yarn workspace @atlaskit/forge-react-types codegen-global
+```
+
+This will generate the global component types found in `forge-common-app-gateway` package into `/src/components/global/__generated__/index.ts`.

package/dist/cjs/components/global/__generated__/GlobalExpandableMenuItemProps.codegen.js

@@ -0,0 +1 @@
+"use strict";

package/dist/cjs/components/global/__generated__/GlobalLinkMenuItemProps.codegen.js

@@ -0,0 +1 @@
+"use strict";

package/dist/cjs/components/global/__generated__/GlobalMainProps.codegen.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/components/global/__generated__/GlobalProps.codegen.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/components/global/__generated__/GlobalSidebarProps.codegen.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/components/global/__generated__/index.js

@@ -0,0 +1 @@
+"use strict";

package/dist/es2019/components/global/__generated__/GlobalMainProps.codegen.js

@@ -0,0 +1 @@
+export {};

package/dist/es2019/components/global/__generated__/GlobalProps.codegen.js

@@ -0,0 +1 @@
+export {};

package/dist/es2019/components/global/__generated__/GlobalSidebarProps.codegen.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/components/global/__generated__/GlobalMainProps.codegen.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/components/global/__generated__/GlobalProps.codegen.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/components/global/__generated__/GlobalSidebarProps.codegen.js

@@ -0,0 +1 @@
+export {};

package/dist/types/components/global/__generated__/GlobalExpandableMenuItemProps.codegen.d.ts

@@ -0,0 +1,17 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalExpandableMenuItem
+ *
+ * @codegen <<SignedSource::8f9bf63fd0127b4faa2986b9c9257182>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-ExpandableMenuItem.tsx <<SignedSource::79df02babb605094ae73bdd0c00c7156>>
+ */
+export type GlobalExpandableMenuItemProps = {
+    /**
+     * The display label for the expandable menu item.
+     */
+    label: string;
+};
+export type TGlobalExpandableMenuItem<T> = (props: GlobalExpandableMenuItemProps) => T;

package/dist/types/components/global/__generated__/GlobalLinkMenuItemProps.codegen.d.ts

@@ -0,0 +1,21 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalLinkMenuItem
+ *
+ * @codegen <<SignedSource::13f71ea4b4d387e48fef444bd10847f9>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-LinkMenuItem.tsx <<SignedSource::e70effe0d4e0620246252b35abddb112>>
+ */
+export type GlobalLinkMenuItemProps = {
+    /**
+     * The display label for the menu item.
+     */
+    label: string;
+    /**
+     * The URL path to navigate to when clicked.
+     */
+    href: string;
+};
+export type TGlobalLinkMenuItem<T> = (props: GlobalLinkMenuItemProps) => T;

package/dist/types/components/global/__generated__/GlobalMainProps.codegen.d.ts

@@ -0,0 +1,15 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalMain
+ *
+ * @codegen <<SignedSource::11ea5d4235fb0042c3ba744599576b5a>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-Main.tsx <<SignedSource::425e3fbc0683323fde14fb4bb6bb3abf>>
+ */
+import type React from 'react';
+export type GlobalMainProps = {
+    children?: React.ReactElement | React.ReactElement[];
+};
+export type TGlobalMain<T> = (props: GlobalMainProps) => T;

package/dist/types/components/global/__generated__/GlobalProps.codegen.d.ts

@@ -0,0 +1,18 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - Global
+ *
+ * @codegen <<SignedSource::01c434a8e1088249f55e97bba99aa916>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global.tsx <<SignedSource::54502ae221b976e3c4f4849cff6be726>>
+ */
+import type React from 'react';
+export type GlobalProps = {
+    /**
+     * Accepts Global.Sidebar and Global.Main components as children.
+     */
+    children?: React.ReactElement | React.ReactElement[];
+};
+export type TGlobal<T> = (props: GlobalProps) => T;

package/dist/types/components/global/__generated__/GlobalSidebarProps.codegen.d.ts

@@ -0,0 +1,23 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalSidebar
+ *
+ * @codegen <<SignedSource::79b07a090ede53f7e378c159fed3ac3b>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-Sidebar.tsx <<SignedSource::216e7ba54d02c3e167f084fb05e4018f>>
+ */
+import type React from 'react';
+export type GlobalSidebarProps = {
+    /**
+     * URL path for the "For You" section in the sidebar.
+     * When provided, enables the "For You" navigation item.
+     */
+    forYouUrl?: string;
+    /**
+     * Accepts Global.LinkMenuItem and Global.ExpandMenuItem components.
+     */
+    children?: React.ReactElement | React.ReactElement[];
+};
+export type TGlobalSidebar<T> = (props: GlobalSidebarProps) => T;

package/dist/types/components/global/__generated__/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Index file for generated Global component prop types
+ *
+ * @codegen <<SignedSource::275df2eb411df5669a05d8e4573e519b>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ */
+export type { GlobalProps, TGlobal } from './GlobalProps.codegen';
+export type { GlobalMainProps, TGlobalMain } from './GlobalMainProps.codegen';
+export type { GlobalSidebarProps, TGlobalSidebar } from './GlobalSidebarProps.codegen';
+export type { GlobalLinkMenuItemProps, TGlobalLinkMenuItem } from './GlobalLinkMenuItemProps.codegen';
+export type { GlobalExpandableMenuItemProps, TGlobalExpandableMenuItem } from './GlobalExpandableMenuItemProps.codegen';

package/dist/types/index.d.ts

@@ -3,3 +3,4 @@ export type { BarChartProps, StackBarChartProps, HorizontalStackBarChartProps, H
 export type { ChromelessEditorProps, CommentEditorProps, TChromelessEditor, TCommentEditor, } from './components/editor';
 export type { ChartColorTokens } from './types';
 export type { FrameProps } from './components/frame';
+export type { GlobalSidebarProps, TGlobalSidebar, GlobalLinkMenuItemProps, TGlobalLinkMenuItem, GlobalExpandableMenuItemProps, TGlobalExpandableMenuItem, GlobalProps, TGlobal, GlobalMainProps, TGlobalMain, } from './components/global/__generated__';

package/dist/types-ts4.5/components/global/__generated__/GlobalExpandableMenuItemProps.codegen.d.ts

@@ -0,0 +1,17 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalExpandableMenuItem
+ *
+ * @codegen <<SignedSource::8f9bf63fd0127b4faa2986b9c9257182>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-ExpandableMenuItem.tsx <<SignedSource::79df02babb605094ae73bdd0c00c7156>>
+ */
+export type GlobalExpandableMenuItemProps = {
+    /**
+     * The display label for the expandable menu item.
+     */
+    label: string;
+};
+export type TGlobalExpandableMenuItem<T> = (props: GlobalExpandableMenuItemProps) => T;

package/dist/types-ts4.5/components/global/__generated__/GlobalLinkMenuItemProps.codegen.d.ts

@@ -0,0 +1,21 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalLinkMenuItem
+ *
+ * @codegen <<SignedSource::13f71ea4b4d387e48fef444bd10847f9>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-LinkMenuItem.tsx <<SignedSource::e70effe0d4e0620246252b35abddb112>>
+ */
+export type GlobalLinkMenuItemProps = {
+    /**
+     * The display label for the menu item.
+     */
+    label: string;
+    /**
+     * The URL path to navigate to when clicked.
+     */
+    href: string;
+};
+export type TGlobalLinkMenuItem<T> = (props: GlobalLinkMenuItemProps) => T;

package/dist/types-ts4.5/components/global/__generated__/GlobalMainProps.codegen.d.ts

@@ -0,0 +1,15 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalMain
+ *
+ * @codegen <<SignedSource::11ea5d4235fb0042c3ba744599576b5a>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-Main.tsx <<SignedSource::425e3fbc0683323fde14fb4bb6bb3abf>>
+ */
+import type React from 'react';
+export type GlobalMainProps = {
+    children?: React.ReactElement | React.ReactElement[];
+};
+export type TGlobalMain<T> = (props: GlobalMainProps) => T;

package/dist/types-ts4.5/components/global/__generated__/GlobalProps.codegen.d.ts

@@ -0,0 +1,18 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - Global
+ *
+ * @codegen <<SignedSource::01c434a8e1088249f55e97bba99aa916>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global.tsx <<SignedSource::54502ae221b976e3c4f4849cff6be726>>
+ */
+import type React from 'react';
+export type GlobalProps = {
+    /**
+     * Accepts Global.Sidebar and Global.Main components as children.
+     */
+    children?: React.ReactElement | React.ReactElement[];
+};
+export type TGlobal<T> = (props: GlobalProps) => T;

package/dist/types-ts4.5/components/global/__generated__/GlobalSidebarProps.codegen.d.ts

@@ -0,0 +1,23 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalSidebar
+ *
+ * @codegen <<SignedSource::79b07a090ede53f7e378c159fed3ac3b>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-Sidebar.tsx <<SignedSource::216e7ba54d02c3e167f084fb05e4018f>>
+ */
+import type React from 'react';
+export type GlobalSidebarProps = {
+    /**
+     * URL path for the "For You" section in the sidebar.
+     * When provided, enables the "For You" navigation item.
+     */
+    forYouUrl?: string;
+    /**
+     * Accepts Global.LinkMenuItem and Global.ExpandMenuItem components.
+     */
+    children?: React.ReactElement | React.ReactElement[];
+};
+export type TGlobalSidebar<T> = (props: GlobalSidebarProps) => T;

package/dist/types-ts4.5/components/global/__generated__/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Index file for generated Global component prop types
+ *
+ * @codegen <<SignedSource::275df2eb411df5669a05d8e4573e519b>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ */
+export type { GlobalProps, TGlobal } from './GlobalProps.codegen';
+export type { GlobalMainProps, TGlobalMain } from './GlobalMainProps.codegen';
+export type { GlobalSidebarProps, TGlobalSidebar } from './GlobalSidebarProps.codegen';
+export type { GlobalLinkMenuItemProps, TGlobalLinkMenuItem } from './GlobalLinkMenuItemProps.codegen';
+export type { GlobalExpandableMenuItemProps, TGlobalExpandableMenuItem } from './GlobalExpandableMenuItemProps.codegen';

package/dist/types-ts4.5/index.d.ts

@@ -3,3 +3,4 @@ export type { BarChartProps, StackBarChartProps, HorizontalStackBarChartProps, H
 export type { ChromelessEditorProps, CommentEditorProps, TChromelessEditor, TCommentEditor, } from './components/editor';
 export type { ChartColorTokens } from './types';
 export type { FrameProps } from './components/frame';
+export type { GlobalSidebarProps, TGlobalSidebar, GlobalLinkMenuItemProps, TGlobalLinkMenuItem, GlobalExpandableMenuItemProps, TGlobalExpandableMenuItem, GlobalProps, TGlobal, GlobalMainProps, TGlobalMain, } from './components/global/__generated__';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/forge-react-types",
-	"version": "0.59.0",
+	"version": "0.61.0",
 	"description": "Component types for Forge UI Kit React components",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -23,23 +23,23 @@
 	"dependencies": {
 		"@atlaskit/button": "^23.9.0",
 		"@atlaskit/comment": "^13.2.0",
-		"@atlaskit/datetime-picker": "^17.4.0",
+		"@atlaskit/datetime-picker": "^17.5.0",
 		"@atlaskit/dynamic-table": "^18.3.0",
 		"@atlaskit/form": "^15.3.0",
 		"@atlaskit/inline-edit": "^15.6.0",
 		"@atlaskit/modal-dialog": "^14.10.0",
-		"@atlaskit/navigation-system": "^5.32.0",
+		"@atlaskit/navigation-system": "^5.33.0",
 		"@atlaskit/object": "^1.0.0",
 		"@atlaskit/popup": "^4.13.0",
 		"@atlaskit/primitives": "^18.0.0",
 		"@atlaskit/progress-bar": "^4.1.0",
-		"@atlaskit/progress-tracker": "^10.4.0",
+		"@atlaskit/progress-tracker": "^10.5.0",
 		"@atlaskit/radio": "^8.4.0",
 		"@atlaskit/section-message": "^8.12.0",
 		"@atlaskit/select": "^21.7.0",
 		"@atlaskit/spinner": "^19.0.0",
 		"@atlaskit/tabs": "^18.3.0",
-		"@atlaskit/tag": "^14.3.0",
+		"@atlaskit/tag": "^14.4.0",
 		"@atlaskit/tag-group": "^12.0.0",
 		"@atlaskit/textarea": "^8.2.0",
 		"@atlaskit/textfield": "^8.2.0",
@@ -65,6 +65,7 @@
 	},
 	"scripts": {
 		"codegen": "ts-node ./scripts/codegen-runner.ts",
+		"codegen-global": "ts-node ./scripts/codegen-global-runner.ts",
 		"check-types": "ts-node --type-check ./scripts/typechecker.ts"
 	},
 	"sideEffects": [

package/scripts/codegen/globalComponentPropTypes.ts

@@ -0,0 +1,363 @@
+// This file was generated by AI. It is an internal script used only for generating types and is not used in any production code. Use AI to update as needed and check the generated types are correct before committing.
+
+/* eslint-disable @typescript-eslint/ban-types */
+import { createSignedArtifact } from '@atlassian/codegen';
+import { Project } from 'ts-morph';
+import type { Symbol, InterfaceDeclaration, PropertySignature, SourceFile } from 'ts-morph';
+import { resolve } from 'path';
+import fs from 'fs';
+
+// Path to the global component props source file (re-exports)
+const GLOBAL_PROPS_SOURCE_PATH = resolve(
+	__dirname,
+	'../../../../..',
+	'services/forge-common-app-gateway/src/types/global-component-props.ts',
+);
+
+// Output directory for generated files
+const GLOBAL_OUTPUT_DIR = resolve(
+	__dirname,
+	'..',
+	'..',
+	'src',
+	'components',
+	'global',
+	'__generated__',
+);
+
+/**
+ * Extracts the JSDoc comment from a node and formats it properly.
+ * Only extracts JSDoc that is directly attached to the node (not file-level comments).
+ */
+const getJSDocComment = (node: InterfaceDeclaration | PropertySignature): string | null => {
+	const jsDocs = node.getJsDocs();
+	if (jsDocs.length === 0) {
+		return null;
+	}
+
+	// Get only the last JSDoc (the one directly attached to the declaration)
+	const lastJsDoc = jsDocs[jsDocs.length - 1];
+	const comment = lastJsDoc.getInnerText();
+
+	if (!comment || comment.length === 0) {
+		return null;
+	}
+
+	const commentBody = comment
+		.split('\n')
+		.map((line: string) => line.trimEnd())
+		.map((line: string) => (line.length === 0 ? ' *' : ` * ${line}`))
+		.join('\n');
+
+	return `/**\n${commentBody}\n */`;
+};
+
+/**
+ * Resolves a TypeScript type to its primitive representation.
+ * For now, we only support simple primitive types.
+ */
+const resolveToPrimitive = (typeText: string): string => {
+	// Already primitive types
+	const primitives = [
+		'string',
+		'number',
+		'boolean',
+		'null',
+		'undefined',
+		'void',
+		'never',
+		'unknown',
+		'any',
+	];
+	if (primitives.includes(typeText)) {
+		return typeText;
+	}
+
+	// Handle union types (e.g., "string | undefined")
+	if (typeText.includes('|')) {
+		const parts = typeText
+			.split('|')
+			.map((p) => p.trim())
+			.filter((p) => p.length > 0);
+		const resolvedParts = parts.map((part) => resolveToPrimitive(part));
+		return resolvedParts.join(' | ');
+	}
+
+	// For any other type, return as-is (it should already be primitive based on our props)
+	return typeText;
+};
+
+/**
+ * Resolves a symbol to its original interface declaration.
+ * Handles re-exported types by following the export declarations.
+ */
+const resolveToInterfaceDeclaration = (
+	symbol: Symbol,
+	sourceFile: SourceFile,
+	project: Project,
+): { interfaceDecl: InterfaceDeclaration; sourceFilePath: string } | null => {
+	const symbolName = symbol.getName();
+
+	// Find the export declaration for this symbol
+	const exportDeclarations = sourceFile.getExportDeclarations();
+
+	for (const exportDecl of exportDeclarations) {
+		const namedExports = exportDecl.getNamedExports();
+		const matchingExport = namedExports.find(
+			(ne) => ne.getName() === symbolName || ne.getAliasNode()?.getText() === symbolName,
+		);
+
+		if (matchingExport) {
+			// Get the module specifier (the path being exported from)
+			const moduleSpecifier = exportDecl.getModuleSpecifierValue();
+			if (!moduleSpecifier) {
+				continue;
+			}
+
+			// Resolve the module path
+			const moduleSourceFile = exportDecl.getModuleSpecifierSourceFile();
+			if (!moduleSourceFile) {
+				// Try to manually resolve and add the source file
+				const resolvedPath = resolve(sourceFile.getDirectoryPath(), moduleSpecifier + '.tsx');
+
+				if (fs.existsSync(resolvedPath)) {
+					const addedSourceFile = project.addSourceFileAtPath(resolvedPath);
+					const interfaceDecl = addedSourceFile.getInterface(symbolName);
+					if (interfaceDecl) {
+						return {
+							interfaceDecl,
+							sourceFilePath: resolvedPath,
+						};
+					}
+				}
+				continue;
+			}
+
+			// Find the interface in the module source file
+			const interfaceDecl = moduleSourceFile.getInterface(symbolName);
+			if (interfaceDecl) {
+				return {
+					interfaceDecl,
+					sourceFilePath: moduleSourceFile.getFilePath(),
+				};
+			}
+		}
+	}
+
+	return null;
+};
+
+/**
+ * Generates the source code for a single component's prop types.
+ */
+const generateComponentPropTypeCode = (
+	interfaceDecl: InterfaceDeclaration,
+	allPropsNames: string[],
+): string => {
+	const interfaceName = interfaceDecl.getName();
+	const componentName = interfaceName.replace('Props', '');
+
+	const lines: string[] = [];
+
+	// Add eslint directive
+	lines.push('/* eslint @repo/internal/codegen/signed-source-integrity: "warn" */');
+	lines.push('');
+
+	// Get interface JSDoc
+	const interfaceJSDoc = getJSDocComment(interfaceDecl);
+	if (interfaceJSDoc) {
+		lines.push(interfaceJSDoc);
+	}
+
+	// Generate the props type
+	const properties = interfaceDecl.getProperties();
+
+	if (properties.length === 0) {
+		// Empty props interface
+		lines.push(`export type ${interfaceName} = Record<string, never>;`);
+	} else {
+		lines.push(`export type ${interfaceName} = {`);
+
+		properties.forEach((prop: PropertySignature) => {
+			const propName = prop.getName();
+			// Prefer the source-level type annotation (getTypeNode) over the resolved type (getType).
+			// getType().getText() can produce degenerate types (any/never/undefined) when the
+			// ts-morph Project lacks type definitions, or overly verbose types that expand
+			// generic defaults (e.g., ReactElement<X> → ReactElement<X, string | JSXElementConstructor<any>>).
+			// The source annotation preserves the developer's intended type expression.
+			const resolvedTypeText = prop.getType().getText();
+			const sourceTypeText = prop.getTypeNode()?.getText();
+			let propType = sourceTypeText ?? resolvedTypeText;
+
+			// Normalize bare React type references (e.g., ReactElement → React.ReactElement)
+			// so the generated file only needs a single React namespace import.
+			const reactTypeNames = [
+				'ReactElement',
+				'ReactNode',
+				'ReactFragment',
+				'ReactPortal',
+				'JSXElementConstructor',
+			];
+			for (const typeName of reactTypeNames) {
+				propType = propType.replace(
+					new RegExp(`(?<![\\w.])${typeName}\\b`, 'g'),
+					`React.${typeName}`,
+				);
+			}
+
+			const isOptional = prop.hasQuestionToken();
+			const resolvedType = resolveToPrimitive(propType);
+
+			// Get property JSDoc
+			const propJSDoc = getJSDocComment(prop);
+			if (propJSDoc) {
+				// Indent the JSDoc for property
+				const indentedJSDoc = propJSDoc
+					.split('\n')
+					.map((line: string) => `\t${line}`)
+					.join('\n');
+				lines.push(indentedJSDoc);
+			}
+
+			const optionalMarker = isOptional ? '?' : '';
+			lines.push(`\t${propName}${optionalMarker}: ${resolvedType};`);
+		});
+
+		lines.push('};');
+	}
+
+	lines.push('');
+
+	// Generate the T* component type
+	if (interfaceJSDoc) {
+		lines.push(interfaceJSDoc);
+	}
+	lines.push(`export type T${componentName}<T> = (props: ${interfaceName}) => T;`);
+
+	// Detect needed imports based on type references in the generated code
+	const generatedCode = lines.slice(2).join('\n'); // skip eslint directive and blank line
+	const importLines: string[] = [];
+
+	if (/\bReact\./.test(generatedCode)) {
+		importLines.push("import type React from 'react';");
+	}
+
+	for (const propsName of allPropsNames) {
+		if (propsName !== interfaceName && generatedCode.includes(propsName)) {
+			importLines.push(`import type { ${propsName} } from './${propsName}.codegen';`);
+		}
+	}
+
+	if (importLines.length > 0) {
+		// Insert imports after the eslint directive and blank line (index 2)
+		lines.splice(2, 0, ...importLines, '');
+	}
+
+	return lines.join('\n');
+};
+
+/**
+ * Generates prop type files for all Global components.
+ *
+ * Process:
+ * 1. Load the re-export file (global-component-props.ts)
+ * 2. Get exported symbols ending with "Props"
+ * 3. Resolve each to its original interface declaration
+ * 4. Extract type info and resolve to primitives
+ * 5. Generate signed .codegen.tsx files and index.ts
+ */
+const generateGlobalComponentPropTypes = () => {
+	// eslint-disable-next-line no-console
+	console.log('Generating Global component prop types...');
+
+	// Ensure output directory exists
+	if (!fs.existsSync(GLOBAL_OUTPUT_DIR)) {
+		fs.mkdirSync(GLOBAL_OUTPUT_DIR, { recursive: true });
+	}
+
+	const project = new Project({
+		compilerOptions: {
+			strict: true,
+		},
+	});
+
+	const sourceFile = project.addSourceFileAtPath(GLOBAL_PROPS_SOURCE_PATH);
+	const exportedSymbols = sourceFile.getExportSymbols();
+	const propsSymbols = exportedSymbols.filter((symbol) => symbol.getName().endsWith('Props'));
+
+	const allPropsNames = propsSymbols.map((s) => s.getName());
+	const generatedFiles: string[] = [];
+
+	propsSymbols.forEach((symbol) => {
+		const symbolName = symbol.getName();
+		const componentName = symbolName.replace('Props', '');
+
+		const resolved = resolveToInterfaceDeclaration(symbol, sourceFile, project);
+
+		if (!resolved) {
+			// eslint-disable-next-line no-console
+			console.error(`  ✗ Could not resolve ${symbolName} to an interface declaration`);
+			return;
+		}
+
+		const { interfaceDecl, sourceFilePath } = resolved;
+		const sourceCode = generateComponentPropTypeCode(interfaceDecl, allPropsNames);
+		const outputPath = resolve(GLOBAL_OUTPUT_DIR, `${symbolName}.codegen.tsx`);
+
+		const signedSourceCode = createSignedArtifact(
+			sourceCode,
+			'yarn workspace @atlaskit/forge-react-types codegen-global',
+			{
+				description: `Generated prop types for Global component - ${componentName}`,
+				dependencies: [GLOBAL_PROPS_SOURCE_PATH, sourceFilePath],
+				outputFolder: GLOBAL_OUTPUT_DIR,
+			},
+		);
+
+		fs.writeFileSync(outputPath, signedSourceCode);
+		generatedFiles.push(symbolName);
+
+		// eslint-disable-next-line no-console
+		console.log(`  ✓ Generated ${symbolName}.codegen.tsx`);
+	});
+
+	generateIndexFile(generatedFiles);
+
+	// eslint-disable-next-line no-console
+	console.log('✓ Global component prop types generation complete!');
+};
+
+/**
+ * Generates the index.ts file that exports all generated types.
+ */
+const generateIndexFile = (interfaceNames: string[]) => {
+	const lines: string[] = [];
+
+	lines.push('/* eslint @repo/internal/codegen/signed-source-integrity: "warn" */');
+	lines.push('');
+
+	interfaceNames.forEach((interfaceName) => {
+		const componentName = interfaceName.replace('Props', '');
+		lines.push(
+			`export type { ${interfaceName}, T${componentName} } from './${interfaceName}.codegen';`,
+		);
+	});
+
+	const sourceCode = lines.join('\n') + '\n';
+
+	const indexPath = resolve(GLOBAL_OUTPUT_DIR, 'index.ts');
+
+	const signedSourceCode = createSignedArtifact(
+		sourceCode,
+		'yarn workspace @atlaskit/forge-react-types codegen-global',
+		{
+			description: 'Index file for generated Global component prop types',
+			dependencies: [GLOBAL_PROPS_SOURCE_PATH],
+			outputFolder: GLOBAL_OUTPUT_DIR,
+		},
+	);
+
+	fs.writeFileSync(indexPath, signedSourceCode);
+};
+
+export { generateGlobalComponentPropTypes };

package/scripts/codegen-global-runner.ts

@@ -0,0 +1,18 @@
+import { generateGlobalComponentPropTypes } from './codegen/globalComponentPropTypes';
+
+const runTypeCheck = () => {
+	// execute yarn run check-types
+	const { execSync } = require('child_process');
+	try {
+		execSync('yarn run check-types', { stdio: 'inherit' });
+		// eslint-disable-next-line no-console
+		console.log('✅ 🚀 Type checks passed successfully for generated Global component types!');
+	} catch (error) {
+		// eslint-disable-next-line no-console
+		console.error('❌ Type checks failed:', error);
+		process.exit(1);
+	}
+};
+
+generateGlobalComponentPropTypes();
+runTypeCheck();

package/scripts/typechecker.ts

@@ -11,7 +11,7 @@ import {
 	type LozengeProps,
 	type RangeProps,
 	type IconProps,
-} from '@atlassian/forge-ui/src/components/UIKit';
+} from '@atlassian/forge-ui/UIKit';
 import { type BadgeProps as GeneratedBadgeProps } from '../src/components/__generated__/BadgeProps.codegen';
 import { type CalendarProps as GeneratedCalendarProps } from '../src/components/__generated__/CalendarProps.codegen';
 import { type CheckboxProps as GeneratedCheckboxProps } from '../src/components/__generated__/CheckboxProps.codegen';

package/src/components/global/__generated__/GlobalExpandableMenuItemProps.codegen.tsx

@@ -0,0 +1,20 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalExpandableMenuItem
+ *
+ * @codegen <<SignedSource::8f9bf63fd0127b4faa2986b9c9257182>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-ExpandableMenuItem.tsx <<SignedSource::79df02babb605094ae73bdd0c00c7156>>
+ */
+/* eslint @repo/internal/codegen/signed-source-integrity: "warn" */
+
+export type GlobalExpandableMenuItemProps = {
+	/**
+	 * The display label for the expandable menu item.
+	 */
+	label: string;
+};
+
+export type TGlobalExpandableMenuItem<T> = (props: GlobalExpandableMenuItemProps) => T;

package/src/components/global/__generated__/GlobalLinkMenuItemProps.codegen.tsx

@@ -0,0 +1,24 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalLinkMenuItem
+ *
+ * @codegen <<SignedSource::13f71ea4b4d387e48fef444bd10847f9>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-LinkMenuItem.tsx <<SignedSource::e70effe0d4e0620246252b35abddb112>>
+ */
+/* eslint @repo/internal/codegen/signed-source-integrity: "warn" */
+
+export type GlobalLinkMenuItemProps = {
+	/**
+	 * The display label for the menu item.
+	 */
+	label: string;
+	/**
+	 * The URL path to navigate to when clicked.
+	 */
+	href: string;
+};
+
+export type TGlobalLinkMenuItem<T> = (props: GlobalLinkMenuItemProps) => T;

package/src/components/global/__generated__/GlobalMainProps.codegen.tsx

@@ -0,0 +1,19 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalMain
+ *
+ * @codegen <<SignedSource::11ea5d4235fb0042c3ba744599576b5a>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-Main.tsx <<SignedSource::425e3fbc0683323fde14fb4bb6bb3abf>>
+ */
+/* eslint @repo/internal/codegen/signed-source-integrity: "warn" */
+
+import type React from 'react';
+
+export type GlobalMainProps = {
+	children?: React.ReactElement | React.ReactElement[];
+};
+
+export type TGlobalMain<T> = (props: GlobalMainProps) => T;

package/src/components/global/__generated__/GlobalProps.codegen.tsx

@@ -0,0 +1,22 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - Global
+ *
+ * @codegen <<SignedSource::01c434a8e1088249f55e97bba99aa916>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global.tsx <<SignedSource::54502ae221b976e3c4f4849cff6be726>>
+ */
+/* eslint @repo/internal/codegen/signed-source-integrity: "warn" */
+
+import type React from 'react';
+
+export type GlobalProps = {
+	/**
+	 * Accepts Global.Sidebar and Global.Main components as children.
+	 */
+	children?: React.ReactElement | React.ReactElement[];
+};
+
+export type TGlobal<T> = (props: GlobalProps) => T;

package/src/components/global/__generated__/GlobalSidebarProps.codegen.tsx

@@ -0,0 +1,27 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Generated prop types for Global component - GlobalSidebar
+ *
+ * @codegen <<SignedSource::79b07a090ede53f7e378c159fed3ac3b>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/components/global/Global-Sidebar.tsx <<SignedSource::216e7ba54d02c3e167f084fb05e4018f>>
+ */
+/* eslint @repo/internal/codegen/signed-source-integrity: "warn" */
+
+import type React from 'react';
+
+export type GlobalSidebarProps = {
+	/**
+	 * URL path for the "For You" section in the sidebar.
+	 * When provided, enables the "For You" navigation item.
+	 */
+	forYouUrl?: string;
+	/**
+	 * Accepts Global.LinkMenuItem and Global.ExpandMenuItem components.
+	 */
+	children?: React.ReactElement | React.ReactElement[];
+};
+
+export type TGlobalSidebar<T> = (props: GlobalSidebarProps) => T;

package/src/components/global/__generated__/index.ts

@@ -0,0 +1,16 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Index file for generated Global component prop types
+ *
+ * @codegen <<SignedSource::275df2eb411df5669a05d8e4573e519b>>
+ * @codegenCommand yarn workspace @atlaskit/forge-react-types codegen-global
+ * @codegenDependency ../../../../../../../services/forge-common-app-gateway/src/types/global-component-props.ts <<SignedSource::ad330a446ee260180d5b510c18b5e1c8>>
+ */
+/* eslint @repo/internal/codegen/signed-source-integrity: "warn" */
+
+export type { GlobalProps, TGlobal } from './GlobalProps.codegen';
+export type { GlobalMainProps, TGlobalMain } from './GlobalMainProps.codegen';
+export type { GlobalSidebarProps, TGlobalSidebar } from './GlobalSidebarProps.codegen';
+export type { GlobalLinkMenuItemProps, TGlobalLinkMenuItem } from './GlobalLinkMenuItemProps.codegen';
+export type { GlobalExpandableMenuItemProps, TGlobalExpandableMenuItem } from './GlobalExpandableMenuItemProps.codegen';

package/src/index.ts

@@ -162,3 +162,16 @@ export type {
 export type { ChartColorTokens } from './types';
 
 export type { FrameProps } from './components/frame';
+
+export type {
+	GlobalSidebarProps,
+	TGlobalSidebar,
+	GlobalLinkMenuItemProps,
+	TGlobalLinkMenuItem,
+	GlobalExpandableMenuItemProps,
+	TGlobalExpandableMenuItem,
+	GlobalProps,
+	TGlobal,
+	GlobalMainProps,
+	TGlobalMain,
+} from './components/global/__generated__';