Astro

Пример для Astro 5: слои под src/, корень композиции в src/pages/, layout и providers в src/app/.

Исходники: examples/astro-pages.

Два корня: pages и app

В pages/ — только routable файлы (index.astro). layout.astro и shop-providers.astro живут в app/, чтобы Astro не создавал лишние маршруты.

Тонкий route

---
import CatalogPage from "@/features/catalog/public/catalog-page.astro";
import ShopProviders from "@/app/shop-providers.astro";
import Layout from "@/app/layout.astro";
---

<Layout title="DMA · Astro mini-shop">
  <ShopProviders>
    <CatalogPage />
  </ShopProviders>
</Layout>

Импорты только вниз: features/*/public/*, services/*/public/*, shared/*.

Frontmatter = module script

Блок --- выполняется на build time:

1. Импортируйте */public/* и стадия-0 модули
2. Вызывайте service helpers до template
3. Передавайте данные в child через props

dma check и Biome plugin парсят импорты из .astro frontmatter так же, как из .ts.

Provider pattern

shop-providers.astro биндит порт до рендера features:

---
import { provideCartSeed } from "@/services/cart/public/ports";
import { demoCartSeed } from "@/app/cart-seed";

provideCartSeed(demoCartSeed);
---
<slot />

Порты невидимы для статического графа — используйте для начальных данных / разрыва цикла, не для обхода promotion. Подробнее — Склейка модулей.

State patterns

1. Размещённый рядом store — catalog.store.ts, импорт relative из public/
2. Promoted service — services/cart/public/cart.ts (catalog + checkout)
3. Provider port — ports.ts + привязка в app/

Куда класть код

Стили

Global CSS — только из корня композиции.

Инструменты

bun run build       # astro build
bun run dma-check   # dma check .
bun run lint        # biome + @derived-modular/biome-plugin
bun run test

Biome plugin — приблизительный (GritQL). Нет полного разрешения путей и циклов графа. Всегда dma check в CI.

Что дальше