binary_asset_blobs.h

Go to the documentation of this file.

// Copyright (C) 2026 Douglas Quigg (dstroy0) <dquigg123@gmail.com>
// SPDX-License-Identifier: AGPL-3.0-or-later
//
// GENERATED by src/web_assets/wizard/gen_theme_blobs.py - DO NOT EDIT BY HAND.
// Add or edit a theme under src/web_assets/themes/ and re-run the generator.
 
#ifndef PROTOCORE_BINARY_ASSET_BLOBS_H
#define PROTOCORE_BINARY_ASSET_BLOBS_H
 
#include "protocore_config.h" // the entry point: protocore_types.h for the widths
 
PROTOCORE_BEGIN_DECLS
 
/**
 * @file binary_asset_blobs.h
 * @brief Layer 7 - toggleable embedded theme stylesheets (PROTOCORE_ENABLE_THEMES).
 *
 * A registry of minified CSS themes in flash (DROM), for serving/switching a theme at runtime.
 * Behind PROTOCORE_ENABLE_THEMES so a build that does not want it links nothing.
 *
 * @c work is bytes the CALLER holds. This module reads none of them: it carries nothing
 * between calls, so there is no state to keep and nothing to wipe. The parameter is there so
 * a caller drives every namespace the same way.
 */
 
/** @brief One embedded theme: its name and its minified CSS (NUL-terminated flash string). */
typedef struct
{
    const char *name;
    const char *css;
} protocore_theme_blob;
 
/** @brief The embedded theme registry (sorted by name) and its count. */
extern const protocore_theme_blob PROTOCORE_THEME_BLOBS[];
 
extern const size_t PROTOCORE_THEME_BLOB_COUNT;
 
/** @brief Dispatch table. Addressed by offset, so the layout is asserted below. */
typedef struct
{
    const char *(*css)(uint8_t *, const char *);
} BinaryAssetBlobsNs;
PROTOCORE_NS_LAYOUT(BinaryAssetBlobsNs, css);
 
/**
 * @brief Look up a theme's CSS by name (exact match).
 * @param work Bytes the caller holds. Not read.
 * @param name The theme name, NUL-terminated.
 * @return The NUL-terminated minified CSS, or NULL where no theme by that name is embedded.
 */
const char *protocore_binary_asset_blobs_css(uint8_t *work, const char *name);
 
/** @brief Module namespace. */
PROTOCORE_NS BinaryAssetBlobsNs BinaryAssetBlobs PROTOCORE_UNUSED = {.css = protocore_binary_asset_blobs_css};
 
PROTOCORE_END_DECLS
 
#endif // PROTOCORE_BINARY_ASSET_BLOBS_H