@motionscript/charts 0.0.0-stage → 0.1.0-alpha.0

package/dist/pie-chart/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/pie-chart/shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Types and pure helpers specific to the {@link PieChart} family: how rows\n * become slices, how slices become arcs on a ring, where the labels around it\n * end up, and the theme all of that is drawn from.\n *\n * The one chart in the family that draws **one mark per row** rather than one\n * per column, which is why almost nothing about its geometry is shared: there is\n * no scale, no axis and no baseline, only a circle divided by share. What it\n * *does* share — the legend, the theme leaf resolvers, the palette, the\n * percentage format — comes from `nodes/chart-kit/shared.ts`.\n *\n * Kept renderer-agnostic (no `Node` imports) so the studio's inspector mapping\n * (`pie-chart-props.ts`) can build a partial {@link PieChartTheme} without\n * pulling the node classes in.\n */\n\nimport {\n  lerpNumber,\n  shadowOps,\n  strokeOps,\n  textOps,\n  type DataRecord,\n  type Fill,\n  type Shadow,\n  type ShadowResolved,\n  type Stroke,\n  type StrokeResolved,\n  type TextStyle,\n  type Vector2,\n} from \"@motionscript/core\"\n\nimport {\n  CHART_PALETTE,\n  DEFAULT_LEGEND,\n  DEFAULT_SERIES_FILLS,\n  SPOTLIGHT_DIM,\n  lerpLegendConfig,\n  lerpSeriesFills,\n  num,\n  resolveLegendConfig,\n  resolveSeriesFills,\n  text,\n  type LegendConfig,\n  type LegendTheme,\n} from \"../kit/shared\"\n\n/**\n * One **resolved** slice of a {@link PieChart}: its caption, its magnitude, and\n * the paint its wedge and legend swatch take.\n *\n * This is what the ring and the legend consume, not what a scene authors: the\n * chart takes tabular `data` plus two field names and resolves it into these, so\n * the parts stay unaware of where a slice's caption, magnitude and paint came\n * from.\n */\nexport interface PieSlice {\n  /** Legend caption and label text for this slice. */\n  category: string\n  /** This slice's magnitude. Its wedge covers `value / (sum of all values)`. */\n  value: number\n  /** Wedge and swatch paint. */\n  fill: Fill\n}\n\n/**\n * Resolve tabular rows into slices: one per row, captioned by the `category`\n * column, sized by the `value` column, painted from `palette` by row order\n * (cycling when the palette is shorter than the data).\n *\n * Paint comes from the palette rather than from the rows because a pie draws one\n * mark per *row* — unlike the line and bar charts, where a colour belongs to a\n * series (a whole column) and rides on the series entry instead. Keeping it out\n * of the rows is what lets a pie be fed straight from a CSV of plain numbers.\n */\nexport function resolvePieSlices(\n  data: DataRecord[],\n  category: string,\n  value: string,\n  palette: Fill[]\n): PieSlice[] {\n  return data.map((row, i) => ({\n    category: text(row, category),\n    value: num(row, value),\n    fill:\n      palette.length > 0 ? palette[i % palette.length] : (\"white\" as Fill),\n  }))\n}\n\n/** What a {@link PieChart}'s labels say. */\nexport type PieLabelMode =\n  /**\n   * The category and its percentage, two lines. Their order flips with the\n   * placement: a **leader** label reads category over percentage, an **inside**\n   * label reads the percentage big over a small category caption — inside a\n   * wedge the reader already knows which slice they're on, so the magnitude is\n   * the thing being read.\n   */\n  | \"both\"\n  /** The category only. */\n  | \"category\"\n  /** The percentage only — the pick when a legend already names the categories. */\n  | \"percent\"\n  /** No labels and no leader lines at all. */\n  | \"none\"\n\n/**\n * Where a slice's label sits.\n *\n * `\"inside\"` drops the leader line entirely and centres the label in the wedge's\n * own band, which costs no gutter — so the ring draws bigger — and costs the eye\n * no round trip. `\"leader\"` is the classic treatment, and what a sliver too\n * narrow to hold text needs.\n */\nexport type PieLabelPlacement = \"inside\" | \"leader\" | \"none\"\n\n/** Degrees → radians. */\nexport const DEG = Math.PI / 180\n\n/** A slice's plotted value: negatives and non-finite values count as 0. */\nexport function sliceValue(slice: PieSlice): number {\n  return slice.value > 0 && Number.isFinite(slice.value) ? slice.value : 0\n}\n\n/** Sum of every slice's plotted value — the denominator every share is taken against. */\nexport function sliceTotal(slices: PieSlice[]): number {\n  let sum = 0\n  for (const slice of slices) sum += sliceValue(slice)\n  return sum\n}\n\n/**\n * The point at radius `r` and angle `a` on a ring centred on the origin, in the\n * node's centred, **y-up** space. Angles run **clockwise from 12 o'clock**:\n * `a = 0` points straight up (+y), and increasing `a` sweeps toward +x then −y.\n */\nexport function ringPoint(r: number, a: number): Vector2 {\n  return { x: r * Math.sin(a), y: r * Math.cos(a) }\n}\n\n/** One slice's resolved angular span on the ring. */\nexport interface PieArc {\n  /** Index of the slice in the source list. */\n  index: number\n  /** Start angle, radians clockwise from 12 o'clock. */\n  a0: number\n  /** End angle, radians clockwise from 12 o'clock. */\n  a1: number\n  /** Bisector angle — where this slice's label and pop-out point. */\n  mid: number\n  /** This slice's share of the total, in `[0, 1]`. */\n  fraction: number\n}\n\n/**\n * Resolve slices into per-slice arcs: each covers exactly its share of the\n * circle, walking clockwise from `startDegrees` (0 = 12 o'clock), with the arcs\n * abutting. Zero/negative slices are skipped entirely; an all-zero list yields\n * no arcs.\n *\n * Arcs are the *undivided* shares — the gap between neighbours is not carved out\n * here, because a fixed angular gap reads as a wedge: wide at the rim, pinched\n * shut at the hole. It's applied when the wedge is drawn instead, as a\n * constant-width inset off both ends of every arc, so a slice still covers its\n * true percentage of the circle.\n */\nexport function pieArcs(slices: PieSlice[], startDegrees: number): PieArc[] {\n  const total = sliceTotal(slices)\n  if (total <= 0) return []\n\n  const arcs: PieArc[] = []\n  let cursor = startDegrees * DEG\n  slices.forEach((slice, index) => {\n    const value = sliceValue(slice)\n    if (value <= 0) return\n    const fraction = value / total\n    const a0 = cursor\n    const a1 = a0 + fraction * Math.PI * 2\n    cursor = a1\n    arcs.push({ index, a0, a1, mid: (a0 + a1) / 2, fraction })\n  })\n  return arcs\n}\n\n/** A label competing for vertical space in one of the two label columns. */\nexport interface LabelSlot {\n  /** Where the label would sit if nothing else were in the way. */\n  ideal: number\n  /** Where it ends up once the column has been de-conflicted. Written by {@link relaxLabels}. */\n  y: number\n}\n\n/**\n * Spread one column of labels so no two overlap, keeping each as close to its\n * `ideal` y as possible and the whole column inside `[bottom, top]`.\n *\n * Two passes, the standard treatment. Walking top-to-bottom, each label takes\n * the highest slot at or below its ideal that still clears the label above it by\n * `minGap`; if that pushes the tail past `bottom`, a reverse pass lifts it back\n * up. When there are more labels than the column can hold, the reverse pass wins\n * and the crowding is shared evenly rather than dumped off the bottom edge.\n *\n * Mutates each slot's `y` and returns `slots` re-ordered top-to-bottom.\n */\nexport function relaxLabels<T extends LabelSlot>(\n  slots: T[],\n  minGap: number,\n  top: number,\n  bottom: number\n): T[] {\n  slots.sort((a, b) => b.ideal - a.ideal)\n\n  let ceiling = top\n  for (const slot of slots) {\n    slot.y = Math.min(slot.ideal, ceiling)\n    ceiling = slot.y - minGap\n  }\n\n  let floor = bottom\n  for (let i = slots.length - 1; i >= 0; i--) {\n    slots[i].y = Math.max(slots[i].y, floor)\n    floor = slots[i].y + minGap\n  }\n\n  return slots\n}\n\n// ---- Theme ---------------------------------------------------------------\n\n/** The ring's geometry and paint — everything about the wedges but their colour. */\nexport interface RingConfig {\n  /**\n   * Width of the channel between adjacent slices, in px, held constant all the\n   * way across the band — the same clearance at the hole as at the rim. (An\n   * angular gap would splay open toward the rim instead.)\n   */\n  gap: number\n  /**\n   * Radius of the hole punched through the middle. Below 1 it reads as a\n   * fraction of the ring's outer radius (`0.6` leaves a band 40% of the radius\n   * thick); 1 and up as an explicit pixel radius; `0` fills the middle in,\n   * drawing solid pie wedges.\n   */\n  holeRadius: number\n  /** Angle in degrees where the first slice begins, clockwise from 12 o'clock. */\n  startAngle: number\n  /**\n   * How far out a selected slice's rim reaches, as a **multiple of the ring's\n   * outer radius**. Being relative, the emphasis scales with the chart instead\n   * of shrinking on a big one and swamping a small one. Clamped to `[1, 1.6]`.\n   */\n  selectedGrow: number\n  /** Optional outline on every wedge. */\n  stroke: Stroke\n  /** Optional drop shadow on every wedge. */\n  shadow: Shadow\n}\n\n/** How the ring's labels are set, and the leader lines that point at them. */\nexport interface LabelConfig {\n  /** The category caption on a label. */\n  textStyle: TextStyle\n  /** The percentage on a label. */\n  percentStyle: TextStyle\n  /**\n   * Ink for a label set **inside** its wedge, both lines. Separate because an\n   * inside label sits on the wedge's own paint rather than on the background, so\n   * it usually wants the opposite end of the value range from everything else.\n   */\n  insideStyle: TextStyle\n  /** The leader line running from a wedge out to its label. */\n  leaderStroke: Stroke\n}\n\n/** The summary set in the ring's hole. */\nexport interface CenterConfig {\n  labelStyle: TextStyle\n  captionStyle: TextStyle\n}\n\n/** A {@link PieChart}'s full, resolved visual theme. */\nexport interface PieChartConfig {\n  /** Wedge and swatch paint, cycled by **row** index (`i % length`). */\n  sliceFills: Fill[]\n  ring: RingConfig\n  label: LabelConfig\n  center: CenterConfig\n  legend: LegendConfig\n  /** How far everything outside the selection fades while any slice is selected. */\n  spotlight: { dimOpacity: number }\n}\n\n/** Author-facing partial theme — every branch optional and deep-merged. */\nexport type PieChartTheme = {\n  sliceFills?: Fill[]\n  ring?: Partial<RingConfig>\n  label?: Partial<LabelConfig>\n  center?: Partial<CenterConfig>\n  legend?: LegendTheme\n  spotlight?: Partial<PieChartConfig[\"spotlight\"]>\n}\n\nconst LABEL_TEXT_STYLE: TextStyle = {\n  fontSize: 26,\n  fontWeight: 600,\n  textAlign: \"center\",\n  fill: CHART_PALETTE.markerColor,\n}\n\n/** The pie chart's out-of-the-box look. */\nexport const DEFAULT_PIE_CHART_THEME: PieChartConfig = {\n  sliceFills: DEFAULT_SERIES_FILLS,\n  ring: {\n    gap: 6,\n    // A donut rather than a solid pie by default: the hole is the largest\n    // uninterrupted area the chart owns and the one place a conclusion can be\n    // set. `0` here would give that away before anyone had asked for it.\n    holeRadius: 0.6,\n    startAngle: 0,\n    selectedGrow: 1.08,\n    stroke: [],\n    shadow: [],\n  },\n  label: {\n    textStyle: LABEL_TEXT_STYLE,\n    percentStyle: { ...LABEL_TEXT_STYLE, fontWeight: 700 },\n    // Inside labels sit on the wedge's paint, which is a mid-tone from the\n    // palette — so they lead with the panel colour rather than the axis ink.\n    insideStyle: { ...LABEL_TEXT_STYLE, fontWeight: 800, fill: \"#15130e\" },\n    leaderStroke: { weight: 2, fill: CHART_PALETTE.markerColor },\n  },\n  center: {\n    labelStyle: {\n      fontSize: 46,\n      fontWeight: 800,\n      textAlign: \"center\",\n      fill: CHART_PALETTE.markerColor,\n    },\n    captionStyle: {\n      fontSize: 22,\n      fontWeight: 500,\n      textAlign: \"center\",\n      fill: CHART_PALETTE.markerColor,\n    },\n  },\n  legend: DEFAULT_LEGEND,\n  spotlight: { dimOpacity: SPOTLIGHT_DIM },\n}\n\nfunction resolveRingConfig(\n  ring: Partial<RingConfig> | undefined,\n  previous: RingConfig\n): RingConfig {\n  return {\n    gap: ring?.gap ?? previous.gap,\n    holeRadius: ring?.holeRadius ?? previous.holeRadius,\n    startAngle: ring?.startAngle ?? previous.startAngle,\n    selectedGrow: ring?.selectedGrow ?? previous.selectedGrow,\n    stroke: strokeOps.resolve(ring?.stroke ?? previous.stroke),\n    shadow: shadowOps.resolve(ring?.shadow ?? previous.shadow),\n  }\n}\n\nfunction lerpRingConfig(\n  from: RingConfig,\n  to: RingConfig,\n  t: number\n): RingConfig {\n  return {\n    gap: lerpNumber(from.gap, to.gap, t),\n    holeRadius: lerpNumber(from.holeRadius, to.holeRadius, t),\n    startAngle: lerpNumber(from.startAngle, to.startAngle, t),\n    selectedGrow: lerpNumber(from.selectedGrow, to.selectedGrow, t),\n    stroke: strokeOps.lerp(\n      from.stroke as StrokeResolved[],\n      to.stroke as StrokeResolved[],\n      t\n    ),\n    shadow: shadowOps.lerp(\n      from.shadow as ShadowResolved[],\n      to.shadow as ShadowResolved[],\n      t\n    ),\n  }\n}\n\nfunction resolveLabelConfig(\n  label: Partial<LabelConfig> | undefined,\n  previous: LabelConfig\n): LabelConfig {\n  return {\n    textStyle: textOps.resolveStyle(label?.textStyle, previous.textStyle),\n    percentStyle: textOps.resolveStyle(\n      label?.percentStyle,\n      previous.percentStyle\n    ),\n    insideStyle: textOps.resolveStyle(label?.insideStyle, previous.insideStyle),\n    leaderStroke: strokeOps.resolve(\n      label?.leaderStroke ?? previous.leaderStroke\n    ),\n  }\n}\n\nfunction lerpLabelConfig(\n  from: LabelConfig,\n  to: LabelConfig,\n  t: number\n): LabelConfig {\n  return {\n    textStyle: textOps.lerpStyle(from.textStyle, to.textStyle, t),\n    percentStyle: textOps.lerpStyle(from.percentStyle, to.percentStyle, t),\n    insideStyle: textOps.lerpStyle(from.insideStyle, to.insideStyle, t),\n    leaderStroke: strokeOps.lerp(\n      from.leaderStroke as StrokeResolved[],\n      to.leaderStroke as StrokeResolved[],\n      t\n    ),\n  }\n}\n\nfunction resolveCenterConfig(\n  center: Partial<CenterConfig> | undefined,\n  previous: CenterConfig\n): CenterConfig {\n  return {\n    labelStyle: textOps.resolveStyle(center?.labelStyle, previous.labelStyle),\n    captionStyle: textOps.resolveStyle(\n      center?.captionStyle,\n      previous.captionStyle\n    ),\n  }\n}\n\nfunction lerpCenterConfig(\n  from: CenterConfig,\n  to: CenterConfig,\n  t: number\n): CenterConfig {\n  return {\n    labelStyle: textOps.lerpStyle(from.labelStyle, to.labelStyle, t),\n    captionStyle: textOps.lerpStyle(from.captionStyle, to.captionStyle, t),\n  }\n}\n\n/**\n * {@link PieChart}'s `theme` @property mapper: merges the author's partial\n * {@link PieChartTheme} onto `previous` (falling back to\n * {@link DEFAULT_PIE_CHART_THEME} on first resolution), fully resolving every\n * leaf so the tween below always has resolved data to interpolate.\n */\nexport function resolvePieChartTheme(\n  theme: PieChartTheme | undefined,\n  previous?: PieChartConfig\n): PieChartConfig {\n  const base = previous ?? DEFAULT_PIE_CHART_THEME\n  return {\n    sliceFills: resolveSeriesFills(theme?.sliceFills, base.sliceFills),\n    ring: resolveRingConfig(theme?.ring, base.ring),\n    label: resolveLabelConfig(theme?.label, base.label),\n    center: resolveCenterConfig(theme?.center, base.center),\n    legend: resolveLegendConfig(theme?.legend, base.legend),\n    spotlight: {\n      dimOpacity: theme?.spotlight?.dimOpacity ?? base.spotlight.dimOpacity,\n    },\n  }\n}\n\n/** {@link PieChart}'s `theme` @property tween — leaf by leaf. */\nexport function lerpPieChartTheme(\n  from: PieChartConfig,\n  to: PieChartConfig,\n  t: number\n): PieChartConfig {\n  return {\n    // A palette is a list of independent paints rather than one value, so it\n    // interpolates pairwise by index; one that grows or shrinks holds the longer\n    // side's tail, exactly as the cartesian charts' palettes do.\n    sliceFills: lerpSeriesFills(from.sliceFills, to.sliceFills, t),\n    ring: lerpRingConfig(from.ring, to.ring, t),\n    label: lerpLabelConfig(from.label, to.label, t),\n    center: lerpCenterConfig(from.center, to.center, t),\n    legend: lerpLegendConfig(from.legend, to.legend, t),\n    spotlight: {\n      dimOpacity: lerpNumber(\n        from.spotlight.dimOpacity,\n        to.spotlight.dimOpacity,\n        t\n      ),\n    },\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@motionscript/charts",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-alpha.0",
+  "type": "module",
+  "description": "Animated data charts for Motion Script: a line chart, a bar chart and a pie chart sharing one axis, legend and theme kit.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/motionscript-dev/motionscript.git",
+    "directory": "packages/components/charts"
+  },
+  "homepage": "https://motionscript.dev",
+  "bugs": {
+    "url": "https://github.com/motionscript-dev/motionscript/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src",
+    "registry.json",
+    "CHANGELOG.md",
+    "!dist/**/*.tsbuildinfo",
+    "!src/**/tests/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.fixtures.ts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./kit": {
+      "types": "./dist/engine.d.ts",
+      "default": "./dist/engine.js"
+    }
+  },
+  "keywords": [
+    "motion-script",
+    "motion script",
+    "chart",
+    "data-visualization",
+    "animation"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@motionscript/core": "^0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "eslint": "^9.39.4",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import-x": "^4.16.1",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.48.0",
+    "vitest": "^4.1.5",
+    "@motionscript/core": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json --resolve-full-paths && node ../../../scripts/build-browser.mjs",
+    "dev": "tsc -p tsconfig.build.json --watch & tsc-alias -p tsconfig.build.json --resolve-full-paths -w",
+    "clean": "rimraf --glob dist .turbo *.tsbuildinfo",
+    "test": "vitest --passWithNoTests",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }

package/registry.json

@@ -0,0 +1,23 @@
+{
+  "kit": { "barrel": "src/engine.ts", "specifier": "@motionscript/charts" },
+  "items": [
+    {
+      "name": "line-chart",
+      "description": "A cartesian line chart with a traced polyline, spotlit regions and a staggered entrance.",
+      "root": "src/line-chart",
+      "files": ["index.ts", "line-chart.ts", "chart-line.ts", "chart-region.ts", "horizontal-axis.ts", "shared.ts", "x-scale.ts"]
+    },
+    {
+      "name": "bar-chart",
+      "description": "A bar chart with grouped or stacked columns off a category axis.",
+      "root": "src/bar-chart",
+      "files": ["index.ts", "bar-chart.ts", "chart-bars.ts", "category-axis.ts", "shared.ts"]
+    },
+    {
+      "name": "pie-chart",
+      "description": "A pie or donut chart with relaxed labels and a revealable centre.",
+      "root": "src/pie-chart",
+      "files": ["index.ts", "pie-chart.ts", "pie-ring.ts", "pie-legend.ts", "shared.ts"]
+    }
+  ]
+}