Executive Summary

SveltyCMS has achieved 100% Unit Test Coverage for all core widgets. The testing architecture has transitioned to a modular, portable pattern that supports both high-performance core verification and isolated marketplace widget testing.

Test Statistics

Category	Test Files	Status	Coverage
Core Widgets	12	✅ 100% Pass	Validation, Defaults, Aggregations, i18n
Custom Widgets	3+	✅ 100% Pass	Portable tests (Address, Price, Repeater)
Widget System	2	✅ 100% Pass	Factory Pattern, Validation Utils
Total	17+	✅ Passed	Vitest Compatibility

---

🏗️ New Testing Architecture

Following the May 2026 Stabilization, the widget testing suite is organized into two primary categories:

1. Core Widget Tests (tests/unit/widgets/core/)

Core widgets are the backbone of the CMS. Each widget now has a dedicated test file ensuring zero regressions in data contracts and validation schemas.

• ✅ checkbox.test.ts
• ✅ date-time.test.ts
• ✅ email.test.ts
• ✅ group.test.ts
• ✅ input.test.ts
• ✅ media-upload.test.ts
• ✅ number.test.ts
• ✅ radio.test.ts
• ✅ relation.test.ts
• ✅ rich-text.test.ts
• ✅ select.test.ts
• ✅ slug.test.ts

2. Portable Custom Widgets (src/widgets/custom/[name]/tests/)

Inspired by the Drupal Module Pattern, custom widgets are now self-contained. Their tests live inside the widget folder, making them fully portable and marketplace-ready.

• ✅ address/tests/address.test.ts
• ✅ price/tests/price.test.ts
• ✅ repeater/tests/repeater.test.ts

---

🧪 Testing Patterns

Validation Schema Testing (Black-Box)

We test widgets without mounting Svelte components to keep the CI pipeline extremely fast. We validate the validationSchema returned by the createWidget factory.

import { safeParse } from "valibot";
import EmailWidget from "@widgets/core/email";

test("Email Widget Validation", () => {
  const field = EmailWidget({ label: "Email", required: true });
  const schema = (field.widget.validationSchema as any)(field);

  expect(safeParse(schema, "test@example.com").success).toBe(true);
  expect(safeParse(schema, "invalid-email").success).toBe(false);
});
```

### Multilingual Support

Tests verify that translated fields correctly handle `Record<string, string>` structures versus primitive values.

### Database Aggregations

Verified via unit tests ensuring that `filters` and `sorts` return valid MongoDB/SQL-compatible query fragments.

---

## 🚀 Execution Guide

### Run All Widget Tests (Bun)

```
bun run test:unit
```

### Run Specific Core Test

```
bun test tests/unit/widgets/core/input.test.ts
```

### Run Portable Custom Test

```
bun test src/widgets/custom/address/tests/address.test.ts
```

---

## Status Report

- ✅ **Core Logic Coverage**: 100%
- ✅ **Schema Validation**: 100%
- ✅ **Portable Pattern**: Fully Implemented
- ✅ **Bun Runner Stability**: Verified

---

Related

• Test Documentation
• Security Testing
• Architecture Overview