\
25 | Logo\
26 | background-color")
22 | }
23 | }
24 |
--------------------------------------------------------------------------------
/Sources/Ignite/Extensions/URL-Relative.swift:
--------------------------------------------------------------------------------
1 | //
2 | // URL-Relative.swift
3 | // Ignite
4 | // https://www.github.com/twostraws/Ignite
5 | // See LICENSE for license information.
6 | //
7 |
8 | import Foundation
9 |
10 | extension URL {
11 | /// Creates a relative URL by using another URL as its base.
12 | /// - Parameter other: The base URL to compare against.
13 | /// - Returns: A relative URL.
14 | func relative(to other: URL) -> String {
15 | let basePath = other.path()
16 | let thisPath = path()
17 | let result = thisPath.trimmingPrefix(basePath)
18 |
19 | return String(result)
20 | }
21 | }
22 |
--------------------------------------------------------------------------------
/Sources/Ignite/Types/UnorderedListMarkerStyle.swift:
--------------------------------------------------------------------------------
1 | //
2 | // UnorderedListStyle.swift
3 | // Ignite
4 | // https://www.github.com/twostraws/Ignite
5 | // See LICENSE for license information.
6 | //
7 |
8 | public enum UnorderedListMarkerStyle: String, Sendable {
9 | /// Lists are shown with filled circle bullet points.
10 | case automatic = "disc"
11 |
12 | /// Lists are shown with hollow circle bullet points.
13 | case circle = "circle"
14 |
15 | /// Lists are shown with filled square bullet points.
16 | case square = "square"
17 |
18 | /// Lists are shown with a custom symbol
19 | case custom = "custom"
20 | }
21 |
--------------------------------------------------------------------------------
/Sources/Ignite/Extensions/URL-Unwrapped.swift:
--------------------------------------------------------------------------------
1 | //
2 | // URL-Unwrapped.swift
3 | // Ignite
4 | // https://www.github.com/twostraws/Ignite
5 | // See LICENSE for license information.
6 | //
7 |
8 | import Foundation
9 |
10 | public extension URL {
11 | /// Creates URLs from static strings, which will only fail if you have made
12 | /// a significant typing error.
13 | init(static string: StaticString) {
14 | if let created = URL(string: String(describing: string)) {
15 | self = created
16 | } else {
17 | fatalError("Attempted to create a URL from an invalid string: \(string)")
18 | }
19 | }
20 | }
21 |
--------------------------------------------------------------------------------
/Tests/IgniteTesting/Elements/String.swift:
--------------------------------------------------------------------------------
1 | //
2 | // String.swift
3 | // Ignite
4 | // https://www.github.com/twostraws/Ignite
5 | // See LICENSE for license information.
6 | //
7 |
8 | import Foundation
9 | import Testing
10 |
11 | @testable import Ignite
12 |
13 | /// Tests for Strings (aka Plain Text)
14 | @Suite("String Tests")
15 | @MainActor
16 | class StringTests: IgniteTestSuite {
17 | @Test("Single Element", arguments: ["This is a test", ""])
18 | func singleElement(element: String) async throws {
19 | let element = element
20 | let output = element.markupString()
21 |
22 | #expect(output == element)
23 | }
24 | }
25 |
--------------------------------------------------------------------------------
/Sources/Ignite/Extensions/String-KebabCased.swift:
--------------------------------------------------------------------------------
1 | //
2 | // String-Kebab.swift
3 | // Ignite
4 | // https://www.github.com/twostraws/Ignite
5 | // See LICENSE for license information.
6 | //
7 |
8 | import Foundation
9 |
10 | extension String {
11 | /// Converts string to kebab-case (e.g. "camelCase" -> "camel-case")
12 | func kebabCased() -> String {
13 | self
14 | .replacing(
15 | #/([a-z0-9])([A-Z])/#,
16 | with: { match in
17 | "\(match.1)-\(match.2)"
18 | }
19 | )
20 | .lowercased()
21 | .replacing(/\s+/, with: "-")
22 | }
23 | }
24 |
--------------------------------------------------------------------------------
/Sources/Ignite/Elements/Input.swift:
--------------------------------------------------------------------------------
1 | //
2 | // Input.swift
3 | // Ignite
4 | // https://www.github.com/twostraws/Ignite
5 | // See LICENSE for license information.
6 | //
7 |
8 | /// An input element for use in form controls.
9 | struct Input: InlineElement {
10 | /// The content and behavior of this HTML.
11 | var body: some InlineElement { self }
12 |
13 | /// The standard set of control attributes for HTML elements.
14 | var attributes = CoreAttributes()
15 |
16 | /// Whether this HTML belongs to the framework.
17 | var isPrimitive: Bool { true }
18 |
19 | func markup() -> Markup {
20 | Markup("Hello
Hello
") 22 | } 23 | } 24 | -------------------------------------------------------------------------------- /Makefile: -------------------------------------------------------------------------------- 1 | PREFIX_DIR := /usr/local/bin 2 | 3 | build: 4 | @echo "Building the Ignite command-line tool...\\n" 5 | @swift build -c release --product IgniteCLI 6 | 7 | install: 8 | @echo "Installing the Ignite command-line tool...\\n" 9 | @mkdir -p $(PREFIX_DIR) 2> /dev/null || ( echo "❌ Unable to create install directory \`$(PREFIX_DIR)\`. You might need to run \`sudo make\`\\n"; exit 126 ) 10 | @(install .build/release/IgniteCLI $(PREFIX_DIR)/ignite && \ 11 | install ./server.py $(PREFIX_DIR)/ignite-server.py && \ 12 | chmod +x $(PREFIX_DIR)/ignite && \ 13 | (echo \\n✅ Success! Run \`ignite\` to get started.)) || \ 14 | (echo \\n❌ Installation failed. You might need to run \`sudo make\` instead.\\n) 15 | 16 | clean: 17 | @echo "Cleaning the Ignite build folder...\\n" 18 | @rm -rf .build/ 19 | -------------------------------------------------------------------------------- /Tests/IgniteTesting/TestSubsite.swift: -------------------------------------------------------------------------------- 1 | // 2 | // TestSubsite.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Ignite 9 | 10 | /// An example site used in tests. 11 | struct TestSubsite: Site { 12 | var name = "My Test Subsite" 13 | var titleSuffix = " - My Test Subsite" 14 | var url = URL(static: "https://www.example.com/subsite") 15 | 16 | var builtInIconsEnabled: BootstrapOptions = .localBootstrap 17 | 18 | var homePage = TestSubsitePage() 19 | var layout = EmptyLayout() 20 | } 21 | 22 | /// An example page used in tests. 23 | struct TestSubsitePage: StaticPage { 24 | var title = "Subsite Home" 25 | 26 | var body: some HTML { 27 | Text("Example subsite text") 28 | } 29 | } 30 | -------------------------------------------------------------------------------- /Sources/Ignite/Types/Angle.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Angle.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// Represents an angle that can be expressed in different units 9 | public enum Angle: Sendable { 10 | /// Angle in degrees (e.g., 180 degrees) 11 | case degrees(Double) 12 | 13 | /// Angle in radians (e.g., π radians) 14 | case radians(Double) 15 | 16 | /// Angle in turns (e.g., 0.5 turns = 180 degrees) 17 | case turns(Double) 18 | 19 | /// The CSS value for the angle 20 | var value: String { 21 | switch self { 22 | case .degrees(let value): "\(value)deg" 23 | case .radians(let value): "\(value)rad" 24 | case .turns(let value): "\(value)turn" 25 | } 26 | } 27 | } 28 | -------------------------------------------------------------------------------- /Sources/Ignite/Rendering/PageMetadata.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Page.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Foundation 9 | 10 | /// A single flattened page from any source – static or dynamic – ready to be 11 | /// passed through a theme. 12 | public struct PageMetadata: Sendable { 13 | private(set) public var title: String 14 | private(set) public var description: String 15 | private(set) public var url: URL 16 | private(set) public var image: URL? 17 | } 18 | 19 | extension PageMetadata { 20 | /// Creates an empty page for use as a default value 21 | @MainActor static let empty = PageMetadata( 22 | title: "", 23 | description: "", 24 | url: URL(string: "about:blank")! 25 | ) 26 | } 27 | -------------------------------------------------------------------------------- /Sources/Ignite/Actions/ShowAlert.swift: -------------------------------------------------------------------------------- 1 | // 2 | // ShowAlert.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// Shows a browser alert dialog with an OK button. 9 | public struct ShowAlert: Action { 10 | /// The text to show inside the alert 11 | var message: String 12 | 13 | /// Creates a new ShowAlert action with its message string. 14 | /// - Parameter message: The message text to show in the alert. 15 | public init(message: String) { 16 | self.message = message 17 | } 18 | 19 | /// Renders this action using publishing context passed in. 20 | /// - Returns: The JavaScript for this action. 21 | public func compile() -> String { 22 | "alert('\(message.escapedForJavascript())')" 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /Sources/Ignite/Elements/EmptyHTML.swift: -------------------------------------------------------------------------------- 1 | // 2 | // EmptyHTML.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// A placeholder HTML element that renders nothing 9 | /// Used as a default or fallback when no content is needed 10 | public struct EmptyHTML: HTML { 11 | /// Creates a new empty HTML element 12 | public nonisolated init() {} 13 | 14 | /// Returns self as the body content since this is an empty element 15 | public var body: some HTML { self } 16 | 17 | /// Whether this HTML belongs to the framework. 18 | public var isPrimitive: Bool { true } 19 | 20 | /// Renders this element as an empty string 21 | /// - Returns: An empty string 22 | public func markup() -> Markup { 23 | Markup() 24 | } 25 | } 26 | -------------------------------------------------------------------------------- /Sources/Ignite/Framework/ElementTypes/BodyElement.swift: -------------------------------------------------------------------------------- 1 | // 2 | // BodyElement.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// An element that can exist in the `` of an HTML page. 9 | /// - Warning: Do not conform to this type directly. 10 | public protocol BodyElement: MarkupElement { 11 | /// Whether this HTML belongs to the framework. 12 | var isPrimitive: Bool { get } 13 | } 14 | 15 | public extension BodyElement { 16 | /// The default status as a primitive element. 17 | var isPrimitive: Bool { false } 18 | 19 | /// A collection of styles, classes, and attributes. 20 | var attributes: CoreAttributes { 21 | get { CoreAttributes() } 22 | set {} // swiftlint:disable:this unused_setter_value 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /Sources/Ignite/Modifiers/SmallCaps.swift: -------------------------------------------------------------------------------- 1 | // 2 | // SmallCaps.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | public extension HTML { 9 | /// Converts lowercase letters to small capitals while leaving uppercase letters unchanged. 10 | /// - Returns: A modified copy of the element with small caps applied 11 | func smallCaps() -> some HTML { 12 | self.style(.fontVariant, "small-caps") 13 | } 14 | } 15 | 16 | public extension InlineElement { 17 | /// Converts lowercase letters to small capitals while leaving uppercase letters unchanged. 18 | /// - Returns: A modified copy of the element with small caps applied 19 | func smallCaps() -> some InlineElement { 20 | self.style(.fontVariant, "small-caps") 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /Tests/IgniteTesting/Elements/Label.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Label.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Foundation 9 | import Testing 10 | 11 | @testable import Ignite 12 | 13 | /// Tests for the `Label` element. 14 | @Suite("Label Tests") 15 | @MainActor 16 | class LabelTests: IgniteTestSuite { 17 | @Test("Basic Label") 18 | func basicLabel() async throws { 19 | let element = Label("Logo", image: "/images/logo.png") 20 | let output = element.markupString() 21 | 22 | #expect(output == """ 23 | \ 24 |\
25 | Logo\
26 |
27 | """)
28 | }
29 | }
30 |
--------------------------------------------------------------------------------
/Tests/IgniteTesting/Framework/Robots/RobotsConfiguration.swift:
--------------------------------------------------------------------------------
1 | //
2 | // RobotsConfiguration.swift
3 | // Ignite
4 | // https://www.github.com/twostraws/Ignite
5 | // See LICENSE for license information.
6 | //
7 |
8 | import Foundation
9 | import Testing
10 |
11 | @testable import Ignite
12 |
13 | /// Tests for `RobotsConfiguration`.
14 | @Suite("RobotsConfiguration Tests")
15 | @MainActor
16 | struct RobotsConfigurationTests {
17 | @Test("Assert that mock conforms to protocol")
18 | func assertMockConformsToProtocol() async throws {
19 | let mock: Any = RobotsConfigurationMock()
20 | #expect(mock is RobotsConfiguration)
21 | }
22 | }
23 |
24 | // MARK: - RobotsConfigurationMock
25 |
26 | final class RobotsConfigurationMock: RobotsConfiguration {
27 | var disallowRules: [DisallowRule] = []
28 | }
29 |
--------------------------------------------------------------------------------
/Sources/Ignite/Framework/Queries/ThemeQuery.swift:
--------------------------------------------------------------------------------
1 | //
2 | // ThemeQuery.swift
3 | // Ignite
4 | // https://www.github.com/twostraws/Ignite
5 | // See LICENSE for license information.
6 | //
7 |
8 | /// Applies styles based on the current theme.
9 | public struct ThemeQuery: Query {
10 | /// The theme identifier
11 | let theme: any Theme.Type
12 |
13 | public init(_ theme: any Theme.Type) {
14 | self.theme = theme
15 | }
16 |
17 | public var condition: String {
18 | "data-bs-theme^=\"\(theme.idPrefix)\""
19 | }
20 |
21 | nonisolated public func hash(into hasher: inout Hasher) {
22 | hasher.combine(theme.idPrefix)
23 | }
24 |
25 | nonisolated public static func == (lhs: ThemeQuery, rhs: ThemeQuery) -> Bool {
26 | lhs.theme.idPrefix == rhs.theme.idPrefix
27 | }
28 | }
29 |
--------------------------------------------------------------------------------
/Tests/IgniteTesting/Elements/IgniteFooter.swift:
--------------------------------------------------------------------------------
1 | //
2 | // IgniteFooter.swift
3 | // Ignite
4 | // https://www.github.com/twostraws/Ignite
5 | // See LICENSE for license information.
6 | //
7 |
8 | import Foundation
9 | import Testing
10 |
11 | @testable import Ignite
12 |
13 | /// Tests for the `IgniteFooter` element.
14 | @Suite("IgniteFooter Tests")
15 | @MainActor
16 | class IgniteFooterTests: IgniteTestSuite {
17 | @Test("Default Ignite Footer")
18 | func defaultIgniteFooter() async throws {
19 | let element = IgniteFooter()
20 | let output = element.markupString()
21 |
22 | #expect(output == """
23 | \ 24 | Created in Swift with \ 25 | Ignite\ 26 |
27 | """) 28 | } 29 | } 30 | -------------------------------------------------------------------------------- /Sources/Ignite/Framework/Animations/AnimationTrigger.swift: -------------------------------------------------------------------------------- 1 | // 2 | // AnimationTrigger.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// Defines the events that can trigger an animation on an HTML element. 9 | public enum AnimationTrigger: String, Hashable, CaseIterable, Sendable { 10 | /// Animation triggers when the element is clicked/tapped 11 | /// - Note: Adds cursor: pointer and click event listener 12 | case click 13 | 14 | /// Animation triggers when the mouse hovers over the element 15 | /// - Note: Adds cursor: pointer and :hover CSS selector 16 | case hover 17 | 18 | /// Animation triggers when the element first appears in the viewport 19 | /// - Note: Uses IntersectionObserver for viewport detection 20 | case appear 21 | } 22 | -------------------------------------------------------------------------------- /Tests/IgniteTesting/Modifiers/TextDecoration.swift: -------------------------------------------------------------------------------- 1 | // 2 | // TextDecoration.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Foundation 9 | import Testing 10 | 11 | @testable import Ignite 12 | 13 | /// Tests for the `TextDecoration` modifier. 14 | @Suite("TextDecoration Tests") 15 | @MainActor 16 | class TextDecorationModifierTests: IgniteTestSuite { 17 | @Test("Text Decoration Modifier", arguments: TextDecoration.allCases) 18 | func textDecorationNone(_ decoration: TextDecoration) async throws { 19 | let element = Span("Hello, World!").textDecoration(decoration) 20 | let output = element.markupString() 21 | 22 | #expect(output == "Hello, World!") 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /Sources/Ignite/Rendering/ResponseErrors/PageNotFoundError.swift: -------------------------------------------------------------------------------- 1 | // 2 | // PageNotFoundError.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// An HTTP error that represents a page not found. 9 | public struct PageNotFoundError: HTTPError { 10 | public let statusCode: Int 11 | public let title: String 12 | public let description: String 13 | 14 | public init() { 15 | self.statusCode = 404 16 | self.title = "Page Not Found" 17 | self.description = "The page you are looking for could not be found." 18 | } 19 | } 20 | 21 | public extension HTTPError where Self == PageNotFoundError { 22 | /// An HTTP error that represents a page not found. 23 | static var pageNotFound: HTTPError { 24 | PageNotFoundError() 25 | } 26 | } 27 | -------------------------------------------------------------------------------- /Sources/Ignite/Actions/ToggleElementVisibility.swift: -------------------------------------------------------------------------------- 1 | // 2 | // ToggleElementVisibility.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Foundation 9 | 10 | /// Toggles an element's visibility by adding or removing the "d-none" CSS class. 11 | public struct ToggleElementVisibility: Action { 12 | /// The unique identifier of the element we're trying to show/hide. 13 | var id: String 14 | 15 | /// Creates a new ToggleElementVisibility action from a specific page element ID. 16 | /// - Parameter id: The unique identifier of the element we're trying to show/hide. 17 | public init(_ id: String) { 18 | self.id = id 19 | } 20 | 21 | public func compile() -> String { 22 | "document.getElementById('\(id)').classList.toggle('d-none')" 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /Sources/Ignite/Framework/BorderStyle.swift: -------------------------------------------------------------------------------- 1 | // 2 | // BorderStyle.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// Defines the style of a border. 9 | public enum BorderStyle: String { 10 | /// Specifies no border 11 | case none 12 | /// A series of dots 13 | case dotted 14 | /// A series of dashes 15 | case dashed 16 | /// A single solid line 17 | case solid 18 | /// Two parallel solid lines 19 | case double 20 | /// A 3D grooved effect that depends on the border color 21 | case groove 22 | /// A 3D ridged effect that depends on the border color 23 | case ridge 24 | /// A 3D inset effect that depends on the border color 25 | case inset 26 | /// A 3D outset effect that depends on the border color 27 | case outset 28 | } 29 | -------------------------------------------------------------------------------- /Sources/Ignite/Framework/EmptyInlineElement.swift: -------------------------------------------------------------------------------- 1 | // 2 | // EmptyInlineElement.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// A placeholder element that renders nothing 9 | /// Used as a default or fallback when no content is needed 10 | public struct EmptyInlineElement: InlineElement { 11 | /// Creates a new empty element 12 | public nonisolated init() {} 13 | 14 | /// Returns self as the body content since this is an empty element 15 | public var body: some InlineElement { self } 16 | 17 | /// Whether this element belongs to the framework. 18 | public var isPrimitive: Bool { true } 19 | 20 | /// Renders this element as an empty string 21 | /// - Returns: An empty string 22 | public func markup() -> Markup { 23 | Markup() 24 | } 25 | } 26 | -------------------------------------------------------------------------------- /Sources/Ignite/Actions/CustomAction.swift: -------------------------------------------------------------------------------- 1 | // 2 | // CustomAction.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// Allows the user to inject hand-written JavaScript into an event. The code you provide 9 | /// will automatically be escaped. 10 | public struct CustomAction: Action { 11 | /// The JavaScript code to execute. 12 | var code: String 13 | 14 | /// Creates a new CustomAction action from the provided JavaScript code. 15 | /// - Parameter code: The code to execute. 16 | public init(_ code: String) { 17 | self.code = code 18 | } 19 | 20 | /// Renders this action using publishing context passed in. 21 | /// - Returns: The JavaScript for this action. 22 | public func compile() -> String { 23 | code.escapedForJavascript() 24 | } 25 | } 26 | -------------------------------------------------------------------------------- /Sources/Ignite/Themes/BootstrapConstants.swift: -------------------------------------------------------------------------------- 1 | // 2 | // BootstrapConstants.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | extension Bootstrap { 9 | // Breakpoints 10 | static let smallBreakpoint: LengthUnit = .px(576) 11 | static let mediumBreakpoint: LengthUnit = .px(768) 12 | static let largeBreakpoint: LengthUnit = .px(992) 13 | static let xLargeBreakpoint: LengthUnit = .px(1200) 14 | static let xxLargeBreakpoint: LengthUnit = .px(1400) 15 | 16 | // Container sizes 17 | static let smallContainer: LengthUnit = .px(540) 18 | static let mediumContainer: LengthUnit = .px(720) 19 | static let largeContainer: LengthUnit = .px(960) 20 | static let xLargeContainer: LengthUnit = .px(1140) 21 | static let xxLargeContainer: LengthUnit = .px(1320) 22 | } 23 | -------------------------------------------------------------------------------- /Tests/IgniteTesting/Framework/Robots/KnownRobot.swift: -------------------------------------------------------------------------------- 1 | // 2 | // KnownRobot.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Foundation 9 | import Testing 10 | 11 | @testable import Ignite 12 | 13 | /// Tests for `KnownRobot`. 14 | @Suite("KnownRobot Tests") 15 | @MainActor 16 | struct KnownRobotTests { 17 | @Test("All KnownRobot cases", arguments: zip( 18 | KnownRobot.allCases, [ 19 | "Applebot", 20 | "baiduspider", 21 | "bingbot", 22 | "GPTBot", 23 | "CCBot", 24 | "Googlebot", 25 | "slurp", 26 | "yandex" 27 | ] 28 | )) 29 | func allKnowRobots(robot: KnownRobot, expectedName: String) async throws { 30 | #expect(robot.rawValue == expectedName) 31 | } 32 | } 33 | -------------------------------------------------------------------------------- /Sources/Ignite/Types/ImageFit.swift: -------------------------------------------------------------------------------- 1 | // 2 | // ImageFit.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// Represents CSS object-fit values for images 9 | public enum ImageFit: String { 10 | /// Stretches the image to fill the container without maintaining aspect ratio 11 | case fill = "fill" 12 | 13 | /// Scales the image to fit within the container while maintaining aspect ratio 14 | case fit = "contain" 15 | 16 | /// Scales the image to cover the container while maintaining aspect ratio, potentially cropping the image 17 | case cover = "cover" 18 | 19 | /// Similar to `fit` but never scales the image larger than its original size 20 | case scaleDown = "scale" 21 | 22 | /// Displays the image at its original size without scaling 23 | case none = "none" 24 | } 25 | -------------------------------------------------------------------------------- /Sources/Ignite/Actions/HideElement.swift: -------------------------------------------------------------------------------- 1 | // 2 | // HideElement.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// Hides a page element by appending the "d-none" CSS class. 9 | public struct HideElement: Action { 10 | /// The unique identifier of the element we're trying to hide. 11 | var id: String 12 | 13 | /// Creates a new HideElement action from a specific page element ID. 14 | /// - Parameter id: The unique identifier of the element we're trying to hide. 15 | public init(_ id: String) { 16 | self.id = id 17 | } 18 | 19 | /// Renders this action using publishing context passed in. 20 | /// - Returns: The JavaScript for this action. 21 | public func compile() -> String { 22 | "document.getElementById('\(id)').classList.add('d-none')" 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /Sources/Ignite/Actions/ShowElement.swift: -------------------------------------------------------------------------------- 1 | // 2 | // ShowElement.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// Shows a page element by removing the "d-none" CSS class. 9 | public struct ShowElement: Action { 10 | /// The unique identifier of the element we're trying to hide. 11 | var id: String 12 | 13 | /// Creates a new ShowElement action from a specific page element ID. 14 | /// - Parameter id: The unique identifier of the element we're trying to hide. 15 | public init(_ id: String) { 16 | self.id = id 17 | } 18 | 19 | /// Renders this action using publishing context passed in. 20 | /// - Returns: The JavaScript for this action. 21 | public func compile() -> String { 22 | "document.getElementById('\(id)').classList.remove('d-none')" 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /Sources/Ignite/Framework/Robots/DisallowRule.swift: -------------------------------------------------------------------------------- 1 | // 2 | // DisallowRule.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// A rule that disallows one specific robot from one or more paths on your site. 9 | public struct DisallowRule { 10 | var name: String 11 | var paths: [String] 12 | 13 | public init(name: String, paths: [String]) { 14 | self.name = name 15 | self.paths = paths 16 | } 17 | 18 | public init(name: String) { 19 | self.name = name 20 | self.paths = ["*"] 21 | } 22 | 23 | public init(robot: KnownRobot, paths: [String]) { 24 | self.name = robot.rawValue 25 | self.paths = paths 26 | } 27 | 28 | public init(robot: KnownRobot) { 29 | self.name = robot.rawValue 30 | self.paths = ["*"] 31 | } 32 | } 33 | -------------------------------------------------------------------------------- /Sources/Ignite/Publishing/RobotsGenerator.swift: -------------------------------------------------------------------------------- 1 | // 2 | // RobotsGenerator.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | @MainActor 9 | struct RobotsGenerator { 10 | var site: any Site 11 | 12 | func generateRobots() -> String { 13 | let disallowRules = site.robotsConfiguration.disallowRules.map { rule in 14 | var ruleText = "User-agent: \(rule.name)\n" 15 | 16 | ruleText += rule.paths.map { 17 | "Disallow: \($0)\n" 18 | }.joined() 19 | 20 | return "\(ruleText)\n" 21 | }.joined() 22 | 23 | let result = """ 24 | \(disallowRules)\ 25 | User-agent: * 26 | Allow: / 27 | 28 | Sitemap: \(site.url.absoluteString)/sitemap.xml 29 | """ 30 | 31 | return result 32 | } 33 | } 34 | -------------------------------------------------------------------------------- /Sources/Ignite/Actions/SwitchTheme.swift: -------------------------------------------------------------------------------- 1 | // 2 | // SwitchTheme.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// An action that switches between themes by updating data-bs-theme 9 | /// and data-theme-state attributes on the document root. 10 | public struct SwitchTheme: Action { 11 | let themeID: String 12 | 13 | /// Creates a new theme switching action 14 | /// - Parameter theme: The ID of the theme to switch to (will be automatically sanitized) 15 | @MainActor public init(_ theme: any Theme) { 16 | self.themeID = theme.cssID 17 | } 18 | 19 | /// Compiles the action into JavaScript code that calls the switchTheme function 20 | /// - Returns: JavaScript code to execute the theme switch 21 | public func compile() -> String { 22 | "igniteSwitchTheme('\(themeID)');" 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /Sources/Ignite/Framework/Analytics/AnalyticsService.swift: -------------------------------------------------------------------------------- 1 | // 2 | // AnalyticsService.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Foundation 9 | 10 | extension Analytics { 11 | /// Defines the different types of analytics services supported 12 | public enum Service { 13 | /// Google Analytics 4 14 | case googleAnalytics(measurementID: String) 15 | /// Plausible Analytics 16 | case plausible(domain: String, measurements: Setimport Foundation
31 | struct CodeBlockTest {
32 | let name: String
33 | }
34 | let test = CodeBlockTest(name: "Swift")This is not an exercice
Hello
") 22 | } 23 | 24 | @Test("Clipped Modifier on Custom Element") 25 | func clippedModifier_onCustomElement() async throws { 26 | let element = TestElement().clipped() 27 | let output = element.markupString() 28 | #expect(output == """ 29 |Test Heading!
\ 31 |Test Subheading
\ 32 | \ 33 |Hello, world!
") 23 | } 24 | 25 | @Test("Preset Line Spacing", arguments: LineSpacing.allCases) 26 | func lineSpacing(spacing: LineSpacing) async throws { 27 | let element = Text("Hello, world!").lineSpacing(spacing) 28 | let output = element.markupString() 29 | 30 | #expect(output == "Hello, world!
") 31 | } 32 | } 33 | -------------------------------------------------------------------------------- /Sources/Ignite/Modifiers/PrivacySensitive.swift: -------------------------------------------------------------------------------- 1 | // 2 | // PrivacySensitive.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// Specifies what content should be encoded for privacy protection 9 | public enum PrivacyEncoding: String, Sendable { 10 | /// Only encode the URL (default) 11 | case urlOnly 12 | 13 | /// Encode both the URL and display text 14 | case urlAndDisplay 15 | } 16 | 17 | public extension Link { 18 | /// Marks this link as containing sensitive content that should be protected from scraping. 19 | /// Use this to protect email addresses, phone numbers, or other sensitive URLs from being 20 | /// scraped by bots while still remaining clickable for real users. 21 | /// 22 | /// - Parameter encoding: Controls what content gets encoded for privacy protection 23 | /// - Returns: A copy of the current link with protection enabled 24 | func privacySensitive(_ encoding: PrivacyEncoding = .urlOnly) -> some InlineElement { 25 | self.customAttribute(name: "privacy-sensitive", value: encoding.rawValue) 26 | } 27 | } 28 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2024 Paul Hudson and other authors. 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. -------------------------------------------------------------------------------- /Sources/Ignite/Rendering/ResultBuilders/DocumentElementBuilder.swift: -------------------------------------------------------------------------------- 1 | // 2 | // DocumentElementBuilder.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// A result builder for populating the children of a `Document`. 9 | @MainActor 10 | @resultBuilder 11 | public struct DocumentElementBuilder { 12 | /// Creates a tuple containing the provided head and body elements. 13 | /// - Parameters: 14 | /// - head: The document's head section containing metadata. 15 | /// - body: The document's body section containing main content. 16 | /// - Returns: A tuple containing the provided head and body elements. 17 | public static func buildBlock(_ head: Head, _ body: Body) -> (Head, Body) { 18 | (head, body) 19 | } 20 | 21 | /// Creates a tuple containing a default head and the provided body element. 22 | /// - Parameter body: The document's body section containing main content. 23 | /// - Returns: A tuple containing a default head and the provided body element. 24 | public static func buildBlock(_ body: Body) -> (Head, Body) { 25 | (Head(), body) 26 | } 27 | } 28 | -------------------------------------------------------------------------------- /Sources/Ignite/Framework/Environment/Environment.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Environment.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// A property wrapper that provides access to values from the environment. 9 | /// 10 | /// Use `Environment` to read values that are propagated through your site's view hierarchy. For example: 11 | /// 12 | /// ```swift 13 | /// struct ContentView: HTMLRootElement { 14 | /// @Environment(\.themes) var themes 15 | /// } 16 | /// ``` 17 | @MainActor 18 | @propertyWrapper public struct EnvironmentTest Heading!
\ 32 |Test Subheading
\ 33 | \ 34 |Hello
") 23 | } 24 | 25 | @Test("All Text Selection") 26 | func allTextSelection() async throws { 27 | let element = Text("Hello").textSelection(.all) 28 | let output = element.markupString() 29 | 30 | #expect(output == "Hello
") 31 | } 32 | 33 | @Test("None Text Selection") 34 | func noneTextSelection() async throws { 35 | let element = Text("Hello").textSelection(.none) 36 | let output = element.markupString() 37 | 38 | #expect(output == "Hello
") 39 | } 40 | } 41 | -------------------------------------------------------------------------------- /Sources/Ignite/Resources/js/prism-typescript.js: -------------------------------------------------------------------------------- 1 | !function(e){e.languages.typescript=e.languages.extend("javascript",{"class-name":{pattern:/(\b(?:class|extends|implements|instanceof|interface|new|type)\s+)(?!keyof\b)(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*(?:\s*<(?:[^<>]|<(?:[^<>]|<[^<>]*>)*>)*>)?/,lookbehind:!0,greedy:!0,inside:null},builtin:/\b(?:Array|Function|Promise|any|boolean|console|never|number|string|symbol|unknown)\b/}),e.languages.typescript.keyword.push(/\b(?:abstract|declare|is|keyof|readonly|require)\b/,/\b(?:asserts|infer|interface|module|namespace|type)\b(?=\s*(?:[{_$a-zA-Z\xA0-\uFFFF]|$))/,/\btype\b(?=\s*(?:[\{*]|$))/),delete e.languages.typescript.parameter,delete e.languages.typescript["literal-property"];var s=e.languages.extend("typescript",{});delete s["class-name"],e.languages.typescript["class-name"].inside=s,e.languages.insertBefore("typescript","function",{decorator:{pattern:/@[$\w\xA0-\uFFFF]+/,inside:{at:{pattern:/^@/,alias:"operator"},function:/^[\s\S]+/}},"generic-function":{pattern:/#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*\s*<(?:[^<>]|<(?:[^<>]|<[^<>]*>)*>)*>(?=\s*\()/,greedy:!0,inside:{function:/^#?(?!\s)[_$a-zA-Z\xA0-\uFFFF](?:(?!\s)[$\w\xA0-\uFFFF])*/,generic:{pattern:/<[\s\S]+/,alias:"class-name",inside:s}}}}),e.languages.ts=e.languages.typescript}(Prism); 2 | -------------------------------------------------------------------------------- /Sources/Ignite/Rendering/TabFocus.swift: -------------------------------------------------------------------------------- 1 | // 2 | // TabFocus.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// An enum representing the `tabindex` attribute for controlling the tab order and focus behavior of HTML elements. 9 | public enum TabFocus { 10 | /// The element is focusable but not part of the tab order (equivalent to `tabindex="-1"`). 11 | case focusable 12 | 13 | /// The element is focusable and part of the natural tab order (equivalent to `tabindex="0"`). 14 | case auto 15 | 16 | /// The element is focusable and has a custom tab order specified by the associated integer 17 | /// value (equivalent to `tabindex` with a positive integer). 18 | /// - Parameter index: A positive integer specifying the custom tab order. 19 | case custom(Int) 20 | 21 | /// The `tabindex` value corresponding to the enum case. 22 | var value: String { 23 | switch self { 24 | case .focusable: 25 | return "-1" 26 | case .auto: 27 | return "0" 28 | case .custom(let index): 29 | return "\(index)" 30 | } 31 | } 32 | 33 | /// The html name for this attribute 34 | var htmlName: String { 35 | "tabindex" 36 | } 37 | } 38 | -------------------------------------------------------------------------------- /Tests/IgniteTesting/Elements/Section.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Section.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Foundation 9 | import Testing 10 | 11 | @testable import Ignite 12 | 13 | /// Tests for the `Section` element. 14 | @Suite("Section Tests") 15 | @MainActor 16 | class SectionTests: IgniteTestSuite { 17 | @Test("Section") 18 | func section() async throws { 19 | let element = Section { 20 | Span("Hello, World!") 21 | Span("Goodbye, World!") 22 | } 23 | 24 | let output = element.markupString() 25 | #expect(output == "Hello
") 23 | } 24 | 25 | @Test("Verify Content Modes", arguments: AspectRatio.allCases, ContentMode.allCases) 26 | func verifyContentModes(ratio: AspectRatio, mode: ContentMode) async throws { 27 | let element = Image("/images/example.jpg").aspectRatio(ratio, contentMode: mode) 28 | let output = element.markupString() 29 | 30 | #expect(output == """ 31 |
Hello
") 22 | } 23 | 24 | @Test("Border Modifier with Specific Edges") 25 | func borderWithSpecificEdges() async throws { 26 | let element = Text("Hello").border(.blue, width: 1.0, style: .dotted, edges: [.top, .bottom]) 27 | let output = element.markupString() 28 | #expect(output.contains("border-top: 1.0px dotted rgb(0 0 255 / 100%)")) 29 | #expect(output.contains("border-bottom: 1.0px dotted rgb(0 0 255 / 100%)")) 30 | #expect(!output.contains("border-left")) 31 | #expect(!output.contains("border-right")) 32 | } 33 | } 34 | -------------------------------------------------------------------------------- /Sources/Ignite/Framework/InlineStyle.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Declaration.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// A simple property-value pair of strings that is able to store inline styles 9 | struct InlineStyle: Hashable, Equatable, Sendable, Comparable, CustomStringConvertible { 10 | /// The property, e.g. `\.color`. 11 | var property: String 12 | 13 | /// The declaration's value, e.g. "blue". 14 | var value: String 15 | 16 | init(_ property: Property, value: String) { 17 | self.property = property.rawValue 18 | self.value = value 19 | } 20 | 21 | init(_ property: String, value: String) { 22 | self.property = property 23 | self.value = value 24 | } 25 | 26 | /// The full declaration, e.g. "color: blue"" 27 | var description: String { 28 | property + ": " + value 29 | } 30 | 31 | static func < (lhs: InlineStyle, rhs: InlineStyle) -> Bool { 32 | lhs.description < rhs.description 33 | } 34 | 35 | func important(_ isImportant: Bool = true) -> InlineStyle { 36 | if isImportant { 37 | InlineStyle(self.property, value: self.value + " !important") 38 | } else { 39 | self 40 | } 41 | } 42 | } 43 | -------------------------------------------------------------------------------- /Sources/Ignite/Themes/Fonts/FontWeight.swift: -------------------------------------------------------------------------------- 1 | // 2 | // FontWeight.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | public typealias FontWeight = Font.Weight 9 | 10 | /// The list of standard font weights supported by HTML. This 11 | /// is designed to match the same order provided by SwiftUI. 12 | /// Note: Bootstrap provides its own font weights as classes, 13 | /// but these are less close to both regular CSS and SwiftUI. 14 | public extension Font { 15 | enum Weight: Int, Defaultable, CaseIterable, Sendable, CustomStringConvertible { 16 | case ultraLight = 100 17 | case thin = 200 18 | case light = 300 19 | case regular = 400 20 | case medium = 500 21 | case semibold = 600 22 | case bold = 700 23 | case heavy = 800 24 | case black = 900 25 | 26 | /// Special value indicating default 27 | static var `default`: Self { .regular } 28 | 29 | /// Indicates whether this unit represents a default value 30 | var isDefault: Bool { 31 | if self == .default { return true } 32 | return false 33 | } 34 | 35 | public var description: String { 36 | rawValue.formatted() 37 | } 38 | } 39 | } 40 | -------------------------------------------------------------------------------- /Sources/IgniteCLI/QR Generation/ErrorCorrection.swift: -------------------------------------------------------------------------------- 1 | // 2 | // ErrorCorrection.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// The level of error correction to use in a QR code. 9 | /// 10 | /// QR codes can incorporate different levels of error correction, allowing the code 11 | /// to be read even when partially damaged or obscured. 12 | enum ErrorCorrection: Int, CaseIterable, Sendable { 13 | /// Low level error correction. Approximately 7% of data can be restored. 14 | case low = 0 15 | 16 | /// Medium level error correction. Approximately 15% of data can be restored. 17 | case medium = 1 18 | 19 | /// Quantize level error correction. Approximately 25% of data can be restored. 20 | case quantize = 2 21 | 22 | /// High level error correction. Approximately 30% of data can be restored. 23 | case high = 3 24 | 25 | /// The default error correction level (`.quantize`). 26 | static let `default` = ErrorCorrection.quantize 27 | 28 | /// The CoreImage error correction string representation. 29 | var level: String { 30 | switch self { 31 | case .low: return "L" 32 | case .medium: return "M" 33 | case .quantize: return "Q" 34 | case .high: return "H" 35 | } 36 | } 37 | } 38 | -------------------------------------------------------------------------------- /Sources/Ignite/Modifiers/FontStyleModifier.swift: -------------------------------------------------------------------------------- 1 | // 2 | // FontStyleModifier.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | @MainActor private func fontStyleModifier( 9 | _ style: Font.Style, 10 | content: any HTML 11 | ) -> any HTML { 12 | if content.isText { 13 | content.fontStyle(style) 14 | } else { 15 | content.class(style.sizeClass) 16 | } 17 | } 18 | 19 | @MainActor private func fontStyleModifier( 20 | _ style: Font.Style, 21 | content: any InlineElement 22 | ) -> any InlineElement { 23 | content.fontStyle(style) 24 | } 25 | 26 | public extension HTML { 27 | /// Adjusts the heading level of this text. 28 | /// - Parameter style: The new heading level. 29 | /// - Returns: A new `Text` instance with the updated font style. 30 | func font(_ style: Font.Style) -> some HTML { 31 | AnyHTML(fontStyleModifier(style, content: self)) 32 | } 33 | } 34 | 35 | public extension InlineElement { 36 | /// Adjusts the heading level of this text. 37 | /// - Parameter style: The new heading level. 38 | /// - Returns: A new `Text` instance with the updated font style. 39 | func font(_ style: Font.Style) -> some InlineElement { 40 | AnyInlineElement(fontStyleModifier(style, content: self)) 41 | } 42 | } 43 | -------------------------------------------------------------------------------- /Tests/IgniteTesting/Modifiers/BadgeModifier.swift: -------------------------------------------------------------------------------- 1 | // 2 | // BadgeModifier.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Foundation 9 | import Testing 10 | 11 | @testable import Ignite 12 | 13 | /// Tests for the `BadgeModifier` modifier. 14 | @Suite("BadgeModifier Tests") 15 | @MainActor 16 | class BadgeModifierTests: IgniteTestSuite { 17 | @Test("Badge Modifier for InlineHTML") 18 | func badgeModifierForInlineHTML() async throws { 19 | let element = Text("Notifications").badge(Badge("3")) 20 | 21 | let output = element.markupString() 22 | 23 | #expect(output == """ 24 |Notifications
\ 26 | 3\ 27 |Messages
\ 42 |\ 27 |29 | """) 30 | } 31 | 32 | @Test("Quote With Caption", arguments: ["Programming is an art."], ["Paul Hudson"]) 33 | func quoteWithCaptionTest(quoteText: String, captionText: String) async throws { 34 | let element = Quote { 35 | Text(quoteText) 36 | } caption: { 37 | captionText 38 | } 39 | 40 | let output = element.markupString() 41 | 42 | #expect(output == """ 43 |\(quoteText)
\ 28 |
\ 44 |47 | """) 48 | } 49 | } 50 | -------------------------------------------------------------------------------- /Sources/Ignite/Modifiers/Cursor.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Cursor.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | public enum Cursor: String, CaseIterable, Sendable { 9 | /// The cursor to display based on the current context. E.g., equivalent to text when hovering text. 10 | case auto 11 | 12 | /// Default cursor. Typically an arrow. 13 | case `default` 14 | 15 | /// No cursor is rendered. 16 | case pointer 17 | 18 | /// Something can be zoomed (magnified) in. 19 | case zoomIn = "zoom-in" 20 | 21 | /// Something can be zoomed (magnified) out. 22 | case zoomOut = "zoom-out" 23 | } 24 | 25 | public extension HTML { 26 | /// Changes the cursor appearance of the element when hovering over the element. 27 | /// - Parameter cursor: The desired cursor style. 28 | /// - Returns: A modified copy of the element with cursor styling applied 29 | func cursor(_ cursor: Cursor) -> some HTML { 30 | self.style(.cursor, cursor.rawValue) 31 | } 32 | } 33 | 34 | public extension InlineElement { 35 | /// Changes the cursor appearance of the element when hovering over the element. 36 | /// - Parameter cursor: The desired cursor style. 37 | /// - Returns: A modified copy of the element with cursor styling applied 38 | func cursor(_ cursor: Cursor) -> some InlineElement { 39 | self.style(.cursor, cursor.rawValue) 40 | } 41 | } 42 | -------------------------------------------------------------------------------- /Sources/Ignite/Resources/css/prism-okaidia.min.css: -------------------------------------------------------------------------------- 1 | /* PrismJS 1.29.0 */ 2 | code[class*=language-],pre[class*=language-]{color:#f8f8f2;background:0 0;text-shadow:0 1px rgba(0,0,0,.3);font-family:var(--bs-font-monospace,Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace);font-size:var(--code-block-font-size, 1em);text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.5;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*=language-]{padding:1em;margin:.5em 0;overflow:auto;border-radius:.3em}:not(pre)>code[class*=language-],pre[class*=language-]{background:#272822}:not(pre)>code[class*=language-]{padding:.1em;border-radius:.3em;white-space:normal}.token.cdata,.token.comment,.token.doctype,.token.prolog{color:#8292a2}.token.punctuation{color:#f8f8f2}.token.namespace{opacity:.7}.token.constant,.token.deleted,.token.property,.token.symbol,.token.tag{color:#f92672}.token.boolean,.token.number{color:#ae81ff}.token.attr-name,.token.builtin,.token.char,.token.inserted,.token.selector,.token.string{color:#a6e22e}.language-css .token.string,.style .token.string,.token.entity,.token.operator,.token.url,.token.variable{color:#f8f8f2}.token.atrule,.token.attr-value,.token.class-name,.token.function{color:#e6db74}.token.keyword{color:#66d9ef}.token.important,.token.regex{color:#fd971f}.token.bold,.token.important{font-weight:700}.token.italic{font-style:italic}.token.entity{cursor:help} 3 | -------------------------------------------------------------------------------- /Sources/Ignite/Modifiers/Attribute Modifiers/IDModifier.swift: -------------------------------------------------------------------------------- 1 | // 2 | // IDModifier.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | @MainActor 9 | private func idModifier(_ id: String, content: any HTML) -> any HTML { 10 | guard !id.isEmpty else { return content } 11 | var copy: any HTML = content.isPrimitive ? content : Section(content) 12 | copy.attributes.id = id 13 | return copy 14 | } 15 | 16 | @MainActor 17 | private func idModifier(_ id: String, content: any InlineElement) -> any InlineElement { 18 | guard !id.isEmpty else { return content } 19 | var copy: any InlineElement = content.isPrimitive ? content : Span(content) 20 | copy.attributes.id = id 21 | return copy 22 | } 23 | 24 | public extension HTML { 25 | /// Sets the `HTML` id attribute of the element. 26 | /// - Parameter id: The HTML ID value to set 27 | /// - Returns: A modified copy of the element with the HTML id added 28 | func id(_ id: String) -> some HTML { 29 | AnyHTML(idModifier(id, content: self)) 30 | } 31 | } 32 | 33 | public extension InlineElement { 34 | /// Sets the `HTML` id attribute of the element. 35 | /// - Parameter id: The HTML ID value to set 36 | /// - Returns: A modified copy of the element with the HTML ID added 37 | func id(_ id: String) -> some InlineElement { 38 | AnyInlineElement(idModifier(id, content: self)) 39 | } 40 | } 41 | -------------------------------------------------------------------------------- /Sources/Ignite/Styles/StyledHTML.swift: -------------------------------------------------------------------------------- 1 | // 2 | // StyledHTML.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | /// A concrete type used for style resolution that only holds attributes 9 | @MainActor public struct StyledHTML { 10 | /// A collection of styles, classes, and attributes. 11 | var attributes = CoreAttributes() 12 | 13 | /// Adds inline styles to the element. 14 | /// - Parameter values: Variable number of `InlineStyle` objects 15 | /// - Returns: The modified `HTML` element 16 | public func style(_ property: Property, _ value: String) -> Self { 17 | var copy = self 18 | copy.attributes.append(styles: .init(property, value: value)) 19 | return copy 20 | } 21 | } 22 | 23 | extension StyledHTML { 24 | /// Adds inline styles to the element. 25 | /// - Parameter values: An array of `InlineStyle` objects 26 | /// - Returns: The modified `HTML` element 27 | func style(_ styles: [InlineStyle]) -> Self { 28 | var copy = self 29 | copy.attributes.append(styles: styles) 30 | return copy 31 | } 32 | 33 | /// Adds inline styles to the element. 34 | /// - Parameter values: An array of `InlineStyle` objects 35 | /// - Returns: The modified `HTML` element 36 | func style(_ styles: InlineStyle...) -> Self { 37 | var copy = self 38 | copy.attributes.append(styles: styles) 39 | return copy 40 | } 41 | } 42 | -------------------------------------------------------------------------------- /Tests/IgniteTesting/Modifiers/Hidden.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Hidden.swift 3 | // Ignite 4 | // https://www.github.com/twostraws/Ignite 5 | // See LICENSE for license information. 6 | // 7 | 8 | import Foundation 9 | import Testing 10 | 11 | @testable import Ignite 12 | 13 | /// Tests for the `Hidden` modifier. 14 | @Suite("Hidden Tests") 15 | @MainActor 16 | struct HiddenTests { 17 | @Test("Hidden Modifier for Text") 18 | func hiddenForText() async throws { 19 | let element = Text("Hello world!").hidden() 20 | let output = element.markupString() 21 | 22 | #expect(output == "\(quoteText)
\ 45 | \ 46 |
Hello world!
") 23 | } 24 | 25 | @Test("MediaQuery based hidden Modifier for Text") 26 | func hiddenMediaQueryForText() async throws { 27 | let className = CSSManager.shared.registerStyles(.init(small: true)) 28 | let element = Text("Hello world!").hidden(.responsive(small: true)) 29 | let output = element.markupString() 30 | 31 | #expect(output == "Hello world!
") 32 | } 33 | 34 | @Test("Hidden Modifier for Column") 35 | func hiddenForColumn() async throws { 36 | let element = Column { 37 | ControlLabel("Left Label") 38 | ControlLabel("Right Label") 39 | }.hidden() 40 | let output = element.markupString() 41 | 42 | #expect(output == "Column 1
Column 2
Column 1
Column 2
Column 1
Column 2