@nice2dev/ui-tools 1.0.10

package/dist/smart-home.d.ts

@@ -0,0 +1,861 @@
+/**
+ * @file smart-home.ts
+ * @module @nice2dev/ui-tools
+ * @description PRO-16.5 — Smart Home
+ *
+ * Types for smart home automation: device discovery, scene editor,
+ * energy monitoring, climate control, lighting, security, voice assistants.
+ */
+/** Home device type */
+export type HomeDeviceType = 'light' | 'switch' | 'dimmer' | 'outlet' | 'thermostat' | 'sensor' | 'camera' | 'doorbell' | 'lock' | 'blinds' | 'shades' | 'garage' | 'speaker' | 'tv' | 'fan' | 'vacuum' | 'irrigation' | 'appliance' | 'button' | 'remote' | 'hub' | 'custom';
+/** Device protocol */
+export type HomeProtocol = 'zigbee' | 'zwave' | 'wifi' | 'bluetooth' | 'thread' | 'matter' | 'homekit' | 'tuya' | 'mqtt' | 'http' | 'custom';
+/** Device state */
+export type HomeDeviceState = 'on' | 'off' | 'unavailable' | 'unknown' | 'idle' | 'active' | 'standby';
+/** Automation trigger */
+export type AutomationTriggerType = 'time' | 'state' | 'sunrise' | 'sunset' | 'event' | 'geo' | 'webhook' | 'tag' | 'template';
+/** Smart home configuration */
+export interface SmartHomeConfig {
+    /** Hub connection */
+    hub?: SmartHomeHub;
+    /** Theme */
+    theme?: SmartHomeTheme;
+    /** Locale */
+    locale?: string;
+    /** Features */
+    features?: SmartHomeFeatures;
+    /** Rooms */
+    rooms?: Room[];
+    /** Integrations */
+    integrations?: HomeIntegration[];
+    /** Voice assistants */
+    voice?: VoiceAssistantConfig;
+    /** Energy config */
+    energy?: EnergyConfig;
+}
+/** Smart home hub */
+export interface SmartHomeHub {
+    type: 'homeAssistant' | 'smartThings' | 'hubitat' | 'openhab' | 'domoticz' | 'custom';
+    url?: string;
+    token?: string;
+    apiKey?: string;
+    websocket?: boolean;
+}
+/** Smart home theme */
+export interface SmartHomeTheme {
+    name?: string;
+    background?: string;
+    surface?: string;
+    primary?: string;
+    deviceColors?: DeviceColorScheme;
+    roomIcons?: RoomIconSet;
+}
+/** Device color scheme */
+export interface DeviceColorScheme {
+    light?: string;
+    switch?: string;
+    thermostat?: string;
+    sensor?: string;
+    camera?: string;
+    lock?: string;
+    default?: string;
+}
+/** Room icon set */
+export interface RoomIconSet {
+    livingRoom?: string;
+    bedroom?: string;
+    kitchen?: string;
+    bathroom?: string;
+    office?: string;
+    garage?: string;
+    outdoor?: string;
+    default?: string;
+}
+/** Smart home features */
+export interface SmartHomeFeatures {
+    discovery?: boolean;
+    scenes?: boolean;
+    automations?: boolean;
+    energy?: boolean;
+    climate?: boolean;
+    lighting?: boolean;
+    security?: boolean;
+    voice?: boolean;
+    presence?: boolean;
+    schedules?: boolean;
+}
+/** Room */
+export interface Room {
+    id: string;
+    name: string;
+    icon?: string;
+    floor?: number;
+    area?: number;
+    devices?: string[];
+    climate?: RoomClimate;
+    position?: FloorPlanPosition;
+}
+/** Room climate */
+export interface RoomClimate {
+    targetTemperature?: number;
+    currentTemperature?: number;
+    humidity?: number;
+    hvacMode?: HVACMode;
+}
+/** HVAC mode */
+export type HVACMode = 'off' | 'heat' | 'cool' | 'auto' | 'fan_only' | 'dry';
+/** Floor plan position */
+export interface FloorPlanPosition {
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+}
+/** Home integration */
+export interface HomeIntegration {
+    id: string;
+    name: string;
+    type: IntegrationType;
+    enabled: boolean;
+    config?: IntegrationConfig;
+    status?: IntegrationStatus;
+}
+/** Integration type */
+export type IntegrationType = 'homeAssistant' | 'googleHome' | 'alexa' | 'homeKit' | 'smartThings' | 'ifttt' | 'philipsHue' | 'nest' | 'ring' | 'wyze' | 'tuya' | 'mqtt' | 'zigbee2mqtt' | 'zwave-js' | 'custom';
+/** Integration config */
+export interface IntegrationConfig {
+    host?: string;
+    port?: number;
+    username?: string;
+    password?: string;
+    apiKey?: string;
+    clientId?: string;
+    clientSecret?: string;
+    refreshToken?: string;
+    region?: string;
+    bridgeId?: string;
+    options?: Record<string, unknown>;
+}
+/** Integration status */
+export interface IntegrationStatus {
+    connected: boolean;
+    lastSync?: Date;
+    deviceCount?: number;
+    error?: string;
+}
+/** Voice assistant config */
+export interface VoiceAssistantConfig {
+    enabled?: boolean;
+    assistants?: VoiceAssistant[];
+    wakeWord?: string;
+    language?: string;
+}
+/** Voice assistant */
+export interface VoiceAssistant {
+    type: 'alexa' | 'googleAssistant' | 'siri' | 'cortana' | 'custom';
+    enabled: boolean;
+    linked?: boolean;
+    skillId?: string;
+    config?: Record<string, unknown>;
+}
+/** Energy config */
+export interface EnergyConfig {
+    enabled?: boolean;
+    gridSource?: GridSource;
+    solar?: SolarConfig;
+    battery?: BatteryConfig;
+    tariff?: TariffConfig;
+    goals?: EnergyGoals;
+}
+/** Grid source */
+export interface GridSource {
+    entityId?: string;
+    importPrice?: number;
+    exportPrice?: number;
+    currency?: string;
+}
+/** Solar config */
+export interface SolarConfig {
+    entityId?: string;
+    capacity?: number;
+    orientation?: string;
+    tilt?: number;
+}
+/** Battery config */
+export interface BatteryConfig {
+    entityId?: string;
+    capacity?: number;
+    minCharge?: number;
+    maxCharge?: number;
+}
+/** Tariff config */
+export interface TariffConfig {
+    type: 'flat' | 'tou' | 'realtime';
+    rates?: TariffRate[];
+    provider?: string;
+}
+/** Tariff rate */
+export interface TariffRate {
+    name: string;
+    price: number;
+    startTime?: string;
+    endTime?: string;
+    days?: number[];
+}
+/** Energy goals */
+export interface EnergyGoals {
+    dailyBudget?: number;
+    monthlyBudget?: number;
+    selfSufficiency?: number;
+}
+/** Home device */
+export interface HomeDevice {
+    id: string;
+    name: string;
+    type: HomeDeviceType;
+    protocol: HomeProtocol;
+    room?: string;
+    state: DeviceStateData;
+    attributes?: DeviceAttributes;
+    capabilities?: DeviceCapability[];
+    config?: DeviceConfig;
+    metadata?: DeviceMetadata;
+}
+/** Device state data */
+export interface DeviceStateData {
+    value: HomeDeviceState | number | string;
+    lastChanged?: Date;
+    lastUpdated?: Date;
+}
+/** Device attributes */
+export interface DeviceAttributes {
+    brightness?: number;
+    colorTemp?: number;
+    color?: ColorValue;
+    position?: number;
+    temperature?: number;
+    humidity?: number;
+    battery?: number;
+    power?: number;
+    energy?: number;
+    voltage?: number;
+    current?: number;
+    motion?: boolean;
+    contact?: boolean;
+    locked?: boolean;
+    playing?: boolean;
+    volume?: number;
+    source?: string;
+    [key: string]: unknown;
+}
+/** Color value */
+export interface ColorValue {
+    rgb?: [number, number, number];
+    hs?: [number, number];
+    xy?: [number, number];
+    kelvin?: number;
+}
+/** Device capability */
+export type DeviceCapability = 'on_off' | 'brightness' | 'color' | 'color_temp' | 'position' | 'tilt' | 'temperature' | 'humidity' | 'motion' | 'contact' | 'lock' | 'media' | 'volume' | 'battery' | 'power' | 'energy';
+/** Device config */
+export interface DeviceConfig {
+    icon?: string;
+    hidden?: boolean;
+    disabled?: boolean;
+    readonly?: boolean;
+    confirmActions?: boolean;
+    updateInterval?: number;
+}
+/** Device metadata */
+export interface DeviceMetadata {
+    manufacturer?: string;
+    model?: string;
+    swVersion?: string;
+    hwVersion?: string;
+    ieeeAddress?: string;
+    zigbeeId?: string;
+    zwaveId?: number;
+    added?: Date;
+    lastSeen?: Date;
+}
+/** Scene */
+export interface HomeScene {
+    id: string;
+    name: string;
+    icon?: string;
+    room?: string;
+    entities: SceneEntity[];
+    snapshot?: boolean;
+    metadata?: SceneMetadata;
+}
+/** Scene entity */
+export interface SceneEntity {
+    entityId: string;
+    state?: string | number | boolean;
+    attributes?: Partial<DeviceAttributes>;
+}
+/** Scene metadata */
+export interface SceneMetadata {
+    created?: Date;
+    createdBy?: string;
+    modified?: Date;
+    lastActivated?: Date;
+    activationCount?: number;
+}
+/** Automation */
+export interface HomeAutomation {
+    id: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    mode: AutomationMode;
+    triggers: AutomationTrigger[];
+    conditions?: AutomationCondition[];
+    actions: AutomationAction[];
+    metadata?: AutomationMetadata;
+}
+/** Automation mode */
+export type AutomationMode = 'single' | 'restart' | 'queued' | 'parallel';
+/** Automation trigger */
+export interface AutomationTrigger {
+    id?: string;
+    type: AutomationTriggerType;
+    platform?: string;
+    config: TriggerConfig;
+}
+/** Trigger config */
+export interface TriggerConfig {
+    entityId?: string;
+    state?: string;
+    from?: string;
+    to?: string;
+    for?: Duration;
+    at?: string;
+    offset?: string;
+    event?: string;
+    eventData?: Record<string, unknown>;
+    zone?: string;
+    webhookId?: string;
+    tag?: string;
+    template?: string;
+    [key: string]: unknown;
+}
+/** Duration */
+export interface Duration {
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+}
+/** Automation condition */
+export interface AutomationCondition {
+    type: ConditionType;
+    config: ConditionConfig;
+}
+/** Condition type */
+export type ConditionType = 'state' | 'numeric_state' | 'time' | 'sun' | 'zone' | 'template' | 'and' | 'or' | 'not';
+/** Condition config */
+export interface ConditionConfig {
+    entityId?: string;
+    state?: string;
+    above?: number;
+    below?: number;
+    after?: string;
+    before?: string;
+    afterOffset?: string;
+    beforeOffset?: string;
+    zone?: string;
+    template?: string;
+    conditions?: AutomationCondition[];
+    [key: string]: unknown;
+}
+/** Automation action */
+export interface AutomationAction {
+    type: ActionType;
+    config: ActionConfig;
+    delay?: Duration;
+    enabled?: boolean;
+}
+/** Action type */
+export type ActionType = 'service' | 'scene' | 'delay' | 'wait' | 'condition' | 'repeat' | 'choose' | 'notification' | 'script';
+/** Action config */
+export interface ActionConfig {
+    service?: string;
+    target?: ActionTarget;
+    data?: Record<string, unknown>;
+    sceneId?: string;
+    delay?: Duration;
+    timeout?: Duration;
+    condition?: AutomationCondition;
+    sequence?: AutomationAction[];
+    count?: number;
+    while?: AutomationCondition;
+    until?: AutomationCondition;
+    options?: ChooseOption[];
+    default?: AutomationAction[];
+    message?: string;
+    title?: string;
+    notifyTarget?: string;
+    scriptId?: string;
+    [key: string]: unknown;
+}
+/** Action target */
+export interface ActionTarget {
+    entityId?: string | string[];
+    deviceId?: string | string[];
+    areaId?: string | string[];
+}
+/** Choose option */
+export interface ChooseOption {
+    conditions: AutomationCondition[];
+    sequence: AutomationAction[];
+}
+/** Automation metadata */
+export interface AutomationMetadata {
+    created?: Date;
+    createdBy?: string;
+    modified?: Date;
+    lastTriggered?: Date;
+    triggerCount?: number;
+}
+/** Energy data */
+export interface EnergyData {
+    summary: EnergySummary;
+    consumption: EnergyConsumption[];
+    production?: EnergyProduction[];
+    battery?: BatteryData;
+    comparison?: EnergyComparison;
+}
+/** Energy summary */
+export interface EnergySummary {
+    totalConsumption: number;
+    totalProduction?: number;
+    netUsage: number;
+    selfConsumption?: number;
+    gridImport?: number;
+    gridExport?: number;
+    cost: number;
+    savings?: number;
+    period: string;
+}
+/** Energy consumption */
+export interface EnergyConsumption {
+    timestamp: Date;
+    value: number;
+    cost?: number;
+    tariff?: string;
+    devices?: DeviceConsumption[];
+}
+/** Device consumption */
+export interface DeviceConsumption {
+    deviceId: string;
+    deviceName?: string;
+    value: number;
+    cost?: number;
+    percentage?: number;
+}
+/** Energy production */
+export interface EnergyProduction {
+    timestamp: Date;
+    value: number;
+    source: 'solar' | 'wind' | 'other';
+    exported?: number;
+    selfConsumed?: number;
+}
+/** Battery data */
+export interface BatteryData {
+    level: number;
+    charging: boolean;
+    power: number;
+    charged?: number;
+    discharged?: number;
+    cycles?: number;
+}
+/** Energy comparison */
+export interface EnergyComparison {
+    previousPeriod: number;
+    change: number;
+    changePercent: number;
+    trend: 'up' | 'down' | 'stable';
+    neighborhoodAvg?: number;
+    ranking?: string;
+}
+/** Climate zone */
+export interface ClimateZone {
+    id: string;
+    name: string;
+    rooms: string[];
+    thermostat?: string;
+    sensors?: string[];
+    mode: HVACMode;
+    targetTemperature: number;
+    currentTemperature?: number;
+    schedule?: ClimateSchedule;
+    presence?: PresenceInfo;
+}
+/** Climate schedule */
+export interface ClimateSchedule {
+    enabled: boolean;
+    periods: SchedulePeriod[];
+    overrides?: ScheduleOverride[];
+}
+/** Schedule period */
+export interface SchedulePeriod {
+    id: string;
+    name?: string;
+    days: number[];
+    startTime: string;
+    endTime: string;
+    temperature: number;
+    mode?: HVACMode;
+}
+/** Schedule override */
+export interface ScheduleOverride {
+    temperature: number;
+    mode?: HVACMode;
+    until?: Date;
+    reason?: string;
+}
+/** Presence info */
+export interface PresenceInfo {
+    occupied: boolean;
+    lastDetected?: Date;
+    persons?: string[];
+    awayMode?: boolean;
+}
+/** Climate preset */
+export interface ClimatePreset {
+    id: string;
+    name: string;
+    icon?: string;
+    zones: ZonePreset[];
+}
+/** Zone preset */
+export interface ZonePreset {
+    zoneId: string;
+    temperature: number;
+    mode?: HVACMode;
+}
+/** Light group */
+export interface LightGroup {
+    id: string;
+    name: string;
+    lights: string[];
+    room?: string;
+    state: LightGroupState;
+    scenes?: LightScene[];
+}
+/** Light group state */
+export interface LightGroupState {
+    on: boolean;
+    brightness?: number;
+    colorTemp?: number;
+    color?: ColorValue;
+    effect?: string;
+}
+/** Light scene */
+export interface LightScene {
+    id: string;
+    name: string;
+    icon?: string;
+    lights: LightState[];
+    transition?: number;
+}
+/** Light state */
+export interface LightState {
+    lightId: string;
+    on: boolean;
+    brightness?: number;
+    colorTemp?: number;
+    color?: ColorValue;
+    effect?: string;
+}
+/** Circadian rhythm config */
+export interface CircadianConfig {
+    enabled: boolean;
+    lights: string[];
+    sunrise?: string;
+    sunset?: string;
+    minBrightness?: number;
+    maxBrightness?: number;
+    minColorTemp?: number;
+    maxColorTemp?: number;
+    transition?: number;
+}
+/** Motion lighting config */
+export interface MotionLightingConfig {
+    motionSensor: string;
+    lights: string[];
+    brightness?: number;
+    colorTemp?: number;
+    timeout: number;
+    onlyAfterSunset?: boolean;
+    onlyWhenDark?: boolean;
+    disabled?: boolean;
+}
+/** Security system */
+export interface SecuritySystem {
+    state: SecurityState;
+    armedMode?: SecurityMode;
+    alarm?: AlarmInfo;
+    zones: SecurityZone[];
+    sensors: SecuritySensor[];
+    cameras?: SecurityCamera[];
+    history?: SecurityEvent[];
+}
+/** Security state */
+export type SecurityState = 'disarmed' | 'armed_home' | 'armed_away' | 'armed_night' | 'arming' | 'pending' | 'triggered';
+/** Security mode */
+export type SecurityMode = 'home' | 'away' | 'night' | 'vacation' | 'custom';
+/** Alarm info */
+export interface AlarmInfo {
+    active: boolean;
+    triggeredAt?: Date;
+    triggeredBy?: string;
+    zones?: string[];
+}
+/** Security zone */
+export interface SecurityZone {
+    id: string;
+    name: string;
+    type: ZoneType;
+    sensors: string[];
+    armed: boolean;
+    bypassed?: boolean;
+    delay?: number;
+}
+/** Zone type */
+export type ZoneType = 'entry' | 'perimeter' | 'interior' | 'motion' | 'panic' | 'fire' | 'water' | 'co';
+/** Security sensor */
+export interface SecuritySensor {
+    id: string;
+    name: string;
+    type: SensorType;
+    zone?: string;
+    state: boolean;
+    battery?: number;
+    tampered?: boolean;
+    bypassed?: boolean;
+    lastTriggered?: Date;
+}
+/** Sensor type */
+export type SensorType = 'door' | 'window' | 'motion' | 'glass_break' | 'smoke' | 'co' | 'water' | 'vibration' | 'panic';
+/** Security camera */
+export interface SecurityCamera {
+    id: string;
+    name: string;
+    type: CameraType;
+    room?: string;
+    stream?: StreamInfo;
+    recording?: RecordingConfig;
+    detection?: DetectionConfig;
+    ptz?: PTZCapability;
+}
+/** Camera type */
+export type CameraType = 'indoor' | 'outdoor' | 'doorbell' | 'floodlight' | 'ptz';
+/** Stream info */
+export interface StreamInfo {
+    url: string;
+    type: 'hls' | 'rtsp' | 'webrtc' | 'mjpeg';
+    audioEnabled?: boolean;
+    resolution?: string;
+}
+/** Recording config */
+export interface RecordingConfig {
+    enabled: boolean;
+    continuous?: boolean;
+    motionOnly?: boolean;
+    retention?: number;
+    storage?: string;
+}
+/** Detection config */
+export interface DetectionConfig {
+    motion?: boolean;
+    person?: boolean;
+    vehicle?: boolean;
+    animal?: boolean;
+    package?: boolean;
+    zones?: DetectionZone[];
+}
+/** Detection zone */
+export interface DetectionZone {
+    id: string;
+    name: string;
+    points: Array<{
+        x: number;
+        y: number;
+    }>;
+    enabled: boolean;
+}
+/** PTZ capability */
+export interface PTZCapability {
+    pan: boolean;
+    tilt: boolean;
+    zoom: boolean;
+    presets?: PTZPreset[];
+}
+/** PTZ preset */
+export interface PTZPreset {
+    id: string;
+    name: string;
+    pan?: number;
+    tilt?: number;
+    zoom?: number;
+}
+/** Security event */
+export interface SecurityEvent {
+    id: string;
+    timestamp: Date;
+    type: SecurityEventType;
+    description: string;
+    user?: string;
+    zone?: string;
+    sensor?: string;
+    camera?: string;
+}
+/** Security event type */
+export type SecurityEventType = 'arm' | 'disarm' | 'trigger' | 'alarm' | 'tamper' | 'motion' | 'entry' | 'bypass' | 'fault' | 'restore';
+/** Discovery result */
+export interface DiscoveryResult {
+    devices: DiscoveredDevice[];
+    scanTime: Date;
+    duration: number;
+    protocols: HomeProtocol[];
+}
+/** Discovered device */
+export interface DiscoveredDevice {
+    id: string;
+    name?: string;
+    type?: HomeDeviceType;
+    protocol: HomeProtocol;
+    address?: string;
+    manufacturer?: string;
+    model?: string;
+    alreadyAdded?: boolean;
+    supported?: boolean;
+    capabilities?: DeviceCapability[];
+}
+/** Discovery config */
+export interface DiscoveryConfig {
+    protocols?: HomeProtocol[];
+    timeout?: number;
+    deep?: boolean;
+    includeUnsupported?: boolean;
+}
+/** Voice command */
+export interface VoiceCommand {
+    id: string;
+    text: string;
+    intent: VoiceIntent;
+    entities?: VoiceEntity[];
+    response?: string;
+    actions?: AutomationAction[];
+}
+/** Voice intent */
+export type VoiceIntent = 'turn_on' | 'turn_off' | 'toggle' | 'set_brightness' | 'set_color' | 'set_temperature' | 'arm_security' | 'disarm_security' | 'lock' | 'unlock' | 'play' | 'pause' | 'stop' | 'volume' | 'scene' | 'query' | 'unknown';
+/** Voice entity */
+export interface VoiceEntity {
+    type: string;
+    value: string;
+    confidence?: number;
+    deviceId?: string;
+    room?: string;
+}
+/** Routine */
+export interface Routine {
+    id: string;
+    name: string;
+    icon?: string;
+    voicePhrases?: string[];
+    triggers?: AutomationTrigger[];
+    actions: AutomationAction[];
+    enabled: boolean;
+    metadata?: AutomationMetadata;
+}
+/** Floor plan */
+export interface FloorPlan {
+    id: string;
+    name: string;
+    floor: number;
+    image?: string;
+    width: number;
+    height: number;
+    scale?: number;
+    rooms: FloorPlanRoom[];
+    devices: FloorPlanDevice[];
+}
+/** Floor plan room */
+export interface FloorPlanRoom {
+    roomId: string;
+    points: Array<{
+        x: number;
+        y: number;
+    }>;
+    label?: FloorPlanLabel;
+}
+/** Floor plan label */
+export interface FloorPlanLabel {
+    text: string;
+    x: number;
+    y: number;
+}
+/** Floor plan device */
+export interface FloorPlanDevice {
+    deviceId: string;
+    x: number;
+    y: number;
+    rotation?: number;
+    icon?: string;
+}
+/** Home notification */
+export interface HomeNotification {
+    id: string;
+    title: string;
+    message: string;
+    timestamp: Date;
+    type: NotificationType;
+    priority: NotificationPriority;
+    entity?: string;
+    room?: string;
+    read?: boolean;
+    dismissed?: boolean;
+    actions?: NotificationAction[];
+}
+/** Notification type */
+export type NotificationType = 'security' | 'energy' | 'climate' | 'device' | 'automation' | 'system' | 'info';
+/** Notification priority */
+export type NotificationPriority = 'critical' | 'high' | 'normal' | 'low';
+/** Notification action */
+export interface NotificationAction {
+    id: string;
+    label: string;
+    action: AutomationAction;
+}
+/** Notification config */
+export interface NotificationConfigSettings {
+    enabled: boolean;
+    channels?: NotificationChannel[];
+    quiet?: QuietHours;
+    filters?: NotificationFilter[];
+}
+/** Notification channel */
+export interface NotificationChannel {
+    type: 'push' | 'email' | 'sms' | 'voice';
+    enabled: boolean;
+    target?: string;
+    priorityThreshold?: NotificationPriority;
+}
+/** Quiet hours */
+export interface QuietHours {
+    enabled: boolean;
+    start: string;
+    end: string;
+    allowCritical?: boolean;
+}
+/** Notification filter */
+export interface NotificationFilter {
+    type?: NotificationType;
+    entity?: string;
+    room?: string;
+    muted: boolean;
+}
+//# sourceMappingURL=smart-home.d.ts.map