import dev.simplified.reflection.Reflection;
import dev.simplified.reflection.accessor.FieldAccessor;
import dev.simplified.reflection.accessor.MethodAccessor;

// Create a reflection instance (results are cached per class)
Reflection<MyClass> reflection = new Reflection<>(MyClass.class);

// Access fields by name or type
FieldAccessor<String> nameField = reflection.getField("name");
String value = nameField.get(instance);
nameField.set(instance, "new value");

// Access methods
MethodAccessor<String> getter = reflection.getMethod("getName");
String name = getter.invoke(instance);

// Construct new instances
MyClass obj = reflection.newInstance("arg1", 42);

// Walk superclass chain (enabled by default)
ConcurrentSet<FieldAccessor<?>> allFields = reflection.getFields();

// Or restrict to declared fields only
reflection.setProcessingSuperclass(false);
ConcurrentSet<FieldAccessor<?>> declaredOnly = reflection.getFields();

// Given: class UserClient extends Client<UserApi>
Class<UserApi> apiType = Reflection.getSuperClass(userClient);

// Resolve the Nth type argument
Class<?> secondArg = Reflection.getSuperClass(SomeClass.class, 1);

import dev.simplified.reflection.accessor.ResourceAccessor;

// Scan the default classloader
ResourceAccessor resources = Reflection.getResources();

// Filter to a specific package
ResourceAccessor filtered = resources.filterPackage(MyApp.class);

// Find all implementations of an interface
ConcurrentList<Class<? extends Plugin>> plugins = filtered.getSubtypesOf(Plugin.class);

// Find all assignable types (including the type itself)
ConcurrentList<Class<JpaModel>> models = filtered.getTypesOf(JpaModel.class);

import dev.simplified.reflection.builder.BuildFlag;
import dev.simplified.reflection.Reflection;

public class Config {

    public static class Builder {

        @BuildFlag(nonNull = true)
        private String host;

        @BuildFlag(notEmpty = true)
        private List<String> endpoints;

        @BuildFlag(pattern = "^[a-z]+$")
        private String name;

        @BuildFlag(limit = 100)
        private String description;

        @BuildFlag(nonNull = true, group = "auth")
        private String apiKey;

        @BuildFlag(nonNull = true, group = "auth")
        private String token;  // mutually exclusive with apiKey

        public Config build() {
            Reflection.validateFlags(this);  // validates all @BuildFlag constraints
            return new Config(this);
        }
    }
}

import dev.simplified.reflection.diagram.DiagramConfig;

DiagramConfig config = DiagramConfig.builder()
    .withScanPackage(MyApp.class)
    .withRoots(BaseInterface.class)
    .withFileName("hierarchy")
    .withSuffix("Impl")           // strip suffix from displayed names
    .build();

TypeHierarchyDiagram diagram = config.render();
diagram.writeTo(Path.of("docs"));  // writes SVG to docs/doc-files/hierarchy.svg