@imgly/plugin-ai-generation-web 0.2.8 → 0.2.9

package/dist/core/provider.d.ts

@@ -174,9 +174,57 @@ export type GenerationResult<O extends Output, C = O> = O | AsyncGenerator<O, C>
  * The options for the generation function.
  */
 export type GenerationOptions = {
+    /**
+     * The block IDs that this generation is operating on.
+     * Middleware can use this to target specific blocks.
+     * - undefined: Middleware typically fall back to selected blocks
+     * - []: Explicitly target no blocks
+     * - [1, 2, 3]: Target specific blocks
+     *
+     * Note: This is passed through to middleware but not required by provider implementations.
+     */
+    blockIds?: number[];
     abortSignal?: AbortSignal;
     engine: CreativeEngine;
     cesdk?: CreativeEditorSDK;
+    /**
+     * Prevents default UI feedback behaviors for this generation.
+     *
+     * **What gets prevented:**
+     * - Error/success notifications
+     * - Block error state
+     * - Console error logging
+     *
+     * **What is NOT prevented (always happens):**
+     * - Pending → Ready block state transition (loading spinner always stops)
+     * - Block validity checks
+     * - Middleware execution flow
+     *
+     * @example
+     * ```typescript
+     * catch (error) {
+     *   options.preventDefault();
+     *   myCustomErrorHandler(error);
+     *   throw error;
+     * }
+     * ```
+     */
+    preventDefault(): void;
+    /**
+     * Check if default behaviors have been prevented.
+     *
+     * @returns `true` if preventDefault() was called
+     *
+     * @example
+     * ```typescript
+     * if (!options.defaultPrevented()) {
+     *   // Show default notification
+     * }
+     * ```
+     *
+     * @internal
+     */
+    defaultPrevented(): boolean;
 };
 export type RenderCustomProperty = {
     [key: string]: (context: BuilderRenderFunctionContext<any>, property: Property) => GetPropertyInput;

package/dist/generation/createGenerateFunction.d.ts

@@ -1,22 +1,33 @@
-import Provider, { Output, OutputKind } from '../core/provider';
+import Provider, { GenerationOptions, Output, OutputKind } from '../core/provider';
 import { Middleware } from '../middleware/middleware';
 import CreativeEditorSDK, { CreativeEngine } from '@cesdk/cesdk-js';
 export type ResultSuccess<O> = {
     status: 'success';
     type: 'async';
     output: AsyncGenerator<O>;
+    middlewareOptions?: GenerationOptions;
 } | {
     status: 'success';
     type: 'sync';
     output: O;
+    middlewareOptions?: GenerationOptions;
 };
 export type Result<O> = ResultSuccess<O> | {
     status: 'error';
     message: string;
+    middlewareOptions?: GenerationOptions;
 } | {
     status: 'aborted';
+    middlewareOptions?: GenerationOptions;
 };
 export type Generate<I, O extends Output> = (input: I, options?: {
+    /**
+     * The block IDs that this generation is operating on.
+     * - undefined: Middleware will fall back to selected blocks
+     * - []: Explicitly target no blocks
+     * - [1, 2, 3]: Target specific blocks (e.g., placeholder block)
+     */
+    blockIds?: number[];
     abortSignal?: AbortSignal;
     middlewares?: Middleware<I, O>[];
     debug?: boolean;

package/dist/generation/handleGenerationError.d.ts

@@ -1,8 +1,9 @@
 import CreativeEditorSDK from '@cesdk/cesdk-js';
-import Provider, { GetInput, Output, OutputKind } from '../core/provider';
+import Provider, { GenerationOptions, GetInput, Output, OutputKind } from '../core/provider';
 declare function handleGenerationError<K extends OutputKind, I, O extends Output>(error: unknown, options: {
     cesdk: CreativeEditorSDK;
     provider: Provider<K, I, O>;
     getInput?: GetInput<I>;
+    middlewareOptions?: GenerationOptions;
 }): void;
 export default handleGenerationError;