serialbench 0.1.3 → 0.2.0

data/site/src/pages/index.astro

@@ -0,0 +1,44 @@
+---
+import Layout from '../layouts/Layout.astro';
+import DashboardConsole from '../components/DashboardConsole.vue';
+import AvailabilityMatrix from '../components/AvailabilityMatrix.astro';
+import FeaturesTable from '../components/FeaturesTable.astro';
+import payloadData from '../data/sample.json';
+import type { Payload } from '../lib/dashboard';
+
+const payload = payloadData as unknown as Payload;
+const envCount = Object.keys(payload.environments).length;
+const runDate = payload.metadata.generated_at.slice(0, 10);
+---
+
+<Layout title="Serialbench — Ruby serialization benchmarks">
+  <section class="mb-10">
+    <p class="font-mono text-[10px] uppercase tracking-[0.14em] text-phosphor mb-3">Measurement console · run {runDate}</p>
+    <h1 class="text-3xl sm:text-4xl font-semibold tracking-tight max-w-3xl">
+      How fast can Ruby read and write your data?
+    </h1>
+    <p class="mt-3 text-inkdim max-w-2xl leading-relaxed">
+      Every XML, JSON, YAML and TOML serializer in the ecosystem, measured on the same workloads across
+      {envCount}
+      platform and Ruby combinations. Pick a format, pin a reference, and read the field.
+    </p>
+  </section>
+
+  <DashboardConsole client:load payload={payload} />
+
+  <AvailabilityMatrix payload={payload} />
+
+  <FeaturesTable payload={payload} />
+
+  <section class="mt-12 border border-line bg-panel px-5 py-5">
+    <h2 class="font-mono text-[10px] uppercase tracking-[0.14em] text-inkmute mb-2">Raw data</h2>
+    <p class="text-sm text-inkdim max-w-2xl leading-relaxed">
+      Full results per environment and the complete resultset are exported as YAML alongside this site —
+      <span class="font-mono text-[13px] break-all">data/&lt;environment&gt;.yaml</span>
+      and
+      <span class="font-mono text-[13px] break-all">data/resultset.yaml</span>. Re-run any leg with
+      <span class="font-mono text-[13px] break-all">serialbench environment execute</span>
+      using the configs in the repository.
+    </p>
+  </section>
+</Layout>

data/site/src/pages/library/[slug].astro

@@ -0,0 +1,128 @@
+---
+import Layout from '../../layouts/Layout.astro';
+import payloadData from '../../data/sample.json';
+import type { Payload } from '../../lib/dashboard';
+import {
+  availability,
+  environmentLabel,
+  environmentList,
+  formatIps,
+  formatsForSerializer,
+  libraryStats,
+  OPERATION_LABELS,
+  primaryEnvKey,
+  runnerShortLabel,
+} from '../../lib/dashboard';
+import { channelColor } from '../../lib/channels';
+import { BASE } from '../../config';
+
+export function getStaticPaths() {
+  const payload = payloadData as unknown as Payload;
+  return availability(payload).serializers.map((serializer) => ({
+    params: { slug: serializer },
+  }));
+}
+
+const { slug } = Astro.params;
+const payload = payloadData as unknown as Payload;
+const serializer = slug as string;
+
+const { envKeys, cells } = availability(payload);
+const envs = environmentList(payload);
+const envKey = primaryEnvKey(payload);
+const stats = libraryStats(payload, serializer, envKey);
+const formats = formatsForSerializer(payload, serializer);
+const covered = cells.get(serializer) ?? new Set<string>();
+const rankOne = stats.filter((s) => s.rank === 1).length;
+const color = channelColor(serializer);
+const runDate = payload.metadata.generated_at.slice(0, 10);
+---
+
+<Layout title={`${serializer} — Serialbench`}>
+  <section class="mb-8">
+    <p class="font-mono text-[10px] uppercase tracking-[0.14em] text-inkmute mb-3">
+      <a href={BASE} class="hover:text-phosphor transition-colors">← Field overview</a>
+    </p>
+    <div class="flex items-center gap-3">
+      <span class="h-3 w-3 rounded-full" style={`background: ${color}`}></span>
+      <h1 class="text-3xl font-semibold tracking-tight font-mono">{serializer}</h1>
+    </div>
+    <p class="mt-2 text-inkdim">
+      {formats.map((f) => f.toUpperCase()).join(' / ')} serializer ·
+      measured on {covered.size} of {envKeys.length} environments ·
+      <span class="text-phosphor">#1 in {rankOne} of {stats.length} measurements</span>
+      <span class="text-inkmute"> · primary environment: {environmentLabel(envKey, payload.environments[envKey])}</span>
+    </p>
+  </section>
+
+  <section aria-label="Availability" class="mb-10 border border-line bg-panel px-4 py-4">
+    <p class="font-mono text-[10px] uppercase tracking-[0.14em] text-inkmute mb-3">Measured environments</p>
+    <div class="flex flex-wrap gap-x-4 gap-y-2">
+      {
+        envs.map(({ key, env }) => (
+          <span class="font-mono text-[11px] flex items-center gap-1.5" title={environmentLabel(key, env)}>
+            {covered.has(key) ? (
+              <span class="h-2 w-2 rounded-full" style={`background: ${color}`} />
+            ) : (
+              <span class="h-2 w-2 rounded-full border border-line" />
+            )}
+            <span class={covered.has(key) ? 'text-inkdim' : 'text-inkmute line-through'}>{runnerShortLabel(key, env)}</span>
+          </span>
+        ))
+      }
+    </div>
+  </section>
+
+  <section aria-label="Measurements">
+    <p class="font-mono text-[10px] uppercase tracking-[0.14em] text-inkmute mb-3">
+      Iterations per second on the primary environment · rank vs the field
+    </p>
+    <div class="overflow-x-auto border border-line bg-panel">
+      <table class="w-full border-collapse">
+        <thead>
+          <tr class="font-mono text-[10px] uppercase tracking-[0.14em] text-inkmute">
+            <th class="text-left font-normal px-3 py-2 border-b border-line">Operation</th>
+            <th class="text-left font-normal px-3 py-2 border-b border-line">Input</th>
+            <th class="text-right font-normal px-3 py-2 border-b border-line">ips</th>
+            <th class="text-right font-normal px-3 py-2 border-b border-line">ms/op</th>
+            <th class="text-right font-normal px-3 py-2 border-b border-line">Rank</th>
+            <th class="text-left font-normal px-3 py-2 border-b border-line">vs best</th>
+          </tr>
+        </thead>
+        <tbody>
+          {
+            stats.map((s) => (
+              <tr>
+                <td class="px-3 py-1.5 border-b border-line/50 font-mono text-[12px]">
+                  {OPERATION_LABELS[s.op as keyof typeof OPERATION_LABELS] ?? s.op}
+                </td>
+                <td class="px-3 py-1.5 border-b border-line/50 font-mono text-[12px] text-inkmute">{s.size}</td>
+                <td class="px-3 py-1.5 border-b border-line/50 font-mono text-[12px] text-right tabular">{formatIps(s.ips)}</td>
+                <td class="px-3 py-1.5 border-b border-line/50 font-mono text-[12px] text-right tabular text-inkdim">
+                  {(1000 / s.ips).toFixed(s.ips < 10 ? 2 : 1)}
+                </td>
+                <td class="px-3 py-1.5 border-b border-line/50 font-mono text-[12px] text-right tabular">
+                  <span class={s.rank === 1 ? 'text-phosphor' : 'text-inkdim'}>{s.rank}/{s.fieldSize}</span>
+                </td>
+                <td class="px-3 py-1.5 border-b border-line/50 font-mono text-[11px] text-inkmute whitespace-nowrap">
+                  {s.ratioToBest == null ? '—' : s.rank === 1 ? 'best in field' : `${s.ratioToBest.toFixed(1)}× slower than ${s.bestSerializer}`}
+                </td>
+              </tr>
+            ))
+          }
+        </tbody>
+      </table>
+    </div>
+    <p class="font-mono text-[11px] text-inkmute mt-2">
+      Compare every library on every environment on the <a href={BASE} class="text-phosphor hover:underline">dashboard</a>.
+    </p>
+  </section>
+
+  <section class="mt-10 border border-line bg-panel px-4 py-3 flex flex-wrap items-center gap-4">
+    <span class="font-mono text-[10px] uppercase tracking-[0.14em] text-inkmute shrink-0">Cite</span>
+    <p class="flex-1 min-w-64 font-mono text-[12px] leading-relaxed text-inkdim">
+      {serializer} measured on {environmentLabel(envKey, payload.environments[envKey])}, {formats.map((f) => f.toUpperCase()).join('/')}
+      workloads — serialbench, {runDate}. Full data: data/{envKey}.yaml.
+    </p>
+  </section>
+</Layout>

data/site/src/pages/methodology.astro

@@ -0,0 +1,55 @@
+---
+import Layout from '../layouts/Layout.astro';
+import { SITE } from '../config';
+---
+
+<Layout title="Methodology — Serialbench">
+  <section class="mb-10">
+    <p class="font-mono text-[10px] uppercase tracking-[0.14em] text-phosphor mb-3">Calibration</p>
+    <h1 class="text-3xl sm:text-4xl font-semibold tracking-tight">Methodology</h1>
+    <p class="mt-3 text-inkdim max-w-2xl leading-relaxed">
+      A benchmark you can't reproduce is marketing. This page documents exactly how serialbench
+      produces every number on this site.
+    </p>
+  </section>
+
+  <div class="grid gap-6 md:grid-cols-2 max-w-4xl">
+    <section class="border border-line bg-panel p-5">
+      <h2 class="font-mono text-[11px] uppercase tracking-[0.14em] text-phosphor mb-3">Workloads</h2>
+      <p class="text-sm text-inkdim leading-relaxed">
+        Each serializer parses, generates, and (where supported) streams the same documents at each
+        configured size. Operations run after warmup iterations; throughput is reported as
+        iterations per second, memory as allocated and retained bytes measured around the operation.
+      </p>
+    </section>
+
+    <section class="border border-line bg-panel p-5">
+      <h2 class="font-mono text-[11px] uppercase tracking-[0.14em] text-phosphor mb-3">Environments</h2>
+      <p class="text-sm text-inkdim leading-relaxed">
+        Results are collected per GitHub-hosted runner platform and Ruby version, then aggregated into
+        one resultset. Runners differ in CPU and memory — compare within an environment, not across
+        environments, unless you are comparing environments.
+      </p>
+    </section>
+
+    <section class="border border-line bg-panel p-5">
+      <h2 class="font-mono text-[11px] uppercase tracking-[0.14em] text-phosphor mb-3">Fairness limits</h2>
+      <p class="text-sm text-inkdim leading-relaxed">
+        Libraries that fail to load or lack an operation are skipped for that leg rather than counted
+        as zero. A dot missing from the availability matrix means no measurement exists — never assume
+        a score. Microbenchmarks measure these workloads, not yours.
+      </p>
+    </section>
+
+    <section class="border border-line bg-panel p-5">
+      <h2 class="font-mono text-[11px] uppercase tracking-[0.14em] text-phosphor mb-3">Reproduce</h2>
+      <p class="text-sm text-inkdim leading-relaxed">
+        Clone
+        <a class="text-phosphor hover:underline" href={SITE.repoUrl}>{SITE.repoUrl.replace("https://github.com/", "")}</a>,
+        then run
+        <span class="font-mono text-[13px]">bundle exec serialbench environment execute &lt;env&gt; &lt;benchmark&gt; &lt;out&gt;</span>.
+        The raw YAML next to every chart is the exact output of that command.
+      </p>
+    </section>
+  </div>
+</Layout>

data/site/src/styles/global.css

@@ -0,0 +1,103 @@
+@import 'tailwindcss';
+
+/*
+ * serialbench design tokens — instrument console.
+ * Semantic colors are runtime CSS vars so [data-theme] can retarget them;
+ * @theme inline exposes them to Tailwind utilities (bg-panel, text-inkdim…).
+ */
+:root {
+  --surface: #0b101b;
+  --panel: #111a2b;
+  --panel-2: #16223a;
+  --line: #22314e;
+  --ink: #e9eef6;
+  --ink-dim: #a9b6c9;
+  --ink-mute: #6f7f99;
+  --phosphor: #5fd4e8;
+  --phosphor-ink: #071018;
+  --grid: rgba(95, 212, 232, 0.07);
+  --grid-strong: rgba(95, 212, 232, 0.14);
+}
+
+[data-theme='light'] {
+  --surface: #f3f5f9;
+  --panel: #ffffff;
+  --panel-2: #eaeef4;
+  --line: #d5dce7;
+  --ink: #16202e;
+  --ink-dim: #46566b;
+  --ink-mute: #75849d;
+  --phosphor: #0b7d96;
+  --phosphor-ink: #ffffff;
+  --grid: rgba(11, 125, 150, 0.08);
+  --grid-strong: rgba(11, 125, 150, 0.16);
+}
+
+@theme inline {
+  --color-surface: var(--surface);
+  --color-panel: var(--panel);
+  --color-panel2: var(--panel-2);
+  --color-line: var(--line);
+  --color-ink: var(--ink);
+  --color-inkdim: var(--ink-dim);
+  --color-inkmute: var(--ink-mute);
+  --color-phosphor: var(--phosphor);
+  --color-phosphorink: var(--phosphor-ink);
+  --font-sans: 'IBM Plex Sans', ui-sans-serif, system-ui, sans-serif;
+  --font-mono: 'IBM Plex Mono', ui-monospace, 'SF Mono', monospace;
+}
+
+html {
+  color-scheme: dark;
+}
+[data-theme='light'] {
+  color-scheme: light;
+}
+
+body {
+  background-color: var(--surface);
+  color: var(--ink);
+  font-family: var(--font-sans);
+  -webkit-font-smoothing: antialiased;
+}
+
+/* scope graticule: faint calibration grid used behind bars and panels */
+.graticule {
+  background-image:
+    linear-gradient(to right, var(--grid) 1px, transparent 1px),
+    linear-gradient(to bottom, var(--grid) 1px, transparent 1px);
+  background-size: 3rem 3rem;
+}
+
+.tabular {
+  font-variant-numeric: tabular-nums;
+}
+
+/* trace sweep-in for the leaderboard; disabled for reduced motion */
+@keyframes trace-in {
+  from {
+    transform: scaleX(0);
+  }
+  to {
+    transform: scaleX(1);
+  }
+}
+.trace-in {
+  transform-origin: left center;
+  animation: trace-in 0.7s cubic-bezier(0.22, 1, 0.36, 1) both;
+}
+@media (prefers-reduced-motion: reduce) {
+  .trace-in {
+    animation: none;
+  }
+}
+
+::selection {
+  background: var(--phosphor);
+  color: var(--phosphor-ink);
+}
+
+:focus-visible {
+  outline: 2px solid var(--phosphor);
+  outline-offset: 2px;
+}

data/site/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "include": [".astro/types.d.ts", "**/*"],
+  "exclude": ["dist"]
+}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: serialbench
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Ribose
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-22 00:00:00.000000000 Z
+date: 2026-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: benchmark-ips
@@ -337,6 +337,7 @@ files:
 - lib/serialbench/serializers/toml/tomlib_serializer.rb
 - lib/serialbench/serializers/toml/tomlrb_serializer.rb
 - lib/serialbench/serializers/xml/base_xml_serializer.rb
+- lib/serialbench/serializers/xml/leptris_serializer.rb
 - lib/serialbench/serializers/xml/libxml_serializer.rb
 - lib/serialbench/serializers/xml/nokogiri_serializer.rb
 - lib/serialbench/serializers/xml/oga_serializer.rb
@@ -358,6 +359,29 @@ files:
 - lib/serialbench/version.rb
 - lib/serialbench/yaml_validator.rb
 - serialbench.gemspec
+- site/.gitignore
+- site/README.md
+- site/astro.config.mjs
+- site/package-lock.json
+- site/package.json
+- site/public/favicon.svg
+- site/scripts/gen-sample-data.mjs
+- site/src/components/AvailabilityMatrix.astro
+- site/src/components/CalibratedLeaderboard.vue
+- site/src/components/CitationBox.vue
+- site/src/components/DashboardConsole.vue
+- site/src/components/FeaturesTable.astro
+- site/src/components/MemoryPanel.vue
+- site/src/components/OpsChart.vue
+- site/src/config.ts
+- site/src/layouts/Layout.astro
+- site/src/lib/channels.ts
+- site/src/lib/dashboard.ts
+- site/src/pages/index.astro
+- site/src/pages/library/[slug].astro
+- site/src/pages/methodology.astro
+- site/src/styles/global.css
+- site/tsconfig.json
 homepage: https://github.com/metanorma/serialbench
 licenses:
 - BSD-2-Clause