Skip to content

Commit 7547789

Browse files
author
iexitdev
committed
docs(release): approve developer preview publish scope
1 parent 463e50f commit 7547789

23 files changed

Lines changed: 157 additions & 129 deletions

docs/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,9 @@ These docs describe the current v2 preview implementation in this repository. Th
3434
## Release
3535

3636
- [Accessibility QA protocol](release/accessibility-qa.md)
37-
- [Beta checklist](release/beta-checklist.md)
37+
- [Developer Preview checklist](release/beta-checklist.md)
3838
- [H4 Pro scope decision packet](release/h4-pro-scope.md)
39-
- [H5 beta gate evidence](release/h5-beta-gate-evidence.md)
39+
- [H5 Developer Preview evidence](release/h5-beta-gate-evidence.md)
4040
- [H5 owner decision memo](release/h5-owner-decision-memo.md)
4141
- [Native release checks](release/native-release-checks.md)
4242
- [Native release results](release/native-release-results.md)

docs/charts/bar.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
Use this API for new apps. The v2 package also exports a `StackedBarChart` compatibility facade for legacy stacked-bar data during migration.
66

7-
Status: basic vertical bars and legacy stacked-bar compatibility are free v2 baseline work. Grouped bars, horizontal stacked bars, production tap/tooltip workflows, scrollable fixed-axis workflows, and animated bar variants are Pro candidates until H4 finalizes the package boundary.
7+
Status: basic vertical bars and legacy stacked-bar compatibility are free v2 baseline work. Grouped bars, horizontal stacked bars, production tap/tooltip workflows, scrollable fixed-axis workflows, and animated bar variants are Pro candidates under the H4-approved package boundary.
88

99
## Basic Bars
1010

docs/charts/candlestick.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
CandlestickChart renders OHLC price rows on a shared categorical x-axis. This CKV2-015 preview establishes renderer-agnostic candle geometry, a theme-aware SVG component, and tap inspection for OHLC values.
44

5-
Status: CandlestickChart is a Financial Preview and Pro candidate until H4 finalizes package scope. Keep it visible for API and product review, but do not position it as part of the final free beta yet.
5+
Status: CandlestickChart is a Financial Preview and Pro candidate under the H4-approved package scope. Keep it visible for API and product review, but do not position it as part of the final free Developer Preview.
66

77
```tsx
88
import {

docs/charts/combined.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
CombinedChart overlays bar and line series on a shared x-axis. The first v2 slice supports vertical grouped or stacked bars plus line series with independent left and right y-axis domains.
44

5-
Status: CombinedChart is a Pro-candidate preview until H4 finalizes the free-vs-Pro boundary. The docs stay visible so the API can be reviewed, but dual-axis and shared-inspection workflows should not be treated as final free-beta scope yet.
5+
Status: CombinedChart is a Pro-candidate preview under the H4-approved free-vs-Pro boundary. The docs stay visible so the API can be reviewed, but dual-axis and shared-inspection workflows should not be treated as final free Developer Preview scope.
66

77
```tsx
88
import { CombinedChart } from "@chart-kit/react-native/pro-preview";

docs/internal/ckv2-017-beta-prep.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# CKV2-017 Beta Release Preparation
1+
# CKV2-017 Developer Preview Release Preparation
22

3-
This slice adds concrete release-prep artifacts without publishing a beta.
3+
This slice added concrete release-prep artifacts. H5 later approved a Developer Preview from free packages only.
44

55
## Changed
66

7-
- added beta release checklist
7+
- added release checklist
88
- added known issues list
99
- added GitHub issue forms for layout, compatibility, and performance bugs
1010
- updated CI so pull requests run tests and docs verification, not only build/typecheck
@@ -23,9 +23,10 @@ This slice adds concrete release-prep artifacts without publishing a beta.
2323
- `npm run surface:check`
2424
- `npm run build`
2525

26-
## Remaining H5 Inputs
26+
## H5 Decision
2727

28-
- final beta package/import path
29-
- whether native e2e beyond the web showcase and native release-build gaps are acceptable for beta
30-
- whether candlestick remains public preview or waits for deeper financial-chart scope
31-
- final free-vs-Pro visibility for animation, range selector, and zoom workflows
28+
- publish free packages only under the `next` npm dist-tag
29+
- disclose native e2e, release workflow, accessibility, performance, and Skia gaps
30+
- keep `@chart-kit/pro` and `@chart-kit/skia-renderer` unpublished
31+
- keep candlestick as Financial Preview
32+
- keep advanced workflows labeled preview or Pro-candidate

docs/internal/completion-audit.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Concrete success criteria:
1313
- modern `@chart-kit/react-native` path is usable without the old `chartConfig` API
1414
- Pro/Skia/package boundary is approved and implemented or explicitly deferred
1515
- native iOS and Android release-build behavior is verified
16-
- H4, H5, and H6 owner gates are approved before beta/RC/stable release claims
16+
- H4 and H5 owner gates are approved before Developer Preview claims; H6 is approved before RC/stable release claims
1717

1818
## Evidence Snapshot
1919

@@ -41,8 +41,8 @@ Concrete success criteria:
4141
| Visual baseline | `apps/expo-showcase/visual/__screenshots__`, `npm run test:visual` | Covered for current web showcase |
4242
| RN CLI example source | `examples/rn-cli-basic`, `npm run example:rn-cli:typecheck` | Covered for source and typecheck; generated native projects missing |
4343
| Native release workflow | `.github/workflows/native-release.yml`, `scripts/run-expo-native-release-check.mjs`, `docs/release/native-release-checks.md`, `docs/release/native-release-results.md`, `docs/release/evidence/native-release-workflow.json` | Configured with artifact upload for Android/iOS logs; iOS and Android release builds passed locally; structured evidence records missing green workflow artifacts |
44-
| Release packet | beta checklist, H5 evidence, H4/H6 owner decision memos, known issues, changelog, owner gate recorder, native workflow evidence recorder, generated native QA checklist, native QA evidence recorder, `scripts/check-release-gates.mjs` | Covered for owner review, executable gate reporting, owner-gate manifest validation, H5/H6 prerequisite enforcement, release-evidence manifest consistency validation, local artifact-link validation, native workflow evidence recording, evidence-matrix shape validation, generated native QA execution checklist, and safer row-level evidence capture |
45-
| Package publish manifest | `docs/release/evidence/package-manifest.json`, `scripts/check-package-packs.mjs`, `scripts/list-release-packages.mjs`, `.github/workflows/publish.yml` | Covered: pack dry-runs check all package contents, while beta publish loops only publish manifest entries marked `publishInBeta: true` |
44+
| Release packet | Developer Preview checklist, H5 evidence, H4/H5/H6 owner decision memos, known issues, changelog, owner gate recorder, native workflow evidence recorder, generated native QA checklist, native QA evidence recorder, `scripts/check-release-gates.mjs` | Covered for owner review, executable gate reporting, owner-gate manifest validation, H5/H6 prerequisite enforcement, release-evidence manifest consistency validation, local artifact-link validation, native workflow evidence recording, evidence-matrix shape validation, generated native QA execution checklist, and safer row-level evidence capture |
45+
| Package publish manifest | `docs/release/evidence/package-manifest.json`, `scripts/check-package-packs.mjs`, `scripts/list-release-packages.mjs`, `.github/workflows/publish.yml` | Covered: pack dry-runs check all package contents, while Developer Preview publish loops only publish manifest entries marked `publishInBeta: true` |
4646

4747
## Missing Or Not Fully Verified
4848

@@ -55,20 +55,20 @@ Concrete success criteria:
5555
| Skia renderer | `packages/skia-renderer` exposes an injected primitive adapter. Baseline free chart surfaces can accept it: LineChart, BarChart, PieChart/DonutChart, ProgressChart/ProgressRing, and ContributionGraph/CalendarHeatmap. CombinedChart and CandlestickChart also accept it for Pro-preview workflows. `npm run skia:parity` covers local primitive and renderer-contract parity; `docs/release/evidence/skia-renderer-evidence.json` and `docs/release/evidence/skia-renderer-matrix.json` record the remaining gaps | Native install, native renderer parity, and native Skia performance evidence are not complete |
5656
| Native performance benchmark | Protocol exists, `docs/release/evidence/native-performance-benchmark.json` records partial status, `docs/release/native-qa-checklists.md` provides row-by-row execution guidance, and one Android release-emulator line-animation timing/memory sample is captured. `docs/release/evidence/native-performance-matrix.json` has 18 pending platform/scenario rows | Full release-device matrix is still missing |
5757
| Screen-reader QA | Protocol exists, `docs/release/native-qa-checklists.md` provides row-by-row execution guidance, and `docs/release/evidence/native-accessibility-qa.json` records missing status. `docs/release/evidence/native-accessibility-matrix.json` has 16 pending assistive-tech/page rows | Accessibility helpers exist, but native assistive-tech behavior is not verified |
58-
| H5 approval | Owner has not approved beta publication | Beta cannot be claimed published/approved |
58+
| Developer Preview publish | H5 approved publishing only the free packages under the `next` dist-tag; `@chart-kit/pro` and `@chart-kit/skia-renderer` remain unpublished, and native/runtime/accessibility/performance/Skia gaps must be disclosed | Production beta and RC still require native evidence |
5959
| H6 approval | No RC approval, final semver, final release notes, final visual freeze | Release candidate cannot be claimed |
6060

6161
## Current Gate Position
6262

6363
- H0/H1: covered by prior decisions.
6464
- H2/H3: preview implementation and API are reviewable; final design/API freeze still belongs to beta/RC review.
6565
- H4: approved on May 6, 2026. Pro stays a separate future package, Skia stays a separate optional preview renderer until native evidence is complete, advanced interactions/financial/Skia/large-data workflows stay preview or Pro-candidate for beta, and no license enforcement is added before beta.
66-
- H5: open. Evidence packet, structured native QA/performance matrices, and generated QA checklist exist, but recommendation remains "keep iterating before npm beta" unless owner explicitly accepts native gaps for an API-preview beta.
66+
- H5: approved on May 6, 2026 for Developer Preview only. Publishable packages are `react-native-chart-kit`, `@chart-kit/core`, `@chart-kit/svg-renderer`, and `@chart-kit/react-native` under the `next` dist-tag; `@chart-kit/pro` and `@chart-kit/skia-renderer` stay unpublished.
6767
- H6: not started. RC requires green native workflow evidence, final semver, final changelog, docs freeze, visual baseline freeze, deprecation policy approval, and owner approval. An owner decision memo is available.
6868

6969
## Recommended Next Decisions
7070

7171
1. Run the native release workflow on the release candidate commit to turn local iOS/Android build evidence into CI artifact evidence.
72-
2. Decide H5 beta posture: continue iterating, or explicitly publish an API Preview beta with native gaps disclosed.
72+
2. If publishing Developer Preview, run the publish workflow with npm dist-tag `next` and disclose native/Skia gaps.
7373
3. Run the native runtime, accessibility, performance, and Skia evidence matrices.
7474
4. If production beta is the target, prioritize native device QA and accessibility QA before adding more chart features.

docs/recipes/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Recipes are scenario-first examples for product teams. They should use the modern API and avoid old `chartConfig` patterns.
44

5-
Status: several recipes intentionally demonstrate Pro-candidate workflows, including production touch interactions, range selectors, dual-axis combined charts, grouped/scrollable bars, advanced donut selection, and financial charts. Keep them visible for product review, but do not treat every recipe as final free-beta scope until H4 is approved.
5+
Status: several recipes intentionally demonstrate Pro-candidate workflows, including production touch interactions, range selectors, dual-axis combined charts, grouped/scrollable bars, advanced donut selection, and financial charts. Keep them visible for product review, but do not treat every recipe as final free Developer Preview scope under the H4-approved boundary.
66

77
## Portfolio Price History
88

docs/release/accessibility-qa.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Status on May 5, 2026: protocol ready, native screen-reader evidence missing. Structured gate evidence lives in [native-accessibility-qa.json](evidence/native-accessibility-qa.json), with the page-by-page assistive-technology matrix in [native-accessibility-matrix.json](evidence/native-accessibility-matrix.json). Use the generated [native QA checklist](native-qa-checklists.md) for row-by-row execution.
44

5-
This protocol covers the manual VoiceOver and TalkBack checks required before H5/H6 can claim native accessibility confidence. Automated tests verify generated summaries and data table helpers, but they do not prove native assistive-technology behavior.
5+
This protocol covers the manual VoiceOver and TalkBack checks required before production beta/RC can claim native accessibility confidence. Automated tests verify generated summaries and data table helpers, but they do not prove native assistive-technology behavior.
66

77
## Automated Coverage
88

@@ -70,7 +70,7 @@ For table fallback examples:
7070

7171
## Evidence Log Template
7272

73-
Before H5/H6, capture a completed log:
73+
Before production beta/RC, capture a completed log:
7474

7575
| Date | Commit | Platform | Device/OS | Build | Result | Notes |
7676
| ---- | ------ | ---------------- | --------- | ----- | ------- | ----- |

0 commit comments

Comments
 (0)