@lynx-js/lynx-library-headers 0.0.1-alpha.4

package/include/lynx/platform/embedder/public/capi/lynx_trace_capi.h

@@ -0,0 +1,62 @@
+// Copyright 2025 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+
+#ifndef PLATFORM_EMBEDDER_PUBLIC_CAPI_LYNX_TRACE_CAPI_H_
+#define PLATFORM_EMBEDDER_PUBLIC_CAPI_LYNX_TRACE_CAPI_H_
+
+#include <stdint.h>
+
+#include "lynx_export.h"
+
+LYNX_EXTERN_C_BEGIN
+
+// [Internal] Begins a trace section.
+// This function is intended to be used via the LYNX_EXTENSION_TRACE_BEGIN
+// macro.
+LYNX_CAPI_EXPORT void lynx_trace_section_begin(const char* category,
+                                               const char* name);
+
+// [Internal] Ends a trace section.
+// This function is intended to be used via the LYNX_EXTENSION_TRACE_END macro.
+LYNX_CAPI_EXPORT void lynx_trace_section_end(const char* category,
+                                             const char* name);
+
+// [Internal] Records an instant event.
+// This function is intended to be used via the LYNX_EXTENSION_TRACE_INSTANT
+// macro.
+LYNX_CAPI_EXPORT void lynx_trace_instant(const char* category,
+                                         const char* name);
+
+// [Internal] Records a counter event.
+LYNX_CAPI_EXPORT void lynx_trace_counter(const char* category, const char* name,
+                                         uint64_t value, bool incremental);
+
+LYNX_EXTERN_C_END
+
+// Begins a trace section via C-API.
+// Must be paired with LYNX_CAPI_TRACE_END.
+// Example:
+//   void my_traced_function() {
+//     LYNX_CAPI_TRACE_BEGIN("MyCategory", "my_traced_function");
+//     // ... code to be traced ...
+//     LYNX_CAPI_TRACE_END("MyCategory", "my_traced_function");
+//   }
+#define LYNX_CAPI_TRACE_BEGIN(category, name) \
+  lynx_trace_section_begin(category, name)
+
+// Ends a trace section via C-API.
+#define LYNX_CAPI_TRACE_END(category, name) \
+  lynx_trace_section_end(category, name)
+
+// Records an instant event via C-API.
+// Example: LYNX_CAPI_TRACE_INSTANT("MyCategory", "ButtonClicked");
+#define LYNX_CAPI_TRACE_INSTANT(category, name) \
+  lynx_trace_instant(category, name)
+
+// Records a counter event via C-API.
+// Example: LYNX_CAPI_TRACE_COUNTER("MyCategory", "MyCounter", 42, false);
+#define LYNX_CAPI_TRACE_COUNTER(category, name, value, incremental) \
+  lynx_trace_counter(category, name, value, incremental)
+
+#endif  // PLATFORM_EMBEDDER_PUBLIC_CAPI_LYNX_TRACE_CAPI_H_

package/include/lynx/platform/embedder/public/capi/lynx_trail_service_capi.h

@@ -0,0 +1,35 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+#ifndef PLATFORM_EMBEDDER_PUBLIC_CAPI_LYNX_TRAIL_SERVICE_CAPI_H_
+#define PLATFORM_EMBEDDER_PUBLIC_CAPI_LYNX_TRAIL_SERVICE_CAPI_H_
+
+#include "lynx_export.h"
+
+LYNX_EXTERN_C_BEGIN
+
+typedef struct lynx_trail_service_t lynx_trail_service_t;
+
+// Returns the string value for `key`. The returned pointer must remain valid
+// for this callback invocation, and callers must copy it immediately.
+typedef const char* (*lynx_trail_string_value_func)(
+    lynx_trail_service_t* trail_service, const char* key);
+
+LYNX_CAPI_EXPORT lynx_trail_service_t* lynx_trail_service_create(
+    void* user_data);
+
+LYNX_CAPI_EXPORT lynx_trail_service_t* lynx_trail_service_create_with_finalizer(
+    void* user_data, void (*finalizer)(lynx_trail_service_t*, void*));
+
+LYNX_CAPI_EXPORT void* lynx_trail_service_get_user_data(
+    lynx_trail_service_t* trail_service);
+
+LYNX_CAPI_EXPORT void lynx_trail_service_bind(
+    lynx_trail_service_t* trail_service, lynx_trail_string_value_func f);
+
+LYNX_CAPI_EXPORT void lynx_trail_service_release(
+    lynx_trail_service_t* trail_service);
+
+LYNX_EXTERN_C_END
+
+#endif  // PLATFORM_EMBEDDER_PUBLIC_CAPI_LYNX_TRAIL_SERVICE_CAPI_H_