token_lock.hpp

Go to the documentation of this file.

#pragma once

 
#include <optional>
#include <string>
#include <vector>
 
namespace pulp::view {
 
// ── Token classification ────────────────────────────────────────────────
//
// Not every inspector tweak is a token. A one-off element edit ("make
// THIS knob 4px wider") is an element tweak handled by the source-locking
// paths.
// A token tweak edits a value the *whole design system* shares.
//
// Two signals classify a tweak as token-typed, in priority order:
//   1. Anchor convention. Token tweaks carry an anchor of the form
//      `designtoken:<group>.<name>` (e.g. `designtoken:colors.primary`).
//      The inspector stamps this anchor when the selected property is
//      backed by a resolved design token rather than a literal.
//   2. Property-path convention. A dotted path whose first segment is a
//      canonical DESIGN.md token group (`colors`, `spacing`, `rounded`,
//      `typography`) is treated as a token path even without the anchor
//      prefix — this lets the CLI and tests address tokens directly.
//
// Element-only paths (`paint.*`, `layout.*`, `text.*`) never classify as
// tokens; `classify_token_tweak` returns std::nullopt for them.

enum class TokenGroup {
    colors,      
    spacing,     
    rounded,     
    typography,  
};

const char* token_group_key(TokenGroup group);

struct TokenTarget {
    TokenGroup group;
    std::string name;
    std::string field;
};

std::optional<TokenTarget> classify_token_tweak(const std::string& anchor_id,
                                                 const std::string& property_path);
 
// ── Lock result ─────────────────────────────────────────────────────────

struct TokenLockResult {
    bool ok = false;
    std::string error;
    std::string updated_markdown;
    std::string previous_value;
    int line = 0;
};

TokenLockResult lock_token_in_designmd(const std::string& markdown,
                                        const TokenTarget& target,
                                        const std::string& new_value);

TokenLockResult lock_token_in_designmd(const std::string& markdown,
                                        const std::string& anchor_id,
                                        const std::string& property_path,
                                        const std::string& new_value);
 
}  // namespace pulp::view