Initial Commit

openspec/archive/2026-05-25-enterprise-form-builder/tasks.md

@@ -0,0 +1,123 @@
+# Tasks — enterprise-form-builder
+
+> Tick each box as work lands. Every requirement in `specs/form-builder/spec.md` is reflected
+> below. **Never silently skip a requirement because "tests already pass without it."**
+
+## 1. Scaffold
+
+- [ ] Create `packages/ui/forms/form-builder/` (package.json `0.1.0`, tsconfig.lib.json,
+      vite.config.ts, vitest.config.ts, tests/setup/polyfills.ts).
+- [ ] Add canonical subpath exports in `package.json` for every feature module.
+- [ ] Add catalog deps (`@opentelemetry/api`, `zod`, `tslib`).
+
+## 2. Types & constants
+
+- [ ] `src/types/form.types.ts` — `FieldType`, `FieldDefinition`, `FormSection`, `FormSchema`,
+      `FormValues`, `FormState`, `FormEventMap`, `ValidationRule`, `ValidationError`,
+      `ConditionalRule`, `SelectOption`, `LeafOperator`.
+- [ ] `src/constants/index.ts` — `FIELD_TYPES`, `LEAF_OPERATORS`, `BUILT_IN_RULES`,
+      `DEFAULT_UNDO_CAPACITY`.
+
+## 3. Errors
+
+- [ ] `src/errors/form-error/form-error.ts` — `FORM_BUILDER_CODES` (`defineCodes`), `FormError`
+      extends `SuaveplanError<FormBuilderCode>`; factory helpers `fieldNotFound`,
+      `sectionNotFound`, `duplicateId`, `configInvalid`, `validationFailed`, `cyclicDependency`.
+- [ ] `form-error.test.ts` — every factory + code reachable.
+
+## 4. Schema (Zod boundary)
+
+- [ ] `src/schema/schema/schema.ts` — Zod schemas for `FieldDefinition`, `FormSection`,
+      `FormSchema`, `ValidationRule`, `ConditionalRule`; `parseFormSchema(raw)`.
+- [ ] `schema.test.ts` — valid + invalid inputs raise `FORM_BUILDER.CONFIG_INVALID`.
+
+## 5. Field registry
+
+- [ ] `src/fields/field-registry/field-registry.ts` — `FieldRegistry` class, 17 built-in field
+      types registered out-of-the-box; `register`, `unregister`, `has`, `get`, `list`.
+- [ ] `field-registry.test.ts`.
+
+## 6. Validators
+
+- [ ] `src/validation/validators/validators.ts` — 11 rule runners
+      (`required`, `minLength`, `maxLength`, `min`, `max`, `pattern`, `email`, `url`, `oneOf`,
+      `equalsField`, `custom`); async-friendly contract via `Promise<ValidationError | null>`.
+- [ ] `validators.test.ts`.
+
+## 7. Validation engine
+
+- [ ] `src/validation/validation/validation.ts` — `runFieldValidation`, `runFormValidation`,
+      `AbortSignal` propagation, OTel counter + histogram emission.
+- [ ] `validation.test.ts`.
+
+## 8. Conditional logic
+
+- [ ] `src/conditional/conditional/conditional.ts` — `evaluateConditional(rule, values)`; 9 leaf
+      operators + `and` / `or` / `not`.
+- [ ] `conditional.test.ts`.
+
+## 9. Dependency graph
+
+- [ ] `src/conditional/dependency-graph/dependency-graph.ts` — `DependencyGraph`: build from
+      fields, topo sort, cycle detection (`FORM_BUILDER.CYCLIC_DEPENDENCY`).
+- [ ] `dependency-graph.test.ts`.
+
+## 10. State + undo/redo
+
+- [ ] `src/state/form-state/form-state.ts` — `FormState` machine: `setValue`, `setValues`,
+      `touch`, `reset`, dirty + valid flags.
+- [ ] `src/state/undo-redo/undo-redo.ts` — bounded `UndoRedoStack`.
+- [ ] `form-state.test.ts`, `undo-redo.test.ts`.
+
+## 11. Serialise + Zod-schema generator
+
+- [ ] `src/serialise/serialise/serialise.ts` — `serialiseForm` / `deserialiseForm`; versioned
+      wire format with Zod validation on `deserialiseForm`.
+- [ ] `src/zod-schema/zod-schema/zod-schema.ts` — `toZodSchema(form)`.
+- [ ] Round-trip + cross-check tests.
+
+## 12. Submission
+
+- [ ] `src/submission/submission/submission.ts` — `submit({ form, values, submitter, signal })`;
+      `prepare → validate → transform → submit`; OTel counter + histogram emission.
+- [ ] `submission.test.ts`.
+
+## 13. OTel instruments
+
+- [ ] `src/otel/instruments/instruments.ts` — lazy `Counter`s + `Histogram`s.
+- [ ] `instruments.test.ts` — every instrument emits at least once under a real
+      `MeterProvider` from `@opentelemetry/sdk-metrics`.
+
+## 14. Builder
+
+- [ ] `src/builder/form-builder/form-builder.ts` — `FormBuilder<TEvents>` aggregating the above;
+      `createSchema`, `addField`, `removeField`, `updateField`, `addSection`, `removeSection`,
+      `getField`, `getSchema`, `validateField`, `validateForm`, `getVisibleFields`, `setValues`,
+      `resetForm`, `getState`, `toJSON`, `getSectionById`, `enableHistory`, `undo`, `redo`,
+      `submit`. EventBus emission.
+- [ ] `form-builder.test.ts` — every behaviour scenario from the spec delta.
+
+## 15. README + barrel
+
+- [ ] Package `README.md` (purpose, install, full feature list, examples).
+- [ ] `src/index.ts` — explicit named re-exports per §6a.
+
+## 16. Pre-publish gate
+
+- [ ] `bunx turbo lint typecheck test build --filter=@suaveplan/form-builder` green.
+- [ ] `bunx turbo test:coverage --filter=@suaveplan/form-builder` — 100 / 100 / 100 / 100.
+- [ ] `grep -rnE "from ['\"](vitest|bun:test)['\"]" packages/ui/forms/form-builder/src/` zero.
+- [ ] `grep -rnE "biome-ignore" packages/ui/forms/form-builder/src/` zero.
+
+## 17. Refresh & archive
+
+- [ ] `bun scripts/folder-reorg/generate-manifest.ts` to refresh `MANIFEST.md`.
+- [ ] Flip `@suaveplan/form-builder` row in `STATUS.md` from `–` to `✅`; update counter
+      (+1 migrated / -1 pending).
+- [ ] Fold `specs/form-builder/spec.md` into `openspec/specs/form-builder/spec.md`.
+- [ ] Move change folder to `openspec/archive/2026-05-25-enterprise-form-builder/`.
+
+## 18. Commit
+
+- [ ] Branch `feat/migrate-form-builder`; conventional commit; Claude co-author footer; **do
+      not push**.