@xplortech/apollo-data 0.0.4 → 0.0.6

package/dist/collection/components/apollo-data-heat-map/apollo-data-heat-map.js

@@ -0,0 +1,208 @@
+import { h, Host } from "@stencil/core";
+import { ApolloBase } from "../../apollo-data-base";
+export class ApolloDataHeatMap extends ApolloBase {
+    constructor() {
+        super();
+    }
+    el = null;
+    /**
+     * Data for the heat map. Each item defines a cell by xLabel, yLabel, and value.
+     * @property {string} xLabel - Label for the X-axis (horizontal).
+     * @property {string} yLabel - Label for the Y-axis (vertical).
+     * @property {number} value - Numeric value encoded as color.
+     */
+    adData = [];
+    /**
+     * Optional specification for axis titles, color range, and tooltip behavior.
+     * @property {string} [xAxisTitle] - Label for the X-axis.
+     * @property {string} [yAxisTitle] - Label for the Y-axis.
+     * @property {string[]} [colorRange] - Two or more colors for the value scale (Vega interpolates between them).
+     * @property {'auto' | 'none'} [tooltip] - Tooltip behavior.
+     */
+    adSpec = {};
+    async componentDidRender() {
+        await this.renderChart();
+    }
+    DEFAULT_COLOR_RANGE = ['#e8f4f8', '#0066a1'];
+    // @ts-ignore
+    async getViewData(data, spec) {
+        const rawRange = spec?.colorRange;
+        const colorRange = Array.isArray(rawRange) && rawRange.length >= 2 ? rawRange : this.DEFAULT_COLOR_RANGE;
+        const tooltip = spec?.tooltip !== 'none';
+        const valid = data.filter(d => d != null && typeof d.xLabel === 'string' && typeof d.yLabel === 'string' && d.xLabel !== '' && d.yLabel !== '' && typeof d.value === 'number');
+        const xLabels = [...new Set(valid.map(d => d.xLabel))];
+        const yLabels = [...new Set(valid.map(d => d.yLabel))];
+        return {
+            $schema: 'https://vega.github.io/schema/vega/v6.json',
+            description: 'A heat map with xLabel and yLabel categories and value encoded as color.',
+            width: 450,
+            height: 350,
+            padding: { left: 5, top: 5, bottom: 5, right: 70 },
+            autosize: { type: 'fit', resize: true },
+            data: [
+                {
+                    name: 'source',
+                    values: valid,
+                },
+            ],
+            scales: [
+                {
+                    name: 'xscale',
+                    type: 'band',
+                    range: [0, { signal: 'width' }],
+                    domain: xLabels,
+                    padding: 0.05,
+                },
+                {
+                    name: 'yscale',
+                    type: 'band',
+                    range: [{ signal: 'height' }, 0],
+                    domain: yLabels,
+                    padding: 0.05,
+                },
+                {
+                    name: 'color',
+                    type: 'sequential',
+                    range: colorRange,
+                    domain: { data: 'source', field: 'value' },
+                    zero: true,
+                },
+            ],
+            axes: [
+                {
+                    orient: 'bottom',
+                    scale: 'xscale',
+                    title: spec?.xAxisTitle ?? 'X',
+                    labelAngle: -90,
+                    labelAlign: 'right',
+                },
+                {
+                    orient: 'left',
+                    scale: 'yscale',
+                    title: spec?.yAxisTitle ?? 'Y',
+                },
+            ],
+            legends: [
+                {
+                    type: 'gradient',
+                    fill: 'color',
+                    orient: 'right',
+                    direction: 'vertical',
+                    title: 'Value',
+                    titleLimit: 120,
+                    tickCount: 5,
+                    format: 's',
+                },
+            ],
+            marks: [
+                {
+                    type: 'rect',
+                    from: { data: 'source' },
+                    encode: {
+                        ...(tooltip && {
+                            enter: {
+                                tooltip: {
+                                    signal: "datum.xLabel + ' | ' + datum.yLabel + ' | ' + format(datum.value, ',.2f')",
+                                },
+                            },
+                        }),
+                        update: {
+                            x: { scale: 'xscale', field: 'xLabel' },
+                            y: { scale: 'yscale', field: 'yLabel' },
+                            width: { scale: 'xscale', band: 1 },
+                            height: { scale: 'yscale', band: 1 },
+                            fill: { scale: 'color', field: 'value' },
+                        },
+                        hover: {
+                            fill: { value: 'firebrick' },
+                            opacity: { value: 0.8 },
+                        },
+                    },
+                },
+            ],
+        };
+    }
+    render() {
+        return (h(Host, { key: 'd15b44f268f153498e61dc7829fe0d45f315a992' }, h("div", { key: '7783444f4675c885980f1cd571737d506e00fdbc', id: "container", style: { width: '100%', height: '100%' } })));
+    }
+    static get is() { return "apollo-data-heat-map"; }
+    static get encapsulation() { return "shadow"; }
+    static get properties() {
+        return {
+            "adData": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string | HeatMapDataItem[]",
+                    "resolved": "HeatMapDataItem[] | string",
+                    "references": {
+                        "HeatMapDataItem": {
+                            "location": "local",
+                            "path": "/home/runner/work/apollo/apollo/packages/apollo-data/src/components/apollo-data-heat-map/apollo-data-heat-map.tsx",
+                            "id": "src/components/apollo-data-heat-map/apollo-data-heat-map.tsx::HeatMapDataItem"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "property",
+                            "text": "{string} xLabel - Label for the X-axis (horizontal)."
+                        }, {
+                            "name": "property",
+                            "text": "{string} yLabel - Label for the Y-axis (vertical)."
+                        }, {
+                            "name": "property",
+                            "text": "{number} value - Numeric value encoded as color."
+                        }],
+                    "text": "Data for the heat map. Each item defines a cell by xLabel, yLabel, and value."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "ad-data",
+                "defaultValue": "[]"
+            },
+            "adSpec": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string | HeatMapSpec",
+                    "resolved": "HeatMapSpec | string",
+                    "references": {
+                        "HeatMapSpec": {
+                            "location": "local",
+                            "path": "/home/runner/work/apollo/apollo/packages/apollo-data/src/components/apollo-data-heat-map/apollo-data-heat-map.tsx",
+                            "id": "src/components/apollo-data-heat-map/apollo-data-heat-map.tsx::HeatMapSpec"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "property",
+                            "text": "{string} [xAxisTitle] - Label for the X-axis."
+                        }, {
+                            "name": "property",
+                            "text": "{string} [yAxisTitle] - Label for the Y-axis."
+                        }, {
+                            "name": "property",
+                            "text": "{string[]} [colorRange] - Two or more colors for the value scale (Vega interpolates between them)."
+                        }, {
+                            "name": "property",
+                            "text": "{'auto' | 'none'} [tooltip] - Tooltip behavior."
+                        }],
+                    "text": "Optional specification for axis titles, color range, and tooltip behavior."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "ad-spec",
+                "defaultValue": "{}"
+            }
+        };
+    }
+    static get elementRef() { return "el"; }
+}

package/dist/collection/components/apollo-data-heat-map/apollo-data-heat-map.stories.js

@@ -0,0 +1,137 @@
+import { html } from "lit-html";
+import { generateReactCode, generateVueCode, generateWebComponentCode, generateInstallationDocs } from "../../utils/code-generator";
+import { heatMapExamples } from "../../examples/apollo-data-heat-map.examples";
+function getCodeForFramework(props, framework) {
+    switch (framework) {
+        case 'vue':
+            return generateVueCode('apollo-data-heat-map', props);
+        case 'webcomponent':
+            return generateWebComponentCode('apollo-data-heat-map', props);
+        case 'react':
+        default:
+            return generateReactCode('apollo-data-heat-map', props);
+    }
+}
+const meta = {
+    title: 'Apollo Data/Heat Map',
+    tags: ['autodocs'],
+    argTypes: {
+        adData: {
+            control: 'object',
+            description: 'Array of data items. Each item defines a cell by xLabel, yLabel, and value (value is encoded as color).',
+            table: {
+                type: {
+                    summary: 'HeatMapDataItem[]',
+                    detail: 'interface HeatMapDataItem {\n  xLabel: string;\n  yLabel: string;\n  value: number;\n}',
+                },
+                defaultValue: { summary: '[]' },
+            },
+        },
+        adSpec: {
+            control: 'object',
+            description: 'Optional specification for axis titles, color range, and tooltip behavior.',
+            table: {
+                type: {
+                    summary: 'HeatMapSpec',
+                    detail: `interface HeatMapSpec {
+  xAxisTitle?: string;
+  yAxisTitle?: string;
+  colorRange?: string[];
+  tooltip?: 'auto' | 'none';
+}`,
+                },
+                defaultValue: { summary: '{}' },
+            },
+        },
+    },
+    decorators: [
+        (story, context) => {
+            const framework = context.globals?.framework || 'react';
+            setTimeout(() => {
+                const doc = globalThis.document;
+                if (doc) {
+                    const installSections = {
+                        react: doc.querySelector('.install-react'),
+                        vue: doc.querySelector('.install-vue'),
+                        webcomponent: doc.querySelector('.install-webcomponent'),
+                    };
+                    Object.values(installSections).forEach((section) => {
+                        if (section) {
+                            section.setAttribute('style', 'display: none;');
+                        }
+                    });
+                    const selectedSection = installSections[framework];
+                    if (selectedSection) {
+                        selectedSection.setAttribute('style', 'display: block;');
+                    }
+                }
+            }, 0);
+            return story();
+        },
+    ],
+    parameters: {
+        docs: {
+            description: {
+                component: `${generateInstallationDocs('react', 'apollo-data-heat-map')}
+
+${generateInstallationDocs('vue', 'apollo-data-heat-map')}
+
+${generateInstallationDocs('webcomponent', 'apollo-data-heat-map')}
+
+---
+
+## Description
+
+A Heat Map visualizes values in a matrix of rows and columns using color. Each cell is defined by a row category, a column category, and a numeric value that is encoded on a color scale.
+
+**Tip:** Use the Framework selector in the toolbar above to switch between React, Vue, and Web Component installation instructions and code examples.`,
+            },
+        },
+        viewMode: 'story',
+    },
+};
+export default meta;
+const chartWrapper = (args) => html `
+  <div style="width: 640px; height: 380px;">
+    <apollo-data-heat-map .adData=${args.adData} .adSpec=${args.adSpec}></apollo-data-heat-map>
+  </div>
+`;
+const sharedParams = {
+    codeGenerator: (args, framework) => getCodeForFramework(args, framework),
+    docs: {
+        source: {
+            language: 'tsx',
+            type: 'dynamic',
+            transform: (_code, storyContext) => {
+                try {
+                    const framework = storyContext?.globals?.framework || 'react';
+                    const props = {
+                        adData: storyContext?.args?.adData || [],
+                        adSpec: storyContext?.args?.adSpec || {},
+                    };
+                    return getCodeForFramework(props, framework);
+                }
+                catch (error) {
+                    console.error('Error in transform function:', error);
+                    return `<apollo-data-heat-map />`;
+                }
+            },
+        },
+    },
+};
+export const WeatherDayVsMonth = {
+    args: {
+        adData: heatMapExamples[0].props.adData,
+        adSpec: heatMapExamples[0].props.adSpec || {},
+    },
+    render: chartWrapper,
+    parameters: {
+        ...sharedParams,
+        docs: {
+            description: {
+                story: 'Average high temperature (°F) by day of month and month. Blue = cooler, red = warmer.',
+            },
+            ...sharedParams.docs,
+        },
+    },
+};

package/dist/collection/components/apollo-data-line/apollo-data-line.js

@@ -0,0 +1,348 @@
+import { h, Host } from "@stencil/core";
+import { ApolloBase } from "../../apollo-data-base";
+import { CHART_COLORS } from "../../utils/constants";
+const FONT_FAMILY = "apple-system, system-ui, 'Segoe UI', Arial, Helvetica, Roboto, sans-serif";
+function lineStyleToStrokeDash(lineStyle) {
+    switch (lineStyle) {
+        case 'dashed':
+            return [6, 4];
+        case 'dotted':
+            return [2, 2];
+        case 'solid':
+        default:
+            return [];
+    }
+}
+export class ApolloDataLineChart extends ApolloBase {
+    constructor() {
+        super();
+    }
+    el = null;
+    adData = [];
+    adSpec = null;
+    static tooltipStylesInjected = false;
+    componentDidLoad() {
+        this.injectTooltipStyles();
+    }
+    async componentDidRender() {
+        await this.renderChart();
+    }
+    injectTooltipStyles() {
+        const chartClass = this.constructor;
+        if (chartClass.tooltipStylesInjected) {
+            return;
+        }
+        const styleId = 'apollo-data-line-tooltip-styles';
+        if (document.getElementById(styleId)) {
+            chartClass.tooltipStylesInjected = true;
+            return;
+        }
+        const style = document.createElement('style');
+        style.id = styleId;
+        style.textContent = `
+      #vg-tooltip-element {
+        background-color: #ffffff;
+        border: 1px solid #e1e2e8;
+        border-radius: 0.25rem;
+        box-shadow: 0 4px 6px -1px rgba(48, 45, 59, 0.1), 0 2px 4px -1px rgba(48, 45, 59, 0.05);
+        font-family: apple-system, system-ui, 'Segoe UI', Arial, Helvetica, Roboto, sans-serif;
+        font-weight: 500;
+        padding: 0.25rem 0.75rem;
+        pointer-events: none;
+        text-align: center;
+        transform: translateY(20%);
+        white-space: pre;
+        z-index: 999999999;
+      }
+
+      #vg-tooltip-element table tr td.key {
+        color: #6a6d7d;
+        text-align: center;
+      }
+
+      #vg-tooltip-element table tr td.value {
+        text-align: center;
+      }
+
+      #vg-tooltip-element.dark-theme {
+        background-color: #292632;
+        border: 1px solid #6a6d7d;
+        box-shadow: 0 4px 6px -1px rgba(48, 45, 59, 0.1), 0 2px 4px -1px rgba(48, 45, 59, 0.5);
+        color: #ffffff;
+      }
+
+      #vg-tooltip-element::after {
+        border-color: rgba(255, 255, 255, 0.95) transparent transparent transparent;
+        border-style: solid;
+        border-width: 9px;
+        bottom: -17px;
+        content: '';
+        left: 50%;
+        position: absolute;
+        transform: translateX(-50%);
+      }
+    `;
+        document.head.appendChild(style);
+        chartClass.tooltipStylesInjected = true;
+    }
+    // @ts-ignore
+    async getViewData(data, spec) {
+        const componentTag = this.el?.tagName?.toLowerCase() ?? 'apollo-data-line-chart';
+        if (!spec) {
+            throw new Error(`adSpec is required for ${componentTag}`);
+        }
+        const { tooltipPrefix = '', currencySymbol = '' } = spec;
+        if (!data || data.length === 0) {
+            throw new Error(`Data is required for ${componentTag}`);
+        }
+        const uniqueCategories = Array.from(new Set(data.map(item => item.category)));
+        const uniqueXValues = [...new Set(data.map(item => item.xValue))].sort((a, b) => a - b);
+        const colorSet = spec?.colorSet ?? CHART_COLORS;
+        const xLabelData = uniqueXValues.map(x => {
+            const first = data.find(d => d.xValue === x);
+            return { xValue: x, displayLabel: first?.xLabel != null ? first.xLabel : String(x) };
+        });
+        const formatNumber = tooltipPrefix ? '.2f' : '.0f';
+        const currencyPrefix = tooltipPrefix ? currencySymbol : '';
+        const pointShape = spec.pointStyle ?? 'circle';
+        const strokeDash = lineStyleToStrokeDash(spec.lineStyle ?? 'solid');
+        const dataSpec = [
+            { name: 'raw', values: data },
+            { name: 'xLabelData', values: xLabelData },
+        ];
+        uniqueCategories.forEach((cat, i) => {
+            dataSpec.push({
+                name: `series_${i}`,
+                source: 'raw',
+                transform: [
+                    { type: 'filter', expr: `datum.category === ${JSON.stringify(cat)}` },
+                    { type: 'collect', sort: { field: 'xValue' } },
+                ],
+            });
+        });
+        const lineMarks = uniqueCategories.map((_, i) => ({
+            type: 'line',
+            from: { data: `series_${i}` },
+            encode: {
+                enter: {
+                    x: { scale: 'x', field: 'xValue' },
+                    y: { scale: 'y', field: 'yValue' },
+                    stroke: { value: colorSet[i % colorSet.length] },
+                    strokeWidth: { value: 2 },
+                    interpolate: { value: 'monotone' },
+                    ...(strokeDash.length > 0 ? { strokeDash: { value: strokeDash } } : {}),
+                },
+            },
+        }));
+        return {
+            $schema: 'https://vega.github.io/schema/vega/v5.json',
+            config: {
+                text: {
+                    fill: '#6a6d7d',
+                    font: FONT_FAMILY,
+                    labelFontSize: 12,
+                    labelFontWeight: 400,
+                },
+                axis: {
+                    labelColor: '#6a6d7d',
+                    titleColor: '#6a6d7d',
+                    labelFont: FONT_FAMILY,
+                    titleFont: FONT_FAMILY,
+                    titleFontWeight: 400,
+                },
+                legend: {
+                    labelColor: '#6a6d7d',
+                    titleColor: '#6a6d7d',
+                    labelFont: FONT_FAMILY,
+                    titleFont: FONT_FAMILY,
+                    labelFontSize: 12,
+                    labelLimit: 95,
+                },
+                title: {
+                    color: '#6a6d7d',
+                    font: FONT_FAMILY,
+                    labelFontSize: 12,
+                    labelFontWeight: 400,
+                },
+            },
+            height: 250,
+            autosize: { type: 'fit-x', contains: 'padding', resize: true },
+            signals: [
+                {
+                    name: 'containerW',
+                    update: 'max(containerSize()[0], 400)',
+                },
+                {
+                    name: 'legendColumns',
+                    update: 'ceil(containerW / 140)',
+                },
+            ],
+            width: { signal: 'containerW' },
+            data: dataSpec,
+            scales: [
+                {
+                    name: 'x',
+                    type: 'point',
+                    domain: uniqueXValues,
+                    range: 'width',
+                    padding: 0.5,
+                },
+                {
+                    name: 'xLabels',
+                    type: 'ordinal',
+                    domain: { data: 'xLabelData', field: 'xValue' },
+                    range: { data: 'xLabelData', field: 'displayLabel' },
+                },
+                {
+                    name: 'y',
+                    type: 'linear',
+                    domain: { data: 'raw', field: 'yValue' },
+                    nice: true,
+                    zero: true,
+                    range: 'height',
+                },
+                {
+                    name: 'color',
+                    type: 'ordinal',
+                    domain: uniqueCategories,
+                    range: spec?.colorSet ?? CHART_COLORS,
+                },
+            ],
+            axes: [
+                {
+                    orient: 'bottom',
+                    scale: 'x',
+                    title: spec?.xAxisTitle,
+                    labelPadding: 12,
+                    titlePadding: 12,
+                    labelAngle: -90,
+                    labelAlign: 'right',
+                    labelBaseline: 'middle',
+                    tickSize: 3,
+                    labelFontSize: 12,
+                    titleFontSize: 14,
+                    ticks: false,
+                    domain: false,
+                    encode: {
+                        labels: {
+                            update: {
+                                text: { signal: "scale('xLabels', datum.value)" },
+                            },
+                        },
+                    },
+                },
+                {
+                    orient: 'left',
+                    scale: 'y',
+                    title: spec?.yAxisTitle || '',
+                    format: ',.0f',
+                    grid: true,
+                    tickCount: 6,
+                    labelFontSize: 12,
+                    titleFontSize: 14,
+                    ticks: false,
+                    domain: false,
+                    tickBand: 'extent',
+                    labelPadding: 10,
+                },
+            ],
+            legends: [
+                {
+                    stroke: 'color',
+                    orient: 'bottom',
+                    direction: 'horizontal',
+                    columns: { signal: 'legendColumns' },
+                    title: null,
+                    symbolType: 'stroke',
+                    symbolStrokeWidth: 3,
+                    rowPadding: 8,
+                    symbolOffset: -35,
+                    symbolSize: 100,
+                    labelOffset: 8,
+                    labelLimit: 95,
+                },
+            ],
+            marks: [
+                ...lineMarks,
+                {
+                    type: 'symbol',
+                    from: { data: 'raw' },
+                    encode: {
+                        enter: {
+                            x: { scale: 'x', field: 'xValue' },
+                            y: { scale: 'y', field: 'yValue' },
+                            fill: { scale: 'color', field: 'category' },
+                            size: { value: 50 },
+                            shape: { value: pointShape },
+                            tooltip: {
+                                signal: `(datum.xLabel != null ? datum.xLabel : format(datum.xValue, ',.0f')) + ' · ' + datum.category + ': ' + (datum.yLabel != null ? datum.yLabel : '${currencyPrefix}' + format(datum.yValue, ',${formatNumber}'))`,
+                            },
+                        },
+                    },
+                },
+            ],
+        };
+    }
+    render() {
+        return (h(Host, { key: 'fd64f4abb624b14a878808b23345910c9b23a72c' }, h("div", { key: 'aeda5086730862ca1368a0374caf2d918969839d', id: "container", style: { width: '100%', height: '100%' } })));
+    }
+    static get is() { return "apollo-data-line-chart"; }
+    static get encapsulation() { return "shadow"; }
+    static get properties() {
+        return {
+            "adData": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string | LineDataItem[]",
+                    "resolved": "LineDataItem[] | string",
+                    "references": {
+                        "LineDataItem": {
+                            "location": "local",
+                            "path": "/home/runner/work/apollo/apollo/packages/apollo-data/src/components/apollo-data-line/apollo-data-line.tsx",
+                            "id": "src/components/apollo-data-line/apollo-data-line.tsx::LineDataItem"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "ad-data",
+                "defaultValue": "[]"
+            },
+            "adSpec": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string | LineSpec",
+                    "resolved": "LineSpec | string",
+                    "references": {
+                        "LineSpec": {
+                            "location": "local",
+                            "path": "/home/runner/work/apollo/apollo/packages/apollo-data/src/components/apollo-data-line/apollo-data-line.tsx",
+                            "id": "src/components/apollo-data-line/apollo-data-line.tsx::LineSpec"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "ad-spec",
+                "defaultValue": "null"
+            }
+        };
+    }
+    static get elementRef() { return "el"; }
+}