@ktnpm_devops/react-component 0.14.0 → 0.15.0

package/dist/index116.cjs

@@ -1,33 +1,95 @@
 "use strict";
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const wrap = "krc-wrap-JRsc1";
-const root = "krc-root-k9ocd";
-const colh = "krc-colh-Fi0Kr";
-const rowh = "krc-rowh-bTG4G";
-const corner = "krc-corner-MNGJd";
-const cell = "krc-cell-i0lDG";
-const bad = "krc-bad-Hb1F3";
-const ok = "krc-ok-hx6Lc";
-const clickable = "krc-clickable-Q8fZg";
-const styles = {
-  wrap,
-  root,
-  colh,
-  rowh,
-  corner,
-  cell,
-  bad,
-  ok,
-  clickable
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const constants = require("./index65.cjs");
+const AXIS_NAME_GAP = { X: 28, Y: 38 };
+const GRID_MARGIN = {
+  BASE: 8,
+  TOP: 16,
+  RIGHT: 16,
+  X_NAME: 23,
+  Y_NAME: 34,
+  LEGEND: 30
 };
-exports.bad = bad;
-exports.cell = cell;
-exports.clickable = clickable;
-exports.colh = colh;
-exports.corner = corner;
-exports.default = styles;
-exports.ok = ok;
-exports.root = root;
-exports.rowh = rowh;
-exports.wrap = wrap;
+const UNCATEGORISED_SERIES = "Points";
+const escapeHtml = (value) => value.replace(/[&<>"]/g, (char) => `&#${char.charCodeAt(0)};`);
+const symbolSizeFor = (weight, minWeight, maxWeight) => {
+  if (maxWeight === minWeight) return constants.SCATTER.BASE_SYMBOL_SIZE;
+  const ratio = Math.sqrt((weight - minWeight) / (maxWeight - minWeight));
+  return constants.SCATTER.MIN_SYMBOL_SIZE + (constants.SCATTER.MAX_SYMBOL_SIZE - constants.SCATTER.MIN_SYMBOL_SIZE) * ratio;
+};
+const groupByCategory = (points) => {
+  const groups = /* @__PURE__ */ new Map();
+  for (const folded of points) {
+    const key = folded.point.category ?? UNCATEGORISED_SERIES;
+    const group = groups.get(key);
+    if (group) group.push(folded);
+    else groups.set(key, [folded]);
+  }
+  return groups;
+};
+const toDataItem = (folded, sizeOf) => ({
+  name: folded.point.label,
+  value: [folded.point.x, folded.point.y, folded.count, folded.index],
+  symbolSize: sizeOf(folded.point.weight)
+});
+const buildTooltipFormatter = (config) => (params) => {
+  const { name, seriesName, value, marker } = params;
+  const [x, y, count] = value;
+  const lines = [`${marker} ${escapeHtml(name)}`];
+  lines.push(`${escapeHtml(config.xLabel ?? "x")}: ${x}`);
+  lines.push(`${escapeHtml(config.yLabel ?? "y")}: ${y}`);
+  if (seriesName !== UNCATEGORISED_SERIES) {
+    lines.push(`${escapeHtml(config.categoryLabel ?? "Category")}: ${escapeHtml(seriesName)}`);
+  }
+  if (count > 1) lines.push(`${count} points here`);
+  return lines.join("<br/>");
+};
+const buildScatterOption = (points, config) => {
+  const weights = points.map((p) => p.point.weight).filter((w) => w != null);
+  const minWeight = weights.length > 0 ? Math.min(...weights) : 0;
+  const maxWeight = weights.length > 0 ? Math.max(...weights) : 0;
+  const sizeOf = (weight) => weights.length === 0 ? constants.SCATTER.BASE_SYMBOL_SIZE : symbolSizeFor(weight ?? minWeight, minWeight, maxWeight);
+  const groups = groupByCategory(points);
+  const series = [...groups.entries()].map(([category, group], i) => ({
+    name: category,
+    type: "scatter",
+    data: group.map((folded) => toDataItem(folded, sizeOf)),
+    itemStyle: { color: constants.CHART_COLORS[i % constants.CHART_COLORS.length], opacity: 0.85 },
+    emphasis: { focus: "series" }
+  }));
+  return {
+    tooltip: { trigger: "item", formatter: buildTooltipFormatter(config) },
+    legend: config.showLegend ? { bottom: 0, type: "scroll" } : void 0,
+    grid: {
+      left: config.yLabel ? GRID_MARGIN.Y_NAME : GRID_MARGIN.BASE,
+      right: GRID_MARGIN.RIGHT,
+      top: GRID_MARGIN.TOP,
+      // Room for the x axis name and the legend, each only when drawn.
+      bottom: GRID_MARGIN.BASE + (config.xLabel ? GRID_MARGIN.X_NAME : 0) + (config.showLegend ? GRID_MARGIN.LEGEND : 0),
+      containLabel: true
+    },
+    xAxis: {
+      type: "value",
+      name: config.xLabel,
+      nameLocation: "middle",
+      nameGap: AXIS_NAME_GAP.X,
+      scale: true
+    },
+    yAxis: {
+      type: "value",
+      name: config.yLabel,
+      nameLocation: "middle",
+      // Without this the y name is drawn horizontally and eats the plot's width.
+      nameRotate: 90,
+      nameGap: AXIS_NAME_GAP.Y,
+      scale: true
+    },
+    dataZoom: config.enableDataZoom ? [
+      { type: "inside", xAxisIndex: 0 },
+      { type: "inside", yAxisIndex: 0 }
+    ] : void 0,
+    series
+  };
+};
+exports.buildScatterOption = buildScatterOption;
 //# sourceMappingURL=index116.cjs.map

package/dist/index116.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index116.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index116.cjs","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":["SCATTER","CHART_COLORS"],"mappings":"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"}

package/dist/index116.js

@@ -1,33 +1,95 @@
-const wrap = "krc-wrap-JRsc1";
-const root = "krc-root-k9ocd";
-const colh = "krc-colh-Fi0Kr";
-const rowh = "krc-rowh-bTG4G";
-const corner = "krc-corner-MNGJd";
-const cell = "krc-cell-i0lDG";
-const bad = "krc-bad-Hb1F3";
-const ok = "krc-ok-hx6Lc";
-const clickable = "krc-clickable-Q8fZg";
-const styles = {
-  wrap,
-  root,
-  colh,
-  rowh,
-  corner,
-  cell,
-  bad,
-  ok,
-  clickable
+import { CHART_COLORS, SCATTER } from "./index65.js";
+const AXIS_NAME_GAP = { X: 28, Y: 38 };
+const GRID_MARGIN = {
+  BASE: 8,
+  TOP: 16,
+  RIGHT: 16,
+  X_NAME: 23,
+  Y_NAME: 34,
+  LEGEND: 30
+};
+const UNCATEGORISED_SERIES = "Points";
+const escapeHtml = (value) => value.replace(/[&<>"]/g, (char) => `&#${char.charCodeAt(0)};`);
+const symbolSizeFor = (weight, minWeight, maxWeight) => {
+  if (maxWeight === minWeight) return SCATTER.BASE_SYMBOL_SIZE;
+  const ratio = Math.sqrt((weight - minWeight) / (maxWeight - minWeight));
+  return SCATTER.MIN_SYMBOL_SIZE + (SCATTER.MAX_SYMBOL_SIZE - SCATTER.MIN_SYMBOL_SIZE) * ratio;
+};
+const groupByCategory = (points) => {
+  const groups = /* @__PURE__ */ new Map();
+  for (const folded of points) {
+    const key = folded.point.category ?? UNCATEGORISED_SERIES;
+    const group = groups.get(key);
+    if (group) group.push(folded);
+    else groups.set(key, [folded]);
+  }
+  return groups;
+};
+const toDataItem = (folded, sizeOf) => ({
+  name: folded.point.label,
+  value: [folded.point.x, folded.point.y, folded.count, folded.index],
+  symbolSize: sizeOf(folded.point.weight)
+});
+const buildTooltipFormatter = (config) => (params) => {
+  const { name, seriesName, value, marker } = params;
+  const [x, y, count] = value;
+  const lines = [`${marker} ${escapeHtml(name)}`];
+  lines.push(`${escapeHtml(config.xLabel ?? "x")}: ${x}`);
+  lines.push(`${escapeHtml(config.yLabel ?? "y")}: ${y}`);
+  if (seriesName !== UNCATEGORISED_SERIES) {
+    lines.push(`${escapeHtml(config.categoryLabel ?? "Category")}: ${escapeHtml(seriesName)}`);
+  }
+  if (count > 1) lines.push(`${count} points here`);
+  return lines.join("<br/>");
+};
+const buildScatterOption = (points, config) => {
+  const weights = points.map((p) => p.point.weight).filter((w) => w != null);
+  const minWeight = weights.length > 0 ? Math.min(...weights) : 0;
+  const maxWeight = weights.length > 0 ? Math.max(...weights) : 0;
+  const sizeOf = (weight) => weights.length === 0 ? SCATTER.BASE_SYMBOL_SIZE : symbolSizeFor(weight ?? minWeight, minWeight, maxWeight);
+  const groups = groupByCategory(points);
+  const series = [...groups.entries()].map(([category, group], i) => ({
+    name: category,
+    type: "scatter",
+    data: group.map((folded) => toDataItem(folded, sizeOf)),
+    itemStyle: { color: CHART_COLORS[i % CHART_COLORS.length], opacity: 0.85 },
+    emphasis: { focus: "series" }
+  }));
+  return {
+    tooltip: { trigger: "item", formatter: buildTooltipFormatter(config) },
+    legend: config.showLegend ? { bottom: 0, type: "scroll" } : void 0,
+    grid: {
+      left: config.yLabel ? GRID_MARGIN.Y_NAME : GRID_MARGIN.BASE,
+      right: GRID_MARGIN.RIGHT,
+      top: GRID_MARGIN.TOP,
+      // Room for the x axis name and the legend, each only when drawn.
+      bottom: GRID_MARGIN.BASE + (config.xLabel ? GRID_MARGIN.X_NAME : 0) + (config.showLegend ? GRID_MARGIN.LEGEND : 0),
+      containLabel: true
+    },
+    xAxis: {
+      type: "value",
+      name: config.xLabel,
+      nameLocation: "middle",
+      nameGap: AXIS_NAME_GAP.X,
+      scale: true
+    },
+    yAxis: {
+      type: "value",
+      name: config.yLabel,
+      nameLocation: "middle",
+      // Without this the y name is drawn horizontally and eats the plot's width.
+      nameRotate: 90,
+      nameGap: AXIS_NAME_GAP.Y,
+      scale: true
+    },
+    dataZoom: config.enableDataZoom ? [
+      { type: "inside", xAxisIndex: 0 },
+      { type: "inside", yAxisIndex: 0 }
+    ] : void 0,
+    series
+  };
 };
 export {
-  bad,
-  cell,
-  clickable,
-  colh,
-  corner,
-  styles as default,
-  ok,
-  root,
-  rowh,
-  wrap
+  buildScatterOption
 };
 //# sourceMappingURL=index116.js.map

package/dist/index116.js.map

@@ -1 +1 @@
-{"version":3,"file":"index116.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index116.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":"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"}