SPB Git

Repository Public

NVColor.swift 8.6 KB 173 lines swift

1// SP Notes Core2// File: Sources/SPNotesDesign/NVColor.swift3// Description: Note Visual System 2.0 colour tokens « Graphite & Ultramarine · Lumen »: sRGB values of the shared spec,4//              dynamic light/dark SwiftUI colours, the Lumen gradient and WCAG contrast helpers.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import SwiftUI9#if canImport(UIKit)10import UIKit11#elseif canImport(AppKit)12import AppKit13#endif1415/// An sRGB colour with components in 0…1. Pure value type: usable off the main actor and in tests.16public struct NVRGB: Sendable, Hashable {17    public var red: Double18    public var green: Double19    public var blue: Double20    public var alpha: Double2122    public init(red: Double, green: Double, blue: Double, alpha: Double = 1) {23        self.red = red24        self.green = green25        self.blue = blue26        self.alpha = alpha27    }2829    /// From `0xRRGGBB`.30    public init(hex: UInt32) {31        self.init(red: Double((hex >> 16) & 0xFF) / 255, green: Double((hex >> 8) & 0xFF) / 255, blue: Double(hex & 0xFF) / 255)32    }3334    /// From `#rgb`, `#rrggbb` or `#rrggbbaa` (the `#` is optional). Nil when the string is not a hex colour.35    public init?(hexString: String) {36        var s = Substring(hexString.trimmingCharacters(in: .whitespacesAndNewlines))37        if s.hasPrefix("#") { s = s.dropFirst() }38        guard [3, 6, 8].contains(s.count), s.allSatisfy(\.isHexDigit), s.utf8.count == s.count else { return nil }39        var digits = String(s)40        if digits.count == 3 { digits = digits.map { "\($0)\($0)" }.joined() }41        guard let value = UInt64(digits, radix: 16) else { return nil }42        if digits.count == 8 {43            self.init(hex: UInt32(value >> 8))44            alpha = Double(value & 0xFF) / 25545        } else {46            self.init(hex: UInt32(value))47        }48    }4950    /// `#RRGGBB` (alpha is not written).51    public var hexString: String {52        func byte(_ v: Double) -> Int { Int((min(1, max(0, v)) * 255).rounded()) }53        return String(format: "#%02X%02X%02X", byte(red), byte(green), byte(blue))54    }5556    /// WCAG 2 relative luminance.57    public var relativeLuminance: Double {58        func linear(_ c: Double) -> Double { c <= 0.03928 ? c / 12.92 : pow((c + 0.055) / 1.055, 2.4) }59        return 0.2126 * linear(red) + 0.7152 * linear(green) + 0.0722 * linear(blue)60    }6162    /// WCAG 2 contrast ratio between two opaque colours (1…21).63    public static func contrast(_ a: NVRGB, _ b: NVRGB) -> Double {64        let la = a.relativeLuminance, lb = b.relativeLuminance65        return (max(la, lb) + 0.05) / (min(la, lb) + 0.05)66    }6768    /// A fixed (non dynamic) SwiftUI colour.69    public var color: Color { Color(.sRGB, red: red, green: green, blue: blue, opacity: alpha) }70}7172/// Colour tokens of the Note Visual System 2.0. `NVColor.fg` and friends are dynamic colours following the73/// light / dark appearance; `NVColor.Token` exposes the raw values.74public enum NVColor {75    /// One named token with its light and dark sRGB values.76    public struct Token: Sendable, Hashable, Identifiable {77        public let name: String78        public let lightHex: UInt3279        public let darkHex: UInt328081        public var id: String { name }82        public var light: NVRGB { NVRGB(hex: lightHex) }83        public var dark: NVRGB { NVRGB(hex: darkHex) }8485        /// The value for one appearance.86        public func rgb(dark isDark: Bool) -> NVRGB { isDark ? dark : light }8788        /// A fixed colour for an explicit scheme (snapshots, exports).89        public func color(for scheme: ColorScheme) -> Color { rgb(dark: scheme == .dark).color }9091        /// The dynamic colour: follows the appearance of the view it is used in.92        public var color: Color {93            let l = light, d = dark94            #if canImport(UIKit) && !os(watchOS)95            return Color(uiColor: UIColor { traits in96                let c = traits.userInterfaceStyle == .dark ? d : l97                return UIColor(red: c.red, green: c.green, blue: c.blue, alpha: c.alpha)98            })99            #elseif canImport(AppKit)100            return Color(nsColor: NSColor(name: nil) { appearance in101                let c = appearance.bestMatch(from: [.aqua, .darkAqua]) == .darkAqua ? d : l102                return NSColor(srgbRed: c.red, green: c.green, blue: c.blue, alpha: c.alpha)103            })104            #else105            return l.color106            #endif107        }108109        public static let bg = Token(name: "bg", lightHex: 0xF9FBFD, darkHex: 0x0D1016)110        public static let bgElevated = Token(name: "bgElevated", lightHex: 0xFFFFFF, darkHex: 0x15181F)111        public static let bgSunken = Token(name: "bgSunken", lightHex: 0xF0F3F6, darkHex: 0x080A0F)112        public static let bgSidebar = Token(name: "bgSidebar", lightHex: 0xF3F6F9, darkHex: 0x0A0C12)113        public static let bgHover = Token(name: "bgHover", lightHex: 0xEAEDF2, darkHex: 0x1D2028)114        public static let fg = Token(name: "fg", lightHex: 0x151922, darkHex: 0xE8EBEF)115        public static let fgMuted = Token(name: "fgMuted", lightHex: 0x535862, darkHex: 0xA0A5AE)116        public static let fgFaint = Token(name: "fgFaint", lightHex: 0x848992, darkHex: 0x6A6F77)117        public static let line = Token(name: "line", lightHex: 0xE1E4E8, darkHex: 0x22252D)118        public static let lineStrong = Token(name: "lineStrong", lightHex: 0xCCD0D5, darkHex: 0x333640)119        public static let accent = Token(name: "accent", lightHex: 0x2F5DDB, darkHex: 0x7CA5FF)120        public static let accentFg = Token(name: "accentFg", lightHex: 0xFBFCFE, darkHex: 0x090F1C)121        public static let accentSoft = Token(name: "accentSoft", lightHex: 0xE5F0FF, darkHex: 0x1B2A4C)122        public static let ai = Token(name: "ai", lightHex: 0x7E41D2, darkHex: 0xB999FB)123        public static let aiSoft = Token(name: "aiSoft", lightHex: 0xF3ECFF, darkHex: 0x302249)124        public static let success = Token(name: "success", lightHex: 0x008B4E, darkHex: 0x5BC083)125        public static let warning = Token(name: "warning", lightHex: 0xD98B09, darkHex: 0xF2AF48)126        public static let danger = Token(name: "danger", lightHex: 0xCC272E, darkHex: 0xF26A64)127128        /// SPEC §7: the semantic hues as SMALL TEXT in light mode (the base hues stay for fills, icons, borders and for129        /// dark mode). Not part of `all`.130        public static let successText = Token(name: "successText", lightHex: 0x006B3C, darkHex: 0x5BC083)131        public static let warningText = Token(name: "warningText", lightHex: 0x8A5A00, darkHex: 0xF2AF48)132        public static let dangerText = Token(name: "dangerText", lightHex: 0xB0181F, darkHex: 0xF26A64)133134        /// The 18 tokens, in the order of the specification table.135        public static let all: [Token] = [bg, bgElevated, bgSunken, bgSidebar, bgHover, fg, fgMuted, fgFaint, line, lineStrong,136                                          accent, accentFg, accentSoft, ai, aiSoft, success, warning, danger]137    }138139    public static let successText = Token.successText.color140    public static let warningText = Token.warningText.color141    public static let dangerText = Token.dangerText.color142    public static let bg = Token.bg.color143    public static let bgElevated = Token.bgElevated.color144    public static let bgSunken = Token.bgSunken.color145    public static let bgSidebar = Token.bgSidebar.color146    public static let bgHover = Token.bgHover.color147    public static let fg = Token.fg.color148    public static let fgMuted = Token.fgMuted.color149    /// Placeholders and decorative text only: below the 4.5 : 1 contrast of body text.150    public static let fgFaint = Token.fgFaint.color151    public static let line = Token.line.color152    public static let lineStrong = Token.lineStrong.color153    public static let accent = Token.accent.color154    public static let accentFg = Token.accentFg.color155    public static let accentSoft = Token.accentSoft.color156    /// Anything produced by an AI model.157    public static let ai = Token.ai.color158    public static let aiSoft = Token.aiSoft.color159    public static let success = Token.success.color160    public static let warning = Token.warning.color161    public static let danger = Token.danger.color162163    /// The signature gradient « Lumen »: accent → ai at 135° (top leading to bottom trailing).164    public static var lumen: LinearGradient {165        LinearGradient(colors: [accent, ai], startPoint: .topLeading, endPoint: .bottomTrailing)166    }167168    /// The Lumen gradient with fixed colours for one scheme.169    public static func lumen(for scheme: ColorScheme) -> LinearGradient {170        LinearGradient(colors: [Token.accent.color(for: scheme), Token.ai.color(for: scheme)], startPoint: .topLeading, endPoint: .bottomTrailing)171    }172}173
Files main
Menu

Theme