Skip to content

docs: update implementation backlog for the contrast solver replacement - #232

Merged
pbroom merged 1 commit into
mainfrom
docs/backlog-contrast-engine-history
Oct 10, 2026
Merged

pbroom merged 1 commit into
mainfrom
docs/backlog-contrast-engine-history

Conversation

@pbroom

@pbroom pbroom commented Oct 7, 2026 •

Copy link
Copy Markdown
Owner

IB-006 still described the legacy marching-squares and hybrid contrast
engines as current. Mark them as replaced with PR references (#223 retired
the legacy engine, #228 replaced the hybrid solver with the ray-based
solver in contrast/region-solver.ts), record the new options and the
removed ones, and list the two open follow-ups: 7 tiny P3 APCA pieces
missed by the single-extremum scan, and ContrastRegionLayer still
gamut-mapping its reference.

The repo-wide sweep for region-legacy, region-hybrid, hybridMaxDepth,
samplingMode and "legacy engine" found no other docs describing the removed
engines as current; remaining hits are removal notices, changelog entries or
the still-supported gamut/chroma-band samplingMode.

lint, build, test, format:check, typecheck, size, check:artifacts, check:preprod and agents:check:strict all pass on this branch.

Part of the color-kit assessment stack (#204 → #232).

🤖 Generated with Claude Code

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-07T21:29:30.164545Z c6e43c9 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

This was referenced Oct 7, 2026
@pbroom
pbroom force-pushed the docs/backlog-contrast-engine-history branch from 9e41c06 to fd82f77 Compare October 8, 2026 17:04
@pbroom
pbroom force-pushed the refactor/react-color-plane-remove-deprecated branch from 1ffb2c5 to 343d359 Compare October 10, 2026 02:39
@pbroom
pbroom force-pushed the docs/backlog-contrast-engine-history branch from fd82f77 to 5e94eff Compare October 10, 2026 02:39

pbroom commented Oct 10, 2026 •

Copy link
Copy Markdown
Owner Author

Merge activity

  • Oct 10, 6:47 PM UTC: A user started a stack merge that includes this pull request via Graphite.
  • Oct 10, 7:57 PM UTC: Graphite rebased this pull request as part of a merge.
  • Oct 10, 7:57 PM UTC: @pbroom merged this pull request with Graphite.

pbroom added a commit that referenced this pull request Oct 10, 2026
getColorAreaFallbackPoint silently mapped any unknown gamut, such as the
removed 'p3' spelling, to sRGB while every core entry point throws. It now
calls core's assertGamutTarget, so the TypeError wording is identical and
ends "'p3' is not supported; use 'display-p3'".

Validator placement: routing through the core plane fallbackPoint query
would change behaviour (it forces a finite hue and returns unclamped plane
coordinates, while the driver returns clamped, y-flipped UI coordinates
for any axes). The repo has no `./gamut` subpath, and adding one would
widen the package export map, tsup entries and facade. assertGamutTarget
is therefore exported from the existing `./plane` subpath, which already
owns the gamut-taking queries, and not from the root barrel.



lint, build, test, format:check, typecheck, size, check:artifacts, check:preprod and agents:check:strict all pass on this branch.

Part of the color-kit assessment stack (#204 → #232).

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@pbroom
pbroom changed the base branch from refactor/react-color-plane-remove-deprecated to graphite-base/232 October 10, 2026 19:54
pbroom added a commit that referenced this pull request Oct 10, 2026
…l renderer alias (#231)

Hard cut-over, no aliases left behind:

- Remove the deprecated `outOfGamut` prop and the exported
  `ColorPlaneOutOfGamutConfig` type. `edgeBehavior` is now the only way to
  choose the out-of-gamut edge treatment (default 'clamp').
- Remove `'webgl'` from `ColorPlaneRenderer` and delete the runtime mapping
  (and its one-time console warning) that resolved it to 'gpu'.
- Drop the two tests that exercised the removed options.
- Correct the docs API table, which listed the `edgeBehavior` default as
  'transparent'; the component default is 'clamp'.

ColorPlane has no runtime prop validation, so none is added; the old values
are now TypeScript errors. The `renderer="canvas2d"` alias is separate and
unchanged.

BREAKING CHANGE: ColorPlane no longer accepts `outOfGamut` or
`renderer="webgl"`.



lint, build, test, format:check, typecheck, size, check:artifacts, check:preprod and agents:check:strict all pass on this branch.

Part of the color-kit assessment stack (#204 → #232).

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@pbroom
pbroom changed the base branch from graphite-base/232 to main October 10, 2026 19:55
IB-006 still described the legacy marching-squares and hybrid contrast
engines as current. Mark them as replaced with PR references (#223 retired
the legacy engine, #228 replaced the hybrid solver with the ray-based
solver in contrast/region-solver.ts), record the new options and the
removed ones, and list the two open follow-ups: 7 tiny P3 APCA pieces
missed by the single-extremum scan, and ContrastRegionLayer still
gamut-mapping its reference.

The repo-wide sweep for region-legacy, region-hybrid, hybridMaxDepth,
samplingMode and "legacy engine" found no other docs describing the removed
engines as current; remaining hits are removal notices, changelog entries or
the still-supported gamut/chroma-band samplingMode.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@pbroom
pbroom force-pushed the docs/backlog-contrast-engine-history branch from 5e94eff to 6411a19 Compare October 10, 2026 19:56
@pbroom
pbroom merged commit 6cf1c9b into main Oct 10, 2026
6 of 7 checks passed
@pbroom
pbroom deleted the docs/backlog-contrast-engine-history branch October 10, 2026 19:57

This branch was successfully deployed

1 active deployment
Preview — 6411a196 Deployed Oct 10, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant