descriptors.hpp

Go to the documentation of this file.

// AI Generated 2026 Ryan P. Nicholl  <rnicholl@protonmail.com>
// SPDX-License-Identifier: Apache-2.0

 
#ifndef RPNX_CORTADO_DESCRIPTORS_HPP
#define RPNX_CORTADO_DESCRIPTORS_HPP
 
#include <cstddef>
#include <cstdint>
#include <rpnx/macros.hpp>
#include <rpnx/variant.hpp>
#include <string>
#include <string_view>
#include <vector>
 
namespace rpnx::cortado
{
    enum class primitive_descriptor_kind : std::uint8_t { byte = 'B', character = 'C', double_precision = 'D', floating_point = 'F', integer = 'I', long_integer = 'J', short_integer = 'S', boolean = 'Z' };

    struct primitive_type_descriptor
    {
        primitive_descriptor_kind kind{primitive_descriptor_kind::integer}; 
        RPNX_MEMBER_METADATA(primitive_type_descriptor, kind);
    };

    struct object_type_descriptor
    {
        std::string internal_name; 
        RPNX_MEMBER_METADATA(object_type_descriptor, internal_name);
    };
 
    struct array_type_descriptor;

    using field_type_descriptor = rpnx::variant< primitive_type_descriptor, object_type_descriptor, array_type_descriptor >;

    struct array_type_descriptor
    {
        field_type_descriptor component; 
        RPNX_MEMBER_METADATA(array_type_descriptor, component);
    };

    struct void_type_descriptor
    {
        RPNX_EMPTY_METADATA(void_type_descriptor);
    };

    using return_type_descriptor = rpnx::variant< void_type_descriptor, field_type_descriptor >;

    struct method_descriptor
    {
        std::vector< field_type_descriptor > parameters; 
        return_type_descriptor return_type; 
        RPNX_MEMBER_METADATA(method_descriptor, parameters, return_type);
    };

    [[nodiscard]] field_type_descriptor parse_field_descriptor(std::string_view text);

    [[nodiscard]] method_descriptor parse_method_descriptor(std::string_view text);

    [[nodiscard]] std::string serialize_field_descriptor(field_type_descriptor const& descriptor);

    [[nodiscard]] std::string serialize_method_descriptor(method_descriptor const& descriptor);

    [[nodiscard]] std::size_t descriptor_slot_count(field_type_descriptor const& descriptor) noexcept;
} // namespace rpnx::cortado
 
#endif // RPNX_CORTADO_DESCRIPTORS_HPP