orange-opensource/ouds-ios/ouds-ios-framework-usage

import OUDSSwiftUI // Always use the umbrella import
 
@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            OUDSThemeableView(theme: OrangeTheme()) {
                ContentView()
            }
        }
    }
}
 
struct ContentView: View {
    @Environment(\.theme) private var theme
    var body: some View {
        VStack(spacing: theme.spaces.fixedMedium) {
            OUDSButton(text: "Action", appearance: .default) {}
        }
        .padding(theme.spaces.fixedLarge)
    }
}

OUDSThemeableView(theme: OrangeTheme()) { … }   // inject at root
@Environment(\.theme) private var theme          // consume anywhere

Text("Hello")
.font(theme.fonts.bodyDefaultMedium) // typography — use view modifier with token
.foregroundColor(theme.colors.contentDefault)
.background(theme.colors.bgPrimary)
.border(style: theme.borders.styleDefault,
        width: theme.borders.widthThin,
        radius: theme.borders.radiusMedium,
        color: theme.colors.actionEnabled)
.shadow(theme.elevations.emphasized)

Circle()
    .fill(theme.colors.actionEnabled)                               // shape fill with token
RoundedRectangle(cornerRadius: 8)
    .fill(theme.colors.bgPrimary, style: FillStyle(eoFill: true))  // with custom fill style

OUDSButton(
    text: "Add",
    image: OUDSImage(asset: Image(systemName: "plus").accessibilityHidden(true)), // ❌ compile error: Image modifier → some View
    appearance: .default) {}
 
OUDSLink(
    text: "Back",
    image: OUDSImage(asset: Image(systemName: "chevron.left").accessibilityHidden(true)), // ❌ compile error: Image modifier → some View
    size: .default) {}

// swiftlint:disable:next accessibility_label_for_image
OUDSButton(text: "Add", image: OUDSImage(asset: Image(systemName: "plus")), appearance: .default) {}
 
// swiftlint:disable:next accessibility_label_for_image
OUDSLink(text: "Back", image: OUDSImage(asset: Image(systemName: "chevron.left")), size: .default) {}
 
// Exception: OUDSToolBarItem still takes a bare `Image`
// swiftlint:disable:next accessibility_label_for_image
OUDSToolBarItem(icon: Image("ic_share"), accessibilityLabel: "Share") {}

private static var fontsAlreadyRegistered = false
 
private func registerFonts() {
    guard !Self.fontsAlreadyRegistered else { return }
    Bundle.main.urls(forResourcesWithExtension: "ttf", subdirectory: nil)?
        .forEach { CTFontManagerRegisterFontsForURL($0 as CFURL, .process, nil) }
    Self.fontsAlreadyRegistered = true
}

registerFont(postScript: "WinkyRough-Regular_Light",   forCombination: PSFNMK("Winky Rough", Font.Weight.light))
registerFont(postScript: "WinkyRough-Regular",         forCombination: PSFNMK("Winky Rough", Font.Weight.regular))
registerFont(postScript: "WinkyRough-Regular_Medium",  forCombination: PSFNMK("Winky Rough", Font.Weight.medium))
registerFont(postScript: "WinkyRough-Regular_SemiBold",forCombination: PSFNMK("Winky Rough", Font.Weight.semibold))
registerFont(postScript: "WinkyRough-Regular_Bold",    forCombination: PSFNMK("Winky Rough", Font.Weight.bold))
registerFont(postScript: "WinkyRough-Regular_Black",   forCombination: PSFNMK("Winky Rough", Font.Weight.black))

import OUDSComponents
import SwiftUI
 
let markdown = "Read our [terms of service](https://example.com/terms) and [privacy policy](https://example.com/privacy)"
 
let textColor = theme.colors.contentDefault.color(for: colorScheme)
let textFont = Font(Font.makeFont(family: theme.fontFamily,
                                   from: theme.fonts.bodyDefaultMedium,
                                   isCompact: horizontalSizeClass == .compact || verticalSizeClass == .compact))
 
let urlColor = theme.colors.contentBrandPrimary.color(for: colorScheme)
let urlFont = Font(Font.makeFont(family: theme.fontFamily,
                                  from: theme.fonts.bodyStrongMedium,
                                  isCompact: horizontalSizeClass == .compact || verticalSizeClass == .compact))
 
let configurations: [AttributedStringUrlConfiguration] = [
    AttributedStringUrlConfiguration(
        text: "terms of service",
        color: urlColor,
        font: urlFont
    ),
    AttributedStringUrlConfiguration(
        text: "privacy policy",
        urlToOpen: URL(string: "https://example.com/privacy")!,
        color: urlColor,
        font: urlFont
    ),
    AttributedStringUrlConfiguration(
        color: urlColor,
        font: urlFont
    )
]
 
let attributedString = AttributedString.from(
    markdown: markdown,
    foregroundColor: textColor,
    font: textFont,
    urlConfigurations: configurations
)

let attributedString = AttributedString.from(
    text: "You must read the terms of service before continuing",
    foregroundColor: textColor,
    font: textFont,
    urlConfigurations: [
        AttributedStringUrlConfiguration(
            text: "terms of service",
            urlToOpen: URL(string: "https://example.com/terms")!,
            color: urlColor,
            font: urlFont
        )
    ]
)

let coloredText = AttributedString.from(text: "Some plain text", foregroundColor: textColor)
let coloredKey = AttributedString.from("some.localized.key", foregroundColor: textColor)
let coloredMarkdown = AttributedString.from(markdown: someMarkdown, foregroundColor: textColor)

import OUDSSwiftUI
 
// Basic usage
OUDSAsyncImage(url: URL(string: "https://example.com/photo.png"))
 
// With content transformation and placeholder
OUDSAsyncImage(url: url) { image in
    image.resizable()
} placeholder: {
    ProgressView()
}
 
// With phases for full control
OUDSAsyncImage(url: url) { phase in
    switch phase {
    case .empty: ProgressView()
    case .success(let image): image.resizable()
    case .failure: Image(systemName: "photo")
    }
}
 
// Cache management
OUDSAsyncImageCache.shared.clearCache()           // memory + disk
OUDSAsyncImageCache.shared.clearMemoryCache()
OUDSAsyncImageCache.shared.clearDiskCache()