distributor/docs/internal/transform.md

# Transform

## Purpose

`internal/transform` defines generated publication artifacts. `internal/transform/markdown` implements Markdown-to-HTML sidecar generation.

## Inputs and outputs

Inputs are a validated source bundle and source backend. Outputs include destination path, source path, transform id, generated bytes, SHA-256, and size.

## Markdown behavior

Markdown files ending in `.md` generate `.html` files in the same logical directory. Non-Markdown files do not generate outputs. Raw HTML embedded in Markdown is not passed through by the renderer.

Generated HTML is deterministic for the same source content and transform configuration.

## Boundaries

Transforms do not publish files, mutate source bundles, or write destination state. Publish planning selects and writes transform outputs.

The app layer owns default transform registration. The transform package does not import concrete transform implementations.

## Tests

Before changing transform behavior, inspect tests under `internal/transform`.