{ "$schema": "https://uipkge.dev/schema/registry-item.json", "name": "bullet-chart", "title": "Bullet Chart", "type": "registry:ui", "files": [ { "path": "packages/registry-svelte/components/bullet-chart/BulletChart.svelte", "content": "\n\n\n\n\n\n

\n\n", "type": "registry:ui", "target": "~/src/lib/components/ui/bullet-chart/BulletChart.svelte" }, { "path": "packages/registry-svelte/components/bullet-chart/chart-theme.ts", "content": "/**\n * Chart palette driven by Tailwind v4 CSS variables (`--chart-1`..`--chart-5`,\n * `--muted-foreground`, `--border`, `--popover`, etc.) so dark/light flips\n * happen automatically when the consumer toggles their theme class. Values\n * resolve at runtime via `getComputedStyle`, so they pick up whatever the\n * consumer set in their own `tailwind.css` -- no fork required.\n *\n * Svelte port of the Vue twin's `useChartTheme.ts`. The Vue version exposes\n * `computed` refs bumped by a module-level `themeKey`; here the component\n * owns a `themeKey` state (bumped by a `MutationObserver` on ``) and\n * calls `getChartTheme()` inside a `$derived` -- same re-paint semantics.\n */\n\n// ECharts' canvas renderer does not accept OKLCH in every browser. Assigning\n// one of our Tailwind tokens to `fillStyle` can silently leave the sentinel\n// colour in place, turning a whole chart black. Convert OKLCH ourselves and\n// let the canvas normalize older CSS colour formats.\nlet _hexCanvas: CanvasRenderingContext2D | null = null\n\nexport function toCanvasColor(cssColor: string): string {\n const value = cssColor.trim()\n const match = value.match(\n /^oklch\$\\s*([+-]?(?:\\d+\\.?\\d*|\\.\\d+))(%?)\\s+([+-]?(?:\\d+\\.?\\d*|\\.\\d+))\\s+([+-]?(?:\\d+\\.?\\d*|\\.\\d+))(?:deg)?(?:\\s*\\/\\s*([+-]?(?:\\d+\\.?\\d*|\\.\\d+))(%?))?\\s*\$$/i,\n )\n\n if (match) {\n const lightness = Number(match[1]) / (match[2] === '%' ? 100 : 1)\n const chroma = Number(match[3])\n const hue = (Number(match[4]) * Math.PI) / 180\n const alpha = match[5] == null ? 1 : Number(match[5]) / (match[6] === '%' ? 100 : 1)\n const a = chroma * Math.cos(hue)\n const b = chroma * Math.sin(hue)\n\n const l = Math.pow(lightness + 0.3963377774 * a + 0.2158037573 * b, 3)\n const m = Math.pow(lightness - 0.1055613458 * a - 0.0638541728 * b, 3)\n const s = Math.pow(lightness - 0.0894841775 * a - 1.291485548 * b, 3)\n const linear = [\n 4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,\n -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,\n -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s,\n ]\n const rgb = linear.map((channel) => {\n const encoded = channel <= 0.0031308 ? 12.92 * channel : 1.055 * Math.pow(channel, 1 / 2.4) - 0.055\n return Math.round(Math.min(1, Math.max(0, encoded)) * 255)\n })\n\n return alpha < 1 ? `rgba(${rgb.join(', ')}, ${alpha})` : `rgb(${rgb.join(', ')})`\n }\n\n if (typeof document === 'undefined') return cssColor\n if (!_hexCanvas) {\n _hexCanvas = document.createElement('canvas').getContext('2d')\n }\n if (!_hexCanvas) return cssColor\n _hexCanvas.fillStyle = '#010203'\n _hexCanvas.fillStyle = value\n const normalized = _hexCanvas.fillStyle as string\n return normalized === '#010203' && value.toLowerCase() !== '#010203' ? value : normalized\n}\n\n// Convert any CSS color (hex, rgb, oklch, color()) + alpha 0..1 to a\n// canvas-safe rgba(r,g,b,a). `colorString + '40'` (8-digit hex alpha)\n// only works when `colorString` is `#rrggbb`; once tokens resolve to\n// oklch() post-hydration the gradient stops break and the canvas paint\n// throws every frame. Stay defensive and always return rgba.\nexport function toRgba(cssColor: string, alpha: number): string {\n const normalized = toCanvasColor(cssColor)\n if (normalized.startsWith('#') && normalized.length === 7) {\n const r = parseInt(normalized.slice(1, 3), 16)\n const g = parseInt(normalized.slice(3, 5), 16)\n const b = parseInt(normalized.slice(5, 7), 16)\n return `rgba(${r},${g},${b},${alpha})`\n }\n if (normalized.startsWith('rgba(')) {\n return normalized.replace(/,\\s*[\\d.]+\\s*\\)$/, `,${alpha})`)\n }\n if (normalized.startsWith('rgb(')) {\n return normalized.replace(/^rgb\$/, 'rgba(').replace(/\$$/, `,${alpha})`)\n }\n // Canvas refused to parse this color -- ship the original string and\n // let ECharts complain (better than crashing the paint loop).\n return cssColor\n}\n\nfunction resolveVar(name: string, fallback: string): string {\n if (typeof window === 'undefined') return fallback\n const v = getComputedStyle(document.documentElement).getPropertyValue(name).trim()\n if (!v) return fallback\n return toCanvasColor(v)\n}\n\n// SSR / pre-hydration fallback palette. Hex values picked to roughly\n// match the shadcn Neutral defaults in `tailwind.css` so the first paint\n// doesn't flicker.\nconst CHART_FALLBACK = ['#f59e0b', '#14b8a6', '#3b82f6', '#f97316', '#eab308']\n\nexport interface ChartTheme {\n colors: string[]\n textColor: string\n axisColor: string\n splitLineColor: string\n tooltipBg: string\n tooltipBorder: string\n tooltipText: string\n bgColor: string\n /** The app's accent, for the one highlighted element on a chart or map. */\n accentColor: string\n /** Out-of-bounds / failure colour for charts encoding good vs bad. */\n dangerColor: string\n}\n\n/** Resolve the full theme snapshot. Call inside a `$derived` keyed on a state bumped by theme changes. */\nexport function getChartTheme(): ChartTheme {\n return {\n colors: Array.from({ length: 5 }, (_, i) => resolveVar(`--chart-${i + 1}`, CHART_FALLBACK[i]!)),\n textColor: resolveVar('--muted-foreground', '#888888'),\n axisColor: resolveVar('--border', '#e5e5e5'),\n splitLineColor: resolveVar('--border', '#f0f0f0'),\n tooltipBg: resolveVar('--popover', 'rgba(255,255,255,0.96)'),\n tooltipBorder: resolveVar('--border', '#e5e5e5'),\n tooltipText: resolveVar('--popover-foreground', '#333333'),\n bgColor: resolveVar('--card', resolveVar('--background', '#ffffff')),\n accentColor: resolveVar('--primary', '#38bdf8'),\n dangerColor: resolveVar('--destructive', '#dc2626'),\n }\n}\n\n// Two-level deep merge for ECharts option blocks (xAxis, yAxis, grid,\n// tooltip, legend, singleAxis, parallel, etc.). The top-level keys merge\n// shallowly, but one nested level (axisLabel, axisLine, splitLine, etc.)\n// merges shallowly too so a consumer passing `xAxis: { axisLabel: { fontSize: 9 } }`\n// doesn't blow away the wrapper's `color` + base font defaults on the same\n// axisLabel block. Arrays + primitives replace outright.\n//\n// This is the merge strategy the chart wrappers use to fold `props.option`\n// onto their computed base option without forcing consumers to spell out\n// every default they want to preserve.\nexport function mergeOptionBlock>(base: T, user: Partial | undefined): T {\n if (!user) return base\n const out: any = { ...base }\n for (const k of Object.keys(user)) {\n const bv = (base as any)[k]\n const uv = (user as any)[k]\n if (\n bv != null &&\n uv != null &&\n typeof bv === 'object' &&\n typeof uv === 'object' &&\n !Array.isArray(bv) &&\n !Array.isArray(uv)\n ) {\n out[k] = { ...bv, ...uv }\n } else {\n out[k] = uv\n }\n }\n return out\n}\n\n// Default gauge stoplight: teal (safe) -> amber (warning) -> red (danger).\n// Pulled off saturated green and onto teal so the gauge ties back to the\n// dashboard palette; red is kept as the universal \"limit reached\" cue.\n// GaugeChart consumes this via its `thresholds` prop default; consumers\n// pass their own array to override. Static because gauges have semantic\n// meaning (green safe / red danger) that we deliberately don't theme-flip.\nexport const gaugeThresholds: [number, string][] = [\n [0.6, '#14b8a6'],\n [0.85, '#f59e0b'],\n [1, '#dc2626'],\n]\n\nexport function heightToStyle(height: number | string): string {\n return /^\\d+$/.test(String(height)) ? `${height}px` : String(height)\n}\n", "type": "registry:ui", "target": "~/src/lib/components/ui/bullet-chart/chart-theme.ts" }, { "path": "packages/registry-svelte/components/bullet-chart/index.ts", "content": "export { default as BulletChart, type BulletChartProps, type BulletDatum } from './BulletChart.svelte'\n", "type": "registry:ui", "target": "~/src/lib/components/ui/bullet-chart/index.ts" } ], "dependencies": [ "echarts" ], "devDependencies": [], "registryDependencies": [], "description": "Bullet chart for KPI vs target around Apache ECharts. Qualitative background bands, a foreground actual bar, and a target marker per row. Theme-aware via registry tokens.", "categories": [ "chart" ] }