連結リストを利用したAPI。モディファイアを構造体で定義し、メソッドチェーンで追加していく。GameWidget で2022年現在開発中であり、こちらでも流用できないかと考えた。

課題

• #68
• #83
• #69

• #105
• #111
• #110

where Node == XXNode というようになっている(XXNode はたとえば SKSpriteNode とか). Node: XXNode というように XXNode のサブクラスを対象とした方がいいかもしれない. こうすると, API 使用者が XXNode のサブクラス(カスタムクラス)に対して親ノード向けのモディファイアを使っても型が消去されないというメリットが得られる.

• 抽象化
• テストコードを追加

成功しました。

• #108

add(_ builder:) コマンドの実装

• ChildNodeBuilder ではなく, root の builder を引数に取ることが可能なコマンド
• 直接 builder オブジェクトを追加するので, add(child: ,build: ) コマンドのようなコールバックを必要としない

第一引数が processor で, 第二引数が sknode だが, 逆が正しいのでは?

addChild(_ node: Node, with processor: some ProcessorProtocol)

ドキュメントコメントが全くないので, 整備していく必要があります.

課題

• index
• Builder
• Generator
• Processor
• Modifier

Generator と Processor をビルダーパターンで別々にセットできるようにしたいです.

• #61
• #73
• #75
• #86
• #91
• #88
• #40
• #93
• #98

ノードを加工する手順をあらかじめ定義し、未加工のノードを定義された順で加工するオブジェクトを考えたい

全てはできないと思いますが, 現在の実装状況を確認するために利用してください.

• SKNode
• SKSpriteNode
• SKLabelNode
• SKShapeNode
• SKAudioNode
• SKEmitterNode
• SKFieldNode
• SKTileMapNode
• SKVideoNode
• SK3DNode
• SKEffectNode
• SKTransformNode

Builder.T を Builder.P に変更しましたが、失敗でした。

モディファイアで SKNode.constraints の設定ができると便利そうです。
難しいポイントは、SKConstraint によっては別の SKNode インスタンスとの関係性を宣言したい場合があることです。SKNodeBuilder では宣言的に SKNode を作成できるようにしたいので、ビルダー内で SKNode インスタンスを直接扱わなくてもいい API を考えましょう。

• Generator のテスト

ライブラリの使用者が Builder のモディファイアを作れるようにしたい。いくつかのAPIを公開すれば extension で作成可能にはなるが、そうではなく、モディファイア作成のために新しくAPIを考えたい。

Range や Array を使って同じ Node を繰り返し配置できるようにしたい.

addChild メソッドの上位互換を想定している.

support/v1, support/v2 を終了したいと思います.

support/v3 は v4 リリース後しばらく継続します.

@NodeBuilder 実装時の Builder に相当する Processor はモディファイアにより型が変化するため, v1 ~ v3 当時のように使用することができない.

README.md, Wiki, Document comment を英語にする

extension の where 節内で

'Node' was defined in extension of protocol 'ProcessorProtocol' and cannot be referenced from a 'where' clause

というエラーが出ているようです。

Builder のGenerics の型名を変更するなどを試してみます。

• #106
• #107

• #114

型名がオブジェクトの性質に適していないと思われます。
代替案 : " Builder "

目的 : 循環参照が不可能な実装に変更すること

実装したい内容

• Builder オブジェクトの body プロパティを unowned にする
• イニシャライザで SKNode を設定できない Builder を実装 (body は通常の定数で保持する）

README.md の内容が version 3 のままなので新しい API の内容に書き直す必要があります.

• 新しい DEMO
• @NodeBuilder の削除と代替
• Modifier を作る API の概説と DEMO

初期化関数もモディファイアの一種と捉えることができる. 直接ノードを初期化しない API にするなら, 初期化もモディファイアと同じように実装するべきである.

#63 Linked modifier の実装にしてから, property wrapper がうまく機能しなくなった. このまま削除した状態にするのか, 色々検討してから決めたい.

Builder に addChild メソッドを追加する

課題

• #73
• #84
• #85
• #94

現時点では, 改変後のノードが返るようになっています.

SKSpriteNode, SKLabelNode, SKShapeNode とそのサブクラス向けの Generator を作成します.

default というコンピューテッドプロパティを提案します。これは setGenerator と setProcessor を省略するメソッドになります。SKNode.init() の generator がセットされた状態になります。

• #112

@discardableResult はいらないかもしれません. 現在考案中の実装では, Builder から SKNode インスタンスを生成するには必ず node() を実行する必要があります. また, 後から生成する場合も Builder インスタンスを変数等に保持するため, これらのメソッドの戻り値は必ず使用すると結論づけられます.

• Builder+Generator のファイルを作成する
• #99