tiny.ui.asset.Embedded

1pub const Embedded = struct {2    pub const Limits = struct {3        font_bytes: usize,4        descriptor_bytes: usize,5        family_bytes: usize,6    };78    pub const Capacity = struct {9        retained_bytes: usize,1011        pub fn derive(limits: Limits) error{CapacityOverflow}!Capacity {12            const fonts = std.math.add(usize, limits.font_bytes, limits.descriptor_bytes) catch return error.CapacityOverflow;13            return .{ .retained_bytes = std.math.add(usize, fonts, limits.family_bytes) catch return error.CapacityOverflow };14        }15    };1617    pub fn defaultLimits() Limits {18        return .{19            .font_bytes = noto_bytes.len + iosevka_bytes.len + faces.len,20            .descriptor_bytes = @sizeOf(@TypeOf(faces)),21            .family_bytes = faces[0].family.len + faces[1].family.len + faces.len,22        };23    }2425    pub const claim: alloc_phase.capacity.Declaration = .{26        .source = .{27            .id = "ui.asset_registry",28            .kind = .startup_static,29            .limit_source = .application_default,30            .storage = .{31                .covered = &.{32                    .{ .id = "embedded_font_bytes", .lifetime = .steady, .detail = "the two pinned TrueType subsets in executable read-only storage" },33                    .{ .id = "embedded_descriptors", .lifetime = .steady, .detail = "the constant font traits and family names registered before UI readiness" },34                },35                .excluded = &.{ "caller-owned registry table slots and owned payload pool", "registered system faces" },36            },37            .capacity = .{38                .inputs = &.{39                    alloc_phase.capacity.bindInput(Limits, "font_bytes", "font_bytes"),40                    alloc_phase.capacity.bindInput(Limits, "descriptor_bytes", "descriptor_bytes"),41                    alloc_phase.capacity.bindInput(Limits, "family_bytes", "family_bytes"),42                },43                .type_selectors = &.{},44                .nodes = &.{45                    .{ .input = 0 },46                    .{ .input = 1 },47                    .{ .input = 2 },48                    .{ .add = .{ .left = 0, .right = 1 } },49                    .{ .add = .{ .left = 3, .right = 2 } },50                },51                .assertions = &.{.{52                    .scope = .closure_total,53                    .measure = .retained,54                    .relation = .upper_bound,55                    .expression = 4,56                }},57            },58            .overload = .{ .kind = .not_applicable, .detail = "the two read-only faces have a fixed executable image size" },59            .risks = .{60                .transitive = .{ .status = .excluded, .detail = "the embedded font bytes and descriptors require no allocator" },61                .foreign = .{ .status = .excluded, .detail = "the startup corpus reads no host font service" },62            },63            .obligations = &.{64                .{ .key = "ui_registry_startup", .role = .acquisition },65                .{ .key = "ui_registry_descriptors", .role = .integration },66                .{ .key = "ui_registry_teardown", .role = .teardown },67            },68        },69        .bindings = .{70            .owner = @This(),71            .default_limits = alloc_phase.capacity.selector(@This().defaultLimits),72        },73    };7475    /// Registers the two regular faces before a UI session begins publishing.76    /// A bold request matches the regular face until a bold face is registered.77    pub fn register(table: *registry.Registry) model.Error![faces.len]model.AssetHandle {78        std.debug.assert(table.phase == .steady);79        if (table.limits.fonts - table.font_used < faces.len) return error.FontCapacityExceeded;80        var handles: [faces.len]model.AssetHandle = undefined;81        for (faces, 0..) |face, index| {82            handles[index] = try table.registerFont(face.family, face.descriptor, .{ .borrowed = face.bytes });83        }84        return handles;85    }8687    /// Returns a ready registry with both embedded faces already registered.88    pub fn open(allocator: std.mem.Allocator, limits: registry.Registry.Limits) (registry.Registry.InitError || model.Error)!registry.Registry {89        if (limits.fonts < faces.len) return error.FontCapacityExceeded;90        var table = try registry.Registry.init(allocator, limits);91        errdefer table.deinit(allocator);92        table.activate();93        _ = try register(&table);94        return table;95    }96};

1pub const Embedded = embedded.Embedded;