lock_to_source.hpp

Go to the documentation of this file.

#pragma once

 
#include <pulp/view/design_import.hpp>
 
#include <optional>
#include <string>
#include <vector>
 
namespace pulp::view {

struct LockToSourceTweak {
    std::string anchor_id;
    std::string property_path;
    std::string value;
};

enum class LockStatus {
    rewritten,
    inserted,
    already_current,
    anchor_not_found,
    unsupported_property,
};

struct LockResult {
    LockStatus status = LockStatus::anchor_not_found;
    std::string source;
    std::string style_property;
    std::string message;
    int line = 0;

    bool mutated() const {
        return status == LockStatus::rewritten || status == LockStatus::inserted;
    }

    bool ok() const {
        return status == LockStatus::rewritten ||
               status == LockStatus::inserted ||
               status == LockStatus::already_current;
    }
};

std::optional<std::string>
lock_property_to_style_name(const std::string& property_path);

LockResult lock_tweak_into_source(const std::string& source,
                                  const LockToSourceTweak& tweak);

std::vector<LockResult>
lock_tweaks_into_source(const std::string& source,
                        const std::vector<LockToSourceTweak>& tweaks);
 
// ── Structural reparent lock-to-source ───────────────────────────────────────
//
// A reflow-aware drag can "drop element A inside container B" — a STRUCTURAL
// tree edit, not a style tweak. In the generated web-compat artifact every
// element block ends with `<parentVar>.appendChild(<var>);` wiring it to its
// parent. Reparenting therefore means rewriting the dragged element's
// `appendChild` receiver from its old parent's var to the NEW parent's var.
//
// This is the structural sibling of lock_tweak_into_source(): it is a pure
// text-in/text-out rewrite over the same anchor-comment block model. It does
// NOT (yet) move the element block's TEXT to sit physically inside the new
// parent's block — the appendChild receiver rewrite is what changes the live
// DOM parent, and re-running the element block in source order still produces
// the reparented tree because createElement + appendChild are order-independent
// once the receiver is correct. Reordering the physical block position to match
// remains a separate formatting pass.

struct ReparentToSourceEdit {
    std::string child_anchor_id;
    std::string new_parent_anchor_id;
    std::string insert_after_anchor_id;  // preceding sibling, or "" = first child
};

LockResult reparent_in_source(const std::string& source,
                              const ReparentToSourceEdit& edit);

bool is_generated_source(const std::string& source);
 
}  // namespace pulp::view