design_variants.hpp

Go to the documentation of this file.

#pragma once
 
// pulp::design — variant sets -> typed parameterized component contract.
//
// A design-tool component set (a Figma variant set, or the equivalent in a
// decoded `.fig`) names each member with a `Prop=Value` string, e.g.
// "Size=Large, State=Hover". Imported naively that is N frozen frames. This
// translation unit collapses the set into one *typed* component contract: each
// property with its observed value enum and a chosen default. That contract is
// the supply side R1's manifest and R2's adherence lint consume — a widget the
// importer can bind to by prop, instead of a wall of one-off frames.
//
// It is pure and deterministic: it takes the variant *names* (which both intake
// lanes already produce) and computes the prop model. Resolving per-variant
// style deltas from instance overrides needs the decoded node geometry and is
// deliberately out of scope here — this layer models well-formed variant sets
// first and emits named issues for anything it could not cleanly collapse, so a
// downstream fidelity ledger (design_fidelity_ledger) can report what was baked.
 
#include <string>
#include <string_view>
#include <vector>
 
namespace pulp::design {

inline constexpr std::string_view kVariantContractVersion = "2026.07-variant-contract-v1";

struct VariantProperty {
    std::string name;
    std::string value;
};

std::vector<VariantProperty> parse_variant_name(std::string_view name);

struct ContractProp {
    std::string name;
    std::vector<std::string> values;  
    std::string default_value;        
};

struct VariantIssue {
    std::string kind;
    std::string detail;
};

struct ComponentContract {
    std::string format_version;         
    std::string component;              
    std::vector<ContractProp> props;    
    int variant_count = 0;
    std::vector<VariantIssue> issues;   
};

ComponentContract build_component_contract(std::string_view component,
                                           const std::vector<std::string>& variant_names);

std::string component_contract_json(const ComponentContract& contract);
 
}  // namespace pulp::design