@mathstack/viz 1.0.0

package/lib/svg-text-wrap/svg-text-wrap-builder.d.ts

@@ -0,0 +1,58 @@
+import { SvgTextWrap } from './svg-text-wrap';
+export declare class SvgTextWrapBuilder {
+    protected _width: number;
+    protected _maintainXPosition: boolean;
+    protected _maintainYPosition: boolean;
+    protected _lineHeight: number;
+    protected _breakOnChars: string[];
+    protected _spaceAroundBreakChars: boolean;
+    constructor();
+    /**
+     * OPTIONAL. Sets the width to wrap the text to.
+     *
+     * @default 100
+     */
+    width(width: number): this;
+    /**
+     * OPTIONAL. If true, the x position of the text will be maintained.
+     *
+     * This is useful, for example, for centering bar labels on a vertical bar chart.
+     *
+     * @default false
+     */
+    maintainXPosition(maintainXPosition: boolean): this;
+    /**
+     * OPTIONAL. If true, the y position of the text will be maintained.
+     *
+     * This is useful, for example, for centering bar labels on a horizontal bar chart.
+     *
+     * @default false
+     */
+    maintainYPosition(maintainYPosition: boolean): this;
+    /**
+     * OPTIONAL. Sets the line height of the text.
+     *
+     * @default 1.1
+     */
+    lineHeight(lineHeight: number): this;
+    /**
+     * OPTIONAL. Sets the characters to break on when wrapping text.
+     * By default, text will only break on spaces.
+     *
+     * @default []
+     */
+    breakOnChars(breakOnChars: string[]): this;
+    /**
+     * OPTIONAL. If true, spaces will be added around break characters.
+     *
+     * This is useful when breaking on punctuation characters, to avoid words being stuck to punctuation.
+     * For example, breaking on commas without spaces around them would result in "word," at the end of one line and "word" at the start of the next line.
+     *
+     * @default false
+     */
+    spaceAroundBreakChars(spaceAroundBreakChars: boolean): this;
+    /**
+     * @internal Not meant to be called by consumers of the library.
+     */
+    build(): SvgTextWrap;
+}

package/lib/svg-text-wrap/svg-text-wrap-options.d.ts

@@ -0,0 +1,8 @@
+export interface SvgTextWrapOptions {
+    width: number;
+    maintainXPosition: boolean;
+    maintainYPosition: boolean;
+    lineHeight: number;
+    breakOnChars: string[];
+    spaceAroundBreakChars: boolean;
+}

package/lib/svg-text-wrap/svg-text-wrap.d.ts

@@ -0,0 +1,13 @@
+import { Selection } from 'd3';
+import { SvgTextWrapOptions } from './svg-text-wrap-options';
+export declare class SvgTextWrap implements SvgTextWrapOptions {
+    width: number;
+    maintainXPosition: boolean;
+    maintainYPosition: boolean;
+    lineHeight: number;
+    breakOnChars: string[];
+    spaceAroundBreakChars: boolean;
+    constructor(options: SvgTextWrapOptions);
+    wrap(textSelection: Selection<SVGTextElement, any, any, any>): void;
+    private buildTokens;
+}

package/lib/tooltips/config/tooltip.d.ts

@@ -0,0 +1,5 @@
+export declare class Tooltip {
+    show: boolean;
+    type: 'svg' | 'html';
+    constructor(options?: Partial<Tooltip>);
+}

package/lib/tooltips/html-tooltip/config/html-tooltip-builder.d.ts

@@ -0,0 +1,57 @@
+import { InteractionOutput } from '../../../events/interaction-output';
+import { HtmlTooltipConfig } from './html-tooltip-config';
+import { HtmlTooltipCdkManagedPosition } from './position/tooltip-position';
+import { HtmlTooltipSizeBuilder } from './size/tooltip-size-builder';
+import * as i0 from "@angular/core";
+export declare class VicHtmlTooltipConfigBuilder {
+    private _applyEventsDisabledClass;
+    private sizeBuilder;
+    private _panelClass;
+    private _origin;
+    private _hasBackdrop;
+    private _position;
+    private _show;
+    constructor();
+    /**
+     * OPTIONAL. If set to true, the tooltip will have the class 'events-disabled' that can be used to disable pointer events.
+     * This is useful when the tooltip should not interfere with user interactions, such as when it is used for informational purposes only.
+     *
+     * Default is true, meaning the class will be applied.
+     *
+     * @param apply - Whether to apply the events-disabled class or not.
+     */
+    applyEventsDisabledClass(apply: boolean): this;
+    /**
+     * OPTIONAL. Will create a Material CDK-provided backdrop if set to true. Clicking on the backdrop will dismiss the backdrop and emit an event.
+     *
+     * @param hasBackdrop - Whether to show a backdrop or not.
+     */
+    hasBackdrop(hasBackdrop: boolean): this;
+    /**
+     * OPTIONAL. Sets CSS classes to apply to the tooltip panel.
+     *
+     * @param panelClass - CSS class name(s) to apply to the tooltip panel.
+     */
+    panelClass(panelClass: string | string[]): this;
+    /**
+     * Sets the origin and position of the tooltip based on the output from a BaseInteractionOutput.
+     *
+     * @param origin - The origin element reference.
+     * @param position - Optional position configuration. If not provided, the default position from the output will be used. Note that the output has several methods to return a position that can be used here.
+     */
+    positionFromOutput(output: InteractionOutput<unknown>, position?: HtmlTooltipCdkManagedPosition): this;
+    /**
+     * Sets whether the tooltip should be shown or not.
+     *
+     * @param show - Whether to show the tooltip or not.
+     */
+    show(show: boolean): this;
+    size(size: null): this;
+    size(size: (size: HtmlTooltipSizeBuilder) => void): this;
+    private initSizeBuilder;
+    getConfig(): HtmlTooltipConfig;
+    private validateBuilder;
+    private getPanelClasses;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VicHtmlTooltipConfigBuilder, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VicHtmlTooltipConfigBuilder>;
+}

package/lib/tooltips/html-tooltip/config/html-tooltip-config.d.ts

@@ -0,0 +1,15 @@
+import { ElementRef } from '@angular/core';
+import { Tooltip } from '../../config/tooltip';
+import { HtmlTooltipOptions } from './html-tooltip-options';
+import { HtmlTooltipCdkManagedPosition } from './position/tooltip-position';
+import { HtmlTooltipSize } from './size/tooltip-size';
+export declare class HtmlTooltipConfig extends Tooltip implements HtmlTooltipOptions {
+    type: 'html';
+    applyEventsDisabledClass: boolean;
+    hasBackdrop: boolean;
+    origin: ElementRef<Element>;
+    panelClass: string[];
+    position: HtmlTooltipCdkManagedPosition;
+    size: HtmlTooltipSize;
+    constructor(options: HtmlTooltipOptions);
+}

package/lib/tooltips/html-tooltip/config/html-tooltip-options.d.ts

@@ -0,0 +1,11 @@
+import { ElementRef } from '@angular/core';
+import { HtmlTooltipCdkManagedPosition } from './position/tooltip-position';
+import { HtmlTooltipSize } from './size/tooltip-size';
+export interface HtmlTooltipOptions {
+    hasBackdrop: boolean;
+    origin: ElementRef<Element>;
+    panelClass: string | string[];
+    position: HtmlTooltipCdkManagedPosition;
+    size: HtmlTooltipSize;
+    show: boolean;
+}

package/lib/tooltips/html-tooltip/config/position/tooltip-position-builder.d.ts

@@ -0,0 +1,34 @@
+import { ConnectedPosition } from '@angular/cdk/overlay';
+import { TooltipPosition } from './tooltip-position';
+export declare class TooltipPositionBuilder {
+    private originX?;
+    private originY?;
+    private overlayX;
+    private overlayY;
+    private currentOffsetX;
+    private currentOffsetY;
+    private additionalConfig;
+    fromTopLeft(): this;
+    fromTopCenter(): this;
+    fromTopRight(): this;
+    fromCenterLeft(): this;
+    fromCenter(): this;
+    fromCenterRight(): this;
+    fromBottomLeft(): this;
+    fromBottomCenter(): this;
+    fromBottomRight(): this;
+    attachTopLeft(): this;
+    attachTopCenter(): this;
+    attachTopRight(): this;
+    attachCenterLeft(): this;
+    attachCenter(): this;
+    attachCenterRight(): this;
+    attachBottomLeft(): this;
+    attachBottomCenter(): this;
+    attachBottomRight(): this;
+    offset(offsetX: number, offsetY: number): this;
+    withConfig(config: Partial<ConnectedPosition>): this;
+    getPosition(): TooltipPosition;
+    reset(): this;
+    applyOffsets(positions: TooltipPosition[], offsetX: number, offsetY: number): TooltipPosition[];
+}

package/lib/tooltips/html-tooltip/config/position/tooltip-position.d.ts

@@ -0,0 +1,23 @@
+import { ConnectedPosition, FlexibleConnectedPositionStrategy, OverlayPositionBuilder } from '@angular/cdk/overlay';
+export type TooltipPositionConfig = {
+    originX: 'start' | 'center' | 'end';
+    originY: 'top' | 'center' | 'bottom';
+    overlayX: 'start' | 'center' | 'end';
+    overlayY: 'top' | 'center' | 'bottom';
+};
+export declare class TooltipPosition implements ConnectedPosition {
+    originX: TooltipPositionConfig['originX'];
+    originY: TooltipPositionConfig['originY'];
+    overlayX: TooltipPositionConfig['overlayX'];
+    overlayY: TooltipPositionConfig['overlayY'];
+    weight?: number;
+    offsetX?: number;
+    offsetY?: number;
+    panelClass?: string | string[];
+    constructor(config: TooltipPositionConfig & Partial<ConnectedPosition>);
+}
+export declare class HtmlTooltipCdkManagedPosition {
+    positions: ConnectedPosition[];
+    constructor(positions: ConnectedPosition[]);
+    getPositionStrategy(origin: Element, overlayPositionBuilder: OverlayPositionBuilder): FlexibleConnectedPositionStrategy;
+}

package/lib/tooltips/html-tooltip/config/size/tooltip-size-builder.d.ts

@@ -0,0 +1,16 @@
+import { HtmlTooltipSize } from './tooltip-size';
+export declare class HtmlTooltipSizeBuilder {
+    _width: number | string;
+    _height: number | string;
+    _minWidth: number | string;
+    _minHeight: number | string;
+    _maxWidth: number | string;
+    _maxHeight: number | string;
+    width(width: number | string | null): this;
+    height(height: number | string | null): this;
+    minWidth(minWidth: number | string | null): this;
+    minHeight(minHeight: number | string | null): this;
+    maxWidth(maxWidth: number | string | null): this;
+    maxHeight(maxHeight: number | string | null): this;
+    _build(): HtmlTooltipSize;
+}

package/lib/tooltips/html-tooltip/config/size/tooltip-size-options.d.ts

@@ -0,0 +1,8 @@
+export interface HtmlTooltipSizeOptions {
+    width: number | string;
+    height: number | string;
+    minWidth: number | string;
+    minHeight: number | string;
+    maxWidth: number | string;
+    maxHeight: number | string;
+}

package/lib/tooltips/html-tooltip/config/size/tooltip-size.d.ts

@@ -0,0 +1,10 @@
+import { HtmlTooltipSizeOptions } from './tooltip-size-options';
+export declare class HtmlTooltipSize implements HtmlTooltipSizeOptions {
+    width: number | string;
+    height: number | string;
+    minWidth: number | string;
+    minHeight: number | string;
+    maxWidth: number | string;
+    maxHeight: number | string;
+    constructor(options: HtmlTooltipSizeOptions);
+}

package/lib/tooltips/html-tooltip/html-tooltip.directive.d.ts

@@ -0,0 +1,43 @@
+import { FlexibleConnectedPositionStrategy, GlobalPositionStrategy, Overlay, OverlayPositionBuilder, OverlayRef } from '@angular/cdk/overlay';
+import { TemplatePortal } from '@angular/cdk/portal';
+import { EventEmitter, OnChanges, OnDestroy, SimpleChanges, TemplateRef, ViewContainerRef } from '@angular/core';
+import { Subject } from 'rxjs';
+import { HtmlTooltipConfig } from './config/html-tooltip-config';
+import * as i0 from "@angular/core";
+export declare class HtmlTooltipDirective implements OnChanges, OnDestroy {
+    private viewContainerRef;
+    private overlay;
+    private overlayPositionBuilder;
+    private document;
+    template: TemplateRef<HTMLElement>;
+    config: HtmlTooltipConfig;
+    backdropClick: EventEmitter<void>;
+    backdropUnsubscribe: Subject<void>;
+    overlayRef: OverlayRef;
+    portalAttached: boolean;
+    positionStrategy: FlexibleConnectedPositionStrategy | GlobalPositionStrategy;
+    onKeydown: (event: KeyboardEvent) => void;
+    constructor(viewContainerRef: ViewContainerRef, overlay: Overlay, overlayPositionBuilder: OverlayPositionBuilder, document: Document);
+    init(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    createOverlayRef(): void;
+    setPositionStrategy(): void;
+    subscribeToBackdropClick(): void;
+    updateVisibility(): void;
+    subscribeToKeyboardEvents(): void;
+    unsubscribeFromKeyboardEvents(): void;
+    show(): void;
+    getTemplatePortal(): TemplatePortal;
+    hide(): void;
+    updateForConfigChanges(changes: SimpleChanges): void;
+    updatePositionStrategy(): void;
+    updateClasses(prevClass: string[]): void;
+    updateSize(): void;
+    updateBackdrop(): void;
+    configChanged(changes: SimpleChanges, property: keyof HtmlTooltipConfig): boolean;
+    ngOnDestroy(): void;
+    destroyBackdropSubscription(): void;
+    destroyOverlay(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HtmlTooltipDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<HtmlTooltipDirective, "vic-html-tooltip", never, { "template": { "alias": "template"; "required": false; }; "config": { "alias": "config"; "required": false; }; }, { "backdropClick": "backdropClick"; }, never, never, true, never>;
+}

package/lib/tooltips/html-tooltip/html-tooltip.module.d.ts

@@ -0,0 +1,10 @@
+import * as i0 from "@angular/core";
+import * as i1 from "@angular/common";
+import * as i2 from "@angular/cdk/overlay";
+import * as i3 from "./html-tooltip.directive";
+import * as i4 from "./tooltip-triangle/tooltip-triangle.component";
+export declare class VicHtmlTooltipModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<VicHtmlTooltipModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<VicHtmlTooltipModule, never, [typeof i1.CommonModule, typeof i2.OverlayModule, typeof i3.HtmlTooltipDirective, typeof i4.TooltipTriangleComponent], [typeof i3.HtmlTooltipDirective, typeof i4.TooltipTriangleComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<VicHtmlTooltipModule>;
+}

package/lib/tooltips/html-tooltip/tooltip-triangle/tooltip-triangle.component.d.ts

@@ -0,0 +1,7 @@
+import * as i0 from "@angular/core";
+export declare class TooltipTriangleComponent {
+    height: number;
+    width: number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TooltipTriangleComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TooltipTriangleComponent, "vic-tooltip-triangle", never, { "height": { "alias": "height"; "required": false; }; "width": { "alias": "width"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/tooltips/index.d.ts

@@ -0,0 +1,11 @@
+export * from './html-tooltip/config/html-tooltip-builder';
+export * from './html-tooltip/config/html-tooltip-config';
+export * from './html-tooltip/config/html-tooltip-options';
+export * from './html-tooltip/config/position/tooltip-position';
+export * from './html-tooltip/config/position/tooltip-position-builder';
+export * from './html-tooltip/config/size/tooltip-size';
+export * from './html-tooltip/config/size/tooltip-size-builder';
+export * from './html-tooltip/config/size/tooltip-size-options';
+export * from './html-tooltip/html-tooltip.directive';
+export * from './html-tooltip/html-tooltip.module';
+export * from './html-tooltip/tooltip-triangle/tooltip-triangle.component';

package/lib/xy-background/index.d.ts

@@ -0,0 +1,2 @@
+export * from './xy-background.component';
+export * from './xy-background.module';

package/lib/xy-background/xy-background.component.d.ts

@@ -0,0 +1,9 @@
+import { XyChartComponent } from '../charts/xy-chart/xy-chart.component';
+import * as i0 from "@angular/core";
+export declare class XyBackgroundComponent {
+    chart: XyChartComponent;
+    color: string;
+    constructor(chart: XyChartComponent);
+    static ɵfac: i0.ɵɵFactoryDeclaration<XyBackgroundComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<XyBackgroundComponent, "[vic-xy-background]", never, { "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/xy-background/xy-background.module.d.ts

@@ -0,0 +1,7 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./xy-background.component";
+export declare class VicXyBackgroundModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<VicXyBackgroundModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<VicXyBackgroundModule, never, [typeof i1.XyBackgroundComponent], [typeof i1.XyBackgroundComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<VicXyBackgroundModule>;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@mathstack/viz",
+  "license": "MIT",
+  "peerDependencies": {
+    "@angular/cdk": "^19.2.6",
+    "@angular/common": "^19.2.2",
+    "@angular/core": "^19.2.2",
+    "@mathstack/app-kit": "^1.2.1",
+    "csstype": "^3.1.3",
+    "d3": "^7.6.1",
+    "file-saver": "^2.0.5",
+    "html-to-image": "1.11.11",
+    "lodash-es": "^4.17.21",
+    "papaparse": "^5.3.2",
+    "polylabel": "^1.1.0",
+    "rxjs": "^7.5.0",
+    "topojson-client": "^3.1.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "version": "1.0.0",
+  "module": "fesm2022/mathstack-viz.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/mathstack-viz.mjs"
+    }
+  },
+  "sideEffects": false
+}

package/public-api.d.ts

@@ -0,0 +1,23 @@
+export * from './lib/axes/index';
+export * from './lib/bars/index';
+export * from './lib/charts/index';
+export * from './lib/core/index';
+export * from './lib/data-dimensions/index';
+export * from './lib/data-export/index';
+export * from './lib/dots/index';
+export * from './lib/events/index';
+export * from './lib/fill-definitions/index';
+export * from './lib/geographies/index';
+export * from './lib/grouped-bars/index';
+export * from './lib/image-download/index';
+export * from './lib/lines/index';
+export * from './lib/map-legend/index';
+export * from './lib/marks/index';
+export * from './lib/point-markers/index';
+export * from './lib/quantitative-rules/index';
+export * from './lib/stacked-area/index';
+export * from './lib/stacked-bars/index';
+export * from './lib/stroke/index';
+export * from './lib/svg-text-wrap/index';
+export * from './lib/tooltips/index';
+export * from './lib/xy-background/index';