Update readme

Author: olimsaidov

README.md

@@ -1,6 +1,6 @@
 # Aidbox Forms Renderer
 
-Minimal React renderer for HL7® FHIR® Questionnaires. State is always a canonical `QuestionnaireResponse`, so the data you display is the data you can submit.
+Minimal React renderer for HL7® FHIR® Questionnaires
 
 ```tsx
 import { Renderer, type Questionnaire, type QuestionnaireResponse } from "aidbox-forms-renderer";
@@ -30,4 +30,84 @@ export function IntakeForm() {
 
 Useful scripts: `npm run dev` (playground), `npm run build` (type-check + bundle), `npm test`, `npm run lint`.
 
-Architecture and rationale live as doc comments in the source (`lib/state/`, `lib/form-provider.tsx`, `lib/questionnaire-renderer.tsx`).
+
+
+# Development Roadmap (Q4 2025)
+
+This roadmap divides implementation milestones by month.
+Each milestone lists the core features and extensions required to reach full compliance with the **HL7 FHIR Structured Data Capture (SDC)** specification.
+
+## 🎯 **October 2025 — Core Questionnaire Rendering**
+
+Focus: Establish baseline FHIR Questionnaire support and base rendering logic.
+
+* [ ] **Core Questionnaire Resource**
+    * [ ] Support `Questionnaire.item` elements (text, type, linkId, required, repeats)
+    * [ ] Implement display of `prefix`, `text`, `item.type`
+    * [ ] Apply constraints: `minLength`, `maxLength`, `minValue`, `maxValue`, `maxOccurs`
+    * [ ] Enable `readOnly`, `initial`, and `defaultValue` behavior
+    * [ ] Support FHIR `enableWhen` conditions and nested groups
+    * [ ] Render `item.control` and `item.control.displayCategory` extensions (basic)
+* [ ] **Questionnaire Navigation & Layout**
+    * [ ] Implement group hierarchy rendering
+    * [ ] Respect `hidden` and `displayCategory` controls
+    * [ ] Add label localization and prefix rendering
+* [ ] **Input Controls**
+    * [ ] Map FHIR types → UI components (`string`, `boolean`, `integer`, `choice`, `date`, `quantity`, etc.)
+    * [ ] Render choice options (`answerOption`, `answerValueSet`)
+    * [ ] Support open-choice types
+* [ ] **Basic Validation**
+    * [ ] Validate required questions
+    * [ ] Validate numeric and string bounds
+    * [ ] Validate answer cardinality (`repeats`, `maxOccurs`)
+
+## ⚙️ **November 2025 — Advanced Form Rendering & Behavior**
+
+Focus: Interactive logic, calculations, adaptive elements, and modular assembly.
+
+* [ ] **Advanced Form Rendering**
+    * [ ] Implement `sdc-questionnaire-itemControl` full support
+    * [ ] Handle `appearance` extension rendering hints
+    * [ ] Support `rendering-style`, `rendering-xhtml`, and `markdown` items
+* [ ] **Form Behavior & Calculation**
+    * [ ] Implement calculated expressions via `calculatedExpression`
+    * [ ] Dynamic enablement: `enableWhenExpression`
+    * [ ] Validation expressions: `constraint`, `constraintExpression`
+    * [ ] Item visibility & computed display expressions
+    * [ ] Value propagation (`derivedFrom`, `answerExpression`)
+* [ ] **Adaptive & Modular Forms**
+    * [ ] Implement `assemble-expectation` and sub-questionnaire resolution
+    * [ ] Support adaptive `next-question` operations (`sdc-questionnaireresponse-adapt`)
+    * [ ] Dynamic loading of next sections via adaptive operation (`Questionnaire/$next-question`)
+    * [ ] Support inclusion of external subforms and library dependencies
+* [ ] **User Interaction Layer**
+    * [ ] Autosave progress to `QuestionnaireResponse`
+    * [ ] Support for resuming saved sessions
+    * [ ] Dynamic updates to visible fields based on answers
+
+## 🧩 **December 2025 — Data Population & Extraction**
+
+Focus: Form prefill, structured output mapping, and integration services.
+
+* [ ] **Form Population**
+    * [ ] Implement population via:
+        * [ ] `initialExpression`
+        * [ ] `itemPopulationContext`
+        * [ ] `candidateExpression`
+    * [ ] Support FHIR `$populate` operation (StructureMap-based)
+    * [ ] Integrate population service from external data sources (Patient, Observation, etc.)
+* [ ] **Form Data Extraction**
+    * [ ] Implement FHIR `$extract` operation
+    * [ ] Map responses → resources using `structureMap`
+    * [ ] Handle `extract` extensions: `sdc-questionnaire-extract`, `itemExtractionContext`
+* [ ] **Export and Serialization**
+    * [ ] Generate valid `QuestionnaireResponse`
+    * [ ] Support export in JSON and XML
+    * [ ] Validate `QuestionnaireResponse` against source `Questionnaire`
+* [ ] **Polish & QA**
+    * [ ] Test all `must-support` extensions from SDC profiles
+    * [ ] Ensure conformance with:
+        * [ ] `sdc-questionnaire-render`
+        * [ ] `sdc-questionnaire-adapt`
+        * [ ] `sdc-questionnaire-extract`
+    * [ ] Accessibility and internationalization compliance

index.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>FHIRPath Editor</title>
+    <title>Aidbox Forms Renderer</title>
   </head>
   <body>
     <div id="root" class="contents"></div>