aboutsummaryrefslogtreecommitdiff
path: root/vendor/libghostty-vt/src/build/GhosttyLibVt.zig
diff options
context:
space:
mode:
authorOgulcan Celik <ogulcancelik@gmail.com>2026-05-07 18:29:21 +0300
committerOgulcan Celik <ogulcancelik@gmail.com>2026-05-07 18:29:21 +0300
commitdcfe11a7588fcd42471159453810abc9b7720a57 (patch)
treec32a77266028e73ca2382b96c96f8438a5fcd621 /vendor/libghostty-vt/src/build/GhosttyLibVt.zig
parent2dfed860103c4e4505ac7f25def9fe37da1e1e6a (diff)
build: update libghostty-vt vendor
vendor ghostty 063ac3e and remove the musl libc++ link workaround. expose the new selection formatter and hyperlink uri apis for follow-up rendering work. add manual artifact validation for static linux builds.
Diffstat (limited to 'vendor/libghostty-vt/src/build/GhosttyLibVt.zig')
-rw-r--r--vendor/libghostty-vt/src/build/GhosttyLibVt.zig306
1 files changed, 233 insertions, 73 deletions
diff --git a/vendor/libghostty-vt/src/build/GhosttyLibVt.zig b/vendor/libghostty-vt/src/build/GhosttyLibVt.zig
index 3e1be477..65f945bf 100644
--- a/vendor/libghostty-vt/src/build/GhosttyLibVt.zig
+++ b/vendor/libghostty-vt/src/build/GhosttyLibVt.zig
@@ -4,9 +4,12 @@ const std = @import("std");
const builtin = @import("builtin");
const assert = std.debug.assert;
const RunStep = std.Build.Step.Run;
+const CombineArchivesStep = @import("CombineArchivesStep.zig");
+const Config = @import("Config.zig");
const GhosttyZig = @import("GhosttyZig.zig");
-const LibtoolStep = @import("LibtoolStep.zig");
+const LipoStep = @import("LipoStep.zig");
const SharedDeps = @import("SharedDeps.zig");
+const XCFrameworkStep = @import("XCFrameworkStep.zig");
/// The step that generates the file.
step: *std.Build.Step,
@@ -21,6 +24,7 @@ kind: Kind,
output: std.Build.LazyPath,
dsym: ?std.Build.LazyPath,
pkg_config: ?std.Build.LazyPath,
+pkg_config_static: ?std.Build.LazyPath,
/// The kind of library being built. This is similar to LinkMode but
/// also includes wasm which is an executable, not a library.
@@ -40,7 +44,7 @@ pub fn initWasm(
const exe = b.addExecutable(.{
.name = "ghostty-vt",
.root_module = zig.vt_c,
- .version = std.SemanticVersion{ .major = 0, .minor = 1, .patch = 0 },
+ .version = zig.version,
});
// Allow exported symbols to actually be exported.
@@ -82,6 +86,7 @@ pub fn initWasm(
.output = output,
.dsym = null,
.pkg_config = null,
+ .pkg_config_static = null,
};
}
@@ -99,6 +104,94 @@ pub fn initShared(
return initLib(b, zig, .dynamic);
}
+/// Apple platform targets for xcframework slices.
+pub const ApplePlatform = enum {
+ macos_universal,
+ ios,
+ ios_simulator,
+ // tvOS, watchOS, and visionOS are not yet supported by Zig's
+ // standard library (missing PATH_MAX, mcontext fields, etc.).
+
+ /// Platforms that have device + simulator pairs, gated on SDK detection.
+ const sdk_platforms = [_]struct {
+ os_tag: std.Target.Os.Tag,
+ device: ApplePlatform,
+ simulator: ApplePlatform,
+ }{
+ .{ .os_tag = .ios, .device = .ios, .simulator = .ios_simulator },
+ };
+};
+
+/// Static libraries for each Apple platform, keyed by `ApplePlatform`.
+pub const AppleLibs = std.EnumMap(ApplePlatform, GhosttyLibVt);
+
+/// Build static libraries for all available Apple platforms.
+/// Always builds a macOS universal (arm64 + x86_64) fat binary.
+/// Additional platforms are included if their SDK is detected.
+pub fn initStaticAppleUniversal(
+ b: *std.Build,
+ cfg: *const Config,
+ deps: *const SharedDeps,
+ zig: *const GhosttyZig,
+) !AppleLibs {
+ var result: AppleLibs = .{};
+
+ // macOS universal (arm64 + x86_64)
+ const aarch64_zig = try zig.retarget(
+ b,
+ cfg,
+ deps,
+ Config.genericMacOSTarget(b, .aarch64),
+ );
+ const x86_64_zig = try zig.retarget(
+ b,
+ cfg,
+ deps,
+ Config.genericMacOSTarget(b, .x86_64),
+ );
+ const aarch64 = try initStatic(b, &aarch64_zig);
+ const x86_64 = try initStatic(b, &x86_64_zig);
+ const universal = LipoStep.create(b, .{
+ .name = "ghostty-vt",
+ .out_name = "libghostty-vt.a",
+ .input_a = aarch64.output,
+ .input_b = x86_64.output,
+ });
+ result.put(.macos_universal, .{
+ .step = universal.step,
+ .artifact = universal.step,
+ .kind = .static,
+ .output = universal.output,
+ .dsym = null,
+ .pkg_config = null,
+ .pkg_config_static = null,
+ });
+
+ // Additional Apple platforms, each gated on SDK availability.
+ for (ApplePlatform.sdk_platforms) |p| {
+ const target_query: std.Target.Query = .{
+ .cpu_arch = .aarch64,
+ .os_tag = p.os_tag,
+ .os_version_min = Config.osVersionMin(p.os_tag),
+ };
+ if (detectAppleSDK(b.resolveTargetQuery(target_query).result)) {
+ const dev_zig = try zig.retarget(b, cfg, deps, b.resolveTargetQuery(target_query));
+ result.put(p.device, try initStatic(b, &dev_zig));
+
+ const sim_zig = try zig.retarget(b, cfg, deps, b.resolveTargetQuery(.{
+ .cpu_arch = .aarch64,
+ .os_tag = p.os_tag,
+ .os_version_min = Config.osVersionMin(p.os_tag),
+ .abi = .simulator,
+ .cpu_model = .{ .explicit = &std.Target.aarch64.cpu.apple_a17 },
+ }));
+ result.put(p.simulator, try initStatic(b, &sim_zig));
+ }
+ }
+
+ return result;
+}
+
fn initLib(
b: *std.Build,
zig: *const GhosttyZig,
@@ -113,7 +206,7 @@ fn initLib(
.name = if (kind == .static) "ghostty-vt-static" else "ghostty-vt",
.linkage = linkage,
.root_module = zig.vt_c,
- .version = std.SemanticVersion{ .major = 0, .minor = 1, .patch = 0 },
+ .version = zig.version,
});
lib.installHeadersDirectory(
b.path("include/ghostty"),
@@ -174,36 +267,27 @@ fn initLib(
};
// pkg-config
- const pc: std.Build.LazyPath = pc: {
- const wf = b.addWriteFiles();
- break :pc wf.add("libghostty-vt.pc", b.fmt(
- \\prefix={s}
- \\includedir=${{prefix}}/include
- \\libdir=${{prefix}}/lib
- \\
- \\Name: libghostty-vt
- \\URL: https://github.com/ghostty-org/ghostty
- \\Description: Ghostty VT library
- \\Version: 0.1.0
- \\Cflags: -I${{includedir}}
- \\Libs: -L${{libdir}} -lghostty-vt
- \\Libs.private: {s}
- \\Requires.private: {s}
- , .{ b.install_prefix, libsPrivate(zig), requiresPrivate(b) }));
- };
+ //
+ // pkg-config's --static only expands Libs.private / Requires.private;
+ // it doesn't change -lghostty-vt into an archive-only reference when
+ // both shared and static libraries are installed. Install a dedicated
+ // static module so consumers can request the archive explicitly.
+ const pcs: ?PkgConfigFiles = if (kind == .shared)
+ pkgConfigFiles(b, zig, target.result.os.tag)
+ else
+ null;
// For static libraries with vendored SIMD dependencies, combine
// all archives into a single fat archive so consumers only need
- // to link one file. Skip on Windows where ar/libtool aren't available.
+ // to link one file.
if (kind == .static and
- zig.simd_libs.items.len > 0 and
- target.result.os.tag != .windows)
+ zig.simd_libs.items.len > 0)
{
var sources: SharedDeps.LazyPathList = .empty;
try sources.append(b.allocator, lib.getEmittedBin());
try sources.appendSlice(b.allocator, zig.simd_libs.items);
- const combined = combineArchives(b, target, sources.items);
+ const combined = CombineArchivesStep.create(b, target, "ghostty-vt", sources.items);
combined.step.dependOn(&lib.step);
return .{
@@ -212,7 +296,8 @@ fn initLib(
.kind = kind,
.output = combined.output,
.dsym = dsymutil,
- .pkg_config = pc,
+ .pkg_config = if (pcs) |v| v.shared else null,
+ .pkg_config_static = if (pcs) |v| v.static else null,
};
}
@@ -222,64 +307,79 @@ fn initLib(
.kind = kind,
.output = lib.getEmittedBin(),
.dsym = dsymutil,
- .pkg_config = pc,
+ .pkg_config = if (pcs) |v| v.shared else null,
+ .pkg_config_static = if (pcs) |v| v.static else null,
};
}
-/// Combine multiple static archives into a single fat archive.
-/// Uses libtool on Darwin and ar MRI scripts on other platforms.
-fn combineArchives(
- b: *std.Build,
- target: std.Build.ResolvedTarget,
- sources: []const std.Build.LazyPath,
-) struct { step: *std.Build.Step, output: std.Build.LazyPath } {
- if (target.result.os.tag.isDarwin()) {
- const libtool = LibtoolStep.create(b, .{
- .name = "ghostty-vt",
- .out_name = "libghostty-vt.a",
- .sources = @constCast(sources),
- });
- return .{ .step = libtool.step, .output = libtool.output };
- }
-
- // On non-Darwin, use an MRI script with ar -M to combine archives
- // directly without extracting. This avoids issues with ar x
- // producing full-path member names and read-only permissions.
- const run = RunStep.create(b, "combine-archives ghostty-vt");
- run.addArgs(&.{
- "/bin/sh", "-c",
- \\set -e
- \\out="$1"; shift
- \\script="CREATE $out"
- \\for a in "$@"; do
- \\ script="$script
- \\ADDLIB $a"
- \\done
- \\script="$script
- \\SAVE
- \\END"
- \\echo "$script" | ar -M
- ,
- "_",
- });
- const output = run.addOutputFileArg("libghostty-vt.a");
- for (sources) |source| run.addFileArg(source);
-
- return .{ .step = &run.step, .output = output };
-}
-
/// Returns the Libs.private value for the pkg-config file.
-/// This includes the C++ standard library needed by SIMD code.
-///
-/// Zig compiles C++ code with LLVM's libc++ (not GNU libstdc++),
-/// so consumers linking the static library need a libc++-compatible
-/// toolchain: `zig cc`, `clang`, or GCC with `-lc++` installed.
+/// Vendored C++ dependencies are built in no-libcxx mode so consumers
+/// don't need libc++. System-provided simdutf still requires it.
fn libsPrivate(
zig: *const GhosttyZig,
) []const u8 {
return if (zig.vt_c.link_libcpp orelse false) "-lc++" else "";
}
+const PkgConfigFiles = struct {
+ shared: std.Build.LazyPath,
+ static: std.Build.LazyPath,
+};
+
+fn pkgConfigFiles(
+ b: *std.Build,
+ zig: *const GhosttyZig,
+ os_tag: std.Target.Os.Tag,
+) PkgConfigFiles {
+ const wf = b.addWriteFiles();
+ const libs_private = libsPrivate(zig);
+ const requires_private = requiresPrivate(b);
+
+ return .{
+ .shared = wf.add("libghostty-vt.pc", b.fmt(
+ \\prefix={s}
+ \\includedir=${{prefix}}/include
+ \\libdir=${{prefix}}/lib
+ \\
+ \\Name: libghostty-vt
+ \\URL: https://github.com/ghostty-org/ghostty
+ \\Description: Ghostty VT library
+ \\Version: {f}
+ \\Cflags: -I${{includedir}}
+ \\Libs: -L${{libdir}} -lghostty-vt
+ \\Libs.private: {s}
+ \\Requires.private: {s}
+ , .{ b.install_prefix, zig.version, libs_private, requires_private })),
+ .static = wf.add("libghostty-vt-static.pc", b.fmt(
+ \\prefix={s}
+ \\includedir=${{prefix}}/include
+ \\libdir=${{prefix}}/lib
+ \\
+ \\Name: libghostty-vt-static
+ \\URL: https://github.com/ghostty-org/ghostty
+ \\Description: Ghostty VT library (static)
+ \\Version: {f}
+ \\Cflags: -I${{includedir}}
+ \\Libs: ${{libdir}}/{s}
+ \\Libs.private: {s}
+ \\Requires.private: {s}
+ , .{
+ b.install_prefix,
+ zig.version,
+ staticLibraryName(os_tag),
+ libs_private,
+ requires_private,
+ })),
+ };
+}
+
+fn staticLibraryName(os_tag: std.Target.Os.Tag) []const u8 {
+ return if (os_tag == .windows)
+ "ghostty-vt-static.lib"
+ else
+ "libghostty-vt.a";
+}
+
/// Returns the Requires.private value for the pkg-config file.
/// When SIMD dependencies are provided by the system (via
/// -Dsystem-integration), we reference their pkg-config names so
@@ -294,6 +394,59 @@ fn requiresPrivate(b: *std.Build) []const u8 {
return "";
}
+/// Create an XCFramework bundle from Apple platform static libraries.
+pub fn xcframework(
+ apple_libs: *const AppleLibs,
+ b: *std.Build,
+) *XCFrameworkStep {
+ // Generate a headers directory with a module map for Swift PM.
+ // We can't use include/ directly because it contains a module map
+ // for GhosttyKit (the macOS app library).
+ const wf = b.addWriteFiles();
+ _ = wf.addCopyDirectory(
+ b.path("include/ghostty"),
+ "ghostty",
+ .{ .include_extensions = &.{".h"} },
+ );
+ _ = wf.add("module.modulemap",
+ \\module GhosttyVt {
+ \\ umbrella header "ghostty/vt.h"
+ \\ export *
+ \\}
+ \\
+ );
+ const headers = wf.getDirectory();
+
+ var libraries: [AppleLibs.len]XCFrameworkStep.Library = undefined;
+ var lib_count: usize = 0;
+ for (std.enums.values(ApplePlatform)) |platform| {
+ if (apple_libs.get(platform)) |lib| {
+ libraries[lib_count] = .{
+ .library = lib.output,
+ .headers = headers,
+ .dsym = null,
+ };
+ lib_count += 1;
+ }
+ }
+
+ return XCFrameworkStep.create(b, .{
+ .name = "ghostty-vt",
+ .out_path = b.pathJoin(&.{ b.install_prefix, "lib/ghostty-vt.xcframework" }),
+ .libraries = libraries[0..lib_count],
+ });
+}
+
+/// Returns true if the Apple SDK for the given target is installed.
+fn detectAppleSDK(target: std.Target) bool {
+ _ = std.zig.LibCInstallation.findNative(.{
+ .allocator = std.heap.page_allocator,
+ .target = &target,
+ .verbose = false,
+ }) catch return false;
+ return true;
+}
+
pub fn install(
self: *const GhosttyLibVt,
step: *std.Build.Step,
@@ -307,4 +460,11 @@ pub fn install(
"share/pkgconfig/libghostty-vt.pc",
).step);
}
+ if (self.pkg_config_static) |pkg_config_static| {
+ step.dependOn(&b.addInstallFileWithDir(
+ pkg_config_static,
+ .prefix,
+ "share/pkgconfig/libghostty-vt-static.pc",
+ ).step);
+ }
}