@react-native/codegen 0.82.0-nightly-20250807-2768c8444 → 0.82.0-nightly-20250809-e0ea78190

package/lib/cli/generators/generate-all.js

@@ -40,6 +40,8 @@ try {
 } catch (err) {
   throw new Error(`Can't parse schema to JSON. ${schemaPath}`);
 }
+const includeGetDebugPropsImplementation =
+  libraryName.includes('FBReactNativeSpec');
 RNCodegen.generate(
   {
     libraryName,
@@ -47,6 +49,7 @@ RNCodegen.generate(
     outputDirectory,
     packageName,
     assumeNonnull,
+    includeGetDebugPropsImplementation,
   },
   {
     generators: [

package/lib/cli/generators/generate-all.js.flow

@@ -46,9 +46,17 @@ try {
 } catch (err) {
   throw new Error(`Can't parse schema to JSON. ${schemaPath}`);
 }
-
+const includeGetDebugPropsImplementation: boolean =
+  libraryName.includes('FBReactNativeSpec');
 RNCodegen.generate(
-  {libraryName, schema, outputDirectory, packageName, assumeNonnull},
+  {
+    libraryName,
+    schema,
+    outputDirectory,
+    packageName,
+    assumeNonnull,
+    includeGetDebugPropsImplementation,
+  },
   {
     generators: [
       'descriptors',

package/lib/generators/RNCodegen.js

@@ -178,6 +178,7 @@ module.exports = {
       packageName,
       assumeNonnull,
       useLocalIncludePaths,
+      includeGetDebugPropsImplementation = false,
       libraryGenerators = LIBRARY_GENERATORS,
     },
     {generators, test},
@@ -217,6 +218,7 @@ module.exports = {
           packageName,
           assumeNonnull,
           headerPrefix,
+          includeGetDebugPropsImplementation,
         ).forEach((contents, fileName) => {
           generatedFiles.push({
             name: fileName,

package/lib/generators/RNCodegen.js.flow

@@ -81,6 +81,7 @@ export type GenerateFunction = (
   packageName?: string,
   assumeNonnull: boolean,
   headerPrefix?: string,
+  includeGetDebugPropsImplementation?: boolean,
 ) => FilesOutput;
 
 export type LibraryGeneratorsFunctions = $ReadOnly<{
@@ -94,6 +95,7 @@ export type LibraryOptions = $ReadOnly<{
   packageName?: string, // Some platforms have a notion of package, which should be configurable.
   assumeNonnull: boolean,
   useLocalIncludePaths?: boolean,
+  includeGetDebugPropsImplementation?: boolean,
   libraryGenerators?: LibraryGeneratorsFunctions,
 }>;
 
@@ -255,6 +257,7 @@ module.exports = {
       packageName,
       assumeNonnull,
       useLocalIncludePaths,
+      includeGetDebugPropsImplementation = false,
       libraryGenerators = LIBRARY_GENERATORS,
     }: LibraryOptions,
     {generators, test}: LibraryConfig,
@@ -299,6 +302,7 @@ module.exports = {
           packageName,
           assumeNonnull,
           headerPrefix,
+          includeGetDebugPropsImplementation,
         ).forEach((contents: string, fileName: string) => {
           generatedFiles.push({
             name: fileName,

package/lib/generators/components/CppHelpers.js

@@ -129,7 +129,7 @@ function convertDefaultTypeToString(componentName, prop, fromBuilder = false) {
       if (typeAnnotation.default == null) {
         return '';
       }
-      return `"${typeAnnotation.default}"`;
+      return `std::string{"${typeAnnotation.default}"}`;
     case 'Int32TypeAnnotation':
       return String(typeAnnotation.default);
     case 'DoubleTypeAnnotation':

package/lib/generators/components/CppHelpers.js.flow

@@ -190,7 +190,7 @@ function convertDefaultTypeToString(
       if (typeAnnotation.default == null) {
         return '';
       }
-      return `"${typeAnnotation.default}"`;
+      return `std::string{"${typeAnnotation.default}"}`;
     case 'Int32TypeAnnotation':
       return String(typeAnnotation.default);
     case 'DoubleTypeAnnotation':

package/lib/generators/components/GenerateComponentDescriptorCpp.js

@@ -51,6 +51,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const fileName = 'ComponentDescriptors.cpp';
     const componentRegistrations = Object.keys(schema.modules)

package/lib/generators/components/GenerateComponentDescriptorCpp.js.flow

@@ -61,6 +61,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const fileName = 'ComponentDescriptors.cpp';
 

package/lib/generators/components/GenerateComponentDescriptorH.js

@@ -53,6 +53,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const fileName = 'ComponentDescriptors.h';
     const componentDefinitions = Object.keys(schema.modules)

package/lib/generators/components/GenerateComponentDescriptorH.js.flow

@@ -63,6 +63,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const fileName = 'ComponentDescriptors.h';
 

package/lib/generators/components/GenerateComponentHObjCpp.js

@@ -296,6 +296,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const fileName = 'RCTComponentViewHelpers.h';
     const componentContent = Object.keys(schema.modules)

package/lib/generators/components/GenerateComponentHObjCpp.js.flow

@@ -381,6 +381,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const fileName = 'RCTComponentViewHelpers.h';
 

package/lib/generators/components/GenerateEventEmitterCpp.js

@@ -319,6 +319,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const moduleComponents = Object.keys(schema.modules)
       .map(moduleName => {

package/lib/generators/components/GenerateEventEmitterCpp.js.flow

@@ -413,6 +413,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const moduleComponents: ComponentCollection = Object.keys(schema.modules)
       .map(moduleName => {

package/lib/generators/components/GenerateEventEmitterH.js

@@ -235,6 +235,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const moduleComponents = Object.keys(schema.modules)
       .map(moduleName => {

package/lib/generators/components/GenerateEventEmitterH.js.flow

@@ -320,6 +320,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const moduleComponents: ComponentCollection = Object.keys(schema.modules)
       .map(moduleName => {

package/lib/generators/components/GeneratePropsCpp.js

@@ -53,7 +53,13 @@ ${className}::${className}(
     ${diffProps}
 
 `.trim();
-function generatePropsDiffString(className, componentName, component) {
+function generatePropsDiffString(
+  className,
+  componentName,
+  component,
+  debugProps = '',
+  includeGetDebugPropsImplementation = false,
+) {
   const diffProps = component.props
     .map(prop => {
       const typeAnnotation = prop.typeAnnotation;
@@ -109,6 +115,11 @@ function generatePropsDiffString(className, componentName, component) {
       }
     })
     .join('\n' + '    ');
+  const getDebugPropsString = `#if RN_DEBUG_STRING_CONVERTIBLE
+SharedDebugStringConvertibleList ${className}::getDebugProps() const {
+  return ViewProps::getDebugProps()${debugProps && debugProps.length > 0 ? ` +\n\t\tSharedDebugStringConvertibleList{${debugProps}\n\t}` : ''};
+}
+#endif`;
   return `
 #ifdef RN_SERIALIZABLE_STATE
 ComponentName ${className}::getDiffPropsImplementationTarget() const {
@@ -128,7 +139,9 @@ folly::dynamic ${className}::getDiffProps(
   ${diffProps}
   return result;
 }
-#endif`;
+#endif
+${includeGetDebugPropsImplementation ? getDebugPropsString : ''}
+`;
 }
 function generatePropsString(componentName, component) {
   return component.props
@@ -144,6 +157,19 @@ function generatePropsString(componentName, component) {
     })
     .join(',\n' + '    ');
 }
+function generateDebugPropsString(componentName, component) {
+  return component.props
+    .map(prop => {
+      if (prop.typeAnnotation.type === 'ObjectTypeAnnotation') {
+        // Skip ObjectTypeAnnotation because there is no generic `toString`
+        // method for it. We would have to define an interface that the structs implement.
+        return '';
+      }
+      const defaultValue = convertDefaultTypeToString(componentName, prop);
+      return `\n\t\t\tdebugStringConvertibleItem("${prop.name}", ${prop.name}${defaultValue ? `, ${defaultValue}` : ''})`;
+    })
+    .join(',');
+}
 function getClassExtendString(component) {
   const extendString =
     ' ' +
@@ -174,12 +200,19 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const fileName = 'Props.cpp';
     const allImports = new Set([
       '#include <react/renderer/core/propsConversions.h>',
       '#include <react/renderer/core/PropsParserContext.h>',
     ]);
+    if (includeGetDebugPropsImplementation) {
+      allImports.add('#include <react/renderer/core/graphicsConversions.h>');
+      allImports.add(
+        '#include <react/renderer/debug/debugStringConvertibleUtils.h>',
+      );
+    }
     const componentProps = Object.keys(schema.modules)
       .map(moduleName => {
         const module = schema.modules[moduleName];
@@ -197,10 +230,15 @@ module.exports = {
             const newName = `${componentName}Props`;
             const propsString = generatePropsString(componentName, component);
             const extendString = getClassExtendString(component);
+            const debugProps = includeGetDebugPropsImplementation
+              ? generateDebugPropsString(componentName, component)
+              : '';
             const diffPropsString = generatePropsDiffString(
               newName,
               componentName,
               component,
+              debugProps,
+              includeGetDebugPropsImplementation,
             );
             const imports = getImports(component.props);
             // $FlowFixMe[method-unbinding] added when improving typing for this parameters

package/lib/generators/components/GeneratePropsCpp.js.flow

@@ -77,6 +77,8 @@ function generatePropsDiffString(
   className: string,
   componentName: string,
   component: ComponentShape,
+  debugProps: string = '',
+  includeGetDebugPropsImplementation?: boolean = false,
 ) {
   const diffProps = component.props
     .map(prop => {
@@ -134,6 +136,12 @@ function generatePropsDiffString(
     })
     .join('\n' + '    ');
 
+  const getDebugPropsString = `#if RN_DEBUG_STRING_CONVERTIBLE
+SharedDebugStringConvertibleList ${className}::getDebugProps() const {
+  return ViewProps::getDebugProps()${debugProps && debugProps.length > 0 ? ` +\n\t\tSharedDebugStringConvertibleList{${debugProps}\n\t}` : ''};
+}
+#endif`;
+
   return `
 #ifdef RN_SERIALIZABLE_STATE
 ComponentName ${className}::getDiffPropsImplementationTarget() const {
@@ -153,8 +161,11 @@ folly::dynamic ${className}::getDiffProps(
   ${diffProps}
   return result;
 }
-#endif`;
+#endif
+${includeGetDebugPropsImplementation ? getDebugPropsString : ''}
+`;
 }
+
 function generatePropsString(componentName: string, component: ComponentShape) {
   return component.props
     .map(prop => {
@@ -170,6 +181,24 @@ function generatePropsString(componentName: string, component: ComponentShape) {
     .join(',\n' + '    ');
 }
 
+function generateDebugPropsString(
+  componentName: string,
+  component: ComponentShape,
+) {
+  return component.props
+    .map(prop => {
+      if (prop.typeAnnotation.type === 'ObjectTypeAnnotation') {
+        // Skip ObjectTypeAnnotation because there is no generic `toString`
+        // method for it. We would have to define an interface that the structs implement.
+        return '';
+      }
+
+      const defaultValue = convertDefaultTypeToString(componentName, prop);
+      return `\n\t\t\tdebugStringConvertibleItem("${prop.name}", ${prop.name}${defaultValue ? `, ${defaultValue}` : ''})`;
+    })
+    .join(',');
+}
+
 function getClassExtendString(component: ComponentShape): string {
   const extendString =
     ' ' +
@@ -202,6 +231,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const fileName = 'Props.cpp';
     const allImports: Set<string> = new Set([
@@ -209,6 +239,13 @@ module.exports = {
       '#include <react/renderer/core/PropsParserContext.h>',
     ]);
 
+    if (includeGetDebugPropsImplementation) {
+      allImports.add('#include <react/renderer/core/graphicsConversions.h>');
+      allImports.add(
+        '#include <react/renderer/debug/debugStringConvertibleUtils.h>',
+      );
+    }
+
     const componentProps = Object.keys(schema.modules)
       .map(moduleName => {
         const module = schema.modules[moduleName];
@@ -229,10 +266,15 @@ module.exports = {
 
             const propsString = generatePropsString(componentName, component);
             const extendString = getClassExtendString(component);
+            const debugProps = includeGetDebugPropsImplementation
+              ? generateDebugPropsString(componentName, component)
+              : '';
             const diffPropsString = generatePropsDiffString(
               newName,
               componentName,
               component,
+              debugProps,
+              includeGetDebugPropsImplementation,
             );
 
             const imports = getImports(component.props);

package/lib/generators/components/GeneratePropsH.js

@@ -43,8 +43,18 @@ ${componentClasses}
 
 } // namespace facebook::react
 `;
-const ClassTemplate = ({enums, structs, className, props, extendClasses}) =>
-  `
+const ClassTemplate = ({
+  enums,
+  structs,
+  className,
+  props,
+  extendClasses,
+  includeGetDebugPropsImplementation,
+}) => {
+  const getDebugPropsString = `#if RN_DEBUG_STRING_CONVERTIBLE
+  SharedDebugStringConvertibleList getDebugProps() const override;
+  #endif`;
+  return `
 ${enums}
 ${structs}
 class ${className} final${extendClasses} {
@@ -61,8 +71,11 @@ class ${className} final${extendClasses} {
 
   folly::dynamic getDiffProps(const Props* prevProps) const override;
   #endif
+
+  ${includeGetDebugPropsImplementation ? getDebugPropsString : ''}
 };
 `.trim();
+};
 const EnumTemplate = ({enumName, values, fromCases, toCases}) =>
   `
 enum class ${enumName} { ${values} };
@@ -121,6 +134,7 @@ const StructTemplate = ({structName, fields, fromCases, toDynamicCases}) =>
   `struct ${structName} {
   ${fields}
 
+
 #ifdef RN_SERIALIZABLE_STATE
   bool operator==(const ${structName}&) const = default;
 
@@ -400,6 +414,7 @@ function generatePropsString(componentName, props, nameParts) {
 function getExtendsImports(extendsProps) {
   const imports = new Set();
   imports.add('#include <react/renderer/core/PropsParserContext.h>');
+  imports.add('#include <react/renderer/debug/DebugStringConvertible.h>');
   extendsProps.forEach(extendProps => {
     switch (extendProps.type) {
       case 'ReactNativeBuiltInType':
@@ -618,6 +633,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const fileName = 'Props.h';
     const allImports = new Set();
@@ -660,6 +676,7 @@ module.exports = {
               className: newName,
               extendClasses: extendString,
               props: propsString,
+              includeGetDebugPropsImplementation,
             });
             return replacedTemplate;
           })

package/lib/generators/components/GeneratePropsH.js.flow

@@ -65,14 +65,20 @@ const ClassTemplate = ({
   className,
   props,
   extendClasses,
+  includeGetDebugPropsImplementation,
 }: {
   enums: string,
   structs: string,
   className: string,
   props: string,
   extendClasses: string,
-}) =>
-  `
+  includeGetDebugPropsImplementation: boolean,
+}) => {
+  const getDebugPropsString = `#if RN_DEBUG_STRING_CONVERTIBLE
+  SharedDebugStringConvertibleList getDebugProps() const override;
+  #endif`;
+
+  return `
 ${enums}
 ${structs}
 class ${className} final${extendClasses} {
@@ -89,8 +95,11 @@ class ${className} final${extendClasses} {
 
   folly::dynamic getDiffProps(const Props* prevProps) const override;
   #endif
+
+  ${includeGetDebugPropsImplementation ? getDebugPropsString : ''}
 };
 `.trim();
+};
 
 const EnumTemplate = ({
   enumName,
@@ -178,6 +187,7 @@ const StructTemplate = ({
   `struct ${structName} {
   ${fields}
 
+
 #ifdef RN_SERIALIZABLE_STATE
   bool operator==(const ${structName}&) const = default;
 
@@ -536,6 +546,7 @@ function getExtendsImports(
   const imports: Set<string> = new Set();
 
   imports.add('#include <react/renderer/core/PropsParserContext.h>');
+  imports.add('#include <react/renderer/debug/DebugStringConvertible.h>');
 
   extendsProps.forEach(extendProps => {
     switch (extendProps.type) {
@@ -783,6 +794,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const fileName = 'Props.h';
 
@@ -831,6 +843,7 @@ module.exports = {
               className: newName,
               extendClasses: extendString,
               props: propsString,
+              includeGetDebugPropsImplementation,
             });
 
             return replacedTemplate;

package/lib/generators/components/GeneratePropsJavaDelegate.js

@@ -246,6 +246,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     // TODO: This doesn't support custom package name yet.
     const normalizedPackageName = 'com.facebook.react.viewmanagers';

package/lib/generators/components/GeneratePropsJavaDelegate.js.flow

@@ -299,6 +299,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     // TODO: This doesn't support custom package name yet.
     const normalizedPackageName = 'com.facebook.react.viewmanagers';

package/lib/generators/components/GeneratePropsJavaInterface.js

@@ -195,6 +195,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     // TODO: This doesn't support custom package name yet.
     const normalizedPackageName = 'com.facebook.react.viewmanagers';

package/lib/generators/components/GeneratePropsJavaInterface.js.flow

@@ -238,6 +238,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     // TODO: This doesn't support custom package name yet.
     const normalizedPackageName = 'com.facebook.react.viewmanagers';

package/lib/generators/components/GenerateShadowNodeCpp.js

@@ -46,6 +46,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const fileName = 'ShadowNodes.cpp';
     const componentNames = Object.keys(schema.modules)

package/lib/generators/components/GenerateShadowNodeCpp.js.flow

@@ -54,6 +54,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const fileName = 'ShadowNodes.cpp';
 

package/lib/generators/components/GenerateShadowNodeH.js

@@ -66,6 +66,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const fileName = 'ShadowNodes.h';
     const moduleResults = Object.keys(schema.modules)

package/lib/generators/components/GenerateShadowNodeH.js.flow

@@ -74,6 +74,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const fileName = 'ShadowNodes.h';
 

package/lib/generators/components/GenerateStateCpp.js

@@ -42,6 +42,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const fileName = 'States.cpp';
     const stateClasses = Object.keys(schema.modules)

package/lib/generators/components/GenerateStateCpp.js.flow

@@ -50,6 +50,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const fileName = 'States.cpp';
 

package/lib/generators/components/GenerateStateH.js

@@ -46,6 +46,7 @@ module.exports = {
     packageName,
     assumeNonnull = false,
     headerPrefix,
+    includeGetDebugPropsImplementation = false,
   ) {
     const fileName = 'States.h';
     const stateClasses = Object.keys(schema.modules)

package/lib/generators/components/GenerateStateH.js.flow

@@ -57,6 +57,7 @@ module.exports = {
     packageName?: string,
     assumeNonnull: boolean = false,
     headerPrefix?: string,
+    includeGetDebugPropsImplementation?: boolean = false,
   ): FilesOutput {
     const fileName = 'States.h';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native/codegen",
-  "version": "0.82.0-nightly-20250807-2768c8444",
+  "version": "0.82.0-nightly-20250809-e0ea78190",
   "description": "Code generation tools for React Native",
   "license": "MIT",
   "repository": {