[CBD-2146] Regenerate TypeIdRegistry from engine type list; add generator

TypeIdRegistry maps Unity ClassIDs (PersistentTypeID) to type names. It is
needed as a fallback when a serialized object's TypeTree is unavailable, and
when only an ID is known with no file to read at all (e.g. resolving the type
of a PackedAsset referenced from a BuildReport). In those cases the name cannot
be recovered from the data, so a static map in the tool is required.

The map was previously built by hand from the public ClassIDReference page and
pruned manually, with no repeatable way to refresh it as new types are added.
TypeIdRegistryGenerator (hosted in the UnityFileSystemTestData project) now
produces the entries from the live engine type list (UnityEditor.UnityType):
runtime types are kept, editor-only types are dropped via the isEditorOnly
flag, a small allowlist of BuildReporting types is force-included (needed for
BuildReport inspection), and test/fake types from development builds are
filtered out. Run it via Tools/Generate TypeIdRegistry or -executeMethod to
regenerate the block for a new Unity version.

Author: SkowronskiAndrew

UnityFileSystem/TypeIdRegistry.cs

@@ -3,8 +3,11 @@
 namespace UnityDataTools.FileSystem;
 
 /// <summary>
-/// Registry of common Unity TypeIds mapped to their type names.
+/// Registry of Unity TypeIds mapped to their type names.
 /// Used as a fallback when TypeTree information is not available.
+/// The entries below are generated from the live engine type list by the
+/// TypeIdRegistryGenerator tool (UnityFileSystemTestData/Assets/Editor/TypeIdRegistryGenerator.cs);
+/// regenerate with a current Unity Editor rather than editing them by hand.
 /// Reference: https://docs.unity3d.com/Manual/ClassIDReference.html
 /// </summary>
 public static class TypeIdRegistry
@@ -74,14 +77,11 @@ public static class TypeIdRegistry
         { 102, "TextMesh" },
         { 104, "RenderSettings" },
         { 108, "Light" },
-        { 109, "ShaderInclude" },
-        { 110, "BaseAnimationTrack" },
         { 111, "Animation" },
         { 114, "MonoBehaviour" },
         { 115, "MonoScript" },
         { 116, "MonoManager" },
         { 117, "Texture3D" },
-        { 118, "NewAnimationTrack" },
         { 119, "Projector" },
         { 120, "LineRenderer" },
         { 121, "Flare" },
@@ -111,8 +111,6 @@ public static class TypeIdRegistry
         { 156, "TerrainData" },
         { 157, "LightmapSettings" },
         { 158, "WebCamTexture" },
-        { 159, "EditorSettings" },
-        { 162, "EditorUserSettings" },
         { 164, "AudioReverbFilter" },
         { 165, "AudioHighPassFilter" },
         { 166, "AudioChorusFilter" },
@@ -139,13 +137,11 @@ public static class TypeIdRegistry
         { 199, "ParticleSystemRenderer" },
         { 200, "ShaderVariantCollection" },
         { 205, "LODGroup" },
-        { 206, "BlendTree" },
         { 207, "Motion" },
         { 208, "NavMeshObstacle" },
         { 210, "SortingGroup" },
         { 212, "SpriteRenderer" },
         { 213, "Sprite" },
-        { 214, "CachedSpriteAtlas" },
         { 215, "ReflectionProbe" },
         { 218, "Terrain" },
         { 220, "LightProbeGroup" },
@@ -170,7 +166,6 @@ public static class TypeIdRegistry
         { 240, "AudioMixer" },
         { 241, "AudioMixerController" },
         { 243, "AudioMixerGroupController" },
-        { 244, "AudioMixerEffectController" },
         { 245, "AudioMixerSnapshotController" },
         { 246, "PhysicsUpdateBehaviour2D" },
         { 247, "ConstantForce2D" },
@@ -199,26 +194,6 @@ public static class TypeIdRegistry
         { 330, "ParticleSystemForceField" },
         { 331, "SpriteMask" },
         { 363, "OcclusionCullingData" },
-        { 900, "MarshallingTestObject" },
-        { 1001, "PrefabInstance" },
-        { 1002, "EditorExtensionImpl" },
-        { 1026, "HierarchyState" },
-        { 1028, "AssetMetaData" },
-        { 1029, "DefaultAsset" },
-        { 1032, "SceneAsset" },
-        { 1045, "EditorBuildSettings" },
-        { 1048, "InspectorExpandedState" },
-        { 1049, "AnnotationManager" },
-        { 1051, "EditorUserBuildSettings" },
-        { 1101, "AnimatorStateTransition" },
-        { 1102, "AnimatorState" },
-        { 1105, "HumanTemplate" },
-        { 1107, "AnimatorStateMachine" },
-        { 1108, "PreviewAnimationClip" },
-        { 1109, "AnimatorTransition" },
-        { 1111, "AnimatorTransitionBase" },
-        { 1113, "LightmapParameters" },
-        { 1120, "LightingDataAsset" },
         { 1125, "BuildReport" },
         { 1126, "PackedAssets" },
         { 100000, "int" },
@@ -234,73 +209,56 @@ public static class TypeIdRegistry
         { 100010, "Polygon2D" },
         { 100011, "void" },
         { 19719996, "TilemapCollider2D" },
-        { 41386430, "ImportLog" },
         { 55640938, "GraphicsStateCollection" },
         { 73398921, "VFXRenderer" },
         { 156049354, "Grid" },
         { 156483287, "ScenesUsingAssets" },
         { 171741748, "ArticulationBody" },
-        { 181963792, "Preset" },
+        { 176606843, "PhysicsCoreProjectSettings2D" },
         { 285090594, "IConstraint" },
+        { 330615474, "ContentSummary" },
         { 355983997, "AudioResource" },
-        { 369655926, "AssetImportInProgressProxy" },
         { 382020655, "PluginBuildInfo" },
-        { 387306366, "MemorySettings" },
-        { 426301858, "EditorProjectAccess" },
+        { 382093023, "UIAnimationBinder" },
+        { 392092235, "UIAnimationClip" },
         { 483693784, "TilemapRenderer" },
-        { 612988286, "SpriteAtlasAsset" },
-        { 638013454, "SpriteAtlasDatabase" },
         { 641289076, "AudioBuildInfo" },
-        { 644342135, "CachedSpriteAtlasRuntimeData" },
         { 655991488, "MultiplayerManager" },
-        { 662584278, "AssemblyDefinitionReferenceAsset" },
         { 668709126, "BuiltAssetBundleInfoSet" },
         { 687078895, "SpriteAtlas" },
-        { 702665669, "DifferentMarshallingTestObject" },
         { 825902497, "RayTracingShader" },
         { 850595691, "LightingSettings" },
-        { 877146078, "PlatformModuleSetup" },
-        { 890905787, "VersionControlSettings" },
         { 893571522, "CustomCollider2D" },
         { 895512359, "AimConstraint" },
         { 937362698, "VFXManager" },
-        { 947337230, "RoslynAnalyzerConfigAsset" },
-        { 954905827, "RuleSetFileAsset" },
         { 994735392, "VisualEffectSubgraph" },
-        { 994735403, "VisualEffectSubgraphOperator" },
-        { 994735404, "VisualEffectSubgraphBlock" },
-        { 1001480554, "Prefab" },
-        { 1114811875, "ReferencesArtifactGenerator" },
-        { 1152215463, "AssemblyDefinitionAsset" },
-        { 1154873562, "SceneVisibilityState" },
+        { 1096314112, "BlockShaderSyntaxTree" },
+        { 1096314113, "BlockShaderContainer" },
+        { 1096314114, "BlockShaderErrors" },
+        { 1120581460, "RenderAs2D" },
+        { 1149764431, "BlockShaderSourceArtifact" },
         { 1183024399, "LookAtConstraint" },
         { 1233149941, "AudioContainerElement" },
-        { 1268269756, "GameObjectRecorder" },
         { 1307931743, "AudioRandomContainer" },
-        { 1325145578, "LightingDataAssetParent" },
-        { 1386491679, "PresetManager" },
         { 1403656975, "StreamingManager" },
         { 1480428607, "LowerResBlitTexture" },
         { 1521398425, "VideoBuildInfo" },
         { 1542919678, "StreamingController" },
-        { 1557264870, "ShaderContainer" },
-        { 1597193336, "RoslynAdditionalFileAsset" },
         { 1652712579, "MultiplayerRolesData" },
         { 1660057539, "SceneRoots" },
-        { 1731078267, "BrokenPrefabAsset" },
         { 1740304944, "VulkanDeviceFilterLists" },
         { 1742807556, "GridLayout" },
         { 1773428102, "ParentConstraint" },
+        { 1798438448, "D3D12DeviceFilterLists" },
         { 1818360608, "PositionConstraint" },
         { 1818360609, "RotationConstraint" },
         { 1818360610, "ScaleConstraint" },
         { 1839735485, "Tilemap" },
-        { 1896753125, "PackageManifest" },
         { 1931382933, "UIRenderer" },
+        { 1931382934, "PanelRenderer" },
         { 1953259897, "TerrainLayer" },
         { 1971053207, "SpriteShapeRenderer" },
         { 2058629509, "VisualEffectAsset" },
-        { 2058629511, "VisualEffectResource" },
         { 2059678085, "VisualEffectObject" },
         { 2083052967, "VisualEffect" },
         { 2083778819, "LocalizationAsset" },

UnityFileSystemTestData/Assets/Editor/TypeIdRegistryGenerator.cs

@@ -0,0 +1,134 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using System.IO;
+using System.Reflection;
+using System.Text;
+using UnityEditor;
+using UnityEngine;
+
+// Generates the s_KnownTypes dictionary entries for UnityDataTools' TypeIdRegistry.cs from the
+// live engine type list. The authoritative source is the internal UnityEditor.UnityType database,
+// which exposes persistentTypeID, name and isEditorOnly for every registered type. Reflection is
+// used because UnityType is internal to the UnityEditor assembly.
+//
+// Runtime (non-editor-only) types are kept. A few editor-only types are force-included because
+// UnityDataTools needs them to inspect BuildReports (see s_IncludeEditorOnlyNames). Test/fake
+// types that get compiled into a development editor build are dropped (see s_ExcludeNames /
+// s_ExcludePatterns) since they don't exist in a shipped editor.
+//
+// Run from the Editor via Tools/Generate TypeIdRegistry, or headless:
+//   Unity.exe -projectPath <thisProject> -batchmode -quit -executeMethod TypeIdRegistryGenerator.Generate
+public static class TypeIdRegistryGenerator
+{
+    // Editor-only types that must be kept because UnityDataTools resolves them when inspecting
+    // BuildReports. These don't follow a naming convention, so they are listed explicitly. The
+    // set mirrors the IMPLEMENT_REGISTER_CLASS(BuildReporting, ...) macros in
+    // Modules/BuildReportingEditor; add new BuildReporting types here when they are introduced.
+    static readonly HashSet<string> s_IncludeEditorOnlyNames = new()
+    {
+        "AudioBuildInfo",
+        "BuildReport",
+        "BuiltAssetBundleInfoSet",
+        "ContentSummary",
+        "PackedAssets",
+        "PluginBuildInfo",
+        "ScenesUsingAssets",
+        "VideoBuildInfo",
+    };
+
+    // Test/fake types registered by a development editor build that are not real runtime classes
+    // and should never appear in the registry.
+    static readonly HashSet<string> s_ExcludeNames = new()
+    {
+        "NativeObjectType",
+        "SerializableManagedHost",
+        "Derived",
+        "SubDerived",
+        "SiblingDerived",
+        "EmptyObject",
+        "BlobObject",
+    };
+
+    // Name substrings that identify test scaffolding types to drop.
+    static readonly string[] s_ExcludePatterns = { "Test", "Fake", "Mock", "Dummy" };
+
+    [MenuItem("Tools/Generate TypeIdRegistry")]
+    public static void Generate()
+    {
+        // UnityType lives in the same assembly as UnityEditor.Editor.
+        Type unityType = typeof(Editor).Assembly.GetType("UnityEditor.UnityType");
+        if (unityType == null)
+        {
+            Debug.LogError("TypeIdRegistryGenerator: could not find type UnityEditor.UnityType.");
+            return;
+        }
+
+        MethodInfo getTypes = unityType.GetMethod("GetTypes", BindingFlags.Public | BindingFlags.Static);
+        if (getTypes == null)
+        {
+            Debug.LogError("TypeIdRegistryGenerator: could not find UnityType.GetTypes().");
+            return;
+        }
+
+        PropertyInfo idProp = unityType.GetProperty("persistentTypeID");
+        PropertyInfo nameProp = unityType.GetProperty("name");
+        PropertyInfo editorOnlyProp = unityType.GetProperty("isEditorOnly");
+        if (idProp == null || nameProp == null || editorOnlyProp == null)
+        {
+            Debug.LogError("TypeIdRegistryGenerator: UnityType is missing an expected property (persistentTypeID/name/isEditorOnly).");
+            return;
+        }
+
+        var entries = new List<(int id, string name)>();
+        foreach (var type in (IEnumerable)getTypes.Invoke(null, null))
+        {
+            var id = (int)idProp.GetValue(type);
+            var name = (string)nameProp.GetValue(type);
+
+            // Id 0 (Object) is treated as an error condition by callers, not a real type to map.
+            if (id == 0 || string.IsNullOrEmpty(name))
+                continue;
+
+            if (IsExcluded(name))
+                continue;
+
+            if ((bool)editorOnlyProp.GetValue(type) && !s_IncludeEditorOnlyNames.Contains(name))
+                continue;
+
+            entries.Add((id, name));
+        }
+
+        entries.Sort((a, b) => a.id.CompareTo(b.id));
+
+        var sb = new StringBuilder();
+        int lastId = int.MinValue;
+        foreach (var (id, name) in entries)
+        {
+            if (id == lastId)
+                Debug.LogWarning($"TypeIdRegistryGenerator: duplicate persistentTypeID {id} (\"{name}\").");
+            lastId = id;
+
+            sb.AppendLine($"        {{ {id}, \"{name}\" }},");
+        }
+
+        var outPath = Path.Combine(Directory.GetParent(Application.dataPath).FullName, "TypeIdRegistry.block.txt");
+        File.WriteAllText(outPath, sb.ToString());
+
+        Debug.Log($"TypeIdRegistryGenerator: wrote {entries.Count} entries to {outPath}");
+    }
+
+    static bool IsExcluded(string name)
+    {
+        if (s_ExcludeNames.Contains(name))
+            return true;
+
+        foreach (var pattern in s_ExcludePatterns)
+        {
+            if (name.Contains(pattern))
+                return true;
+        }
+
+        return false;
+    }
+}