Skip to content

E0: удалить преждевременный browser API - #356

Merged
lemone112 merged 3 commits into
mainfrom
agent/e0-browser-shell-cleanup
Jul 19, 2026
Merged

E0: удалить преждевременный browser API#356
lemone112 merged 3 commits into
mainfrom
agent/e0-browser-shell-cleanup

Conversation

@lemone112

@lemone112 lemone112 commented Jul 19, 2026

Copy link
Copy Markdown
Collaborator

Корневая проблема

Browser-пакет публиковал незавершённые вспомогательные поверхности до того, как у продукта появился единый point-compositor и честная модель неизвестного backdrop. Это создавало второй источник истины и преждевременный API-контракт.

Что изменено

  • удалены публичные effective-bg и JS-FNV поверхности, их типы, экспорт и самопроверяющий differential-тест;
  • удалён неиспользуемый legacy-флаг strict из заявлений Rust/WASM/npm;
  • FNV-векторы оставлены как канонический Rust-тест, без дублирующей JS-реализации;
  • release-проверка теперь устанавливает свежий tarball и доказывает отсутствие удалённых root/subpath-экспортов, а также работоспособность adaptTheme/watchTheme;
  • внутренний DOM-walker пока остаётся package-private: его заменят C8b/C8c единым WASM compositor и типизированным unknown-backdrop, без расширения публичного API.

Доказательства

  • cleanup: 3/3;
  • npm: 233/233;
  • TypeScript: green;
  • native WASM contract: 5/5;
  • cargo fmt --all -- --check: green;
  • clean-install smoke: 22 files, 244941 B packed / 615807 B unpacked;
  • canonical WASM SHA-256 не изменился: 310b54201a80e9c9c2212ddfc94c76b7a3cf4a7b8a3dfd003d7a1e38ad39bfae;
  • независимое архитектурное/API/documentation review: APPROVE.

Это deletion-first срез: 255 добавлений, 748 удалений.

Summary by CodeRabbit

  • Изменения API

    • Удалён публичный модуль вычисления эффективного фона и связанные функции и типы.
    • Удалён экспорт JavaScript-хеша FNV-1a.
    • Из adaptTheme убрана опция strict.
  • Изменения поведения

    • Промежуточные кадры адаптивного перехода теперь отображаются без гарантии соответствия контрастному порогу.
    • Адаптация использует переданный конечный набор образцов фона.
  • Документация

    • Обновлены примеры и описания watchTheme и adaptTheme.
    • Уточнены формулировки о проверке контраста и происхождении тестовых значений.
  • Проверки

    • Обновлены smoke-, интеграционные и контрактные проверки нового публичного API.

@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 45 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 687db17b-9a79-496f-9f0c-c2286efe4d5b

📥 Commits

Reviewing files that changed from the base of the PR and between 0eaa8b6 and 81db500.

📒 Files selected for processing (3)
  • crates/labcolors-wasm/Cargo.toml
  • packages/colors/effective-bg.js
  • packages/colors/test/public-api-cleanup.test.mjs

Walkthrough

Удалён legacy strict floor-clamp из adaptTheme, сокращены hot-path и публичные exports, включая effectiveBackground и JavaScript FNV-зеркало. Обновлены TypeScript-контракты, smoke/release-проверки, тесты и документация runtime/WASM.

Changes

Runtime API и переходы

Layer / File(s) Summary
Упрощение adaptive transition
packages/colors/adapt-theme.*, packages/colors/test/adapt-theme.test.mjs, packages/colors/bench/*, packages/colors/smoke.consumer.ts, packages/colors/README.md
Удалены strict, floor-latch и WCAG-кламп; easing использует только интерполированные значения, а промежуточные кадры проверяются как несертифицированные.
Effective-background surface
packages/colors/effective-bg.*, packages/colors/index.*, packages/colors/package.json, packages/colors/test/hotpath-parity.test.mjs, packages/colors/README.md
Удалены luminance helpers, lerpPairLuminance, byte-копии compiled pairs и публичные exports effective-bg.
Release и public-contract проверки
packages/colors/test/public-api-cleanup.test.mjs, packages/colors/test/release-contract.test.mjs, packages/colors/test/public-claims.test.mjs, packages/colors/tsconfig.json, scripts/verify-package-release.mjs
Проверки подтверждают отсутствие удалённых API, strict-опции и FNV JavaScript-зеркала, а smoke-тесты покрывают доступные watchTheme и adaptTheme.
FNV characterization
crates/labcolors-core/src/hash.rs, crates/labcolors-core/tests/*, packages/colors/fnv1a.*
Rust-документация и имена векторных тестов используют frozen characterization; JavaScript-модуль FNV и differential test удалены.
Runtime/WASM документация
crates/labcolors-wasm/*, packages/colors/README.md
Уточнены границы WASM-конфигурации, ABI recheck, hex-парсинга и семантика отсутствия сертификации промежуточных кадров.

Estimated code review effort: 4 (Complex) | ~60 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 60.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Заголовок соответствует основному изменению: удалению преждевременно опубликованного browser API и связанных экспортов.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agent/e0-browser-shell-cleanup

Comment @coderabbitai help to get the list of available commands.

Copy link
Copy Markdown
Collaborator Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Copy link
Copy Markdown
Collaborator Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/colors/effective-bg.js (1)

313-323: 🎯 Functional Correctness | 🔵 Trivial | 💤 Low value

Инвариант «read-only» задокументирован, но не защищён на уровне кода.

parseCssColorCached возвращает элемент кэша напрямую; случайная мутация массива вызывающей стороной незаметно испортит запись в parseCache для всех последующих обращений с той же строкой. Комментарий фиксирует контракт, но не гарантирует его.

🛡️ Возможное усиление инварианта
 export function parseCssColorCached(css) {
   let hit = parseCache.get(css);
   if (hit === undefined) {
     hit = parseCssColor(css);
+    if (hit) Object.freeze(hit);
     if (parseCache.size >= PARSE_CACHE_CAP) parseCache.clear();
     parseCache.set(css, hit);
   }
   return hit;
 }
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/colors/effective-bg.js` around lines 313 - 323, Защитите запись в
parseCache от мутаций вызывающей стороны в parseCssColorCached: возвращайте
копию закэшированного массива, а не hit напрямую, сохраняя оригинал только
внутри кэша. Не изменяйте поведение parseCssColor для некэшированных вызовов и
логику заполнения кэша.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@crates/labcolors-wasm/Cargo.toml`:
- Around line 18-21: Сократите комментарий в Cargo.toml, удалив упоминания
pre-cutover, целевой архитектуры, миграции и отсутствия второго артефакта.
Оставьте только устойчивый инвариант: этот WASM-артефакт владеет
JSON-конфигурацией и legacy resolve/recheck bindings с point evaluators, а также
границы ответственности. Переведите итоговый комментарий на краткий русский
язык.

---

Outside diff comments:
In `@packages/colors/effective-bg.js`:
- Around line 313-323: Защитите запись в parseCache от мутаций вызывающей
стороны в parseCssColorCached: возвращайте копию закэшированного массива, а не
hit напрямую, сохраняя оригинал только внутри кэша. Не изменяйте поведение
parseCssColor для некэшированных вызовов и логику заполнения кэша.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 8cd6acb7-ee88-432e-ac89-2c3d94bd3c4d

📥 Commits

Reviewing files that changed from the base of the PR and between cf69e10 and 0eaa8b6.

📒 Files selected for processing (28)
  • crates/labcolors-core/src/hash.rs
  • crates/labcolors-core/tests/data/fnv1a-vectors.txt
  • crates/labcolors-core/tests/fnv1a_vectors.rs
  • crates/labcolors-wasm/Cargo.toml
  • crates/labcolors-wasm/src/dto.rs
  • crates/labcolors-wasm/src/engine.rs
  • crates/labcolors-wasm/src/lib.rs
  • packages/colors/README.md
  • packages/colors/adapt-theme.d.ts
  • packages/colors/adapt-theme.js
  • packages/colors/bench/hotpath.bench.mjs
  • packages/colors/effective-bg.d.ts
  • packages/colors/effective-bg.js
  • packages/colors/fnv1a.d.ts
  • packages/colors/fnv1a.js
  • packages/colors/index.d.ts
  • packages/colors/index.js
  • packages/colors/package.json
  • packages/colors/smoke.consumer.ts
  • packages/colors/test/adapt-theme-translucent.test.mjs
  • packages/colors/test/adapt-theme.test.mjs
  • packages/colors/test/fnv1a-differential.test.mjs
  • packages/colors/test/hotpath-parity.test.mjs
  • packages/colors/test/public-api-cleanup.test.mjs
  • packages/colors/test/public-claims.test.mjs
  • packages/colors/test/release-contract.test.mjs
  • packages/colors/tsconfig.json
  • scripts/verify-package-release.mjs
💤 Files with no reviewable changes (10)
  • packages/colors/fnv1a.d.ts
  • packages/colors/tsconfig.json
  • packages/colors/fnv1a.js
  • packages/colors/test/fnv1a-differential.test.mjs
  • packages/colors/effective-bg.d.ts
  • packages/colors/index.d.ts
  • packages/colors/adapt-theme.d.ts
  • packages/colors/test/public-claims.test.mjs
  • packages/colors/package.json
  • packages/colors/test/adapt-theme-translucent.test.mjs

Comment thread crates/labcolors-wasm/Cargo.toml Outdated

Copy link
Copy Markdown
Collaborator Author

Оба замечания исправлены в 3d1f734.

  • Миграционная хроника удалена из Cargo-комментариев; оставлены только устойчивые ownership/runtime-dependency/size-ratchet инварианты.
  • Shared parse-cache entry больше не экспортируется: lexical private helper имеет единственного consumer-а compileLerpPair, который сразу создаёт собственные la/lb arrays и hex. Это структурно закрывает мутацию без copy/freeze и без аллокации на cache hit.
  • RED→GREEN anti-vacuum test доказывает отсутствие export.
  • npm 234/234, typecheck, fmt и diff check — green; targeted independent repair review — APPROVE.

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown

@lemone112, thanks for the detailed fix summary. I’ll review the updates in 3d1f734, including the restored encapsulation and the anti-vacuum regression coverage.

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Copy link
Copy Markdown
Collaborator Author

Branch synchronised with merged V1a main at 985d140 without history rewrite; PR diff remains E0-only. Final exact head: 81db500. @coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown

@lemone112, I’ll review the PR at final head 81db500, with the V1a-main synchronization context in mind.

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@lemone112
lemone112 marked this pull request as ready for review July 19, 2026 18:08
@lemone112
lemone112 merged commit 98eda0c into main Jul 19, 2026
10 checks passed
@lemone112
lemone112 deleted the agent/e0-browser-shell-cleanup branch July 19, 2026 18:08
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