@maccesar/titools 5.1.1 → 5.2.0

package/skills/ti-admob-unified/references/source-snapshot.json

@@ -0,0 +1,440 @@
+{
+  "module": "ti.admob.unified",
+  "version": "1.0.0",
+  "release_status": "first public release under preparation",
+  "repository": "macCesar/ti.admob.unified",
+  "commit": "5b4cbf9347a51c4f959dc262ac1500f82f28b4a0",
+  "copied": "2026-10-11",
+  "files": [
+    {
+      "source": "documentation/fullscreen.md",
+      "destination": "references/fullscreen.md",
+      "source_sha256": "61e21798b234ff1f06d59d0239c62e3f422a424ebc2ff70e5839d203fa4c85b7",
+      "mirrored_sha256": "8c3defb078bc7115475f1389ee02d8d855164de16287afa4156842fa69e344af",
+      "links": [
+        {
+          "original": "../example/app.js",
+          "mirrored": "../assets/example/app.js"
+        }
+      ]
+    },
+    {
+      "source": "documentation/mediation.md",
+      "destination": "references/mediation.md",
+      "source_sha256": "59ede67bf9389b3b98a45a4eb24b59395a98631b0cb47d1cd24357d35f85d57e",
+      "mirrored_sha256": "3f6623d6178a437249542d191ecc6c5d6e22ae51db78713c41236b6ed637c938",
+      "links": [
+        {
+          "original": "../DEPENDENCIES.md",
+          "mirrored": "dependencies.md"
+        },
+        {
+          "original": "api-reference.md#automatic-adapter-discovery",
+          "mirrored": "api-reference.md#automatic-adapter-discovery"
+        },
+        {
+          "original": "api-reference.md#mediation-diagnostics",
+          "mirrored": "api-reference.md#mediation-diagnostics"
+        },
+        {
+          "original": "../CONTRIBUTING.md#adding-a-network",
+          "mirrored": "contributing.md#adding-a-network"
+        }
+      ]
+    },
+    {
+      "source": "documentation/integration.md",
+      "destination": "references/integration.md",
+      "source_sha256": "47b247dff23ca909b4b8cb598e31571d7ed419feb4b63d59a0d662950d265fa5",
+      "mirrored_sha256": "d63800df29b1857552456e1c73ea7de83aed2596b7704c953be9864ba83fb2ff",
+      "links": [
+        {
+          "original": "../example/lib/ads.js",
+          "mirrored": "../assets/example/lib/ads.js"
+        },
+        {
+          "original": "library.md",
+          "mirrored": "library.md"
+        },
+        {
+          "original": "../example/library-usage.js",
+          "mirrored": "../assets/example/library-usage.js"
+        },
+        {
+          "original": "banners.md#reserve-real-layout-space",
+          "mirrored": "banners.md#reserve-real-layout-space"
+        },
+        {
+          "original": "../example/app.js",
+          "mirrored": "../assets/example/app.js"
+        },
+        {
+          "original": "library.md",
+          "mirrored": "library.md"
+        },
+        {
+          "original": "banners.md",
+          "mirrored": "banners.md"
+        },
+        {
+          "original": "fullscreen.md",
+          "mirrored": "fullscreen.md"
+        },
+        {
+          "original": "privacy.md",
+          "mirrored": "privacy.md"
+        }
+      ]
+    },
+    {
+      "source": "documentation/third-party-notices.md",
+      "destination": "references/third-party-notices.md",
+      "source_sha256": "b203d99e49312a0450db497a0b54dae9fb1f705a27ba18f71fbaf76e46d830cd",
+      "mirrored_sha256": "93c74402995ac911bc96cac3453ca39f1c262653ef4e7d8ebccefe4c3630bbad",
+      "links": [
+        {
+          "original": "../DEPENDENCIES.md",
+          "mirrored": "dependencies.md"
+        }
+      ]
+    },
+    {
+      "source": "documentation/privacy.md",
+      "destination": "references/privacy.md",
+      "source_sha256": "25adc561cf4b1b2b0ae2c25c3373b9a7eae6b429ecdee1a7d4968e3021255d37",
+      "mirrored_sha256": "68ec23fc532865910ec2e6cb801b33f9afb788eac7c3dc5e1e230ad245a1ad03",
+      "links": [
+        {
+          "original": "getting-started.md#optional-if-the-application-requests-att",
+          "mirrored": "getting-started.md#optional-if-the-application-requests-att"
+        },
+        {
+          "original": "getting-started.md#ios",
+          "mirrored": "getting-started.md#ios"
+        }
+      ]
+    },
+    {
+      "source": "documentation/migration.md",
+      "destination": "references/migration.md",
+      "source_sha256": "85c6e3b897c4ac7f7cfb4f2a4fc61936f2e43a81de620a6c89fed670157877b3",
+      "mirrored_sha256": "028890977867cecef1f6c8a67b526bece5919200d061cabca61f0f12f9b8eb12",
+      "links": [
+        {
+          "original": "mediation.md",
+          "mirrored": "mediation.md"
+        },
+        {
+          "original": "banners.md#creation-properties-1",
+          "mirrored": "banners.md#creation-properties-1"
+        },
+        {
+          "original": "getting-started.md",
+          "mirrored": "getting-started.md"
+        },
+        {
+          "original": "banners.md#who-pauses-a-banner",
+          "mirrored": "banners.md#who-pauses-a-banner"
+        },
+        {
+          "original": "fullscreen.md#the-four-hour-window",
+          "mirrored": "fullscreen.md#the-four-hour-window"
+        },
+        {
+          "original": "api-reference.md#automatic-adapter-discovery",
+          "mirrored": "api-reference.md#automatic-adapter-discovery"
+        }
+      ]
+    },
+    {
+      "source": "documentation/getting-started.md",
+      "destination": "references/getting-started.md",
+      "source_sha256": "82e606a8807a75985f8371876650f6499028e2b4452f28f525cd9edced2f0a7d",
+      "mirrored_sha256": "a1784814b78d17d3c6a928f0aed34cadccc100cf6ce57b9e05b309745ecac652",
+      "links": [
+        {
+          "original": "mediation.md",
+          "mirrored": "mediation.md"
+        },
+        {
+          "original": "migration.md",
+          "mirrored": "migration.md"
+        },
+        {
+          "original": "mediation.md",
+          "mirrored": "mediation.md"
+        },
+        {
+          "original": "api-reference.md#automatic-adapter-discovery",
+          "mirrored": "api-reference.md#automatic-adapter-discovery"
+        },
+        {
+          "original": "privacy.md",
+          "mirrored": "privacy.md"
+        },
+        {
+          "original": "api-reference.md#reserved-and-unavailable-apis",
+          "mirrored": "api-reference.md#reserved-and-unavailable-apis"
+        },
+        {
+          "original": "banners.md",
+          "mirrored": "banners.md"
+        }
+      ]
+    },
+    {
+      "source": "documentation/library.md",
+      "destination": "references/library.md",
+      "source_sha256": "0da03f4b91912045737da2a8992679c7a1503f5085abc9d7495817ae54e68021",
+      "mirrored_sha256": "40568c25adc6e5cf7a27ad0305205dfc6847c7c6039eae095bf102f6b8688873",
+      "links": [
+        {
+          "original": "../example/lib/ads.js",
+          "mirrored": "../assets/example/lib/ads.js"
+        },
+        {
+          "original": "../example/app.js",
+          "mirrored": "../assets/example/app.js"
+        },
+        {
+          "original": "../example/library-usage.js",
+          "mirrored": "../assets/example/library-usage.js"
+        }
+      ]
+    },
+    {
+      "source": "documentation/index.md",
+      "destination": "references/index.md",
+      "source_sha256": "358dbe96a4f5ff49179b05bed5a1a28a2c13b0c698663a6f8fba6b858a55ffaf",
+      "mirrored_sha256": "1f07d92cfc885074bedfea0bfc8164df4dbb1091ecf4193ee733162b3a60e2ab",
+      "links": [
+        {
+          "original": "getting-started.md",
+          "mirrored": "getting-started.md"
+        },
+        {
+          "original": "integration.md",
+          "mirrored": "integration.md"
+        },
+        {
+          "original": "library.md",
+          "mirrored": "library.md"
+        },
+        {
+          "original": "privacy.md",
+          "mirrored": "privacy.md"
+        },
+        {
+          "original": "mediation.md",
+          "mirrored": "mediation.md"
+        },
+        {
+          "original": "banners.md",
+          "mirrored": "banners.md"
+        },
+        {
+          "original": "fullscreen.md",
+          "mirrored": "fullscreen.md"
+        },
+        {
+          "original": "api-reference.md",
+          "mirrored": "api-reference.md"
+        },
+        {
+          "original": "migration.md",
+          "mirrored": "migration.md"
+        },
+        {
+          "original": "third-party-notices.md",
+          "mirrored": "third-party-notices.md"
+        },
+        {
+          "original": "../CONTRIBUTING.md#adding-a-network",
+          "mirrored": "contributing.md#adding-a-network"
+        },
+        {
+          "original": "../DEPENDENCIES.md",
+          "mirrored": "dependencies.md"
+        },
+        {
+          "original": "../CHANGELOG.md",
+          "mirrored": "module-changelog.md"
+        },
+        {
+          "original": "../ROADMAP.md",
+          "mirrored": "roadmap.md"
+        },
+        {
+          "original": "../CONTRIBUTING.md",
+          "mirrored": "contributing.md"
+        }
+      ]
+    },
+    {
+      "source": "documentation/banners.md",
+      "destination": "references/banners.md",
+      "source_sha256": "6503b64e3adca882c099710c9df7d3f03ce6ff21cf98e54c199e3f9020581990",
+      "mirrored_sha256": "aaf1cc653f9c4d6085e21e88496259b7b3e4abfcd8ba9aa39a5f25cfc6c1db26",
+      "links": []
+    },
+    {
+      "source": "documentation/api-reference.md",
+      "destination": "references/api-reference.md",
+      "source_sha256": "e1e0e51562f18cca354d58ca0dffeb32830b07fea0f4cafecd356eca832b8ab7",
+      "mirrored_sha256": "d1fec104a8f8ffb153c0fbcc9e405c224145f0dd439a5d9caa4ac78ad64064fa",
+      "links": [
+        {
+          "original": "mediation.md#missing-configuration-and-startup-errors",
+          "mirrored": "mediation.md#missing-configuration-and-startup-errors"
+        },
+        {
+          "original": "banners.md#creation-properties-1",
+          "mirrored": "banners.md#creation-properties-1"
+        },
+        {
+          "original": "banners.md#creation-properties",
+          "mirrored": "banners.md#creation-properties"
+        },
+        {
+          "original": "fullscreen.md#the-four-hour-window",
+          "mirrored": "fullscreen.md#the-four-hour-window"
+        },
+        {
+          "original": "fullscreen.md",
+          "mirrored": "fullscreen.md"
+        },
+        {
+          "original": "banners.md#who-pauses-a-banner",
+          "mirrored": "banners.md#who-pauses-a-banner"
+        },
+        {
+          "original": "banners.md#creation-properties",
+          "mirrored": "banners.md#creation-properties"
+        },
+        {
+          "original": "fullscreen.md#events",
+          "mirrored": "fullscreen.md#events"
+        },
+        {
+          "original": "mediation.md",
+          "mirrored": "mediation.md"
+        },
+        {
+          "original": "migration.md#generic-mediation-diagnostics",
+          "mirrored": "migration.md#generic-mediation-diagnostics"
+        }
+      ],
+      "link_fixes": [
+        {
+          "original_markdown": "[Mediation diagnostics and compatibility](#mediation-diagnostics-and-compatibility)",
+          "mirrored_markdown": "[Mediation diagnostics and compatibility](#mediation-diagnostics)",
+          "reason": "Official document references a removed heading; target its existing Mediation diagnostics section. Original source is unchanged."
+        }
+      ]
+    },
+    {
+      "source": "DEPENDENCIES.md",
+      "destination": "references/dependencies.md",
+      "source_sha256": "345106277d89646fa2f79026d28fcef39c2c97701f0190141efdfaaf2cc988be",
+      "mirrored_sha256": "131c1a1042905893ef122ef6b44acfeba701177d42377061c60f827a686336fc",
+      "links": [
+        {
+          "original": "documentation/mediation.md#unity-consent-with-the-pinned-adapter",
+          "mirrored": "mediation.md#unity-consent-with-the-pinned-adapter"
+        }
+      ]
+    },
+    {
+      "source": "ROADMAP.md",
+      "destination": "references/roadmap.md",
+      "source_sha256": "e51337b46621f513bd0e7ece60604cb52b05137dce4a30e15474babb8ac2b3be",
+      "mirrored_sha256": "8d214f8b74201a1f60fa92df039eb8af88926159e2f26e946252eadd1afb214e",
+      "links": [
+        {
+          "original": "DEPENDENCIES.md#transitive-security-review",
+          "mirrored": "dependencies.md#transitive-security-review"
+        }
+      ]
+    },
+    {
+      "source": "CONTRIBUTING.md",
+      "destination": "references/contributing.md",
+      "source_sha256": "836799de6a281aec867f9df34a520963db337733caf33e7ea0bc314365bd5c6b",
+      "mirrored_sha256": "4cfb401b52a0de14fd72b040ff88c64d1be7fdba27e56c1ec1fcd9008cae8ae9",
+      "links": [
+        {
+          "original": "DEPENDENCIES.md",
+          "mirrored": "dependencies.md"
+        },
+        {
+          "original": "DEPENDENCIES.md",
+          "mirrored": "dependencies.md"
+        },
+        {
+          "original": "documentation/getting-started.md",
+          "mirrored": "getting-started.md"
+        },
+        {
+          "original": "documentation/privacy.md",
+          "mirrored": "privacy.md"
+        },
+        {
+          "original": "documentation/banners.md",
+          "mirrored": "banners.md"
+        },
+        {
+          "original": "LICENSE",
+          "mirrored": "module-license.txt"
+        }
+      ]
+    },
+    {
+      "source": "CHANGELOG.md",
+      "destination": "references/module-changelog.md",
+      "source_sha256": "206836587f356a152b6f9b3dbc3ecafdc47d006dc04ef9272be22fb61e1730a7",
+      "mirrored_sha256": "d7c53654b8b4c3166a8c86ed6a9d20d141692dbdfcd9ffacde4887367588adfa",
+      "links": [
+        {
+          "original": "DEPENDENCIES.md",
+          "mirrored": "dependencies.md"
+        },
+        {
+          "original": "DEPENDENCIES.md",
+          "mirrored": "dependencies.md"
+        },
+        {
+          "original": "documentation/mediation.md#release-validation",
+          "mirrored": "mediation.md#release-validation"
+        }
+      ]
+    },
+    {
+      "source": "LICENSE",
+      "destination": "references/module-license.txt",
+      "source_sha256": "4f0914a1e3dba2ee340a000feddd0700eb1977923090d77c0fa32e2a47830823",
+      "mirrored_sha256": "4f0914a1e3dba2ee340a000feddd0700eb1977923090d77c0fa32e2a47830823",
+      "links": []
+    },
+    {
+      "source": "example/lib/ads.js",
+      "destination": "assets/example/lib/ads.js",
+      "source_sha256": "7103fd5406a6fdae2652fdb75d6e76bbe8e1f820183d8caafcdacbb38c939567",
+      "mirrored_sha256": "7103fd5406a6fdae2652fdb75d6e76bbe8e1f820183d8caafcdacbb38c939567",
+      "links": []
+    },
+    {
+      "source": "example/library-usage.js",
+      "destination": "assets/example/library-usage.js",
+      "source_sha256": "1dc8f385dda582cfadcd0f77edc24681214ac7b066909d5d9d1599c923eece24",
+      "mirrored_sha256": "1dc8f385dda582cfadcd0f77edc24681214ac7b066909d5d9d1599c923eece24",
+      "links": []
+    },
+    {
+      "source": "example/app.js",
+      "destination": "assets/example/app.js",
+      "source_sha256": "ba0bfcb76dcc727e9f1785a3980ec0df3bdd4f62fceba6efb1938295ba2d2ab5",
+      "mirrored_sha256": "ba0bfcb76dcc727e9f1785a3980ec0df3bdd4f62fceba6efb1938295ba2d2ab5",
+      "links": []
+    }
+  ]
+}

package/skills/ti-admob-unified/references/third-party-notices.md

@@ -0,0 +1,22 @@
+> Source snapshot: official ti.admob.unified 1.0.0 documentation at commit `5b4cbf9` (copied 2026-10-11). Relative links rebased for this skill.
+
+# Third-party SDK notices
+
+`ti.admob.unified` and the `ti.admob.unified.mediation.<network>` complements use the MIT license. The distributed advertising SDKs and adapters have their own licenses, terms, privacy policies and publisher agreements.
+
+The core `ti.admob.unified` includes Google Mobile Ads and UMP. Each optional network module includes its network SDK and Google adapter, so applications distribute only selected dependencies. Unity includes UnityCoherenceLib; ironSource advertising is deferred.
+
+| Component                                             | Owner                      | Terms or license                                                    |
+| ----------------------------------------------------- | -------------------------- | ------------------------------------------------------------------- |
+| Google Mobile Ads, UMP, and Google mediation adapters | Google LLC                 | [Google APIs Terms of Service](https://developers.google.com/terms) |
+| AppLovin SDK                                          | AppLovin Corp.             | [AppLovin Terms](https://www.applovin.com/terms/)                   |
+| Meta Audience Network SDK                             | Meta Platforms, Inc.       | [Meta Platform Terms](https://developers.facebook.com/terms/)       |
+| InMobi SDK                                            | InMobi Technology Services | [InMobi publisher terms](https://www.inmobi.com/terms-of-service/)  |
+| Unity Ads and Unity support libraries                 | Unity Technologies         | [Unity Terms of Service](https://unity.com/legal/terms-of-service)  |
+| Liftoff Monetize/Vungle SDK                           | Liftoff Mobile, Inc.       | [Liftoff Monetize terms](https://publisher.vungle.com/LICENSE.html) |
+
+The exact versions are recorded in [the dependency inventory](dependencies.md). Maintainers must review the upstream terms whenever a native SDK is added or updated. Application publishers must also accept and comply with the terms of every network they enable in AdMob.
+
+Android also distributes Guava as a utility dependency. Guava uses the [Apache License 2.0](https://github.com/google/guava/blob/master/LICENSE) and is not an advertising SDK.
+
+The InMobi and Liftoff Android complements also pin OkHttp 4.12.0. OkHttp and its Okio dependency use the Apache License 2.0; preserve their distributed license notices. See [OkHttp](https://github.com/lysine-dev/okhttp/blob/master/LICENSE.txt) and [Okio](https://github.com/lysine-dev/okio/blob/main/LICENSE.txt).

package/skills/ti-game/SKILL.md

@@ -12,6 +12,12 @@ This skill is verified against upstream `main` at **`3bea2f4` (2026-09-02)**. Bo
 
 The skill applies to **Classic and Alloy** projects. Nothing here requires PurgeTSS.
 
+## Visual and sound asset collaboration
+
+Use `ti-game-assets` to create/edit complete visual and sound asset sets, preserve art/acoustic palettes and provenance, validate alpha/frames/manifests, prepare exports, and coordinate variants and stereo event placement. `ti-game` governs native representation/motion/events; `ti-synthengine` governs synthesis and sound behavior with `ti.synthengine`. Both have equal domain authority. Read their relevant current references rather than duplicating manuals. Art alone does not require installing modules or adding sounds/mechanics.
+
+For requested advertising or existing `ti.admob.unified`, use `ti-admob-unified` for the official module/privacy/provider contract and deliberate game-ad boundaries. Preserve native clock, inputs and audio ownership; graphics work alone does not authorize monetization.
+
 ## Required workflow
 
 Open the references relevant to the task before proposing code. Do not answer from familiarity with Phaser, Godot, Box2D, or an older `ti.game` build.
@@ -21,6 +27,7 @@ Open the references relevant to the task before proposing code. Do not answer fr
 | Exact methods, properties, defaults, event payloads, percentages | [references/api.md](references/api.md) |
 | Install, Classic/Alloy structure, assets, cleanup, lifecycle | [references/project-setup.md](references/project-setup.md) |
 | Choose a runnable upstream example | [references/examples.md](references/examples.md) |
+| Choose or tune a physical model, derive equations/units, diagnose FPS-dependent motion | [references/physics.md](references/physics.md) |
 | Reusable level, pooling, HUD, collision, path, timer patterns | [references/patterns.md](references/patterns.md) |
 | Platformer, racer, shooter, runner, rhythm, ball-game recipes | [references/recipes-action.md](references/recipes-action.md) |
 | Cards, point-and-click, particles, ropes, camera, effects | [references/recipes-adventure-effects.md](references/recipes-adventure-effects.md) |
@@ -127,7 +134,9 @@ When sources disagree, use this order:
 3. Upstream `README.md` and `TUTORIAL.md` for intended public usage.
 4. Upstream `TODO.md` for what remains partial or absent.
 
-The prose drift recorded at the previous pin is gone: upstream now states 34 demos (correct), names the HUD corners correctly, and documents `legend`, `firstGid`, `cols` and `rows` as creation-time on Android. What remains uncovered by any demo is `wallSlideSpeed` and the `onWallLeft`/`onWallRight` flags — `wallhit` itself is now exercised by `worldwrap.js` — so that part of the contract still comes from the README and both native implementations.
+Rechecked upstream HEAD on 2026-10-12: it remains `3bea2f4`. The catalog contains 34 demos. Examples establish intended API combinations; source inspection does not certify an installed binary or hardware behavior. Keep local fork changes separate from that upstream pin.
+
+Known source-level traps are collected in [references/physics.md](references/physics.md): thrust can be erased by the damping rest threshold, rope damping is per update and zero-delta rope updates are not a guaranteed freeze, and Rhythm's 400 ms subdivision comment is wrong at its stated 150 BPM. The wall-slide flags still have no demo; their contract comes from the README and both native implementations. Classify a wrong demo comment separately from a reproduced native-engine defect before proposing an upstream change.
 
 ## Before returning code
 

package/skills/ti-game/references/api.md

@@ -102,7 +102,7 @@ A normal Titanium view — add it to a window or any container, size it with the
 | `pause()` / `resume()` | method | — | Render loop control. The activity/app lifecycle already pauses and resumes automatically |
 | `backgroundColor` | string | — | GL clear color |
 | `maxFps` | int | `0` | Frame cap. `60` stops 120 Hz ProMotion displays from doubling render work; `0` = display refresh rate |
-| `timeScale` | float | `1` | Global multiplier for everything the engine ticks: physics, sheet animations, tweens, particles, camera. `0.5` = slow motion, `0` freezes the scene while rendering and touch keep running (pause menus, hit-stop) |
+| `timeScale` | float | `1` | Multiplies the scene dt for physics, sheet animations, tweens, particles and camera. `0.5` = slow motion; at `0` rendering/touch continue. Rope's previous-displacement integration still runs at zero dt in the pinned source, so complete rope freeze is not guaranteed; see [physics.md](physics.md#verlet-ropes-and-tethers) |
 | `surfaceWidth` / `surfaceHeight` | int | — | Read-only surface size in pixels |
 | `cameraX` / `cameraY` | float | `0` | World-space offset of the view |
 | `cameraScale` | float | `1` | Zoom, anchored on the view center |
@@ -192,6 +192,10 @@ On Android the buttons are captured at the activity window: the game view needs
 
 `platformer.js` runs on either the on-screen buttons or a pad.
 
+That single-view example does not establish independent receivers for several
+retained iOS GameViews: the pinned controller adapter overwrites a shared
+GCController callback. See [lifecycle and input ownership](project-setup.md#retained-ios-scenes-and-multiple-gameviews).
+
 ## SpriteSheet
 
 Create one sheet per texture and share it across every sprite that uses it — sprites sharing a sheet batch into a single draw call.
@@ -271,7 +275,7 @@ Hit-testing runs against the transformed shape (rotation and scale included), to
 | `velocityX`, `velocityY` | `0` | px/s |
 | `gravity` | `0` | px/s², added to `velocityY`. Per sprite — there is no global gravity |
 | `gravityX` | `0` | px/s², added to `velocityX`. The **sibling** of `gravity`, not half of a vector: `gravity` keeps its exact vertical meaning. Wind, a conveyor, or a top-down game whose "down" is sideways (`gravity: 0`, `gravityX` non-zero). Since 2026-08-27 |
-| `linearDamping` | `0` | Fraction of speed shed per second, applied to both velocity axes before the position integration — rolling friction for ordinary sprites, which `drag` never was (that one only runs inside `carMode`). ~`0.6` is a pool ball on felt. Proportional, so a fast body sheds a lot and a slow one very little; below **4 px/s** the engine zeroes both axes outright, because a proportion never reaches zero on its own. Negative values are clamped to 0. Since 2026-08-27 |
+| `linearDamping` | `0` | Coefficient in 1/s: each step retains `max(0, 1−linearDamping·dt)` of both velocity axes, after thrust/gravity and before position. Below combined speed **4 px/s** it zeroes both axes; this can erase a small first thrust step. ~`0.6` is used for pool felt, but damping acts even without contact. Negative values clamp to0. See [physics.md](physics.md#thrust-inertia-and-linear-damping) |
 | `maxSpeed` | `500` | px/s cap applied **only** to `thrust` acceleration and the `carMode` model. Writing `velocityX`/`velocityY` directly is never clamped |
 | `angularVelocity` | `0` | deg/s |
 | `thrust` | `0` | px/s² along the current heading (Newtonian flight) |
@@ -573,6 +577,10 @@ A native Verlet chain: integration and distance constraints run in the game loop
 | `visible` | `true` | |
 | `endX`, `endY` | — | Read-only live position of the loose end (grappling-hook tips) |
 
+Per-step retention is not a per-second rate. Rope's existing displacement and
+constraint passes still execute at `dt=0` in the pinned implementation;
+see [Verlet equations and pause limits](physics.md#verlet-ropes-and-tethers).
+
 The tether yields at the end no finger owns: with a fixed head anchor the tail sprite is simply leashed, but with sprites on both ends you can drag either one and the other is towed once the rope goes taut.
 
 ## TileLayer

package/skills/ti-game/references/debugging-performance.md

@@ -94,6 +94,12 @@ Telemetry is opt-in inside the renderers. With the HUD disabled and no `performa
 
 ## Common diagnostic order
 
+For a physics discrepancy, record the installed build/commit, surface size,
+`timeScale`, input values and actual FPS first. `maxFps` is a cap, not a fixed
+physics step. A visible thruster proves an animation state, not acceleration.
+The damping rest threshold can erase a small first thrust step, and Rope uses
+per-update damping. See [physics.md](physics.md#time-step-and-frame-rate).
+
 1. Confirm the object was added and is visible/in bounds.
 2. Turn on the relevant sprite/layer debug shape, then the global overlay if relationships are unclear.
 3. Verify `collisionGroup` is on the target and `solidWith`/`collidesWith` on the mover.

package/skills/ti-game/references/examples.md

@@ -2,7 +2,17 @@
 
 Verified against all 34 self-contained demos under `ti.game@3bea2f4:example/`, plus the launcher `example/app.js` and the shared back-control helper `example/backnav.js` (neither is a demo). `wallhit` now has one user — `worldwrap.js` counts bolt hits with it — but `wallSlideSpeed` and the `onWallLeft`/`onWallRight` flags still have no demo; for those use [the platformer recipe](recipes-action.md#platformer), verified against both native implementations and the README contract.
 
-The demos prove that API combinations run together on the current module. They are **not** production templates: most keep state in one file, repeat launcher/back-button plumbing, and still use pre-ES6 syntax. Start from the closest demo, retain the demonstrated engine calls, then apply the focused structure and cleanup patterns in this skill.
+The demos show intended API combinations; reading them does not verify an
+installed module or device. They are **not** production templates: most keep
+state in one file, repeat launcher/back-button plumbing, and still use pre-ES6
+syntax. Start from the closest demo, retain the demonstrated engine calls,
+then apply the focused structure and cleanup patterns in this skill.
+
+For equations, units, genre selection and frame-rate limits, use
+[physics.md](physics.md). Rhythm's 400 ms interval is a quarter note at its
+stated 150 BPM, despite the upstream "eighth" comments. Flappy replaces
+vertical velocity per tap; it does not add repeated impulses. The curated
+Lunar Lander recipe is not an additional upstream demo.
 
 | Demo | What it proves | Production-oriented reference |
 | --- | --- | --- |

package/skills/ti-game/references/patterns.md

@@ -206,7 +206,17 @@ Slower layers read as further away. Three layers (clouds at 0.15×, hills at 0.4
 
 ### Multitouch on-screen controls
 
-Each button must be **its own Titanium view** — sibling views receive simultaneous pointers, so holding a direction while pressing jump works. A single container splitting touches itself does not.
+Use separate sibling input targets for held directions and actions. Their
+native control type also matters for simultaneous touch; the factory below
+uses Label rather than UIButton-backed controls.
+
+The factory below deliberately uses Label. In Titanium SDK13.4.1.GA on iOS,
+TiUIButton sets its internal UIButton's `exclusiveTouch=YES`; changing the
+outer view's multitouch flag does not remove that exclusivity. Keep held
+flight controls as sibling Label/View targets or native game sprites and
+verify simultaneous input on-device. See `iphone/Classes/TiUIButton.m`,
+method `button`, in that SDK; this is a Titanium UI boundary, not a ti.game
+physics discrepancy.
 
 ```javascript
 function makeButton(title, position, fontSize) {
@@ -487,6 +497,10 @@ Two things bite here. The sweep **ignores** anything that is not `solidMode: 'bl
 
 **`linearDamping` is the missing friction, with a caveat.** `drag` only ever worked inside `carMode`; this is the same idea for ordinary sprites, and it is what brings a pool table to rest. But nothing checks contact — it bleeds speed on both axes, in the air as much as on the felt, and along a slope as much as across it. Right for a table, wrong for a hill. Below a combined 4 px/s the engine zeroes the velocity outright, so a deliberate 3 px/s drift dies the moment that sprite also carries damping.
 
+That threshold can also erase the first increment of an accelerating ship.
+Read [thrust and damping](physics.md#thrust-inertia-and-linear-damping) before
+using a permanent coasting brake on a powered sprite.
+
 **A bouncy surface is now a property of the surface.** `restitution` is read off both sides and mixed as `max`, so a springy floor rebounds riders that are not themselves bouncy:
 
 ```javascript
@@ -673,7 +687,15 @@ What still belongs in `setTimeout`: anything that must keep running while the ga
 
 ### Hit-stop on impact
 
-Freezing the scene for a few frames makes an impact read before the explosion starts. `timeScale = 0` stops the engine from advancing while it keeps drawing and accepting touches — no render loop to restart, no state to save. (Pattern from Titanium Lander: 140 ms on a crash, 90 ms when a shield absorbs a hit.)
+Giving the scene zero dt for a few frames makes an impact read before the
+explosion starts, while it keeps drawing and accepting touches. This avoids
+restarting the render loop. (Pattern from Titanium Lander: 140 ms on a crash,
+90 ms when a shield absorbs a hit.)
+
+This sets scene dt to zero, not a universal suspension of every update.
+Rope's previous-displacement and constraint pass still run in the pinned
+source; verify hit-stop separately for rope scenes. See
+[physics.md](physics.md#verlet-ropes-and-tethers).
 
 ```javascript
 let hitStopTimer = null;