Add source code and tests

Author: Mike Blair

src/FractalDataWorks.CodeBuilder.Abstractions/FractalDataWorks.CodeBuilder.Abstractions.csproj

@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>netstandard2.0</TargetFramework>
+    <ImplicitUsings>disable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <LangVersion>latest</LangVersion>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\FractalDataWorks.Net\FractalDataWorks.net.csproj" />
+  </ItemGroup>
+
+</Project>

src/FractalDataWorks.CodeBuilder.Abstractions/IClassBuilder.cs

@@ -0,0 +1,140 @@
+using System;
+using System.Collections.Generic;
+
+namespace FractalDataWorks.CodeBuilder.Abstractions;
+
+/// <summary>
+/// Builder interface for generating class definitions.
+/// </summary>
+public interface IClassBuilder : ICodeBuilder
+{
+    /// <summary>
+    /// Sets the namespace for the class.
+    /// </summary>
+    /// <param name="namespaceName">The namespace name.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithNamespace(string namespaceName);
+
+    /// <summary>
+    /// Adds using directives.
+    /// </summary>
+    /// <param name="usings">The using directives to add.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithUsings(params string[] usings);
+
+    /// <summary>
+    /// Sets the class name.
+    /// </summary>
+    /// <param name="className">The class name.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithName(string className);
+
+    /// <summary>
+    /// Sets the access modifier for the class.
+    /// </summary>
+    /// <param name="accessModifier">The access modifier (public, internal, etc.).</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithAccessModifier(string accessModifier);
+
+    /// <summary>
+    /// Makes the class static.
+    /// </summary>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder AsStatic();
+
+    /// <summary>
+    /// Makes the class abstract.
+    /// </summary>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder AsAbstract();
+
+    /// <summary>
+    /// Makes the class sealed.
+    /// </summary>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder AsSealed();
+
+    /// <summary>
+    /// Makes the class partial.
+    /// </summary>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder AsPartial();
+
+    /// <summary>
+    /// Sets the base class.
+    /// </summary>
+    /// <param name="baseClass">The base class name.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithBaseClass(string baseClass);
+
+    /// <summary>
+    /// Adds interfaces that the class implements.
+    /// </summary>
+    /// <param name="interfaces">The interface names.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithInterfaces(params string[] interfaces);
+
+    /// <summary>
+    /// Adds generic type parameters.
+    /// </summary>
+    /// <param name="typeParameters">The type parameter names.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithGenericParameters(params string[] typeParameters);
+
+    /// <summary>
+    /// Adds generic type constraints.
+    /// </summary>
+    /// <param name="typeParameter">The type parameter to constrain.</param>
+    /// <param name="constraints">The constraints.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithGenericConstraint(string typeParameter, params string[] constraints);
+
+    /// <summary>
+    /// Adds an attribute to the class.
+    /// </summary>
+    /// <param name="attribute">The attribute code.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithAttribute(string attribute);
+
+    /// <summary>
+    /// Adds a field to the class.
+    /// </summary>
+    /// <param name="fieldBuilder">The field builder.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithField(IFieldBuilder fieldBuilder);
+
+    /// <summary>
+    /// Adds a property to the class.
+    /// </summary>
+    /// <param name="propertyBuilder">The property builder.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithProperty(IPropertyBuilder propertyBuilder);
+
+    /// <summary>
+    /// Adds a method to the class.
+    /// </summary>
+    /// <param name="methodBuilder">The method builder.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithMethod(IMethodBuilder methodBuilder);
+
+    /// <summary>
+    /// Adds a constructor to the class.
+    /// </summary>
+    /// <param name="constructorBuilder">The constructor builder.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithConstructor(IConstructorBuilder constructorBuilder);
+
+    /// <summary>
+    /// Adds a nested class.
+    /// </summary>
+    /// <param name="nestedClassBuilder">The nested class builder.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithNestedClass(IClassBuilder nestedClassBuilder);
+
+    /// <summary>
+    /// Adds XML documentation comments.
+    /// </summary>
+    /// <param name="summary">The summary text.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IClassBuilder WithXmlDoc(string summary);
+}

src/FractalDataWorks.CodeBuilder.Abstractions/ICodeBuilder.cs

@@ -0,0 +1,25 @@
+using System;
+
+namespace FractalDataWorks.CodeBuilder.Abstractions;
+
+/// <summary>
+/// Base interface for code builders that generate source code.
+/// </summary>
+public interface ICodeBuilder
+{
+    /// <summary>
+    /// Builds the code and returns it as a string.
+    /// </summary>
+    /// <returns>The generated code.</returns>
+    string Build();
+
+    /// <summary>
+    /// Gets the current indentation level.
+    /// </summary>
+    int IndentLevel { get; }
+
+    /// <summary>
+    /// Gets or sets the indentation string (default is 4 spaces).
+    /// </summary>
+    string IndentString { get; set; }
+}

src/FractalDataWorks.CodeBuilder.Abstractions/ICodeGenerator.cs

@@ -0,0 +1,49 @@
+using System.Collections.Generic;
+
+namespace FractalDataWorks.CodeBuilder.Abstractions;
+
+/// <summary>
+/// Interface for code generators that transform syntax trees or definitions into source code.
+/// </summary>
+public interface ICodeGenerator
+{
+    /// <summary>
+    /// Gets the target language for this generator.
+    /// </summary>
+    string TargetLanguage { get; }
+
+    /// <summary>
+    /// Generates code from a syntax tree.
+    /// </summary>
+    /// <param name="syntaxTree">The syntax tree to generate from.</param>
+    /// <returns>The generated source code.</returns>
+    string Generate(ISyntaxTree syntaxTree);
+
+    /// <summary>
+    /// Generates code from a class builder.
+    /// </summary>
+    /// <param name="classBuilder">The class builder.</param>
+    /// <returns>The generated source code.</returns>
+    string Generate(IClassBuilder classBuilder);
+
+    /// <summary>
+    /// Generates code from an interface builder.
+    /// </summary>
+    /// <param name="interfaceBuilder">The interface builder.</param>
+    /// <returns>The generated source code.</returns>
+    string Generate(IInterfaceBuilder interfaceBuilder);
+
+    /// <summary>
+    /// Generates code from an enum builder.
+    /// </summary>
+    /// <param name="enumBuilder">The enum builder.</param>
+    /// <returns>The generated source code.</returns>
+    string Generate(IEnumBuilder enumBuilder);
+
+    /// <summary>
+    /// Generates a compilation unit with multiple types.
+    /// </summary>
+    /// <param name="builders">The builders for the types to include.</param>
+    /// <returns>The generated source code.</returns>
+    string GenerateCompilationUnit(IEnumerable<ICodeBuilder> builders);
+}

src/FractalDataWorks.CodeBuilder.Abstractions/ICodeParser.cs

@@ -0,0 +1,38 @@
+using System.Threading;
+using System.Threading.Tasks;
+using FractalDataWorks;
+
+namespace FractalDataWorks.CodeBuilder.Abstractions;
+
+/// <summary>
+/// Defines a parser that can convert source code into a syntax tree.
+/// </summary>
+public interface ICodeParser
+{
+    /// <summary>
+    /// Gets the language this parser supports.
+    /// </summary>
+    string Language { get; }
+
+    /// <summary>
+    /// Parses the source code into a syntax tree.
+    /// </summary>
+    /// <param name="sourceCode">The source code to parse.</param>
+    /// <param name="filePath">Optional file path for context.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>Result containing the syntax tree or error information.</returns>
+    Task<IFdwResult<ISyntaxTree>> ParseAsync(
+        string sourceCode,
+        string? filePath = null,
+        CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Validates the source code without building a full syntax tree.
+    /// </summary>
+    /// <param name="sourceCode">The source code to validate.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>Result indicating whether the code is valid.</returns>
+    Task<IFdwResult> ValidateAsync(
+        string sourceCode,
+        CancellationToken cancellationToken = default);
+}

src/FractalDataWorks.CodeBuilder.Abstractions/IConstructorBuilder.cs

@@ -0,0 +1,81 @@
+using System;
+
+namespace FractalDataWorks.CodeBuilder.Abstractions;
+
+/// <summary>
+/// Builder interface for generating constructor definitions.
+/// </summary>
+public interface IConstructorBuilder : ICodeBuilder
+{
+    /// <summary>
+    /// Sets the access modifier.
+    /// </summary>
+    /// <param name="accessModifier">The access modifier.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder WithAccessModifier(string accessModifier);
+
+    /// <summary>
+    /// Makes the constructor static.
+    /// </summary>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder AsStatic();
+
+    /// <summary>
+    /// Adds a parameter to the constructor.
+    /// </summary>
+    /// <param name="type">The parameter type.</param>
+    /// <param name="name">The parameter name.</param>
+    /// <param name="defaultValue">Optional default value.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder WithParameter(string type, string name, string? defaultValue = null);
+
+    /// <summary>
+    /// Adds a base constructor call.
+    /// </summary>
+    /// <param name="arguments">The arguments to pass to the base constructor.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder WithBaseCall(params string[] arguments);
+
+    /// <summary>
+    /// Adds a this constructor call.
+    /// </summary>
+    /// <param name="arguments">The arguments to pass to the this constructor.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder WithThisCall(params string[] arguments);
+
+    /// <summary>
+    /// Adds an attribute to the constructor.
+    /// </summary>
+    /// <param name="attribute">The attribute code.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder WithAttribute(string attribute);
+
+    /// <summary>
+    /// Sets the constructor body.
+    /// </summary>
+    /// <param name="body">The constructor body code.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder WithBody(string body);
+
+    /// <summary>
+    /// Adds a line to the constructor body.
+    /// </summary>
+    /// <param name="line">The line of code to add.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder AddBodyLine(string line);
+
+    /// <summary>
+    /// Adds XML documentation comments.
+    /// </summary>
+    /// <param name="summary">The summary text.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder WithXmlDoc(string summary);
+
+    /// <summary>
+    /// Adds XML documentation for a parameter.
+    /// </summary>
+    /// <param name="parameterName">The parameter name.</param>
+    /// <param name="description">The parameter description.</param>
+    /// <returns>The builder for method chaining.</returns>
+    IConstructorBuilder WithParamDoc(string parameterName, string description);
+}