design_codegen.hpp

Go to the documentation of this file.

#pragma once

 
#include <pulp/view/design_ir.hpp>
#include <pulp/view/design_shortcuts.hpp>  // DetectedShortcut (CodeGenOptions::shortcuts)
#include <pulp/view/design_fidelity.hpp>   // FidelityIssue + run_fidelity_checks (sink)
#include <optional>
#include <string>
#include <vector>
 
namespace pulp::view {
 
// ── Code generator ──────────────────────────────────────────────────────

enum class CodeGenMode {
    web_compat,        // document.createElement + el.style (web-compat layer)
    bridge_native_js,  // JS that calls createCol/createRow/createKnob + setFlex
                       // through the native widget bridge; not direct C++.
    native
        [[deprecated("Use CodeGenMode::bridge_native_js; CodeGenMode::native emits bridge JS, not direct C++.")]]
        = bridge_native_js
};

struct CodeGenOptions {
    CodeGenMode mode = CodeGenMode::bridge_native_js;  // Native-bridge JS by default (better Yoga compat)
    bool include_tokens = true;       // Generate token assignments
    bool include_comments = true;     // Generate inline comments
    bool preview_mode = false;        // Use minimal widget style (design preview)
    std::string root_variable = "root";
    int indent_spaces = 2;

    bool use_silver_knobs = true;

    bool skin_faders = true;
    bool skin_meters = true;

    std::vector<DetectedShortcut> shortcuts;

    std::vector<FidelityIssue>* fidelity_report = nullptr;
};

std::string generate_pulp_js(const DesignIR& ir, const CodeGenOptions& opts = {});
 
struct CppExportOptions {
    std::string function_name = "build_imported_ui";
    std::string namespace_name;
    std::string header_filename = "imported_ui.hpp";
    std::string binding_function_name = "bind_imported_ui";
    bool include_comments = true;
    bool emit_named_tokens = true;
    bool emit_asset_constants = true;
    bool extract_named_components = true;
    bool emit_binding_context_helpers = true;
    int indent_spaces = 4;

    std::vector<FidelityIssue>* fidelity_report = nullptr;
};
 
struct CppExportResult {
    std::string header;
    std::string source;
    std::string binding_manifest;
};

CppExportResult generate_pulp_cpp(const DesignIR& ir,
                                  const IRAssetManifest& manifest,
                                  const CppExportOptions& opts = {});
 
// ── Baked SwiftUI code generation ───────────────────────────────────────
//
// `--emit swiftui` lowers the same baked DesignIR to native SwiftUI — a
// fourth lowering alongside DOM/native-JS/baked-C++. Baked-only: SwiftUI is a
// compiled declarative target with no Pulp JS-runtime story. The current
// emitter covers stacks / Text / fixed frame-padding-background /
// knob+slider+toggle + a code-first PulpTheme partition + a minimal
// name-keyed binding.
 
struct SwiftExportOptions {
    std::string root_view_name = "ImportedPulpView";
    std::string theme_type_name = "PulpTheme";
    bool include_comments = true;
    bool emit_theme = true;            
    bool emit_binding_manifest = true; 
    int indent_spaces = 4;
    std::vector<FidelityIssue>* fidelity_report = nullptr;
};
 
struct SwiftExportResult {
    std::string view_source;       
    std::string theme_source;      
    std::string binding_manifest;  
};

SwiftExportResult generate_pulp_swift(const DesignIR& ir,
                                      const IRAssetManifest& manifest,
                                      const SwiftExportOptions& opts = {});
 
// ── Shortcut helpers (V2 — used by both the generator and any test/
//    runtime caller that needs to map DetectedShortcut → registerShortcut
//    args). String forms come from `extract_keyboard_shortcuts`; integer
//    forms feed `registerShortcut(key, modifiers, callback)` and the
//    runtime KeyCode enum.

int key_string_to_keycode(const std::string& key);

int modifier_strings_to_mask(const std::vector<std::string>& mods);
 
} // namespace pulp::view