@explorer02/cfm-survey-sdk 0.1.9 → 0.2.0

package/templates/docs/MANIFEST.json

@@ -125,5 +125,26 @@
       "component": "01-components/02-question.md",
       "reference": "02-reference/question-types/README.md#text_and_media"
     }
-  }
+  },
+  "uiSpecs": {
+    "questionShell": "03-ui-specs/00-question-shell.md",
+    "rating": "03-ui-specs/01-rating.md",
+    "radio": "03-ui-specs/02-radio.md",
+    "text": "03-ui-specs/03-text.md",
+    "csat": "03-ui-specs/04-csat.md",
+    "rating_scale": "03-ui-specs/05-rating-scale.md",
+    "slider": "03-ui-specs/06-slider.md",
+    "matrix_CFM_MATRIX": "03-ui-specs/07-matrix-cfm.md",
+    "matrix_CSAT_MATRIX": "03-ui-specs/08-matrix-csat-rating.md",
+    "matrix_RATING_MATRIX": "03-ui-specs/08-matrix-csat-rating.md",
+    "slider_matrix": "03-ui-specs/09-slider-matrix.md",
+    "file_upload": "03-ui-specs/10-file-upload.md",
+    "text_and_media": "03-ui-specs/11-text-and-media.md",
+    "surveyChrome": "03-ui-specs/12-survey-chrome.md"
+  },
+  "sharedUiSpecs": {
+    "customSliderTrack": "03-ui-specs/shared/custom-slider-track.md",
+    "matrixDropdown": "03-ui-specs/shared/matrix-dropdown.md"
+  },
+  "configFieldIndex": "02-reference/config-field-index.md"
 }

package/templates/docs/index.md

@@ -11,8 +11,9 @@ docs/
 ├── index.md                 ← YOU ARE HERE
 ├── MANIFEST.json            ← Phase + question-type routing (for tooling)
 ├── 00-integration/          ← Setup, hook contract, constraints
-├── 01-components/           ← UI blueprints (read ALL before coding)
-├── 02-reference/            ← Routing table + question-type data (on demand)
+├── 01-components/           ← Wiring blueprints (read ALL before coding)
+├── 02-reference/            ← Routing table + config-field-index (on demand)
+├── 03-ui-specs/             ← Authoritative UI specs (reference-client driven)
 └── templates/
     └── implementation_plan.md
 ```
@@ -73,7 +74,15 @@ For each question type in the fetched survey, also read matching docs from `02-r
 
 Read: `00-integration/constraints.md`
 
-Implement components per blueprints. Use exported types:
+For each question in `state.currentQuestions`:
+
+1. Read `02-reference/question-types/{type}.md` for data shape
+2. Read `03-ui-specs/{NN}-{type}.md` (use `MANIFEST.json` `uiSpecs`; split matrix by `subType`)
+3. If `matrixFormat`, `buttonType`, or `sliderType` is present → read `03-ui-specs/shared/` specs
+4. Cross-check `02-reference/config-field-index.md` for every non-default field
+5. Match reference client behavior in `apps/client/src/components/` when available
+
+Implement components per blueprints + UI specs. Use exported types:
 
 ```typescript
 import { useSurveySDK, ACTIONS, type SurveyAction } from '@explorer02/cfm-survey-sdk';
@@ -106,4 +115,6 @@ If yes: `npx cfm-sdk deploy` (preferred) or `npx vercel --prod --yes`
 | Always first | `index.md`, `00-integration/setup.md`, `00-integration/useSurveySDK.md`, `00-integration/constraints.md` |
 | Before any React code | All `01-components/*.md` |
 | On demand | `02-reference/question-types/<type>.md` for types in survey |
+| Before building each question | `03-ui-specs/` per `MANIFEST.uiSpecs` |
+| Config audit | `02-reference/config-field-index.md` |
 | Tooling | `MANIFEST.json`, `templates/implementation_plan.md` |

package/templates/docs/templates/implementation_plan.md

@@ -59,6 +59,19 @@ Exhaustive switch — check each:
 | LanguageSelector | | `01-components/12-language-selector.md` | |
 | MatrixDropdown | | `01-components/13-matrix-dropdown.md` | |
 
+## 4b. Per-Question Config & UI Coverage
+
+Fill one row per question in the fetched survey:
+
+| questionId | type | subType | configs detected | uiSpec read | ref component | branches implemented |
+|------------|------|---------|------------------|-------------|---------------|---------------------|
+| | | | | | | |
+
+- **configs detected:** non-default fields from `02-reference/config-field-index.md` (e.g. `matrixFormat: carousel`, `buttonType: emoji`)
+- **uiSpec read:** path from `MANIFEST.json` `uiSpecs` (matrix: use `matrix_{subType}`)
+- **ref component:** `apps/client/src/components/{Component}.tsx`
+- **branches implemented:** list decision-tree branches from the ui-spec (e.g. dropdown vs grid vs carousel)
+
 ## 5. Theme, Brand & Logo
 
 - [ ] CSS-only logo (no `<img>`, no `public/` uploads)