Analyze web documentation

* Add constructors to EngineResourceData and UnityPackageData
* Make UnityPackageData.Assets a dictionary

.editorconfig

@@ -0,0 +1,258 @@
+# To learn more about .editorconfig see https://aka.ms/editorconfigdocs
+# Remove the line below if you want to inherit .editorconfig settings from higher directories
+root = true
+
+# C# files
+[*.cs]
+
+#### Core EditorConfig Options ####
+
+# Indentation and spacing
+indent_size = 4
+indent_style = tab
+tab_width = 4
+
+# New line preferences
+end_of_line = crlf
+insert_final_newline =true
+
+#### .NET Coding Conventions ####
+
+# Organize usings
+dotnet_separate_import_directive_groups = false
+dotnet_sort_system_directives_first = false
+
+# this. and Me. preferences
+dotnet_style_qualification_for_event = false:silent
+dotnet_style_qualification_for_field = false:silent
+dotnet_style_qualification_for_method = false:silent
+dotnet_style_qualification_for_property = false:silent
+
+# Language keywords vs BCL types preferences
+dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
+dotnet_style_predefined_type_for_member_access = true:suggestion
+
+# Parentheses preferences
+dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_other_operators = never_if_unnecessary:silent
+dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:silent
+
+# Modifier preferences
+dotnet_style_require_accessibility_modifiers = for_non_interface_members:silent
+
+# Expression-level preferences
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_explicit_tuple_names = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+dotnet_style_object_initializer = false:suggestion
+dotnet_style_prefer_auto_properties = true:suggestion
+dotnet_style_prefer_compound_assignment = true:suggestion
+dotnet_style_prefer_conditional_expression_over_assignment = false:silent
+dotnet_style_prefer_conditional_expression_over_return = false:silent
+dotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion
+dotnet_style_prefer_inferred_tuple_names = true:suggestion
+dotnet_style_prefer_is_null_check_over_reference_equality_method = true:suggestion
+
+# Field preferences
+dotnet_style_readonly_field = true:suggestion
+
+# Parameter preferences
+dotnet_code_quality_unused_parameters = all:suggestion
+
+#### C# Coding Conventions ####
+
+# var preferences
+csharp_style_var_elsewhere = false:warning
+csharp_style_var_for_built_in_types = false:warning
+csharp_style_var_when_type_is_apparent = false:suggestion
+
+# Expression-bodied members
+csharp_style_expression_bodied_accessors = true:silent
+csharp_style_expression_bodied_constructors = false:silent
+csharp_style_expression_bodied_indexers = true:silent
+csharp_style_expression_bodied_lambdas = true:silent
+csharp_style_expression_bodied_local_functions = false:silent
+csharp_style_expression_bodied_methods = false:silent
+csharp_style_expression_bodied_operators = false:silent
+csharp_style_expression_bodied_properties = true:silent
+
+# Pattern matching preferences
+csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
+csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
+csharp_style_prefer_switch_expression = true:suggestion
+
+# Null-checking preferences
+csharp_style_conditional_delegate_call = true:suggestion
+
+# Modifier preferences
+csharp_prefer_static_local_function = true:suggestion
+csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async
+
+# Code-block preferences
+csharp_prefer_braces = true:suggestion
+csharp_prefer_simple_using_statement = true:suggestion
+
+# Expression-level preferences
+csharp_prefer_simple_default_expression = true:suggestion
+csharp_style_deconstructed_variable_declaration = true:suggestion
+csharp_style_inlined_variable_declaration = true:suggestion
+csharp_style_pattern_local_over_anonymous_function = true:suggestion
+csharp_style_prefer_index_operator = true:suggestion
+csharp_style_prefer_range_operator = true:suggestion
+csharp_style_throw_expression = true:suggestion
+csharp_style_unused_value_assignment_preference = discard_variable:suggestion
+csharp_style_unused_value_expression_statement_preference = discard_variable:silent
+
+# 'using' directive preferences
+csharp_using_directive_placement = outside_namespace:silent
+
+#### C# Formatting Rules ####
+
+# New line preferences
+csharp_new_line_before_catch = true
+csharp_new_line_before_else = true
+csharp_new_line_before_finally = true
+csharp_new_line_before_members_in_anonymous_types = true
+csharp_new_line_before_members_in_object_initializers = true
+csharp_new_line_before_open_brace = all
+csharp_new_line_between_query_expression_clauses = true
+
+# Indentation preferences
+csharp_indent_block_contents = true
+csharp_indent_braces = false
+csharp_indent_case_contents = true
+csharp_indent_case_contents_when_block = true
+csharp_indent_labels = one_less_than_current
+csharp_indent_switch_labels = true
+
+# Space preferences
+csharp_space_after_cast = false
+csharp_space_after_colon_in_inheritance_clause = true
+csharp_space_after_comma = true
+csharp_space_after_dot = false
+csharp_space_after_keywords_in_control_flow_statements = true
+csharp_space_after_semicolon_in_for_statement = true
+csharp_space_around_binary_operators = before_and_after
+csharp_space_around_declaration_statements = false
+csharp_space_before_colon_in_inheritance_clause = true
+csharp_space_before_comma = false
+csharp_space_before_dot = false
+csharp_space_before_open_square_brackets = false
+csharp_space_before_semicolon_in_for_statement = false
+csharp_space_between_empty_square_brackets = false
+csharp_space_between_method_call_empty_parameter_list_parentheses = false
+csharp_space_between_method_call_name_and_opening_parenthesis = false
+csharp_space_between_method_call_parameter_list_parentheses = false
+csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
+csharp_space_between_method_declaration_name_and_open_parenthesis = false
+csharp_space_between_method_declaration_parameter_list_parentheses = false
+csharp_space_between_parentheses = false
+csharp_space_between_square_brackets = false
+
+# Wrapping preferences
+csharp_preserve_single_line_blocks = true
+csharp_preserve_single_line_statements = true
+
+#### Naming styles ####
+
+# Naming rules
+
+dotnet_naming_rule.interface_should_be_begins_with_i.severity = suggestion
+dotnet_naming_rule.interface_should_be_begins_with_i.symbols = interface
+dotnet_naming_rule.interface_should_be_begins_with_i.style = begins_with_i
+
+dotnet_naming_rule.types_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.types_should_be_pascal_case.symbols = types
+dotnet_naming_rule.types_should_be_pascal_case.style = pascal_case
+
+dotnet_naming_rule.non_field_members_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.non_field_members_should_be_pascal_case.symbols = non_field_members
+dotnet_naming_rule.non_field_members_should_be_pascal_case.style = pascal_case
+
+# Symbol specifications
+
+dotnet_naming_symbols.interface.applicable_kinds = interface
+dotnet_naming_symbols.interface.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
+dotnet_naming_symbols.interface.required_modifiers = 
+
+dotnet_naming_symbols.types.applicable_kinds = class, struct, interface, enum
+dotnet_naming_symbols.types.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
+dotnet_naming_symbols.types.required_modifiers = 
+
+dotnet_naming_symbols.non_field_members.applicable_kinds = property, event, method
+dotnet_naming_symbols.non_field_members.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
+dotnet_naming_symbols.non_field_members.required_modifiers = 
+
+# Naming styles
+
+dotnet_naming_style.pascal_case.required_prefix = 
+dotnet_naming_style.pascal_case.required_suffix = 
+dotnet_naming_style.pascal_case.word_separator = 
+dotnet_naming_style.pascal_case.capitalization = pascal_case
+
+dotnet_naming_style.begins_with_i.required_prefix = I
+dotnet_naming_style.begins_with_i.required_suffix = 
+dotnet_naming_style.begins_with_i.word_separator = 
+dotnet_naming_style.begins_with_i.capitalization = pascal_case
+csharp_style_namespace_declarations = block_scoped:silent
+csharp_style_prefer_method_group_conversion = true:silent
+csharp_style_prefer_null_check_over_type_check = true:suggestion
+csharp_style_prefer_local_over_anonymous_function = true:suggestion
+csharp_style_implicit_object_creation_when_type_is_apparent = true:suggestion
+csharp_style_prefer_tuple_swap = true:suggestion
+csharp_style_allow_embedded_statements_on_same_line_experimental = true:silent
+csharp_style_allow_blank_lines_between_consecutive_braces_experimental = true:silent
+csharp_style_allow_blank_line_after_colon_in_constructor_initializer_experimental = true:silent
+csharp_style_prefer_parameter_null_checking = true:suggestion
+csharp_style_prefer_pattern_matching = true:silent
+csharp_style_prefer_not_pattern = true:suggestion
+csharp_style_prefer_extended_property_pattern = true:suggestion
+csharp_style_prefer_top_level_statements = false:silent
+dotnet_diagnostic.CA1309.severity = error
+dotnet_diagnostic.CA1311.severity = suggestion
+dotnet_diagnostic.SYSLIB1054.severity = warning
+csharp_style_prefer_primary_constructors = false:silent
+csharp_style_prefer_utf8_string_literals = true:suggestion
+csharp_style_prefer_readonly_struct = true:suggestion
+csharp_style_prefer_readonly_struct_member = true:suggestion
+csharp_style_allow_blank_line_after_token_in_conditional_expression_experimental = true:silent
+csharp_style_allow_blank_line_after_token_in_arrow_expression_clause_experimental = true:silent
+
+[*.{cs,vb}]
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+dotnet_style_prefer_is_null_check_over_reference_equality_method = true:suggestion
+dotnet_style_prefer_auto_properties = true:suggestion
+dotnet_style_object_initializer = false:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_prefer_simplified_boolean_expressions = true:suggestion
+dotnet_style_operator_placement_when_wrapping = beginning_of_line
+tab_width = 4
+indent_size = 4
+end_of_line = lf
+dotnet_style_prefer_conditional_expression_over_assignment = false:silent
+dotnet_style_prefer_conditional_expression_over_return = false:silent
+dotnet_style_explicit_tuple_names = true:suggestion
+dotnet_style_prefer_inferred_tuple_names = true:suggestion
+dotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion
+dotnet_style_prefer_compound_assignment = true:suggestion
+dotnet_style_prefer_simplified_interpolation = true:suggestion
+dotnet_style_namespace_match_folder = true:suggestion
+dotnet_style_readonly_field = true:suggestion
+dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
+dotnet_style_predefined_type_for_member_access = true:suggestion
+dotnet_style_require_accessibility_modifiers = for_non_interface_members:silent
+dotnet_style_allow_multiple_blank_lines_experimental = true:silent
+dotnet_style_allow_statement_immediately_after_block_experimental = true:silent
+dotnet_code_quality_unused_parameters = all:suggestion
+dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_other_operators = never_if_unnecessary:silent
+dotnet_style_qualification_for_field = false:silent
+dotnet_style_qualification_for_property = false:silent
+dotnet_style_qualification_for_method = false:silent
+dotnet_style_qualification_for_event = false:silent
+dotnet_style_prefer_collection_expression = true:suggestion

AssetRipper.Mining.EngineFileExtractor/Program.cs

@@ -84,7 +84,8 @@ internal static class Program
 						obj = new Mesh()
 						{
 							Name = asset.Name,
-							VertexCount = asset.BaseField.Get("m_VertexData").Get("m_VertexCount").AsUInt
+							VertexCount = asset.BaseField.Get("m_VertexData").Get("m_VertexCount").AsInt,
+							SubMeshCount = asset.BaseField.Get("m_SubMeshes").Get("Array").Children.Count
 						};
 					}
 					break;

AssetRipper.Mining.PredefinedAssets.Tests/Tests.cs

@@ -17,4 +17,27 @@ public class Tests
 			}
 			""".Replace(Environment.NewLine, "\n")));
 	}
-}
+
+	[Test]
+	public void UnityPackageDataCanBeSerialized()
+	{
+		UnityPackageData package = new UnityPackageData("Example", "1.0.0", true);
+		package.Assets.Add(new TextAsset("", ""u8), default);
+		string json = package.ToJson();
+		Assert.That(json, Is.Not.Empty);
+	}
+
+	[Test]
+	public void UnityPackageDataCanBeDeserialized()
+	{
+		UnityPackageData package = UnityPackageData.FromJson(MakeJson());
+		Assert.That(package.Assets, Is.Not.Empty);
+
+		static string MakeJson()
+		{
+			UnityPackageData package = new UnityPackageData("Example", "1.0.0", true);
+			package.Assets.Add(new TextAsset("", ""u8), default);
+			return package.ToJson();
+		}
+	}
+}

AssetRipper.Mining.PredefinedAssets/AssetDictionary.cs

@@ -0,0 +1,82 @@
+using AssetRipper.Primitives;
+using System.Collections;
+
+namespace AssetRipper.Mining.PredefinedAssets;
+
+public readonly struct AssetDictionary : IReadOnlyCollection<KeyValuePair<Object, PPtr>>, ICollection<KeyValuePair<Object, PPtr>>
+{
+	//This class implements all the IReadOnlyDictionary`2 members, but does not implement the interface because that changes how System.Text.Json serializes it.
+
+	private readonly Dictionary<Object, PPtr> _dictionary = new();
+
+	public int Count => _dictionary.Count;
+
+	public IEnumerable<Object> Keys => _dictionary.Keys;
+
+	public IEnumerable<PPtr> Values => _dictionary.Values;
+
+	public PPtr this[Object key] => _dictionary[key];
+
+	public AssetDictionary()
+	{
+	}
+
+	public void Add(Object key, PPtr value) => _dictionary.Add(key, value);
+
+	public void Add(MonoScript key, UnityGuid guid) => Add(key, new PPtr(11500000, guid, AssetType.Meta));
+
+	public void Clear() => _dictionary.Clear();
+
+	public bool ContainsKey(Object key)
+	{
+		return _dictionary.ContainsKey(key);
+	}
+
+	public bool TryAdd(Object key, PPtr value)
+	{
+#if NETSTANDARD
+		if (_dictionary.ContainsKey(key))
+		{
+			return false;
+		}
+		else
+		{
+			_dictionary.Add(key, value);
+			return true;
+		}
+#else
+		return _dictionary.TryAdd(key, value);
+#endif
+	}
+
+	public bool TryGetValue(Object key, out PPtr value)
+	{
+		return _dictionary.TryGetValue(key, out value);
+	}
+
+	public IEnumerator<KeyValuePair<Object, PPtr>> GetEnumerator() => _dictionary.GetEnumerator();
+
+	IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
+
+	bool ICollection<KeyValuePair<Object, PPtr>>.IsReadOnly => ((ICollection<KeyValuePair<Object, PPtr>>)_dictionary).IsReadOnly;
+
+	void ICollection<KeyValuePair<Object, PPtr>>.Add(KeyValuePair<Object, PPtr> item)
+	{
+		((ICollection<KeyValuePair<Object, PPtr>>)_dictionary).Add(item);
+	}
+
+	bool ICollection<KeyValuePair<Object, PPtr>>.Contains(KeyValuePair<Object, PPtr> item)
+	{
+		return ((ICollection<KeyValuePair<Object, PPtr>>)_dictionary).Contains(item);
+	}
+
+	void ICollection<KeyValuePair<Object, PPtr>>.CopyTo(KeyValuePair<Object, PPtr>[] array, int arrayIndex)
+	{
+		((ICollection<KeyValuePair<Object, PPtr>>)_dictionary).CopyTo(array, arrayIndex);
+	}
+
+	bool ICollection<KeyValuePair<Object, PPtr>>.Remove(KeyValuePair<Object, PPtr> item)
+	{
+		return ((ICollection<KeyValuePair<Object, PPtr>>)_dictionary).Remove(item);
+	}
+}

AssetRipper.Mining.PredefinedAssets/AssetRipper.Mining.PredefinedAssets.csproj

@@ -9,7 +9,7 @@
 		<CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
 		<Authors>ds5678</Authors>
 		<Company>AssetRipper</Company>
-		<Version>1.0.1</Version>
+		<Version>1.2.1</Version>
 		<AssemblyVersion>$(Version)</AssemblyVersion>
 		<PackageId>AssetRipper.Mining.PredefinedAssets</PackageId>
 		<PackageTags>C# Unity</PackageTags>

AssetRipper.Mining.PredefinedAssets/AssetType.cs

@@ -0,0 +1,28 @@
+namespace AssetRipper.Mining.PredefinedAssets;
+
+public enum AssetType
+{
+	/// <summary>
+	/// Used by a released game
+	/// </summary>
+	Internal = 0,
+	/// <summary>
+	/// Library asset file. It is editor created file, it doesn't exist in Assets directory
+	/// It has the format "library/cache/[first Hash byte as hex]/[Hash as hex]"
+	/// </summary>
+	Cached = 1,
+	/// <summary>
+	/// Serialized asset file. It contains all parameters inside itself.
+	/// </summary>
+	/// <remarks>
+	/// All yaml files use this type.
+	/// </remarks>
+	Serialized = 2,
+	/// <summary>
+	/// Binary asset file. It contains all parameters inside meta file.
+	/// </summary>
+	/// <remarks>
+	/// Any "universal" format uses this type. For example, png, jpg, tga, wav, ogg, fbx, cs, dll, shader, etc.
+	/// </remarks>
+	Meta = 3,
+}

AssetRipper.Mining.PredefinedAssets/AudioClip.cs

@@ -19,4 +19,16 @@ public sealed record class AudioClip : NamedObject
 	/// 5.0.0 to Max
 	/// </summary>
 	public required float Length { get; init; }
+
+	public AudioClip()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public AudioClip(string name, int channels, int frequency, float length) : base(name)
+	{
+		Channels = channels;
+		Frequency = frequency;
+		Length = length;
+	}
 }

AssetRipper.Mining.PredefinedAssets/Cubemap.cs

@@ -2,4 +2,12 @@
 
 public sealed record class Cubemap : Texture2D
 {
-}
+	public Cubemap()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public Cubemap(string name, int width, int height) : base(name, width, height)
+	{
+	}
+}

AssetRipper.Mining.PredefinedAssets/EngineResourceData.cs

@@ -4,6 +4,10 @@ namespace AssetRipper.Mining.PredefinedAssets;
 
 public readonly record struct EngineResourceData(Dictionary<long, Object> DefaultResources, Dictionary<long, Object> ExtraResources)
 {
+	public EngineResourceData() : this(new(), new())
+	{
+	}
+
 	public readonly string ToJson()
 	{
 		return JsonSerializer.Serialize(this, InternalSerializerContext.Default.EngineResourceData);

AssetRipper.Mining.PredefinedAssets/GenericNamedObject.cs

@@ -6,4 +6,24 @@ public sealed record class GenericNamedObject : NamedObject
 {
 	[JsonInclude]
 	public new required int TypeID { get; init; }
-}
+
+	public GenericNamedObject()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public GenericNamedObject(string name, int typeID) : base(name)
+	{
+		TypeID = typeID;
+	}
+
+	public static GenericNamedObject CreateComputeShader(string name)
+	{
+		return new(name, 72);
+	}
+
+	public static GenericNamedObject CreateFont(string name)
+	{
+		return new(name, 128);
+	}
+}

AssetRipper.Mining.PredefinedAssets/Material.cs

@@ -1,8 +1,16 @@
-using System.Text.Json.Serialization;
-
-namespace AssetRipper.Mining.PredefinedAssets;
+namespace AssetRipper.Mining.PredefinedAssets;
 
 public sealed record class Material : NamedObject
 {
 	public required string? Shader { get; init; }
+
+	public Material()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public Material(string name, string? shader) : base(name)
+	{
+		Shader = shader;
+	}
 }

AssetRipper.Mining.PredefinedAssets/Mesh.cs

@@ -2,5 +2,17 @@
 
 public sealed record class Mesh : NamedObject
 {
-	public required uint VertexCount { get; init; }
+	public required int VertexCount { get; init; }
+	public required int SubMeshCount { get; init; }
+
+	public Mesh()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public Mesh(string name, int vertexCount, int subMeshCount) : base(name)
+	{
+		VertexCount = vertexCount;
+		SubMeshCount = subMeshCount;
+	}
 }

AssetRipper.Mining.PredefinedAssets/MonoScript.cs

@@ -5,4 +5,21 @@ public sealed record class MonoScript : Object
 	public required string AssemblyName { get; init; }
 	public required string Namespace { get; init; }
 	public required string ClassName { get; init; }
+
+	public MonoScript()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public MonoScript(string assemblyName, string @namespace, string className)
+	{
+		AssemblyName = assemblyName;
+		Namespace = @namespace;
+		ClassName = className;
+	}
+
+	public static MonoScript FromType(Type type)
+	{
+		return new MonoScript(type.Assembly.GetName().Name, type.Namespace, type.Name);
+	}
 }

AssetRipper.Mining.PredefinedAssets/NamedObject.cs

@@ -3,4 +3,14 @@
 public abstract record class NamedObject : Object
 {
 	public required string Name { get; init; }
+
+	public NamedObject()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public NamedObject(string name)
+	{
+		Name = name;
+	}
 }

AssetRipper.Mining.PredefinedAssets/PPtr.cs

@@ -0,0 +1,13 @@
+using AssetRipper.Primitives;
+
+namespace AssetRipper.Mining.PredefinedAssets;
+
+/// <summary>
+/// A data structure representing a reference to an asset.
+/// </summary>
+/// <param name="FileID">The local identifier within the file.</param>
+/// <param name="Guid">The global identifier for the file.</param>
+/// <param name="Type">The type of file. </param>
+public readonly record struct PPtr(long FileID, UnityGuid Guid, AssetType Type)
+{
+}

AssetRipper.Mining.PredefinedAssets/Shader.cs

@@ -18,4 +18,14 @@ public sealed record class Shader : NamedObject
 	{
 		return HashCode.Combine(Name, PropertyNames.Length);
 	}
-}
+
+	public Shader()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public Shader(string name, string[] propertyNames) : base(name)
+	{
+		PropertyNames = propertyNames;
+	}
+}

AssetRipper.Mining.PredefinedAssets/Sprite.cs

@@ -3,4 +3,14 @@
 public sealed record class Sprite : NamedObject
 {
 	public required string? Texture { get; init; }
-}
+
+	public Sprite()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public Sprite(string name, string? texture) : base(name)
+	{
+		Texture = texture;
+	}
+}

AssetRipper.Mining.PredefinedAssets/TextAsset.cs

@@ -1,5 +1,4 @@
 using System.Buffers.Binary;
-using System.Diagnostics.CodeAnalysis;
 using System.Security.Cryptography;
 
 namespace AssetRipper.Mining.PredefinedAssets;

AssetRipper.Mining.PredefinedAssets/Texture2D.cs

@@ -4,4 +4,15 @@ public record class Texture2D : NamedObject
 {
 	public required int Width { get; init; }
 	public required int Height { get; init; }
+
+	public Texture2D()
+	{
+	}
+
+	[SetsRequiredMembers]
+	public Texture2D(string name, int width, int height) : base(name)
+	{
+		Width = width;
+		Height = height;
+	}
 }

AssetRipper.Mining.PredefinedAssets/UInt128.cs

@@ -2,7 +2,9 @@
 [assembly: System.Runtime.CompilerServices.TypeForwardedTo(typeof(UInt128))]
 #else
 using AssetRipper.Mining.PredefinedAssets;
+using System.Buffers;
 using System.Numerics;
+using System.Text;
 using System.Text.Json.Serialization;
 
 namespace System;
@@ -35,6 +37,15 @@ public readonly record struct UInt128
 		return TryParse(value, out UInt128 result) ? result : throw new FormatException("Input string was not in a correct format.");
 	}
 
+	internal static UInt128 Parse(ReadOnlySpan<byte> value)
+	{
+		byte[] rented = ArrayPool<byte>.Shared.Rent(value.Length);
+		value.CopyTo(rented);
+		UInt128 result = Parse(Encoding.ASCII.GetString(rented, 0, value.Length));
+		ArrayPool<byte>.Shared.Return(rented);
+		return result;
+	}
+
 	public static bool TryParse(string value, out UInt128 result)
 	{
 		if (BigInteger.TryParse(value, out BigInteger bigInteger))
@@ -57,8 +68,10 @@ public readonly record struct UInt128
 	private static UInt128 FromBigInteger(BigInteger value)
 	{
 		ulong upper = (ulong)(value >> 64);
-		ulong lower = (ulong)value;
+		ulong lower = (ulong)(value & LowerBitMask);
 		return new UInt128(upper, lower);
 	}
+
+	private static readonly BigInteger LowerBitMask = new BigInteger(ulong.MaxValue);
 }
-#endif
+#endif

AssetRipper.Mining.PredefinedAssets/UInt128JsonConverter.cs

@@ -8,7 +8,7 @@ public sealed class UInt128JsonConverter : JsonConverter<UInt128>
 {
 	public override UInt128 Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
 	{
-		return UInt128.Parse(reader.GetString() ?? throw new JsonException("String was read as null"));
+		return UInt128.Parse(reader.ValueSpan);
 	}
 
 	public override void Write(Utf8JsonWriter writer, UInt128 value, JsonSerializerOptions options)
@@ -16,4 +16,4 @@ public sealed class UInt128JsonConverter : JsonConverter<UInt128>
 		writer.WriteRawValue(value.ToString());
 	}
 }
-#endif
+#endif

AssetRipper.Mining.PredefinedAssets/UnityPackageData.cs

@@ -1,4 +1,5 @@
 using AssetRipper.Primitives;
+using System.Collections;
 using System.Text.Json;
 
 namespace AssetRipper.Mining.PredefinedAssets;
@@ -10,19 +11,25 @@ namespace AssetRipper.Mining.PredefinedAssets;
 /// File extensions are not included in any names.
 /// </remarks>
 /// <param name="Name">The name of this Unity package.</param>
-/// <param name="Version">The version of this Unity package. Only applicable if <paramref name="UsedInPackageJson"/> is true.</param>
+/// <param name="Version">The version or git url of this Unity package. Only applicable if <paramref name="UsedInPackageJson"/> is true.</param>
 /// <param name="UsedInPackageJson">If true, this Unity package should be referenced in the project's package json file.</param>
 /// <param name="Assemblies">A dictionary of compiled dll assemblies in the package.</param>
-/// <param name="Scripts">A dictionary of loose cs scripts in the package. Assembly name : { Full name : Guid }</param>
 /// <param name="Assets">A dictionary of assets in the package.</param>
 public readonly record struct UnityPackageData(
 	string Name,
-	Version Version,
+	string Version,
 	bool UsedInPackageJson,
 	Dictionary<string, UnityGuid> Assemblies,
-	Dictionary<string, Dictionary<string, UnityGuid>> Scripts,
-	KeyValuePair<Object, UnityGuid>[] Assets)
+	AssetDictionary Assets)
 {
+	public UnityPackageData(string name, string version, bool usedInPackageJson) : this(name, version, usedInPackageJson, new(), new())
+	{
+	}
+
+	public UnityPackageData(string name, string version = "") : this(name, version, string.IsNullOrEmpty(version))
+	{
+	}
+
 	public readonly string ToJson()
 	{
 		return JsonSerializer.Serialize(this, InternalSerializerContext.Default.UnityPackageData);
@@ -32,4 +39,4 @@ public readonly record struct UnityPackageData(
 	{
 		return JsonSerializer.Deserialize(text, InternalSerializerContext.Default.UnityPackageData);
 	}
-}
+}

AssetRipper.Mining.PredefinedAssets/Usings.cs

@@ -0,0 +1 @@
+global using System.Diagnostics.CodeAnalysis;

AssetRipper.Mining.Unity.Documentation.Web/AssetRipper.Mining.Unity.Documentation.Web.csproj

@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+	<PropertyGroup>
+		<OutputType>Exe</OutputType>
+		<TargetFramework>net7.0</TargetFramework>
+		<ImplicitUsings>enable</ImplicitUsings>
+		<Nullable>enable</Nullable>
+	</PropertyGroup>
+
+	<ItemGroup>
+		<PackageReference Include="System.Text.Json" Version="8.0.0-preview.6.23329.7" />
+	</ItemGroup>
+
+</Project>

AssetRipper.Mining.Unity.Documentation.Web/Program.cs

@@ -0,0 +1,6 @@
+using AssetRipper.Mining.Unity.Documentation.Web;
+
+TocNode root = TocNode.FromJsonFile(@"toc.json") ?? throw new NullReferenceException();
+Dictionary<string, string> dictionary = TocAnalyzer.Analyze(root);
+Dictionary<string, string> reverseDictionary = dictionary.OrderBy(pair => pair.Value).ToDictionary(pair => pair.Value, pair => pair.Key);
+_ = reverseDictionary;

AssetRipper.Mining.Unity.Documentation.Web/TocAnalyzer.cs

@@ -0,0 +1,69 @@
+using System.Diagnostics;
+
+namespace AssetRipper.Mining.Unity.Documentation.Web;
+public static class TocAnalyzer
+{
+	public static Dictionary<string, string> Analyze(TocNode root)
+	{
+		Debug.Assert(root.IsRoot);
+		Debug.Assert(root.HasChildren);
+
+		//Link : Full name
+		Dictionary<string, string> result = new();
+		Stack<(TocNode, int)> stack = new();
+		foreach (TocNode rootChild in root.Children)
+		{
+			if (rootChild.Title is "Other")
+			{
+				continue;
+			}
+			stack.Push((rootChild, -1));
+			while (stack.Count > 0)
+			{
+				(TocNode node, int childIndex) = stack.Pop();
+				if (childIndex == -1)
+				{
+					if (node.IsType)
+					{
+						string @namespace = GetNamespace(stack, result);
+						string fullName = $"{@namespace}.{node.Title}";
+						result.Add(node.Link, fullName);
+					}
+					if (node.HasChildren && !node.IsAssemblyCollection)
+					{
+						stack.Push((node, 0));
+					}
+				}
+				else if (childIndex < node.Children!.Length)
+				{
+					stack.Push((node, childIndex + 1));
+					stack.Push((node.Children[childIndex], -1));
+				}
+			}
+		}
+		return result;
+	}
+
+	private static string GetNamespace(Stack<(TocNode, int)> stack, Dictionary<string, string> dictionary)
+	{
+		foreach ((TocNode node, _) in stack)
+		{
+			if (node.IsNamespace)
+			{
+				return node.Title;
+			}
+			if (node.IsType)
+			{
+				return dictionary[node.Link];
+			}
+		}
+		if (stack.Count == 0)
+		{
+			throw new InvalidOperationException("The stack is empty.");
+		}
+		else
+		{
+			throw new InvalidOperationException("Could not determine the namespace from the stack.");
+		}
+	}
+}

AssetRipper.Mining.Unity.Documentation.Web/TocNode.cs

@@ -0,0 +1,73 @@
+using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace AssetRipper.Mining.Unity.Documentation.Web;
+
+[DebuggerDisplay($"{{{nameof(GetDebuggerDisplay)}(),nq}}")]
+public sealed class TocNode
+{
+	private const string TOC = "toc";
+	private const string Classes = "Classes";
+	private const string Interfaces = "Interfaces";
+	private const string Enumerations = "Enumerations";
+	private const string Attributes = "Attributes";
+	private const string Assemblies = "Assemblies";
+	private string? link;
+
+	[JsonPropertyName("link")]
+	public required string? Link
+	{
+		get => link;
+		init
+		{
+			link = value is "null" ? null : value;
+		}
+	}
+
+	[JsonPropertyName("title")]
+	public required string Title { get; init; }
+
+	[JsonPropertyName("children")]
+	public required TocNode[]? Children { get; init; }
+
+	[JsonIgnore]
+	[MemberNotNullWhen(true, nameof(Link))]
+	public bool IsRoot => Link is TOC && Title is TOC;
+
+	[JsonIgnore]
+	[MemberNotNullWhen(true, nameof(Link))]
+	public bool IsType => Link is not null and not TOC;
+
+	[JsonIgnore]
+	[MemberNotNullWhen(false, nameof(Link))]
+	public bool IsTypeCollection => Link is null && Title is Classes or Interfaces or Enumerations or Attributes;
+
+	[JsonIgnore]
+	[MemberNotNullWhen(false, nameof(Link))]
+	public bool IsAssemblyCollection => Link is null && Title is Assemblies;
+
+	[JsonIgnore]
+	[MemberNotNullWhen(false, nameof(Link))]
+	public bool IsNamespace => Link is null && Title is not Classes and not Interfaces and not Enumerations and not Attributes and not Assemblies;
+
+	[JsonIgnore]
+	[MemberNotNullWhen(true, nameof(Children))]
+	public bool HasChildren => Children is not null && Children.Length > 0;
+
+	public static TocNode? FromJsonText(string json)
+	{
+		return JsonSerializer.Deserialize(json, TocSerializerContext.Default.TocNode);
+	}
+
+	public static TocNode? FromJsonFile(string path)
+	{
+		return JsonSerializer.Deserialize(File.OpenRead(path), TocSerializerContext.Default.TocNode);
+	}
+
+	private string GetDebuggerDisplay()
+	{
+		return Title;
+	}
+}

AssetRipper.Mining.Unity.Documentation.Web/TocSerializerContext.cs

@@ -0,0 +1,9 @@
+using System.Text.Json.Serialization;
+
+namespace AssetRipper.Mining.Unity.Documentation.Web;
+
+[JsonSourceGenerationOptions(GenerationMode = JsonSourceGenerationMode.Metadata)]
+[JsonSerializable(typeof(TocNode))]
+internal partial class TocSerializerContext : JsonSerializerContext
+{
+}