@mywallpaper/addon-sdk 2.12.0 → 2.13.0

package/README.md

@@ -48,7 +48,7 @@ my-addon/
 {
   "name": "My Awesome Addon",
   "version": "1.0.0",
-  "sdkVersion": "2.12.0",
+  "sdkVersion": "2.13.0",
   "description": "A cool widget for your desktop",
   "author": "Your Name",
   "capabilities": {

package/dist/index.d.mts

@@ -955,6 +955,37 @@ interface SettingOption {
  * ```
  */
 interface SettingsAPI {
+    /**
+     * Update a single setting value from the addon.
+     * This syncs the value back to the host UI and persists it.
+     *
+     * @param settingKey - The setting key to update
+     * @param value - The new value
+     *
+     * @example
+     * ```typescript
+     * // Update a color setting after randomization
+     * api.settings.setValue('primaryColor', '#ff0000')
+     * ```
+     */
+    setValue(settingKey: string, value: unknown): void;
+    /**
+     * Update multiple setting values at once.
+     * This syncs all values back to the host UI and persists them.
+     *
+     * @param values - Object with settingKey -> value pairs
+     *
+     * @example
+     * ```typescript
+     * // Update multiple colors after randomization
+     * api.settings.setValues({
+     *   primaryColor: '#ff0000',
+     *   secondaryColor: '#00ff00',
+     *   backgroundColor: '#0000ff'
+     * })
+     * ```
+     */
+    setValues(values: Record<string, unknown>): void;
     /**
      * Update the options for a select-type setting.
      * The new options replace existing ones from the manifest.

package/dist/index.d.ts

@@ -955,6 +955,37 @@ interface SettingOption {
  * ```
  */
 interface SettingsAPI {
+    /**
+     * Update a single setting value from the addon.
+     * This syncs the value back to the host UI and persists it.
+     *
+     * @param settingKey - The setting key to update
+     * @param value - The new value
+     *
+     * @example
+     * ```typescript
+     * // Update a color setting after randomization
+     * api.settings.setValue('primaryColor', '#ff0000')
+     * ```
+     */
+    setValue(settingKey: string, value: unknown): void;
+    /**
+     * Update multiple setting values at once.
+     * This syncs all values back to the host UI and persists them.
+     *
+     * @param values - Object with settingKey -> value pairs
+     *
+     * @example
+     * ```typescript
+     * // Update multiple colors after randomization
+     * api.settings.setValues({
+     *   primaryColor: '#ff0000',
+     *   secondaryColor: '#00ff00',
+     *   backgroundColor: '#0000ff'
+     * })
+     * ```
+     */
+    setValues(values: Record<string, unknown>): void;
     /**
      * Update the options for a select-type setting.
      * The new options replace existing ones from the manifest.

package/dist/manifest.d.mts

@@ -936,6 +936,37 @@ interface SettingOption {
  * ```
  */
 interface SettingsAPI {
+    /**
+     * Update a single setting value from the addon.
+     * This syncs the value back to the host UI and persists it.
+     *
+     * @param settingKey - The setting key to update
+     * @param value - The new value
+     *
+     * @example
+     * ```typescript
+     * // Update a color setting after randomization
+     * api.settings.setValue('primaryColor', '#ff0000')
+     * ```
+     */
+    setValue(settingKey: string, value: unknown): void;
+    /**
+     * Update multiple setting values at once.
+     * This syncs all values back to the host UI and persists them.
+     *
+     * @param values - Object with settingKey -> value pairs
+     *
+     * @example
+     * ```typescript
+     * // Update multiple colors after randomization
+     * api.settings.setValues({
+     *   primaryColor: '#ff0000',
+     *   secondaryColor: '#00ff00',
+     *   backgroundColor: '#0000ff'
+     * })
+     * ```
+     */
+    setValues(values: Record<string, unknown>): void;
     /**
      * Update the options for a select-type setting.
      * The new options replace existing ones from the manifest.

package/dist/manifest.d.ts

@@ -936,6 +936,37 @@ interface SettingOption {
  * ```
  */
 interface SettingsAPI {
+    /**
+     * Update a single setting value from the addon.
+     * This syncs the value back to the host UI and persists it.
+     *
+     * @param settingKey - The setting key to update
+     * @param value - The new value
+     *
+     * @example
+     * ```typescript
+     * // Update a color setting after randomization
+     * api.settings.setValue('primaryColor', '#ff0000')
+     * ```
+     */
+    setValue(settingKey: string, value: unknown): void;
+    /**
+     * Update multiple setting values at once.
+     * This syncs all values back to the host UI and persists them.
+     *
+     * @param values - Object with settingKey -> value pairs
+     *
+     * @example
+     * ```typescript
+     * // Update multiple colors after randomization
+     * api.settings.setValues({
+     *   primaryColor: '#ff0000',
+     *   secondaryColor: '#00ff00',
+     *   backgroundColor: '#0000ff'
+     * })
+     * ```
+     */
+    setValues(values: Record<string, unknown>): void;
     /**
      * Update the options for a select-type setting.
      * The new options replace existing ones from the manifest.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mywallpaper/addon-sdk",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "SDK for building MyWallpaper addons - TypeScript types, manifest validation, and utilities",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/runtime/addon-client.js

@@ -426,7 +426,7 @@
   window.MyWallpaper = {
     get config() { return config },
     layerId: layerId,
-    version: '2.11.0',
+    version: '2.13.0',
 
     onSettingsChange: function (fn) { if (typeof fn === 'function') settingsCallbacks.push(fn) },
 
@@ -470,7 +470,7 @@
       isReady = true
       opts = opts || {}
       send('ADDON_READY', {
-        version: '2.11.0',
+        version: '2.13.0',
         capabilities: opts.capabilities || [],
         subscribedEvents: opts.subscribedEvents || []
       })
@@ -761,6 +761,42 @@
      * })))
      */
     settings: {
+      /**
+       * Update a setting value from the addon
+       * This syncs the value back to the host UI and persists it
+       * @param {string} settingKey - The setting key to update
+       * @param {*} value - The new value
+       */
+      setValue: function (settingKey, value) {
+        if (!settingKey || typeof settingKey !== 'string') {
+          console.error('[MyWallpaper] settings.setValue: settingKey is required')
+          return
+        }
+        // Update local config immediately
+        config[settingKey] = value
+        // Send to host to update UI and persist
+        send('SETTINGS_VALUE_UPDATE', { settingKey: settingKey, value: value })
+      },
+
+      /**
+       * Update multiple setting values at once
+       * @param {Record<string, *>} values - Object with settingKey -> value pairs
+       */
+      setValues: function (values) {
+        if (!values || typeof values !== 'object') {
+          console.error('[MyWallpaper] settings.setValues: values object is required')
+          return
+        }
+        // Update local config immediately
+        for (var key in values) {
+          if (Object.prototype.hasOwnProperty.call(values, key)) {
+            config[key] = values[key]
+          }
+        }
+        // Send to host to update UI and persist
+        send('SETTINGS_VALUES_UPDATE', { values: values })
+      },
+
       /**
        * Update the options for a select-type setting
        * @param {string} settingKey - The setting key to update
@@ -819,5 +855,5 @@
     }
   }
 
-  console.warn('[MyWallpaper] SDK v2.11.0 ready:', layerId)
+  console.warn('[MyWallpaper] SDK v2.13.0 ready:', layerId)
 })()