DDComponent

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 41)

DDComponent is an iOS framework that decomposes complex pages into independent, reusable Presenter components. Its P-Tree (logic) and V-Tree (UI) separate concerns, enabling the same logic to drive different interfaces. With unified state management and dependency injection, it makes large-scale iOS apps modular and testable.

DDComponent 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DDComponent

[![Version](https://img.shields.io/cocoapods/v/DDComponent.svg?style=flat)](https://cocoapods.org/pods/DDComponent)
[![License](https://img.shields.io/cocoapods/l/DDComponent.svg?style=flat)](https://cocoapods.org/pods/DDComponent)
[![Platform](https://img.shields.io/cocoapods/p/DDComponent.svg?style=flat)](https://cocoapods.org/pods/DDComponent)

[中文](./README-zh.md)

An MVP-based iOS page decomposition framework. Break down complex pages into independent, reusable, pluggable Presenter components.

## Why DDComponent?

| Problem | DDComponent's Solution |
|---|---|
| Multiple developers modifying the same file causes conflicts | Each feature is split into independent Presenters, no interference |
| Feature boundaries are fuzzy, no one owns quality | Presenters serve as clear logic boundaries with well-defined responsibilities |
| Same feature needs different UIs (e.g. Resso vs TTM) | P-Tree and V-Tree are separated — logic is reused, UI is swappable |
| Features need dynamic pluggability | Use the `install` DSL to assemble Presenters and Services on demand |

## Core Concepts

### P-Tree and V-Tree

```
P-Tree (Presenter Tree)        V-Tree (View Tree)
┌─────────────────┐          ┌─────────────────┐
│  RootPresenter  │ - - - - │    RootView     │
│  ├ LikePresenter │ - - - - │   ├ LikeButton  │
│  ├ SharePresenter│ - - - - │   ├ ShareButton │
│  └ CommentPresenter│ - - - │   └ CommentList │
└─────────────────┘          └─────────────────┘
```

- **P-Tree** (Presenter Tree): The functional logic structure of the page
- **V-Tree** (View Tree): The UI presentation structure
- The two are loosely bound: the same P-Tree can bind to entirely different V-Trees

### State-Driven Updates

DDComponent draws inspiration from React/SwiftUI — all UI updates must go through a single `setState` entry point, batched and executed by the UpdatePipeline:

```
Data change → setState { ... } → Pipeline scheduling → onUpdate(view:context:) → UI update
```

### Quick Example

```swift
// 1. View protocol (not UIView)
protocol LikeViewProtocol: AnyObject {
    var isLiked: Bool { get set }
    var likeCount: Int { get set }
    var onLikeTapped: (() -> Void)? { get set }
}

// 2. Presenter (business logic)
class LikePresenter: ViewPresenter<LikeViewProtocol> {
    var isLiked = false { didSet { setState {} } }

func toggleLike() {
        getService(LikeService.self)?.toggleLike { [weak self] result in
            self?.isLiked = result
        }
    }

override func onBindView(_ view: LikeViewProtocol) {
        view.onLikeTapped = { [weak self] in self?.toggleLike() }
    }

override func onUpdate(view: LikeViewProtocol, context: ViewUpdateContext) {
        view.isLiked = isLiked
    }
}

// 3. Assembly
class MyViewController: PageViewController<MyRootView, MyRootPresenter> {
    @PageInstallerBuilder override var pageInstallers: PageInstaller {
        ServiceInstaller(LikeService.self, { LikeServiceImpl() })
    }
}
```

## Installation

```ruby
pod 'DDComponent'

# Optional: @PresenterState macro
pod 'DDComponent/Macros'
```

### Claude Code Plugin

This project ships with a [Claude Code](https://claude.com/claude-code) plugin that provides DDComponent-specific development skills and a code review Agent:

| Plugin Feature | Description |
|---|---|
| `ddcomponent` skill | Guides Claude Code to build pages following the Presenter tree architecture, lifecycle conventions, and Service/Notify communication patterns |
| `code-reviewer` Agent | Reviews DDComponent code for type correctness, state design, lifecycle usage, and logic consistency |

Run in Claude Code:

```bash
# Add GitHub marketplace
/plugin marketplace add djs66256/DDComponent

# Install the plugin
/plugin install ddcomponent@ddcomponent
```

## Documentation

| You want to... | Read this |
|----------------|-----------|
| Understand the framework design philosophy | [Architecture](./docs/en/architecture.md) |
| Build pages / lists / features | [Usage Guide](./docs/en/usage-guide.md) |
| Develop list cells | [Reusable Presenter](./docs/en/reusable-presenter.md) |
| Use the Hooks-style API | [use* API](./docs/en/use-methods.md) |
| Simplify state declarations | [@PresenterState Macro](./docs/en/presenter-state-macro.md) |
| Adapt for Swift 6 | [Swift 6 Concurrency Patterns](./docs/en/swift6-patterns.md) |
| Browse example code | [Demo Index](./docs/en/demo-index.md) |

**Documentation index**: [docs/en/README.md](./docs/en/README.md)

## Testing

The framework includes 122 unit tests covering all core capabilities. Tests are located in `Example/Tests/`.

```bash
cd Example
xcodebuild test -project DDComponent.xcodeproj -scheme DDComponent-Example -destination 'platform=iOS Simulator,name=iPhone 17'
```

## Requirements

- iOS 13.0+
- Swift 5.7+
- Xcode 14.0+

## License

DDComponent is available under the MIT license. See the LICENSE file for more info.

DDComponent

DDComponent 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

DDComponent

DDComponent 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README