@medicaresoft/dicom-viewer 0.1.0 → 0.2.0

package/README.md

@@ -45,6 +45,45 @@ El host decide de dónde salen los bytes: API propia, DICOMweb, disco local
 | `onBack` | `() => void` | Si se define, muestra botón volver |
 | `actions` | `ReactNode` | `<Action/>` inyectadas en slots |
 | `modals` | `ReactNode` | `<ViewerModal/>` inyectados |
+| `theme` | `DicomViewerTheme` | Colores primario/secundario + contrastes y superficies |
+
+## Tema (`theme`)
+
+El visor se personaliza en runtime sin recompilar estilos:
+
+```tsx
+<DicomViewer
+  study={study}
+  getDicomFile={fetcher}
+  theme={{
+    primary: "#0a5f8a",
+    primaryForeground: "#ffffff",
+    secondary: "#e63946",
+    secondaryForeground: "#ffffff",
+    // superficies opcionales (tema oscuro completo):
+    background: "#0e1017",
+    chrome: "#060608",
+    panel: "#1a1d27",
+    panelHover: "#202432",
+    border: "#242735",
+    // ...
+  }}
+/>
+```
+
+El prop se inyecta como variables CSS (`--dv-*`) en el elemento raíz del
+visor — alcance por instancia, sin contaminar el `:root` del host. Todos los
+campos son opcionales; los no definidos usan los defaults del paquete (o el
+tema del host, en el caso de Symphony).
+
+También puedes sobreescribir las variables globalmente en tu CSS:
+
+```css
+:root {
+  --dv-secondary: #e63946;
+  --dv-primary: #0a5f8a;
+}
+```
 
 ## Acciones y modales (slots)
 

package/dist/DicomViewer.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import type { DicomFileFetcher, DicomStudy, PresetsConfig, ThumbnailUrlResolver, ViewerBranding } from "./types";
+import type { DicomFileFetcher, DicomStudy, DicomViewerTheme, PresetsConfig, ThumbnailUrlResolver, ViewerBranding } from "./types";
 export interface DicomViewerProps {
     /** Metadatos del estudio (el host los obtiene de donde quiera). */
     study: DicomStudy;
@@ -19,6 +19,11 @@ export interface DicomViewerProps {
     actions?: ReactNode;
     /** Modales inyectados: <ViewerModal open=...>...</ViewerModal>. */
     modals?: ReactNode;
+    /**
+     * Tema de colores: primario/secundario con contrastes y tokens de
+     * superficie. Se aplica como variables CSS scoped al visor.
+     */
+    theme?: DicomViewerTheme;
     className?: string;
 }
 /**
@@ -26,5 +31,5 @@ export interface DicomViewerProps {
  * lógica de negocio, sin router y sin HTTP propio. Todo lo específico del
  * host llega por props (datos, fetchers, branding, acciones y modales).
  */
-export declare const DicomViewer: ({ study, getDicomFile, getThumbnailUrl, presets, maxConcurrentDownloads, branding, onBack, actions: actionsProp, modals: modalsProp, className, }: DicomViewerProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DicomViewer: ({ study, getDicomFile, getThumbnailUrl, presets, maxConcurrentDownloads, branding, onBack, actions: actionsProp, modals: modalsProp, theme, className, }: DicomViewerProps) => import("react/jsx-runtime").JSX.Element;
 export default DicomViewer;

package/dist/components/ImageUnavailable.d.ts

@@ -0,0 +1,16 @@
+interface ImageUnavailableProps {
+    /** Título principal. */
+    title?: string;
+    /** Texto secundario. */
+    description?: string;
+    /** Variante para miniaturas de series. */
+    compact?: boolean;
+    className?: string;
+}
+/**
+ * Placeholder visual para imágenes DICOM que no pudieron cargarse.
+ * Es un SVG/HTML temático (no un DICOM falso): no altera mediciones ni
+ * overlays y se adapta a los colores del visor.
+ */
+export declare function ImageUnavailable({ title, description, compact, className, }: ImageUnavailableProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/SeriesThumbnail.d.ts

@@ -0,0 +1,11 @@
+interface SeriesThumbnailProps {
+    src?: string;
+    alt: string;
+    className?: string;
+}
+/**
+ * Miniatura de serie con fallback estético cuando la URL falla o no existe.
+ * El estado de error es local a cada miniatura.
+ */
+export declare function SeriesThumbnail({ src, alt, className }: SeriesThumbnailProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/hooks/useCornerstoneViewer.d.ts

@@ -6,6 +6,7 @@ export declare function useCornerstoneViewer(study: DicomStudy, seriesIndex?: nu
     loadingProgress: number;
     downloadedCount: number;
     totalImages: number;
+    loadError: boolean;
     currentImageIndex: number;
     activeTool: string;
     toolBindings: Record<number, string>;

package/dist/index.d.ts

@@ -1,7 +1,6 @@
-import "./style.css";
 export { DicomViewer } from "./DicomViewer";
 export type { DicomViewerProps } from "./DicomViewer";
 export { Action, ViewerModal } from "./Action";
 export { DicomToolbarButton } from "./components/DicomToolbarButton";
 export { useDicomContext, useViewerActions, DicomViewerContext } from "./context";
-export type { ActionContext, ActionPlacement, ActionProps, DicomFile, DicomFileFetcher, DicomSeries, DicomStudy, PresetsConfig, ThumbnailUrlResolver, ViewerBranding, ViewerModalProps, } from "./types";
+export type { ActionContext, ActionPlacement, ActionProps, DicomFile, DicomFileFetcher, DicomSeries, DicomStudy, DicomViewerTheme, PresetsConfig, ThumbnailUrlResolver, ViewerBranding, ViewerModalProps, } from "./types";