@interware/content-generator 0.4.4 → 0.6.0

package/dist/_chunks/{index-DGPqyrzz.js → index-BKhe-Jyx.js}

@@ -20,6 +20,7 @@ const __variableDynamicImportRuntimeHelper = (glob, path, segs) => {
   });
 };
 const PLUGIN_ID = "strapi-content-generator-gemini";
+const STUDIO_PATH = `plugins/${PLUGIN_ID}-studio`;
 const loadFontAwesome = () => {
   if (document.getElementById("font-awesome-kit")) return;
   const script = document.createElement("script");
@@ -37,7 +38,8 @@ const Initializer = ({ setPlugin }) => {
   }, []);
   return null;
 };
-const PluginIcon = () => /* @__PURE__ */ jsxRuntime.jsx(icons.Sparkle, {});
+const ContentIcon = () => /* @__PURE__ */ jsxRuntime.jsx(icons.Quotes, {});
+const StudioIcon = () => /* @__PURE__ */ jsxRuntime.jsx(icons.Lightning, {});
 const pluginPermissions = {
   access: [
     {
@@ -71,19 +73,34 @@ const index = {
   register(app) {
     app.addMenuLink({
       to: `plugins/${PLUGIN_ID}`,
-      icon: PluginIcon,
+      icon: ContentIcon,
       intlLabel: {
-        id: `${PLUGIN_ID}.plugin.name`,
-        defaultMessage: PLUGIN_ID
+        id: `${PLUGIN_ID}.menu.content`,
+        defaultMessage: "Generador de contenido"
       },
       Component: async () => {
-        const { App } = await Promise.resolve().then(() => require("./App-CfwvfmvL.js"));
+        const { App } = await Promise.resolve().then(() => require("./App-CJxSC8yt.js"));
         return App;
       },
       permissions: [
         pluginPermissions.access[0]
       ]
     });
+    app.addMenuLink({
+      to: STUDIO_PATH,
+      icon: StudioIcon,
+      intlLabel: {
+        id: `${PLUGIN_ID}.menu.studio`,
+        defaultMessage: "Estudio de imágenes"
+      },
+      Component: async () => {
+        const { StudioApp } = await Promise.resolve().then(() => require("./StudioApp-BaySMwrk.js"));
+        return StudioApp;
+      },
+      permissions: [
+        pluginPermissions.access[0]
+      ]
+    });
     app.registerPlugin({
       id: PLUGIN_ID,
       initializer: Initializer,
@@ -98,7 +115,7 @@ const index = {
         defaultMessage: PLUGIN_ID
       },
       Component: async () => {
-        const component = await Promise.resolve().then(() => require("./Settings-BrqTzJp-.js"));
+        const component = await Promise.resolve().then(() => require("./Settings-BQXxV3LO.js"));
         return component.default;
       },
       to: `plugins/${PLUGIN_ID}/settings`,
@@ -119,6 +136,7 @@ const index = {
   }
 };
 exports.PLUGIN_ID = PLUGIN_ID;
+exports.STUDIO_PATH = STUDIO_PATH;
 exports.closeDialog = closeDialog;
 exports.index = index;
 exports.openDialog = openDialog;

package/dist/_chunks/{index-Dyq8dxMX.mjs → index-BKigRXm3.mjs}

@@ -1,6 +1,6 @@
 import { useRef, useEffect } from "react";
 import { jsx } from "react/jsx-runtime";
-import { Sparkle } from "@strapi/icons";
+import { Quotes, Lightning } from "@strapi/icons";
 import { createSlice } from "@reduxjs/toolkit";
 const __variableDynamicImportRuntimeHelper = (glob, path, segs) => {
   const v = glob[path];
@@ -19,6 +19,7 @@ const __variableDynamicImportRuntimeHelper = (glob, path, segs) => {
   });
 };
 const PLUGIN_ID = "strapi-content-generator-gemini";
+const STUDIO_PATH = `plugins/${PLUGIN_ID}-studio`;
 const loadFontAwesome = () => {
   if (document.getElementById("font-awesome-kit")) return;
   const script = document.createElement("script");
@@ -36,7 +37,8 @@ const Initializer = ({ setPlugin }) => {
   }, []);
   return null;
 };
-const PluginIcon = () => /* @__PURE__ */ jsx(Sparkle, {});
+const ContentIcon = () => /* @__PURE__ */ jsx(Quotes, {});
+const StudioIcon = () => /* @__PURE__ */ jsx(Lightning, {});
 const pluginPermissions = {
   access: [
     {
@@ -70,19 +72,34 @@ const index = {
   register(app) {
     app.addMenuLink({
       to: `plugins/${PLUGIN_ID}`,
-      icon: PluginIcon,
+      icon: ContentIcon,
       intlLabel: {
-        id: `${PLUGIN_ID}.plugin.name`,
-        defaultMessage: PLUGIN_ID
+        id: `${PLUGIN_ID}.menu.content`,
+        defaultMessage: "Generador de contenido"
       },
       Component: async () => {
-        const { App } = await import("./App-BQr5_g5u.mjs");
+        const { App } = await import("./App-qbgUXlOZ.mjs");
         return App;
       },
       permissions: [
         pluginPermissions.access[0]
       ]
     });
+    app.addMenuLink({
+      to: STUDIO_PATH,
+      icon: StudioIcon,
+      intlLabel: {
+        id: `${PLUGIN_ID}.menu.studio`,
+        defaultMessage: "Estudio de imágenes"
+      },
+      Component: async () => {
+        const { StudioApp } = await import("./StudioApp-C_znlQRo.mjs");
+        return StudioApp;
+      },
+      permissions: [
+        pluginPermissions.access[0]
+      ]
+    });
     app.registerPlugin({
       id: PLUGIN_ID,
       initializer: Initializer,
@@ -97,7 +114,7 @@ const index = {
         defaultMessage: PLUGIN_ID
       },
       Component: async () => {
-        const component = await import("./Settings-CdZnYLLK.mjs");
+        const component = await import("./Settings-o2GngLaW.mjs");
         return component.default;
       },
       to: `plugins/${PLUGIN_ID}/settings`,
@@ -119,6 +136,7 @@ const index = {
 };
 export {
   PLUGIN_ID as P,
+  STUDIO_PATH as S,
   closeDialog as c,
   index as i,
   openDialog as o,

package/dist/admin/index.js

@@ -1,3 +1,3 @@
 "use strict";
-const index = require("../_chunks/index-DGPqyrzz.js");
+const index = require("../_chunks/index-BKhe-Jyx.js");
 module.exports = index.index;

package/dist/admin/index.mjs

@@ -1,4 +1,4 @@
-import { i } from "../_chunks/index-Dyq8dxMX.mjs";
+import { i } from "../_chunks/index-BKigRXm3.mjs";
 export {
   i as default
 };

package/dist/admin/src/components/PluginIcon.d.ts

@@ -1,2 +1,4 @@
-declare const PluginIcon: () => import("react/jsx-runtime").JSX.Element;
-export { PluginIcon };
+/** Íconos de las entradas del menú principal (S4.10; Quotes y Lightning a pedido de Israel). */
+declare const ContentIcon: () => import("react/jsx-runtime").JSX.Element;
+declare const StudioIcon: () => import("react/jsx-runtime").JSX.Element;
+export { ContentIcon, StudioIcon };

package/dist/admin/src/components/PluginProviders.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from 'react';
+/**
+ * Proveedores del plugin. El plugin trae su propia copia del Design System (2.2), así que sus componentes
+ * necesitan su tema (claro u oscuro según el panel, S4.10) y el proveedor de tooltips.
+ *
+ * NO se usa `DesignSystemProvider`: monta un `GlobalStyle` con el mismo id que el del panel y, al desmontarse
+ * (al salir del plugin), styled-components borraba también los estilos globales del panel: todo Strapi quedaba
+ * en Times hasta recargar. Los estilos globales y las regiones `aria-live` ya los pone el panel.
+ */
+export declare const PluginProviders: ({ children }: {
+    children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/admin/src/components/generate-video/Form.d.ts

@@ -16,7 +16,7 @@ export type ReferenceImage = {
     previewUrl?: string;
 };
 export declare const validationSchema: Yup.ObjectSchema<{
-    aspectRatio: NonNullable<"1:1" | "9:16" | "16:9" | undefined>;
+    aspectRatio: NonNullable<"1:1" | "16:9" | "9:16" | undefined>;
     scenes: {
         referenceImages?: {
             file?: {} | undefined;

package/dist/admin/src/components/settings/Form.d.ts

@@ -1,8 +1,7 @@
-import { type FormikHelpers } from 'formik';
-import type { FormValues } from "../../containers/settings";
+import type { FormValues, SettingsStatus } from '../../containers/settings';
 interface FormProps {
-    settings: FormValues;
-    handleSubmit: (values: FormValues, formikHelpers: FormikHelpers<FormValues>) => void;
+    status: SettingsStatus;
+    handleSubmit: (values: Partial<FormValues>) => void | Promise<void>;
 }
-declare const Form: ({ settings, handleSubmit }: FormProps) => import("react/jsx-runtime").JSX.Element;
+declare const Form: ({ status, handleSubmit }: FormProps) => import("react/jsx-runtime").JSX.Element;
 export { Form };

package/dist/admin/src/components/settings/VertexSettings.d.ts

@@ -0,0 +1,18 @@
+/** Estado público de la cuenta de servicio que devuelve `GET /config`: nunca la llave (S5.1). */
+export interface VertexStatus {
+    configured: boolean;
+    projectId: string | null;
+    clientEmail: string | null;
+}
+interface VertexSettingsProps {
+    status: VertexStatus;
+    /** Guarda el JSON pegado. Rechaza con el mensaje del servidor si no es válido. */
+    onSave: (json: string) => Promise<void>;
+    onRemove: () => Promise<void>;
+}
+/**
+ * Cuenta de servicio de Vertex AI en Ajustes (S5.1, decisión de Israel). Se pega el JSON completo; al guardarse,
+ * el campo se limpia y la llave no vuelve a mostrarse: solo el proyecto y el correo de la cuenta.
+ */
+export declare const VertexSettings: ({ status, onSave, onRemove }: VertexSettingsProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/containers/settings/index.d.ts

@@ -1,9 +1,9 @@
-export type FormValues = {
-    googleGenAI: string;
-    linkedInAccessToken: string;
-    linkedInOrganizationId: string;
-    facebookClientToken: string;
-    facebookPageId: string;
-};
+export type CredentialField = 'googleGenAI' | 'linkedInAccessToken' | 'linkedInOrganizationId' | 'facebookClientToken' | 'facebookPageId';
+export type FormValues = Record<CredentialField, string>;
+/** Estado enmascarado que devuelve `GET /config`: nunca incluye el valor completo. */
+export type SettingsStatus = Record<CredentialField, {
+    configured: boolean;
+    last4: string | null;
+}>;
 declare const SettingsContainer: () => import("react/jsx-runtime").JSX.Element;
 export { SettingsContainer };

package/dist/admin/src/features/background-removal/RemoveBackgroundButton.d.ts

@@ -0,0 +1,7 @@
+interface RemoveBackgroundButtonProps {
+    src: string;
+    onDone: (dataUrl: string) => void;
+}
+/** «Quitar fondo»: abre el diálogo con los modos Automático y Por color (S4.18); los errores se ven ahí. */
+export declare const RemoveBackgroundButton: ({ src, onDone }: RemoveBackgroundButtonProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/features/background-removal/RemoveBackgroundDialog.d.ts

@@ -0,0 +1,15 @@
+/** Tolerancia inicial (%): quita el fondo liso y sus variaciones leves (compresión, sombras suaves). */
+export declare const DEFAULT_TOLERANCE = 15;
+interface RemoveBackgroundDialogProps {
+    open: boolean;
+    src: string;
+    onClose: () => void;
+    /** PNG sin fondo en data URL. Puede ser asíncrono (la biblioteca guarda la copia). */
+    onApply: (dataUrl: string) => void | Promise<void>;
+}
+/**
+ * «Quitar fondo» con dos modos (S4.18): *Automático* corre ISNet (S4.17) al abrir; *Por color* quita
+ * el fondo conectado a cada punto marcado, con tolerancia y vista previa en vivo.
+ */
+export declare const RemoveBackgroundDialog: ({ open, src, onClose, onApply }: RemoveBackgroundDialogProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/features/background-removal/colorKey.d.ts

@@ -0,0 +1,29 @@
+/**
+ * «Quitar fondo» por color (S4.18). Desde cada punto marcado se rellenan los píxeles conectados
+ * (vecinos arriba, abajo, izquierda y derecha) cuyo color se parece al del punto. Solo se quita lo
+ * conectado: otro fondo, aunque sea del mismo color, se queda si un objeto lo separa. Funciones puras
+ * sobre arreglos RGBA; el canvas queda en el diálogo.
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+type Rgb = readonly [number, number, number];
+/** Franja después de la tolerancia con alfa parcial, para que el contorno no quede dentado. */
+export declare const SOFTNESS = 0.06;
+/** Distancia euclidiana RGB normalizada: 0 es el mismo color, 1 es blanco contra negro. */
+export declare const colorDistance: (a: Rgb, b: Rgb) => number;
+/**
+ * Alfa por píxel (0 quitado, 255 intacto). Cada píxel se compara con el color de su punto, no con su
+ * vecino, así un degradado no se va en cadena. Hasta `tolerance` (0–1) el píxel se quita y el relleno
+ * sigue; en la franja siguiente (`SOFTNESS`) queda con alfa parcial y el relleno se detiene ahí.
+ *
+ * Con `contiguous: false` se quita ese color en toda la imagen, conectado o no: los huecos de letras y
+ * figuras (la «o», la «a») que el relleno no alcanza porque el trazo los encierra.
+ */
+export declare const colorKeyAlpha: (rgba: Uint8ClampedArray, width: number, height: number, points: Point[], tolerance: number, { contiguous }?: {
+    contiguous?: boolean;
+}) => Uint8ClampedArray;
+/** Copia de la imagen con el alfa aplicado; conserva la transparencia que ya tenía. */
+export declare const applyKeyAlpha: (rgba: Uint8ClampedArray, alpha: Uint8ClampedArray) => Uint8ClampedArray;
+export {};

package/dist/admin/src/features/background-removal/imageCanvas.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Canvas de «Quitar fondo» (S4.18): leer los píxeles de una imagen, pintarlos y exportarlos a PNG.
+ * Aislado aquí porque jsdom no dibuja; las pruebas lo simulan.
+ */
+export interface Pixels {
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+}
+export declare const canvas: (width: number, height: number) => {
+    c: HTMLCanvasElement;
+    ctx: CanvasRenderingContext2D;
+};
+export declare const loadImage: (src: string) => Promise<HTMLImageElement>;
+/** Píxeles RGBA de una imagen (data URL o URL del mismo origen) a su tamaño original. */
+export declare const loadPixels: (src: string) => Promise<Pixels>;
+/** Pinta los píxeles en un canvas de la página (la vista previa). */
+export declare const drawPixels: (target: HTMLCanvasElement, width: number, height: number, data: Uint8ClampedArray) => void;
+/** Píxeles → PNG en data URL (conserva la transparencia). */
+export declare const pixelsToDataUrl: (width: number, height: number, data: Uint8ClampedArray) => string;

package/dist/admin/src/features/background-removal/mask.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Posprocesamiento de «Quitar fondo» en el panel (S4.17). La normalización y el modelo (ISNet) los hace el
+ * worker (`static/background-worker.mjs`); aquí se aplica su máscara 0–1 al tamaño de la imagen.
+ * Funciones puras sobre arreglos RGBA: el canvas queda en `runtime.ts`.
+ */
+export declare const INPUT_SIZE = 1024;
+/** Máscara 0–1 → RGBA en gris opaco, para escalarla con un canvas sin alfa premultiplicado. */
+export declare const maskToRgba: (mask: Float32Array, width: number, height: number) => Uint8ClampedArray;
+/** Usa el canal rojo de la máscara (ya al tamaño de la imagen) como alfa de la imagen. */
+export declare const applyAlpha: (rgba: Uint8ClampedArray, maskRgba: Uint8ClampedArray) => void;

package/dist/admin/src/features/background-removal/runtime.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Worker que sirve el CMS desde `/ort/` (lo copia `npm run assets:image-studio` de web-cms desde
+ * `static/background-worker.mjs`): la inferencia corre fuera del hilo del panel (S4.17, ADR-007).
+ */
+export declare const WORKER_URL = "/ort/background-worker.mjs";
+/** Límite por imagen: con WASM en una máquina lenta tarda decenas de segundos, nunca minutos. */
+export declare const RUN_TIMEOUT_MS = 120000;
+export declare const TIMEOUT_MESSAGE = "Quitar fondo tard\u00F3 demasiado. Intenta de nuevo.";
+export declare class RemoveBackgroundTimeout extends Error {
+    constructor();
+}
+/** Mensaje para el panel: el aviso de tiempo agotado o el genérico. */
+export declare const removeBackgroundError: (err: unknown) => "Quitar fondo tardó demasiado. Intenta de nuevo." | "No se pudo quitar el fondo.";
+export interface Model {
+    /** Píxeles RGBA de 1024 × 1024 → máscara 0–1. El búfer se transfiere al worker. */
+    run: (rgba: Uint8ClampedArray) => Promise<Float32Array>;
+}
+/**
+ * Crea el worker y carga el modelo una sola vez por sesión del panel. El worker elige WebGPU o WASM.
+ * Si la carga o una imagen fallan, o una imagen pasa del límite, termina el worker y descarta la
+ * promesa: una sesión que falló puede no volver a responder, y el siguiente intento empieza de cero.
+ */
+export declare const loadModel: (onStatus?: (status: string) => void) => Promise<Model>;
+/** Solo para pruebas. */
+export declare const resetModel: () => void;
+/**
+ * Quita el fondo de una imagen (data URL o URL del mismo origen) y devuelve un PNG en data URL con
+ * el fondo transparente, al tamaño original. La máscara vuelve a ese tamaño escalándola con el
+ * canvas (diseño S4.7, D8).
+ */
+export declare const removeBackground: (src: string, onStatus?: (status: string) => void) => Promise<string>;

package/dist/admin/src/features/generator/EditEmpty.d.ts

@@ -0,0 +1,13 @@
+import type { LibraryFile } from '../library/uploadApi';
+interface EditEmptyProps {
+    disabled: boolean;
+    onUpload: (file: File | undefined) => void;
+    onOpenLibrary: () => void;
+    onOpenRecent: (file: LibraryFile) => void;
+}
+/**
+ * Modo Editar sin imagen (S4.13): arrastrar, subir o elegir de la biblioteca, con las imágenes más
+ * recientes de toda la biblioteca (raíz y subcarpetas, S4.14) a un clic.
+ */
+export declare const EditEmpty: ({ disabled, onUpload, onOpenLibrary, onOpenRecent }: EditEmptyProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/features/generator/GeneratorTab.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Pestaña «Generador» del Estudio de imágenes (diseño S4.2, modos de S4.13). «Crear imagen»: parámetros,
+ * referencias de estilo y prompt con «Expandir idea». «Editar imagen»: una imagen (generada, subida o
+ * de la biblioteca) con cambios por instrucción, elementos para integrar e historial de versiones en
+ * memoria. Nada se sube a la biblioteca hasta que se guarda (D4).
+ */
+export declare const GeneratorTab: () => import("react/jsx-runtime").JSX.Element;

package/dist/admin/src/features/generator/GroundingSources.d.ts

@@ -0,0 +1,9 @@
+import type { Grounding } from './generatorApi';
+/**
+ * Fuentes y sugerencia de búsqueda de una imagen generada con búsqueda de Google (S4.14, D6). Los
+ * términos de Google piden mostrar la sugerencia tal cual: es HTML de Google, así que va en un
+ * iframe `srcdoc` sin scripts (solo puede abrir sus enlaces en otra pestaña).
+ */
+export declare const GroundingSources: ({ grounding }: {
+    grounding: Grounding;
+}) => import("react/jsx-runtime").JSX.Element | null;

package/dist/admin/src/features/generator/ModeSwitch.d.ts

@@ -0,0 +1,6 @@
+export type GeneratorMode = 'create' | 'edit';
+/** Crear o editar (S4.13): dos modos separados para que quede claro qué aplica en cada uno. */
+export declare const ModeSwitch: ({ value, onChange }: {
+    value: GeneratorMode;
+    onChange: (mode: GeneratorMode) => void;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/admin/src/features/generator/PromptComposer.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from 'react';
+import type { PromptLabels } from '../../lib/promptRules';
+interface PromptComposerProps {
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    /** Recibe el texto ya saneado (S4.14, D1). */
+    onSubmit: (text: string) => void;
+    labels: PromptLabels;
+    placeholder: string;
+    actionLabel: string;
+    actionIcon: ReactNode;
+    loading: boolean;
+    disabled: boolean;
+    hint?: string;
+    /** Acciones secundarias dentro del campo, a la izquierda del contador (p. ej. «Expandir idea»). */
+    tools?: ReactNode;
+}
+/**
+ * Campo de prompt con la acción principal dentro (S4.14, D3): contador, validación con las reglas
+ * compartidas y ⌘/Ctrl + Enter. Snowflake: el `Textarea` del DS no admite contenido dentro del
+ * borde; se pinta con los tokens del tema.
+ */
+export declare const PromptComposer: (p: PromptComposerProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/features/generator/ReferencePicker.d.ts

@@ -0,0 +1,26 @@
+interface ReferencePickerProps {
+    files: File[];
+    max: number;
+    modelLabel: string;
+    onChange: (files: File[]) => void;
+    /** Abre el selector de la biblioteca (S4.13). */
+    onPickFromLibrary: () => void;
+    /**
+     * Textos del uso: referencias de estilo al crear o elementos para el cambio al editar (S4.13).
+     * `noun` arma «Agregar …», «… desde la biblioteca» y las etiquetas accesibles.
+     */
+    label?: string;
+    hint?: string;
+    noun?: {
+        plural: string;
+        capital: string;
+        file: string;
+        none: string;
+    };
+}
+/**
+ * Imágenes de referencia con miniaturas. Snowflake: el DS no tiene un cargador de imágenes con
+ * vista previa. El tope lo da el modelo (diseño S4.2, D7); con 0 se deshabilita y lo explica.
+ */
+export declare const ReferencePicker: ({ files, max, modelLabel, onChange, onPickFromLibrary, label, hint, noun, }: ReferencePickerProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/features/generator/VersionHistory.d.ts

@@ -0,0 +1,13 @@
+import type { Version } from './model';
+interface VersionHistoryProps {
+    versions: Version[];
+    currentId: string | null;
+    disabled: boolean;
+    onSelect: (id: string) => void;
+}
+/**
+ * Historial de versiones con miniatura. Snowflake: el DS no tiene una lista seleccionable con
+ * imagen; cada fila es un botón con `aria-current` en la versión actual.
+ */
+export declare const VersionHistory: ({ versions, currentId, disabled, onSelect }: VersionHistoryProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/features/generator/generatorApi.d.ts

@@ -0,0 +1,71 @@
+export interface ImageModelInfo {
+    id: string;
+    label: string;
+    maxReferences: number;
+    sizes: string[];
+    aspectRatios: string[];
+    canEdit: boolean;
+    /** Admite la búsqueda de Google al generar (S4.14). */
+    grounding: boolean;
+}
+/** Fuentes y sugerencia de búsqueda que devuelve una imagen generada con búsqueda de Google. */
+export interface Grounding {
+    suggestions?: string;
+    /** Consultas web y de imágenes que hizo el modelo. */
+    queries: string[];
+    sources: {
+        title: string;
+        uri: string;
+    }[];
+}
+export interface GenerateParams {
+    prompt: string;
+    model: string;
+    aspectRatio: string;
+    imageSize?: string;
+    safety: boolean;
+    allowPeople: boolean;
+    grounding: boolean;
+    references: File[];
+}
+/** Editar la versión actual; `references` son los elementos para el cambio (S4.13). */
+export interface EditParams {
+    src: string;
+    instruction: string;
+    model: string;
+    references: File[];
+    safety: boolean;
+    allowPeople: boolean;
+    /** Proporción que debe conservar el resultado (la de la imagen base). */
+    aspectRatio?: string;
+}
+type Client = {
+    get: (url: string) => Promise<{
+        data: unknown;
+    }>;
+    post: (url: string, body: unknown) => Promise<{
+        data: unknown;
+    }>;
+};
+/** Mensaje del servidor (400 y 422 traen uno legible, diseño S4.2 D12) o el genérico dado. */
+export declare const errorMessage: (err: unknown, fallback: string) => string;
+/** Cliente de las rutas del Generador. Las imágenes viajan en multipart (el JSON admite 1 MB). */
+export declare const createGeneratorApi: (client: Client) => {
+    models(): Promise<{
+        models: ImageModelInfo[];
+        verified: boolean;
+    }>;
+    generate(p: GenerateParams): Promise<{
+        grounding?: Grounding | undefined;
+        src: string;
+        model: string;
+    }>;
+    edit(p: EditParams): Promise<{
+        grounding?: Grounding | undefined;
+        src: string;
+        model: string;
+    }>;
+    expand(prompt: string): Promise<string>;
+};
+export type GeneratorApi = ReturnType<typeof createGeneratorApi>;
+export {};

package/dist/admin/src/features/generator/model.d.ts

@@ -0,0 +1,60 @@
+import type { Grounding } from './generatorApi';
+/**
+ * Historial de versiones del Generador (diseño S4.2, D10). Vive en memoria como en el prototipo:
+ * la persistencia quedó en el parking lot del epic.
+ */
+export interface Version {
+    id: string;
+    /** Data URL de la imagen. */
+    src: string;
+    prompt: string;
+    /** Instrucción con la que se iteró; vacía en la versión original. */
+    instruction?: string;
+    /** Fuentes y sugerencia si se generó con búsqueda de Google (S4.14). */
+    grounding?: Grounding;
+}
+export interface GeneratorState {
+    versions: Version[];
+    currentId: string | null;
+}
+export type GeneratorAction = {
+    type: 'generated';
+    id: string;
+    src: string;
+    prompt: string;
+    grounding?: Grounding;
+} | {
+    type: 'iterated';
+    id: string;
+    src: string;
+    instruction: string;
+}
+/** Una imagen existente (subida o de la biblioteca) como Original, para editarla (S4.13). */
+ | {
+    type: 'loaded';
+    id: string;
+    src: string;
+    name: string;
+} | {
+    type: 'select';
+    id: string;
+}
+/** «Cambiar imagen» en el modo Editar (S4.13). */
+ | {
+    type: 'reset';
+};
+export declare const initialGenerator: GeneratorState;
+export declare const currentVersion: (s: GeneratorState) => Version | null;
+export declare const generatorReducer: (state: GeneratorState, action: GeneratorAction) => GeneratorState;
+export declare const versionLabel: (index: number) => string;
+/**
+ * «Imagen 28 sep» y, desde la segunda versión, « v3». La fecha se arma a mano: `toLocaleDateString`
+ * da «28-sep» o «28 sept» según la versión de ICU del navegador.
+ */
+export declare const defaultSaveName: (date: Date, index: number) => string;
+export declare const ITERATE_EXAMPLES: string[];
+/**
+ * La proporción del modelo más cercana a unas medidas (S4.13). Al editar con elementos, Gemini no
+ * conserva la proporción de la imagen base, así que se le pide la más parecida.
+ */
+export declare const closestRatio: (width: number, height: number, ratios: string[]) => string | undefined;

package/dist/admin/src/features/generator/useGeneratorApi.d.ts

@@ -0,0 +1,21 @@
+/** Cliente del Generador conectado al panel (sesión y notificaciones de Strapi). */
+export declare const useGeneratorApi: () => {
+    api: {
+        models(): Promise<{
+            models: import("./generatorApi").ImageModelInfo[];
+            verified: boolean;
+        }>;
+        generate(p: import("./generatorApi").GenerateParams): Promise<{
+            grounding?: import("./generatorApi").Grounding | undefined;
+            src: string;
+            model: string;
+        }>;
+        edit(p: import("./generatorApi").EditParams): Promise<{
+            grounding?: import("./generatorApi").Grounding | undefined;
+            src: string;
+            model: string;
+        }>;
+        expand(prompt: string): Promise<string>;
+    };
+    notify: (type: 'success' | 'danger' | 'warning', message: string) => void;
+};