feat (@typegpu/color): Tonemapping functions

[Aquel32]

What was added:

• Most common tonemapping functions such as aces, hable, reinhard and neutral.
• A new dev example (tonemapping) in the docs.
• Dedicated WGSL code validation test.

Closes #1730

[Copilot]

Pull request overview

Adds a set of common tonemapping operators to @typegpu/color and wires them into a new docs dev example, with an accompanying shader-generation snapshot test to ensure the emitted WGSL stays valid/stable.

Changes:

• Introduces tonemapping functions (aces, hable, reinhard, neutral) as tgpu.fn utilities in @typegpu/color.
• Exposes the new tonemapping API via the package entrypoint.
• Adds a new docs example (image-processing/tonemapping) plus an individual example test that snapshots generated WGSL.

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 12 comments.

Show a summary per file

File	Description
packages/typegpu-color/src/tonemapping.ts	New tonemapping function implementations.
packages/typegpu-color/src/index.ts	Re-exports tonemapping functions from the package entrypoint.
apps/typegpu-docs/tests/individual-example-tests/tonemapping.test.ts	Adds an example test that snapshots generated WGSL for the tonemapping demo.
apps/typegpu-docs/src/examples/image-processing/tonemapping/meta.json	Registers the new docs example metadata.
apps/typegpu-docs/src/examples/image-processing/tonemapping/index.ts	Implements the new docs demo using the added tonemapping functions.
apps/typegpu-docs/src/examples/image-processing/tonemapping/index.html	Adds the canvas host for the new example.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[pullfrog]

Important

Two new files use import tgpu from 'typegpu', which fails the repository's internal no-tgpu-default-import lint rule. The PR also needs to run npx oxfmt --write over the changed files before CI will pass.

Reviewed changes — added four GPU tonemapping functions to @typegpu/color, a dev docs example, and an inline-snapshot WGSL smoke test.

• Add aces, hable, reinhard, and neutral tonemapping helpers in packages/typegpu-color/src/tonemapping.ts.
• Export the new functions from packages/typegpu-color/src/index.ts.
• Add a dev example under apps/typegpu-docs/src/examples/image-processing/tonemapping/ with controls and a side-by-side comparison view.
• Add a WGSL code-generation test for the example in apps/typegpu-docs/tests/individual-example-tests/tonemapping.test.ts.

⚠️ Default import tgpu will fail CI

Both packages/typegpu-color/src/tonemapping.ts and the new docs example import tgpu as the default member (import tgpu from 'typegpu'). The internal lint rule eslint-plugin-internal/no-tgpu-default-import is enabled as an error and flags exactly this pattern.

Technical details

# Default `import tgpu` will fail CI

## Affected sites
- `packages/typegpu-color/src/tonemapping.ts:1` — `import tgpu from "typegpu";`
- `apps/typegpu-docs/src/examples/image-processing/tonemapping/index.ts:1` — `import tgpu, { common, d, std } from 'typegpu';`

## Required outcome
- Replace both with `import { tgpu } from 'typegpu';` (and include `common`, `d`, `std` in the named import for the example).
- CI lint must pass after the change.

## Suggested approach
In `packages/typegpu-color/src/tonemapping.ts`: replace line 1 with `import { tgpu } from 'typegpu';`.
In `apps/typegpu-docs/src/examples/image-processing/tonemapping/index.ts`: replace line 1 with `import { tgpu, common, d, std } from 'typegpu';`.

## Open questions for the human
None.

⚠️ Formatting check fails across all changed text files

npx oxfmt --check reports formatting issues in all four changed .ts/.test.ts files. Running npx oxfmt --write packages/typegpu-color/src/tonemapping.ts packages/typegpu-color/src/index.ts apps/typegpu-docs/src/examples/image-processing/tonemapping/index.ts apps/typegpu-docs/tests/individual-example-tests/tonemapping.test.ts fixes them automatically.

Technical details

# Formatting check fails across all changed text files

## Affected sites
- `packages/typegpu-color/src/tonemapping.ts` — double quotes, trailing whitespace, missing trailing commas, missing EOF newline.
- `packages/typegpu-color/src/index.ts` — missing EOF newline.
- `apps/typegpu-docs/src/examples/image-processing/tonemapping/index.ts` — double quotes, `else if` spacing, missing EOF newline.
- `apps/typegpu-docs/tests/individual-example-tests/tonemapping.test.ts` — double quotes, missing trailing commas.

## Required outcome
All changed text files must pass `oxfmt --check`.

## Suggested approach
Run `npx oxfmt --write` on the four files listed above.

## Open questions for the human
None.

  ^{｜ Fix all ➔ ｜ Fix 👍s ➔ ｜ View workflow run ｜ Using Kimi K2 (free via Pullfrog for OSS) ｜ 𝕏}

[cieplypolar]

Running pnpm run fix will resolve most of the issues. It starts by running oxlint --fix. It will list problems that cannot be automatically fixed. Once you have corrected those, a second run with format everything using oxfmt according to our repository standard 🫡 .