capacitor-apple-intelligence 1.0.1 → 1.0.2

package/CapacitorAppleIntelligence.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'CapacitorAppleIntelligence'
-  s.version = '1.0.0'
+  s.version = '1.0.2'
   s.summary = 'Capacitor plugin for Apple Intelligence with schema-constrained JSON generation'
   s.license = 'MIT'
   s.homepage = 'https://github.com/farabiabdelwahe/capacitor-apple-intelligence'

package/README.md

@@ -42,6 +42,18 @@ npx cap sync
 
 ### Basic Example
 
+First, check if Apple Intelligence is available:
+
+```typescript
+const availability = await AppleIntelligence.checkAvailability();
+if (!availability.available) {
+  console.error("Apple Intelligence not available");
+  return;
+}
+```
+
+Then generate JSON:
+
 ```typescript
 import { AppleIntelligence } from 'capacitor-apple-intelligence';
 
@@ -177,12 +189,40 @@ const result = await AppleIntelligence.generateTextWithLanguage({
   language: "es"  // or "Spanish"
 });
 
+if (result.success) {
+  console.log(result.content);
+  // "El atardecer pinta el cielo con tonos dorados y rosados..."
+}
 if (result.success) {
   console.log(result.content);
   // "El atardecer pinta el cielo con tonos dorados y rosados..."
 }
 ```
 
+### Image Generation
+
+Generate images from text prompts:
+
+```typescript
+const result = await AppleIntelligence.generateImage({
+  prompt: "A futuristic city with flying cars",
+  style: "animation",       // Optional: "animation" (default), "illustration", "sketch"
+  count: 1,                 // Optional: Defaults to 1
+  sourceImage: base64String // Optional: Required for face-based generation
+});
+
+if (result.success && result.images) {
+  result.images.forEach(base64Image => {
+    // Display image
+    const img = document.createElement('img');
+    img.src = `data:image/png;base64,${base64Image}`;
+    document.body.appendChild(img);
+  });
+}
+```
+
+**Note**: When your prompt involves generating images of people, you **must** provide a `sourceImage` containing a clearly visible face. This is a requirement of Apple's Image Playground API. The source image should be passed as a base64-encoded string.
+
 Supported language codes: `en`, `es`, `fr`, `de`, `ja`, `zh`, `it`, `pt`, `ru`, `ar`, `ko`
 
 ## API
@@ -211,7 +251,8 @@ if (result.available) {
 }
 ```
 
----
+
+
 
 ### `generate(request)`
 

package/dist/esm/definitions.d.ts

@@ -167,6 +167,13 @@ export interface AppleIntelligencePlugin {
      * @returns Promise resolving to availability status
      */
     checkAvailability(): Promise<AvailabilityResponse>;
+    /**
+     * Generate an image based on the provided prompt using Apple Intelligence.
+     *
+     * @param request - The generation request containing prompt and options
+     * @returns Promise resolving to an image response with success/error and base64 image data
+     */
+    generateImage(request: GenerateImageRequest): Promise<GenerateImageResponse>;
 }
 /**
  * Request payload for text generation.
@@ -221,3 +228,47 @@ export interface AvailabilityResponse {
      */
     error?: GenerateError;
 }
+/**
+ * Request payload for image generation.
+ */
+export interface GenerateImageRequest {
+    /**
+     * The prompt describing the image to generate.
+     */
+    prompt: string;
+    /**
+     * Optional style guide for generation.
+     * Supported values: "animation" (default), "illustration", "sketch".
+     * Note: "photorealistic" is NOT supported by Apple's on-device Image Playground.
+     */
+    style?: string;
+    /**
+     * Optional number of images to generate. Defaults to 1. Maximum 10.
+     */
+    count?: number;
+    /**
+     * Optional base64-encoded source image for face-based generation.
+     * Required when the prompt involves generating images of people/faces.
+     * The image should contain a clearly visible person's face.
+     */
+    sourceImage?: string;
+}
+/**
+ * Response for image generation.
+ */
+export interface GenerateImageResponse {
+    /**
+     * Whether the generation was successful.
+     */
+    success: boolean;
+    /**
+     * Array of base64 encoded images strings.
+     * Only present when success is true.
+     */
+    images?: string[];
+    /**
+     * Error details on failure.
+     * Only present when success is false.
+     */
+    error?: GenerateError;
+}

package/dist/esm/web.d.ts

@@ -9,4 +9,5 @@ export declare class AppleIntelligenceWeb extends WebPlugin implements AppleInte
     generateText(_request: unknown): Promise<any>;
     generateTextWithLanguage(_request: unknown): Promise<any>;
     checkAvailability(): Promise<any>;
+    generateImage(_request: unknown): Promise<any>;
 }

package/dist/esm/web.js

@@ -43,5 +43,15 @@ export class AppleIntelligenceWeb extends WebPlugin {
             },
         };
     }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async generateImage(_request) {
+        return {
+            success: false,
+            error: {
+                code: 'UNAVAILABLE',
+                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',
+            },
+        };
+    }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD,6DAA6D;IAC7D,KAAK,CAAC,QAAQ,CAAC,QAAyB;QACtC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,0FAA0F;aACpG;SACF,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,YAAY,CAAC,QAAiB;QAClC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,0FAA0F;aACpG;SACF,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,wBAAwB,CAAC,QAAiB;QAC9C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,0FAA0F;aACpG;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,0FAA0F;aACpG;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD,6DAA6D;IAC7D,KAAK,CAAC,QAAQ,CAAC,QAAyB;QACtC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,0FAA0F;aACpG;SACF,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,YAAY,CAAC,QAAiB;QAClC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,0FAA0F;aACpG;SACF,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,wBAAwB,CAAC,QAAiB;QAC9C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,0FAA0F;aACpG;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,0FAA0F;aACpG;SACF,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,aAAa,CAAC,QAAiB;QACnC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,0FAA0F;aACpG;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/plugin.cjs.js

@@ -79,6 +79,16 @@ class AppleIntelligenceWeb extends core.WebPlugin {
             },
         };
     }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async generateImage(_request) {
+        return {
+            success: false,
+            error: {
+                code: 'UNAVAILABLE',
+                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',
+            },
+        };
+    }
 }
 
 var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Apple Intelligence Plugin instance.\n *\n * Provides schema-constrained JSON generation using Apple's on-device\n * Foundation Models framework.\n *\n * @example\n * ```typescript\n * import { AppleIntelligence } from 'capacitor-apple-intelligence';\n *\n * const result = await AppleIntelligence.generate({\n *   messages: [{ role: \"user\", content: \"Suggest 3 books\" }],\n *   response_format: {\n *     type: \"json_schema\",\n *     schema: {\n *       type: \"array\",\n *       items: {\n *         type: \"object\",\n *         properties: {\n *           title: { type: \"string\" },\n *           author: { type: \"string\" }\n *         },\n *         required: [\"title\", \"author\"]\n *       }\n *     }\n *   }\n * });\n * ```\n */\nconst AppleIntelligence = registerPlugin('AppleIntelligence', {\n    web: () => import('./web').then((m) => new m.AppleIntelligenceWeb()),\n});\nexport * from './definitions';\nexport { AppleIntelligence };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation stub for Apple Intelligence.\n * Always returns UNAVAILABLE since Apple Intelligence is iOS-only.\n */\nexport class AppleIntelligenceWeb extends WebPlugin {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generate(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateText(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateTextWithLanguage(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    async checkAvailability() {\n        return {\n            available: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACK,MAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;AAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;AACxE,CAAC;;AC/BD;AACA;AACA;AACA;AACO,MAAM,oBAAoB,SAASC,cAAS,CAAC;AACpD;AACA,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE;AAC7B,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,KAAK;AAC1B,YAAY,KAAK,EAAE;AACnB,gBAAgB,IAAI,EAAE,aAAa;AACnC,gBAAgB,OAAO,EAAE,0FAA0F;AACnH,aAAa;AACb,SAAS;AACT,IAAI;AACJ;AACA,IAAI,MAAM,YAAY,CAAC,QAAQ,EAAE;AACjC,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,KAAK;AAC1B,YAAY,KAAK,EAAE;AACnB,gBAAgB,IAAI,EAAE,aAAa;AACnC,gBAAgB,OAAO,EAAE,0FAA0F;AACnH,aAAa;AACb,SAAS;AACT,IAAI;AACJ;AACA,IAAI,MAAM,wBAAwB,CAAC,QAAQ,EAAE;AAC7C,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,KAAK;AAC1B,YAAY,KAAK,EAAE;AACnB,gBAAgB,IAAI,EAAE,aAAa;AACnC,gBAAgB,OAAO,EAAE,0FAA0F;AACnH,aAAa;AACb,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,iBAAiB,GAAG;AAC9B,QAAQ,OAAO;AACf,YAAY,SAAS,EAAE,KAAK;AAC5B,YAAY,KAAK,EAAE;AACnB,gBAAgB,IAAI,EAAE,aAAa;AACnC,gBAAgB,OAAO,EAAE,0FAA0F;AACnH,aAAa;AACb,SAAS;AACT,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Apple Intelligence Plugin instance.\n *\n * Provides schema-constrained JSON generation using Apple's on-device\n * Foundation Models framework.\n *\n * @example\n * ```typescript\n * import { AppleIntelligence } from 'capacitor-apple-intelligence';\n *\n * const result = await AppleIntelligence.generate({\n *   messages: [{ role: \"user\", content: \"Suggest 3 books\" }],\n *   response_format: {\n *     type: \"json_schema\",\n *     schema: {\n *       type: \"array\",\n *       items: {\n *         type: \"object\",\n *         properties: {\n *           title: { type: \"string\" },\n *           author: { type: \"string\" }\n *         },\n *         required: [\"title\", \"author\"]\n *       }\n *     }\n *   }\n * });\n * ```\n */\nconst AppleIntelligence = registerPlugin('AppleIntelligence', {\n    web: () => import('./web').then((m) => new m.AppleIntelligenceWeb()),\n});\nexport * from './definitions';\nexport { AppleIntelligence };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation stub for Apple Intelligence.\n * Always returns UNAVAILABLE since Apple Intelligence is iOS-only.\n */\nexport class AppleIntelligenceWeb extends WebPlugin {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generate(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateText(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateTextWithLanguage(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    async checkAvailability() {\n        return {\n            available: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateImage(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACK,MAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;AAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;AACxE,CAAC;;AC/BD;AACA;AACA;AACA;AACO,MAAM,oBAAoB,SAASC,cAAS,CAAC;AACpD;AACA,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE;AAC7B,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,KAAK;AAC1B,YAAY,KAAK,EAAE;AACnB,gBAAgB,IAAI,EAAE,aAAa;AACnC,gBAAgB,OAAO,EAAE,0FAA0F;AACnH,aAAa;AACb,SAAS;AACT,IAAI;AACJ;AACA,IAAI,MAAM,YAAY,CAAC,QAAQ,EAAE;AACjC,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,KAAK;AAC1B,YAAY,KAAK,EAAE;AACnB,gBAAgB,IAAI,EAAE,aAAa;AACnC,gBAAgB,OAAO,EAAE,0FAA0F;AACnH,aAAa;AACb,SAAS;AACT,IAAI;AACJ;AACA,IAAI,MAAM,wBAAwB,CAAC,QAAQ,EAAE;AAC7C,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,KAAK;AAC1B,YAAY,KAAK,EAAE;AACnB,gBAAgB,IAAI,EAAE,aAAa;AACnC,gBAAgB,OAAO,EAAE,0FAA0F;AACnH,aAAa;AACb,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,iBAAiB,GAAG;AAC9B,QAAQ,OAAO;AACf,YAAY,SAAS,EAAE,KAAK;AAC5B,YAAY,KAAK,EAAE;AACnB,gBAAgB,IAAI,EAAE,aAAa;AACnC,gBAAgB,OAAO,EAAE,0FAA0F;AACnH,aAAa;AACb,SAAS;AACT,IAAI;AACJ;AACA,IAAI,MAAM,aAAa,CAAC,QAAQ,EAAE;AAClC,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,KAAK;AAC1B,YAAY,KAAK,EAAE;AACnB,gBAAgB,IAAI,EAAE,aAAa;AACnC,gBAAgB,OAAO,EAAE,0FAA0F;AACnH,aAAa;AACb,SAAS;AACT,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -78,6 +78,16 @@ var capacitorAppleIntelligence = (function (exports, core) {
                 },
             };
         }
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        async generateImage(_request) {
+            return {
+                success: false,
+                error: {
+                    code: 'UNAVAILABLE',
+                    message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',
+                },
+            };
+        }
     }
 
     var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Apple Intelligence Plugin instance.\n *\n * Provides schema-constrained JSON generation using Apple's on-device\n * Foundation Models framework.\n *\n * @example\n * ```typescript\n * import { AppleIntelligence } from 'capacitor-apple-intelligence';\n *\n * const result = await AppleIntelligence.generate({\n *   messages: [{ role: \"user\", content: \"Suggest 3 books\" }],\n *   response_format: {\n *     type: \"json_schema\",\n *     schema: {\n *       type: \"array\",\n *       items: {\n *         type: \"object\",\n *         properties: {\n *           title: { type: \"string\" },\n *           author: { type: \"string\" }\n *         },\n *         required: [\"title\", \"author\"]\n *       }\n *     }\n *   }\n * });\n * ```\n */\nconst AppleIntelligence = registerPlugin('AppleIntelligence', {\n    web: () => import('./web').then((m) => new m.AppleIntelligenceWeb()),\n});\nexport * from './definitions';\nexport { AppleIntelligence };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation stub for Apple Intelligence.\n * Always returns UNAVAILABLE since Apple Intelligence is iOS-only.\n */\nexport class AppleIntelligenceWeb extends WebPlugin {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generate(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateText(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateTextWithLanguage(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    async checkAvailability() {\n        return {\n            available: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;AACK,UAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;IAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACxE,CAAC;;IC/BD;IACA;IACA;IACA;IACO,MAAM,oBAAoB,SAASC,cAAS,CAAC;IACpD;IACA,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE;IAC7B,QAAQ,OAAO;IACf,YAAY,OAAO,EAAE,KAAK;IAC1B,YAAY,KAAK,EAAE;IACnB,gBAAgB,IAAI,EAAE,aAAa;IACnC,gBAAgB,OAAO,EAAE,0FAA0F;IACnH,aAAa;IACb,SAAS;IACT,IAAI;IACJ;IACA,IAAI,MAAM,YAAY,CAAC,QAAQ,EAAE;IACjC,QAAQ,OAAO;IACf,YAAY,OAAO,EAAE,KAAK;IAC1B,YAAY,KAAK,EAAE;IACnB,gBAAgB,IAAI,EAAE,aAAa;IACnC,gBAAgB,OAAO,EAAE,0FAA0F;IACnH,aAAa;IACb,SAAS;IACT,IAAI;IACJ;IACA,IAAI,MAAM,wBAAwB,CAAC,QAAQ,EAAE;IAC7C,QAAQ,OAAO;IACf,YAAY,OAAO,EAAE,KAAK;IAC1B,YAAY,KAAK,EAAE;IACnB,gBAAgB,IAAI,EAAE,aAAa;IACnC,gBAAgB,OAAO,EAAE,0FAA0F;IACnH,aAAa;IACb,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,OAAO;IACf,YAAY,SAAS,EAAE,KAAK;IAC5B,YAAY,KAAK,EAAE;IACnB,gBAAgB,IAAI,EAAE,aAAa;IACnC,gBAAgB,OAAO,EAAE,0FAA0F;IACnH,aAAa;IACb,SAAS;IACT,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\n/**\n * Apple Intelligence Plugin instance.\n *\n * Provides schema-constrained JSON generation using Apple's on-device\n * Foundation Models framework.\n *\n * @example\n * ```typescript\n * import { AppleIntelligence } from 'capacitor-apple-intelligence';\n *\n * const result = await AppleIntelligence.generate({\n *   messages: [{ role: \"user\", content: \"Suggest 3 books\" }],\n *   response_format: {\n *     type: \"json_schema\",\n *     schema: {\n *       type: \"array\",\n *       items: {\n *         type: \"object\",\n *         properties: {\n *           title: { type: \"string\" },\n *           author: { type: \"string\" }\n *         },\n *         required: [\"title\", \"author\"]\n *       }\n *     }\n *   }\n * });\n * ```\n */\nconst AppleIntelligence = registerPlugin('AppleIntelligence', {\n    web: () => import('./web').then((m) => new m.AppleIntelligenceWeb()),\n});\nexport * from './definitions';\nexport { AppleIntelligence };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation stub for Apple Intelligence.\n * Always returns UNAVAILABLE since Apple Intelligence is iOS-only.\n */\nexport class AppleIntelligenceWeb extends WebPlugin {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generate(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateText(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateTextWithLanguage(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    async checkAvailability() {\n        return {\n            available: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    async generateImage(_request) {\n        return {\n            success: false,\n            error: {\n                code: 'UNAVAILABLE',\n                message: 'Apple Intelligence is only available on iOS 26+ devices with Apple Intelligence enabled.',\n            },\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;AACK,UAAC,iBAAiB,GAAGA,mBAAc,CAAC,mBAAmB,EAAE;IAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACxE,CAAC;;IC/BD;IACA;IACA;IACA;IACO,MAAM,oBAAoB,SAASC,cAAS,CAAC;IACpD;IACA,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE;IAC7B,QAAQ,OAAO;IACf,YAAY,OAAO,EAAE,KAAK;IAC1B,YAAY,KAAK,EAAE;IACnB,gBAAgB,IAAI,EAAE,aAAa;IACnC,gBAAgB,OAAO,EAAE,0FAA0F;IACnH,aAAa;IACb,SAAS;IACT,IAAI;IACJ;IACA,IAAI,MAAM,YAAY,CAAC,QAAQ,EAAE;IACjC,QAAQ,OAAO;IACf,YAAY,OAAO,EAAE,KAAK;IAC1B,YAAY,KAAK,EAAE;IACnB,gBAAgB,IAAI,EAAE,aAAa;IACnC,gBAAgB,OAAO,EAAE,0FAA0F;IACnH,aAAa;IACb,SAAS;IACT,IAAI;IACJ;IACA,IAAI,MAAM,wBAAwB,CAAC,QAAQ,EAAE;IAC7C,QAAQ,OAAO;IACf,YAAY,OAAO,EAAE,KAAK;IAC1B,YAAY,KAAK,EAAE;IACnB,gBAAgB,IAAI,EAAE,aAAa;IACnC,gBAAgB,OAAO,EAAE,0FAA0F;IACnH,aAAa;IACb,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,OAAO;IACf,YAAY,SAAS,EAAE,KAAK;IAC5B,YAAY,KAAK,EAAE;IACnB,gBAAgB,IAAI,EAAE,aAAa;IACnC,gBAAgB,OAAO,EAAE,0FAA0F;IACnH,aAAa;IACb,SAAS;IACT,IAAI;IACJ;IACA,IAAI,MAAM,aAAa,CAAC,QAAQ,EAAE;IAClC,QAAQ,OAAO;IACf,YAAY,OAAO,EAAE,KAAK;IAC1B,YAAY,KAAK,EAAE;IACnB,gBAAgB,IAAI,EAAE,aAAa;IACnC,gBAAgB,OAAO,EAAE,0FAA0F;IACnH,aAAa;IACb,SAAS;IACT,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/AppleIntelligencePlugin/AppleIntelligence.swift

@@ -1,9 +1,14 @@
 import Foundation
+import UIKit
 
 #if canImport(FoundationModels)
 import FoundationModels
 #endif
 
+#if canImport(ImagePlayground)
+import ImagePlayground
+#endif
+
 // MARK: - Error Types
 
 /// Error codes for Apple Intelligence plugin
@@ -51,6 +56,35 @@ public struct Message {
     }
 }
 
+// MARK: - Image Generation Options
+
+/// Configuration options for image generation
+public struct ImageGenerationOptions {
+    /// JPEG compression quality (0.0 to 1.0)
+    public let compressionQuality: CGFloat
+    /// Maximum dimension for the output image
+    public let maxDimension: CGFloat?
+    /// Output format
+    public let format: ImageFormat
+    
+    public enum ImageFormat {
+        case png
+        case jpeg
+    }
+    
+    public static let `default` = ImageGenerationOptions(
+        compressionQuality: 0.8,
+        maxDimension: 1024,
+        format: .jpeg
+    )
+    
+    public init(compressionQuality: CGFloat = 0.8, maxDimension: CGFloat? = 1024, format: ImageFormat = .jpeg) {
+        self.compressionQuality = min(1.0, max(0.0, compressionQuality))
+        self.maxDimension = maxDimension
+        self.format = format
+    }
+}
+
 // MARK: - Main Implementation
 
 /// Apple Intelligence implementation class
@@ -60,6 +94,121 @@ public struct Message {
     // MARK: - Constants
     
     private let maxRetries = 1
+    private let maxImageCount = 10
+    private let minImageCount = 1
+    
+    // MARK: - Task Management
+    
+    /// Currently running generation tasks for cancellation support
+    private var activeTasks: [UUID: Task<Void, Never>] = [:]
+    private let taskLock = NSLock()
+    
+    /// Cancel all active generation tasks
+    public func cancelAllTasks() {
+        taskLock.lock()
+        defer { taskLock.unlock() }
+        for (_, task) in activeTasks {
+            task.cancel()
+        }
+        activeTasks.removeAll()
+    }
+    
+    /// Register a task for tracking
+    private func registerTask(_ task: Task<Void, Never>) -> UUID {
+        let id = UUID()
+        taskLock.lock()
+        activeTasks[id] = task
+        taskLock.unlock()
+        return id
+    }
+    
+    /// Unregister a completed task
+    private func unregisterTask(_ id: UUID) {
+        taskLock.lock()
+        activeTasks.removeValue(forKey: id)
+        taskLock.unlock()
+    }
+    
+    // MARK: - Helper Methods
+    
+    /// Convert schema dictionary to JSON string
+    private func schemaToString(_ schema: [String: Any]) -> String {
+        guard let data = try? JSONSerialization.data(withJSONObject: schema, options: [.prettyPrinted, .sortedKeys]),
+              let string = String(data: data, encoding: .utf8) else {
+            return "{}"
+        }
+        return string
+    }
+    
+    /// Parse message dictionaries into Message objects
+    public func parseMessages(_ messages: [[String: String]]) -> [Message]? {
+        let parsed = messages.compactMap { dict -> Message? in
+            guard let roleStr = dict["role"],
+                  let content = dict["content"],
+                  let role = MessageRole(rawValue: roleStr) else { return nil }
+            return Message(role: role, content: content)
+        }
+        return parsed.isEmpty ? nil : parsed
+    }
+    
+    /// Safely escape string for JSON embedding
+    private func escapeForJson(_ string: String) -> String {
+        guard let data = try? JSONSerialization.data(withJSONObject: string, options: []),
+              let escaped = String(data: data, encoding: .utf8) else {
+            // Fallback: basic escaping
+            return string
+                .replacingOccurrences(of: "\\", with: "\\\\")
+                .replacingOccurrences(of: "\"", with: "\\\"")
+                .replacingOccurrences(of: "\n", with: "\\n")
+                .replacingOccurrences(of: "\r", with: "\\r")
+                .replacingOccurrences(of: "\t", with: "\\t")
+        }
+        // Remove surrounding quotes from JSON string serialization
+        return String(escaped.dropFirst().dropLast())
+    }
+    
+    /// Get full language name from locale code
+    private func fullLanguageName(from code: String) -> String {
+        // First try to get from system locale
+        if let name = Locale.current.localizedString(forLanguageCode: code.lowercased()) {
+            return name
+        }
+        
+        // Fallback map for common codes
+        let fallbackMap: [String: String] = [
+            "en": "English",
+            "es": "Spanish",
+            "fr": "French",
+            "de": "German",
+            "ja": "Japanese",
+            "zh": "Chinese",
+            "it": "Italian",
+            "pt": "Portuguese",
+            "ru": "Russian",
+            "ar": "Arabic",
+            "ko": "Korean",
+            "nl": "Dutch",
+            "pl": "Polish",
+            "tr": "Turkish",
+            "vi": "Vietnamese",
+            "th": "Thai",
+            "hi": "Hindi",
+            "he": "Hebrew",
+            "id": "Indonesian",
+            "ms": "Malay",
+            "sv": "Swedish",
+            "da": "Danish",
+            "no": "Norwegian",
+            "fi": "Finnish",
+            "cs": "Czech",
+            "el": "Greek",
+            "hu": "Hungarian",
+            "ro": "Romanian",
+            "uk": "Ukrainian"
+        ]
+        
+        return fallbackMap[code.lowercased()] ?? code
+    }
     
     // MARK: - JSON Schema Validation
     
@@ -77,10 +226,9 @@ public struct Message {
         case "string":
             return (json is String, json is String ? nil : "Expected string, got \(type(of: json))")
         case "number", "integer":
-            return (json is NSNumber && !(json is Bool), 
-                    (json is NSNumber && !(json is Bool)) ? nil : "Expected number, got \(type(of: json))")
+            return validateNumber(json)
         case "boolean":
-            return (json is Bool, json is Bool ? nil : "Expected boolean, got \(type(of: json))")
+            return validateBoolean(json)
         case "null":
             return (json is NSNull, json is NSNull ? nil : "Expected null, got \(type(of: json))")
         default:
@@ -88,6 +236,40 @@ public struct Message {
         }
     }
     
+    /// Validate a number value (ensuring it's not actually a boolean)
+    private func validateNumber(_ json: Any) -> (valid: Bool, error: String?) {
+        guard let number = json as? NSNumber else {
+            return (false, "Expected number, got \(type(of: json))")
+        }
+        
+        // Use CFGetTypeID to properly distinguish booleans from numbers
+        let boolID = CFBooleanGetTypeID()
+        let typeID = CFGetTypeID(number as CFTypeRef)
+        
+        if typeID == boolID {
+            return (false, "Expected number, got boolean")
+        }
+        
+        return (true, nil)
+    }
+    
+    /// Validate a boolean value
+    private func validateBoolean(_ json: Any) -> (valid: Bool, error: String?) {
+        guard let number = json as? NSNumber else {
+            return (false, "Expected boolean, got \(type(of: json))")
+        }
+        
+        // Use CFGetTypeID to properly identify booleans
+        let boolID = CFBooleanGetTypeID()
+        let typeID = CFGetTypeID(number as CFTypeRef)
+        
+        if typeID == boolID {
+            return (true, nil)
+        }
+        
+        return (false, "Expected boolean, got number")
+    }
+    
     /// Validate an object against a schema
     private func validateObject(_ json: Any, schema: [String: Any]) -> (valid: Bool, error: String?) {
         guard let jsonObject = json as? [String: Any] else {
@@ -155,13 +337,7 @@ public struct Message {
     
     /// Build the system prompt with JSON schema instructions
     private func buildSystemPrompt(userSystemPrompt: String?, schema: [String: Any]) -> String {
-        let schemaJson: String
-        do {
-            let schemaData = try JSONSerialization.data(withJSONObject: schema, options: [.prettyPrinted, .sortedKeys])
-            schemaJson = String(data: schemaData, encoding: .utf8) ?? "{}"
-        } catch {
-            schemaJson = "{}"
-        }
+        let schemaJson = schemaToString(schema)
         
         var prompt = """
         You are a JSON generator. Your response must be ONLY valid JSON that matches the provided schema.
@@ -189,13 +365,7 @@ public struct Message {
     
     /// Build corrective prompt for retry attempts
     private func buildCorrectivePrompt(previousResponse: String, validationError: String, schema: [String: Any]) -> String {
-        let schemaJson: String
-        do {
-            let schemaData = try JSONSerialization.data(withJSONObject: schema, options: [.prettyPrinted, .sortedKeys])
-            schemaJson = String(data: schemaData, encoding: .utf8) ?? "{}"
-        } catch {
-            schemaJson = "{}"
-        }
+        let schemaJson = schemaToString(schema)
         
         return """
         The previous response was invalid JSON or did not match the required schema.
@@ -278,8 +448,13 @@ public struct Message {
         messages: [Message],
         schema: [String: Any]
     ) async -> Result<Any, AppleIntelligenceError> {
-        // Import Foundation Models at runtime
-        // Note: This uses the new Foundation Models framework available in iOS 26+
+        // Check for task cancellation
+        if Task.isCancelled {
+            return .failure(AppleIntelligenceError(
+                code: .nativeError,
+                message: "Generation was cancelled"
+            ))
+        }
         
         // Extract system and user messages
         let systemMessages = messages.filter { $0.role == .system }.map { $0.content }
@@ -296,6 +471,14 @@ public struct Message {
         var lastError = ""
         
         for attempt in 0...maxRetries {
+            // Check for cancellation between attempts
+            if Task.isCancelled {
+                return .failure(AppleIntelligenceError(
+                    code: .nativeError,
+                    message: "Generation was cancelled"
+                ))
+            }
+            
             do {
                 let response: String
                 
@@ -380,14 +563,24 @@ public struct Message {
         return response.content
         
         #else
-        // Fallback for development/testing when FoundationModels isn't available
-        throw AppleIntelligenceError(
-            code: .unavailable,
-            message: "FoundationModels framework not available"
-        )
+        // Mock fallback for development/testing
+        if systemPrompt.contains("You are a JSON generator") {
+            // JSON mock for generate() calls - using proper JSON escaping
+            let escapedQuery = escapeForJson(userPrompt)
+            return """
+            {
+                "mock_response": "This is a mocked JSON response from Apple Intelligence (Runtime not available)",
+                "original_query": "\(escapedQuery)"
+            }
+            """
+        } else {
+            // Return plain text for generateText() calls
+            return "This is a mocked response from Apple Intelligence (Runtime not available). User query was: \(userPrompt)"
+        }
         #endif
     }
 
+    // MARK: - Bridge Helpers
     
     /// Generate method that returns a dictionary suitable for Capacitor bridge
     @available(iOS 26, *)
@@ -395,17 +588,7 @@ public struct Message {
         messages: [[String: String]],
         schema: [String: Any]
     ) async -> [String: Any] {
-        // Convert raw dictionaries to Message objects
-        let parsedMessages = messages.compactMap { dict -> Message? in
-            guard let roleStr = dict["role"],
-                  let content = dict["content"],
-                  let role = MessageRole(rawValue: roleStr) else {
-                return nil
-            }
-            return Message(role: role, content: content)
-        }
-        
-        if parsedMessages.isEmpty {
+        guard let parsedMessages = parseMessages(messages) else {
             return [
                 "success": false,
                 "error": AppleIntelligenceError(
@@ -430,6 +613,7 @@ public struct Message {
             ]
         }
     }
+    
     /// Generate plain text output using Apple Intelligence
     /// - Parameters:
     ///   - messages: Array of conversation messages
@@ -438,6 +622,14 @@ public struct Message {
     public func generateText(
         messages: [Message]
     ) async -> Result<String, AppleIntelligenceError> {
+        // Check for task cancellation
+        if Task.isCancelled {
+            return .failure(AppleIntelligenceError(
+                code: .nativeError,
+                message: "Generation was cancelled"
+            ))
+        }
+        
         let systemMessages = messages.filter { $0.role == .system }.map { $0.content }
         let userMessages = messages.filter { $0.role == .user }.map { $0.content }
         
@@ -468,25 +660,19 @@ public struct Message {
         messages: [Message],
         language: String
     ) async -> Result<String, AppleIntelligenceError> {
+        // Check for task cancellation
+        if Task.isCancelled {
+            return .failure(AppleIntelligenceError(
+                code: .nativeError,
+                message: "Generation was cancelled"
+            ))
+        }
+        
         let systemMessages = messages.filter { $0.role == .system }.map { $0.content }
         let userMessages = messages.filter { $0.role == .user }.map { $0.content }
         
-        // Convert language code to full language name for better model understanding
-        let languageMap: [String: String] = [
-            "en": "English",
-            "es": "Spanish",
-            "fr": "French",
-            "de": "German",
-            "ja": "Japanese",
-            "zh": "Chinese",
-            "it": "Italian",
-            "pt": "Portuguese",
-            "ru": "Russian",
-            "ar": "Arabic",
-            "ko": "Korean"
-        ]
-        
-        let fullLanguageName = languageMap[language.lowercased()] ?? language
+        // Get full language name dynamically
+        let fullLanguageName = fullLanguageName(from: language)
         
         var systemPrompt = systemMessages.joined(separator: "\n")
         // Append language instruction
@@ -516,16 +702,7 @@ public struct Message {
     public func generateTextForBridge(
         messages: [[String: String]]
     ) async -> [String: Any] {
-        let parsedMessages = messages.compactMap { dict -> Message? in
-            guard let roleStr = dict["role"],
-                  let content = dict["content"],
-                  let role = MessageRole(rawValue: roleStr) else {
-                return nil
-            }
-            return Message(role: role, content: content)
-        }
-        
-        if parsedMessages.isEmpty {
+        guard let parsedMessages = parseMessages(messages) else {
             return [
                 "success": false,
                 "error": AppleIntelligenceError(
@@ -557,16 +734,7 @@ public struct Message {
         messages: [[String: String]],
         language: String
     ) async -> [String: Any] {
-        let parsedMessages = messages.compactMap { dict -> Message? in
-            guard let roleStr = dict["role"],
-                  let content = dict["content"],
-                  let role = MessageRole(rawValue: roleStr) else {
-                return nil
-            }
-            return Message(role: role, content: content)
-        }
-        
-        if parsedMessages.isEmpty {
+        guard let parsedMessages = parseMessages(messages) else {
             return [
                 "success": false,
                 "error": AppleIntelligenceError(
@@ -591,4 +759,180 @@ public struct Message {
             ]
         }
     }
+    
+    // MARK: - Image Generation
+    
+    /// Supported image styles for Apple's on-device Image Playground
+    /// Note: Photorealistic images are NOT supported by Apple's on-device API
+    public static let supportedImageStyles = ["animation", "illustration", "sketch"]
+    
+    /// Generate images using Apple Intelligence
+    /// - Parameters:
+    ///   - prompt: Description of the image
+    ///   - style: Style for the image. Supported values: "animation" (default), "illustration", "sketch".
+    ///            Note: "photorealistic" and other styles are NOT supported by Apple's on-device Image Playground API.
+    ///   - count: Number of images (clamped to 1-10)
+    ///   - sourceImage: Optional source image for face-based generation. Required when prompt involves generating images of people.
+    ///   - options: Image generation options for compression and sizing
+    /// - Returns: Result containing array of base64 image strings or error
+    @available(iOS 26, *)
+    public func generateImage(
+        prompt: String,
+        style: String?,
+        count: Int,
+        sourceImage: UIImage? = nil,
+        options: ImageGenerationOptions = .default
+    ) async -> Result<[String], AppleIntelligenceError> {
+        // Check for task cancellation
+        if Task.isCancelled {
+            return .failure(AppleIntelligenceError(
+                code: .nativeError,
+                message: "Image generation was cancelled"
+            ))
+        }
+        
+        // Validate style parameter
+        if let styleStr = style?.lowercased(), !styleStr.isEmpty {
+            if !Self.supportedImageStyles.contains(styleStr) {
+                return .failure(AppleIntelligenceError(
+                    code: .nativeError,
+                    message: "Unsupported image style: '\(style ?? "")'. Apple's on-device Image Playground only supports: \(Self.supportedImageStyles.joined(separator: ", ")). Note: Photorealistic images are not supported by Apple's native API."
+                ))
+            }
+        }
+        
+        // Validate and clamp count
+        let validatedCount = max(minImageCount, min(count, maxImageCount))
+        
+        #if canImport(ImagePlayground)
+        do {
+            let creator = try await ImageCreator()
+            
+            // Build concepts array
+            var concepts: [ImagePlaygroundConcept] = [.text(prompt)]
+            
+            // If source image provided, save to temp URL and add as image concept
+            if let source = sourceImage, let jpegData = source.jpegData(compressionQuality: 0.9) {
+                let tempURL = FileManager.default.temporaryDirectory.appendingPathComponent("source_\(UUID().uuidString).jpg")
+                try jpegData.write(to: tempURL)
+                if let imageConcept = ImagePlaygroundConcept.image(tempURL) {
+                    concepts.append(imageConcept)
+                }
+            }
+            
+            // Map style string to ImagePlaygroundStyle enum
+            let imageStyle: ImagePlaygroundStyle
+            switch style?.lowercased() {
+            case "illustration": imageStyle = .illustration
+            case "sketch": imageStyle = .sketch
+            default: imageStyle = .animation  // Default to animation
+            }
+            
+            var base64Images: [String] = []
+            
+            for try await createdImage in creator.images(for: concepts, style: imageStyle, limit: validatedCount) {
+                // Check for cancellation during image generation
+                if Task.isCancelled {
+                    return .failure(AppleIntelligenceError(
+                        code: .nativeError,
+                        message: "Image generation was cancelled"
+                    ))
+                }
+                
+                var uiImage = UIImage(cgImage: createdImage.cgImage)
+                
+                // Resize if needed
+                if let maxDim = options.maxDimension {
+                    uiImage = resizeImage(uiImage, maxDimension: maxDim)
+                }
+                
+                // Compress based on format
+                let data: Data?
+                switch options.format {
+                case .png:
+                    data = uiImage.pngData()
+                case .jpeg:
+                    data = uiImage.jpegData(compressionQuality: options.compressionQuality)
+                }
+                
+                if let imageData = data {
+                    base64Images.append(imageData.base64EncodedString())
+                }
+            }
+            
+            if base64Images.isEmpty {
+                return .failure(AppleIntelligenceError(code: .nativeError, message: "No images were generated"))
+            }
+            return .success(base64Images)
+        } catch let error as NSError {
+            // Provide more helpful error message for face-related errors
+            let errorMessage = error.localizedDescription
+            if errorMessage.lowercased().contains("face") || errorMessage.lowercased().contains("person") || errorMessage.lowercased().contains("source image") {
+                return .failure(AppleIntelligenceError(
+                    code: .nativeError,
+                    message: "This prompt requires generating images of people. Please provide a source image containing a face using the 'sourceImage' parameter, or modify your prompt to avoid generating human faces."
+                ))
+            }
+            return .failure(AppleIntelligenceError(code: .nativeError, message: "Image generation failed: \(errorMessage)"))
+        }
+        #else
+        return .failure(AppleIntelligenceError(code: .unavailable, message: "ImagePlayground not available"))
+        #endif
+    }
+    
+    /// Resize image to fit within maximum dimension while maintaining aspect ratio
+    private func resizeImage(_ image: UIImage, maxDimension: CGFloat) -> UIImage {
+        let size = image.size
+        
+        // Check if resizing is needed
+        guard size.width > maxDimension || size.height > maxDimension else {
+            return image
+        }
+        
+        let ratio = min(maxDimension / size.width, maxDimension / size.height)
+        let newSize = CGSize(width: size.width * ratio, height: size.height * ratio)
+        
+        let renderer = UIGraphicsImageRenderer(size: newSize)
+        return renderer.image { _ in
+            image.draw(in: CGRect(origin: .zero, size: newSize))
+        }
+    }
+
+    /// Generate image bridge helper
+    @available(iOS 26, *)
+    public func generateImageForBridge(
+        prompt: String,
+        style: String?,
+        count: Int,
+        sourceImageBase64: String? = nil,
+        compressionQuality: CGFloat? = nil
+    ) async -> [String: Any] {
+        let options = ImageGenerationOptions(
+            compressionQuality: compressionQuality ?? 0.8,
+            maxDimension: 1024,
+            format: .jpeg
+        )
+        
+        // Decode source image from base64 if provided
+        var sourceImage: UIImage? = nil
+        if let base64String = sourceImageBase64,
+           let imageData = Data(base64Encoded: base64String) {
+            sourceImage = UIImage(data: imageData)
+        }
+        
+        let result = await generateImage(prompt: prompt, style: style, count: count, sourceImage: sourceImage, options: options)
+        
+        switch result {
+        case .success(let images):
+            return [
+                "success": true,
+                "images": images
+            ]
+        case .failure(let error):
+            return [
+                "success": false,
+                "error": error.asDictionary
+            ]
+        }
+    }
 }

package/ios/Sources/AppleIntelligencePlugin/AppleIntelligencePlugin.swift

@@ -3,6 +3,7 @@ import Capacitor
 
 /// Capacitor plugin class for Apple Intelligence
 /// Bridges JavaScript calls to the native AppleIntelligence implementation
+@MainActor
 @objc(AppleIntelligencePlugin)
 public class AppleIntelligencePlugin: CAPPlugin, CAPBridgedPlugin {
     
@@ -14,13 +15,39 @@ public class AppleIntelligencePlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "generate", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "generateText", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "generateTextWithLanguage", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "checkAvailability", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "generateImage", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "checkAvailability", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "cancelAllTasks", returnType: CAPPluginReturnPromise)
     ]
     
     // MARK: - Implementation
     
     private let implementation = AppleIntelligence()
     
+    // MARK: - Helper Methods
+    
+    /// Create a standardized error response dictionary
+    private func errorResponse(code: AppleIntelligenceErrorCode, message: String) -> [String: Any] {
+        return [
+            "success": false,
+            "error": [
+                "code": code.rawValue,
+                "message": message
+            ]
+        ]
+    }
+    
+    /// Create an unavailable error response from the availability check
+    private func unavailableResponse(from availability: (available: Bool, error: AppleIntelligenceError?)) -> [String: Any] {
+        return [
+            "success": false,
+            "error": availability.error?.asDictionary ?? [
+                "code": AppleIntelligenceErrorCode.unavailable.rawValue,
+                "message": "Apple Intelligence is not available on this device."
+            ]
+        ]
+    }
+    
     // MARK: - Plugin Methods
     
     /// Generate structured JSON output using Apple Intelligence
@@ -28,185 +55,160 @@ public class AppleIntelligencePlugin: CAPPlugin, CAPBridgedPlugin {
     @objc func generate(_ call: CAPPluginCall) {
         // Validate input
         guard let messagesArray = call.getArray("messages") as? [[String: String]] else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "NATIVE_ERROR",
-                    "message": "Invalid or missing 'messages' array. Expected array of { role: string, content: string }."
-                ]
-            ])
+            call.resolve(errorResponse(
+                code: .nativeError,
+                message: "Invalid or missing 'messages' array. Expected array of { role: string, content: string }."
+            ))
             return
         }
         
         guard let responseFormat = call.getObject("response_format") else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "NATIVE_ERROR",
-                    "message": "Missing 'response_format' object."
-                ]
-            ])
+            call.resolve(errorResponse(
+                code: .nativeError,
+                message: "Missing 'response_format' object."
+            ))
             return
         }
         
         guard let formatType = responseFormat["type"] as? String, formatType == "json_schema" else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "NATIVE_ERROR",
-                    "message": "response_format.type must be 'json_schema'."
-                ]
-            ])
+            call.resolve(errorResponse(
+                code: .nativeError,
+                message: "response_format.type must be 'json_schema'."
+            ))
             return
         }
         
         guard let schema = responseFormat["schema"] as? [String: Any] else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "NATIVE_ERROR",
-                    "message": "Missing or invalid 'schema' in response_format."
-                ]
-            ])
+            call.resolve(errorResponse(
+                code: .nativeError,
+                message: "Missing or invalid 'schema' in response_format."
+            ))
             return
         }
         
-        // Check availability
+        // Check availability (handles both iOS version and Apple Intelligence feature availability)
         let availability = implementation.checkAvailability()
-        if !availability.available {
-            call.resolve([
-                "success": false,
-                "error": availability.error?.asDictionary ?? [
-                    "code": "UNAVAILABLE",
-                    "message": "Apple Intelligence is not available on this device."
-                ]
-            ])
+        guard availability.available else {
+            call.resolve(unavailableResponse(from: availability))
             return
         }
         
         // Execute generation asynchronously
         if #available(iOS 26, *) {
-            Task {
-                let result = await implementation.generateForBridge(
+            Task { [weak self] in
+                guard let self = self else { return }
+                
+                let result = await self.implementation.generateForBridge(
                     messages: messagesArray,
                     schema: schema
                 )
                 
-                // Resolve on main thread
-                await MainActor.run {
-                    call.resolve(result)
-                }
+                call.resolve(result)
             }
-        } else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "UNAVAILABLE",
-                    "message": "Apple Intelligence requires iOS 26 or later."
-                ]
-            ])
         }
+        // Note: No else needed - checkAvailability already handles iOS version check
     }
 
     /// Generate plain text output using Apple Intelligence
     @objc func generateText(_ call: CAPPluginCall) {
         guard let messagesArray = call.getArray("messages") as? [[String: String]] else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "NATIVE_ERROR",
-                    "message": "Invalid or missing 'messages' array."
-                ]
-            ])
+            call.resolve(errorResponse(
+                code: .nativeError,
+                message: "Invalid or missing 'messages' array."
+            ))
             return
         }
 
         // Check availability
         let availability = implementation.checkAvailability()
-        if !availability.available {
-            call.resolve([
-                "success": false,
-                "error": availability.error?.asDictionary ?? [
-                    "code": "UNAVAILABLE",
-                    "message": "Apple Intelligence is not available on this device."
-                ]
-            ])
+        guard availability.available else {
+            call.resolve(unavailableResponse(from: availability))
             return
         }
 
         if #available(iOS 26, *) {
-            Task {
-                let result = await implementation.generateTextForBridge(messages: messagesArray)
-                await MainActor.run {
-                    call.resolve(result)
-                }
+            Task { [weak self] in
+                guard let self = self else { return }
+                
+                let result = await self.implementation.generateTextForBridge(messages: messagesArray)
+                call.resolve(result)
             }
-        } else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "UNAVAILABLE",
-                    "message": "Apple Intelligence requires iOS 26 or later."
-                ]
-            ])
         }
     }
 
     /// Generate plain text output with specific language
     @objc func generateTextWithLanguage(_ call: CAPPluginCall) {
         guard let messagesArray = call.getArray("messages") as? [[String: String]] else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "NATIVE_ERROR",
-                    "message": "Invalid or missing 'messages' array."
-                ]
-            ])
+            call.resolve(errorResponse(
+                code: .nativeError,
+                message: "Invalid or missing 'messages' array."
+            ))
             return
         }
 
         guard let language = call.getString("language") else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "NATIVE_ERROR",
-                    "message": "Missing 'language' string."
-                ]
-            ])
+            call.resolve(errorResponse(
+                code: .nativeError,
+                message: "Missing 'language' string."
+            ))
             return
         }
 
         // Check availability
         let availability = implementation.checkAvailability()
-        if !availability.available {
-            call.resolve([
-                "success": false,
-                "error": availability.error?.asDictionary ?? [
-                    "code": "UNAVAILABLE",
-                    "message": "Apple Intelligence is not available on this device."
-                ]
-            ])
+        guard availability.available else {
+            call.resolve(unavailableResponse(from: availability))
             return
         }
 
         if #available(iOS 26, *) {
-            Task {
-                let result = await implementation.generateTextWithLanguageForBridge(
+            Task { [weak self] in
+                guard let self = self else { return }
+                
+                let result = await self.implementation.generateTextWithLanguageForBridge(
                     messages: messagesArray,
                     language: language
                 )
-                await MainActor.run {
-                    call.resolve(result)
-                }
+                call.resolve(result)
+            }
+        }
+    }
+
+    /// Generate image using Apple Intelligence
+    @objc func generateImage(_ call: CAPPluginCall) {
+        guard let prompt = call.getString("prompt") else {
+            call.resolve(errorResponse(
+                code: .nativeError,
+                message: "Missing 'prompt' string."
+            ))
+            return
+        }
+
+        let style = call.getString("style")
+        let count = call.getInt("count") ?? 1
+        let compressionQuality = call.getDouble("compressionQuality")
+        let sourceImage = call.getString("sourceImage")
+
+        // Check availability
+        let availability = implementation.checkAvailability()
+        guard availability.available else {
+            call.resolve(unavailableResponse(from: availability))
+            return
+        }
+
+        if #available(iOS 26, *) {
+            Task { [weak self] in
+                guard let self = self else { return }
+                
+                let result = await self.implementation.generateImageForBridge(
+                    prompt: prompt,
+                    style: style,
+                    count: count,
+                    sourceImageBase64: sourceImage,
+                    compressionQuality: compressionQuality.map { CGFloat($0) }
+                )
+                call.resolve(result)
             }
-        } else {
-            call.resolve([
-                "success": false,
-                "error": [
-                    "code": "UNAVAILABLE",
-                    "message": "Apple Intelligence requires iOS 26 or later."
-                ]
-            ])
         }
     }
 
@@ -222,10 +224,18 @@ public class AppleIntelligencePlugin: CAPPlugin, CAPBridgedPlugin {
             call.resolve([
                 "available": false,
                 "error": availability.error?.asDictionary ?? [
-                    "code": "UNAVAILABLE",
+                    "code": AppleIntelligenceErrorCode.unavailable.rawValue,
                     "message": "Apple Intelligence is not available on this device."
                 ]
             ])
         }
     }
+    
+    /// Cancel all active generation tasks
+    @objc func cancelAllTasks(_ call: CAPPluginCall) {
+        implementation.cancelAllTasks()
+        call.resolve([
+            "success": true
+        ])
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-apple-intelligence",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Capacitor v8 plugin for Apple Intelligence with schema-constrained JSON generation for structured AI responses",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -77,4 +77,4 @@
       "src": "ios"
     }
   }
-}
+}