udp-schema 0.3.0 → 1.1.0

package/dist/field-helpers.d.ts

@@ -1,55 +1,42 @@
 /**
- * Convenience helpers for accessing UDP field metadata.
+ * Convenience helpers for accessing UDP field metadata and step schemas.
  *
- * Mirrors the dating-schema `field-helpers.ts` pattern:
- * pre-built lookup maps with `getUdpFieldOptions()` and `getUdpFieldMeta()`.
+ * Mirrors the dating-schema field-helpers.ts pattern:
+ * pre-built lookup maps with getFieldOptions() and getFieldMeta().
  *
  * @module udp-schema/field-helpers
  */
-import { type UdpFieldMeta, type UdpFieldOption } from './field-meta.js';
+import type { z } from 'zod';
+import type { FieldOption, ProfileField } from './profile-fields/types.js';
 /**
- * Get the `{ value, label }` options array for a UDP field by its key.
+ * Get the `{ value, label, description }` options array for a field by its key.
  *
  * @example
  * ```ts
- * import { getUdpFieldOptions } from 'udp-schema';
- * const opts = getUdpFieldOptions('desireToBeLeader');
- * // → [{ value: 'YES_STRONGLY', label: 'desireToBeLeader_YES_STRONGLY' }, ...]
+ * import { getFieldOptions } from 'udp-schema';
+ * const opts = getFieldOptions('gender');
+ * // → [{ value: 'man', label: 'Man' }, { value: 'woman', label: 'Woman' }, ...]
  * ```
  */
-export declare function getUdpFieldOptions(fieldKey: string): readonly UdpFieldOption[];
+export declare function getFieldOptions(fieldKey: string): readonly FieldOption[];
 /**
- * Get full field metadata (label, step, component, options, etc.) by key.
+ * Get full field metadata (label, description, step, type, options, etc.) by key.
  *
  * @example
  * ```ts
- * import { getUdpFieldMeta } from 'udp-schema';
- * const meta = getUdpFieldMeta('gender');
- * // → { key: 'gender', step: 1, labelKey: 'gender', component: 'genderSelector', options: [...], immutable: true }
+ * import { getFieldMeta } from 'udp-schema';
+ * const meta = getFieldMeta('familyReligion');
+ * // → { key: 'familyReligion', label: 'Family Religion', type: 'single_select', step: 1, options: [...], ... }
  * ```
  */
-export declare function getUdpFieldMeta(fieldKey: string): UdpFieldMeta | undefined;
+export declare function getFieldMeta(fieldKey: string): ProfileField | undefined;
 /**
- * Get all field metadata entries for a given step number.
- *
- * @example
- * ```ts
- * import { getUdpStepFields } from 'udp-schema';
- * const step5Fields = getUdpStepFields(5);
- * // → [{ key: 'desireToBeLeader', ... }, { key: 'desiredPoliticalPosition', ... }, ...]
- * ```
+ * Get the Zod schema for a given step number.
+ * Use `.partial().parse(data)` for sub-step saves.
  */
-export declare function getUdpStepFields(stepNumber: number): readonly UdpFieldMeta[];
+export declare function getStepSchema(stepNumber: number): z.ZodObject<any> | undefined;
 /**
  * Get the list of field keys that are immutable after volunteer approval.
- * These fields can only be changed by a volunteer in survey-mode once approved.
- *
- * @example
- * ```ts
- * import { getImmutableFields } from 'udp-schema';
- * const locked = getImmutableFields();
- * // → ['firstName', 'middleName', 'lastName', 'gender', 'dateOfBirth', 'phonePrimary']
- * ```
  */
 export declare function getImmutableFields(): readonly string[];
 //# sourceMappingURL=field-helpers.d.ts.map

package/dist/field-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-helpers.d.ts","sourceRoot":"","sources":["../src/field-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAkB,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AA8BzF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,CAE9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAE5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD"}
+{"version":3,"file":"field-helpers.d.ts","sourceRoot":"","sources":["../src/field-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AA8B3E;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAExE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEvE;AAoBD;;;GAGG;AAEH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAE9E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD"}

package/dist/field-helpers.js

@@ -1,85 +1,90 @@
 /**
- * Convenience helpers for accessing UDP field metadata.
+ * Convenience helpers for accessing UDP field metadata and step schemas.
  *
- * Mirrors the dating-schema `field-helpers.ts` pattern:
- * pre-built lookup maps with `getUdpFieldOptions()` and `getUdpFieldMeta()`.
+ * Mirrors the dating-schema field-helpers.ts pattern:
+ * pre-built lookup maps with getFieldOptions() and getFieldMeta().
  *
  * @module udp-schema/field-helpers
  */
-import { UDP_FIELD_META } from './field-meta.js';
-// ─── Pre-built lookup maps ───────────────────────────────────────────────────
+import { allFieldGroups } from './profile-fields/index.js';
+import { step01ProfileSchema } from './step-01.schema.js';
+import { step02PoliticalSchema } from './step-02.schema.js';
+import { step03ElectoralSchema } from './step-03.schema.js';
+import { step04LeadershipSchema } from './step-04.schema.js';
+import { step05PsychologicalSchema } from './step-05.schema.js';
+import { step06EducationSchema } from './step-06.schema.js';
+import { step07EmploymentSchema } from './step-07.schema.js';
+import { step08NeurodiversitySchema } from './step-08.schema.js';
+import { step09HealthSchema } from './step-09.schema.js';
+import { step10WorldViewSchema } from './step-10.schema.js';
+import { step11ResidenceSchema } from './step-11.schema.js';
+import { step12HouseholdSchema } from './step-12.schema.js';
+// ─── Pre-built lookup maps (like dating-schema) ────────────────────────────
 const optionsMap = new Map();
 const fieldMap = new Map();
-const stepFieldsMap = new Map();
-const immutableFieldKeys = [];
-for (const meta of Object.values(UDP_FIELD_META)) {
-    fieldMap.set(meta.key, meta);
-    if (meta.options) {
-        optionsMap.set(meta.key, meta.options);
-    }
-    if (meta.immutable) {
-        immutableFieldKeys.push(meta.key);
-    }
-    const existing = stepFieldsMap.get(meta.step);
-    if (existing) {
-        existing.push(meta);
-    }
-    else {
-        stepFieldsMap.set(meta.step, [meta]);
+for (const group of allFieldGroups) {
+    for (const field of group.fields) {
+        fieldMap.set(field.key, field);
+        if ('options' in field && Array.isArray(field.options)) {
+            optionsMap.set(field.key, field.options);
+        }
     }
 }
-// ─── Public helpers ──────────────────────────────────────────────────────────
+// ─── Field metadata helpers (like dating-schema) ────────────────────────────
 /**
- * Get the `{ value, label }` options array for a UDP field by its key.
+ * Get the `{ value, label, description }` options array for a field by its key.
  *
  * @example
  * ```ts
- * import { getUdpFieldOptions } from 'udp-schema';
- * const opts = getUdpFieldOptions('desireToBeLeader');
- * // → [{ value: 'YES_STRONGLY', label: 'desireToBeLeader_YES_STRONGLY' }, ...]
+ * import { getFieldOptions } from 'udp-schema';
+ * const opts = getFieldOptions('gender');
+ * // → [{ value: 'man', label: 'Man' }, { value: 'woman', label: 'Woman' }, ...]
  * ```
  */
-export function getUdpFieldOptions(fieldKey) {
+export function getFieldOptions(fieldKey) {
     return optionsMap.get(fieldKey) ?? [];
 }
 /**
- * Get full field metadata (label, step, component, options, etc.) by key.
+ * Get full field metadata (label, description, step, type, options, etc.) by key.
  *
  * @example
  * ```ts
- * import { getUdpFieldMeta } from 'udp-schema';
- * const meta = getUdpFieldMeta('gender');
- * // → { key: 'gender', step: 1, labelKey: 'gender', component: 'genderSelector', options: [...], immutable: true }
+ * import { getFieldMeta } from 'udp-schema';
+ * const meta = getFieldMeta('familyReligion');
+ * // → { key: 'familyReligion', label: 'Family Religion', type: 'single_select', step: 1, options: [...], ... }
  * ```
  */
-export function getUdpFieldMeta(fieldKey) {
+export function getFieldMeta(fieldKey) {
     return fieldMap.get(fieldKey);
 }
+// ─── Step Schema Registry ───────────────────────────────────────────────────
+// biome-ignore lint/suspicious/noExplicitAny: Zod schema types vary per step
+const STEP_SCHEMAS = {
+    1: step01ProfileSchema,
+    2: step02PoliticalSchema,
+    3: step03ElectoralSchema,
+    4: step04LeadershipSchema,
+    5: step05PsychologicalSchema,
+    6: step06EducationSchema,
+    7: step07EmploymentSchema,
+    8: step08NeurodiversitySchema,
+    9: step09HealthSchema,
+    10: step10WorldViewSchema,
+    11: step11ResidenceSchema,
+    12: step12HouseholdSchema,
+};
 /**
- * Get all field metadata entries for a given step number.
- *
- * @example
- * ```ts
- * import { getUdpStepFields } from 'udp-schema';
- * const step5Fields = getUdpStepFields(5);
- * // → [{ key: 'desireToBeLeader', ... }, { key: 'desiredPoliticalPosition', ... }, ...]
- * ```
+ * Get the Zod schema for a given step number.
+ * Use `.partial().parse(data)` for sub-step saves.
  */
-export function getUdpStepFields(stepNumber) {
-    return stepFieldsMap.get(stepNumber) ?? [];
+// biome-ignore lint/suspicious/noExplicitAny: Zod schema types vary per step
+export function getStepSchema(stepNumber) {
+    return STEP_SCHEMAS[stepNumber];
 }
 /**
  * Get the list of field keys that are immutable after volunteer approval.
- * These fields can only be changed by a volunteer in survey-mode once approved.
- *
- * @example
- * ```ts
- * import { getImmutableFields } from 'udp-schema';
- * const locked = getImmutableFields();
- * // → ['firstName', 'middleName', 'lastName', 'gender', 'dateOfBirth', 'phonePrimary']
- * ```
  */
 export function getImmutableFields() {
-    return immutableFieldKeys;
+    return ['firstName', 'middleName', 'lastName', 'gender', 'dateOfBirth'];
 }
 //# sourceMappingURL=field-helpers.js.map

package/dist/field-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-helpers.js","sourceRoot":"","sources":["../src/field-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAA0C,MAAM,iBAAiB,CAAC;AAEzF,gFAAgF;AAEhF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqC,CAAC;AAChE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AACjD,MAAM,aAAa,GAAG,IAAI,GAAG,EAA0B,CAAC;AACxD,MAAM,kBAAkB,GAAa,EAAE,CAAC;AAExC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;IACjD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAE7B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,kBAAkB,CAAC;AAC5B,CAAC","sourcesContent":["/**\n * Convenience helpers for accessing UDP field metadata.\n *\n * Mirrors the dating-schema `field-helpers.ts` pattern:\n * pre-built lookup maps with `getUdpFieldOptions()` and `getUdpFieldMeta()`.\n *\n * @module udp-schema/field-helpers\n */\n\nimport { UDP_FIELD_META, type UdpFieldMeta, type UdpFieldOption } from './field-meta.js';\n\n// ─── Pre-built lookup maps ───────────────────────────────────────────────────\n\nconst optionsMap = new Map<string, readonly UdpFieldOption[]>();\nconst fieldMap = new Map<string, UdpFieldMeta>();\nconst stepFieldsMap = new Map<number, UdpFieldMeta[]>();\nconst immutableFieldKeys: string[] = [];\n\nfor (const meta of Object.values(UDP_FIELD_META)) {\n  fieldMap.set(meta.key, meta);\n\n  if (meta.options) {\n    optionsMap.set(meta.key, meta.options);\n  }\n\n  if (meta.immutable) {\n    immutableFieldKeys.push(meta.key);\n  }\n\n  const existing = stepFieldsMap.get(meta.step);\n  if (existing) {\n    existing.push(meta);\n  } else {\n    stepFieldsMap.set(meta.step, [meta]);\n  }\n}\n\n// ─── Public helpers ──────────────────────────────────────────────────────────\n\n/**\n * Get the `{ value, label }` options array for a UDP field by its key.\n *\n * @example\n * ```ts\n * import { getUdpFieldOptions } from 'udp-schema';\n * const opts = getUdpFieldOptions('desireToBeLeader');\n * // → [{ value: 'YES_STRONGLY', label: 'desireToBeLeader_YES_STRONGLY' }, ...]\n * ```\n */\nexport function getUdpFieldOptions(fieldKey: string): readonly UdpFieldOption[] {\n  return optionsMap.get(fieldKey) ?? [];\n}\n\n/**\n * Get full field metadata (label, step, component, options, etc.) by key.\n *\n * @example\n * ```ts\n * import { getUdpFieldMeta } from 'udp-schema';\n * const meta = getUdpFieldMeta('gender');\n * // → { key: 'gender', step: 1, labelKey: 'gender', component: 'genderSelector', options: [...], immutable: true }\n * ```\n */\nexport function getUdpFieldMeta(fieldKey: string): UdpFieldMeta | undefined {\n  return fieldMap.get(fieldKey);\n}\n\n/**\n * Get all field metadata entries for a given step number.\n *\n * @example\n * ```ts\n * import { getUdpStepFields } from 'udp-schema';\n * const step5Fields = getUdpStepFields(5);\n * // → [{ key: 'desireToBeLeader', ... }, { key: 'desiredPoliticalPosition', ... }, ...]\n * ```\n */\nexport function getUdpStepFields(stepNumber: number): readonly UdpFieldMeta[] {\n  return stepFieldsMap.get(stepNumber) ?? [];\n}\n\n/**\n * Get the list of field keys that are immutable after volunteer approval.\n * These fields can only be changed by a volunteer in survey-mode once approved.\n *\n * @example\n * ```ts\n * import { getImmutableFields } from 'udp-schema';\n * const locked = getImmutableFields();\n * // → ['firstName', 'middleName', 'lastName', 'gender', 'dateOfBirth', 'phonePrimary']\n * ```\n */\nexport function getImmutableFields(): readonly string[] {\n  return immutableFieldKeys;\n}\n"]}
+{"version":3,"file":"field-helpers.js","sourceRoot":"","sources":["../src/field-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,8EAA8E;AAE9E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkC,CAAC;AAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEjD,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,IAAI,SAAS,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,+EAA+E;AAE/E,6EAA6E;AAC7E,MAAM,YAAY,GAAqC;IACrD,CAAC,EAAE,mBAAmB;IACtB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,sBAAsB;IACzB,CAAC,EAAE,yBAAyB;IAC5B,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,sBAAsB;IACzB,CAAC,EAAE,0BAA0B;IAC7B,CAAC,EAAE,kBAAkB;IACrB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,qBAAqB;CAC1B,CAAC;AAEF;;;GAGG;AACH,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["/**\n * Convenience helpers for accessing UDP field metadata and step schemas.\n *\n * Mirrors the dating-schema field-helpers.ts pattern:\n * pre-built lookup maps with getFieldOptions() and getFieldMeta().\n *\n * @module udp-schema/field-helpers\n */\n\nimport type { z } from 'zod';\nimport { allFieldGroups } from './profile-fields/index.js';\nimport type { FieldOption, ProfileField } from './profile-fields/types.js';\nimport { step01ProfileSchema } from './step-01.schema.js';\nimport { step02PoliticalSchema } from './step-02.schema.js';\nimport { step03ElectoralSchema } from './step-03.schema.js';\nimport { step04LeadershipSchema } from './step-04.schema.js';\nimport { step05PsychologicalSchema } from './step-05.schema.js';\nimport { step06EducationSchema } from './step-06.schema.js';\nimport { step07EmploymentSchema } from './step-07.schema.js';\nimport { step08NeurodiversitySchema } from './step-08.schema.js';\nimport { step09HealthSchema } from './step-09.schema.js';\nimport { step10WorldViewSchema } from './step-10.schema.js';\nimport { step11ResidenceSchema } from './step-11.schema.js';\nimport { step12HouseholdSchema } from './step-12.schema.js';\n\n// ─── Pre-built lookup maps (like dating-schema) ────────────────────────────\n\nconst optionsMap = new Map<string, readonly FieldOption[]>();\nconst fieldMap = new Map<string, ProfileField>();\n\nfor (const group of allFieldGroups) {\n  for (const field of group.fields) {\n    fieldMap.set(field.key, field);\n    if ('options' in field && Array.isArray(field.options)) {\n      optionsMap.set(field.key, field.options);\n    }\n  }\n}\n\n// ─── Field metadata helpers (like dating-schema) ────────────────────────────\n\n/**\n * Get the `{ value, label, description }` options array for a field by its key.\n *\n * @example\n * ```ts\n * import { getFieldOptions } from 'udp-schema';\n * const opts = getFieldOptions('gender');\n * // → [{ value: 'man', label: 'Man' }, { value: 'woman', label: 'Woman' }, ...]\n * ```\n */\nexport function getFieldOptions(fieldKey: string): readonly FieldOption[] {\n  return optionsMap.get(fieldKey) ?? [];\n}\n\n/**\n * Get full field metadata (label, description, step, type, options, etc.) by key.\n *\n * @example\n * ```ts\n * import { getFieldMeta } from 'udp-schema';\n * const meta = getFieldMeta('familyReligion');\n * // → { key: 'familyReligion', label: 'Family Religion', type: 'single_select', step: 1, options: [...], ... }\n * ```\n */\nexport function getFieldMeta(fieldKey: string): ProfileField | undefined {\n  return fieldMap.get(fieldKey);\n}\n\n// ─── Step Schema Registry ───────────────────────────────────────────────────\n\n// biome-ignore lint/suspicious/noExplicitAny: Zod schema types vary per step\nconst STEP_SCHEMAS: Record<number, z.ZodObject<any>> = {\n  1: step01ProfileSchema,\n  2: step02PoliticalSchema,\n  3: step03ElectoralSchema,\n  4: step04LeadershipSchema,\n  5: step05PsychologicalSchema,\n  6: step06EducationSchema,\n  7: step07EmploymentSchema,\n  8: step08NeurodiversitySchema,\n  9: step09HealthSchema,\n  10: step10WorldViewSchema,\n  11: step11ResidenceSchema,\n  12: step12HouseholdSchema,\n};\n\n/**\n * Get the Zod schema for a given step number.\n * Use `.partial().parse(data)` for sub-step saves.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Zod schema types vary per step\nexport function getStepSchema(stepNumber: number): z.ZodObject<any> | undefined {\n  return STEP_SCHEMAS[stepNumber];\n}\n\n/**\n * Get the list of field keys that are immutable after volunteer approval.\n */\nexport function getImmutableFields(): readonly string[] {\n  return ['firstName', 'middleName', 'lastName', 'gender', 'dateOfBirth'];\n}\n"]}

package/dist/field-meta.d.ts

@@ -1,40 +1,20 @@
 /**
- * UDP Field Metadata
- * ==================
- * Single source of truth for field-level metadata across all 14 UDP steps.
- * Both frontend and backend import this — NO hardcoded option arrays elsewhere.
+ * UDP Field Metadata — backward-compatible re-exports from profile-fields.
  *
- * Labels use i18n translation keys (not hardcoded English strings).
+ * This file re-exports option arrays under SCREAMING_CASE names for
+ * backward compatibility with existing frontend imports.
+ * New code should import directly from profile-fields.
  *
  * @module udp-schema/field-meta
  */
-export interface UdpFieldOption {
-    value: string;
-    /** i18n translation key */
-    label: string;
-}
-export interface UdpFieldMeta {
-    /** Unique field key — matches the Zod schema key and form field key */
-    key: string;
-    /** Step number (1–14) this field belongs to */
-    step: number;
-    /** i18n key for the field label */
-    labelKey: string;
-    /** i18n key for help text / description */
-    descriptionKey?: string;
-    /** Component type hint (matches frontend FieldComponentType) */
-    component: string;
-    /** Options for select / radio / multiCheckbox / genderSelector fields */
-    options?: readonly UdpFieldOption[];
-    /** Whether the field is required to complete the step */
-    required?: boolean;
-    /** i18n key for the toast shown after saving this field's step */
-    successMessageKey?: string;
-    /**
-     * If true, this field is locked after first volunteer approval.
-     * Only a volunteer (survey-mode) can change it once locked.
-     */
-    immutable?: boolean;
-}
-export declare const UDP_FIELD_META: Record<string, UdpFieldMeta>;
+export type { FieldOption as UdpFieldOption } from './profile-fields/types.js';
+export { genderOptions as GENDER_OPTIONS, religionOptions as RELIGION_OPTIONS, languageOptions as LANGUAGE_OPTIONS, reservationOptions as RESERVATION_STATUS_OPTIONS, minorityOptions as MINORITY_STATUS_OPTIONS, } from './profile-fields/01-profile.js';
+export { politicalSpectrumOptions as POLITICAL_SPECTRUM_OPTIONS, partyOptions as PARTY_OPTIONS, civicEngagementOptions as CIVIC_ENGAGEMENT_OPTIONS, } from './profile-fields/02-political.js';
+export { votingIssueOptions as VOTING_ISSUES_OPTIONS } from './profile-fields/03-electoral.js';
+export { leadershipSkillsetOptions as LEADERSHIP_SKILLSET_OPTIONS } from './profile-fields/04-leadership.js';
+export { qualificationOptions as QUALIFICATION_OPTIONS } from './profile-fields/06-education.js';
+export { neurodiversityConditionOptions as NEURODIVERSITY_CONDITIONS_OPTIONS, sensoryPreferenceOptions as SENSORY_PREFERENCES_OPTIONS, supportNeedOptions as SUPPORT_NEEDS_OPTIONS, } from './profile-fields/08-neurodiversity.js';
+export { disabilityOptions as DISABILITY_STATUS_OPTIONS, substanceUseOptions as SUBSTANCE_USE_OPTIONS, } from './profile-fields/09-health.js';
+export { lgbtqStatementOptions as LGBTQ_STATEMENTS_OPTIONS, transgenderStatementOptions as TRANSGENDER_STATEMENTS_OPTIONS, casteDiscriminationPlaceOptions as CASTE_DISCRIMINATION_PLACES_OPTIONS, } from './profile-fields/10-worldview.js';
+export { familyMemberOptions as FAMILY_MEMBERS_OPTIONS, digitalAccessOptions as DIGITAL_ACCESS_OPTIONS, } from './profile-fields/12-household.js';
 //# sourceMappingURL=field-meta.d.ts.map

package/dist/field-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-meta.d.ts","sourceRoot":"","sources":["../src/field-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AA09BD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAwmC9C,CAAC"}
+{"version":3,"file":"field-meta.d.ts","sourceRoot":"","sources":["../src/field-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,WAAW,IAAI,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE/E,OAAO,EACL,aAAa,IAAI,cAAc,EAC/B,eAAe,IAAI,gBAAgB,EACnC,eAAe,IAAI,gBAAgB,EACnC,kBAAkB,IAAI,0BAA0B,EAChD,eAAe,IAAI,uBAAuB,GAC3C,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,wBAAwB,IAAI,0BAA0B,EACtD,YAAY,IAAI,aAAa,EAC7B,sBAAsB,IAAI,wBAAwB,GACnD,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,kBAAkB,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE/F,OAAO,EAAE,yBAAyB,IAAI,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAE7G,OAAO,EAAE,oBAAoB,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEjG,OAAO,EACL,8BAA8B,IAAI,iCAAiC,EACnE,wBAAwB,IAAI,2BAA2B,EACvD,kBAAkB,IAAI,qBAAqB,GAC5C,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,iBAAiB,IAAI,yBAAyB,EAC9C,mBAAmB,IAAI,qBAAqB,GAC7C,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,IAAI,wBAAwB,EACjD,2BAA2B,IAAI,8BAA8B,EAC7D,+BAA+B,IAAI,mCAAmC,GACvE,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,mBAAmB,IAAI,sBAAsB,EAC7C,oBAAoB,IAAI,sBAAsB,GAC/C,MAAM,kCAAkC,CAAC"}