160 lines
3.7 KiB
Swift
160 lines
3.7 KiB
Swift
import Rainbow
|
|
|
|
public typealias Example = (label: String, example: String)
|
|
|
|
public struct ExampleSection<Header: TextNode, Label: TextNode>: TextNode {
|
|
|
|
@usableFromInline
|
|
let configuration: ExampleSectionConfiguration
|
|
|
|
@inlinable
|
|
public init(
|
|
examples: [Example],
|
|
@TextBuilder title: () -> Header,
|
|
@TextBuilder label: () -> Label
|
|
) {
|
|
self.configuration = .init(
|
|
title: title(),
|
|
label: label(),
|
|
examples: examples
|
|
)
|
|
}
|
|
|
|
@inlinable
|
|
public init(
|
|
_ title: @autoclosure () -> Header,
|
|
label: @autoclosure () -> Label,
|
|
examples: [Example]
|
|
) {
|
|
self.init(
|
|
examples: examples,
|
|
title: title,
|
|
label: label
|
|
)
|
|
}
|
|
|
|
@inlinable
|
|
public var body: some TextNode {
|
|
style(.default())
|
|
}
|
|
}
|
|
|
|
/// The type-erased configuration of an ``ExampleSection``
|
|
public struct ExampleSectionConfiguration {
|
|
public let title: any TextNode
|
|
|
|
public let label: any TextNode
|
|
|
|
public let examples: [Example]
|
|
|
|
@usableFromInline
|
|
init(title: any TextNode, label: any TextNode, examples: [Example]) {
|
|
self.title = title
|
|
self.label = label
|
|
self.examples = examples
|
|
}
|
|
}
|
|
|
|
/// The configuration context for the `examples` of an ``ExampleSection``.
|
|
public struct ExampleConfiguration {
|
|
public let examples: [Example]
|
|
|
|
@usableFromInline
|
|
init(examples: [Example]) {
|
|
self.examples = examples
|
|
}
|
|
}
|
|
|
|
// MARK: - Style
|
|
|
|
public protocol ExampleSectionStyle: TextModifier where Content == ExampleSectionConfiguration {}
|
|
public protocol ExampleStyle: TextModifier where Content == ExampleConfiguration {}
|
|
|
|
public extension ExampleSection {
|
|
|
|
@inlinable
|
|
func style<S: ExampleSectionStyle>(_ style: S) -> some TextNode {
|
|
style.render(content: configuration)
|
|
}
|
|
|
|
@inlinable
|
|
func exampleStyle<S: ExampleStyle>(_ style: S) -> some TextNode {
|
|
DefaultExampleSectionStyle(exampleStyle: style).render(content: configuration)
|
|
}
|
|
}
|
|
|
|
extension Array where Element == Example {
|
|
@inlinable
|
|
func exampleStyle<S: ExampleStyle>(_ style: S) -> some TextNode {
|
|
style.render(content: .init(examples: self))
|
|
}
|
|
}
|
|
|
|
public extension ExampleSectionStyle {
|
|
@inlinable
|
|
static func `default`<S: ExampleStyle>(exampleStyle: S) -> DefaultExampleSectionStyle<S> {
|
|
DefaultExampleSectionStyle(exampleStyle: exampleStyle)
|
|
}
|
|
}
|
|
|
|
public extension ExampleSectionStyle where Self == DefaultExampleSectionStyle<DefaultExampleStyle> {
|
|
@inlinable
|
|
static func `default`() -> DefaultExampleSectionStyle<DefaultExampleStyle> {
|
|
DefaultExampleSectionStyle()
|
|
}
|
|
}
|
|
|
|
public extension ExampleStyle where Self == DefaultExampleStyle {
|
|
static var `default`: Self {
|
|
DefaultExampleStyle()
|
|
}
|
|
}
|
|
|
|
public struct DefaultExampleSectionStyle<Style: ExampleStyle>: ExampleSectionStyle {
|
|
|
|
@usableFromInline
|
|
let exampleStyle: Style
|
|
|
|
@inlinable
|
|
public init(exampleStyle: Style) {
|
|
self.exampleStyle = exampleStyle
|
|
}
|
|
|
|
@inlinable
|
|
public func render(content: ExampleSectionConfiguration) -> some TextNode {
|
|
Section {
|
|
exampleStyle.render(content: .init(examples: content.examples))
|
|
} header: {
|
|
HStack {
|
|
content.title
|
|
.color(.yellow)
|
|
.bold()
|
|
|
|
content.label.italic()
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
public extension DefaultExampleSectionStyle where Style == DefaultExampleStyle {
|
|
@inlinable
|
|
init() {
|
|
self.init(exampleStyle: .default)
|
|
}
|
|
}
|
|
|
|
public struct DefaultExampleStyle: ExampleStyle {
|
|
|
|
@inlinable
|
|
public func render(content: ExampleConfiguration) -> some TextNode {
|
|
VStack(separator: .newLine(count: 2)) {
|
|
content.examples.map { example in
|
|
VStack {
|
|
example.label.color(.green).bold()
|
|
ShellCommand(example.example).style(.default)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|