Added Spanish translations and improved plugin configuration API.

- All plugin configuration options in `PDFViewerConfig` now use `Partial<>` types
- Added Spanish (`es`) locale support with complete translations for all UI elements and commands.

Author: bobsingor

.changeset/snippet-spanish-translations-partial-configs.md

@@ -0,0 +1,25 @@
+---
+'@embedpdf/snippet': minor
+---
+
+Added Spanish translations and improved plugin configuration API.
+
+### New Features
+
+- **Spanish Translations**: Added Spanish (`es`) locale support with complete translations for all UI elements and commands.
+
+### Improvements
+
+- **Partial Plugin Configs**: All plugin configuration options in `PDFViewerConfig` now use `Partial<>` types, making it easier to override only the settings you need without specifying all required fields.
+
+```typescript
+// Before: Had to provide full config objects
+// After: Can override just specific settings
+<PDFViewer
+  config={{
+    src: '/document.pdf',
+    zoom: { defaultZoomLevel: ZoomMode.FitWidth }, // Only override what you need
+    i18n: { defaultLocale: 'es' }, // Use Spanish translations
+  }}
+/>
+```

viewers/snippet/src/components/app.tsx

@@ -126,6 +126,7 @@ import {
   dutchTranslations,
   germanTranslations,
   frenchTranslations,
+  spanishTranslations,
 } from '@/config';
 import { ThemeConfig } from '@/config/theme';
 import { IconsConfig } from '@/config/icon-registry';
@@ -187,67 +188,70 @@ export interface PDFViewerConfig {
   disabledCategories?: string[];
 
   // === Plugin Configurations (uses actual plugin types - no duplication!) ===
+  // All plugin configs are Partial<> so users can override just the settings they need.
+  // Defaults are merged in at runtime.
+
   // Core plugins
   /** Document manager options (initialDocuments) */
-  documentManager?: DocumentManagerPluginConfig;
+  documentManager?: Partial<DocumentManagerPluginConfig>;
   /** Commands options (commands, disabledCategories) */
-  commands?: CommandsPluginConfig;
+  commands?: Partial<CommandsPluginConfig>;
   /** i18n options (defaultLocale, locales, paramResolvers) */
-  i18n?: I18nPluginConfig;
+  i18n?: Partial<I18nPluginConfig>;
   /** UI schema options (schema, disabledCategories) */
-  ui?: UIPluginConfig;
+  ui?: Partial<UIPluginConfig>;
 
   // Viewport & Navigation
   /** Viewport options (viewportGap, scrollEndDelay) */
-  viewport?: ViewportPluginConfig;
+  viewport?: Partial<ViewportPluginConfig>;
   /** Scroll options (defaultStrategy, defaultPageGap, defaultBufferSize) */
-  scroll?: ScrollPluginConfig;
+  scroll?: Partial<ScrollPluginConfig>;
   /** Zoom options (defaultZoomLevel, minZoom, maxZoom, zoomStep) */
-  zoom?: ZoomPluginConfig;
+  zoom?: Partial<ZoomPluginConfig>;
   /** Spread/layout options (defaultSpreadMode) */
-  spread?: SpreadPluginConfig;
+  spread?: Partial<SpreadPluginConfig>;
   /** Rotation options (defaultRotation) */
-  rotation?: RotatePluginConfig;
+  rotation?: Partial<RotatePluginConfig>;
   /** Pan mode options (defaultMode: 'never' | 'mobile' | 'always') */
-  pan?: PanPluginConfig;
+  pan?: Partial<PanPluginConfig>;
 
   // Rendering
   /** Render options (withForms, withAnnotations) */
-  render?: RenderPluginConfig;
+  render?: Partial<RenderPluginConfig>;
   /** Tiling options (tileSize, overlapPx, extraRings) */
-  tiling?: TilingPluginConfig;
+  tiling?: Partial<TilingPluginConfig>;
   /** Thumbnail options (width, gap, buffer, labelHeight, etc.) */
-  thumbnails?: ThumbnailPluginConfig;
+  thumbnails?: Partial<ThumbnailPluginConfig>;
 
   // Content features
   /** Annotation options (tools, colorPresets, autoCommit, author, etc.) */
-  annotations?: AnnotationPluginConfig;
+  annotations?: Partial<AnnotationPluginConfig>;
   /** Search options (flags, showAllResults) */
-  search?: SearchPluginConfig;
+  search?: Partial<SearchPluginConfig>;
   /** Selection options (menuHeight) */
-  selection?: SelectionPluginConfig;
+  selection?: Partial<SelectionPluginConfig>;
   /** Bookmark options */
-  bookmarks?: BookmarkPluginConfig;
+  bookmarks?: Partial<BookmarkPluginConfig>;
   /** Attachment options */
-  attachments?: AttachmentPluginConfig;
+  attachments?: Partial<AttachmentPluginConfig>;
 
   // Tools
   /** Capture options (scale, imageType, withAnnotations) */
-  capture?: CapturePluginConfig;
+  capture?: Partial<CapturePluginConfig>;
   /** Redaction options (drawBlackBoxes) */
-  redaction?: RedactionPluginConfig;
+  redaction?: Partial<RedactionPluginConfig>;
   /** Print options */
-  print?: PrintPluginConfig;
+  print?: Partial<PrintPluginConfig>;
   /** Export options (defaultFileName) */
-  export?: ExportPluginConfig;
+  export?: Partial<ExportPluginConfig>;
   /** Fullscreen options (targetElement) */
-  fullscreen?: FullscreenPluginConfig;
+  fullscreen?: Partial<FullscreenPluginConfig>;
 
   // Infrastructure
   /** History/undo options */
-  history?: HistoryPluginConfig;
+  history?: Partial<HistoryPluginConfig>;
   /** Interaction manager options (exclusionRules) */
-  interactionManager?: InteractionManagerPluginConfig;
+  interactionManager?: Partial<InteractionManagerPluginConfig>;
 }
 
 // Default configurations for all plugins
@@ -258,7 +262,13 @@ const DEFAULTS = {
   commands: { commands: defaultCommands } as CommandsPluginConfig,
   i18n: {
     defaultLocale: 'en',
-    locales: [englishTranslations, dutchTranslations, germanTranslations, frenchTranslations],
+    locales: [
+      englishTranslations,
+      dutchTranslations,
+      germanTranslations,
+      frenchTranslations,
+      spanishTranslations,
+    ],
     paramResolvers: defaultParamResolvers,
   } as I18nPluginConfig,
   ui: { schema: defaultUISchema } as UIPluginConfig,

viewers/snippet/src/config/translations.ts

@@ -759,6 +759,196 @@ export const frenchTranslations: Locale = {
   },
 };
 
+export const spanishTranslations: Locale = {
+  code: 'es',
+  name: 'Español',
+  translations: {
+    search: {
+      placeholder: 'Buscar',
+      caseSensitive: 'Distinguir mayúsculas',
+      wholeWord: 'Palabra completa',
+      resultsFound: '{count} resultados encontrados',
+      page: 'Página {page}',
+    },
+    zoom: {
+      in: 'Acercar',
+      out: 'Alejar',
+      fitWidth: 'Ajustar al ancho',
+      fitPage: 'Ajustar a la página',
+      marquee: 'Zoom de selección',
+      menu: 'Menú de zoom',
+      level: 'Nivel de zoom ({level}%)',
+    },
+    pan: {
+      toggle: 'Alternar modo desplazamiento',
+    },
+    pointer: {
+      toggle: 'Alternar modo puntero',
+    },
+    capture: {
+      screenshot: 'Captura de pantalla',
+    },
+    document: {
+      menu: 'Menú del documento',
+      open: 'Abrir',
+      close: 'Cerrar',
+      print: 'Imprimir',
+      export: 'Exportar',
+      fullscreen: 'Pantalla completa',
+    },
+    emptyState: {
+      title: 'No hay documentos abiertos',
+      description: 'Abra un documento PDF para comenzar.',
+      descriptionMulti: 'Puede ver varios documentos usando pestañas.',
+      openButton: 'Abrir documento',
+      supportedFormats: 'Formato compatible: PDF',
+    },
+    passwordPrompt: {
+      title: 'Contraseña requerida',
+      required:
+        'Este documento está protegido con contraseña. Por favor, ingrese la contraseña para abrirlo.',
+      incorrect: 'La contraseña ingresada es incorrecta. Por favor, inténtelo de nuevo.',
+      incorrectWarning: 'Contraseña incorrecta. Por favor, verifique e inténtelo de nuevo.',
+      label: 'Contraseña',
+      placeholder: 'Ingrese la contraseña del documento',
+      open: 'Abrir',
+      opening: 'Abriendo...',
+      cancel: 'Cancelar',
+      close: 'Cerrar',
+    },
+    documentError: {
+      title: 'Error al cargar el documento',
+      unknown: 'Ha ocurrido un error desconocido',
+      errorCode: 'Código de error: {code}',
+      close: 'Cerrar documento',
+    },
+    panel: {
+      sidebar: 'Barra lateral',
+      search: 'Buscar',
+      comment: 'Comentario',
+      thumbnails: 'Miniaturas',
+      outline: 'Esquema',
+      annotationStyle: 'Estilo de anotación',
+    },
+    menu: {
+      viewControls: 'Controles de vista',
+      zoomControls: 'Controles de zoom',
+      moreOptions: 'Más opciones',
+    },
+    outline: {
+      title: 'Esquema',
+      loading: 'Cargando esquema...',
+      noOutline: 'No hay esquema disponible',
+      noBookmarks: 'Este documento no contiene marcadores',
+    },
+    page: {
+      settings: 'Configuración de página',
+      single: 'Página única',
+      twoOdd: 'Dos páginas (Impar)',
+      twoEven: 'Dos páginas (Par)',
+      vertical: 'Vertical',
+      horizontal: 'Horizontal',
+      spreadMode: 'Modo de doble página',
+      scrollLayout: 'Diseño de desplazamiento',
+      rotation: 'Rotación de página',
+      next: 'Página siguiente',
+      previous: 'Página anterior',
+    },
+    rotate: {
+      clockwise: 'Rotar en sentido horario',
+      counterClockwise: 'Rotar en sentido antihorario',
+    },
+    selection: {
+      copy: 'Copiar selección',
+    },
+    mode: {
+      view: 'Ver',
+      annotate: 'Anotar',
+      shapes: 'Formas',
+      redact: 'Redactar',
+    },
+    annotation: {
+      text: 'Texto',
+      highlight: 'Resaltar',
+      strikeout: 'Tachar',
+      underline: 'Subrayar',
+      squiggly: 'Ondulado',
+      rectangle: 'Rectángulo',
+      circle: 'Círculo',
+      line: 'Línea',
+      arrow: 'Flecha',
+      polygon: 'Polígono',
+      polyline: 'Polilínea',
+      ink: 'Tinta',
+      stamp: 'Sello',
+      // Sidebar labels
+      color: 'Color',
+      opacity: 'Opacidad',
+      blendMode: 'Modo de fusión',
+      strokeWidth: 'Grosor del trazo',
+      strokeColor: 'Color del trazo',
+      borderStyle: 'Estilo del borde',
+      fillColor: 'Color de relleno',
+      fontSize: 'Tamaño de fuente',
+      fontFamily: 'Fuente',
+      textAlign: 'Alineación del texto',
+      verticalAlign: 'Alineación vertical',
+      lineEnding: 'Final de línea',
+      lineStart: 'Inicio de línea',
+      lineEnd: 'Final de línea',
+      font: 'Fuente',
+      fontColor: 'Color de fuente',
+      backgroundColor: 'Color de fondo',
+      noStyles: 'No hay estilos para esta anotación.',
+      noStylesStamp: 'No hay estilos para los sellos.',
+      selectAnnotation: 'Seleccione una anotación para ver los estilos',
+      deleteSelected: 'Eliminar anotación seleccionada',
+    },
+    redaction: {
+      area: 'Redactar área',
+      text: 'Redactar texto',
+      applyAll: 'Aplicar todo',
+      clearAll: 'Borrar todo',
+    },
+    history: {
+      undo: 'Deshacer',
+      redo: 'Rehacer',
+    },
+    comments: {
+      page: 'Página {page}',
+      commentCount: '{count} comentario',
+      commentCountPlural: '{count} comentarios',
+      addComment: 'Añadir comentario...',
+      addReply: 'Añadir respuesta...',
+      save: 'Guardar',
+      cancel: 'Cancelar',
+      edit: 'Editar',
+      delete: 'Eliminar',
+      showMore: 'más',
+      showLess: 'menos',
+      emptyState: 'Añada anotaciones para poder comentarlas.',
+    },
+    blendMode: {
+      normal: 'Normal',
+      multiply: 'Multiplicar',
+      screen: 'Trama',
+      overlay: 'Superponer',
+      darken: 'Oscurecer',
+      lighten: 'Aclarar',
+      colorDodge: 'Sobreexponer color',
+      colorBurn: 'Subexponer color',
+      hardLight: 'Luz fuerte',
+      softLight: 'Luz suave',
+      difference: 'Diferencia',
+      exclusion: 'Exclusión',
+      hue: 'Tono',
+      saturation: 'Saturación',
+      color: 'Color',
+      luminosity: 'Luminosidad',
+    },
+  },
+};
+
 export const paramResolvers: ParamResolvers<State> = {
   'zoom.level': ({ state, documentId }) => {
     const zoomLevel = documentId

viewers/snippet/src/config/ui-schema.ts

@@ -32,11 +32,13 @@ export const viewerUISchema: UISchema = {
               breakpoints: {
                 md: {
                   replaceShow: [
+                    'view-mode',
                     'annotate-mode',
                     'zoom-toolbar',
                     'pan-button',
                     'pointer-button',
                     'divider-3',
+                    'overflow-tabs-button',
                   ],
                 },
               },

viewers/snippet/src/index.html

@@ -25,6 +25,9 @@
       tabBar: 'always',
       theme: {
         preference: 'system'
+      },
+      i18n: {
+        defaultLocale: 'fr',
       }
     })
   </script>