@mmerterden/multi-agent-pipeline 20.8.0 → 20.8.1

package/pipeline/skills/shared/external/widgetkit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: widgetkit
-description: "WidgetKit and ActivityKit surfaces on iOS 26+: timeline-driven widgets for the Home Screen, the Lock Screen and StandBy, interactive widgets using Button or Toggle with AppIntent actions, Live Activities and their Dynamic Island layouts (compact, expanded, minimal), Control Center controls with ControlWidgetButton or ControlWidgetToggle, families, deep links, the refresh budget, reloads triggered by push, Liquid Glass accented rendering, extension setup, App Groups and entitlements. Use when implementing, reviewing or improving widgets, Live Activities or controls."
+description: "WidgetKit surfaces on iOS 26+: timeline-driven widgets for the Home Screen, the Lock Screen and StandBy, interactive widgets using Button or Toggle with AppIntent actions, widget views for a Live Activity (Dynamic Island compact, expanded, minimal), Control Center controls with ControlWidgetButton or ControlWidgetToggle, families, deep links, the refresh budget, push reloads, accented rendering, extension setup, App Groups. Use when implementing or reviewing widgets, Live Activity views or controls. Not for Live Activity lifecycle or pushes (live-activities)."
 metadata:
   source: multi-agent-pipeline
 ---
@@ -13,7 +13,9 @@ surface WidgetKit and ActivityKit draw on: the Home Screen, the Lock Screen,
 Live Activities and the Dynamic Island, Control Center and StandBy.
 
 Related skills: `app-intents` for intent and entity design beyond what a widget
-needs, `live-activities` for deeper ActivityKit push contracts.
+needs, `live-activities` for the Live Activity lifecycle (request, update, end),
+push tokens and ActivityKit push contracts. This skill covers the widget views a
+Live Activity renders.
 
 Longer examples are in [the advanced reference](references/widgetkit-advanced.md).
 
@@ -300,14 +302,20 @@ on its side. Read `@Environment(\.widgetLocation)` to tell where you are drawn:
 - Budget: roughly 40 to 70 refreshes a day, with entries 5 minutes apart or more.
   For countdowns use `Text(timerInterval:countsDown:)` instead of one entry per tick.
 
-## iOS 26 Additions
+## iOS 18 Additions
 
 - `WidgetAccentedRenderingMode` (`.accented`, `.accentedDesaturated`,
-  `.desaturated`, `.fullColor`) controls how images adapt to Liquid Glass tinting.
+  `.desaturated`, `.fullColor`), applied with `.widgetAccentedRenderingMode(_:)`,
+  controls how images adapt to accented (tinted) rendering. Available from
+  iOS 18, macOS 15 and watchOS 11; on visionOS from 26.
+- `ControlPushHandler.pushTokensDidChange(controls:)` gives a push token per
+  control; an APNs push to it reloads the control.
+
+## iOS 26 Additions
+
 - `WidgetPushHandler.pushTokenDidChange(_:widgets:)` gives you a token to send to
-  your server; an APNs push to it reloads the widget. `ControlPushHandler` does
-  the same for controls. See
-  [Reloading timelines by push](references/widgetkit-advanced.md#reloading-timelines-by-push-ios-26-and-later).
+  your server; an APNs push to it reloads the widget. See
+  [Reloading timelines by push](references/widgetkit-advanced.md#reloading-timelines-by-push).
 - `.systemSmall` widgets render in CarPlay from iOS 26. Keep them readable at a
   glance so a driver is never pulled into detail.
 

package/pipeline/skills/shared/external/widgetkit/references/widgetkit-advanced.md

@@ -6,7 +6,7 @@ heading says otherwise.
 ## Contents
 
 - [Timeline Strategies](#timeline-strategies)
-- [Reloading timelines by push (iOS 26 and later)](#reloading-timelines-by-push-ios-26-and-later)
+- [Reloading timelines by push](#reloading-timelines-by-push)
 - [Deep Links and Widget URLs](#deep-links-and-widget-urls)
 - [User-configurable widgets through App Intents](#user-configurable-widgets-through-app-intents)
 - [Multiple Widget Support](#multiple-widget-support)
@@ -75,9 +75,10 @@ cost budget.
 - A widget run from Xcode's debugger has no refresh limit, so budget problems
   only show up outside the debugger.
 
-## Reloading timelines by push (iOS 26 and later)
+## Reloading timelines by push
 
-A `WidgetPushHandler` receives a token for APNs. Send it to your server.
+From iOS 26, a `WidgetPushHandler` receives a token for APNs. Send it to your
+server.
 
 ```swift
 struct ScoreboardPushHandler: WidgetPushHandler {
@@ -99,8 +100,9 @@ func hexString(_ bytes: Data) -> String {
 When the server sends an APNs push addressed to that token, the system calls
 `getTimeline` or `timeline(for:in:)` again.
 
-Controls have their own handler that receives every control at once, as
-`ControlInfo` values; each carries its token in an optional `pushInfo`:
+Controls have their own handler, available from iOS 18, that receives every
+control at once, as `ControlInfo` values; each carries its token in an optional
+`pushInfo`:
 
 ```swift
 struct GaragePushHandler: ControlPushHandler {
@@ -478,7 +480,7 @@ Task {
 }
 ```
 
-From iOS 26 a broadcast channel works too: `pushType: .channel("ferry-route-12")`.
+From iOS 18 a broadcast channel works too: `pushType: .channel("ferry-route-12")`.
 
 Update payload: