poetry-charts 0.0.2

data/themes/sera.css

@@ -0,0 +1,140 @@
+/* poetry-charts sera theme - chart chrome under upstream
+ * style-sera.css (pinned clone 1773ecfe, the shadcn@4.19.0 release). Upstream ships ONE chart rule (cn-chart-tooltip) and sera reskins it (bg-popover ring-1 ring-foreground/10 shadow-sm, radius absent = square); everything else carries the default treatment.
+ * Same contract as default.css: imported layer(base) by the host entry;
+ * POETRY_THEME=sera drives the gates and golden set. */
+
+/* MARK: Tooltip */
+.cn-chart-tooltip {
+  @apply bg-popover text-popover-foreground ring-foreground/10 gap-1.5 px-2.5 py-1.5 text-xs shadow-sm ring-1;
+}
+
+.cn-chart-tooltip-label {
+  @apply font-medium;
+}
+
+.cn-chart-tooltip-row {
+  @apply gap-2 [&>svg]:h-2.5 [&>svg]:w-2.5 [&>svg]:text-muted-foreground;
+}
+
+.cn-chart-tooltip-name {
+  @apply text-muted-foreground;
+}
+
+.cn-chart-tooltip-value {
+  @apply font-mono font-medium text-foreground tabular-nums;
+}
+
+/* MARK: Legend */
+.cn-chart-legend {
+  @apply gap-4;
+}
+
+.cn-chart-legend-align-top {
+  @apply pb-3;
+}
+
+.cn-chart-legend-align-bottom {
+  @apply pt-3;
+}
+
+.cn-chart-legend-item {
+  @apply gap-1.5 [&>svg]:h-3 [&>svg]:w-3 [&>svg]:text-muted-foreground;
+}
+
+.cn-chart-legend-swatch {
+  @apply h-2 w-2 rounded-[2px];
+}
+
+/* MARK: Cartesian chrome (shared across families) */
+.cn-chart-grid-line {
+  @apply stroke-border/50;
+}
+
+.cn-chart-tick {
+  @apply fill-muted-foreground;
+}
+
+.cn-chart-cursor-line {
+  @apply stroke-border;
+}
+
+.cn-chart-cursor-band {
+  @apply fill-muted;
+}
+
+.cn-chart-reference-line {
+  @apply stroke-muted-foreground;
+}
+
+.cn-chart-reference-area {
+  @apply fill-muted-foreground;
+}
+
+.cn-chart-reference-dot {
+  @apply fill-background stroke-muted-foreground;
+}
+
+.cn-chart-error-bar {
+  @apply stroke-foreground;
+}
+
+.cn-chart-brush-track {
+  @apply fill-muted;
+}
+
+.cn-chart-brush-window {
+  @apply fill-foreground/10 stroke-border;
+}
+
+.cn-chart-brush-handle {
+  @apply fill-muted-foreground;
+}
+
+.cn-chart-label {
+  @apply fill-foreground;
+}
+
+/* MARK: Polar chrome */
+.cn-chart-polar-grid-line {
+  @apply fill-none stroke-border;
+}
+
+.cn-chart-polar-grid-circle {
+  @apply fill-none stroke-border/50;
+}
+
+.cn-chart-radial-track {
+  @apply fill-muted;
+}
+
+.cn-chart-radial-disc-muted {
+  @apply fill-muted;
+}
+
+.cn-chart-radial-disc-background {
+  @apply fill-background;
+}
+
+.cn-chart-inside-label {
+  @apply fill-background text-xs;
+}
+
+.cn-chart-radial-inside-label {
+  @apply fill-white capitalize mix-blend-luminosity text-[11px];
+}
+
+.cn-chart-center-title {
+  @apply fill-foreground text-3xl font-bold;
+}
+
+.cn-chart-center-title-radial {
+  @apply fill-foreground text-4xl font-bold;
+}
+
+.cn-chart-center-title-compact {
+  @apply fill-foreground text-2xl font-bold;
+}
+
+.cn-chart-center-subtitle {
+  @apply fill-muted-foreground;
+}

data/themes/vega.css

@@ -0,0 +1,144 @@
+/* poetry-charts vega theme - same contract as default.css
+ * (layer(base), shared chrome names). Upstream style-vega.css touches a
+ * single chart surface (.cn-chart-tooltip) and its body is byte-identical
+ * to poetry defaults; every other chart treatment is poetry-own and
+ * carries the default look (a deliberate, recorded choice). The file
+ * exists so every poetry gem ships every theme (install --theme vega
+ * fails fast otherwise) and diverges when a later theme restyles charts.
+ */
+
+/* MARK: Tooltip */
+.cn-chart-tooltip {
+  @apply gap-1.5 rounded-lg border border-border/50 bg-background px-2.5 py-1.5 text-xs shadow-xl;
+}
+
+.cn-chart-tooltip-label {
+  @apply font-medium;
+}
+
+.cn-chart-tooltip-row {
+  @apply gap-2 [&>svg]:h-2.5 [&>svg]:w-2.5 [&>svg]:text-muted-foreground;
+}
+
+.cn-chart-tooltip-name {
+  @apply text-muted-foreground;
+}
+
+.cn-chart-tooltip-value {
+  @apply font-mono font-medium text-foreground tabular-nums;
+}
+
+/* MARK: Legend */
+.cn-chart-legend {
+  @apply gap-4;
+}
+
+.cn-chart-legend-align-top {
+  @apply pb-3;
+}
+
+.cn-chart-legend-align-bottom {
+  @apply pt-3;
+}
+
+.cn-chart-legend-item {
+  @apply gap-1.5 [&>svg]:h-3 [&>svg]:w-3 [&>svg]:text-muted-foreground;
+}
+
+.cn-chart-legend-swatch {
+  @apply h-2 w-2 rounded-[2px];
+}
+
+/* MARK: Cartesian chrome (shared across families) */
+.cn-chart-grid-line {
+  @apply stroke-border/50;
+}
+
+.cn-chart-tick {
+  @apply fill-muted-foreground;
+}
+
+.cn-chart-cursor-line {
+  @apply stroke-border;
+}
+
+.cn-chart-cursor-band {
+  @apply fill-muted;
+}
+
+.cn-chart-reference-line {
+  @apply stroke-muted-foreground;
+}
+
+.cn-chart-reference-area {
+  @apply fill-muted-foreground;
+}
+
+.cn-chart-reference-dot {
+  @apply fill-background stroke-muted-foreground;
+}
+
+.cn-chart-error-bar {
+  @apply stroke-foreground;
+}
+
+.cn-chart-brush-track {
+  @apply fill-muted;
+}
+
+.cn-chart-brush-window {
+  @apply fill-foreground/10 stroke-border;
+}
+
+.cn-chart-brush-handle {
+  @apply fill-muted-foreground;
+}
+
+.cn-chart-label {
+  @apply fill-foreground;
+}
+
+/* MARK: Polar chrome */
+.cn-chart-polar-grid-line {
+  @apply fill-none stroke-border;
+}
+
+.cn-chart-polar-grid-circle {
+  @apply fill-none stroke-border/50;
+}
+
+.cn-chart-radial-track {
+  @apply fill-muted;
+}
+
+.cn-chart-radial-disc-muted {
+  @apply fill-muted;
+}
+
+.cn-chart-radial-disc-background {
+  @apply fill-background;
+}
+
+.cn-chart-inside-label {
+  @apply fill-background text-xs;
+}
+
+.cn-chart-radial-inside-label {
+  @apply fill-white capitalize mix-blend-luminosity text-[11px];
+}
+
+.cn-chart-center-title {
+  @apply fill-foreground text-3xl font-bold;
+}
+
+.cn-chart-center-title-radial {
+  @apply fill-foreground text-4xl font-bold;
+}
+
+.cn-chart-center-title-compact {
+  @apply fill-foreground text-2xl font-bold;
+}
+
+.cn-chart-center-subtitle {
+  @apply fill-muted-foreground;
+}

data/vendor/d3-kernel/LICENSE-d3.txt

@@ -0,0 +1,17 @@
+Applies to the d3-array, d3-scale, d3-shape, d3-interpolate, d3-format,
+d3-time, and d3-time-format modules bundled (unmodified) into
+app/javascript/poetry/charts/d3.js.
+
+Copyright 2010-2023 Mike Bostock
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.

data/vendor/d3-kernel/LICENSE-decimal.js-light.txt

@@ -0,0 +1,25 @@
+Applies to decimal.js-light, bundled (unmodified) into
+app/javascript/poetry/charts/d3.js.
+
+The MIT Expat Licence.
+
+Copyright (c) 2020 Michael Mclaughlin
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/vendor/d3-kernel/LICENSE-recharts.txt

@@ -0,0 +1,26 @@
+Applies to getNiceTickValues.ts and util/arithmetic.ts under recharts/,
+copied verbatim from recharts v3.9.2 and bundled into
+app/javascript/poetry/charts/d3.js, and to the BigDecimal transcription
+of the same algorithm in lib/ (Poetry::Charts::Geometry::NiceTicks).
+
+The MIT License (MIT)
+
+Copyright (c) 2015-present recharts
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/vendor/d3-kernel/README.md

@@ -0,0 +1,30 @@
+# The @poetry/charts/d3 kernel
+
+The DOM-free geometry kernel poetry-charts' live tier computes with,
+bundled into the committed `app/javascript/poetry/charts/d3.js` (ESM,
+~26 KB gzip) behind the host-remappable `@poetry/charts/d3` importmap pin.
+It is an implementation detail of live mode, not a public d3 distribution
+(no poetry-d3 gem unless raw-d3 demand appears — the remappable pin
+keeps that extraction non-breaking).
+
+Contents, unmodified:
+
+- **d3**: d3-array, d3-scale, d3-shape, d3-interpolate, d3-format,
+  d3-time, d3-time-format (ISC, Mike Bostock) — the EXACT packages that
+  generate `test/fixtures/geometry_fixtures.json`, so this kernel and the
+  Ruby geometry port answer to one oracle.
+- **decimal.js-light** (MIT, Michael Mclaughlin) — recharts' arbitrary-precision
+  dependency.
+- **recharts/** — `getNiceTickValues.ts` + `util/arithmetic.ts` copied
+  VERBATIM from recharts v3.9.2 `src/util/scale/` (MIT, Recharts Group);
+  the two sibling `.ts` files here are type-only shims at the original
+  import paths so the copies bundle unmodified. This is the same algorithm
+  `Poetry::Charts::Geometry::NiceTicks` transcribes to BigDecimal.
+
+Rebuild: `npm run vendor:d3`. Drift gates: `npm run vendor:d3:verify`
+(byte compare, part of `npm test`) and the KERNEL_VERSIONS check +
+fixture-parity suite in `test/javascript/d3_kernel.test.js`.
+
+License texts for everything bundled here: `LICENSE-d3.txt`,
+`LICENSE-decimal.js-light.txt`, `LICENSE-recharts.txt` (this directory;
+see also the repo-root `THIRD_PARTY_NOTICES.md`).

data/vendor/d3-kernel/build.mjs

@@ -0,0 +1,66 @@
+// Builds the committed @poetry/charts/d3 kernel bundle from
+// vendor/d3-kernel/entry.js (the vendoring pattern).
+//
+//   npm run vendor:d3          rebuild app/javascript/poetry/charts/d3.js
+//   npm run vendor:d3:verify   rebuild in memory and fail on drift
+//
+// The build is deterministic for a given dependency set; KERNEL_VERSIONS
+// is injected so the vitest gate can prove the committed bundle matches
+// the installed packages.
+import { build } from "esbuild"
+import { readFileSync, writeFileSync } from "node:fs"
+import { fileURLToPath } from "node:url"
+import path from "node:path"
+
+const ROOT = path.dirname(path.dirname(path.dirname(fileURLToPath(import.meta.url))))
+const OUTFILE = path.join(ROOT, "app/javascript/poetry/charts/d3.js")
+
+const PACKAGES = [
+  "d3-array", "d3-scale", "d3-shape", "d3-interpolate", "d3-format",
+  "d3-time", "d3-time-format", "decimal.js-light",
+]
+const versions = Object.fromEntries(
+  PACKAGES.map((name) => [
+    name,
+    JSON.parse(readFileSync(path.join(ROOT, "node_modules", name, "package.json"), "utf8")).version,
+  ])
+)
+
+const banner = `/*!
+ * @poetry/charts/d3 - the vendored DOM-free geometry kernel (the opt-in live mode).
+ * Bundles, unmodified:
+ *   d3-array ${versions["d3-array"]}, d3-scale ${versions["d3-scale"]}, d3-shape ${versions["d3-shape"]},
+ *   d3-interpolate ${versions["d3-interpolate"]}, d3-format ${versions["d3-format"]},
+ *   d3-time ${versions["d3-time"]}, d3-time-format ${versions["d3-time-format"]}
+ *     - Copyright 2010-2023 Mike Bostock, ISC license (https://github.com/d3)
+ *   decimal.js-light ${versions["decimal.js-light"]}
+ *     - Copyright Michael Mclaughlin, MIT license
+ *   getNiceTickValues from recharts v3.9.2 (verbatim)
+ *     - Copyright (c) Recharts Group, MIT license (https://github.com/recharts/recharts)
+ * Rebuild: npm run vendor:d3 (source: vendor/d3-kernel/).
+ */`
+
+const result = await build({
+  entryPoints: [path.join(ROOT, "vendor/d3-kernel/entry.js")],
+  bundle: true,
+  format: "esm",
+  minify: true,
+  legalComments: "none",
+  banner: { js: banner },
+  define: { __KERNEL_VERSIONS__: JSON.stringify(versions) },
+  write: false,
+})
+
+const fresh = result.outputFiles[0].text
+
+if (process.argv.includes("--verify")) {
+  const committed = readFileSync(OUTFILE, "utf8")
+  if (committed !== fresh) {
+    console.error("DRIFT: app/javascript/poetry/charts/d3.js does not match a fresh build - run `npm run vendor:d3` and commit.")
+    process.exit(1)
+  }
+  console.log(`vendor:d3 verified (${(fresh.length / 1024).toFixed(1)} KB, ${Object.entries(versions).map(([k, v]) => `${k}@${v}`).join(", ")})`)
+} else {
+  writeFileSync(OUTFILE, fresh)
+  console.log(`vendored ${OUTFILE} (${(fresh.length / 1024).toFixed(1)} KB)`)
+}

data/vendor/d3-kernel/entry.js

@@ -0,0 +1,27 @@
+// The @poetry/charts/d3 kernel surface: the DOM-free d3
+// modules the live tier computes geometry with - the EXACT packages that
+// generated test/fixtures/geometry_fixtures.json, so the client kernel and
+// the Ruby geometry port share one ground truth - plus recharts' own
+// getNiceTickValues (copied verbatim; v3 keeps it internal) so client
+// ticks match Geometry::NiceTicks decimal-for-decimal.
+//
+// Not a public d3 distribution: this is an implementation detail of live
+// mode behind a host-remappable importmap pin (the vendoring pattern).
+// Rebuild with `npm run vendor:d3`; CI drift-gates the committed bundle.
+
+export { ticks, tickIncrement, tickStep, bisector, extent, max, min, range } from "d3-array"
+export { scaleLinear, scaleBand, scalePoint, scaleTime } from "d3-scale"
+export {
+  line, area, stack, arc, pie,
+  curveLinear, curveNatural, curveStep, curveStepBefore, curveStepAfter, curveMonotoneX,
+  stackOffsetNone, stackOffsetExpand, stackOffsetDiverging, stackOrderNone,
+} from "d3-shape"
+export { interpolate, interpolateNumber, interpolateArray } from "d3-interpolate"
+export { format } from "d3-format"
+export { timeFormat, timeParse } from "d3-time-format"
+export { getNiceTickValues, getTickValuesFixedDomain } from "./recharts/util/scale/getNiceTickValues"
+
+// Injected at bundle time (vendor/d3-kernel/build.mjs): the exact package
+// versions inside this bundle - the vitest drift gate compares them to
+// package.json so a dependency bump can never outrun a rebuild.
+export const KERNEL_VERSIONS = __KERNEL_VERSIONS__

data/vendor/d3-kernel/recharts/state/cartesianAxisSlice.ts

@@ -0,0 +1,6 @@
+// Type shim for the verbatim recharts copies in this vendor tree: the
+// original `src/util/scale/getNiceTickValues.ts` imports
+// NiceTicksAlgorithm from `../../state/cartesianAxisSlice`; this file
+// provides ONLY that type (from recharts v3.9.2) so the copies bundle
+// without modification.
+export type NiceTicksAlgorithm = 'none' | 'auto' | 'adaptive' | 'snap125';