js_gui.h

#include "../../js_modules.h"
#include <gui/view.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum {
    JsViewPropTypeString,
    JsViewPropTypeNumber,
    JsViewPropTypeArr,
    JsViewPropTypeTypedArr,
    JsViewPropTypeBool,
} JsViewPropType;
 
typedef union {
    const char* string;
    int32_t number;
    bool boolean;
    mjs_val_t term;
} JsViewPropValue;
 
typedef bool (
    *JsViewPropAssign)(struct mjs* mjs, void* specific_view, JsViewPropValue value, void* context);
 
typedef struct {
    const char* name; //<! Property name, as visible from JS
    JsViewPropType type; // <! Property type, ensured by the GUI module
    JsViewPropAssign assign; // <! Property assignment callback
} JsViewPropDescriptor;
 
// View method signatures
 
typedef void* (*JsViewAlloc)(void);
typedef View* (*JsViewGetView)(void* specific_view);
typedef void (*JsViewFree)(void* specific_view);
 
// Glue code method signatures
 
typedef void* (*JsViewCustomMake)(struct mjs* mjs, void* specific_view, mjs_val_t view_obj);
typedef void (*JsViewCustomDestroy)(void* specific_view, void* custom_state, FuriEventLoop* loop);
 
typedef struct {
    JsViewAlloc alloc;
    JsViewGetView get_view;
    JsViewFree free;
    JsViewCustomMake custom_make; // <! May be NULL
    JsViewCustomDestroy custom_destroy; // <! May be NULL
    size_t prop_cnt; //<! Number of properties visible from JS
    JsViewPropDescriptor props[]; // <! Descriptors of properties visible from JS
} JsViewDescriptor;
 
// Callback ordering:
// alloc -> get_view -> [custom_make (if set)] -> props[i].assign -> [custom_destroy (if_set)] -> free
// \_______________ creation ________________/    \___ usage ___/    \_________ destruction _________/
 
mjs_val_t js_gui_make_view_factory(struct mjs* mjs, const JsViewDescriptor* view_descriptor);
 
#define JS_GUI_VIEW_DEF(name, descriptor)                                                \
    static void* view_mod_ctor(struct mjs* mjs, mjs_val_t* object, JsModules* modules) { \
        UNUSED(modules);                                                                 \
        *object = js_gui_make_view_factory(mjs, descriptor);                             \
        return NULL;                                                                     \
    }                                                                                    \
    static const JsModuleDescriptor js_mod_desc = {                                      \
        "gui__" #name,                                                                   \
        view_mod_ctor,                                                                   \
        NULL,                                                                            \
        NULL,                                                                            \
    };                                                                                   \
    static const FlipperAppPluginDescriptor plugin_descriptor = {                        \
        .appid = PLUGIN_APP_ID,                                                          \
        .ep_api_version = PLUGIN_API_VERSION,                                            \
        .entry_point = &js_mod_desc,                                                     \
    };                                                                                   \
    const FlipperAppPluginDescriptor* js_view_##name##_ep(void) {                        \
        return &plugin_descriptor;                                                       \
    }
 
#ifdef __cplusplus
}
#endif