Sprint 8: add widget manifest and data source engine

docs/Widget-Manifest-Report.md

@@ -0,0 +1,91 @@
+# Widget Manifest Report
+
+## Scope
+
+Sprint 8 introduced a generic widget manifest and data-source engine for the runtime homepage path. The implementation stays within the frozen architecture and does not change Product Domain, Category Domain, authentication, payment, or backend APIs.
+
+The widget engine now resolves widget metadata, supported layouts, supported data sources, settings schema, and default settings from a manifest. Widgets receive only the section config and resolved data.
+
+## Implemented Changes
+
+### Widget Manifest
+
+- `src/app/widgets/contracts/widget-manifest.contract.ts`
+- `src/app/widgets/registry/widget-manifest.service.ts`
+- `src/assets/mock/bootstrap/widget-manifest.json`
+
+Added widget metadata for:
+
+- Hero
+- Categories
+- ProductCollection
+- Banner
+- Html
+- Partners
+- Footer
+
+Each widget definition now exposes:
+
+- supported layouts
+- supported data sources
+- settings schema
+- default settings
+
+### Data Source Resolver
+
+- `src/app/widgets/resolvers/data-source-resolver.service.ts`
+
+Added a generic resolver that delegates to the existing facades:
+
+- `CategoryFacade` for root and parent category data
+- `ProductFacade` for featured, latest, category, manual, and related product data
+
+Supported data source modes include:
+
+- ProductCollection: `featured`, `latest`, `category`, `manual`, `related`, `future`
+- Categories: `root`, `parent`, `manual`, `future`
+
+### Widget Rendering
+
+- `src/app/dynamic-renderer/widget-host/widget-host.service.ts`
+- `src/app/layouts/containers/dynamic-page-layout.component.ts`
+- `src/app/widgets/ui/hero-widget.component.ts`
+- `src/app/widgets/ui/categories-widget.component.ts`
+- `src/app/widgets/ui/product-carousel-widget.component.ts`
+- `src/app/widgets/ui/footer-navigation-widget.component.ts`
+
+Widgets now receive section config plus resolved data only. The layout resolves widgets asynchronously through the host service and renders the resolved component with those two inputs.
+
+### Homepage Bootstrap
+
+- `src/assets/mock/bootstrap/bootstrap.json`
+- `src/assets/mock/bootstrap/homepage.json`
+- `src/app/pages/home/home.component.ts`
+- `src/app/pages/home/home.component.html`
+
+The homepage now resolves from the runtime section collection and includes:
+
+- Hero
+- Categories
+- ProductCollection
+
+## Validation
+
+Completed checks:
+
+- Existing homepage still renders.
+- ProductCollection works through the data-source resolver.
+- Categories work through the data-source resolver.
+- Widget metadata exists in the manifest.
+- Data-source resolution is isolated from widget components.
+- Build passes.
+
+Build validation:
+
+```bash
+npm run build
+```
+
+## Stop Point
+
+Sprint 8 widget-manifest and data-source-engine work is complete. Stop here and wait for approval before extending the manifest system to more pages or adding new widget types.