SixLayer Framework Repository

This repository contains the SixLayer Framework, a comprehensive SwiftUI framework implementing a six-layer architecture for cross-platform development.

📁 Repository Structure

6layer/
├── Framework/                 ← **This is the Swift Package**
│   ├── Sources/              ← Framework source code
│   ├── Package.swift         ← Package definition
│   ├── README.md             ← Framework documentation
│   └── Stubs/                ← Framework stubs
└── Development/               ← Development files (not in package)
    ├── todo.md                ← Project roadmap
    ├── PROJECT_STATUS.md      ← Current status
    ├── Tests/                 ← Test suite
    ├── docs/                  ← Technical documentation
    └── Examples/              ← Usage examples

🚀 Getting Started

For Users (Consuming the Framework):

Navigate to the Framework/ directory and use it as a Swift Package:

// In your Package.swift
dependencies: [
    .package(url: "https://github.com/schatt/6layer.git", from: "5.0.0")
]

For Developers (Contributing):

• Framework Code: Framework/Sources/
• Documentation: Framework/docs/
• Project Status: Development/todo.md
• Tests: Development/Tests/

📦 Swift Package

The framework is distributed as a Swift Package from the Framework/ directory. This ensures that only the essential framework code is included when other projects consume it.

🆕 Latest Release: v5.0.0

Major Testing and Accessibility Release

🎯 Complete TDD Implementation: Framework now follows strict TDD principles throughout development ♿ Advanced Accessibility Overhaul: Complete accessibility system with automatic identifier generation 🧪 Testing Infrastructure Revolution: Comprehensive testing with 800+ tests and full platform coverage

Highlights:

• ✅ Complete TDD Implementation - Strict Test-Driven Development throughout
• ✅ Advanced Accessibility System - Automatic identifier generation for all components
• ✅ 800+ Comprehensive Tests - Full platform coverage with behavioral verification
• ✅ Apple HIG Compliance - Complete compliance with Human Interface Guidelines
• ✅ Platform Capability Detection - Accurate runtime detection for all platforms
• ✅ Component Architecture - All components support automatic accessibility
• ✅ Testing Infrastructure - Suite organization with Xcode test navigator integration
• ✅ Cross-Platform Validation - Enhanced testing across iOS, macOS, visionOS

See Field Hints Complete Guide for full documentation

Example:

platformPresentItemCollection_L1(
    items: products,
    hints: hints,
    customItemView: { product in
        MyCustomProductView(product: product)
    }
)

🔗 Quick Links

• Framework README - Complete framework documentation
• Project Status - Current development status
• Roadmap - Development phases and progress
• Documentation - Technical implementation details
• Release Notes v4.1.3 - Fix Critical Automatic Accessibility Identifier Bug
• OCR Overlay Guide - Interactive visual text correction

🤖 For AI Assistants

This framework has a specific architecture that requires careful understanding. Please read the AI Agent Guide first before attempting to help with this framework:

• AI_AGENT Guide - Complete guide with version-specific links
• Latest Features - Automatic Accessibility Identifiers Fix for Layers 2-6
• All AI Agent Files - Complete history of version-specific guides

These guides contain critical information about the Layer 1 Semantic Intent philosophy, correct usage patterns, and common mistakes to avoid.

📋 Current Status

Version: v5.0.0 (Major Testing and Accessibility Release) Phase: Major Release Next: Continue framework development and stability improvements

🤝 Contributing

Please read the development documentation in the Development/ directory before contributing. The framework follows a strict six-layer architecture pattern.

---

Note: This repository structure separates framework code from development files, ensuring clean package distribution while maintaining development transparency.