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

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

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: "4.1.1")
]

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

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.

🎯 Breaking Change: Framework components now automatically check the global accessibility configuration. GlobalAutomaticAccessibilityIdentifierModifier is no longer needed for framework components.

Highlights:

• ✅ Cleaner API - Framework components automatically respect global config
• ✅ Better Separation - Clear distinction between framework and custom view behavior
• ✅ Persistent IDs - Accessibility identifiers now persist across app launches
• ✅ Deterministic Generation - IDs based on view structure, not timestamps
• ✅ Complete Automatic Accessibility Identifiers - Works for all Layers 1-6
• ✅ Comprehensive Test Coverage - 1,662 tests passing with 0 failures
• ✅ Mandatory Testing Rules - Established TDD methodology for future development
• ✅ Layer 4-6 Functions Fixed - Photo components, performance extensions, haptic feedback
• ✅ Backward Compatible - No migration required
• ✅ Enhanced Debug Output - Rich debugging with hierarchy and context
• ✅ UI Test Helpers - Generate tap actions, text input actions
• ✅ Proper TDD Process - Red-Green-Refactor cycle followed

Example:

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

• 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

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.

Version: v4.1.2 (Automatic Accessibility Identifiers Fix for Layers 2-6)
Phase: Patch Release (Bug Fix)
Next: Continue framework development and stability improvements

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.