expo-widgets 56.0.13 → 56.0.15

package/plugin/build/types/WidgetFamily.type.d.ts

@@ -1,9 +1,10 @@
-export declare enum WidgetFamily {
-    systemSmall = "systemSmall",
-    systemMedium = "systemMedium",
-    systemLarge = "systemLarge",
-    systemExtraLarge = "systemExtraLarge",
-    accessoryCircular = "accessoryCircular",
-    accessoryRectangular = "accessoryRectangular",
-    accessoryInline = "accessoryInline"
-}
+export declare const WidgetFamily: {
+    readonly systemSmall: "systemSmall";
+    readonly systemMedium: "systemMedium";
+    readonly systemLarge: "systemLarge";
+    readonly systemExtraLarge: "systemExtraLarge";
+    readonly accessoryCircular: "accessoryCircular";
+    readonly accessoryRectangular: "accessoryRectangular";
+    readonly accessoryInline: "accessoryInline";
+};
+export type WidgetFamily = (typeof WidgetFamily)[keyof typeof WidgetFamily];

package/plugin/build/types/WidgetFamily.type.js

@@ -1,13 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WidgetFamily = void 0;
-var WidgetFamily;
-(function (WidgetFamily) {
-    WidgetFamily["systemSmall"] = "systemSmall";
-    WidgetFamily["systemMedium"] = "systemMedium";
-    WidgetFamily["systemLarge"] = "systemLarge";
-    WidgetFamily["systemExtraLarge"] = "systemExtraLarge";
-    WidgetFamily["accessoryCircular"] = "accessoryCircular";
-    WidgetFamily["accessoryRectangular"] = "accessoryRectangular";
-    WidgetFamily["accessoryInline"] = "accessoryInline";
-})(WidgetFamily || (exports.WidgetFamily = WidgetFamily = {}));
+exports.WidgetFamily = {
+    systemSmall: 'systemSmall',
+    systemMedium: 'systemMedium',
+    systemLarge: 'systemLarge',
+    systemExtraLarge: 'systemExtraLarge',
+    accessoryCircular: 'accessoryCircular',
+    accessoryRectangular: 'accessoryRectangular',
+    accessoryInline: 'accessoryInline',
+};

package/plugin/build/withWidgets.js

@@ -4,71 +4,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_plugins_1 = require("expo/config-plugins");
-const withAppGroupEntitlements_1 = __importDefault(require("./withAppGroupEntitlements"));
-const withAppInfoPlist_1 = __importDefault(require("./withAppInfoPlist"));
-const withEasConfig_1 = __importDefault(require("./withEasConfig"));
-const withIosWarning_1 = __importDefault(require("./withIosWarning"));
-const withPodsLinking_1 = __importDefault(require("./withPodsLinking"));
-const withPushNotifications_1 = __importDefault(require("./withPushNotifications"));
-const withWidgetSourceFiles_1 = __importDefault(require("./withWidgetSourceFiles"));
-const withTargetXcodeProject_1 = __importDefault(require("./xcode/withTargetXcodeProject"));
+const withAndroidWidgets_1 = __importDefault(require("./android/withAndroidWidgets"));
+const withIosWidgets_1 = __importDefault(require("./ios/withIosWidgets"));
 const pkg = require('../../package.json');
 const withWidgets = (config, props) => {
-    let plugins = [];
-    const deploymentTarget = '16.4';
-    const targetName = 'ExpoWidgetsTarget';
-    let bundleIdentifier = props?.bundleIdentifier;
-    if (!bundleIdentifier) {
-        bundleIdentifier = `${config.ios?.bundleIdentifier}.${targetName}`;
-        plugins.push([
-            withIosWarning_1.default,
-            {
-                property: 'bundleIdentifier',
-                warning: `Expo Widgets: No bundle identifier provided, using fallback: ${bundleIdentifier}.`,
-            },
-        ]);
-    }
-    let groupIdentifier = props?.groupIdentifier;
-    if (!groupIdentifier) {
-        if (!config.ios?.bundleIdentifier) {
-            throw new Error('iOS bundle identifier is required. Please set `ios.bundleIdentifier` in `app.json` or `app.config.js`');
-        }
-        groupIdentifier = `group.${config.ios.bundleIdentifier}`;
-        plugins.push([
-            withIosWarning_1.default,
-            {
-                property: 'groupIdentifier',
-                warning: `Expo Widgets: No group identifier provided, using fallback: ${groupIdentifier}.`,
-            },
-        ]);
-    }
     const widgets = props?.widgets ?? [];
-    const enablePushNotifications = props?.enablePushNotifications ?? false;
-    const frequentUpdates = props?.frequentUpdates ?? false;
-    let sharedFiles = [];
-    const setFiles = (files) => {
-        sharedFiles = [...sharedFiles, ...files];
-    };
-    const getFileUris = () => sharedFiles;
-    plugins = [
-        ...plugins,
-        [withEasConfig_1.default, { targetName, bundleIdentifier, groupIdentifier }],
-        [withPodsLinking_1.default, { targetName }],
-        [withWidgetSourceFiles_1.default, { targetName, widgets, groupIdentifier, onFilesGenerated: setFiles }],
-        [withAppInfoPlist_1.default, { frequentUpdates, groupIdentifier }],
-        [withPushNotifications_1.default, { enablePushNotifications }],
-        [withAppGroupEntitlements_1.default, { groupIdentifier }],
-        [
-            withTargetXcodeProject_1.default,
-            {
-                targetName,
-                bundleIdentifier,
-                deploymentTarget,
-                appleTeamId: config.ios?.appleTeamId,
-                getFileUris,
-            },
-        ],
-    ];
-    return (0, config_plugins_1.withPlugins)(config, plugins);
+    return (0, config_plugins_1.withPlugins)(config, [
+        [withAndroidWidgets_1.default, { widgets }],
+        [withIosWidgets_1.default, { ...(props ?? {}), widgets }],
+    ]);
 };
 exports.default = (0, config_plugins_1.createRunOncePlugin)(withWidgets, pkg.name, pkg.version);

package/plugin/src/android/resourceNames.ts

@@ -0,0 +1,29 @@
+import { WidgetConfig } from '../types/WidgetConfig.type';
+
+const toAndroidResourceName = (name: string): string => {
+  const resourceName = name
+    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2')
+    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+    .replace(/[^A-Za-z0-9_]/g, '_')
+    .replace(/_+/g, '_')
+    .replace(/^_+|_+$/g, '')
+    .toLowerCase();
+
+  return /^[a-z]/.test(resourceName) ? resourceName : `widget_${resourceName}`;
+};
+
+export const getProviderClassName = (widget: WidgetConfig): string => {
+  return `${widget.name}Provider`;
+};
+
+export const getWidgetInfoResourceName = (widget: WidgetConfig): string => {
+  return `${toAndroidResourceName(widget.name)}_info`;
+};
+
+export const getWidgetDisplayNameResourceName = (widget: WidgetConfig): string => {
+  return `${toAndroidResourceName(widget.name)}_display_name`;
+};
+
+export const getWidgetDescriptionResourceName = (widget: WidgetConfig): string => {
+  return `${toAndroidResourceName(widget.name)}_description`;
+};

package/plugin/src/android/withAndroidWidgetFiles.ts

@@ -0,0 +1,143 @@
+import { AndroidConfig, ConfigPlugin, withDangerousMod } from 'expo/config-plugins';
+import * as fs from 'fs';
+import * as path from 'path';
+
+import {
+  getProviderClassName,
+  getWidgetDescriptionResourceName,
+  getWidgetDisplayNameResourceName,
+  getWidgetInfoResourceName,
+} from './resourceNames';
+import { WidgetConfig } from '../types/WidgetConfig.type';
+
+const withAndroidWidgetFiles: ConfigPlugin<WidgetConfig[]> = (config, widgets) => {
+  return withDangerousMod(config, [
+    'android',
+    async (config) => {
+      const androidPackage = AndroidConfig.Package.getPackage(config);
+      if (
+        typeof androidPackage !== 'string' ||
+        !/^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)+$/.test(androidPackage)
+      ) {
+        throw new Error(
+          'Android package is required for expo-widgets. Please set `android.package` in `app.json` or `app.config.js`.'
+        );
+      }
+
+      const projectRoot = config.modRequest.platformProjectRoot;
+      const packageDirectory = path.join(
+        projectRoot,
+        'app/src/main/java',
+        ...androidPackage.split('.')
+      );
+      const xmlDirectory = path.join(projectRoot, 'app/src/main/res/xml');
+      const valuesDirectory = path.join(projectRoot, 'app/src/main/res/values');
+      const widgetsXmlPath = path.join(xmlDirectory, 'expo_widgets.xml');
+
+      fs.mkdirSync(packageDirectory, { recursive: true });
+      fs.mkdirSync(xmlDirectory, { recursive: true });
+      fs.mkdirSync(valuesDirectory, { recursive: true });
+
+      if (fs.existsSync(widgetsXmlPath)) {
+        fs.rmSync(widgetsXmlPath);
+      }
+      fs.writeFileSync(widgetsXmlPath, createWidgetStringsXml(widgets));
+
+      for (const widget of widgets) {
+        const providerPath = path.join(packageDirectory, `${getProviderClassName(widget)}.kt`);
+        if (fs.existsSync(providerPath)) {
+          fs.rmSync(providerPath);
+        }
+        fs.writeFileSync(
+          path.join(packageDirectory, `${getProviderClassName(widget)}.kt`),
+          createWidgetProviderKt(androidPackage, widget)
+        );
+
+        const widgetInfoPath = path.join(xmlDirectory, `${getWidgetInfoResourceName(widget)}.xml`);
+        if (fs.existsSync(widgetInfoPath)) {
+          fs.rmSync(widgetInfoPath);
+        }
+        fs.writeFileSync(
+          path.join(xmlDirectory, `${getWidgetInfoResourceName(widget)}.xml`),
+          createWidgetInfoXml(widget)
+        );
+      }
+
+      return config;
+    },
+  ]);
+};
+
+const createWidgetProviderKt = (androidPackage: string, widget: WidgetConfig): string => {
+  return `package ${androidPackage}
+
+import expo.modules.widgets.ExpoWidgetsAppWidgetProvider
+
+class ${getProviderClassName(widget)} : ExpoWidgetsAppWidgetProvider(${JSON.stringify(widget.name)})
+`;
+};
+
+const createWidgetInfoXml = (widget: WidgetConfig): string => {
+  const android = getAndroidWidgetConfig(widget);
+
+  return `<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+  android:minWidth="${android.minWidth}dp"
+  android:minHeight="${android.minHeight}dp"
+  android:targetCellWidth="${android.targetCellWidth}"
+  android:targetCellHeight="${android.targetCellHeight}"
+  android:updatePeriodMillis="0"
+  android:initialLayout="@layout/glance_default_loading_layout"
+  android:description="@string/${getWidgetDescriptionResourceName(widget)}"
+  android:resizeMode="${getWidgetResizeMode(widget)}"
+  android:widgetCategory="home_screen" />
+`;
+};
+
+const getWidgetResizeMode = (widget: WidgetConfig): string => {
+  const resizeMode = widget.android?.resizeMode;
+  switch (resizeMode) {
+    case 'none':
+      return 'none';
+    case 'horizontal':
+      return 'horizontal';
+    case 'vertical':
+      return 'vertical';
+    case 'both':
+    default:
+      return 'horizontal|vertical';
+  }
+};
+
+const getAndroidWidgetConfig = (widget: WidgetConfig): NonNullable<WidgetConfig['android']> => {
+  return {
+    minWidth: widget.android?.minWidth ?? 180,
+    minHeight: widget.android?.minHeight ?? 110,
+    targetCellWidth: widget.android?.targetCellWidth ?? 4,
+    targetCellHeight: widget.android?.targetCellHeight ?? 2,
+  };
+};
+
+const escapeXmlSpecialChars = (value: string): string => {
+  return value
+    .replace(/&/g, '&amp;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;');
+};
+
+const createWidgetStringsXml = (widgets: WidgetConfig[]): string => {
+  return `<?xml version="1.0" encoding="utf-8"?>
+<resources>
+${widgets
+  .map((widget) => {
+    return `  <string name="${getWidgetDisplayNameResourceName(widget)}">${escapeXmlSpecialChars(widget.displayName)}</string>
+  <string name="${getWidgetDescriptionResourceName(widget)}">${escapeXmlSpecialChars(widget.description)}</string>`;
+  })
+  .join('\n')}
+</resources>
+`;
+};
+
+export default withAndroidWidgetFiles;

package/plugin/src/android/withAndroidWidgetManifest.ts

@@ -0,0 +1,94 @@
+import { AndroidConfig, ConfigPlugin, withAndroidManifest } from 'expo/config-plugins';
+
+import {
+  getProviderClassName,
+  getWidgetDisplayNameResourceName,
+  getWidgetInfoResourceName,
+} from './resourceNames';
+import { WidgetConfig } from '../types/WidgetConfig.type';
+
+const EXPO_WIDGETS_INTERACTION_ACTION = 'expo.modules.widgets.ACTION_WIDGET_INTERACTION';
+const EXPO_WIDGETS_NAME_METADATA = 'expo.modules.widgets.NAME';
+
+type ManifestReceiver = {
+  $: {
+    'android:name': string;
+    'android:exported'?: 'true' | 'false';
+    'android:label'?: string;
+    [key: string]: string | undefined;
+  };
+  'intent-filter'?: {
+    action?: {
+      $: {
+        'android:name': string;
+      };
+    }[];
+  }[];
+  'meta-data'?: {
+    $: {
+      'android:name': string;
+      'android:value'?: string;
+      'android:resource'?: string;
+    };
+  }[];
+};
+
+const createWidgetReceiver = (widget: WidgetConfig): ManifestReceiver => {
+  return {
+    $: {
+      'android:name': `.${getProviderClassName(widget)}`,
+      'android:exported': 'true',
+      'android:label': `@string/${getWidgetDisplayNameResourceName(widget)}`,
+    },
+    'intent-filter': [
+      {
+        action: [
+          {
+            $: {
+              'android:name': 'android.appwidget.action.APPWIDGET_UPDATE',
+            },
+          },
+          {
+            $: {
+              'android:name': EXPO_WIDGETS_INTERACTION_ACTION,
+            },
+          },
+        ],
+      },
+    ],
+    'meta-data': [
+      {
+        $: {
+          'android:name': 'android.appwidget.provider',
+          'android:resource': `@xml/${getWidgetInfoResourceName(widget)}`,
+        },
+      },
+      {
+        $: {
+          'android:name': EXPO_WIDGETS_NAME_METADATA,
+          'android:value': widget.name,
+        },
+      },
+    ],
+  };
+};
+
+const withAndroidWidgetManifest: ConfigPlugin<WidgetConfig[]> = (config, widgets) => {
+  return withAndroidManifest(config, (config) => {
+    const mainApplication = AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);
+    const receivers = (mainApplication.receiver ?? []) as ManifestReceiver[];
+    const isNotWidgetReceiver = (receiver: ManifestReceiver) =>
+      !receiver['meta-data']?.some(
+        (metaData) => metaData.$['android:name'] === EXPO_WIDGETS_NAME_METADATA
+      );
+
+    mainApplication.receiver = [
+      ...receivers.filter(isNotWidgetReceiver),
+      ...widgets.map(createWidgetReceiver),
+    ];
+
+    return config;
+  });
+};
+
+export default withAndroidWidgetManifest;

package/plugin/src/android/withAndroidWidgets.ts

@@ -0,0 +1,21 @@
+import { ConfigPlugin } from 'expo/config-plugins';
+
+import withAndroidWidgetFiles from './withAndroidWidgetFiles';
+import withAndroidWidgetManifest from './withAndroidWidgetManifest';
+import { WidgetConfig } from '../types/WidgetConfig.type';
+
+const withAndroidWidgets: ConfigPlugin<{ widgets: WidgetConfig[] }> = (config, { widgets }) => {
+  if (widgets.length === 0) {
+    return config;
+  }
+
+  const androidWidgets = widgets.filter((widget) => widget.android !== null);
+  let nextConfig = config;
+  if (androidWidgets.length > 0) {
+    nextConfig = withAndroidWidgetFiles(nextConfig, androidWidgets);
+  }
+
+  return withAndroidWidgetManifest(nextConfig, androidWidgets);
+};
+
+export default withAndroidWidgets;

package/plugin/src/ios/withIosWidgets.ts

@@ -0,0 +1,99 @@
+import { ConfigPlugin, StaticPlugin, withPlugins } from 'expo/config-plugins';
+
+import withAppGroupEntitlements from './withAppGroupEntitlements';
+import withAppInfoPlist from './withAppInfoPlist';
+import withEasConfig from './withEasConfig';
+import withIosWarning from './withIosWarning';
+import withPodsLinking from './withPodsLinking';
+import withPushNotifications from './withPushNotifications';
+import withWidgetSourceFiles from './withWidgetSourceFiles';
+import { WidgetConfig } from '../types/WidgetConfig.type';
+import withTargetXcodeProject from './xcode/withTargetXcodeProject';
+
+type IosWidgetsProps = {
+  bundleIdentifier?: string;
+  groupIdentifier?: string;
+  enablePushNotifications?: boolean;
+  frequentUpdates?: boolean;
+  widgets: WidgetConfig[];
+};
+
+const withIosWidgets: ConfigPlugin<IosWidgetsProps> = (config, props) => {
+  const shouldConfigureIos =
+    !!config.ios?.bundleIdentifier ||
+    !!props.bundleIdentifier ||
+    !!props.groupIdentifier ||
+    props.enablePushNotifications === true ||
+    props.frequentUpdates === true;
+
+  if (!shouldConfigureIos) {
+    return config;
+  }
+
+  let plugins: (StaticPlugin | ConfigPlugin | string)[] = [];
+  const deploymentTarget = config.ios?.deploymentTarget ?? '16.4';
+  const targetName = 'ExpoWidgetsTarget';
+  const widgets = props.widgets.filter((widget) => widget.ios !== null);
+
+  const enablePushNotifications = props.enablePushNotifications ?? false;
+  const frequentUpdates = props.frequentUpdates ?? false;
+
+  let bundleIdentifier = props.bundleIdentifier;
+  if (!bundleIdentifier) {
+    bundleIdentifier = `${config.ios?.bundleIdentifier}.${targetName}`;
+    plugins.push([
+      withIosWarning,
+      {
+        property: 'bundleIdentifier',
+        warning: `Expo Widgets: No bundle identifier provided, using fallback: ${bundleIdentifier}.`,
+      },
+    ]);
+  }
+
+  let groupIdentifier = props.groupIdentifier;
+  if (!groupIdentifier) {
+    if (!config.ios?.bundleIdentifier) {
+      throw new Error(
+        'iOS bundle identifier is required. Please set `ios.bundleIdentifier` in `app.json` or `app.config.js`'
+      );
+    }
+    groupIdentifier = `group.${config.ios.bundleIdentifier}`;
+    plugins.push([
+      withIosWarning,
+      {
+        property: 'groupIdentifier',
+        warning: `Expo Widgets: No group identifier provided, using fallback: ${groupIdentifier}.`,
+      },
+    ]);
+  }
+
+  let sharedFiles: string[] = [];
+  const setFiles = (files: string[]) => {
+    sharedFiles = [...sharedFiles, ...files];
+  };
+  const getFileUris = () => sharedFiles;
+
+  plugins = [
+    ...plugins,
+    [withEasConfig, { targetName, bundleIdentifier, groupIdentifier }],
+    [withPodsLinking, { targetName }],
+    [withWidgetSourceFiles, { targetName, widgets, groupIdentifier, onFilesGenerated: setFiles }],
+    [withAppInfoPlist, { frequentUpdates, groupIdentifier }],
+    [withPushNotifications, { enablePushNotifications }],
+    [withAppGroupEntitlements, { groupIdentifier }],
+    [
+      withTargetXcodeProject,
+      {
+        targetName,
+        bundleIdentifier,
+        deploymentTarget,
+        appleTeamId: config.ios?.appleTeamId,
+        getFileUris,
+      },
+    ],
+  ];
+
+  return withPlugins(config, plugins);
+};
+
+export default withIosWidgets;

package/plugin/src/{withWidgetSourceFiles.ts → ios/withWidgetSourceFiles.ts}

@@ -3,8 +3,8 @@ import { ConfigPlugin, withDangerousMod } from 'expo/config-plugins';
 import * as fs from 'fs';
 import * as path from 'path';
 
-import { WidgetConfig } from './types/WidgetConfig.type';
-import { WidgetFamily } from './types/WidgetFamily.type';
+import { WidgetConfig } from '../types/WidgetConfig.type';
+import { WidgetFamily } from '../types/WidgetFamily.type';
 
 type WidgetSourceFilesProps = {
   targetName: string;
@@ -31,11 +31,13 @@ function assertWidgetFamily(value: unknown): asserts value is WidgetFamily {
 
 function validateWidget(widget: WidgetConfig): void {
   assertSwiftIdentifier(widget.name, 'widget name');
-  for (const family of widget.supportedFamilies) {
+  const supportedFamilies = widget.ios?.supportedFamilies ?? widget.supportedFamilies ?? [];
+  for (const family of supportedFamilies) {
     assertWidgetFamily(family);
   }
-  if (widget.configuration) {
-    for (const [paramName, param] of Object.entries(widget.configuration.parameters)) {
+  const configuration = widget.ios?.configuration ?? widget.configuration;
+  if (configuration) {
+    for (const [paramName, param] of Object.entries(configuration.parameters)) {
       assertSwiftIdentifier(paramName, 'parameter name');
       if (param.type === 'number' && typeof param.default !== 'number') {
         throw new Error(`Invalid default for ${JSON.stringify(paramName)}: must be a number.`);
@@ -161,7 +163,7 @@ struct ExportWidgets${index}: WidgetBundle {
   var body: some Widget {
     ${widgets
       .map((widget) => {
-        if (widget.configuration) {
+        if (widget.ios?.configuration ?? widget.configuration) {
           return `if #available(iOS 17.0, *) {
       ${widget.name}()
     }`;
@@ -174,7 +176,11 @@ struct ExportWidgets${index}: WidgetBundle {
 }`;
 
 const widgetSwift = (widget: WidgetConfig): string => {
-  if (!widget.configuration)
+  const configuration = widget.ios?.configuration ?? widget.configuration;
+  const supportedFamilies = widget.ios?.supportedFamilies ?? widget.supportedFamilies ?? [];
+  const contentMarginsDisabled =
+    widget.ios?.contentMarginsDisabled ?? widget.contentMarginsDisabled;
+  if (!configuration)
     return `import WidgetKit
 import SwiftUI
 internal import ExpoWidgets
@@ -188,7 +194,7 @@ struct ${widget.name}: Widget {
     }
     .configurationDisplayName(${JSON.stringify(widget.displayName)})
     .description(${JSON.stringify(widget.description)})
-    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
+    .supportedFamilies([.${supportedFamilies.join(', .')}])${contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
   return `import WidgetKit
@@ -198,9 +204,9 @@ internal import ExpoWidgets
 
 // AppIntent
 struct ${widget.name}ConfigurationAppIntent: WidgetConfigurationIntent {
-  static var title: LocalizedStringResource = ${JSON.stringify(`${widget.configuration?.title ?? widget.displayName} Configuration`)}
-${widget.configuration?.description ? `  static var description: LocalizedStringResource = ${JSON.stringify(widget.configuration.description)}\n` : ''}
-${Object.entries(widget.configuration?.parameters ?? {})
+  static var title: LocalizedStringResource = ${JSON.stringify(`${configuration?.title ?? widget.displayName} Configuration`)}
+${configuration?.description ? `  static var description: LocalizedStringResource = ${JSON.stringify(configuration.description)}\n` : ''}
+${Object.entries(configuration?.parameters ?? {})
   .map(([name, param]) => {
     let paramType: string;
     switch (param.type) {
@@ -227,7 +233,7 @@ ${Object.entries(widget.configuration?.parameters ?? {})
     return .result()
   }
 }
-${Object.entries(widget.configuration?.parameters ?? {})
+${Object.entries(configuration?.parameters ?? {})
   .map(([name, param]) => {
     if (param.type !== 'enum') return '';
     const paramTypeName = `${widget.name}${name[0]?.toUpperCase() + name.slice(1)}Enum`;
@@ -307,7 +313,7 @@ struct ${widget.name}EntryView: View {
     var env: [String: Any] = getWidgetEnvironment(environment: environment)
     env["timestamp"] = Int(entry.date.timeIntervalSince1970 * 1000)
     env["configuration"] = [
-${Object.entries(widget.configuration?.parameters ?? {})
+${Object.entries(configuration?.parameters ?? {})
   .map(([name, param]) => {
     return `      "${name}": entry.configuration.${name}${param.type === 'enum' ? '.rawValue' : ''}`;
   })
@@ -346,7 +352,7 @@ struct ${widget.name}: Widget {
     }
     .configurationDisplayName(${JSON.stringify(widget.displayName)})
     .description(${JSON.stringify(widget.description)})
-    .supportedFamilies([.${widget.supportedFamilies.join(', .')}])${widget.contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
+    .supportedFamilies([.${supportedFamilies.join(', .')}])${contentMarginsDisabled ? '\n    .contentMarginsDisabled()' : ''}
   }
 }`;
 };

package/plugin/src/types/WidgetConfig.type.ts

@@ -2,15 +2,34 @@ import { WidgetFamily } from './WidgetFamily.type';
 
 export type WidgetConfig = {
   name: string;
-  supportedFamilies: WidgetFamily[];
   displayName: string;
   description: string;
+  // @deprecated: use `ios.supportedFamilies` instead.
+  supportedFamilies: WidgetFamily[];
+  // @deprecated: use `ios.contentMarginsDisabled` instead.
   contentMarginsDisabled: boolean;
+  // @deprecated: use `ios.configuration` instead.
   configuration?: {
     title: string;
     description?: string;
     parameters: Record<string, WidgetParameter>;
   };
+  ios?: {
+    supportedFamilies: WidgetFamily[];
+    contentMarginsDisabled?: boolean;
+    configuration?: {
+      title: string;
+      description?: string;
+      parameters: Record<string, WidgetParameter>;
+    };
+  } | null;
+  android?: {
+    minWidth?: number;
+    minHeight?: number;
+    targetCellWidth?: number;
+    targetCellHeight?: number;
+    resizeMode?: 'none' | 'horizontal' | 'vertical' | 'both';
+  } | null;
 };
 
 export type WidgetParameterString = {

package/plugin/src/types/WidgetFamily.type.ts

@@ -1,9 +1,11 @@
-export enum WidgetFamily {
-  systemSmall = 'systemSmall',
-  systemMedium = 'systemMedium',
-  systemLarge = 'systemLarge',
-  systemExtraLarge = 'systemExtraLarge',
-  accessoryCircular = 'accessoryCircular',
-  accessoryRectangular = 'accessoryRectangular',
-  accessoryInline = 'accessoryInline',
-}
+export const WidgetFamily = {
+  systemSmall: 'systemSmall',
+  systemMedium: 'systemMedium',
+  systemLarge: 'systemLarge',
+  systemExtraLarge: 'systemExtraLarge',
+  accessoryCircular: 'accessoryCircular',
+  accessoryRectangular: 'accessoryRectangular',
+  accessoryInline: 'accessoryInline',
+} as const;
+
+export type WidgetFamily = (typeof WidgetFamily)[keyof typeof WidgetFamily];