Utilities

PrismFoundation includes a set of lightweight utilities for common tasks — persistent storage, date formatting, file management, localization, and convenient Swift extensions.

PrismDefaults

A UserDefaults wrapper with Codable type support. Uses a dedicated "prism.defaults" suite by default.

Storing and Retrieving Values

import PrismFoundation

let defaults = PrismDefaults()

// Store a Codable value
struct Settings: Codable {
    var theme: String
    var fontSize: Int
}

let settings = Settings(theme: "dark", fontSize: 14)
defaults.set(settings, for: "userSettings")

// Retrieve it later
let saved: Settings? = defaults.get(for: "userSettings")
print(saved?.theme) // "dark"

// Remove a key
defaults.set(nil as Settings?, for: "userSettings")

Pass a custom UserDefaults instance via PrismDefaults(userDefaults:) for app groups or testing.

PrismDateFormatter

Utilities for consistent date formatting across your app.

Date Formatting

import PrismFoundation

let formatter = PrismDateFormatter()
// Format dates using predefined styles

PrismFileManager

File system operations with a Prism-native API.

File Operations

import PrismFoundation

let fileManager = PrismFileManager()
// Read, write, and manage files

PrismFilePrivacy

File protection levels for sensitive data on disk.

File Privacy

import PrismFoundation

let privacy = PrismFilePrivacy()
// Set protection levels on files

PrismBundle

Access to bundle resources (strings, images, data files) through a typed API.

Bundle Access

import PrismFoundation

let bundle = PrismBundle()
// Load resources from the app bundle

Locale Handling

PrismLocale and PrismLocaleManager provide locale-aware formatting and management.

Locale Management

import PrismFoundation

let localeManager = PrismLocaleManager()
// Manage app locale, format numbers and currencies

Extensions

PrismFoundation extends common Swift types with convenience methods:

Array Extensions

Safe subscript access, chunking, unique filtering, and more.

String Extensions

Trimming, regex matching, slug generation, and encoding utilities.

Data Extensions

Hex encoding, hashing shortcuts, and Codable helpers.

Date Extensions

Relative date formatting, component extraction, and comparison helpers.

Encodable Extensions

.data() and .json properties for quick JSON serialization.

Numeric Extensions

BinaryInteger and BinaryFloatingPoint formatting, clamping, and conversion helpers.

Extension Examples

import PrismFoundation

// Encodable → JSON string
let user = User(id: UUID(), name: "Alice", email: "alice@example.com")
let json = try user.json  // JSON string

// Encodable → Data
let data = try user.data() // JSON Data

Getting Started

Foundation

Network

Architecture

UI

Intelligence

Gamification

Security

Storage

Capabilities

Video

Utilities

Utilities

PrismDefaults

PrismDateFormatter

PrismFileManager

PrismFilePrivacy

PrismBundle

Locale Handling

Extensions

Array Extensions

String Extensions

Data Extensions

Date Extensions

Encodable Extensions

Numeric Extensions

​Utilities

​PrismDefaults

​PrismDateFormatter

​PrismFileManager

​PrismFilePrivacy

​PrismBundle

​Locale Handling

​Extensions

Array Extensions

String Extensions

Data Extensions

Date Extensions

Encodable Extensions

Numeric Extensions

Utilities

PrismDefaults

PrismDateFormatter

PrismFileManager

PrismFilePrivacy

PrismBundle

Locale Handling

Extensions