design_export.hpp

Go to the documentation of this file.

#pragma once

 
#include <pulp/view/theme.hpp>
#include <string>
#include <unordered_map>
 
namespace pulp::view {

class DesignExport {
public:
    static std::string to_json(const Theme& theme);

    static std::string to_css(const Theme& theme, const std::string& prefix = "pulp");

    static std::string to_cpp_header(const Theme& theme, const std::string& namespace_name);

    static std::string to_oklch_css(const Theme& theme, const std::string& prefix = "pulp");

    static std::string to_wgsl_uniforms(const Theme& theme, const std::string& struct_name = "ThemeUniforms");
};
 
// ── DESIGN.md emitter ─────────────────────────────────────────────────────
//
// `export_designmd` is the shared write path for serializing a Theme back into
// a DESIGN.md-shaped document:
//
//   1. `pulp import-design --from <source> --update-design-md` — merges
//      an external re-import (Figma / Stitch / v0 / Pencil / Claude)
//      into the project's DESIGN.md instead of overwriting tokens.json.
//      Round-trip semantic — preserves prose sections and comment
//      placement from the prose_hints argument.
//   2. `pulp design` on save — captures the live editor's Theme state
//      back into DESIGN.md.
//
// This API is intentionally gated until anchor-stable IDs and 3-way merge
// semantics are available. Until then, the function below throws a
// reimport-safe design-loop gate error instead of writing partial output.
 
struct DesignMdProseHints {
    // Optional verbatim prose for each canonical section (Overview,
    // Colors, Typography, Layout, Elevation & Depth, Shapes, Components,
    // Do's and Don'ts). Unset keys produce auto-generated stub prose.
    std::unordered_map<std::string, std::string> section_bodies;
    // Optional name override; defaults to the theme's existing "name"
    // string token if present.
    std::string name_override;
};

std::string export_designmd(const Theme& theme,
                             const DesignMdProseHints& hints = {});
 
} // namespace pulp::view