@rosetears/aili-pi 0.1.0

package/skills/ios-application-dev/references/layout-system.md

@@ -0,0 +1,199 @@
+# Layout System
+
+iOS layout system guide covering touch targets, safe areas, UICollectionView, and Compositional Layout.
+
+## Touch Targets
+
+Interactive elements need adequate tap areas. The recommended minimum is 44x44 points.
+
+```swift
+let actionButton = UIButton(type: .system)
+actionButton.setTitle("Submit", for: .normal)
+view.addSubview(actionButton)
+
+actionButton.snp.makeConstraints { make in
+    make.height.greaterThanOrEqualTo(44)
+    make.leading.trailing.equalToSuperview().inset(16)
+    make.bottom.equalTo(view.safeAreaLayoutGuide).offset(-16)
+}
+```
+
+Use 8-point increments for spacing (8, 16, 24, 32, 40, 48) to maintain visual consistency.
+
+## Safe Area
+
+Always constrain content to the safe area to avoid the notch, Dynamic Island, and home indicator.
+
+```swift
+class MainViewController: UIViewController {
+    private let contentStack = UIStackView()
+
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        view.backgroundColor = .systemBackground
+
+        contentStack.axis = .vertical
+        contentStack.spacing = 16
+        view.addSubview(contentStack)
+
+        contentStack.snp.makeConstraints { make in
+            make.top.bottom.equalTo(view.safeAreaLayoutGuide)
+            make.leading.trailing.equalTo(view.safeAreaLayoutGuide).inset(16)
+        }
+    }
+}
+```
+
+## UICollectionView with Diffable Data Source
+
+```swift
+class ItemsViewController: UIViewController {
+    enum Section { case main }
+
+    private var collectionView: UICollectionView!
+    private var dataSource: UICollectionViewDiffableDataSource<Section, Item>!
+
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        setupCollectionView()
+        configureDataSource()
+    }
+
+    private func setupCollectionView() {
+        var config = UICollectionLayoutListConfiguration(appearance: .insetGrouped)
+        config.trailingSwipeActionsConfigurationProvider = { [weak self] indexPath in
+            self?.makeSwipeActions(for: indexPath)
+        }
+
+        let layout = UICollectionViewCompositionalLayout.list(using: config)
+        collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
+
+        view.addSubview(collectionView)
+        collectionView.snp.makeConstraints { make in
+            make.edges.equalToSuperview()
+        }
+    }
+
+    private func configureDataSource() {
+        let cellRegistration = UICollectionView.CellRegistration<UICollectionViewListCell, Item> {
+            cell, indexPath, item in
+            var content = cell.defaultContentConfiguration()
+            content.text = item.title
+            content.secondaryText = item.subtitle
+            cell.contentConfiguration = content
+        }
+
+        dataSource = UICollectionViewDiffableDataSource(collectionView: collectionView) {
+            collectionView, indexPath, item in
+            collectionView.dequeueConfiguredReusableCell(
+                using: cellRegistration, for: indexPath, item: item
+            )
+        }
+    }
+
+    func updateItems(_ items: [Item]) {
+        var snapshot = NSDiffableDataSourceSnapshot<Section, Item>()
+        snapshot.appendSections([.main])
+        snapshot.appendItems(items)
+        dataSource.apply(snapshot)
+    }
+}
+```
+
+## Grid Layout
+
+```swift
+private func createGridLayout() -> UICollectionViewLayout {
+    let itemSize = NSCollectionLayoutSize(
+        widthDimension: .fractionalWidth(1/3),
+        heightDimension: .fractionalHeight(1.0)
+    )
+    let item = NSCollectionLayoutItem(layoutSize: itemSize)
+    item.contentInsets = NSDirectionalEdgeInsets(top: 2, leading: 2, bottom: 2, trailing: 2)
+
+    let groupSize = NSCollectionLayoutSize(
+        widthDimension: .fractionalWidth(1.0),
+        heightDimension: .fractionalWidth(1/3)
+    )
+    let group = NSCollectionLayoutGroup.horizontal(layoutSize: groupSize, subitems: [item])
+
+    let section = NSCollectionLayoutSection(group: group)
+    return UICollectionViewCompositionalLayout(section: section)
+}
+```
+
+## Sectioned List with Headers
+
+```swift
+class CategorizedListVC: UIViewController {
+    enum Section: Hashable {
+        case favorites, recent, all
+    }
+
+    private var dataSource: UICollectionViewDiffableDataSource<Section, Item>!
+
+    private func setupCollectionView() {
+        var config = UICollectionLayoutListConfiguration(appearance: .insetGrouped)
+        config.headerMode = .supplementary
+
+        let layout = UICollectionViewCompositionalLayout.list(using: config)
+        collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
+    }
+
+    private func configureDataSource() {
+        let cellRegistration = UICollectionView.CellRegistration<UICollectionViewListCell, Item> {
+            cell, indexPath, item in
+            var content = cell.defaultContentConfiguration()
+            content.text = item.title
+            cell.contentConfiguration = content
+        }
+
+        let headerRegistration = UICollectionView.SupplementaryRegistration<UICollectionViewListCell>(
+            elementKind: UICollectionView.elementKindSectionHeader
+        ) { [weak self] header, elementKind, indexPath in
+            guard let section = self?.dataSource.sectionIdentifier(for: indexPath.section) else { return }
+            var content = header.defaultContentConfiguration()
+            content.text = self?.title(for: section)
+            header.contentConfiguration = content
+        }
+
+        dataSource = UICollectionViewDiffableDataSource(collectionView: collectionView) {
+            collectionView, indexPath, item in
+            collectionView.dequeueConfiguredReusableCell(using: cellRegistration, for: indexPath, item: item)
+        }
+
+        dataSource.supplementaryViewProvider = { collectionView, kind, indexPath in
+            collectionView.dequeueConfiguredReusableSupplementary(using: headerRegistration, for: indexPath)
+        }
+    }
+
+    func applySnapshot(favorites: [Item], recent: [Item], all: [Item]) {
+        var snapshot = NSDiffableDataSourceSnapshot<Section, Item>()
+        if !favorites.isEmpty {
+            snapshot.appendSections([.favorites])
+            snapshot.appendItems(favorites, toSection: .favorites)
+        }
+        if !recent.isEmpty {
+            snapshot.appendSections([.recent])
+            snapshot.appendItems(recent, toSection: .recent)
+        }
+        snapshot.appendSections([.all])
+        snapshot.appendItems(all, toSection: .all)
+        dataSource.apply(snapshot)
+    }
+}
+```
+
+## Spacing Guidelines
+
+| Spacing | Usage |
+|---------|-------|
+| 8pt | Compact element spacing |
+| 16pt | Standard padding |
+| 24pt | Section spacing |
+| 32pt | Large section separation |
+| 48pt | Screen margins (large screens) |
+
+---
+
+*UIKit and Apple are trademarks of Apple Inc. SnapKit is a trademark of its respective owners.*

package/skills/ios-application-dev/references/metal-shader.md

@@ -0,0 +1,178 @@
+# Metal Shader Reference
+
+Expert reference for Metal shaders, real-time rendering, and Apple's Tile-Based Deferred Rendering (TBDR) architecture.
+
+## Core Principles
+
+**Half precision first → Leverage TBDR → Function constant specialization → Use Intersector API**
+
+### When to Use
+
+- Metal Shading Language (MSL) development
+- Apple GPU optimization (TBDR architecture)
+- PBR rendering pipelines
+- Compute shaders and parallel processing
+- Apple Silicon ray tracing
+- GPU profiling and debugging
+
+### When NOT to Use
+
+- WebGL/GLSL (different architecture)
+- CUDA (NVIDIA only)
+- OpenGL (deprecated on Apple)
+- CPU-side optimization
+
+## Expert vs Novice
+
+| Topic | Novice | Expert |
+|-------|--------|--------|
+| Data types | `float` everywhere | Default `half`, `float` only for position/depth |
+| Branching | Runtime conditionals | Function constants for compile-time elimination |
+| Memory | Everything in device | Know constant/device/threadgroup tradeoffs |
+| Architecture | Treat as desktop GPU | Understand TBDR: tile memory is free, bandwidth is expensive |
+| Ray tracing | intersection queries | intersector API (hardware-aligned) |
+| Debugging | print debugging | GPU capture, shader profiler, occupancy analysis |
+
+## Common Anti-Patterns
+
+| Anti-Pattern | Problem | Solution |
+|--------------|---------|----------|
+| 32-bit floats | Wastes registers, reduces occupancy, doubles bandwidth | Default `half`, `float` only for position/depth |
+| Ignoring TBDR | Not using free tile memory | Use `[[color(n)]]`, memoryless targets |
+| Runtime constant branches | Warp divergence, wastes ALU | Function constants + pipeline specialization |
+| intersection queries | Not hardware-aligned | Use intersector API |
+
+## Metal Evolution
+
+| Era | Key Development |
+|-----|-----------------|
+| Metal 2.x | OpenGL migration, basic compute |
+| Apple Silicon | Unified memory, tile shaders critical |
+| Metal 3 | Mesh shaders, hardware-accelerated ray tracing |
+| Latest | Neural Engine + GPU cooperation, Vision Pro foveated rendering |
+
+**Apple Family 9 Note**: Threadgroup memory less advantageous vs direct device access.
+
+## Shader Types
+
+| Type | Purpose | Key Attributes |
+|------|---------|----------------|
+| Vertex | Vertex transformation | `[[stage_in]]`, `[[buffer(n)]]` |
+| Fragment | Pixel shading | `[[color(n)]]`, `[[texture(n)]]` |
+| Compute/Kernel | General computation | `[[thread_position_in_grid]]` |
+| Tile | TBDR-specific | `[[imageblock]]` |
+| Mesh | Metal 3 geometry | `[[mesh_id]]` |
+
+## Rendering Techniques
+
+| Technique | Description |
+|-----------|-------------|
+| Fullscreen quad | 4 vertex triangle strip, no MVP, post-processing basis |
+| PBR Cook-Torrance | Fresnel Schlick + GGX Distribution + Smith Geometry |
+| Blinn-Phong | Simple specular, half-vector calculation |
+
+## Procedural Generation
+
+| Technique | Use Case |
+|-----------|----------|
+| Hash functions | Pseudo-random basis for noise, random sampling |
+| Voronoi | Cell textures, stones, cracks |
+| Value/Perlin Noise | Continuous random fields |
+| FBM | Multi-octave layering, fractal terrain, clouds |
+| Domain Warping | Coordinate distortion, organic shapes |
+
+## Numerical Techniques
+
+| Technique | Formula |
+|-----------|---------|
+| Central difference gradient | `(f(x+h) - f(x-h)) / (2h)` |
+| Smoothstep | `x * x * (3 - 2 * x)` |
+| SDF operations | `min/max/smooth_min` boolean ops |
+
+## SwiftUI + MTKView Integration
+
+### Architecture Pattern
+
+```
+MetalView (UIViewRepresentable)
+    └── Coordinator = Renderer (MTKViewDelegate)
+            ├── MTLDevice
+            ├── MTLCommandQueue
+            ├── MTLRenderPipelineState
+            └── MTLBuffer (vertices, uniforms)
+```
+
+### Uniform Alignment Rules
+
+| Swift Type | Metal Type | Alignment |
+|------------|------------|-----------|
+| `Float` | `float` | 4 bytes |
+| `SIMD2<Float>` | `float2` | 8 bytes |
+| `SIMD3<Float>` | `float3` | **16 bytes** |
+| `SIMD4<Float>` | `float4` | 16 bytes |
+
+**Key**: `float3` aligns to 16 bytes. Use `MemoryLayout<T>.size` to verify.
+
+## Command Line Tools
+
+| Command | Purpose |
+|---------|---------|
+| `xcrun metal -c shader.metal -o shader.air` | Compile to AIR |
+| `xcrun metallib shader.air -o shader.metallib` | Link to metallib |
+| `xcrun metal shader.metal -o shader.metallib` | One-step compile & link |
+| `xcrun metal -Weverything -c shader.metal` | Syntax check |
+| `xcrun metal-objdump --disassemble shader.metallib` | Disassemble |
+
+## GPU Debugging
+
+### Xcode Workflow
+
+1. **GPU Capture**: ⌘⇧⌥G
+2. **Shader Profiler**: Select draw call → View Shader
+3. **Memory Viewer**: Inspect buffer/texture
+4. **Performance HUD**: Enable in device options
+
+### Key Metrics
+
+| Metric | Healthy Value | Low Value Cause |
+|--------|---------------|-----------------|
+| GPU Occupancy | > 80% | Memory bandwidth bottleneck |
+| ALU Utilization | > 60% | Waiting on memory |
+| Bandwidth | As low as possible | TBDR should minimize store |
+
+### Debug Utility Functions
+
+| Function | Purpose |
+|----------|---------|
+| heatmap | Value visualization (blue→green→red) |
+| debugNaN | NaN/Inf detection (magenta marker) |
+| visualizeDepth | Linearized depth visualization |
+
+## Performance Optimization Checklist
+
+### Data Types
+- [ ] Default `half`, `float` only for position/depth
+
+### Memory Management
+- [ ] Constants in constant address space
+- [ ] Use `.storageModeShared`
+- [ ] Leverage tile memory (TBDR free reads)
+- [ ] Avoid unnecessary render target stores
+
+### Branch Optimization
+- [ ] Function constants to eliminate branches
+- [ ] Fixed loop bounds (GPU unrolling)
+
+### Rendering Tips
+- [ ] Fullscreen quad with 4 vertex triangle strip
+- [ ] Procedural textures to avoid sampling bandwidth
+- [ ] `[[early_fragment_tests]]` for early depth test
+- [ ] `setFragmentBytes` for small data
+
+### Compute Optimization
+- [ ] Vectorize (SIMD)
+- [ ] Reduce register pressure
+
+---
+
+*Metal, Apple Silicon, and Xcode are trademarks of Apple Inc.*

package/skills/ios-application-dev/references/navigation-patterns.md

@@ -0,0 +1,175 @@
+# Navigation Patterns
+
+iOS navigation patterns guide covering Tab navigation, Navigation Controller, and modal presentation.
+
+## Tab-Based Navigation
+
+For apps with 3-5 main sections:
+
+```swift
+class AppTabBarController: UITabBarController {
+    override func viewDidLoad() {
+        super.viewDidLoad()
+
+        let homeNav = UINavigationController(rootViewController: HomeVC())
+        homeNav.tabBarItem = UITabBarItem(
+            title: "Home",
+            image: UIImage(systemName: "house"),
+            selectedImage: UIImage(systemName: "house.fill")
+        )
+
+        let searchNav = UINavigationController(rootViewController: SearchVC())
+        searchNav.tabBarItem = UITabBarItem(
+            title: "Search",
+            image: UIImage(systemName: "magnifyingglass"),
+            tag: 1
+        )
+
+        let profileNav = UINavigationController(rootViewController: ProfileVC())
+        profileNav.tabBarItem = UITabBarItem(
+            title: "Profile",
+            image: UIImage(systemName: "person"),
+            selectedImage: UIImage(systemName: "person.fill")
+        )
+
+        viewControllers = [homeNav, searchNav, profileNav]
+    }
+}
+```
+
+### Tab Bar Best Practices
+
+| Principle | Description |
+|-----------|-------------|
+| Limit count | Maximum 5 tabs, use More for additional |
+| Always visible | Tab bar stays visible at all navigation levels |
+| State preservation | Preserve navigation state when switching tabs |
+| Icon choice | Use SF Symbols, provide selected/unselected states |
+
+## Navigation Controller
+
+Use large titles for root views:
+
+```swift
+class ListViewController: UIViewController {
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        title = "Items"
+        navigationController?.navigationBar.prefersLargeTitles = true
+        navigationItem.largeTitleDisplayMode = .always
+    }
+
+    func pushDetail(_ item: Item) {
+        let detail = DetailViewController(item: item)
+        detail.navigationItem.largeTitleDisplayMode = .never
+        navigationController?.pushViewController(detail, animated: true)
+    }
+}
+```
+
+### Navigation Bar Configuration
+
+```swift
+class CustomNavigationController: UINavigationController {
+    override func viewDidLoad() {
+        super.viewDidLoad()
+
+        let appearance = UINavigationBarAppearance()
+        appearance.configureWithDefaultBackground()
+
+        navigationBar.standardAppearance = appearance
+        navigationBar.scrollEdgeAppearance = appearance
+        navigationBar.compactAppearance = appearance
+    }
+}
+```
+
+### Navigation Bar Buttons
+
+```swift
+override func viewDidLoad() {
+    super.viewDidLoad()
+
+    navigationItem.rightBarButtonItem = UIBarButtonItem(
+        image: UIImage(systemName: "plus"),
+        style: .plain,
+        target: self,
+        action: #selector(addItem)
+    )
+
+    navigationItem.rightBarButtonItems = [
+        UIBarButtonItem(systemItem: .add, primaryAction: UIAction { _ in }),
+        UIBarButtonItem(systemItem: .edit, primaryAction: UIAction { _ in })
+    ]
+}
+```
+
+## Modal Presentation
+
+### Sheet Presentation
+
+```swift
+func presentEditor() {
+    let editorVC = EditorViewController()
+    let nav = UINavigationController(rootViewController: editorVC)
+
+    editorVC.navigationItem.leftBarButtonItem = UIBarButtonItem(
+        systemItem: .cancel, target: self, action: #selector(dismissEditor)
+    )
+    editorVC.navigationItem.rightBarButtonItem = UIBarButtonItem(
+        systemItem: .done, target: self, action: #selector(saveAndDismiss)
+    )
+
+    if let sheet = nav.sheetPresentationController {
+        sheet.detents = [.medium(), .large()]
+        sheet.prefersGrabberVisible = true
+        sheet.prefersScrollingExpandsWhenScrolledToEdge = false
+    }
+
+    present(nav, animated: true)
+}
+```
+
+### Custom Detent (iOS 16+)
+
+```swift
+if let sheet = nav.sheetPresentationController {
+    let customDetent = UISheetPresentationController.Detent.custom { context in
+        return context.maximumDetentValue * 0.4
+    }
+    sheet.detents = [customDetent, .large()]
+}
+```
+
+### Full Screen Presentation
+
+```swift
+func presentFullScreen() {
+    let vc = FullScreenViewController()
+    vc.modalPresentationStyle = .fullScreen
+    vc.modalTransitionStyle = .coverVertical
+    present(vc, animated: true)
+}
+```
+
+## Presentation Styles
+
+| Style | Usage |
+|-------|-------|
+| `.automatic` | System default (usually sheet) |
+| `.pageSheet` | Card-style, parent view visible |
+| `.fullScreen` | Full screen cover |
+| `.overFullScreen` | Full screen with transparent background |
+| `.popover` | iPad popover |
+
+## Navigation Best Practices
+
+1. **Back gesture** - Ensure edge swipe back always works
+2. **State restoration** - Use `UIStateRestoring` to save navigation stack
+3. **Depth limit** - Avoid more than 4-5 navigation levels
+4. **Cancel button** - Modal views must provide a cancel option
+5. **Save confirmation** - Show confirmation dialog for unsaved changes
+
+---
+
+*UIKit, SF Symbols, and Apple are trademarks of Apple Inc.*