benday: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

CONTRIBUTING.md is the human-facing guide and is accurate — read it for the contribution workflow, the changeset rules, and the test rationale. This file covers what is only visible after reading across several files.

Commands

Bun workspaces driven by turbo. Run everything from the repo root.

bun install
bun run dev              # registry:build, then the docs site on :5173
bun run check            # lint and format (ultracite / oxlint + oxfmt)
bun run fix              # apply what check reports
bun run typecheck
bun run test             # the registry suite
bun run knip             # unused files, exports, dependencies
bun run build            # registry payloads, then every app
bun run registry:build   # regenerate apps/web/public/r/*.json only

CI runs check, typecheck, test, knip, registry:build, a git diff --exit-code on apps/web/public/r, and build.

A single test file or a single test — bun test has no turbo wrapper worth using here:

cd registry && bun test tests/bake.test.ts
cd registry && bun test -t "normalizes depth"

The one structural rule

registry/ is the product. It mirrors the tree the shadcn CLI writes into a consumer's project, which is why its internal imports are relative (./benday/renderer) and never aliased, and why only React may be imported. apps/web reaches the same source through the @registry/* alias instead of keeping a copy, so every example on the docs site is the code that ships.

apps/web/public/r/*.json is generated by registry:build and committed. Any change under registry/ must be committed together with the regenerated payloads and a changeset, or CI fails on drift.

Architecture

The pipeline is image → DotMap → canvas. bake.ts rasterizes a logo, separates ink from background (alpha when the source has soft pixels, otherwise a luminance mask estimated from the corners), derives a separate tone channel, runs an exact Euclidean distance transform so every dot carries its depth inside the shape, and grid-samples the result. The output is small and JSON-serializable on purpose: consumers can run the bake at build time and pass dotMap instead of src, skipping all of it on the client. bake is browser-only — it goes through a canvas.