Repository Public
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