@ktnpm_devops/react-component 0.13.0 → 0.13.1

package/dist/index99.js.map

@@ -1 +1 @@
-{"version":3,"file":"index99.js","sources":["../src/geo/GeoMapCard/buildMarkerStyle.ts"],"sourcesContent":["import { CHART_COLORS, GEO_MAP } from '../../constants';\nimport { orbitTokens } from '../../tokens/tokens';\nimport type { ThemeMode } from '../../hooks/useThemeMode';\nimport type { GeoLegendItem, GeoPoint } from '../../types/geo.types';\n\n/**\n * Leaflet draws its markers as SVG paths, out of reach of the CSS custom\n * properties, so colours are resolved here as hex — the same exception the\n * ECharts family makes. Everything styled with CSS still uses the tokens.\n */\nexport interface MarkerStyle {\n  radius: number;\n  /** Stroke colour. */\n  color: string;\n  /** Stroke width. */\n  weight: number;\n  fillColor: string;\n  fillOpacity: number;\n}\n\n/** Weight range actually present in the data, or `null` when it carries none. */\nexport interface WeightScale {\n  min: number;\n  max: number;\n}\n\nexport interface MarkerStyleOptions {\n  categoryColors: Map<string, string>;\n  weightScale: WeightScale | null;\n  selected: boolean;\n  theme: ThemeMode;\n}\n\n/** Ring drawn around a selected marker: maximum contrast against the basemap. */\nconst SELECTION_RING: Record<ThemeMode, string> = {\n  light: orbitTokens.purple.base,\n  dark: '#FFFFFF',\n};\n\n/** Colour used when no point carries a category. */\nconst UNCATEGORISED_COLOR = orbitTokens.brand.orange;\n\n/**\n * Categories are sorted before being indexed into the palette, so a colour\n * belongs to a category and not to the order the rows happened to arrive in.\n */\nexport const buildCategoryColors = (points: GeoPoint[]): Map<string, string> => {\n  const categories = [...new Set(points.map((p) => p.category).filter((c): c is string => c != null))];\n\n  categories.sort((a, b) => a.localeCompare(b));\n\n  return new Map(categories.map((category, i) => [category, CHART_COLORS[i % CHART_COLORS.length]]));\n};\n\n/**\n * Null when nothing carries a weight, and also when every weight is equal:\n * a dataset with no size information should render at the base radius rather\n * than paint every marker at the maximum.\n */\nexport const buildWeightScale = (points: GeoPoint[]): WeightScale | null => {\n  const weights = points\n    .map((p) => p.weight)\n    .filter((w): w is number => w != null && Number.isFinite(w));\n\n  if (weights.length === 0) return null;\n\n  const min = Math.min(...weights);\n  const max = Math.max(...weights);\n\n  return min === max ? null : { min, max };\n};\n\n/**\n * Interpolate on the *area*, which is what a reader actually compares, and take\n * the square root to get back to a radius.\n */\nconst radiusFor = (weight: number | null | undefined, scale: WeightScale | null): number => {\n  if (scale == null || weight == null || !Number.isFinite(weight)) return GEO_MAP.BASE_MARKER_RADIUS;\n\n  const ratio = (weight - scale.min) / (scale.max - scale.min);\n  const clamped = Math.min(Math.max(ratio, 0), 1);\n  const minArea = GEO_MAP.MIN_MARKER_RADIUS ** 2;\n  const maxArea = GEO_MAP.MAX_MARKER_RADIUS ** 2;\n\n  return Math.sqrt(minArea + clamped * (maxArea - minArea));\n};\n\n/**\n * Selection changes the radius and the stroke as well as the colour, because\n * colour is never allowed to be the only indicator of a state.\n */\nexport const buildMarkerStyle = (\n  point: GeoPoint,\n  { categoryColors, weightScale, selected, theme }: MarkerStyleOptions,\n): MarkerStyle => {\n  const fillColor =\n    (point.category != null ? categoryColors.get(point.category) : undefined) ?? UNCATEGORISED_COLOR;\n  const radius = radiusFor(point.weight, weightScale);\n\n  return {\n    radius: selected ? radius + GEO_MAP.SELECTED_RADIUS_BOOST : radius,\n    color: selected ? SELECTION_RING[theme] : fillColor,\n    weight: selected ? GEO_MAP.SELECTED_STROKE_WIDTH : GEO_MAP.MARKER_STROKE_WIDTH,\n    fillColor,\n    fillOpacity: selected ? 1 : GEO_MAP.MARKER_FILL_OPACITY,\n  };\n};\n\n/** Legend swatches, in the same order the palette was handed out. */\nexport const buildLegendItems = (categoryColors: Map<string, string>): GeoLegendItem[] =>\n  [...categoryColors].map(([label, color]) => ({ label, color }));\n"],"names":[],"mappings":";;AAkCA,MAAM,iBAA4C;AAAA,EAChD,OAAO,YAAY,OAAO;AAAA,EAC1B,MAAM;AACR;AAGA,MAAM,sBAAsB,YAAY,MAAM;AAMvC,MAAM,sBAAsB,CAAC,WAA4C;AAC9E,QAAM,aAAa,CAAC,GAAG,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAmB,KAAK,IAAI,CAAC,CAAC;AAEnG,aAAW,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAE5C,SAAO,IAAI,IAAI,WAAW,IAAI,CAAC,UAAU,MAAM,CAAC,UAAU,aAAa,IAAI,aAAa,MAAM,CAAC,CAAC,CAAC;AACnG;AAOO,MAAM,mBAAmB,CAAC,WAA2C;AAC1E,QAAM,UAAU,OACb,IAAI,CAAC,MAAM,EAAE,MAAM,EACnB,OAAO,CAAC,MAAmB,KAAK,QAAQ,OAAO,SAAS,CAAC,CAAC;AAE7D,MAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,QAAM,MAAM,KAAK,IAAI,GAAG,OAAO;AAC/B,QAAM,MAAM,KAAK,IAAI,GAAG,OAAO;AAE/B,SAAO,QAAQ,MAAM,OAAO,EAAE,KAAK,IAAA;AACrC;AAMA,MAAM,YAAY,CAAC,QAAmC,UAAsC;AAC1F,MAAI,SAAS,QAAQ,UAAU,QAAQ,CAAC,OAAO,SAAS,MAAM,EAAG,QAAO,QAAQ;AAEhF,QAAM,SAAS,SAAS,MAAM,QAAQ,MAAM,MAAM,MAAM;AACxD,QAAM,UAAU,KAAK,IAAI,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;AAC9C,QAAM,UAAU,QAAQ,qBAAqB;AAC7C,QAAM,UAAU,QAAQ,qBAAqB;AAE7C,SAAO,KAAK,KAAK,UAAU,WAAW,UAAU,QAAQ;AAC1D;AAMO,MAAM,mBAAmB,CAC9B,OACA,EAAE,gBAAgB,aAAa,UAAU,YACzB;AAChB,QAAM,aACH,MAAM,YAAY,OAAO,eAAe,IAAI,MAAM,QAAQ,IAAI,WAAc;AAC/E,QAAM,SAAS,UAAU,MAAM,QAAQ,WAAW;AAElD,SAAO;AAAA,IACL,QAAQ,WAAW,SAAS,QAAQ,wBAAwB;AAAA,IAC5D,OAAO,WAAW,eAAe,KAAK,IAAI;AAAA,IAC1C,QAAQ,WAAW,QAAQ,wBAAwB,QAAQ;AAAA,IAC3D;AAAA,IACA,aAAa,WAAW,IAAI,QAAQ;AAAA,EAAA;AAExC;AAGO,MAAM,mBAAmB,CAAC,mBAC/B,CAAC,GAAG,cAAc,EAAE,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,EAAE,OAAO,QAAQ;"}
+{"version":3,"file":"index99.js","sources":["../src/charts/ScatterChartCard/buildScatterOption.ts"],"sourcesContent":["import type { FoldedPoint } from './foldPoints';\nimport { CHART_COLORS, SCATTER } from '../../constants';\n\n/** Distance from each axis line to its name (px — echarts canvas attributes, not CSS). */\nconst AXIS_NAME_GAP = { X: 28, Y: 38 } as const;\n\n/**\n * Grid margins (px). `containLabel` reserves room for the tick *labels* only, so\n * the axis names and the legend need their own margin or they get clipped at the\n * canvas edge. Each margin must exceed its `AXIS_NAME_GAP` by a text height.\n */\nconst GRID_MARGIN = {\n  BASE: 8,\n  TOP: 16,\n  RIGHT: 16,\n  X_NAME: 23,\n  Y_NAME: 34,\n  LEGEND: 30,\n} as const;\n\n/** Series name used when no point carries a category. */\nconst UNCATEGORISED_SERIES = 'Points';\n\nexport interface ScatterOptionConfig {\n  xLabel?: string;\n  yLabel?: string;\n  categoryLabel?: string;\n  showLegend: boolean;\n  enableDataZoom: boolean;\n}\n\n/** Point labels come from consumer data and land in the tooltip's HTML. */\nconst escapeHtml = (value: string) =>\n  value.replace(/[&<>\"]/g, (char) => `&#${char.charCodeAt(0)};`);\n\n/**\n * Map a weight onto a symbol diameter. The square root keeps the mark *area*\n * proportional to the weight, which is how a reader compares bubble sizes.\n * A dataset whose weights are all equal carries no size information, so it\n * renders at the base size rather than all-maximum.\n */\nconst symbolSizeFor = (weight: number, minWeight: number, maxWeight: number) => {\n  if (maxWeight === minWeight) return SCATTER.BASE_SYMBOL_SIZE;\n\n  const ratio = Math.sqrt((weight - minWeight) / (maxWeight - minWeight));\n  return SCATTER.MIN_SYMBOL_SIZE + (SCATTER.MAX_SYMBOL_SIZE - SCATTER.MIN_SYMBOL_SIZE) * ratio;\n};\n\n/** Group marks by category, preserving first-appearance order. */\nconst groupByCategory = (points: FoldedPoint[]) => {\n  const groups = new Map<string, FoldedPoint[]>();\n\n  for (const folded of points) {\n    const key = folded.point.category ?? UNCATEGORISED_SERIES;\n    const group = groups.get(key);\n    if (group) group.push(folded);\n    else groups.set(key, [folded]);\n  }\n\n  return groups;\n};\n\n/** `[x, y, count, sourceIndex]` — dims beyond the axes carry the tooltip/click metadata. */\nconst toDataItem = (folded: FoldedPoint, sizeOf: (weight: number | null | undefined) => number) => ({\n  name: folded.point.label,\n  value: [folded.point.x, folded.point.y, folded.count, folded.index],\n  symbolSize: sizeOf(folded.point.weight),\n});\n\nconst buildTooltipFormatter = (config: ScatterOptionConfig) => (params: unknown) => {\n  const { name, seriesName, value, marker } = params as {\n    name: string;\n    seriesName: string;\n    value: [number, number, number, number];\n    marker: string;\n  };\n  const [x, y, count] = value;\n\n  const lines = [`${marker} ${escapeHtml(name)}`];\n  lines.push(`${escapeHtml(config.xLabel ?? 'x')}: ${x}`);\n  lines.push(`${escapeHtml(config.yLabel ?? 'y')}: ${y}`);\n\n  if (seriesName !== UNCATEGORISED_SERIES) {\n    lines.push(`${escapeHtml(config.categoryLabel ?? 'Category')}: ${escapeHtml(seriesName)}`);\n  }\n\n  if (count > 1) lines.push(`${count} points here`);\n\n  return lines.join('<br/>');\n};\n\nexport const buildScatterOption = (points: FoldedPoint[], config: ScatterOptionConfig) => {\n  const weights = points.map((p) => p.point.weight).filter((w): w is number => w != null);\n  const minWeight = weights.length > 0 ? Math.min(...weights) : 0;\n  const maxWeight = weights.length > 0 ? Math.max(...weights) : 0;\n\n  // An absent weight sits at the bottom of the scale once any weight is present,\n  // and yields the base size when none is.\n  const sizeOf = (weight: number | null | undefined) =>\n    weights.length === 0\n      ? SCATTER.BASE_SYMBOL_SIZE\n      : symbolSizeFor(weight ?? minWeight, minWeight, maxWeight);\n\n  const groups = groupByCategory(points);\n  const series = [...groups.entries()].map(([category, group], i) => ({\n    name: category,\n    type: 'scatter' as const,\n    data: group.map((folded) => toDataItem(folded, sizeOf)),\n    itemStyle: { color: CHART_COLORS[i % CHART_COLORS.length], opacity: 0.85 },\n    emphasis: { focus: 'series' as const },\n  }));\n\n  return {\n    tooltip: { trigger: 'item' as const, formatter: buildTooltipFormatter(config) },\n    legend: config.showLegend ? { bottom: 0, type: 'scroll' as const } : undefined,\n    grid: {\n      left: config.yLabel ? GRID_MARGIN.Y_NAME : GRID_MARGIN.BASE,\n      right: GRID_MARGIN.RIGHT,\n      top: GRID_MARGIN.TOP,\n      // Room for the x axis name and the legend, each only when drawn.\n      bottom:\n        GRID_MARGIN.BASE +\n        (config.xLabel ? GRID_MARGIN.X_NAME : 0) +\n        (config.showLegend ? GRID_MARGIN.LEGEND : 0),\n      containLabel: true,\n    },\n    xAxis: {\n      type: 'value' as const,\n      name: config.xLabel,\n      nameLocation: 'middle' as const,\n      nameGap: AXIS_NAME_GAP.X,\n      scale: true,\n    },\n    yAxis: {\n      type: 'value' as const,\n      name: config.yLabel,\n      nameLocation: 'middle' as const,\n      // Without this the y name is drawn horizontally and eats the plot's width.\n      nameRotate: 90,\n      nameGap: AXIS_NAME_GAP.Y,\n      scale: true,\n    },\n    dataZoom: config.enableDataZoom\n      ? [\n          { type: 'inside' as const, xAxisIndex: 0 },\n          { type: 'inside' as const, yAxisIndex: 0 },\n        ]\n      : undefined,\n    series,\n  };\n};\n"],"names":[],"mappings":";AAIA,MAAM,gBAAgB,EAAE,GAAG,IAAI,GAAG,GAAA;AAOlC,MAAM,cAAc;AAAA,EAClB,MAAM;AAAA,EACN,KAAK;AAAA,EACL,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AACV;AAGA,MAAM,uBAAuB;AAW7B,MAAM,aAAa,CAAC,UAClB,MAAM,QAAQ,WAAW,CAAC,SAAS,KAAK,KAAK,WAAW,CAAC,CAAC,GAAG;AAQ/D,MAAM,gBAAgB,CAAC,QAAgB,WAAmB,cAAsB;AAC9E,MAAI,cAAc,UAAW,QAAO,QAAQ;AAE5C,QAAM,QAAQ,KAAK,MAAM,SAAS,cAAc,YAAY,UAAU;AACtE,SAAO,QAAQ,mBAAmB,QAAQ,kBAAkB,QAAQ,mBAAmB;AACzF;AAGA,MAAM,kBAAkB,CAAC,WAA0B;AACjD,QAAM,6BAAa,IAAA;AAEnB,aAAW,UAAU,QAAQ;AAC3B,UAAM,MAAM,OAAO,MAAM,YAAY;AACrC,UAAM,QAAQ,OAAO,IAAI,GAAG;AAC5B,QAAI,MAAO,OAAM,KAAK,MAAM;AAAA,QACvB,QAAO,IAAI,KAAK,CAAC,MAAM,CAAC;AAAA,EAC/B;AAEA,SAAO;AACT;AAGA,MAAM,aAAa,CAAC,QAAqB,YAA2D;AAAA,EAClG,MAAM,OAAO,MAAM;AAAA,EACnB,OAAO,CAAC,OAAO,MAAM,GAAG,OAAO,MAAM,GAAG,OAAO,OAAO,OAAO,KAAK;AAAA,EAClE,YAAY,OAAO,OAAO,MAAM,MAAM;AACxC;AAEA,MAAM,wBAAwB,CAAC,WAAgC,CAAC,WAAoB;AAClF,QAAM,EAAE,MAAM,YAAY,OAAO,WAAW;AAM5C,QAAM,CAAC,GAAG,GAAG,KAAK,IAAI;AAEtB,QAAM,QAAQ,CAAC,GAAG,MAAM,IAAI,WAAW,IAAI,CAAC,EAAE;AAC9C,QAAM,KAAK,GAAG,WAAW,OAAO,UAAU,GAAG,CAAC,KAAK,CAAC,EAAE;AACtD,QAAM,KAAK,GAAG,WAAW,OAAO,UAAU,GAAG,CAAC,KAAK,CAAC,EAAE;AAEtD,MAAI,eAAe,sBAAsB;AACvC,UAAM,KAAK,GAAG,WAAW,OAAO,iBAAiB,UAAU,CAAC,KAAK,WAAW,UAAU,CAAC,EAAE;AAAA,EAC3F;AAEA,MAAI,QAAQ,EAAG,OAAM,KAAK,GAAG,KAAK,cAAc;AAEhD,SAAO,MAAM,KAAK,OAAO;AAC3B;AAEO,MAAM,qBAAqB,CAAC,QAAuB,WAAgC;AACxF,QAAM,UAAU,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,MAAM,EAAE,OAAO,CAAC,MAAmB,KAAK,IAAI;AACtF,QAAM,YAAY,QAAQ,SAAS,IAAI,KAAK,IAAI,GAAG,OAAO,IAAI;AAC9D,QAAM,YAAY,QAAQ,SAAS,IAAI,KAAK,IAAI,GAAG,OAAO,IAAI;AAI9D,QAAM,SAAS,CAAC,WACd,QAAQ,WAAW,IACf,QAAQ,mBACR,cAAc,UAAU,WAAW,WAAW,SAAS;AAE7D,QAAM,SAAS,gBAAgB,MAAM;AACrC,QAAM,SAAS,CAAC,GAAG,OAAO,QAAA,CAAS,EAAE,IAAI,CAAC,CAAC,UAAU,KAAK,GAAG,OAAO;AAAA,IAClE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM,MAAM,IAAI,CAAC,WAAW,WAAW,QAAQ,MAAM,CAAC;AAAA,IACtD,WAAW,EAAE,OAAO,aAAa,IAAI,aAAa,MAAM,GAAG,SAAS,KAAA;AAAA,IACpE,UAAU,EAAE,OAAO,SAAA;AAAA,EAAkB,EACrC;AAEF,SAAO;AAAA,IACL,SAAS,EAAE,SAAS,QAAiB,WAAW,sBAAsB,MAAM,EAAA;AAAA,IAC5E,QAAQ,OAAO,aAAa,EAAE,QAAQ,GAAG,MAAM,aAAsB;AAAA,IACrE,MAAM;AAAA,MACJ,MAAM,OAAO,SAAS,YAAY,SAAS,YAAY;AAAA,MACvD,OAAO,YAAY;AAAA,MACnB,KAAK,YAAY;AAAA;AAAA,MAEjB,QACE,YAAY,QACX,OAAO,SAAS,YAAY,SAAS,MACrC,OAAO,aAAa,YAAY,SAAS;AAAA,MAC5C,cAAc;AAAA,IAAA;AAAA,IAEhB,OAAO;AAAA,MACL,MAAM;AAAA,MACN,MAAM,OAAO;AAAA,MACb,cAAc;AAAA,MACd,SAAS,cAAc;AAAA,MACvB,OAAO;AAAA,IAAA;AAAA,IAET,OAAO;AAAA,MACL,MAAM;AAAA,MACN,MAAM,OAAO;AAAA,MACb,cAAc;AAAA;AAAA,MAEd,YAAY;AAAA,MACZ,SAAS,cAAc;AAAA,MACvB,OAAO;AAAA,IAAA;AAAA,IAET,UAAU,OAAO,iBACb;AAAA,MACE,EAAE,MAAM,UAAmB,YAAY,EAAA;AAAA,MACvC,EAAE,MAAM,UAAmB,YAAY,EAAA;AAAA,IAAE,IAE3C;AAAA,IACJ;AAAA,EAAA;AAEJ;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ktnpm_devops/react-component",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "Kenmei Technologies React Component Library",
   "type": "module",
   "license": "MIT",
@@ -110,6 +110,9 @@
     "type": "git",
     "url": "https://github.com/kenmeitechnologies/react-component.git"
   },
+  "engines": {
+    "node": ">=22"
+  },
   "scripts": {
     "dev": "storybook dev -p 6006",
     "build": "vite build && pnpm build:css",