Tags from SnapshotPreviews

v0.16.0

2026-06-08T18:57:29Z

test(snapshots): Remove excluded preview override from single-module …

…test

Drop the excludedSnapshotPreviews() override in the single-module allow
test so it relies solely on the snapshotPreviewModules() allow list.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

v0.15.0

2026-05-29T21:51:43Z

feat(snapshot): Add metadata modifiers (#264)

Add snapshot tags and additional context modifiers, carrying their metadata
through the existing preference, rendering, and sidecar export pipeline.

Rename the public diff threshold modifier to snapshotDiffThreshold while
keeping the old spelling as a deprecated alias for source compatibility.

Co-authored-by: OpenAI Codex <codex@openai.com>

v0.14.1

2026-05-14T08:35:19Z

Align the docs with Sentry Snapshots and replace references to Emerge…

… Tools where applicable (EME-1115) (#261)

* docs(readme): Lead with snapshot generation and Sentry CI export

Restructure the README so visitors arriving from Sentry docs land on
snapshot generation and the TEST_RUNNER_SNAPSHOTS_EXPORT_DIR export
flow rather than the preview gallery. Move PreviewGallery, accessibility
audits, and PreviewLayoutTest into a later "Additional Features"
section, clarify that the exporter writes PNGs + JSON sidecars (no
Xcode code-coverage data), trim the env-var tip to the variable Sentry
users actually need, and pare back non-essential Emerge branding.

* refactor: Rename .emerge* SwiftUI modifiers to .snapshot* and refresh Sentry docs

User-facing rebrand pass for the Sentry Snapshots integration. The
SnapshotPreviewsCore public API is left untouched because the legacy
Emerge SaaS still binds against it.

Renames (breaking API change for adopters):
- .emergeAccessibility -> .snapshotAccessibility
- .emergeRenderingMode -> .snapshotRenderingMode
- .emergeSnapshotPrecision -> .snapshotPrecision
- .emergeAppStoreSnapshot -> .snapshotAppStore
- .emergeExpansion -> .snapshotExpansion

Other changes:
- Add RUNNING_FOR_SNAPSHOTS env var as the canonical signal that the
app is running inside a snapshot test. EMERGE_IS_RUNNING_FOR_SNAPSHOTS
is still set/read as a deprecated alias.
- Rewrite the README "Uploading Snapshots to Sentry" section around the
documented sentry-cli build snapshots flow, with a complete GitHub
Actions example.
- Fix stale github.com/EmergeTools/SnapshotPreviews-iOS references in
the UnitTestMigration example.
- Clean up "emerge" prose in SnapshotPreferences doc comments and the
RenderingMode.swift file header.

Kept (cross-module ABI with SnapshotPreviewsCore):
- EmergeRenderingMode enum (public parameter type)
- @objc(EmergeModifierState) / @objc(EmergeModifierFinder) classes
(looked up by NSClassFromString from SnapshotPreviewsCore)

* fix(snapshot-preferences): Remove snapshotPrecision modifier

Remove the public snapshotPrecision modifier so diffThreshold is the documented way to customize Sentry Snapshot comparison tolerance.

Update the README sidecar guidance to describe diffThreshold directly and keep the snapshot modifiers table focused on rendering behavior.

Co-Authored-By: OpenAI Codex <codex@openai.com>

* docs: Explain local snapshot output

Document how to write rendered snapshots to disk locally without referring to CI export before the Sentry export flow is introduced.\n\nCo-Authored-By: OpenAI Codex <codex@openai.com>

* docs: Add Sentry Snapshots UI image

Show the visual diff UI in the Sentry upload section so readers can see the snapshot review experience.\n\nCo-Authored-By: OpenAI Codex <codex@openai.com>

* docs: Clarify sidecar metadata fields

Document that display_name and group are generated, not overrideable, and note that future metadata fields should use explicit SnapshotPreferences modifiers.\n\nCo-Authored-By: OpenAI Codex <codex@openai.com>

* docs: Mention Fastlane snapshot upload

Update the Sentry upload section to describe both sentry-cli and Fastlane and link to the Sentry iOS Snapshots CI docs.\n\nCo-Authored-By: OpenAI Codex <codex@openai.com>

* docs: Add snapshot best practices

Add iOS-specific guidance for deterministic previews to avoid flaky snapshot output from network, timing, animation, locale, and clock dependencies.\n\nCo-Authored-By: OpenAI Codex <codex@openai.com>

* docs: Fix README heading levels

Use second-level headings below the README top-level sections so the document hierarchy does not skip from H1 to H3.\n\nCo-Authored-By: OpenAI Codex <codex@openai.com>

* docs: Clarify variant snapshot output

Explain that SnapshotTest renders every emitted preview variant and writes each named variant as its own snapshot image and sidecar.\n\nCo-Authored-By: OpenAI Codex <codex@openai.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: OpenAI Codex <codex@openai.com>

v0.14.0

2026-04-29T09:12:41Z

feat(snapshotting): Add module-based preview filtering (#260)

Allow consumers to include or exclude previews by module name via new
`snapshotPreviewModules()` and `excludedSnapshotPreviewModules()` overrides
on the `PreviewFilters` protocol, mirrored by `SNAPSHOT_PREVIEW_MODULES`
and `EXCLUDED_SNAPSHOT_PREVIEW_MODULES` launch environment variables.

Module names are matched exactly against the prefix of each preview type
name (e.g. "MyModule" in "MyModule.MyView_Previews"), giving multi-module
projects a coarse-grained filter without enumerating individual previews.

Add a MultiModuleDemo example covering the new filters and unit tests
for the module matching helpers.

v0.13.0

2026-04-24T09:27:47Z

ref(snapshotting): Restructure CI export sidecar schema (#259)

* ref(snapshotting): Restructure CI export sidecar schema

Restructures the JSON sidecar emitted via SNAPSHOTS_EXPORT_DIR from a flat
blob into a nested schema with explicit top-level fields for dashboard
filtering and a nested `context` bag for forensic/diagnostic data.

Refs EME-1073

* ref(snapshotting): Move color_mode under context.preferred_color_scheme

Renames and relocates the sidecar's color scheme field. The value reflects
the author-declared `.preferredColorScheme(_:)` modifier, not a rendered
output, so it belongs under `context` (forensic data) with a name that
mirrors the SwiftUI API.

Refs EME-1073

* ref(snapshotting): Drop tags, move orientation and color scheme under preview

Removes the top-level `tags` object. Its `device` field was a duplicate of
`context.simulator.device_name`, and its `orientation` field is a per-preview
author declaration (from `.previewInterfaceOrientation(_:)` or `#Preview`
traits), not a simulator property. Both now live where their provenance
points:

- `context.preview.orientation` joins the other per-preview author
declarations (`display_name`, `preferred_color_scheme`).
- `device_name` remains under `context.simulator` as the single source of
truth.

Refs EME-1073

v0.12.0

2026-04-14T07:36:32Z

feat(snapshots): Add CI image export via SNAPSHOTS_EXPORT_DIR env var…

… (EME-931) (#252)

v0.11.0

2025-11-18T19:21:29Z

v0.10.24

2025-08-14T22:28:55Z

v0.10.23

2025-08-11T17:59:15Z

Add alternative rendering modes on macOS (#241)

* Use CGWindowListCreateImage to generate snapshot.

* Add in an exponential backoff when we try to take a screenshot with CGWindowListCreateImage.

* Add CAlayer-based rendering, and update EmergeRenderingMode to support macOS.

* Capture view controller weakly.

v0.10.22

2025-03-28T14:26:02Z