io-actions/app/blocks/power_ups/weather.js

import weatherMixin from "./weather_mixin.js"


const
  { keyToLabel, HELP_TEXT_BY_PROP: propText } = weatherMixin,
  propLines = (prefix, props) =>
    props.map(prop => `${prefix}- \`${keyToLabel(prop)}\`: ${propText[prop].description}`).join("")

/** @type {import('#types').BlockDefinitionRaw} */
export default {
  type: "weather",
  bytecodeKey: "weather",
  name: "Weather",
  colour: 360,
  ioPlus: true,
  description: "Fetch the current or forecast weather conditions at the specified location.",

  connections: {
    mode: "value",
    output: "expression",
  },

  mixins: [
    'replaceDropdownOptions',
    { weatherMixin }
  ],

  extensions: {
    prepareWeather: ({ block, observeData, data: { weatherLocationOptions } }) => {
      // populate weather locations
      if(!weatherLocationOptions?.length) {
        weatherLocationOptions = [[ "No locations! Visit Power-Ups -> Weather", "" ]]
        block.setEnabled(false)

      } else if(weatherLocationOptions[0][1] != "") {
        weatherLocationOptions.unshift([ "Select Location", "" ])
      }

      // @ts-ignore
      block.replaceDropdownOptions("POWER_UP_ID", weatherLocationOptions)

      // skip the rest if we're in the toolbox
      if(block.isInFlyout) { return }

      // yield so fields can populate, flags can be set
      setTimeout(() => {
        // nope out for insertion markers
        if(block.isInsertionMarker()) { return }

        // @ts-ignore auto-disable block, if necessary
        block.setEnabledByLocation()

        // react to incoming forecast data
        const unobserve = observeData('currentWeatherByLocation', (newData = {}) => {
          // if this block is disposed, clean up this listener
          if (block.isDisposed()) { unobserve(); return }
          // @ts-ignore update the reference to the injected/updated extension data
          block.currentWeatherByLocation = newData
          // @ts-ignore re-run the things that use the data
          block.refreshPropertyOptions({})
        })
      }, 1)
    }
  },

  template: `
    Weather |CENTER
    At: %POWER_UP_ID
    When: %WEATHER_TIME
    Metric: %WEATHER_PROPERTY
    %WEATHER_PROPERTY_HELP
  `,

  fields: {
    POWER_UP_ID: {
      options: [
        [ "Loading locations...", "" ],
      ]
    },

    WEATHER_TIME: {
      options: [
        [ "Now", "current" ],
        [ "In 5 minutes", "forecast_minutes_5" ],
        [ "In 30 minutes", "forecast_minutes_30" ],
        [ "This hour", "forecast_hours_0" ],
        [ "In 1 hour", "forecast_hours_1" ],
        [ "In 2 hours", "forecast_hours_2" ],
        [ "In 6 hours", "forecast_hours_6" ],
        [ "In 12 hours", "forecast_hours_12" ],
        [ "In 24 hours", "forecast_hours_24" ],
        [ "Today", "forecast_days_0" ],
        [ "Tomorrow", "forecast_days_1" ],
        [ "In 2 days", "forecast_days_2" ],
        [ "In 3 days", "forecast_days_3" ],
        [ "In 4 days", "forecast_days_4" ],
        [ "In 5 days", "forecast_days_5" ],
        [ "In 6 days", "forecast_days_6" ],
        [ "In 7 days", "forecast_days_7" ],
        [ "In 8 days", "forecast_days_8" ],
        [ "In 9 days", "forecast_days_9" ],
      ]
    },

    WEATHER_PROPERTY: {
      label: ""
    },

    WEATHER_PROPERTY_HELP: {
      label: ""
    },
  },

  docOverrides: {
    fields: `
      ### \`Location\`
      The list of weather locations defined in the Weather Power-Up. Select
      the location you would like weather information for.

      ### \`Forecast\` and \`Metric\`
      A list a weather forecasts to choose from. The weather metrics available
      are different based on the chosen forecast.

      :::details \`Now\` Metrics` + propLines(`
      `, weatherMixin.CURRENT_PROPS) + `
      :::

      :::details \`In X minutes\` Metrics` + propLines(`
      `, weatherMixin.MINUTE_PROPS) + `
      :::

      :::details \`In X hours\` Metrics` + propLines(`
      `, weatherMixin.HOUR_PROPS) + `
      :::

      :::details \`In X days\` Metrics
      **Some daily metrics can be narrowed to just the daytime or overnight portions.**
      ` + propLines(`
      `, weatherMixin.DAY_PROPS) + `
      :::
    `
  },

  generators: {
    json: block => {
      const
        powerUpId = parseInt(block.getFieldValue('POWER_UP_ID'), 10),
        weatherTime = block.getFieldValue('WEATHER_TIME'),
        weatherProperty = block.getFieldValue('WEATHER_PROPERTY'),
        payload = { weather: {
            powerUpId, weatherTime, weatherProperty
        }}

      return [ JSON.stringify(payload), 0 ]
    }
  },

  regenerators: {
    json: blockObject => {
      const payload = blockObject.weather

      return {
        type: "weather",
        fields: {
          POWER_UP_ID: String(payload.powerUpId),
          WEATHER_TIME: payload.weatherTime,
          WEATHER_PROPERTY: payload.weatherProperty,
        }
      }
    }
  }
}