Pruebas y depuración

Abre la Biblioteca de paneles (Cmd/CtrlShiftE), ve a Comunidad, luego a Crear un panel, y elige Cargar una carpeta. Selecciona la carpeta donde está panel.json. Este es el entorno donde va a correr tu panel, así que todo panel debería pasar aquí antes de publicarse.

• Deska revisa la carpeta con las mismas reglas que usa deska.dev, y lista cada problema en la página de la carpeta, bajo Qué corregir.
• Sirve la carpeta con la misma política que un paquete instalado y recarga el panel cada vez que cambia un archivo, un instante después de guardar.
• El panel tiene exactamente los permisos que pide su panel.json, como los tendrá cuando la gente los permita. La página de la carpeta muestra qué se les va a preguntar.
• Tiene su propio almacenamiento y sus propios archivos, separados de cualquier versión instalada del mismo panel, e init.panel.dev es true.
• Carga la carpeta donde está panel.json. Una carpeta de 5,000 archivos o más, como la raíz de un proyecto con su node_modules, se rechaza y nunca se vigila.
• Una carpeta cargada nunca se fija, no se sincroniza con tu cuenta y no se publica tal cual.

¿Usas Vite u otro servidor de desarrollo con recarga en caliente? En Crear un panel, bajo Una página en localhost, escribe su dirección, como http://localhost:5173. Solo se aceptan localhost y 127.0.0.1, por http o https.

El marco sigue aislado: sin localStorage, con las mismas reglas de foco, y los enlaces por deska.openUrl. Sirve /__deska/sdk.js desde tu propio servidor de desarrollo: copia el tools/preview/sdk.js de la herramienta de vista previa a tu carpeta pública; es una copia del SDK que sirve Deska.

El repositorio de ejemplos trae un host de vista previa que corre un panel en tu propio navegador, junto a tu editor. Necesita Node 20 o posterior.

git clone https://github.com/0xPasho/deska-panels-examples.git
cd deska-panels-examples
npm install
npm run preview -- path/to/my-panel

Abre la dirección que imprime (http://127.0.0.1:5170/ por defecto). La vista previa:

• sirve cada panel en un origen propio con la misma Content-Security-Policy y el mismo sandbox que Deska, y el SDK en /__deska/sdk.js;
• hace la parte de Deska en el puente: tema, visibilidad, almacenamiento, archivos, avisos, enlaces, portapapeles y la fila de Extras, con los límites de Deska, así que una llamada que Deska rechazaría también se rechaza aquí;
• te deja cambiar el tema (oscuro o claro), el lugar (escritorio o Extras), la visibilidad y la inactividad, recargar el panel y borrar su almacenamiento;
• registra cada llamada y su respuesta en un registro del puente junto al panel.

npm run preview -- panels/team-clocks   # un panel, varios, o ninguno para todos
npm run preview -- panels/net-radio --port 5300
npm run validate                        # las revisiones de paquete de Deska en cada carpeta de panels/
npm run check                           # las revisiones, y luego una carga sin ventana en oscuro y claro
npm run check -- team-clocks            # un solo panel de panels/

• validate ejecuta las revisiones de paquete de Deska en cada carpeta de panels/, sin navegador, imprime los problemas de cada carpeta y falla si alguna se rechaza.
• check ejecuta las revisiones y luego carga cada panel sin ventana en la vista previa, en oscuro y en claro (y en Extras si tiene fila). Falla con un error de consola, una violación de la política, una página que nunca llama a deska.ready() o una llamada rechazada, y guarda capturas en docs/screenshots/preview/.
• Los dos buscan en panels/. Para revisar tu propio panel con ellos, pon su carpeta ahí en tu copia del repositorio; preview acepta cualquier ruta.

En la vista previa, abre las herramientas de desarrollo de tu navegador. Ahí el panel es un marco normal: elígelo en el menú de contexto de la consola para ejecutar código en él, mira sus solicitudes en la pestaña de red y lee las violaciones de la política, que nombran la directiva que rechazó algo (connect-src para un host que no declaraste, script-src para un script remoto o eval).

• Registra los rechazos por código: console.warn(err.code) en cada catch convierte una falla silenciosa en una línea que puedes leer.
• Ten SDK Playground cargado junto a tu panel para probar una llamada a mano y ver exactamente qué responde Deska.
• Prueba los estados que va a encontrar la gente: sin conexión, un host lento, el primer uso vacío, el almacenamiento lleno, el panel oculto y vuelto a mostrar, una recarga a mitad de una tarea, los dos temas, y la página de Extras si tienes una.

Cuando la carpeta pase en Deska y se vea bien en los dos temas, lee Publicar.