nn-widgets 0.1.0

package/build/NNWidgets.types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Widget data that can be shared between app and widget (legacy flat format)
+ */
+export interface WidgetData {
+    [key: string]: string | number | boolean | null;
+}
+/**
+ * Configuration for updating widget
+ */
+export interface WidgetUpdateConfig {
+    /**
+     * Widget kind identifier (iOS) or widget class name (Android)
+     */
+    widgetName?: string;
+}
+/**
+ * System font size keys (maps to SwiftUI Font / Android sp).
+ */
+export type WidgetFontSize = "caption2" | "caption" | "footnote" | "subheadline" | "body" | "headline" | "title3" | "title2" | "title";
+/**
+ * Font weight keys.
+ */
+export type WidgetFontWeight = "regular" | "medium" | "semibold" | "bold";
+/**
+ * Icon configuration for a widget item.
+ * - string: SF Symbol name (iOS) or drawable resource name (Android)
+ * - object: icon with extra styling
+ */
+export type WidgetItemIcon = string | {
+    /** Icon name: SF Symbol (iOS), drawable name (Android), or bundled icon name */
+    url: string;
+    /** Icon size in points/dp @default 32 */
+    size?: number;
+    /** Border radius (0 = square, size/2 = circle) @default 0 */
+    radius?: number;
+    /** Background color behind the icon (hex) */
+    backgroundColor?: string;
+};
+/**
+ * Text configuration for a widget item.
+ * - string: plain text
+ * - object: text with custom styling
+ */
+export type WidgetItemText = string | {
+    /** The text content */
+    text: string;
+    /** Text color (hex). Falls back to widget-level style. */
+    color?: string;
+    /** Font size key */
+    fontSize?: WidgetFontSize;
+    /** Font weight */
+    fontWeight?: WidgetFontWeight;
+};
+/**
+ * A single item in a list-type widget.
+ */
+export interface WidgetListItem {
+    /** Left icon (SF Symbol name, bundled icon, or object with styling) */
+    icon?: WidgetItemIcon;
+    /** Right icon (SF Symbol name, bundled icon, or object with styling) */
+    rightIcon?: WidgetItemIcon;
+    /** Title text (string or styled object) */
+    title: WidgetItemText;
+    /** Description text (string or styled object) */
+    description?: WidgetItemText;
+    /** Per-item deep link URL */
+    deepLink?: string;
+}
+/**
+ * Structured data payload for `updateWidget()`.
+ */
+export interface WidgetDataPayload {
+    /** Title text (for single/list fallback) */
+    title?: string;
+    /** Subtitle text (for single/list fallback) */
+    subtitle?: string;
+    /** Numeric value (for single-type widgets) */
+    value?: number;
+    /** List items (for list-type widgets) */
+    items?: WidgetListItem[];
+}
+/**
+ * Widget module interface
+ */
+export interface NNWidgetsModuleType {
+    /**
+     * Set shared data that widgets can read (legacy flat key-value format).
+     * Keys are stored with `widget_` prefix in UserDefaults/SharedPreferences.
+     */
+    setWidgetData(data: WidgetData): Promise<boolean>;
+    /**
+     * Get current shared widget data (legacy format)
+     */
+    getWidgetData(): Promise<WidgetData>;
+    /**
+     * Update a specific widget with structured data.
+     * Automatically serializes items to JSON and reloads the widget timeline.
+     *
+     * @param widgetName - The widget kind identifier (matches `name` in app.json config)
+     * @param data - Structured widget data payload
+     * @returns Promise<boolean> - Success status
+     */
+    updateWidget(widgetName: string, data: WidgetDataPayload): Promise<boolean>;
+    /**
+     * Request widget to reload/update its timeline (iOS) or update (Android)
+     */
+    reloadWidget(config?: WidgetUpdateConfig): Promise<boolean>;
+    /**
+     * Check if widgets are supported on this device
+     */
+    isSupported(): boolean;
+}
+//# sourceMappingURL=NNWidgets.types.d.ts.map

package/build/NNWidgets.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NNWidgets.types.d.ts","sourceRoot":"","sources":["../src/NNWidgets.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,SAAS,GACT,UAAU,GACV,aAAa,GACb,MAAM,GACN,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN;IACE,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN;IACE,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,kBAAkB;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,wEAAwE;IACxE,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,2CAA2C;IAC3C,KAAK,EAAE,cAAc,CAAC;IACtB,iDAAiD;IACjD,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAErC;;;;;;;OAOG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5E;;OAEG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5D;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;CACxB"}

package/build/NNWidgets.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NNWidgets.types.js.map

package/build/NNWidgets.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NNWidgets.types.js","sourceRoot":"","sources":["../src/NNWidgets.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Widget data that can be shared between app and widget (legacy flat format)\n */\nexport interface WidgetData {\n  [key: string]: string | number | boolean | null;\n}\n\n/**\n * Configuration for updating widget\n */\nexport interface WidgetUpdateConfig {\n  /**\n   * Widget kind identifier (iOS) or widget class name (Android)\n   */\n  widgetName?: string;\n}\n\n// ──────────────────────────────────────────────\n//  Rich widget data types (for list/single widgets)\n// ──────────────────────────────────────────────\n\n/**\n * System font size keys (maps to SwiftUI Font / Android sp).\n */\nexport type WidgetFontSize =\n  | \"caption2\"\n  | \"caption\"\n  | \"footnote\"\n  | \"subheadline\"\n  | \"body\"\n  | \"headline\"\n  | \"title3\"\n  | \"title2\"\n  | \"title\";\n\n/**\n * Font weight keys.\n */\nexport type WidgetFontWeight = \"regular\" | \"medium\" | \"semibold\" | \"bold\";\n\n/**\n * Icon configuration for a widget item.\n * - string: SF Symbol name (iOS) or drawable resource name (Android)\n * - object: icon with extra styling\n */\nexport type WidgetItemIcon =\n  | string\n  | {\n      /** Icon name: SF Symbol (iOS), drawable name (Android), or bundled icon name */\n      url: string;\n      /** Icon size in points/dp @default 32 */\n      size?: number;\n      /** Border radius (0 = square, size/2 = circle) @default 0 */\n      radius?: number;\n      /** Background color behind the icon (hex) */\n      backgroundColor?: string;\n    };\n\n/**\n * Text configuration for a widget item.\n * - string: plain text\n * - object: text with custom styling\n */\nexport type WidgetItemText =\n  | string\n  | {\n      /** The text content */\n      text: string;\n      /** Text color (hex). Falls back to widget-level style. */\n      color?: string;\n      /** Font size key */\n      fontSize?: WidgetFontSize;\n      /** Font weight */\n      fontWeight?: WidgetFontWeight;\n    };\n\n/**\n * A single item in a list-type widget.\n */\nexport interface WidgetListItem {\n  /** Left icon (SF Symbol name, bundled icon, or object with styling) */\n  icon?: WidgetItemIcon;\n  /** Right icon (SF Symbol name, bundled icon, or object with styling) */\n  rightIcon?: WidgetItemIcon;\n  /** Title text (string or styled object) */\n  title: WidgetItemText;\n  /** Description text (string or styled object) */\n  description?: WidgetItemText;\n  /** Per-item deep link URL */\n  deepLink?: string;\n}\n\n/**\n * Structured data payload for `updateWidget()`.\n */\nexport interface WidgetDataPayload {\n  /** Title text (for single/list fallback) */\n  title?: string;\n  /** Subtitle text (for single/list fallback) */\n  subtitle?: string;\n  /** Numeric value (for single-type widgets) */\n  value?: number;\n  /** List items (for list-type widgets) */\n  items?: WidgetListItem[];\n}\n\n/**\n * Widget module interface\n */\nexport interface NNWidgetsModuleType {\n  /**\n   * Set shared data that widgets can read (legacy flat key-value format).\n   * Keys are stored with `widget_` prefix in UserDefaults/SharedPreferences.\n   */\n  setWidgetData(data: WidgetData): Promise<boolean>;\n\n  /**\n   * Get current shared widget data (legacy format)\n   */\n  getWidgetData(): Promise<WidgetData>;\n\n  /**\n   * Update a specific widget with structured data.\n   * Automatically serializes items to JSON and reloads the widget timeline.\n   *\n   * @param widgetName - The widget kind identifier (matches `name` in app.json config)\n   * @param data - Structured widget data payload\n   * @returns Promise<boolean> - Success status\n   */\n  updateWidget(widgetName: string, data: WidgetDataPayload): Promise<boolean>;\n\n  /**\n   * Request widget to reload/update its timeline (iOS) or update (Android)\n   */\n  reloadWidget(config?: WidgetUpdateConfig): Promise<boolean>;\n\n  /**\n   * Check if widgets are supported on this device\n   */\n  isSupported(): boolean;\n}\n"]}

package/build/NNWidgetsModule.d.ts

@@ -0,0 +1,3 @@
+declare const _default: any;
+export default _default;
+//# sourceMappingURL=NNWidgetsModule.d.ts.map

package/build/NNWidgetsModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NNWidgetsModule.d.ts","sourceRoot":"","sources":["../src/NNWidgetsModule.ts"],"names":[],"mappings":";AACA,wBAAgD"}

package/build/NNWidgetsModule.js

@@ -0,0 +1,3 @@
+import { requireNativeModule } from "expo-modules-core";
+export default requireNativeModule("NNWidgets");
+//# sourceMappingURL=NNWidgetsModule.js.map

package/build/NNWidgetsModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NNWidgetsModule.js","sourceRoot":"","sources":["../src/NNWidgetsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,eAAe,mBAAmB,CAAC,WAAW,CAAC,CAAC","sourcesContent":["import { requireNativeModule } from \"expo-modules-core\";\nexport default requireNativeModule(\"NNWidgets\");\n"]}

package/build/index.d.ts

@@ -0,0 +1,11 @@
+import type { WidgetData, WidgetDataPayload, WidgetListItem, WidgetItemIcon, WidgetItemText, WidgetUpdateConfig, NNWidgetsModuleType } from "./NNWidgets.types";
+export type { WidgetData, WidgetDataPayload, WidgetListItem, WidgetItemIcon, WidgetItemText, WidgetUpdateConfig, NNWidgetsModuleType, };
+/**
+ * NNWidgets - Native widget integration for React Native / Expo
+ *
+ * This module provides APIs to communicate between your React Native app
+ * and native widgets (iOS WidgetKit & Android App Widgets).
+ */
+export declare const NNWidgets: NNWidgetsModuleType;
+export default NNWidgets;
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,mBAAmB,GACpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,mBAqJvB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/build/index.js

@@ -0,0 +1,152 @@
+import NNWidgetsModule from "./NNWidgetsModule";
+/**
+ * NNWidgets - Native widget integration for React Native / Expo
+ *
+ * This module provides APIs to communicate between your React Native app
+ * and native widgets (iOS WidgetKit & Android App Widgets).
+ */
+export const NNWidgets = {
+    /**
+     * Set shared data that widgets can read (legacy flat key-value format).
+     * Data is stored in App Groups (iOS) or SharedPreferences (Android).
+     *
+     * @param data - Key-value pairs to share with widget
+     * @returns Promise<boolean> - Success status
+     *
+     * @example
+     * ```ts
+     * await NNWidgets.setWidgetData({
+     *   userName: 'John',
+     *   points: 100,
+     *   isLoggedIn: true
+     * });
+     * ```
+     */
+    async setWidgetData(data) {
+        try {
+            return await NNWidgetsModule.setWidgetData(data);
+        }
+        catch (error) {
+            console.error("[NNWidgets] Failed to set widget data:", error);
+            return false;
+        }
+    },
+    /**
+     * Get current shared widget data.
+     *
+     * @returns Promise<WidgetData> - Current shared data
+     */
+    async getWidgetData() {
+        try {
+            return await NNWidgetsModule.getWidgetData();
+        }
+        catch (error) {
+            console.error("[NNWidgets] Failed to get widget data:", error);
+            return {};
+        }
+    },
+    /**
+     * Update a specific widget with structured data.
+     * Automatically serializes items to JSON, stores data with proper key prefixes,
+     * and reloads the widget timeline.
+     *
+     * @param widgetName - The widget kind identifier (matches `name` in app.json widgets config)
+     * @param data - Structured widget data payload
+     * @returns Promise<boolean> - Success status
+     *
+     * @example
+     * ```ts
+     * // Update a list-type widget
+     * await NNWidgets.updateWidget('SessionsWidget', {
+     *   items: [
+     *     {
+     *       icon: 'brainstorm',
+     *       title: { text: 'Morning Focus', color: '#1E1E2E', fontWeight: 'bold' },
+     *       description: '25 min session',
+     *       deepLink: 'myapp://session/123',
+     *     },
+     *     {
+     *       icon: { url: 'meditation', size: 28, radius: 14 },
+     *       title: 'Evening Wind Down',
+     *       description: { text: '15 min', color: '#888888' },
+     *     },
+     *   ],
+     * });
+     *
+     * // Update a single-type widget
+     * await NNWidgets.updateWidget('StatsWidget', {
+     *   title: 'Focus Time',
+     *   subtitle: 'This week',
+     *   value: 142,
+     * });
+     * ```
+     */
+    async updateWidget(widgetName, data) {
+        try {
+            const flatData = {};
+            if (data.title !== undefined) {
+                flatData[`${widgetName}_title`] = data.title;
+            }
+            if (data.subtitle !== undefined) {
+                flatData[`${widgetName}_subtitle`] = data.subtitle;
+            }
+            if (data.value !== undefined) {
+                flatData[`${widgetName}_value`] = data.value;
+            }
+            if (data.items !== undefined) {
+                // Serialize items array to JSON string for native storage
+                flatData[`${widgetName}_items`] = JSON.stringify(data.items);
+            }
+            const success = await NNWidgetsModule.setWidgetData(flatData);
+            if (success) {
+                await NNWidgetsModule.reloadWidget(widgetName);
+            }
+            return success;
+        }
+        catch (error) {
+            console.error(`[NNWidgets] Failed to update widget "${widgetName}":`, error);
+            return false;
+        }
+    },
+    /**
+     * Request widget to reload/update.
+     * - iOS: Reloads widget timeline
+     * - Android: Triggers widget update broadcast
+     *
+     * @param config - Optional configuration
+     * @returns Promise<boolean> - Success status
+     *
+     * @example
+     * ```ts
+     * // Update all widgets
+     * await NNWidgets.reloadWidget();
+     *
+     * // Update specific widget
+     * await NNWidgets.reloadWidget({ widgetName: 'MyWidget' });
+     * ```
+     */
+    async reloadWidget(config) {
+        try {
+            return await NNWidgetsModule.reloadWidget(config?.widgetName || null);
+        }
+        catch (error) {
+            console.error("[NNWidgets] Failed to reload widget:", error);
+            return false;
+        }
+    },
+    /**
+     * Check if widgets are supported on this device.
+     *
+     * @returns boolean - True if widgets are supported
+     */
+    isSupported() {
+        try {
+            return NNWidgetsModule.isSupported();
+        }
+        catch (error) {
+            return false;
+        }
+    },
+};
+export default NNWidgets;
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAqBhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAwB;IAC5C;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,aAAa,CAAC,IAAgB;QAClC,IAAI,CAAC;YACH,OAAO,MAAM,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,OAAO,MAAM,eAAe,CAAC,aAAa,EAAE,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;YAC/D,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,IAAuB;QAEvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAe,EAAE,CAAC;YAEhC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,QAAQ,CAAC,GAAG,UAAU,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YAC/C,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChC,QAAQ,CAAC,GAAG,UAAU,WAAW,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YACrD,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,QAAQ,CAAC,GAAG,UAAU,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YAC/C,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,0DAA0D;gBAC1D,QAAQ,CAAC,GAAG,UAAU,QAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/D,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC9D,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,eAAe,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,wCAAwC,UAAU,IAAI,EACtD,KAAK,CACN,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,YAAY,CAAC,MAA2B;QAC5C,IAAI,CAAC;YACH,OAAO,MAAM,eAAe,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;YAC7D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,IAAI,CAAC;YACH,OAAO,eAAe,CAAC,WAAW,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,SAAS,CAAC","sourcesContent":["import NNWidgetsModule from \"./NNWidgetsModule\";\nimport type {\n  WidgetData,\n  WidgetDataPayload,\n  WidgetListItem,\n  WidgetItemIcon,\n  WidgetItemText,\n  WidgetUpdateConfig,\n  NNWidgetsModuleType,\n} from \"./NNWidgets.types\";\n\nexport type {\n  WidgetData,\n  WidgetDataPayload,\n  WidgetListItem,\n  WidgetItemIcon,\n  WidgetItemText,\n  WidgetUpdateConfig,\n  NNWidgetsModuleType,\n};\n\n/**\n * NNWidgets - Native widget integration for React Native / Expo\n *\n * This module provides APIs to communicate between your React Native app\n * and native widgets (iOS WidgetKit & Android App Widgets).\n */\nexport const NNWidgets: NNWidgetsModuleType = {\n  /**\n   * Set shared data that widgets can read (legacy flat key-value format).\n   * Data is stored in App Groups (iOS) or SharedPreferences (Android).\n   *\n   * @param data - Key-value pairs to share with widget\n   * @returns Promise<boolean> - Success status\n   *\n   * @example\n   * ```ts\n   * await NNWidgets.setWidgetData({\n   *   userName: 'John',\n   *   points: 100,\n   *   isLoggedIn: true\n   * });\n   * ```\n   */\n  async setWidgetData(data: WidgetData): Promise<boolean> {\n    try {\n      return await NNWidgetsModule.setWidgetData(data);\n    } catch (error) {\n      console.error(\"[NNWidgets] Failed to set widget data:\", error);\n      return false;\n    }\n  },\n\n  /**\n   * Get current shared widget data.\n   *\n   * @returns Promise<WidgetData> - Current shared data\n   */\n  async getWidgetData(): Promise<WidgetData> {\n    try {\n      return await NNWidgetsModule.getWidgetData();\n    } catch (error) {\n      console.error(\"[NNWidgets] Failed to get widget data:\", error);\n      return {};\n    }\n  },\n\n  /**\n   * Update a specific widget with structured data.\n   * Automatically serializes items to JSON, stores data with proper key prefixes,\n   * and reloads the widget timeline.\n   *\n   * @param widgetName - The widget kind identifier (matches `name` in app.json widgets config)\n   * @param data - Structured widget data payload\n   * @returns Promise<boolean> - Success status\n   *\n   * @example\n   * ```ts\n   * // Update a list-type widget\n   * await NNWidgets.updateWidget('SessionsWidget', {\n   *   items: [\n   *     {\n   *       icon: 'brainstorm',\n   *       title: { text: 'Morning Focus', color: '#1E1E2E', fontWeight: 'bold' },\n   *       description: '25 min session',\n   *       deepLink: 'myapp://session/123',\n   *     },\n   *     {\n   *       icon: { url: 'meditation', size: 28, radius: 14 },\n   *       title: 'Evening Wind Down',\n   *       description: { text: '15 min', color: '#888888' },\n   *     },\n   *   ],\n   * });\n   *\n   * // Update a single-type widget\n   * await NNWidgets.updateWidget('StatsWidget', {\n   *   title: 'Focus Time',\n   *   subtitle: 'This week',\n   *   value: 142,\n   * });\n   * ```\n   */\n  async updateWidget(\n    widgetName: string,\n    data: WidgetDataPayload,\n  ): Promise<boolean> {\n    try {\n      const flatData: WidgetData = {};\n\n      if (data.title !== undefined) {\n        flatData[`${widgetName}_title`] = data.title;\n      }\n      if (data.subtitle !== undefined) {\n        flatData[`${widgetName}_subtitle`] = data.subtitle;\n      }\n      if (data.value !== undefined) {\n        flatData[`${widgetName}_value`] = data.value;\n      }\n      if (data.items !== undefined) {\n        // Serialize items array to JSON string for native storage\n        flatData[`${widgetName}_items`] = JSON.stringify(data.items);\n      }\n\n      const success = await NNWidgetsModule.setWidgetData(flatData);\n      if (success) {\n        await NNWidgetsModule.reloadWidget(widgetName);\n      }\n      return success;\n    } catch (error) {\n      console.error(\n        `[NNWidgets] Failed to update widget \"${widgetName}\":`,\n        error,\n      );\n      return false;\n    }\n  },\n\n  /**\n   * Request widget to reload/update.\n   * - iOS: Reloads widget timeline\n   * - Android: Triggers widget update broadcast\n   *\n   * @param config - Optional configuration\n   * @returns Promise<boolean> - Success status\n   *\n   * @example\n   * ```ts\n   * // Update all widgets\n   * await NNWidgets.reloadWidget();\n   *\n   * // Update specific widget\n   * await NNWidgets.reloadWidget({ widgetName: 'MyWidget' });\n   * ```\n   */\n  async reloadWidget(config?: WidgetUpdateConfig): Promise<boolean> {\n    try {\n      return await NNWidgetsModule.reloadWidget(config?.widgetName || null);\n    } catch (error) {\n      console.error(\"[NNWidgets] Failed to reload widget:\", error);\n      return false;\n    }\n  },\n\n  /**\n   * Check if widgets are supported on this device.\n   *\n   * @returns boolean - True if widgets are supported\n   */\n  isSupported(): boolean {\n    try {\n      return NNWidgetsModule.isSupported();\n    } catch (error) {\n      return false;\n    }\n  },\n};\n\nexport default NNWidgets;\n"]}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["ios", "android"],
+  "ios": {
+    "modules": ["NNWidgetsModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.nnwidgets.NNWidgetsModule"]
+  }
+}

package/ios/NNWidgets.podspec

@@ -0,0 +1,27 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'NNWidgets'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platforms      = { :ios => '15.1' }
+  s.swift_version  = '5.9'
+  s.source         = { git: 'https://github.com/NamReplIT/expo-utils' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+    'SWIFT_COMPILATION_MODE' => 'wholemodule'
+  }
+
+  s.source_files = "**/*.{h,m,swift}"
+end

package/ios/NNWidgetsModule.swift

@@ -0,0 +1,97 @@
+import ExpoModulesCore
+import WidgetKit
+
+public class NNWidgetsModule: Module {
+    
+    // App Group identifier - will be set via plugin config
+    private var appGroupIdentifier: String {
+        // Try to get from Info.plist or use default pattern
+        if let identifier = Bundle.main.object(forInfoDictionaryKey: "NNWidgetsAppGroup") as? String {
+            return identifier
+        }
+        // Fallback: derive from bundle identifier
+        if let bundleId = Bundle.main.bundleIdentifier {
+            return "group.\(bundleId)"
+        }
+        return "group.app.widget"
+    }
+    
+    private var userDefaults: UserDefaults? {
+        return UserDefaults(suiteName: appGroupIdentifier)
+    }
+    
+    public func definition() -> ModuleDefinition {
+        Name("NNWidgets")
+        
+        // Check if widgets are supported (iOS 14+)
+        Function("isSupported") { () -> Bool in
+            if #available(iOS 14.0, *) {
+                return true
+            }
+            return false
+        }
+        
+        // Set widget data to shared UserDefaults
+        AsyncFunction("setWidgetData") { (data: [String: Any]) -> Bool in
+            guard let defaults = self.userDefaults else {
+                print("[NNWidgets] Failed to access App Group UserDefaults")
+                return false
+            }
+            
+            // Store each key-value pair
+            for (key, value) in data {
+                defaults.set(value, forKey: "widget_\(key)")
+            }
+            
+            // Store keys list for retrieval
+            let keys = data.keys.map { "widget_\($0)" }
+            defaults.set(keys, forKey: "widget_data_keys")
+            
+            defaults.synchronize()
+            print("[NNWidgets] Widget data saved: \(data.keys.joined(separator: ", "))")
+            return true
+        }
+        
+        // Get widget data from shared UserDefaults
+        AsyncFunction("getWidgetData") { () -> [String: Any] in
+            guard let defaults = self.userDefaults else {
+                print("[NNWidgets] Failed to access App Group UserDefaults")
+                return [:]
+            }
+            
+            guard let keys = defaults.array(forKey: "widget_data_keys") as? [String] else {
+                return [:]
+            }
+            
+            var result: [String: Any] = [:]
+            for key in keys {
+                if let value = defaults.object(forKey: key) {
+                    // Remove "widget_" prefix from key
+                    let cleanKey = String(key.dropFirst(7))
+                    result[cleanKey] = value
+                }
+            }
+            
+            return result
+        }
+        
+        // Reload widget timeline
+        AsyncFunction("reloadWidget") { (widgetKind: String?) -> Bool in
+            if #available(iOS 14.0, *) {
+                DispatchQueue.main.async {
+                    if let kind = widgetKind {
+                        // Reload specific widget
+                        WidgetCenter.shared.reloadTimelines(ofKind: kind)
+                        print("[NNWidgets] Reloaded widget: \(kind)")
+                    } else {
+                        // Reload all widgets
+                        WidgetCenter.shared.reloadAllTimelines()
+                        print("[NNWidgets] Reloaded all widgets")
+                    }
+                }
+                return true
+            }
+            return false
+        }
+    }
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "nn-widgets",
+  "version": "0.1.0",
+  "description": "Expo config plugin for adding native widgets (iOS WidgetKit & Android App Widgets)",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "expo-module build && npm run build:plugin",
+    "build:plugin": "npx tsc -p plugin/tsconfig.json",
+    "clean": "expo-module clean && rm -rf plugin/build",
+    "lint": "expo-module lint",
+    "test": "expo-module test",
+    "prepare": "expo-module prepare",
+    "prepublishOnly": "expo-module prepublishOnly",
+    "expo-module": "expo-module"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "expo-plugin",
+    "widget",
+    "ios-widget",
+    "android-widget",
+    "widgetkit",
+    "app-widget"
+  ],
+  "repository": "https://github.com/NamReplIT/expo-utils",
+  "bugs": {
+    "url": "https://github.com/NamReplIT/expo-utils/issues"
+  },
+  "author": "NamReplIT <89992703+NamReplIT@users.noreply.github.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/NamReplIT/expo-utils#readme",
+  "dependencies": {},
+  "devDependencies": {
+    "@expo/config-plugins": "^9.0.0",
+    "@types/node": "^20.0.0",
+    "expo-module-scripts": "^4.0.5",
+    "expo-modules-core": "^2.5.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@types/react": "*",
+    "@types/react-native": "*",
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  }
+}

package/plugin/build/index.d.ts

@@ -0,0 +1,9 @@
+import { ConfigPlugin } from "@expo/config-plugins";
+import { withIosWidget } from "./withIosWidget";
+import { withAndroidWidget } from "./withAndroidWidget";
+import type { NNWidgetsPluginProps, WidgetConfig, ResolvedPluginProps, ResolvedWidgetConfig } from "./types";
+export type { NNWidgetsPluginProps, WidgetConfig, ResolvedPluginProps, ResolvedWidgetConfig, };
+export { withIosWidget, withAndroidWidget };
+declare const _default: ConfigPlugin<void | NNWidgetsPluginProps>;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/plugin/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,CAAC;AACF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;;AAyE5C,wBAAyE"}

package/plugin/build/index.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withAndroidWidget = exports.withIosWidget = void 0;
+const config_plugins_1 = require("@expo/config-plugins");
+const withIosWidget_1 = require("./withIosWidget");
+Object.defineProperty(exports, "withIosWidget", { enumerable: true, get: function () { return withIosWidget_1.withIosWidget; } });
+const withAndroidWidget_1 = require("./withAndroidWidget");
+Object.defineProperty(exports, "withAndroidWidget", { enumerable: true, get: function () { return withAndroidWidget_1.withAndroidWidget; } });
+/**
+ * nn-widgets Expo Config Plugin
+ *
+ * Adds native widget support for iOS (WidgetKit) and Android (App Widgets)
+ * to your Expo/React Native app.
+ *
+ * Supports multiple independent widgets per app.
+ *
+ * @example
+ * ```js
+ * // app.json or app.config.js
+ * {
+ *   "expo": {
+ *     "plugins": [
+ *       ["nn-widgets", {
+ *         "widgets": [
+ *           {
+ *             "name": "MainWidget",
+ *             "displayName": "My App",
+ *             "description": "Quick access",
+ *             "deepLinkUrl": "myapp://widget/home",
+ *             "widgetFamilies": ["systemSmall", "systemMedium"]
+ *           },
+ *           {
+ *             "name": "StatsWidget",
+ *             "displayName": "Stats",
+ *             "description": "View your stats",
+ *             "deepLinkUrl": "myapp://widget/stats",
+ *             "widgetFamilies": ["systemSmall"]
+ *           }
+ *         ],
+ *         "ios": {
+ *           "deploymentTarget": "17.0",
+ *           "devTeam": "YOUR_TEAM_ID"
+ *         },
+ *         "android": {
+ *           "minWidth": 110,
+ *           "minHeight": 40
+ *         }
+ *       }]
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+const withNNWidgets = (config, props = {}) => {
+    const pluginProps = props || {};
+    const widgetCount = pluginProps.widgets?.length || 1;
+    console.log(`[nn-widgets] Configuring ${widgetCount} native widget(s)...`);
+    // Apply iOS widget configuration
+    config = (0, withIosWidget_1.withIosWidget)(config, pluginProps);
+    // Apply Android widget configuration
+    config = (0, withAndroidWidget_1.withAndroidWidget)(config, pluginProps);
+    console.log("[nn-widgets] Widget configuration complete!");
+    return config;
+};
+// Package info for createRunOncePlugin
+const pkg = {
+    name: "nn-widgets",
+    version: "0.2.0",
+};
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withNNWidgets, pkg.name, pkg.version);