feat(shims): expose C path aliases

Author: Kyle-Ye

Package.resolved

@@ -197,9 +197,9 @@ extension Target {
         dependencies.append(
             .product(name: "RenderBox", package: "DarwinPrivateFrameworks")
         )
-        var swiftSettings = swiftSettings ?? []
-        swiftSettings.append(.define("OPENRENDERBOX_RENDERBOX"))
-        self.swiftSettings = swiftSettings
+        cSettings = (cSettings ?? []) + [.define("OPENRENDERBOX_RENDERBOX")]
+        cxxSettings = (cxxSettings ?? []) + [.define("OPENRENDERBOX_RENDERBOX")]
+        swiftSettings = (swiftSettings ?? []) + [.define("OPENRENDERBOX_RENDERBOX")]
     }
 }
 
@@ -231,8 +231,19 @@ let openRenderBoxCxxTarget = Target.target(
 )
 let openRenderBoxShimsTarget = Target.target(
     name: "OpenRenderBoxShims",
+    dependencies: ["OpenRenderBoxShimsCxx"],
     swiftSettings: sharedSwiftSettings
 )
+let openRenderBoxShimsCxxTarget = Target.target(
+    name: "OpenRenderBoxShimsCxx",
+    dependencies: renderBoxCondtion
+        ? [.product(name: "RenderBox", package: "DarwinPrivateFrameworks")]
+        : ["OpenRenderBox"],
+    sources: ["OpenRenderBoxShimsCxx.c"],
+    publicHeadersPath: renderBoxCondtion ? "include/RenderBox" : "include/OpenRenderBox",
+    cSettings: sharedCSettings,
+    cxxSettings: sharedCxxSettings
+)
 let openRenderBoxTestsTarget = Target.testTarget(
     name: "OpenRenderBoxTests",
     dependencies: [
@@ -270,7 +281,7 @@ let package = Package(
     name: "OpenRenderBox",
     products: [
         .library(name: "OpenRenderBox", type: libraryType, targets: ["OpenRenderBox", "OpenRenderBoxCxx"]),
-        .library(name: "OpenRenderBoxShims", type: libraryType, targets: ["OpenRenderBoxShims"]),
+        .library(name: "OpenRenderBoxShims", type: libraryType, targets: ["OpenRenderBoxShims", "OpenRenderBoxShimsCxx"]),
     ],
     dependencies: [
         .package(url: "https://github.com/apple/swift-numerics", from: "1.1.1"),
@@ -279,6 +290,7 @@ let package = Package(
         openRenderBoxTarget,
         openRenderBoxCxxTarget,
         openRenderBoxShimsTarget,
+        openRenderBoxShimsCxxTarget,
         openRenderBoxTestsTarget,
         openRenderBoxCompatibilityTestTarget,
     ],

Package.swift

@@ -22,6 +22,27 @@ Currently, this project is in early development.
 
 The current suggested toolchain to build the project is Swift 6.3.3 / Xcode 26.6.
 
+## Shims
+
+The `OpenRenderBoxShims` product provides Swift aliases and a C header for path APIs.
+Swift clients use:
+
+```swift
+import OpenRenderBoxShims
+```
+
+C, C++, and Objective-C clients use:
+
+```c
+#include <OpenRenderBoxShims/OpenRenderBoxShims.h>
+```
+
+The C module is `OpenRenderBoxShimsCxx`; its public header uses the product name.
+
+The package selects the public header directory for the configured backend.
+Clients use `ORB` names with either backend and do not need to define
+`OPENRENDERBOX_RENDERBOX` in their preprocessor settings.
+
 ## Supported platforms
 
 | **CI Status** |

README.md

@@ -0,0 +1 @@
+// Empty file to make SwiftPM happy :)

Sources/OpenRenderBoxShimsCxx/OpenRenderBoxShimsCxx.c

@@ -0,0 +1,9 @@
+//
+//  OpenRenderBoxShims.h
+//  OpenRenderBoxShims
+
+#pragma once
+
+#include <OpenRenderBox/ORBPath.h>
+#include <OpenRenderBox/ORBPathCallbacks.h>
+#include <OpenRenderBox/ORBPathStorage.h>

Sources/OpenRenderBoxShimsCxx/include/OpenRenderBox/OpenRenderBoxShims/OpenRenderBoxShims.h

@@ -0,0 +1,4 @@
+module OpenRenderBoxShimsCxx {
+    umbrella header "OpenRenderBoxShims/OpenRenderBoxShims.h"
+    export *
+}

Sources/OpenRenderBoxShimsCxx/include/OpenRenderBox/module.modulemap

@@ -0,0 +1,62 @@
+//
+//  OpenRenderBoxShims.h
+//  OpenRenderBoxShims
+
+#pragma once
+
+#include <RenderBox/RBPath.h>
+#include <RenderBox/RBPathCallbacks.h>
+#include <RenderBox/RBPathStorage.h>
+
+typedef RBPath ORBPath;
+typedef RBPathElement ORBPathElement;
+typedef RBPathRoundedCornerStyle ORBPathRoundedCornerStyle;
+typedef RBPathApplyCallback ORBPathApplyCallback;
+typedef RBPathCallbacks ORBPathCallbacks;
+typedef RBPathCallbacksFlags ORBPathCallbacksFlags;
+typedef RBPathCallbacksExtended ORBPathCallbacksExtended;
+typedef RBPathStorageRef ORBPathStorageRef;
+
+#define ORBPathElementMoveToPoint RBPathElementMoveToPoint
+#define ORBPathElementAddLineToPoint RBPathElementAddLineToPoint
+#define ORBPathElementAddQuadCurveToPoint RBPathElementAddQuadCurveToPoint
+#define ORBPathElementAddCurveToPoint RBPathElementAddCurveToPoint
+#define ORBPathElementCloseSubpath RBPathElementCloseSubpath
+#define ORBPathElementRect RBPathElementRect
+#define ORBPathElementRoundedRect RBPathElementRoundedRect
+#define ORBPathElementFixedRoundedRectCircular RBPathElementFixedRoundedRectCircular
+#define ORBPathElementFixedRoundedRectContinuous RBPathElementFixedRoundedRectContinuous
+#define ORBPathElementInvalid RBPathElementInvalid
+
+#define ORBPathRoundedCornerStyleCircular RBPathRoundedCornerStyleCircular
+#define ORBPathRoundedCornerStyleContinuous RBPathRoundedCornerStyleContinuous
+
+#define ORBPathEmpty RBPathEmpty
+#define ORBPathNull RBPathNull
+#define ORBPathRetain RBPathRetain
+#define ORBPathRelease RBPathRelease
+#define ORBPathMakeWithCGPath RBPathMakeWithCGPath
+#define ORBPathMakeRect RBPathMakeRect
+#define ORBPathMakeEllipse RBPathMakeEllipse
+#define ORBPathMakeRoundedRect RBPathMakeRoundedRect
+#define ORBPathMakeUnevenRoundedRect RBPathMakeUnevenRoundedRect
+#define ORBPathIsEmpty RBPathIsEmpty
+#define ORBPathApplyElements RBPathApplyElements
+#define ORBPathEqualToPath RBPathEqualToPath
+#define ORBPathCopyCGPath RBPathCopyCGPath
+#define ORBPathContainsPoint RBPathContainsPoint
+#define ORBPathContainsPoints RBPathContainsPoints
+
+#define ORBPathCGPathCallbacks RBPathCGPathCallbacks
+#define ORBPathStorageInit RBPathStorageInit
+#define ORBPathStorageDestroy RBPathStorageDestroy
+#define ORBPathStorageClear RBPathStorageClear
+#define ORBPathStorageAppendElement RBPathStorageAppendElement
+#define ORBPathStorageAppendPath RBPathStorageAppendPath
+#define ORBPathStorageApplyElements RBPathStorageApplyElements
+#define ORBPathStorageIsEmpty RBPathStorageIsEmpty
+#define ORBPathStorageEqualToStorage RBPathStorageEqualToStorage
+#define ORBPathStorageIsSingleElement RBPathStorageIsSingleElement
+#define ORBPathStorageGetBezierOrder RBPathStorageGetBezierOrder
+#define ORBPathStorageGetBoundingRect RBPathStorageGetBoundingRect
+#define ORBPathStorageGetCGPath RBPathStorageGetCGPath

Sources/OpenRenderBoxShimsCxx/include/RenderBox/OpenRenderBoxShims/OpenRenderBoxShims.h

@@ -0,0 +1,4 @@
+module OpenRenderBoxShimsCxx {
+    umbrella header "OpenRenderBoxShims/OpenRenderBoxShims.h"
+    export *
+}