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.

Import @sixtyfold/lineclass

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 para mostrar de este error de superposición del gráfico.
`sources`	`readonly string[]`	Fuentes del error de superposición del gráfico.
`stack?`	`string \| undefined`	Texto de la pila.

`ChartRendererError`

Error informado cuando un renderizador de gráficos falla durante el arranque o su uso posterior.

Import @sixtyfold/lineclase

class ChartRendererError extends Error

Miembro	Definición	Descripción
`cause?`	`Error \| undefined`	Causa del error del renderizador de gráficos.
`message`	`string`	Texto del mensaje.
`name`	`"ChartRendererError"`	Nombre visible de este error del renderizador de gráficos.
`phase`	`RendererFailurePhase`	Fase del error del renderizador de gráficos.
`stack?`	`string \| undefined`	Texto de la pila.

`LineChart`

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

Importar @sixtyfold/lineclase

class LineChart

Miembro	Definición	Descripción
`addVector`	`(timestamp: number, values: number[]) => void`	Encola una marca temporal finita y un valor por cada serie configurada. Copia los valores antes de encolarlos para que el llamador pueda reutilizar la matriz escalar; las llamadas escalares y por lotes válidas conservan su orden.
`addVectors`	`(timestamps: Float64Array, valuesBySeries: Float64Array[]) => void`	Valida columnas alineadas de marcas temporales Float64Array y series con marcas temporales finitas antes de vaciar las muestras escalares en cola. Las fallas de validación conservan la cola y los búferes del llamador; los anexos en modo worker válidos transfieren y separan los búferes. Lanza: Error si las columnas están mal formadas o alguna marca temporal no es finita.
`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 gráfico y los recursos que posee.
`getAppearance`	`() => DeepReadonly<LineAppearanceOptions>`	Devuelve una instantánea de solo lectura del subconjunto mutable de apariencia.
`getOptions`	`() => DeepReadonly<LineChartOptions>`	Devuelve una instantánea normalizada y 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 hilo principal no se vuelven listos en el intervalo configurado. Las aplicaciones deben await esta método antes de asignar su primer conjunto de datos.
`initStreaming`	`(seriesCount: number, maxPoints?: number) => void`	Asigna un búfer de transmisión de capacidad fija usando un número de series y una capacidad enteros positivos. Descarta las muestras en cola del flujo anterior y cancela su animación pendiente de la ventana de visualización.
`reset`	`(options?: { animated?: boolean; }) => void`	Restablece el viewport al alcance completo de los datos.
`resize`	`() => void`	Sincroniza el renderer 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`	Reemplace o desactive los anuncios localizados de acciones del teclado en tiempo de ejecución. Los anuncios pendientes existentes se cancelan.
`setLabels`	`(labels: ChartLabels) => void`	Actualice las etiquetas del gráfico en tiempo de ejecución. Se fusionan con las etiquetas existentes (mismas semánticas que updateAppearance). Lanza: TypeError por etiquetas malformadas o entradas escasas/no objeto `custom`.
`setLODOptions`	`(patch: LineLODOptions) => void`	Aplique una actualización parcial de modo, densidad, ratio de rebase o cuantización de la cuadrícula 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>`	Actualice primitivas de superposición declarativas en tiempo de ejecución. Las primitivas válidas y las imágenes decodificadas con éxito se instalan incluso cuando otra imagen falla. Si todos los elementos solicitados fallan, la superposición previamente renderizada permanece instalada. Fallos de resolución y de entrega del renderer rechazan con `ChartOverlayError`; registre `setOverlayErrorCallback` cuando la aplicación también necesite notificación asíncrona. Si se llama antes de que el renderer diferido esté listo, esta promesa incluye la espera de preparación. Actualizaciones sustituidas y la destrucción del gráfico son cancelaciones rutinarias y resuelven sin instalar.
`setOverlayErrorCallback`	`(callback: OverlayErrorCallback \| null) => void`	Registre una devolución de llamada para fallos de resolución o entrega de superposición no fatales. Los elementos de superposición exitosos siguen instalándose. La promesa correspondiente `setOverlay` también se rechaza con el mismo error.
`setRendererErrorCallback`	`(callback: RendererErrorCallback \| null) => void`	Registre una devolución de llamada de fallo del renderer de un solo uso. 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; las llamadas `destroy` no la invocan.
`setSeriesVisibilityCallback`	`(callback: ((event: SeriesVisibilityChangeEvent) => void) \| null) => void`	Recibe cambios de visibilidad realizados 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`	Activa las estadísticas del renderizador y recibe instantáneas con limitación de frecuencia. Pase `null` para desactivarlas.
`setViewport`	`(viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void`	Establezca el rango del viewport programáticamente. Solo es necesario proporcionar `xMin` y/o `xMax`; los campos omitidos mantienen los valores actuales.
`setVisibleSeries`	`(indices: number[]) => void`	Muestra solo los índices de series listados.
`toggleSeriesVisibility`	`(index: number) => void`	Alterna la visibilidad de las series.
`updateAppearance`	`(patch: DeepPartial<LineAppearanceOptions>) => void`	Aplica parches a las 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`	Aplica parches a la configuración visual de una única serie por índice.