# Import Boundary Matrix

Status: Mandatory
Date: 2026-07-03

## Allowed Import Matrix

Legend:

- Yes: Allowed
- No: Forbidden
- Limited: Allowed only via published contracts

| From \ To | Core | Shared | UI Library | Widgets | Layouts | Pages | Features | Facades | Integrations |
|---|---|---|---|---|---|---|---|---|---|
| Core | Yes | Yes | No | No | No | No | No | No | Limited |
| Shared | Yes | Yes | No | No | No | No | No | No | No |
| UI Library | Shared only | Yes | Yes | No | No | No | No | No | No |
| Widgets | Shared/Core contracts | Yes | Yes | Yes | No | No | No | Limited | No |
| Layouts | Shared/Core contracts | Yes | Yes | Yes | Yes | No | No | Limited | No |
| Pages | Shared/Core contracts | Yes | Yes | Yes | Yes | Yes | No | Yes | No |
| Features | Shared/Core contracts | Yes | Yes | Yes | Yes | Yes | No direct feature-to-feature | Yes | Limited |
| Facades | Shared/Core contracts | Yes | No | No | No | No | Limited | Yes | Yes |
| Integrations | Shared/Core contracts | Yes | No | No | No | No | No | Limited | Yes |

## Additional Constraints

- Features cannot import other features directly.
- Shared cannot import any feature, page, layout, widget, or UI layer.
- UI Library cannot import facades, integrations, router, or HttpClient.
- Core cannot import features.
- Circular dependencies are forbidden in all directions.

## Enforcement

- Enforce with lint module boundaries.
- Enforce with dependency graph checks in CI.
- Merge blocked on violations.
