Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.prism.byescaleira.com/llms.txt

Use this file to discover all available pages before exploring further.

Prism follows Semantic Versioning and documents every notable change in the format defined by Keep a Changelog. The entries below cover the most significant releases. Each accordion lists what was added, changed, and fixed in that version so you can quickly assess the impact of upgrading.
This page highlights key releases. For the complete, unabridged history — including every merge commit and CI fix — see the GitHub Releases page.

Recent releases

Added

Developer experience tooling
  • PrismComponentGenerator — code generation from six templates (button, card, form, list, detail, settings)
  • PrismTokenInspector — debug panel showing active theme tokens at runtime
  • PrismComponentDebugger — render tracking with a debug overlay
  • PrismLiveReloadServer — protocol-based live reload coordination
  • PrismPrototyper — interactive screen builder with flow navigation
  • PrismEnvironmentDebugger — floating badge showing current environment state
SwiftData integration
  • PrismModelView — generic SwiftData CRUD list with a detail view
  • PrismModelFormBuilder — declarative form generation from field definitions
  • PrismMigrationHelper — ordered migration stage management
  • PrismCloudSyncMonitor — sync state monitoring with a status indicator view
  • PrismPredicateBuilder — chainable filter API with PrismFilterBar UI
Internationalization v2
  • PrismLayoutDirection, PrismBidirectionalStack — automatic RTL/LTR layout handling
  • PrismPluralRule — locale-aware plural categories (English, Arabic, Russian, Japanese)
  • PrismNumberFormatter, PrismDateFormatter, PrismRelativeTimeFormatter — locale-sensitive formatting
  • PrismLocalizedKey, PrismStringExporter — localization key management
  • PrismMultiLocalePreview — side-by-side locale comparison
Accessibility v3
  • PrismColorBlindnessSimulator — seven vision-type simulations with a view modifier
  • PrismFocusOrderValidator — priority-based focus order checking
  • PrismVoiceControlGroup and modifiers for voice control accessibility
  • PrismContrastChecker — WCAG contrast ratio, level compliance, and auto color suggestion
  • PrismAccessibilityAnnouncer — priority-based screen reader announcements
Performance toolkit
  • PrismLazyView — deferred body evaluation with placeholder support
  • PrismRenderProfiler — real-time render count and timing with a debug overlay
  • PrismMemoryTrackerV2mach_task_basic_info memory snapshots
  • PrismImageDownsamplerCGImageSource-based downsampling for memory efficiency
  • PrismPrefetchCoordinator — protocol-based prefetch task management

Added

  • Structured logging: PrismStructuredLogger actor with level-filtered, buffered logging, PrismLogLevel, PrismLogEntry, and a pluggable PrismLogDestination protocol
  • Crash reporter: PrismCrashReporter actor — collects PrismCrashReport structs with stack traces, app version, metadata, and an optional callback
  • Performance traces: PrismPerformanceTracer actor — hierarchical PrismTraceSpan with beginSpan/endSpan and an auto-traced measure() helper
  • Network inspector: PrismNetworkInspector actor — records PrismNetworkLog entries with aggregate averageLatency and errorRate metrics
  • Analytics funnel: PrismAnalyticsFunnel actor — define ordered steps, record unique users per step, and generate conversion rate reports
  • 25 new tests (785 total)

Added

  • Embedding store: PrismEmbedding, PrismEmbeddingStore actor — vector storage with cosine similarity search
  • RAG pipeline: PrismRAGConfig, PrismTextChunker, PrismRAGPipeline — chunk, embed, store, retrieve, and generate workflow
  • Vision classifier: PrismVisionClassifier — image classification via the Vision framework (VNClassifyImageRequest)
  • NLP actions: PrismNLPActions — sentiment analysis, entity extraction, language detection, and tokenization via NaturalLanguage
  • Structured output: PrismStructuredParser, PrismOutputValidator — JSON extraction, key-value parsing, and schema validation
  • Model manager: PrismModelManager actor — model lifecycle management with register, unload, and hot-swap
  • 22+ new tests (Swift Testing)

Added

  • Time-travel debugging: PrismStateSnapshot, PrismTimeTravelDebugger — record, navigate, and jump through state history with configurable snapshot limits
  • State persistence: PrismPersistenceStrategy protocol with PrismDiskPersistence, PrismKeychainPersistence, and PrismUserDefaultsPersistence — pluggable state-saving strategies
  • Persist middleware: PrismPersistMiddleware — auto-saves state changes via any persistence strategy
  • Derived stores: PrismDerivedStore — read-only projected view of a parent store with Equatable-based change detection
  • Store scope: PrismStoreScope — scoped store for child features with action mapping
  • Middleware chaining DSL: PrismChainableMiddleware protocol, PrismLoggingMiddleware, PrismThrottleMiddleware, and PrismMiddlewareChain builder
  • Undo/redo stack: PrismUndoRedoStack — configurable undo/redo state management with stack size limits
  • 30 new tests

Added

  • Retry policies: PrismRetryPolicy protocol, PrismExponentialBackoff (exponential backoff with jitter), PrismLinearRetry (fixed delay), PrismRetryableRequest wrapper
  • Request deduplication: PrismRequestDeduplicator actor — coalesces identical in-flight requests by key (URL + method + body hash)
  • Offline queue: PrismQueuedRequest struct, PrismOfflineQueue actor with priority-based dequeue and auto-flush via PrismConnectivityMonitor (NWPathMonitor)
  • Response caching: PrismCachePolicy enum (four strategies), PrismCacheEntry with TTL, PrismResponseCache actor with LRU eviction
  • GraphQL support: PrismGraphQLQuery, PrismGraphQLResponse<T>, PrismGraphQLError, PrismGraphQLClient actor for typed query and mutation execution
  • Multipart upload: PrismMultipartFormData builder, PrismUploadProgress tracker, PrismUploadTask actor with AsyncStream progress
  • 27 new tests

Added

  • KPI card: PrismKPICard — metric card with title, value, trend, change percentage, sparkline, and compact/expanded sizes
  • Trend enum: PrismTrend — up/down/flat direction with semantic color coding (green/red/gray)
  • Stat grid: PrismStatGrid, PrismStatItem — responsive grid of stat items with adaptive columns
  • Activity feed: PrismActivityFeed, PrismActivity, PrismActivityGroup — chronological feed with avatars, relative timestamps, and date grouping
  • Timeline: PrismTimeline, PrismTimelineEvent, PrismEventStatus — vertical timeline with connecting line and status dots (completed/current/upcoming/failed)
  • Comparison table: PrismComparisonTable, PrismComparisonFeature, PrismComparisonColumn, PrismFeatureValue — feature comparison grid with a highlighted column
  • Sparkline row: PrismSparklineRow — inline label + value + sparkline with an optional trend indicator
  • 30 new tests

Added

  • Chat bubble: PrismChatBubble — message bubble with sender alignment, timestamp, and delivery status
  • Bubble styles: PrismBubbleStyle — filled, outlined, and glass visual variants
  • Message list: PrismMessageList — scrollable conversation view with date separators and auto-scroll
  • Message model: PrismMessage and PrismMessageStatus — chat message data with five-state delivery tracking
  • Message grouping: PrismMessageGroup — groups consecutive messages from the same sender
  • Typing indicator: PrismTypingIndicator — animated bouncing dots with staggered animation
  • Reaction picker: PrismReactionPicker — horizontal emoji strip with pop-in animation
  • Reaction bar: PrismReactionBar — displays emoji reactions with counts below a message
  • Thread view: PrismThreadView — root message with indented, collapsible replies
  • Read receipts: PrismReadReceiptIndicator — checkmark icons for sent, delivered, and read status
  • 35 new tests

Added

  • Markdown renderer: PrismMarkdownView — renders Markdown strings as styled SwiftUI with headings, bold, italic, code blocks, inline code, links, lists, blockquotes, images, and horizontal rules
  • Markdown styles: PrismMarkdownStyle — default, compact, and documentation rendering modes
  • Rich text editor: PrismRichTextEditor — attributed string editor with PrismFormattingToolbar for bold, italic, underline, strikethrough, code, headings, links, and lists
  • Attributed string builder: PrismAttributedStringBuilder — chainable API for composing styled text
  • Result builder: @PrismTextBuilder — declarative attributed string composition using Swift result builder syntax
  • Syntax highlighter: PrismSyntaxHighlighter — token-based syntax coloring for Swift, JSON, HTML, CSS, JavaScript, and Python
  • Code block view: PrismCodeBlock — themed code display with line numbers, syntax highlighting, and copy-to-clipboard
  • 22 new tests

Added

  • Heatmap: PrismHeatmapCell, PrismHeatmap — colored grid from 2D numeric data with color interpolation and optional row/column labels
  • Treemap: PrismTreemapItem, PrismTreemap — squarified treemap layout with drill-down navigation and breadcrumb trail
  • Radar chart: PrismRadarAxis, PrismRadarDataSet, PrismRadarChart — polygon overlay with multiple data sets, axis labels, and grid lines
  • Sparkline: PrismSparklineStyle, PrismSparkline — inline mini chart with line, area, and bar styles plus min/max markers and trend coloring
  • Funnel chart: PrismFunnelStage, PrismFunnelChart — tapered trapezoid stages with conversion rate labels
  • Candlestick chart: PrismCandlestick, PrismCandlestickChart — standard OHLC candles with green/red bullish/bearish coloring
  • 28 new tests
The first stable release unified all seven modules under a single package with a complete DocC documentation catalog.

Added

  • PrismCodableTrainingData: generic adapter that converts any Codable struct into feature rows for tabular classification and regression training via Mirror-based reflection
  • Provider-agnostic analytics: PrismAnalyticsProvider protocol and PrismAnalyticsEvent with automatic tracking in PrismButton, PrismTextField, PrismCarousel, PrismTabView, and PrismNavigationView
  • Runtime locale switching: PrismLocaleManager observable class with persistence support and SwiftUI environment integration
  • Remote auth token convenience: PrismIntelligenceClient.remote(endpoint:token:model:) factory with automatic Bearer header
  • DocC documentation: full catalog for all seven modules with articles for analytics, locale, codable training, local training, remote models, and platform availability
  • DocC hosting: documentation published online for all seven modules
  • PrismDivider, PrismMenu, and PrismAlert UI components
  • Cross-platform macOS adaptations for all PrismUI components
  • 154 tests across 31 suites covering all modules

Changed

  • README rewritten with module table, architecture diagram, usage examples, badges, and development instructions
  • Package manifest updated for Swift 6.3 with strict concurrency
  • Documentation infrastructure consolidated to DocC (removed legacy Next.js docs site)

Fixed

  • PrismVideoEntity.id was a computed property generating a new UUID on every access — changed to a stored let
  • PrismStore.send(_:) replaced force-unwrap with safe guard let
  • PrismRouter.present(_:) and fullScreen(_:) now enforce mutual exclusivity

Added

  • Theme editor: PrismThemeEditor — live runtime theme builder with color pickers, spacing/radius/elevation/motion previews, dark mode toggle, and JSON export
  • Auto theme generation: PrismAutoTheme — generate a BrandTheme from a single color using four color harmony strategies (complementary, analogous, triadic, split-complementary) with HSL color math
  • Figma sync: PrismFigmaSync — bidirectional token sync: export to Figma Variables format, import from Figma JSON to BrandTheme, plus W3C DTCG format for cross-tool compatibility
  • Storybook: PrismStorybook — interactive Storybook-style component explorer with NavigationSplitView sidebar, theme switching, dark mode/large text toggles, and live component stories across five categories
  • 20 new tests

Fixed

  • Stabilized flaky async tests; eliminated all compiler warnings

Added

  • Initial PrismIntelligence module with CreateML training and CoreML inference
  • PrismArchitecture store, reducer, and middleware primitives
  • PrismNetwork HTTP client and socket transport

Added

  • Initial PrismFoundation, PrismUI, and PrismVideo modules
  • Basic Swift Package Manager setup