Porch light

const definition = {
  name: 'Porch Light',
  namespace: 'com.example',
  description: 'Turns lights on before sunset and off at a fixed time every night.',
  category: 'lighting',
};

const preferences = {
  pages: [{
    id: 'main',
    title: 'Porch Light',
    inputs: [
      { key: 'lights', label: 'Lights', type: 'entity', domainFilter: 'light', multiple: true, required: true },
      { key: 'beforeSunsetMinutes', label: 'Turn on this many minutes before sunset',
        type: 'number', default: 20, minValue: 0, maxValue: 120 },
      { key: 'brightness', label: 'Brightness (1–100)', type: 'number', minValue: 1, maxValue: 100,
        requiresEntityFeature: { siblingKey: 'lights', domain: 'light', colorMode: 'brightness' } },
      { key: 'offTime', label: 'Turn off at', type: 'time', default: '23:00', required: true },
    ],
  }],
};

function installed() { initialize(); }
function updated() { unsubscribe(); unschedule(); initialize(); }

function initialize() {
  subscribeToLocationEvent('systemStart', armSunset);   // a reboot may have dropped the pending one-shot
  runDaily(typeof offTime === 'string' ? offTime : '23:00', lightsOff);
  armSunset();
}

function armSunset() {
  const minutes = typeof beforeSunsetMinutes === 'number' ? beforeSunsetMinutes : 20;
  scheduleAtSunset(lightsOn, -minutes);                 // fires once, at the next sunset
}

function lightsOn() {
  const params = typeof brightness === 'number' ? { brightnessPercent: brightness } : {};
  lights.turnOn(params);                                // one light or many: the call fans out
  state.lastOnAt = new Date().toISOString();
  armSunset();                                          // re-arm for tomorrow
}

function lightsOff() {
  lights.turnOff();
}

function run() {                                        // the Run button: "do the evening thing now"
  lightsOn();
}