LineChart API

Importar

import { LineChart } from "@sixtyfold/line";

Usa el punto de entrada público indicado arriba. Las importaciones solo de tipos se eliminan del JavaScript de la aplicación.

`ChartOverlayError`

Error informado cuando una o más fuentes de superposición declarativas no se pueden aplicar.

Importar @sixtyfold/lineclase

class ChartOverlayError extends Error

Miembro	Definición	Descripción
`cause?`	`Error \| undefined`	Causa del error de superposición del gráfico.
`message`	`string`	Texto del mensaje.
`name`	`"ChartOverlayError"`	Nombre mostrado para este error de superposición de gráfico.
`sources`	`readonly string[]`	Fuentes para el error de superposición de gráfico.
`stack?`	`string \| undefined`	Texto de la pila.

`ChartRendererError`

Error reportado cuando un renderer de gráfico falla durante el arranque o en uso posterior.

Import @sixtyfold/lineclass

class ChartRendererError extends Error

Member	Definition	Description
`cause?`	`Error \| undefined`	Motivo del error del renderizador de gráficos.
`message`	`string`	Texto del mensaje.
`name`	`"ChartRendererError"`	Nombre visible para este error del renderer de gráficos.
`phase`	`RendererFailurePhase`	Fase del error del renderer de gráficos.
`stack?`	`string \| undefined`	Texto de pila.

`LineChart`

Gráfico imperativo para navegador para series de tipo line, step, range, scatter, bar y stacked-area.

Import @sixtyfold/lineclass

class LineChart

Miembro	Definición	Descripción
`addVector`	`(timestamp: number, values: number[]) => void`	Añade una marca temporal y un valor por serie al búfer de streaming.
`addVectors`	`(timestamps: Float64Array, valuesBySeries: Float64Array[]) => void`	Añade marcas temporales alineadas y columnas de series al búfer de streaming.
`batch`	`(fn: () => void) => void`	Agrupa cambios síncronos de apariencia y viewport en una actualización. Los lotes anidados se combinan; las cargas de datos se ejecutan de inmediato.
`destroy`	`() => void`	Libera el chart y sus recursos asociados.
`getAppearance`	`() => DeepReadonly<LineAppearanceOptions>`	Devuelve una instantánea de solo lectura del subconjunto mutable de apariencia.
`getOptions`	`() => DeepReadonly<LineChartOptions>`	Devuelve una instantánea completa normalizada de solo lectura de todas las opciones (construcción + apariencia actual).
`getRenderMode`	`() => "worker" \| "main"`	Devuelve el modo de renderizado resuelto ("worker" o "main").
`getSeriesVisibility`	`() => boolean[]`	Devuelve la visibilidad de la serie.
`getViewport`	`() => Viewport`	Devuelve una instantánea del viewport actual.
`initialize`	`() => Promise<void>`	Espere hasta que el renderer esté listo para datos y comandos en tiempo de ejecución. El watchdog de inicialización en tiempo de construcción rechaza esta promesa con una `ChartRendererError` cuando el worker o la alternativa en el main thread no se vuelven operativos en el intervalo configurado. Las aplicaciones deberían await este método antes de instalar su primer conjunto de datos.
`initStreaming`	`(seriesCount: number, maxPoints?: number) => void`	Reserva un búfer de transmisión de capacidad fija para el número configurado de series.
`reset`	`(options?: { animated?: boolean; }) => void`	Restablece la vista al alcance completo de los datos.
`resize`	`() => void`	Sincroniza el renderizador con el tamaño del canvas.
`setData`	`(data: TimeSeriesData, options?: LineDataUpdateOptions) => number`	Carga una serie y entrega al renderizador la propiedad de sus typed arrays. En modo worker, los buffers se transfieren y se separan; en el hilo principal, el renderizador conserva referencias. Devuelve la generación de datos.
`setKeyboardAnnouncements`	`(messages: false \| KeyboardAnnouncementMessages) => void`	Reemplaza o desactiva los anuncios localizados de acciones del teclado en tiempo de ejecución. Los anuncios pendientes existentes se cancelan.
`setLabels`	`(labels: ChartLabels) => void`	Actualiza las etiquetas del gráfico en tiempo de ejecución. Se fusionan con las etiquetas existentes (mismas semánticas que updateAppearance). Lanza: TypeError para etiquetas malformadas o entradas dispersas/no objeto `custom`.
`setLODOptions`	`(patch: LineLODOptions) => void`	Aplica una actualización parcial de modo, density, rebase ratio o grid quantization sin recrear el gráfico ni reconstruir su jerarquía.
`setMultiSeriesData`	`(data: MultiSeriesData, options?: LineDataUpdateOptions) => number`	Carga series alineadas con una columna X compartida y entrega al renderizador la propiedad de sus typed arrays. En modo worker, los buffers se transfieren y se separan; en el hilo principal, el renderizador conserva referencias. Devuelve la generación de datos.
`setOverlay`	`(overlay: OverlayOptions) => Promise<void>`	Actualiza primitivas de superposición declarativas en tiempo de ejecución. Las primitivas válidas y las imágenes decodificadas con éxito se instalan aunque otra imagen falle. Si todos los elementos solicitados fallan, permanece instalada la superposición renderizada previamente. Fallos de resolución y entrega del renderer rechazan con `ChartOverlayError`; registre `setOverlayErrorCallback` cuando la aplicación también necesite notificación asíncrona. Cuando se llama antes de que el renderer perezoso esté listo, esta promesa incluye la espera de preparación. Actualizaciones sustituidas y destrucción del gráfico son cancelación rutinaria y resuelven sin instalar.
`setOverlayErrorCallback`	`(callback: OverlayErrorCallback \| null) => void`	Registra una devolución de llamada para fallos no fatales de resolución o entrega de superposición. Los elementos de superposición exitosos aún se instalan. La promesa correspondiente `setOverlay` también se rechaza con el mismo error.
`setRendererErrorCallback`	`(callback: RendererErrorCallback \| null) => void`	Registra una devolución de llamada de fallo del renderer de una sola vez. Se invoca una vez antes del desmontaje por fallos de inicialización o en tiempo de ejecución. Sin una devolución de llamada, los errores usan `console.error`. Pase `null` para cancelarla; llamadas `destroy` no la invocan.
`setSeriesVisibilityCallback`	`(callback: ((event: SeriesVisibilityChangeEvent) => void) \| null) => void`	Recibe cambios de visibilidad efectuados mediante la API o la leyenda interactiva.
`setSeriesVisible`	`(index: number, visible: boolean) => void`	Muestra u oculta una serie por índice.
`setStatsCallback`	`(callback: ((stats: LineChartStats) => void) \| null, options?: LineChartStatsOptions) => void`	Habilita estadísticas del renderer y recibe instantáneas con limitación de frecuencia. Pase `null` para desactivarlas.
`setViewport`	`(viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void`	Establece programáticamente el rango del viewport. Solo es necesario proporcionar `xMin` y/o `xMax`; los campos omitidos conservan los valores actuales.
`setVisibleSeries`	`(indices: number[]) => void`	Muestra solo los índices de series listados.
`toggleSeriesVisibility`	`(index: number) => void`	Alterna la visibilidad de la serie.
`updateAppearance`	`(patch: DeepPartial<LineAppearanceOptions>) => void`	Parchea opciones de apariencia mutables en tiempo de ejecución. Lanza: TypeError para etiquetas mal formadas o entradas `custom` dispersas/no objeto.
`updateSeriesAppearance`	`(index: number, patch: DeepPartial<SeriesAppearanceOptions>) => void`	Parchea la configuración visual de una sola serie por índice.