Skip to content

CHANGELOG.md

Latest commit

 

History

History
109 lines (75 loc) · 8.73 KB

CHANGELOG.md

File metadata and controls

109 lines (75 loc) · 8.73 KB
Raw

Changelog

All notable changes to the PRC Chart Builder plugin are documented in this file.

For detailed narrative release notes, see docs/release-notes/.

Format follows Keep a Changelog.

[3.8.1] - Late April 2026

Added

  • Custom tooltip text (#2923). TK more context

[3.8.0] — April 2026

Added

  • Table data validation & typed columns (#2565) — the Power Table block now supports per-column data types (number, date, currency, percentage, url, fips, iso3alpha, iso3numeric, plus auto/text) with live per-cell validation, an inspector "Data validation" panel that surfaces error details, and a block-toolbar error-count button that jumps editors to the problem. Chart Builder registers five named validation schemas via the new prc_table_validation_schemas filter (geo-state, geo-county, geo-country, geo-country-numeric, timeseries) so a chart that requires FIPS codes, ISO-3 codes, or a date+number pairing can enforce it at the table level. Chart Builder's chart block reads the table's isValid flag and the active validationSchema and refuses to sync invalid data into the chart, showing an inline warning instead.
  • Multi-user editor presence & locking — new useDeclarePresence and usePresenceUsers hooks (shipped from @prc/hooks) let chart authors see when other users are editing the same chart, and the controller disables block editing mode when a lock is detected. Per-panel presence tracking surfaces which inspector panel another user is focused on.
  • Error bars on dot plots — per-point ErrorBarPanel in the ShapePanel popover with stroke color, width, opacity, and dasharray controls. A useErrorBarCustomizations hook manages state, and a new voronoi hit model on DotPlot improves label-trigger accuracy around error-bar whiskers.
  • Net value labels for bar charts — new NetValueLabels component renders net totals on diverging bar charts (horizontal and vertical) with per-side color, font-size, and positioning controls in a dedicated net-value-controls.jsx inspector panel. Labels are dark-mode-aware via the standardized getLabelFill helper.
  • Chart/Data view toggle — new view-mode-controls.jsx adds a block-toolbar "Switch to data/chart" button and an inspector "Show both" toggle. View state is held in a new controller Redux store keyed by controller id so chart, data, and controller stay in sync without attribute round-trips. Per-user editor preference only; does not affect the published view.
  • Synced chart auto-publish — new Synced_Chart_Auto_Publish class hooks into prc_platform_on_publish and prc_platform_on_update to automatically publish any draft chart CPT posts referenced by a post's synced-chart blocks when that post is published or updated.
  • JSON-LD isPartOf — Dataset schema now includes an isPartOf array listing every published post that references the chart CPT, surfacing the post→chart relationship to search engines.

Changed

  • JSON-LD Dataset.description prefers alt_text when present, falling back to the subtitle-based description for charts without alt text.
  • Synced chart reference panel filters out post revisions so the list only shows live referencing posts.
  • Treemap — sort, label, and category rendering refined; variation template updated. data-controls.jsx reorganized for treemap-specific controls.
  • Label fill resolution consolidated — resolveLabelFill folded into a single getLabelFill helper used across every chart component for consistent dark-mode behavior.
  • Pie chart refactored — Pie.tsx reduced from ~1280 to ~530 lines, consolidating rendering paths. No user-visible behavior change.
  • Chart block migration script tweaked; label controls and contrast adjustments in the migration path.
  • Version constants aligned — PRC_CHART_BUILDER_VERSION bumped from the stale 3.1.0 to 3.8.0 to match the plugin header.

Removed

  • Editor-side canvas PNG generation — chart-png-panel.js and the editor-side createPNG flow are gone. The server-side PNG pipeline introduced in 3.6.0 is now the sole path for chart images.

Fixed

  • Label controls rendering against the wrong contrast value in certain theme contexts.
  • Synced chart reference panel showing post revisions alongside the canonical post.

[3.7.0] — April 2026

Added

  • PCH import pipeline — one-way handoff from pewplots (R) to Chart Builder via .pch.json files. Upload a PCH file in the Chart Builder admin to create a fully configured draft chart post.
  • REST endpoint POST /prc-chart-builder/v1/import-pch — validates, converts, and creates a chart post from a PCH payload. Returns post_id and edit_url.
  • Tidy-to-wide data pivot — PCH stores data in R-native long/tidy format; the importer pivots it to the wide format expected by the Chart Builder table block and charting library.
  • Chart type mapping — resolves PCH chartType + orientation to the correct Chart Builder variation type (e.g. bar + vertical → column; stacked-bar + vertical → stacked-column).
  • 3-layer attribute merge — PCH overrides apply on top of block.json defaults and chart-type variation templates, so type-specific defaults (sort order, axis tick labels, etc.) are preserved unless explicitly overridden by PCH.
  • PCH JSON Schema at includes/chart-handoff/src/schema.json (schema ID prc-chart-handoff/v1).
  • JS converter at includes/chart-handoff/src/pch-to-chart-builder.js with full unit-test coverage (tests/integration/chart-handoff/).
  • Test fixtures for bar, column, stacked bar, diverging bar, line, area, dot-plot, and scatter chart types.
  • PCH technical reference at includes/chart-handoff/README.md.

Fixed

  • v1 block re-migration — deprecations/v1.js isEligible now short-circuits immediately when attributes._version === 'v2', preventing v2 blocks from being flagged as needing migration every time the editor opens.

[3.6.0] — March 2026

Added

  • Server-side PNG export — charts are automatically screenshotted via ScreenshotOne, stored as WordPress media attachments, and served as static fallback images on the frontend.
  • Static fallback image — renders <img class="chart-fallback chart-fallback--png"> when a PNG is available; <div class="chart-fallback chart-fallback--placeholder"> otherwise.
  • Synced chart (refId) PNG resolution — fallback image and Download button correctly resolve PNG meta from the source chart post for synced chart instances.
  • WP-CLI backfill command — wp prc chart-builder backfill_pngs for bulk PNG generation with dry-run support.

Changed

  • Viewer toolbar layout — Chart/Data tabs left-aligned; Download image and Share right-aligned.
  • Active tab display — switched from inline-block to block to remove phantom line-box gap above toolbar.
  • Figure margin — stripped browser default figure margin from figure.wp-chart-builder.
  • Subtitle/note spacing — reduced margin-bottom / margin-top to 4px.

Fixed

  • backfill_pngs processed 0 charts — subcommand name uses underscore, not hyphen; multisite requires --url.
  • Export URL built from local permalink on alpha — generate_png() now accepts $base_url / $export_url_override.
  • $export_url overwritten in CLI loop — renamed per-iteration display variable.
  • Removed alpha-testing qm/debug action and success-path error_log calls from PNG generation.

[3.5.0] — February – March 2026

Added

  • Chart Library admin dashboard — rebuilt on @wordpress/dataviews with a live block preview gallery, visual chart type picker, and drag-and-drop CSV import.
  • AI chart generation — generate a fully configured chart from a natural-language prompt via OpenAI.
  • Click-to-style element popover — click any chart element in the editor to open a targeted style panel for that element.
  • Sankey chart type — flow/relationship diagrams.
  • Treemap chart type — hierarchical data visualizations.
  • Dark mode — supported across all standard chart types.
  • Scatter plot grouping and regression lines — group scatter points by category; overlay linear or polynomial regression lines.
  • Map enhancements — significant improvements to choropleth and symbol map rendering.
  • Axis, label, and annotation improvements — comprehensive additions to axis configuration, data labels, and callout annotations.
  • Pattern-based chart creation — new charts are seeded from variation templates rather than a blank slate.
  • WP-CLI tooling — rewritten CLI commands for bulk operations and chart type backfills.