mirror of
https://github.com/home-assistant/iOS.git
synced 2026-06-19 17:13:37 -05:00
<!-- Thank you for submitting a Pull Request and helping to improve Home Assistant. Please complete the following sections to help the processing and review of your changes. Please do not delete anything from this template. --> ## Summary <!-- Provide a brief summary of the changes you have made and most importantly what they aim to achieve --> First iteration of the widget builder, user is able to choose what entities to display, choose a display text for them, color customization and "on tap" action. ## Screenshots <!-- If this is a user-facing change not in the frontend, please include screenshots in light and dark mode. --> https://github.com/user-attachments/assets/5949322a-a8df-4b3d-aaab-d4ba3853cc84 ## Link to pull request in Documentation repository <!-- Pull requests that add, change or remove functionality must have a corresponding pull request in the Companion App Documentation repository (https://github.com/home-assistant/companion.home-assistant). Please add the number of this pull request after the "#" --> Documentation: home-assistant/companion.home-assistant# ## Any other notes <!-- If there is any other information of note, like if this Pull Request is part of a bigger change, please include it here. -->
95 lines
3.4 KiB
Swift
95 lines
3.4 KiB
Swift
import AppIntents
|
|
import Foundation
|
|
import SFSafeSymbols
|
|
import Shared
|
|
import WidgetKit
|
|
|
|
@available(iOS 18, *)
|
|
struct ControlEntityItem {
|
|
let id: String
|
|
let entityId: String
|
|
let serverId: String
|
|
let name: String
|
|
let icon: SFSymbolEntity
|
|
let value: Bool
|
|
}
|
|
|
|
@available(iOS 18, *)
|
|
struct ControlLightsValueProvider: AppIntentControlValueProvider {
|
|
func currentValue(configuration: ControlLightsConfiguration) async throws -> ControlEntityItem {
|
|
try await ControlRefreshDelay.wait()
|
|
guard let serverId = configuration.light?.serverId,
|
|
let lightId = configuration.light?.entityId,
|
|
let state: String = try await ControlEntityProvider(domains: [.light]).currentState(
|
|
serverId: serverId,
|
|
entityId: lightId
|
|
) else {
|
|
throw AppIntentError.restartPerform
|
|
}
|
|
let isOn = state == ControlEntityProvider.States.on.rawValue
|
|
let icon = isOn ? configuration.icon : configuration.offStateIcon
|
|
return item(light: configuration.light, value: isOn, iconName: icon)
|
|
}
|
|
|
|
func placeholder(for configuration: ControlLightsConfiguration) -> ControlEntityItem {
|
|
item(light: configuration.light, value: nil, iconName: configuration.icon)
|
|
}
|
|
|
|
func previewValue(configuration: ControlLightsConfiguration) -> ControlEntityItem {
|
|
item(light: configuration.light, value: nil, iconName: configuration.icon)
|
|
}
|
|
|
|
private func item(light: IntentLightEntity?, value: Bool?, iconName: SFSymbolEntity?) -> ControlEntityItem {
|
|
let placeholder = placeholder(value: value)
|
|
if let light {
|
|
return .init(
|
|
id: light.id,
|
|
entityId: light.entityId,
|
|
serverId: light.serverId,
|
|
name: light.displayString,
|
|
icon: iconName ?? .init(id: placeholder.iconName),
|
|
value: value ?? false
|
|
)
|
|
} else {
|
|
return .init(
|
|
id: placeholder.id,
|
|
entityId: placeholder.entityId,
|
|
serverId: placeholder.serverId,
|
|
name: placeholder.displayString,
|
|
icon: .init(id: placeholder.iconName),
|
|
value: false
|
|
)
|
|
}
|
|
}
|
|
|
|
private func placeholder(value: Bool?) -> IntentLightEntity {
|
|
.init(
|
|
id: UUID().uuidString,
|
|
entityId: "",
|
|
serverId: "",
|
|
displayString: L10n.Widgets.Controls.Light.placeholderTitle,
|
|
iconName: (value ?? false) ? SFSymbol.lightbulbFill.rawValue : SFSymbol.lightbulb.rawValue
|
|
)
|
|
}
|
|
}
|
|
|
|
@available(iOS 18.0, *)
|
|
struct ControlLightsConfiguration: ControlConfigurationIntent {
|
|
static var title: LocalizedStringResource = .init("widgets.lights.description", defaultValue: "Turn on/off Light")
|
|
|
|
@Parameter(
|
|
title: .init("app_intents.lights.light.title", defaultValue: "Light")
|
|
)
|
|
var light: IntentLightEntity?
|
|
@Parameter(
|
|
title: .init("app_intents.lights.on_state_icon.title", defaultValue: "Icon for on state"),
|
|
default: SFSymbolEntity(id: SFSymbol.lightbulbFill.rawValue)
|
|
)
|
|
var icon: SFSymbolEntity?
|
|
@Parameter(
|
|
title: .init("app_intents.lights.off_state_icon.title", defaultValue: "Icon for off state"),
|
|
default: SFSymbolEntity(id: SFSymbol.lightbulb.rawValue)
|
|
)
|
|
var offStateIcon: SFSymbolEntity?
|
|
}
|