@htilabs/platform-common-models 0.1.0-beta.2 → 0.1.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -43,6 +43,83 @@ export const DATA_QUALITY_DESCRIPTIONS: Record<DataQualityValue, string> = {
43
43
  "Data was not collected during this interaction",
44
44
  };
45
45
 
46
+ // ─── CVC-1: Name Type ───────────────────────────────────────────────
47
+ // Distinguishes between legal names (structured: first/middle/last/suffix)
48
+ // and unstructured name forms (alias, trade name, mononym, etc.)
49
+ // Reference: core_name_type in IC/CVC codebook
50
+
51
+ export const CVC_1_NAME_TYPE = {
52
+ /** Full legal name with structured components (first, middle, last, suffix) */
53
+ LEGAL: "legal",
54
+ /** Alias or AKA - single unstructured name field */
55
+ ALIAS: "alias",
56
+ /** Trade name / business name - single unstructured name field */
57
+ TRADE_NAME: "trade_name",
58
+ /** Single-word name (e.g., "Madonna", "Prince") - single unstructured name field */
59
+ MONONYM: "mononym",
60
+ /** Nickname - single unstructured name field */
61
+ NICKNAME: "nickname",
62
+ /** Online handle or username - single unstructured name field */
63
+ HANDLE: "handle",
64
+ /** Name type is unknown */
65
+ UNKNOWN: "unknown",
66
+ } as const;
67
+
68
+ export type CVC1Value = (typeof CVC_1_NAME_TYPE)[keyof typeof CVC_1_NAME_TYPE];
69
+
70
+ export const CVC_1_VALUES = [
71
+ CVC_1_NAME_TYPE.LEGAL,
72
+ CVC_1_NAME_TYPE.ALIAS,
73
+ CVC_1_NAME_TYPE.TRADE_NAME,
74
+ CVC_1_NAME_TYPE.MONONYM,
75
+ CVC_1_NAME_TYPE.NICKNAME,
76
+ CVC_1_NAME_TYPE.HANDLE,
77
+ CVC_1_NAME_TYPE.UNKNOWN,
78
+ ] as const;
79
+
80
+ export const CVC_1_LABELS: Record<CVC1Value, string> = {
81
+ [CVC_1_NAME_TYPE.LEGAL]: "Legal Name",
82
+ [CVC_1_NAME_TYPE.ALIAS]: "Alias / AKA",
83
+ [CVC_1_NAME_TYPE.TRADE_NAME]: "Trade Name",
84
+ [CVC_1_NAME_TYPE.MONONYM]: "Mononym",
85
+ [CVC_1_NAME_TYPE.NICKNAME]: "Nickname",
86
+ [CVC_1_NAME_TYPE.HANDLE]: "Handle / Username",
87
+ [CVC_1_NAME_TYPE.UNKNOWN]: "Unknown",
88
+ };
89
+
90
+ /**
91
+ * Name types that require structured fields (firstName, middleName, lastName, suffix).
92
+ * These names have distinct components that should be captured separately.
93
+ */
94
+ export const CVC_1_STRUCTURED_NAME_TYPES: readonly CVC1Value[] = [
95
+ CVC_1_NAME_TYPE.LEGAL,
96
+ ];
97
+
98
+ /**
99
+ * Name types that use a single unstructured name field.
100
+ * These names don't have separate first/middle/last components.
101
+ */
102
+ export const CVC_1_UNSTRUCTURED_NAME_TYPES: readonly CVC1Value[] = [
103
+ CVC_1_NAME_TYPE.ALIAS,
104
+ CVC_1_NAME_TYPE.TRADE_NAME,
105
+ CVC_1_NAME_TYPE.MONONYM,
106
+ CVC_1_NAME_TYPE.NICKNAME,
107
+ CVC_1_NAME_TYPE.HANDLE,
108
+ CVC_1_NAME_TYPE.UNKNOWN,
109
+ ];
110
+
111
+ /**
112
+ * Determine if a name type requires structured fields (first/middle/last/suffix).
113
+ * @param nameType - The name type value
114
+ * @returns True if structured fields should be shown, false for single name field
115
+ */
116
+ export function isStructuredNameType(
117
+ nameType: CVC1Value | string | null | undefined
118
+ ): boolean {
119
+ if (!nameType) return false;
120
+ return CVC_1_STRUCTURED_NAME_TYPES.includes(nameType as CVC1Value);
121
+ }
122
+
46
123
  // ─── IC-5: Victimization / Abuse Types ──────────────────────────────
47
124
 
48
125
  export const IC_5_VICTIMIZATION = {
@@ -241,45 +318,175 @@ export const IC_13_CATEGORY_ORDER: readonly IC13Category[] = [
241
318
  "ungrouped",
242
319
  ];
243
320
 
244
- // ─── CVC-126: Relationship Dynamics & Concerns ─────────────────────
245
- // These are NOT relationship types (IC-13). They are attributes
246
- // (multi-select axes) on a PersonRelationship record.
321
+ // ─── CVC-145: Relationship Dynamics ─────────────────────────────────
322
+ // Captures relationship-level behavior patterns (control, coercion, threats,
323
+ // abuse, power imbalance) for risk context and workflow.
324
+ // These are attributes (multi-select) on a PersonRelationship record.
325
+ // Distinct from relationship type (CVC-126) and relationship ties (CVC-159).
326
+
327
+ /**
328
+ * CVC-145 Level 1 Categories
329
+ * High-level groupings of relationship dynamics.
330
+ */
331
+ export const CVC_145_CATEGORY = {
332
+ CONTROL_MONITORING: "control_monitoring",
333
+ RESOURCE_CONTROL: "resource_control",
334
+ COERCION_THREATS: "coercion_threats",
335
+ ABUSE_DYNAMICS: "abuse_dynamics",
336
+ POWER_IMBALANCE: "power_imbalance",
337
+ MISSINGNESS: "missingness",
338
+ } as const;
339
+
340
+ export type CVC145Category =
341
+ (typeof CVC_145_CATEGORY)[keyof typeof CVC_145_CATEGORY];
342
+
343
+ export const CVC_145_CATEGORY_LABELS: Record<CVC145Category, string> = {
344
+ [CVC_145_CATEGORY.CONTROL_MONITORING]: "Control / Monitoring",
345
+ [CVC_145_CATEGORY.RESOURCE_CONTROL]: "Resource Control",
346
+ [CVC_145_CATEGORY.COERCION_THREATS]: "Coercion / Threats",
347
+ [CVC_145_CATEGORY.ABUSE_DYNAMICS]: "Abuse Dynamics",
348
+ [CVC_145_CATEGORY.POWER_IMBALANCE]: "Power Imbalance",
349
+ [CVC_145_CATEGORY.MISSINGNESS]: "Missingness",
350
+ };
351
+
352
+ /**
353
+ * CVC-145 Relationship Dynamics codes
354
+ */
355
+ export const CVC_145_RELATIONSHIP_DYNAMICS = {
356
+ // Missingness (Level 0)
357
+ DNC: "DNC",
358
+ ANON: "ANON",
359
+ UNK: "UNK",
360
+ // Control / Monitoring
361
+ CONTROLLING_BEHAVIOR: "CONTROLLING_BEHAVIOR",
362
+ // Resource Control
363
+ CONTROLS_FINANCES: "CONTROLS_FINANCES",
364
+ CONTROLS_DOCUMENTATION: "CONTROLS_DOCUMENTATION",
365
+ // Coercion / Threats
366
+ THREATS_OF_HARM: "THREATS_OF_HARM",
367
+ THREATS_TO_FAMILY_FRIENDS: "THREATS_TO_FAMILY_FRIENDS",
368
+ THREATS_OF_LEGAL_TROUBLE: "THREATS_OF_LEGAL_TROUBLE",
369
+ // Abuse Dynamics
370
+ EMOTIONAL_VERBAL_ABUSE: "EMOTIONAL_VERBAL_ABUSE",
371
+ PHYSICAL_ABUSE: "PHYSICAL_ABUSE",
372
+ SEXUAL_ABUSE: "SEXUAL_ABUSE",
373
+ FAMILY_FRIENDS_PHYSICALLY_ABUSED: "FAMILY_FRIENDS_PHYSICALLY_ABUSED",
374
+ // Power Imbalance
375
+ AGE_DISPARITY: "AGE_DISPARITY",
376
+ } as const;
377
+
378
+ export type CVC145Value =
379
+ (typeof CVC_145_RELATIONSHIP_DYNAMICS)[keyof typeof CVC_145_RELATIONSHIP_DYNAMICS];
380
+
381
+ export const CVC_145_VALUES = Object.values(
382
+ CVC_145_RELATIONSHIP_DYNAMICS,
383
+ ) as readonly CVC145Value[];
384
+
385
+ export const CVC_145_LABELS: Record<CVC145Value, string> = {
386
+ [CVC_145_RELATIONSHIP_DYNAMICS.DNC]: "Data not collected",
387
+ [CVC_145_RELATIONSHIP_DYNAMICS.ANON]: "Anonymous",
388
+ [CVC_145_RELATIONSHIP_DYNAMICS.UNK]: "Unknown",
389
+ [CVC_145_RELATIONSHIP_DYNAMICS.CONTROLLING_BEHAVIOR]: "Controlling behavior",
390
+ [CVC_145_RELATIONSHIP_DYNAMICS.CONTROLS_FINANCES]: "Controls finances",
391
+ [CVC_145_RELATIONSHIP_DYNAMICS.CONTROLS_DOCUMENTATION]: "Controls documentation",
392
+ [CVC_145_RELATIONSHIP_DYNAMICS.THREATS_OF_HARM]: "Threats of harm",
393
+ [CVC_145_RELATIONSHIP_DYNAMICS.THREATS_TO_FAMILY_FRIENDS]: "Threats of harm to family or close friends",
394
+ [CVC_145_RELATIONSHIP_DYNAMICS.THREATS_OF_LEGAL_TROUBLE]: "Threats of legal trouble / other coercion",
395
+ [CVC_145_RELATIONSHIP_DYNAMICS.EMOTIONAL_VERBAL_ABUSE]: "Emotional or verbal abuse",
396
+ [CVC_145_RELATIONSHIP_DYNAMICS.PHYSICAL_ABUSE]: "Physical abuse",
397
+ [CVC_145_RELATIONSHIP_DYNAMICS.SEXUAL_ABUSE]: "Sexual abuse",
398
+ [CVC_145_RELATIONSHIP_DYNAMICS.FAMILY_FRIENDS_PHYSICALLY_ABUSED]: "Family or close friends physically abused",
399
+ [CVC_145_RELATIONSHIP_DYNAMICS.AGE_DISPARITY]: "Age disparity",
400
+ };
401
+
402
+ /**
403
+ * Maps each dynamics code to its L1 category.
404
+ */
405
+ export const CVC_145_TYPE_TO_CATEGORY: Record<CVC145Value, CVC145Category> = {
406
+ [CVC_145_RELATIONSHIP_DYNAMICS.DNC]: CVC_145_CATEGORY.MISSINGNESS,
407
+ [CVC_145_RELATIONSHIP_DYNAMICS.ANON]: CVC_145_CATEGORY.MISSINGNESS,
408
+ [CVC_145_RELATIONSHIP_DYNAMICS.UNK]: CVC_145_CATEGORY.MISSINGNESS,
409
+ [CVC_145_RELATIONSHIP_DYNAMICS.CONTROLLING_BEHAVIOR]: CVC_145_CATEGORY.CONTROL_MONITORING,
410
+ [CVC_145_RELATIONSHIP_DYNAMICS.CONTROLS_FINANCES]: CVC_145_CATEGORY.RESOURCE_CONTROL,
411
+ [CVC_145_RELATIONSHIP_DYNAMICS.CONTROLS_DOCUMENTATION]: CVC_145_CATEGORY.RESOURCE_CONTROL,
412
+ [CVC_145_RELATIONSHIP_DYNAMICS.THREATS_OF_HARM]: CVC_145_CATEGORY.COERCION_THREATS,
413
+ [CVC_145_RELATIONSHIP_DYNAMICS.THREATS_TO_FAMILY_FRIENDS]: CVC_145_CATEGORY.COERCION_THREATS,
414
+ [CVC_145_RELATIONSHIP_DYNAMICS.THREATS_OF_LEGAL_TROUBLE]: CVC_145_CATEGORY.COERCION_THREATS,
415
+ [CVC_145_RELATIONSHIP_DYNAMICS.EMOTIONAL_VERBAL_ABUSE]: CVC_145_CATEGORY.ABUSE_DYNAMICS,
416
+ [CVC_145_RELATIONSHIP_DYNAMICS.PHYSICAL_ABUSE]: CVC_145_CATEGORY.ABUSE_DYNAMICS,
417
+ [CVC_145_RELATIONSHIP_DYNAMICS.SEXUAL_ABUSE]: CVC_145_CATEGORY.ABUSE_DYNAMICS,
418
+ [CVC_145_RELATIONSHIP_DYNAMICS.FAMILY_FRIENDS_PHYSICALLY_ABUSED]: CVC_145_CATEGORY.ABUSE_DYNAMICS,
419
+ [CVC_145_RELATIONSHIP_DYNAMICS.AGE_DISPARITY]: CVC_145_CATEGORY.POWER_IMBALANCE,
420
+ };
421
+
422
+ /** UI option type for grouped dropdowns */
423
+ export interface CVC145Option {
424
+ value: CVC145Value;
425
+ label: string;
426
+ category: CVC145Category;
427
+ categoryLabel: string;
428
+ }
429
+
430
+ /** Generate options array grouped by category */
431
+ export const CVC_145_OPTIONS: readonly CVC145Option[] = Object.entries(
432
+ CVC_145_TYPE_TO_CATEGORY,
433
+ ).map(([value, category]) => ({
434
+ value: value as CVC145Value,
435
+ label: CVC_145_LABELS[value as CVC145Value],
436
+ category,
437
+ categoryLabel: CVC_145_CATEGORY_LABELS[category],
438
+ }));
247
439
 
440
+ /** Get selectable options (excludes missingness for most UIs) */
441
+ export const CVC_145_SELECTABLE_OPTIONS: readonly CVC145Option[] =
442
+ CVC_145_OPTIONS.filter((opt) => opt.category !== CVC_145_CATEGORY.MISSINGNESS);
443
+
444
+ /** Category display order for UI */
445
+ export const CVC_145_CATEGORY_ORDER: readonly CVC145Category[] = [
446
+ CVC_145_CATEGORY.CONTROL_MONITORING,
447
+ CVC_145_CATEGORY.RESOURCE_CONTROL,
448
+ CVC_145_CATEGORY.COERCION_THREATS,
449
+ CVC_145_CATEGORY.ABUSE_DYNAMICS,
450
+ CVC_145_CATEGORY.POWER_IMBALANCE,
451
+ ];
452
+
453
+ // ─── Legacy aliases for backward compatibility ──────────────────────
454
+ // @deprecated Use CVC_145_RELATIONSHIP_DYNAMICS instead
248
455
  export const RELATIONSHIP_DYNAMICS = {
249
- APPEARS_CONTROLLING: "appears_controlling",
250
- CONTROLS_FINANCES: "controls_finances",
251
- CONTROLS_DOCUMENTATION: "controls_documentation",
252
- EMOTIONAL_VERBAL_ABUSE: "emotional_verbal_abuse",
253
- PHYSICAL_ABUSE: "physical_abuse",
254
- SEXUAL_ABUSE: "sexual_abuse",
255
- THREATS_OF_HARM: "threats_of_harm",
256
- THREATS_OF_LEGAL_TROUBLE: "threats_of_legal_trouble",
257
- AGE_DISPARITY: "age_disparity",
258
- HAS_KIDS_WITH: "has_kids_with",
456
+ APPEARS_CONTROLLING: "CONTROLLING_BEHAVIOR",
457
+ CONTROLS_FINANCES: "CONTROLS_FINANCES",
458
+ CONTROLS_DOCUMENTATION: "CONTROLS_DOCUMENTATION",
459
+ EMOTIONAL_VERBAL_ABUSE: "EMOTIONAL_VERBAL_ABUSE",
460
+ PHYSICAL_ABUSE: "PHYSICAL_ABUSE",
461
+ SEXUAL_ABUSE: "SEXUAL_ABUSE",
462
+ THREATS_OF_HARM: "THREATS_OF_HARM",
463
+ THREATS_OF_LEGAL_TROUBLE: "THREATS_OF_LEGAL_TROUBLE",
464
+ AGE_DISPARITY: "AGE_DISPARITY",
465
+ HAS_KIDS_WITH: "HAS_KIDS_WITH", // Note: moved to CVC-159 relationship ties
259
466
  } as const;
260
467
 
468
+ // @deprecated Use CVC145Value instead
261
469
  export type RelationshipDynamicValue =
262
470
  (typeof RELATIONSHIP_DYNAMICS)[keyof typeof RELATIONSHIP_DYNAMICS];
263
471
 
264
- export const RELATIONSHIP_DYNAMICS_LABELS: Record<
265
- RelationshipDynamicValue,
266
- string
267
- > = {
268
- appears_controlling: "Appears Controlling",
269
- controls_finances: "Controls Finances",
270
- controls_documentation: "Controls Documentation",
271
- emotional_verbal_abuse: "Emotional / Verbal Abuse",
272
- physical_abuse: "Physical Abuse",
273
- sexual_abuse: "Sexual Abuse",
274
- threats_of_harm: "Threats of Harm",
275
- threats_of_legal_trouble: "Threats of Legal Trouble",
276
- age_disparity: "Age Disparity",
277
- has_kids_with: "Has Kids With",
472
+ // @deprecated Use CVC_145_LABELS instead
473
+ export const RELATIONSHIP_DYNAMICS_LABELS: Record<string, string> = {
474
+ CONTROLLING_BEHAVIOR: "Appears Controlling",
475
+ CONTROLS_FINANCES: "Controls Finances",
476
+ CONTROLS_DOCUMENTATION: "Controls Documentation",
477
+ EMOTIONAL_VERBAL_ABUSE: "Emotional / Verbal Abuse",
478
+ PHYSICAL_ABUSE: "Physical Abuse",
479
+ SEXUAL_ABUSE: "Sexual Abuse",
480
+ THREATS_OF_HARM: "Threats of Harm",
481
+ THREATS_OF_LEGAL_TROUBLE: "Threats of Legal Trouble",
482
+ AGE_DISPARITY: "Age Disparity",
483
+ HAS_KIDS_WITH: "Has Kids With",
278
484
  };
279
485
 
486
+ // @deprecated Use CVC_145_VALUES instead
280
487
  export const RELATIONSHIP_DYNAMICS_VALUES = Object.values(
281
488
  RELATIONSHIP_DYNAMICS,
282
- ) as readonly RelationshipDynamicValue[];
489
+ ) as readonly string[];
283
490
 
284
491
  export const RELATIONSHIP_CONCERNS = {
285
492
  SAFETY: "safety",
@@ -1128,6 +1335,74 @@ export const IC_23_LABELS: Record<IC23Value, string> = {
1128
1335
  [IC_23_CORE_GENDER_IDENTITY.UNKNOWN]: "Unknown",
1129
1336
  };
1130
1337
 
1338
+ // ─── CVC-15: Core Sex ───────────────────────────────────────────────
1339
+ // CVC-aligned sex field using string codes (replaces IC-22 numeric codes).
1340
+ // Reference: https://www.notion.so/htilabs/CVC-15-core-sex
1341
+
1342
+ export const CVC_15_CORE_SEX = {
1343
+ MALE: "male",
1344
+ FEMALE: "female",
1345
+ UNKNOWN: "unknown",
1346
+ NOT_REPORTED: "not_reported",
1347
+ NOT_TRACKED: "not_tracked",
1348
+ } as const;
1349
+
1350
+ export type CVC15Value =
1351
+ (typeof CVC_15_CORE_SEX)[keyof typeof CVC_15_CORE_SEX];
1352
+
1353
+ export const CVC_15_LABELS: Record<CVC15Value, string> = {
1354
+ [CVC_15_CORE_SEX.MALE]: "Male",
1355
+ [CVC_15_CORE_SEX.FEMALE]: "Female",
1356
+ [CVC_15_CORE_SEX.UNKNOWN]: "Unknown",
1357
+ [CVC_15_CORE_SEX.NOT_REPORTED]: "Not Reported",
1358
+ [CVC_15_CORE_SEX.NOT_TRACKED]: "Not Tracked",
1359
+ };
1360
+
1361
+ // Selectable values (excludes missingness codes for UI dropdowns)
1362
+ export const CVC_15_SELECTABLE_VALUES: CVC15Value[] = [
1363
+ CVC_15_CORE_SEX.MALE,
1364
+ CVC_15_CORE_SEX.FEMALE,
1365
+ CVC_15_CORE_SEX.UNKNOWN,
1366
+ ];
1367
+
1368
+ // ─── CVC-16: Core Sexual Orientation ────────────────────────────────
1369
+ // Sexual orientation identity field.
1370
+ // Reference: https://www.notion.so/htilabs/CVC-16-core-orientation-identity
1371
+
1372
+ export const CVC_16_CORE_ORIENTATION = {
1373
+ STRAIGHT: "straight",
1374
+ GAY_OR_LESBIAN: "gay_or_lesbian",
1375
+ BISEXUAL: "bisexual",
1376
+ OTHER: "other_write_in_option",
1377
+ UNKNOWN: "unknown",
1378
+ } as const;
1379
+
1380
+ export type CVC16Value =
1381
+ (typeof CVC_16_CORE_ORIENTATION)[keyof typeof CVC_16_CORE_ORIENTATION];
1382
+
1383
+ export const CVC_16_LABELS: Record<CVC16Value, string> = {
1384
+ [CVC_16_CORE_ORIENTATION.STRAIGHT]: "Straight",
1385
+ [CVC_16_CORE_ORIENTATION.GAY_OR_LESBIAN]: "Gay or Lesbian",
1386
+ [CVC_16_CORE_ORIENTATION.BISEXUAL]: "Bisexual",
1387
+ [CVC_16_CORE_ORIENTATION.OTHER]: "Other",
1388
+ [CVC_16_CORE_ORIENTATION.UNKNOWN]: "Unknown",
1389
+ };
1390
+
1391
+ // Values that indicate LGBTQ+ for derivation logic
1392
+ export const CVC_16_LGBTQ_VALUES: CVC16Value[] = [
1393
+ CVC_16_CORE_ORIENTATION.GAY_OR_LESBIAN,
1394
+ CVC_16_CORE_ORIENTATION.BISEXUAL,
1395
+ ];
1396
+
1397
+ /**
1398
+ * Check if a sexual orientation value indicates LGBTQ+ status.
1399
+ * Used for LGBTQ auto-derivation logic.
1400
+ */
1401
+ export function isLgbtqOrientation(value: CVC16Value | null | undefined): boolean {
1402
+ if (!value) return false;
1403
+ return CVC_16_LGBTQ_VALUES.includes(value);
1404
+ }
1405
+
1131
1406
  // ─── CVC-17: Core Gender Identity (Hierarchical) ────────────────────
1132
1407
  // This CVC provides a unified gender identity field with hierarchical
1133
1408
  // transgender options (Level 1 + Level 2 subcategories).
@@ -2975,93 +3250,284 @@ export const CVC_115_LABELS: Record<CVC115Value, string> = {
2975
3250
  // ─── CVC-171: Income / Benefits Sources ───────────────────────────────
2976
3251
  // Income and benefit source categories for socioeconomic assessment.
2977
3252
  // Aligned with HMIS R14 (Income Sources) and R15 (Non-Cash Benefits).
3253
+ //
3254
+ // HIERARCHICAL STRUCTURE:
3255
+ // Categories (non-selectable accordion headers): INCOME, BENEFITS
3256
+ // Selectable parents with children:
3257
+ // - SSA (Social Security) → SSI, SSDI, SSA_RET
3258
+ // - VA (Veterans Benefits) → VA_SCD, VA_NSC_PEN
3259
+ // - TANF → TANF_CC, TANF_TRANS, TANF_OTHER_SVC
3260
+ // Selecting a child auto-checks the parent.
3261
+ // Parents can be selected alone if specific type unknown.
2978
3262
 
2979
- export const CVC_171_INCOME_SOURCES = {
2980
- // Earned Income
3263
+ /**
3264
+ * CVC-171 Categories (non-selectable accordion headers)
3265
+ */
3266
+ export const CVC_171_CATEGORY = {
3267
+ INCOME: "income",
3268
+ BENEFITS: "benefits",
3269
+ } as const;
3270
+
3271
+ export type CVC171Category =
3272
+ (typeof CVC_171_CATEGORY)[keyof typeof CVC_171_CATEGORY];
3273
+
3274
+ export const CVC_171_CATEGORY_LABELS: Record<CVC171Category, string> = {
3275
+ [CVC_171_CATEGORY.INCOME]: "Income",
3276
+ [CVC_171_CATEGORY.BENEFITS]: "Benefits",
3277
+ };
3278
+
3279
+ /**
3280
+ * CVC-171 Income/Benefits Values (all selectable items)
3281
+ */
3282
+ export const CVC_171_INCOME_BENEFITS = {
3283
+ // Income - Earned
2981
3284
  WAGES_SALARY: "wages_salary",
2982
3285
  SELF_EMPLOYMENT: "self_employment",
2983
3286
  TIPS_COMMISSIONS: "tips_commissions",
2984
- // Cash Benefits
3287
+ // Income - Other
3288
+ PENSION: "pension",
3289
+ CHILD_SUPPORT: "child_support",
3290
+ ALIMONY: "alimony",
3291
+ FAMILY_FRIENDS: "family_friends",
3292
+ OTHER_INCOME: "other_income",
3293
+ // Benefits - Social Security (hierarchical parent)
3294
+ SSA: "ssa",
2985
3295
  SSI: "ssi",
2986
3296
  SSDI: "ssdi",
2987
- SSA: "ssa",
3297
+ SSA_RET: "ssa_ret",
3298
+ // Benefits - Veterans (hierarchical parent)
3299
+ VA: "va",
3300
+ VA_SCD: "va_scd",
3301
+ VA_NSC_PEN: "va_nsc_pen",
3302
+ // Benefits - TANF (hierarchical parent)
2988
3303
  TANF: "tanf",
3304
+ TANF_CC: "tanf_cc",
3305
+ TANF_TRANS: "tanf_trans",
3306
+ TANF_OTHER_SVC: "tanf_other_svc",
3307
+ // Benefits - Other
2989
3308
  UNEMPLOYMENT: "unemployment",
2990
- VETERANS_BENEFITS: "veterans_benefits",
2991
- PENSION: "pension",
2992
3309
  WORKERS_COMP: "workers_comp",
2993
- // In-Kind Benefits
2994
3310
  SNAP: "snap",
2995
3311
  WIC: "wic",
2996
3312
  HOUSING_ASSISTANCE: "housing_assistance",
2997
3313
  MEDICAID: "medicaid",
2998
3314
  MEDICARE: "medicare",
2999
- // Transfer/Support
3000
- CHILD_SUPPORT: "child_support",
3001
- ALIMONY: "alimony",
3002
- FAMILY_FRIENDS: "family_friends",
3003
- // Other
3004
- OTHER: "other",
3315
+ OTHER_BENEFITS: "other_benefits",
3316
+ // Missingness (not shown in UI, used for data)
3005
3317
  NONE: "none",
3006
3318
  UNKNOWN: "unknown",
3007
3319
  DECLINED: "declined",
3008
3320
  } as const;
3009
3321
 
3010
3322
  export type CVC171Value =
3011
- (typeof CVC_171_INCOME_SOURCES)[keyof typeof CVC_171_INCOME_SOURCES];
3012
-
3013
- export const CVC_171_VALUES = [
3014
- CVC_171_INCOME_SOURCES.WAGES_SALARY,
3015
- CVC_171_INCOME_SOURCES.SELF_EMPLOYMENT,
3016
- CVC_171_INCOME_SOURCES.TIPS_COMMISSIONS,
3017
- CVC_171_INCOME_SOURCES.SSI,
3018
- CVC_171_INCOME_SOURCES.SSDI,
3019
- CVC_171_INCOME_SOURCES.SSA,
3020
- CVC_171_INCOME_SOURCES.TANF,
3021
- CVC_171_INCOME_SOURCES.UNEMPLOYMENT,
3022
- CVC_171_INCOME_SOURCES.VETERANS_BENEFITS,
3023
- CVC_171_INCOME_SOURCES.PENSION,
3024
- CVC_171_INCOME_SOURCES.WORKERS_COMP,
3025
- CVC_171_INCOME_SOURCES.SNAP,
3026
- CVC_171_INCOME_SOURCES.WIC,
3027
- CVC_171_INCOME_SOURCES.HOUSING_ASSISTANCE,
3028
- CVC_171_INCOME_SOURCES.MEDICAID,
3029
- CVC_171_INCOME_SOURCES.MEDICARE,
3030
- CVC_171_INCOME_SOURCES.CHILD_SUPPORT,
3031
- CVC_171_INCOME_SOURCES.ALIMONY,
3032
- CVC_171_INCOME_SOURCES.FAMILY_FRIENDS,
3033
- CVC_171_INCOME_SOURCES.OTHER,
3034
- CVC_171_INCOME_SOURCES.NONE,
3035
- CVC_171_INCOME_SOURCES.UNKNOWN,
3036
- CVC_171_INCOME_SOURCES.DECLINED,
3037
- ] as const;
3323
+ (typeof CVC_171_INCOME_BENEFITS)[keyof typeof CVC_171_INCOME_BENEFITS];
3038
3324
 
3039
3325
  export const CVC_171_LABELS: Record<CVC171Value, string> = {
3040
- [CVC_171_INCOME_SOURCES.WAGES_SALARY]: "Wages / Salary",
3041
- [CVC_171_INCOME_SOURCES.SELF_EMPLOYMENT]: "Self-employment income",
3042
- [CVC_171_INCOME_SOURCES.TIPS_COMMISSIONS]: "Tips / Commissions",
3043
- [CVC_171_INCOME_SOURCES.SSI]: "SSI (Supplemental Security Income)",
3044
- [CVC_171_INCOME_SOURCES.SSDI]: "SSDI (Social Security Disability)",
3045
- [CVC_171_INCOME_SOURCES.SSA]: "Social Security (type unknown)",
3046
- [CVC_171_INCOME_SOURCES.TANF]: "TANF",
3047
- [CVC_171_INCOME_SOURCES.UNEMPLOYMENT]: "Unemployment insurance",
3048
- [CVC_171_INCOME_SOURCES.VETERANS_BENEFITS]: "Veterans benefits",
3049
- [CVC_171_INCOME_SOURCES.PENSION]: "Pension / Retirement",
3050
- [CVC_171_INCOME_SOURCES.WORKERS_COMP]: "Workers' compensation",
3051
- [CVC_171_INCOME_SOURCES.SNAP]: "SNAP (Food stamps)",
3052
- [CVC_171_INCOME_SOURCES.WIC]: "WIC",
3053
- [CVC_171_INCOME_SOURCES.HOUSING_ASSISTANCE]: "Housing assistance",
3054
- [CVC_171_INCOME_SOURCES.MEDICAID]: "Medicaid",
3055
- [CVC_171_INCOME_SOURCES.MEDICARE]: "Medicare",
3056
- [CVC_171_INCOME_SOURCES.CHILD_SUPPORT]: "Child support",
3057
- [CVC_171_INCOME_SOURCES.ALIMONY]: "Alimony / Spousal support",
3058
- [CVC_171_INCOME_SOURCES.FAMILY_FRIENDS]: "Support from family/friends",
3059
- [CVC_171_INCOME_SOURCES.OTHER]: "Other income",
3060
- [CVC_171_INCOME_SOURCES.NONE]: "No income",
3061
- [CVC_171_INCOME_SOURCES.UNKNOWN]: "Unknown",
3062
- [CVC_171_INCOME_SOURCES.DECLINED]: "Declined to answer",
3326
+ // Income - Earned
3327
+ [CVC_171_INCOME_BENEFITS.WAGES_SALARY]: "Wages / Salary",
3328
+ [CVC_171_INCOME_BENEFITS.SELF_EMPLOYMENT]: "Self-employment income",
3329
+ [CVC_171_INCOME_BENEFITS.TIPS_COMMISSIONS]: "Tips / Commissions",
3330
+ // Income - Other
3331
+ [CVC_171_INCOME_BENEFITS.PENSION]: "Pension / Retirement",
3332
+ [CVC_171_INCOME_BENEFITS.CHILD_SUPPORT]: "Child support",
3333
+ [CVC_171_INCOME_BENEFITS.ALIMONY]: "Alimony / Spousal support",
3334
+ [CVC_171_INCOME_BENEFITS.FAMILY_FRIENDS]: "Support from family/friends",
3335
+ [CVC_171_INCOME_BENEFITS.OTHER_INCOME]: "Other income",
3336
+ // Benefits - Social Security
3337
+ [CVC_171_INCOME_BENEFITS.SSA]: "Social Security (type unknown)",
3338
+ [CVC_171_INCOME_BENEFITS.SSI]: "SSI (Supplemental Security Income)",
3339
+ [CVC_171_INCOME_BENEFITS.SSDI]: "SSDI (Social Security Disability)",
3340
+ [CVC_171_INCOME_BENEFITS.SSA_RET]: "Social Security Retirement",
3341
+ // Benefits - Veterans
3342
+ [CVC_171_INCOME_BENEFITS.VA]: "VA Benefits (type unknown)",
3343
+ [CVC_171_INCOME_BENEFITS.VA_SCD]: "VA Service-Connected Disability",
3344
+ [CVC_171_INCOME_BENEFITS.VA_NSC_PEN]: "VA Non-Service-Connected Pension",
3345
+ // Benefits - TANF
3346
+ [CVC_171_INCOME_BENEFITS.TANF]: "TANF (type unknown)",
3347
+ [CVC_171_INCOME_BENEFITS.TANF_CC]: "TANF Child Care",
3348
+ [CVC_171_INCOME_BENEFITS.TANF_TRANS]: "TANF Transportation",
3349
+ [CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC]: "TANF Other Services",
3350
+ // Benefits - Other
3351
+ [CVC_171_INCOME_BENEFITS.UNEMPLOYMENT]: "Unemployment insurance",
3352
+ [CVC_171_INCOME_BENEFITS.WORKERS_COMP]: "Workers' compensation",
3353
+ [CVC_171_INCOME_BENEFITS.SNAP]: "SNAP (Food stamps)",
3354
+ [CVC_171_INCOME_BENEFITS.WIC]: "WIC",
3355
+ [CVC_171_INCOME_BENEFITS.HOUSING_ASSISTANCE]: "Housing assistance",
3356
+ [CVC_171_INCOME_BENEFITS.MEDICAID]: "Medicaid",
3357
+ [CVC_171_INCOME_BENEFITS.MEDICARE]: "Medicare",
3358
+ [CVC_171_INCOME_BENEFITS.OTHER_BENEFITS]: "Other benefits",
3359
+ // Missingness
3360
+ [CVC_171_INCOME_BENEFITS.NONE]: "No income or benefits",
3361
+ [CVC_171_INCOME_BENEFITS.UNKNOWN]: "Unknown",
3362
+ [CVC_171_INCOME_BENEFITS.DECLINED]: "Declined to answer",
3363
+ };
3364
+
3365
+ /**
3366
+ * Maps each value to its category (INCOME or BENEFITS)
3367
+ */
3368
+ export const CVC_171_VALUE_TO_CATEGORY: Record<CVC171Value, CVC171Category> = {
3369
+ // Income
3370
+ [CVC_171_INCOME_BENEFITS.WAGES_SALARY]: CVC_171_CATEGORY.INCOME,
3371
+ [CVC_171_INCOME_BENEFITS.SELF_EMPLOYMENT]: CVC_171_CATEGORY.INCOME,
3372
+ [CVC_171_INCOME_BENEFITS.TIPS_COMMISSIONS]: CVC_171_CATEGORY.INCOME,
3373
+ [CVC_171_INCOME_BENEFITS.PENSION]: CVC_171_CATEGORY.INCOME,
3374
+ [CVC_171_INCOME_BENEFITS.CHILD_SUPPORT]: CVC_171_CATEGORY.INCOME,
3375
+ [CVC_171_INCOME_BENEFITS.ALIMONY]: CVC_171_CATEGORY.INCOME,
3376
+ [CVC_171_INCOME_BENEFITS.FAMILY_FRIENDS]: CVC_171_CATEGORY.INCOME,
3377
+ [CVC_171_INCOME_BENEFITS.OTHER_INCOME]: CVC_171_CATEGORY.INCOME,
3378
+ // Benefits
3379
+ [CVC_171_INCOME_BENEFITS.SSA]: CVC_171_CATEGORY.BENEFITS,
3380
+ [CVC_171_INCOME_BENEFITS.SSI]: CVC_171_CATEGORY.BENEFITS,
3381
+ [CVC_171_INCOME_BENEFITS.SSDI]: CVC_171_CATEGORY.BENEFITS,
3382
+ [CVC_171_INCOME_BENEFITS.SSA_RET]: CVC_171_CATEGORY.BENEFITS,
3383
+ [CVC_171_INCOME_BENEFITS.VA]: CVC_171_CATEGORY.BENEFITS,
3384
+ [CVC_171_INCOME_BENEFITS.VA_SCD]: CVC_171_CATEGORY.BENEFITS,
3385
+ [CVC_171_INCOME_BENEFITS.VA_NSC_PEN]: CVC_171_CATEGORY.BENEFITS,
3386
+ [CVC_171_INCOME_BENEFITS.TANF]: CVC_171_CATEGORY.BENEFITS,
3387
+ [CVC_171_INCOME_BENEFITS.TANF_CC]: CVC_171_CATEGORY.BENEFITS,
3388
+ [CVC_171_INCOME_BENEFITS.TANF_TRANS]: CVC_171_CATEGORY.BENEFITS,
3389
+ [CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC]: CVC_171_CATEGORY.BENEFITS,
3390
+ [CVC_171_INCOME_BENEFITS.UNEMPLOYMENT]: CVC_171_CATEGORY.BENEFITS,
3391
+ [CVC_171_INCOME_BENEFITS.WORKERS_COMP]: CVC_171_CATEGORY.BENEFITS,
3392
+ [CVC_171_INCOME_BENEFITS.SNAP]: CVC_171_CATEGORY.BENEFITS,
3393
+ [CVC_171_INCOME_BENEFITS.WIC]: CVC_171_CATEGORY.BENEFITS,
3394
+ [CVC_171_INCOME_BENEFITS.HOUSING_ASSISTANCE]: CVC_171_CATEGORY.BENEFITS,
3395
+ [CVC_171_INCOME_BENEFITS.MEDICAID]: CVC_171_CATEGORY.BENEFITS,
3396
+ [CVC_171_INCOME_BENEFITS.MEDICARE]: CVC_171_CATEGORY.BENEFITS,
3397
+ [CVC_171_INCOME_BENEFITS.OTHER_BENEFITS]: CVC_171_CATEGORY.BENEFITS,
3398
+ // Missingness (categorized under Benefits for simplicity)
3399
+ [CVC_171_INCOME_BENEFITS.NONE]: CVC_171_CATEGORY.BENEFITS,
3400
+ [CVC_171_INCOME_BENEFITS.UNKNOWN]: CVC_171_CATEGORY.BENEFITS,
3401
+ [CVC_171_INCOME_BENEFITS.DECLINED]: CVC_171_CATEGORY.BENEFITS,
3402
+ };
3403
+
3404
+ /** UI option type for hierarchical picker */
3405
+ export interface CVC171Option {
3406
+ value: CVC171Value;
3407
+ label: string;
3408
+ category: CVC171Category;
3409
+ categoryLabel: string;
3410
+ }
3411
+
3412
+ /**
3413
+ * Parent-to-children mapping for hierarchical picker.
3414
+ * Parents are selectable and children appear indented below.
3415
+ */
3416
+ export const CVC_171_PARENT_CHILDREN: Record<string, string[]> = {
3417
+ [CVC_171_INCOME_BENEFITS.SSA]: [
3418
+ CVC_171_INCOME_BENEFITS.SSI,
3419
+ CVC_171_INCOME_BENEFITS.SSDI,
3420
+ CVC_171_INCOME_BENEFITS.SSA_RET,
3421
+ ],
3422
+ [CVC_171_INCOME_BENEFITS.VA]: [
3423
+ CVC_171_INCOME_BENEFITS.VA_SCD,
3424
+ CVC_171_INCOME_BENEFITS.VA_NSC_PEN,
3425
+ ],
3426
+ [CVC_171_INCOME_BENEFITS.TANF]: [
3427
+ CVC_171_INCOME_BENEFITS.TANF_CC,
3428
+ CVC_171_INCOME_BENEFITS.TANF_TRANS,
3429
+ CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC,
3430
+ ],
3431
+ };
3432
+
3433
+ /**
3434
+ * Child-to-parent mapping (inverse of PARENT_CHILDREN).
3435
+ * When selecting a child, the parent is auto-selected.
3436
+ */
3437
+ export const CVC_171_CHILD_TO_PARENT: Record<string, string> = {
3438
+ [CVC_171_INCOME_BENEFITS.SSI]: CVC_171_INCOME_BENEFITS.SSA,
3439
+ [CVC_171_INCOME_BENEFITS.SSDI]: CVC_171_INCOME_BENEFITS.SSA,
3440
+ [CVC_171_INCOME_BENEFITS.SSA_RET]: CVC_171_INCOME_BENEFITS.SSA,
3441
+ [CVC_171_INCOME_BENEFITS.VA_SCD]: CVC_171_INCOME_BENEFITS.VA,
3442
+ [CVC_171_INCOME_BENEFITS.VA_NSC_PEN]: CVC_171_INCOME_BENEFITS.VA,
3443
+ [CVC_171_INCOME_BENEFITS.TANF_CC]: CVC_171_INCOME_BENEFITS.TANF,
3444
+ [CVC_171_INCOME_BENEFITS.TANF_TRANS]: CVC_171_INCOME_BENEFITS.TANF,
3445
+ [CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC]: CVC_171_INCOME_BENEFITS.TANF,
3063
3446
  };
3064
3447
 
3448
+ /**
3449
+ * All selectable values in display order.
3450
+ * Excludes missingness values which are handled separately.
3451
+ * Parents are listed before their children for correct rendering.
3452
+ */
3453
+ const CVC_171_SELECTABLE_VALUES: CVC171Value[] = [
3454
+ // Income
3455
+ CVC_171_INCOME_BENEFITS.WAGES_SALARY,
3456
+ CVC_171_INCOME_BENEFITS.SELF_EMPLOYMENT,
3457
+ CVC_171_INCOME_BENEFITS.TIPS_COMMISSIONS,
3458
+ CVC_171_INCOME_BENEFITS.PENSION,
3459
+ CVC_171_INCOME_BENEFITS.CHILD_SUPPORT,
3460
+ CVC_171_INCOME_BENEFITS.ALIMONY,
3461
+ CVC_171_INCOME_BENEFITS.FAMILY_FRIENDS,
3462
+ CVC_171_INCOME_BENEFITS.OTHER_INCOME,
3463
+ // Benefits - Social Security (parent then children)
3464
+ CVC_171_INCOME_BENEFITS.SSA,
3465
+ CVC_171_INCOME_BENEFITS.SSI,
3466
+ CVC_171_INCOME_BENEFITS.SSDI,
3467
+ CVC_171_INCOME_BENEFITS.SSA_RET,
3468
+ // Benefits - Veterans (parent then children)
3469
+ CVC_171_INCOME_BENEFITS.VA,
3470
+ CVC_171_INCOME_BENEFITS.VA_SCD,
3471
+ CVC_171_INCOME_BENEFITS.VA_NSC_PEN,
3472
+ // Benefits - TANF (parent then children)
3473
+ CVC_171_INCOME_BENEFITS.TANF,
3474
+ CVC_171_INCOME_BENEFITS.TANF_CC,
3475
+ CVC_171_INCOME_BENEFITS.TANF_TRANS,
3476
+ CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC,
3477
+ // Benefits - Other
3478
+ CVC_171_INCOME_BENEFITS.UNEMPLOYMENT,
3479
+ CVC_171_INCOME_BENEFITS.WORKERS_COMP,
3480
+ CVC_171_INCOME_BENEFITS.SNAP,
3481
+ CVC_171_INCOME_BENEFITS.WIC,
3482
+ CVC_171_INCOME_BENEFITS.HOUSING_ASSISTANCE,
3483
+ CVC_171_INCOME_BENEFITS.MEDICAID,
3484
+ CVC_171_INCOME_BENEFITS.MEDICARE,
3485
+ CVC_171_INCOME_BENEFITS.OTHER_BENEFITS,
3486
+ ];
3487
+
3488
+ /**
3489
+ * Selectable options for HierarchicalCheckboxPicker.
3490
+ * Each option includes category info for accordion grouping.
3491
+ */
3492
+ export const CVC_171_SELECTABLE_OPTIONS: readonly CVC171Option[] =
3493
+ CVC_171_SELECTABLE_VALUES.map((value) => ({
3494
+ value,
3495
+ label: CVC_171_LABELS[value],
3496
+ category: CVC_171_VALUE_TO_CATEGORY[value],
3497
+ categoryLabel: CVC_171_CATEGORY_LABELS[CVC_171_VALUE_TO_CATEGORY[value]],
3498
+ }));
3499
+
3500
+ // ─── Legacy aliases for backward compatibility ──────────────────────
3501
+ // @deprecated Use CVC_171_INCOME_BENEFITS instead
3502
+ export const CVC_171_INCOME_SOURCES = {
3503
+ WAGES_SALARY: CVC_171_INCOME_BENEFITS.WAGES_SALARY,
3504
+ SELF_EMPLOYMENT: CVC_171_INCOME_BENEFITS.SELF_EMPLOYMENT,
3505
+ TIPS_COMMISSIONS: CVC_171_INCOME_BENEFITS.TIPS_COMMISSIONS,
3506
+ SSI: CVC_171_INCOME_BENEFITS.SSI,
3507
+ SSDI: CVC_171_INCOME_BENEFITS.SSDI,
3508
+ SSA: CVC_171_INCOME_BENEFITS.SSA,
3509
+ TANF: CVC_171_INCOME_BENEFITS.TANF,
3510
+ UNEMPLOYMENT: CVC_171_INCOME_BENEFITS.UNEMPLOYMENT,
3511
+ VETERANS_BENEFITS: CVC_171_INCOME_BENEFITS.VA, // Mapped to new VA parent
3512
+ PENSION: CVC_171_INCOME_BENEFITS.PENSION,
3513
+ WORKERS_COMP: CVC_171_INCOME_BENEFITS.WORKERS_COMP,
3514
+ SNAP: CVC_171_INCOME_BENEFITS.SNAP,
3515
+ WIC: CVC_171_INCOME_BENEFITS.WIC,
3516
+ HOUSING_ASSISTANCE: CVC_171_INCOME_BENEFITS.HOUSING_ASSISTANCE,
3517
+ MEDICAID: CVC_171_INCOME_BENEFITS.MEDICAID,
3518
+ MEDICARE: CVC_171_INCOME_BENEFITS.MEDICARE,
3519
+ CHILD_SUPPORT: CVC_171_INCOME_BENEFITS.CHILD_SUPPORT,
3520
+ ALIMONY: CVC_171_INCOME_BENEFITS.ALIMONY,
3521
+ FAMILY_FRIENDS: CVC_171_INCOME_BENEFITS.FAMILY_FRIENDS,
3522
+ OTHER: CVC_171_INCOME_BENEFITS.OTHER_INCOME,
3523
+ NONE: CVC_171_INCOME_BENEFITS.NONE,
3524
+ UNKNOWN: CVC_171_INCOME_BENEFITS.UNKNOWN,
3525
+ DECLINED: CVC_171_INCOME_BENEFITS.DECLINED,
3526
+ } as const;
3527
+
3528
+ // @deprecated Use CVC_171_SELECTABLE_VALUES
3529
+ export const CVC_171_VALUES = CVC_171_SELECTABLE_VALUES;
3530
+
3065
3531
  // ─── CVC-179: Employment Status ───────────────────────────────────────
3066
3532
  // Employment status aligned with BLS/Census labor force categories.
3067
3533
  // Uses flattened primary + secondary structure for simplified selection.
@@ -3142,6 +3608,517 @@ export const CVC_179_PRIMARY_CATEGORY: Record<CVC179Value, string> = {
3142
3608
  [CVC_179_EMPLOYMENT_STATUS.DECLINED]: "declined",
3143
3609
  };
3144
3610
 
3611
+ // ─── CVC-179 Hierarchical Structure ────────────────────────────────────
3612
+ // Full hierarchical employment status from IC/CVC codebook (CVC-179).
3613
+ // Designed for HierarchicalCheckboxPicker with selectable top-level categories.
3614
+ // Categories: Employed, Unemployed, Not in Labor Force, Missingness
3615
+ // Top-level categories ARE selectable; selecting a child implies the parent.
3616
+
3617
+ /** Employment status categories for hierarchical grouping */
3618
+ export const CVC_179_HIERARCHICAL_CATEGORY = {
3619
+ EMPLOYED: "employed",
3620
+ UNEMPLOYED: "unemployed",
3621
+ NILF: "nilf",
3622
+ MISSINGNESS: "missingness",
3623
+ } as const;
3624
+
3625
+ export type CVC179HierarchicalCategory =
3626
+ (typeof CVC_179_HIERARCHICAL_CATEGORY)[keyof typeof CVC_179_HIERARCHICAL_CATEGORY];
3627
+
3628
+ /** Display labels for categories */
3629
+ export const CVC_179_HIERARCHICAL_CATEGORY_LABELS: Record<
3630
+ CVC179HierarchicalCategory,
3631
+ string
3632
+ > = {
3633
+ [CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED]: "Employed",
3634
+ [CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED]: "Unemployed",
3635
+ [CVC_179_HIERARCHICAL_CATEGORY.NILF]: "Not in Labor Force",
3636
+ [CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS]: "Missingness",
3637
+ };
3638
+
3639
+ /** All hierarchical employment status values (parent categories + child options) */
3640
+ export const CVC_179_HIERARCHICAL_VALUES = {
3641
+ // Parent categories (selectable)
3642
+ EMP: "emp",
3643
+ UNE: "une",
3644
+ NILF: "nilf",
3645
+ // Employed - children
3646
+ EMP_FT: "emp_ft",
3647
+ EMP_PT: "emp_pt",
3648
+ EMP_SEASONAL: "emp_seasonal",
3649
+ EMP_SELF: "emp_self",
3650
+ EMP_INFORMAL: "emp_informal",
3651
+ EMP_MULTIPLE: "emp_multiple",
3652
+ EMP_UNPAID_FAMILY: "emp_unpaid_family",
3653
+ // Unemployed - children
3654
+ UNE_SEEKING: "une_seeking",
3655
+ UNE_LAID_OFF: "une_laid_off",
3656
+ UNE_FIRST_TIME: "une_first_time",
3657
+ UNE_LONG_TERM: "une_long_term",
3658
+ UNE_LOOKING_HMIS: "une_looking_hmis",
3659
+ // Not in Labor Force - children
3660
+ NILF_STUDENT: "nilf_student",
3661
+ NILF_CAREGIVER: "nilf_caregiver",
3662
+ NILF_DISABLED: "nilf_disabled",
3663
+ NILF_RETIRED: "nilf_retired",
3664
+ NILF_DISCOURAGED: "nilf_discouraged",
3665
+ NILF_OTHER: "nilf_other",
3666
+ NILF_NOT_LOOKING_HMIS: "nilf_not_looking_hmis",
3667
+ NILF_UNABLE_HMIS: "nilf_unable_hmis",
3668
+ // Missingness values (standalone, no children)
3669
+ UNKNOWN: "unknown",
3670
+ CLIENT_DOESNT_KNOW: "client_doesnt_know",
3671
+ DATA_NOT_COLLECTED: "data_not_collected",
3672
+ DOES_NOT_APPLY: "does_not_apply",
3673
+ ANONYMOUS: "anonymous",
3674
+ } as const;
3675
+
3676
+ export type CVC179HierarchicalValue =
3677
+ (typeof CVC_179_HIERARCHICAL_VALUES)[keyof typeof CVC_179_HIERARCHICAL_VALUES];
3678
+
3679
+ /** Human-readable labels for all hierarchical values */
3680
+ export const CVC_179_HIERARCHICAL_LABELS: Record<
3681
+ CVC179HierarchicalValue,
3682
+ string
3683
+ > = {
3684
+ // Parent categories
3685
+ [CVC_179_HIERARCHICAL_VALUES.EMP]: "Employed",
3686
+ [CVC_179_HIERARCHICAL_VALUES.UNE]: "Unemployed",
3687
+ [CVC_179_HIERARCHICAL_VALUES.NILF]: "Not in Labor Force",
3688
+ // Employed - children
3689
+ [CVC_179_HIERARCHICAL_VALUES.EMP_FT]: "Full-time",
3690
+ [CVC_179_HIERARCHICAL_VALUES.EMP_PT]: "Part-time",
3691
+ [CVC_179_HIERARCHICAL_VALUES.EMP_SEASONAL]: "Seasonal / Sporadic",
3692
+ [CVC_179_HIERARCHICAL_VALUES.EMP_SELF]: "Self-employed",
3693
+ [CVC_179_HIERARCHICAL_VALUES.EMP_INFORMAL]: "Informal / Gig work",
3694
+ [CVC_179_HIERARCHICAL_VALUES.EMP_MULTIPLE]: "Multiple jobs",
3695
+ [CVC_179_HIERARCHICAL_VALUES.EMP_UNPAID_FAMILY]: "Unpaid family worker",
3696
+ // Unemployed - children
3697
+ [CVC_179_HIERARCHICAL_VALUES.UNE_SEEKING]: "Actively seeking work",
3698
+ [CVC_179_HIERARCHICAL_VALUES.UNE_LAID_OFF]: "Recently laid off",
3699
+ [CVC_179_HIERARCHICAL_VALUES.UNE_FIRST_TIME]: "First-time job seeker",
3700
+ [CVC_179_HIERARCHICAL_VALUES.UNE_LONG_TERM]: "Long-term unemployed",
3701
+ [CVC_179_HIERARCHICAL_VALUES.UNE_LOOKING_HMIS]: "Looking for work (HMIS)",
3702
+ // Not in Labor Force - children
3703
+ [CVC_179_HIERARCHICAL_VALUES.NILF_STUDENT]: "Student",
3704
+ [CVC_179_HIERARCHICAL_VALUES.NILF_CAREGIVER]: "Caregiver",
3705
+ [CVC_179_HIERARCHICAL_VALUES.NILF_DISABLED]: "Disabled / Unable to work",
3706
+ [CVC_179_HIERARCHICAL_VALUES.NILF_RETIRED]: "Retired",
3707
+ [CVC_179_HIERARCHICAL_VALUES.NILF_DISCOURAGED]: "Discouraged worker",
3708
+ [CVC_179_HIERARCHICAL_VALUES.NILF_OTHER]: "Other (not in labor force)",
3709
+ [CVC_179_HIERARCHICAL_VALUES.NILF_NOT_LOOKING_HMIS]:
3710
+ "Not looking for work (HMIS)",
3711
+ [CVC_179_HIERARCHICAL_VALUES.NILF_UNABLE_HMIS]: "Unable to work (HMIS)",
3712
+ // Missingness
3713
+ [CVC_179_HIERARCHICAL_VALUES.UNKNOWN]: "Unknown",
3714
+ [CVC_179_HIERARCHICAL_VALUES.CLIENT_DOESNT_KNOW]: "Client doesn't know",
3715
+ [CVC_179_HIERARCHICAL_VALUES.DATA_NOT_COLLECTED]: "Data not collected",
3716
+ [CVC_179_HIERARCHICAL_VALUES.DOES_NOT_APPLY]: "Does not apply",
3717
+ [CVC_179_HIERARCHICAL_VALUES.ANONYMOUS]: "Anonymous",
3718
+ };
3719
+
3720
+ /** Maps each value to its display category */
3721
+ export const CVC_179_VALUE_TO_CATEGORY: Record<
3722
+ CVC179HierarchicalValue,
3723
+ CVC179HierarchicalCategory
3724
+ > = {
3725
+ // Parent categories belong to their own category
3726
+ [CVC_179_HIERARCHICAL_VALUES.EMP]: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3727
+ [CVC_179_HIERARCHICAL_VALUES.UNE]: CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3728
+ [CVC_179_HIERARCHICAL_VALUES.NILF]: CVC_179_HIERARCHICAL_CATEGORY.NILF,
3729
+ // Employed children
3730
+ [CVC_179_HIERARCHICAL_VALUES.EMP_FT]: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3731
+ [CVC_179_HIERARCHICAL_VALUES.EMP_PT]: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3732
+ [CVC_179_HIERARCHICAL_VALUES.EMP_SEASONAL]:
3733
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3734
+ [CVC_179_HIERARCHICAL_VALUES.EMP_SELF]:
3735
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3736
+ [CVC_179_HIERARCHICAL_VALUES.EMP_INFORMAL]:
3737
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3738
+ [CVC_179_HIERARCHICAL_VALUES.EMP_MULTIPLE]:
3739
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3740
+ [CVC_179_HIERARCHICAL_VALUES.EMP_UNPAID_FAMILY]:
3741
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3742
+ // Unemployed children
3743
+ [CVC_179_HIERARCHICAL_VALUES.UNE_SEEKING]:
3744
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3745
+ [CVC_179_HIERARCHICAL_VALUES.UNE_LAID_OFF]:
3746
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3747
+ [CVC_179_HIERARCHICAL_VALUES.UNE_FIRST_TIME]:
3748
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3749
+ [CVC_179_HIERARCHICAL_VALUES.UNE_LONG_TERM]:
3750
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3751
+ [CVC_179_HIERARCHICAL_VALUES.UNE_LOOKING_HMIS]:
3752
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3753
+ // NILF children
3754
+ [CVC_179_HIERARCHICAL_VALUES.NILF_STUDENT]:
3755
+ CVC_179_HIERARCHICAL_CATEGORY.NILF,
3756
+ [CVC_179_HIERARCHICAL_VALUES.NILF_CAREGIVER]:
3757
+ CVC_179_HIERARCHICAL_CATEGORY.NILF,
3758
+ [CVC_179_HIERARCHICAL_VALUES.NILF_DISABLED]:
3759
+ CVC_179_HIERARCHICAL_CATEGORY.NILF,
3760
+ [CVC_179_HIERARCHICAL_VALUES.NILF_RETIRED]:
3761
+ CVC_179_HIERARCHICAL_CATEGORY.NILF,
3762
+ [CVC_179_HIERARCHICAL_VALUES.NILF_DISCOURAGED]:
3763
+ CVC_179_HIERARCHICAL_CATEGORY.NILF,
3764
+ [CVC_179_HIERARCHICAL_VALUES.NILF_OTHER]: CVC_179_HIERARCHICAL_CATEGORY.NILF,
3765
+ [CVC_179_HIERARCHICAL_VALUES.NILF_NOT_LOOKING_HMIS]:
3766
+ CVC_179_HIERARCHICAL_CATEGORY.NILF,
3767
+ [CVC_179_HIERARCHICAL_VALUES.NILF_UNABLE_HMIS]:
3768
+ CVC_179_HIERARCHICAL_CATEGORY.NILF,
3769
+ // Missingness
3770
+ [CVC_179_HIERARCHICAL_VALUES.UNKNOWN]:
3771
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
3772
+ [CVC_179_HIERARCHICAL_VALUES.CLIENT_DOESNT_KNOW]:
3773
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
3774
+ [CVC_179_HIERARCHICAL_VALUES.DATA_NOT_COLLECTED]:
3775
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
3776
+ [CVC_179_HIERARCHICAL_VALUES.DOES_NOT_APPLY]:
3777
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
3778
+ [CVC_179_HIERARCHICAL_VALUES.ANONYMOUS]:
3779
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
3780
+ };
3781
+
3782
+ /** Order of categories for display (Missingness last) */
3783
+ export const CVC_179_HIERARCHICAL_CATEGORY_ORDER: CVC179HierarchicalCategory[] =
3784
+ [
3785
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3786
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3787
+ CVC_179_HIERARCHICAL_CATEGORY.NILF,
3788
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
3789
+ ];
3790
+
3791
+ /** Parent-to-children mapping for hierarchical picker */
3792
+ export const CVC_179_PARENT_CHILDREN: Record<string, string[]> = {
3793
+ [CVC_179_HIERARCHICAL_VALUES.EMP]: [
3794
+ CVC_179_HIERARCHICAL_VALUES.EMP_FT,
3795
+ CVC_179_HIERARCHICAL_VALUES.EMP_PT,
3796
+ CVC_179_HIERARCHICAL_VALUES.EMP_SEASONAL,
3797
+ CVC_179_HIERARCHICAL_VALUES.EMP_SELF,
3798
+ CVC_179_HIERARCHICAL_VALUES.EMP_INFORMAL,
3799
+ CVC_179_HIERARCHICAL_VALUES.EMP_MULTIPLE,
3800
+ CVC_179_HIERARCHICAL_VALUES.EMP_UNPAID_FAMILY,
3801
+ ],
3802
+ [CVC_179_HIERARCHICAL_VALUES.UNE]: [
3803
+ CVC_179_HIERARCHICAL_VALUES.UNE_SEEKING,
3804
+ CVC_179_HIERARCHICAL_VALUES.UNE_LAID_OFF,
3805
+ CVC_179_HIERARCHICAL_VALUES.UNE_FIRST_TIME,
3806
+ CVC_179_HIERARCHICAL_VALUES.UNE_LONG_TERM,
3807
+ CVC_179_HIERARCHICAL_VALUES.UNE_LOOKING_HMIS,
3808
+ ],
3809
+ [CVC_179_HIERARCHICAL_VALUES.NILF]: [
3810
+ CVC_179_HIERARCHICAL_VALUES.NILF_STUDENT,
3811
+ CVC_179_HIERARCHICAL_VALUES.NILF_CAREGIVER,
3812
+ CVC_179_HIERARCHICAL_VALUES.NILF_DISABLED,
3813
+ CVC_179_HIERARCHICAL_VALUES.NILF_RETIRED,
3814
+ CVC_179_HIERARCHICAL_VALUES.NILF_DISCOURAGED,
3815
+ CVC_179_HIERARCHICAL_VALUES.NILF_OTHER,
3816
+ CVC_179_HIERARCHICAL_VALUES.NILF_NOT_LOOKING_HMIS,
3817
+ CVC_179_HIERARCHICAL_VALUES.NILF_UNABLE_HMIS,
3818
+ ],
3819
+ };
3820
+
3821
+ /** Child-to-parent mapping (inverse of PARENT_CHILDREN) */
3822
+ export const CVC_179_CHILD_TO_PARENT: Record<string, string> = {
3823
+ // Employed children → emp
3824
+ [CVC_179_HIERARCHICAL_VALUES.EMP_FT]: CVC_179_HIERARCHICAL_VALUES.EMP,
3825
+ [CVC_179_HIERARCHICAL_VALUES.EMP_PT]: CVC_179_HIERARCHICAL_VALUES.EMP,
3826
+ [CVC_179_HIERARCHICAL_VALUES.EMP_SEASONAL]: CVC_179_HIERARCHICAL_VALUES.EMP,
3827
+ [CVC_179_HIERARCHICAL_VALUES.EMP_SELF]: CVC_179_HIERARCHICAL_VALUES.EMP,
3828
+ [CVC_179_HIERARCHICAL_VALUES.EMP_INFORMAL]: CVC_179_HIERARCHICAL_VALUES.EMP,
3829
+ [CVC_179_HIERARCHICAL_VALUES.EMP_MULTIPLE]: CVC_179_HIERARCHICAL_VALUES.EMP,
3830
+ [CVC_179_HIERARCHICAL_VALUES.EMP_UNPAID_FAMILY]:
3831
+ CVC_179_HIERARCHICAL_VALUES.EMP,
3832
+ // Unemployed children → une
3833
+ [CVC_179_HIERARCHICAL_VALUES.UNE_SEEKING]: CVC_179_HIERARCHICAL_VALUES.UNE,
3834
+ [CVC_179_HIERARCHICAL_VALUES.UNE_LAID_OFF]: CVC_179_HIERARCHICAL_VALUES.UNE,
3835
+ [CVC_179_HIERARCHICAL_VALUES.UNE_FIRST_TIME]: CVC_179_HIERARCHICAL_VALUES.UNE,
3836
+ [CVC_179_HIERARCHICAL_VALUES.UNE_LONG_TERM]: CVC_179_HIERARCHICAL_VALUES.UNE,
3837
+ [CVC_179_HIERARCHICAL_VALUES.UNE_LOOKING_HMIS]:
3838
+ CVC_179_HIERARCHICAL_VALUES.UNE,
3839
+ // NILF children → nilf
3840
+ [CVC_179_HIERARCHICAL_VALUES.NILF_STUDENT]: CVC_179_HIERARCHICAL_VALUES.NILF,
3841
+ [CVC_179_HIERARCHICAL_VALUES.NILF_CAREGIVER]: CVC_179_HIERARCHICAL_VALUES.NILF,
3842
+ [CVC_179_HIERARCHICAL_VALUES.NILF_DISABLED]: CVC_179_HIERARCHICAL_VALUES.NILF,
3843
+ [CVC_179_HIERARCHICAL_VALUES.NILF_RETIRED]: CVC_179_HIERARCHICAL_VALUES.NILF,
3844
+ [CVC_179_HIERARCHICAL_VALUES.NILF_DISCOURAGED]:
3845
+ CVC_179_HIERARCHICAL_VALUES.NILF,
3846
+ [CVC_179_HIERARCHICAL_VALUES.NILF_OTHER]: CVC_179_HIERARCHICAL_VALUES.NILF,
3847
+ [CVC_179_HIERARCHICAL_VALUES.NILF_NOT_LOOKING_HMIS]:
3848
+ CVC_179_HIERARCHICAL_VALUES.NILF,
3849
+ [CVC_179_HIERARCHICAL_VALUES.NILF_UNABLE_HMIS]:
3850
+ CVC_179_HIERARCHICAL_VALUES.NILF,
3851
+ };
3852
+
3853
+ /** Selectable options array for HierarchicalCheckboxPicker */
3854
+ export const CVC_179_SELECTABLE_OPTIONS: Array<{
3855
+ value: CVC179HierarchicalValue;
3856
+ label: string;
3857
+ category: CVC179HierarchicalCategory;
3858
+ categoryLabel: string;
3859
+ isParent?: boolean;
3860
+ }> = [
3861
+ // Employed category (parent first, then children)
3862
+ {
3863
+ value: CVC_179_HIERARCHICAL_VALUES.EMP,
3864
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.EMP],
3865
+ category: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3866
+ categoryLabel:
3867
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3868
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED
3869
+ ],
3870
+ isParent: true,
3871
+ },
3872
+ {
3873
+ value: CVC_179_HIERARCHICAL_VALUES.EMP_FT,
3874
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.EMP_FT],
3875
+ category: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3876
+ categoryLabel:
3877
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3878
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED
3879
+ ],
3880
+ },
3881
+ {
3882
+ value: CVC_179_HIERARCHICAL_VALUES.EMP_PT,
3883
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.EMP_PT],
3884
+ category: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3885
+ categoryLabel:
3886
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3887
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED
3888
+ ],
3889
+ },
3890
+ {
3891
+ value: CVC_179_HIERARCHICAL_VALUES.EMP_SEASONAL,
3892
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.EMP_SEASONAL],
3893
+ category: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3894
+ categoryLabel:
3895
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3896
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED
3897
+ ],
3898
+ },
3899
+ {
3900
+ value: CVC_179_HIERARCHICAL_VALUES.EMP_SELF,
3901
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.EMP_SELF],
3902
+ category: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3903
+ categoryLabel:
3904
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3905
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED
3906
+ ],
3907
+ },
3908
+ {
3909
+ value: CVC_179_HIERARCHICAL_VALUES.EMP_INFORMAL,
3910
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.EMP_INFORMAL],
3911
+ category: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3912
+ categoryLabel:
3913
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3914
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED
3915
+ ],
3916
+ },
3917
+ {
3918
+ value: CVC_179_HIERARCHICAL_VALUES.EMP_MULTIPLE,
3919
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.EMP_MULTIPLE],
3920
+ category: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3921
+ categoryLabel:
3922
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3923
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED
3924
+ ],
3925
+ },
3926
+ {
3927
+ value: CVC_179_HIERARCHICAL_VALUES.EMP_UNPAID_FAMILY,
3928
+ label:
3929
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.EMP_UNPAID_FAMILY],
3930
+ category: CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED,
3931
+ categoryLabel:
3932
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3933
+ CVC_179_HIERARCHICAL_CATEGORY.EMPLOYED
3934
+ ],
3935
+ },
3936
+ // Unemployed category
3937
+ {
3938
+ value: CVC_179_HIERARCHICAL_VALUES.UNE,
3939
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.UNE],
3940
+ category: CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3941
+ categoryLabel:
3942
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3943
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED
3944
+ ],
3945
+ isParent: true,
3946
+ },
3947
+ {
3948
+ value: CVC_179_HIERARCHICAL_VALUES.UNE_SEEKING,
3949
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.UNE_SEEKING],
3950
+ category: CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3951
+ categoryLabel:
3952
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3953
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED
3954
+ ],
3955
+ },
3956
+ {
3957
+ value: CVC_179_HIERARCHICAL_VALUES.UNE_LAID_OFF,
3958
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.UNE_LAID_OFF],
3959
+ category: CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3960
+ categoryLabel:
3961
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3962
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED
3963
+ ],
3964
+ },
3965
+ {
3966
+ value: CVC_179_HIERARCHICAL_VALUES.UNE_FIRST_TIME,
3967
+ label:
3968
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.UNE_FIRST_TIME],
3969
+ category: CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3970
+ categoryLabel:
3971
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3972
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED
3973
+ ],
3974
+ },
3975
+ {
3976
+ value: CVC_179_HIERARCHICAL_VALUES.UNE_LONG_TERM,
3977
+ label:
3978
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.UNE_LONG_TERM],
3979
+ category: CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3980
+ categoryLabel:
3981
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3982
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED
3983
+ ],
3984
+ },
3985
+ {
3986
+ value: CVC_179_HIERARCHICAL_VALUES.UNE_LOOKING_HMIS,
3987
+ label:
3988
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.UNE_LOOKING_HMIS],
3989
+ category: CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED,
3990
+ categoryLabel:
3991
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
3992
+ CVC_179_HIERARCHICAL_CATEGORY.UNEMPLOYED
3993
+ ],
3994
+ },
3995
+ // NILF category
3996
+ {
3997
+ value: CVC_179_HIERARCHICAL_VALUES.NILF,
3998
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.NILF],
3999
+ category: CVC_179_HIERARCHICAL_CATEGORY.NILF,
4000
+ categoryLabel:
4001
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[CVC_179_HIERARCHICAL_CATEGORY.NILF],
4002
+ isParent: true,
4003
+ },
4004
+ {
4005
+ value: CVC_179_HIERARCHICAL_VALUES.NILF_STUDENT,
4006
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.NILF_STUDENT],
4007
+ category: CVC_179_HIERARCHICAL_CATEGORY.NILF,
4008
+ categoryLabel:
4009
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[CVC_179_HIERARCHICAL_CATEGORY.NILF],
4010
+ },
4011
+ {
4012
+ value: CVC_179_HIERARCHICAL_VALUES.NILF_CAREGIVER,
4013
+ label:
4014
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.NILF_CAREGIVER],
4015
+ category: CVC_179_HIERARCHICAL_CATEGORY.NILF,
4016
+ categoryLabel:
4017
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[CVC_179_HIERARCHICAL_CATEGORY.NILF],
4018
+ },
4019
+ {
4020
+ value: CVC_179_HIERARCHICAL_VALUES.NILF_DISABLED,
4021
+ label:
4022
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.NILF_DISABLED],
4023
+ category: CVC_179_HIERARCHICAL_CATEGORY.NILF,
4024
+ categoryLabel:
4025
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[CVC_179_HIERARCHICAL_CATEGORY.NILF],
4026
+ },
4027
+ {
4028
+ value: CVC_179_HIERARCHICAL_VALUES.NILF_RETIRED,
4029
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.NILF_RETIRED],
4030
+ category: CVC_179_HIERARCHICAL_CATEGORY.NILF,
4031
+ categoryLabel:
4032
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[CVC_179_HIERARCHICAL_CATEGORY.NILF],
4033
+ },
4034
+ {
4035
+ value: CVC_179_HIERARCHICAL_VALUES.NILF_DISCOURAGED,
4036
+ label:
4037
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.NILF_DISCOURAGED],
4038
+ category: CVC_179_HIERARCHICAL_CATEGORY.NILF,
4039
+ categoryLabel:
4040
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[CVC_179_HIERARCHICAL_CATEGORY.NILF],
4041
+ },
4042
+ {
4043
+ value: CVC_179_HIERARCHICAL_VALUES.NILF_OTHER,
4044
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.NILF_OTHER],
4045
+ category: CVC_179_HIERARCHICAL_CATEGORY.NILF,
4046
+ categoryLabel:
4047
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[CVC_179_HIERARCHICAL_CATEGORY.NILF],
4048
+ },
4049
+ {
4050
+ value: CVC_179_HIERARCHICAL_VALUES.NILF_NOT_LOOKING_HMIS,
4051
+ label:
4052
+ CVC_179_HIERARCHICAL_LABELS[
4053
+ CVC_179_HIERARCHICAL_VALUES.NILF_NOT_LOOKING_HMIS
4054
+ ],
4055
+ category: CVC_179_HIERARCHICAL_CATEGORY.NILF,
4056
+ categoryLabel:
4057
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[CVC_179_HIERARCHICAL_CATEGORY.NILF],
4058
+ },
4059
+ {
4060
+ value: CVC_179_HIERARCHICAL_VALUES.NILF_UNABLE_HMIS,
4061
+ label:
4062
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.NILF_UNABLE_HMIS],
4063
+ category: CVC_179_HIERARCHICAL_CATEGORY.NILF,
4064
+ categoryLabel:
4065
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[CVC_179_HIERARCHICAL_CATEGORY.NILF],
4066
+ },
4067
+ // Missingness category (no parent-child, flat options)
4068
+ {
4069
+ value: CVC_179_HIERARCHICAL_VALUES.UNKNOWN,
4070
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.UNKNOWN],
4071
+ category: CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
4072
+ categoryLabel:
4073
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
4074
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS
4075
+ ],
4076
+ },
4077
+ {
4078
+ value: CVC_179_HIERARCHICAL_VALUES.CLIENT_DOESNT_KNOW,
4079
+ label:
4080
+ CVC_179_HIERARCHICAL_LABELS[
4081
+ CVC_179_HIERARCHICAL_VALUES.CLIENT_DOESNT_KNOW
4082
+ ],
4083
+ category: CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
4084
+ categoryLabel:
4085
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
4086
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS
4087
+ ],
4088
+ },
4089
+ {
4090
+ value: CVC_179_HIERARCHICAL_VALUES.DATA_NOT_COLLECTED,
4091
+ label:
4092
+ CVC_179_HIERARCHICAL_LABELS[
4093
+ CVC_179_HIERARCHICAL_VALUES.DATA_NOT_COLLECTED
4094
+ ],
4095
+ category: CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
4096
+ categoryLabel:
4097
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
4098
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS
4099
+ ],
4100
+ },
4101
+ {
4102
+ value: CVC_179_HIERARCHICAL_VALUES.DOES_NOT_APPLY,
4103
+ label:
4104
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.DOES_NOT_APPLY],
4105
+ category: CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
4106
+ categoryLabel:
4107
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
4108
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS
4109
+ ],
4110
+ },
4111
+ {
4112
+ value: CVC_179_HIERARCHICAL_VALUES.ANONYMOUS,
4113
+ label: CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.ANONYMOUS],
4114
+ category: CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
4115
+ categoryLabel:
4116
+ CVC_179_HIERARCHICAL_CATEGORY_LABELS[
4117
+ CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS
4118
+ ],
4119
+ },
4120
+ ];
4121
+
3145
4122
  // ─── CVC-180: Highest Education Level Completed ───────────────────────
3146
4123
  // Education attainment aligned with Census/ACS categories.
3147
4124
  // Ordinal scale for analytics and modeling.
@@ -3435,6 +4412,180 @@ export const CVC_158_LABELS: Record<CVC158Value, string> = {
3435
4412
  [CVC_158_CUSTODY_STATUS.UNKNOWN]: "Unknown",
3436
4413
  };
3437
4414
 
4415
+ // ─── CVC-159: Relationship Ties ─────────────────────────────────────
4416
+ // Structural constraints that bind two people and affect access, obligations,
4417
+ // safety planning, and service eligibility. Distinct from relationship dynamics
4418
+ // (CVC-145) which captures behavior patterns.
4419
+ // Multi-select attribute on a PersonRelationship record.
4420
+
4421
+ /**
4422
+ * CVC-159 Level 1 Categories
4423
+ * High-level groupings of relationship ties.
4424
+ */
4425
+ export const CVC_159_CATEGORY = {
4426
+ HOUSEHOLD_LIVING: "1.1_HOUSEHOLD_LIVING",
4427
+ CHILD_FAMILY: "1.2_CHILD_FAMILY",
4428
+ LEGAL_FORMAL: "1.3_LEGAL_FORMAL",
4429
+ FINANCIAL_RESOURCE: "1.4_FINANCIAL_RESOURCE",
4430
+ ACCESS_LOGISTICS: "1.5_ACCESS_LOGISTICS",
4431
+ OTHER_FALLBACK: "1.6_OTHER_FALLBACK",
4432
+ MISSINGNESS: "0_MISSINGNESS",
4433
+ } as const;
4434
+
4435
+ export type CVC159Category =
4436
+ (typeof CVC_159_CATEGORY)[keyof typeof CVC_159_CATEGORY];
4437
+
4438
+ export const CVC_159_CATEGORY_LABELS: Record<CVC159Category, string> = {
4439
+ [CVC_159_CATEGORY.HOUSEHOLD_LIVING]: "Household / Living Ties",
4440
+ [CVC_159_CATEGORY.CHILD_FAMILY]: "Child / Family Ties",
4441
+ [CVC_159_CATEGORY.LEGAL_FORMAL]: "Legal / Formal Ties",
4442
+ [CVC_159_CATEGORY.FINANCIAL_RESOURCE]: "Financial / Resource Ties",
4443
+ [CVC_159_CATEGORY.ACCESS_LOGISTICS]: "Access / Logistics Ties",
4444
+ [CVC_159_CATEGORY.OTHER_FALLBACK]: "Other",
4445
+ [CVC_159_CATEGORY.MISSINGNESS]: "Missingness",
4446
+ };
4447
+
4448
+ /**
4449
+ * CVC-159 Relationship Ties codes
4450
+ */
4451
+ export const CVC_159_RELATIONSHIP_TIES = {
4452
+ // Missingness (Level 0)
4453
+ DNC: "DNC",
4454
+ ANON: "ANON",
4455
+ UNK: "UNK",
4456
+ // Household / Living (1.1)
4457
+ COHABITATING: "COHABITATING",
4458
+ SHARED_CARE_ENVIRONMENT: "SHARED_CARE_ENVIRONMENT",
4459
+ // Child / Family (1.2)
4460
+ HAS_CHILDREN_TOGETHER: "HAS_CHILDREN_TOGETHER",
4461
+ CO_PARENTING: "CO_PARENTING",
4462
+ FAMILY_CARE_OBLIGATION: "FAMILY_CARE_OBLIGATION",
4463
+ // Legal / Formal (1.3)
4464
+ LEGALLY_MARRIED: "LEGALLY_MARRIED",
4465
+ SHARED_LEGAL_CASE_OR_ORDER: "SHARED_LEGAL_CASE_OR_ORDER",
4466
+ CUSTODY_OR_VISITATION_LINK: "CUSTODY_OR_VISITATION_LINK",
4467
+ PROTECTIVE_ORDER_LINK: "PROTECTIVE_ORDER_LINK",
4468
+ LEGAL_GUARDIANSHIP: "LEGAL_GUARDIANSHIP",
4469
+ // Financial / Resource (1.4)
4470
+ FINANCIAL_DEPENDENCE: "FINANCIAL_DEPENDENCE",
4471
+ SHARED_EMPLOYMENT_OR_INCOME_LINK: "SHARED_EMPLOYMENT_OR_INCOME_LINK",
4472
+ SHARED_PROPERTY_OR_LEASE: "SHARED_PROPERTY_OR_LEASE",
4473
+ SHARED_FINANCES: "SHARED_FINANCES",
4474
+ // Access / Logistics (1.5)
4475
+ DOCUMENT_OR_ID_LINK: "DOCUMENT_OR_ID_LINK",
4476
+ TRANSPORTATION_DEPENDENCE: "TRANSPORTATION_DEPENDENCE",
4477
+ REGULAR_UNAVOIDABLE_CONTACT: "REGULAR_UNAVOIDABLE_CONTACT",
4478
+ COMMUNICATION_ACCESS_LINK: "COMMUNICATION_ACCESS_LINK",
4479
+ // Other Fallback (1.6)
4480
+ OTHER: "OTHER",
4481
+ } as const;
4482
+
4483
+ export type CVC159Value =
4484
+ (typeof CVC_159_RELATIONSHIP_TIES)[keyof typeof CVC_159_RELATIONSHIP_TIES];
4485
+
4486
+ export const CVC_159_VALUES = Object.values(
4487
+ CVC_159_RELATIONSHIP_TIES,
4488
+ ) as readonly CVC159Value[];
4489
+
4490
+ export const CVC_159_LABELS: Record<CVC159Value, string> = {
4491
+ // Missingness
4492
+ [CVC_159_RELATIONSHIP_TIES.DNC]: "Data not collected",
4493
+ [CVC_159_RELATIONSHIP_TIES.ANON]: "Anonymous / declined to answer",
4494
+ [CVC_159_RELATIONSHIP_TIES.UNK]: "Unknown",
4495
+ // Household / Living
4496
+ [CVC_159_RELATIONSHIP_TIES.COHABITATING]: "Cohabitating",
4497
+ [CVC_159_RELATIONSHIP_TIES.SHARED_CARE_ENVIRONMENT]: "Shared care / supervision environment",
4498
+ // Child / Family
4499
+ [CVC_159_RELATIONSHIP_TIES.HAS_CHILDREN_TOGETHER]: "Has children together",
4500
+ [CVC_159_RELATIONSHIP_TIES.CO_PARENTING]: "Co-parenting",
4501
+ [CVC_159_RELATIONSHIP_TIES.FAMILY_CARE_OBLIGATION]: "Family-based care obligation",
4502
+ // Legal / Formal
4503
+ [CVC_159_RELATIONSHIP_TIES.LEGALLY_MARRIED]: "Legally married",
4504
+ [CVC_159_RELATIONSHIP_TIES.SHARED_LEGAL_CASE_OR_ORDER]: "Shared legal case or order",
4505
+ [CVC_159_RELATIONSHIP_TIES.CUSTODY_OR_VISITATION_LINK]: "Custody / visitation link",
4506
+ [CVC_159_RELATIONSHIP_TIES.PROTECTIVE_ORDER_LINK]: "Protective order link",
4507
+ [CVC_159_RELATIONSHIP_TIES.LEGAL_GUARDIANSHIP]: "Legal guardianship",
4508
+ // Financial / Resource
4509
+ [CVC_159_RELATIONSHIP_TIES.FINANCIAL_DEPENDENCE]: "Financial dependence",
4510
+ [CVC_159_RELATIONSHIP_TIES.SHARED_EMPLOYMENT_OR_INCOME_LINK]: "Shared economic activity link",
4511
+ [CVC_159_RELATIONSHIP_TIES.SHARED_PROPERTY_OR_LEASE]: "Shared property / lease",
4512
+ [CVC_159_RELATIONSHIP_TIES.SHARED_FINANCES]: "Shared finances",
4513
+ // Access / Logistics
4514
+ [CVC_159_RELATIONSHIP_TIES.DOCUMENT_OR_ID_LINK]: "Document / ID link",
4515
+ [CVC_159_RELATIONSHIP_TIES.TRANSPORTATION_DEPENDENCE]: "Transportation dependence",
4516
+ [CVC_159_RELATIONSHIP_TIES.REGULAR_UNAVOIDABLE_CONTACT]: "Regular unavoidable contact",
4517
+ [CVC_159_RELATIONSHIP_TIES.COMMUNICATION_ACCESS_LINK]: "Communication access link",
4518
+ // Other
4519
+ [CVC_159_RELATIONSHIP_TIES.OTHER]: "Other",
4520
+ };
4521
+
4522
+ /**
4523
+ * Maps each tie code to its L1 category.
4524
+ */
4525
+ export const CVC_159_TYPE_TO_CATEGORY: Record<CVC159Value, CVC159Category> = {
4526
+ // Missingness
4527
+ [CVC_159_RELATIONSHIP_TIES.DNC]: CVC_159_CATEGORY.MISSINGNESS,
4528
+ [CVC_159_RELATIONSHIP_TIES.ANON]: CVC_159_CATEGORY.MISSINGNESS,
4529
+ [CVC_159_RELATIONSHIP_TIES.UNK]: CVC_159_CATEGORY.MISSINGNESS,
4530
+ // Household / Living
4531
+ [CVC_159_RELATIONSHIP_TIES.COHABITATING]: CVC_159_CATEGORY.HOUSEHOLD_LIVING,
4532
+ [CVC_159_RELATIONSHIP_TIES.SHARED_CARE_ENVIRONMENT]: CVC_159_CATEGORY.HOUSEHOLD_LIVING,
4533
+ // Child / Family
4534
+ [CVC_159_RELATIONSHIP_TIES.HAS_CHILDREN_TOGETHER]: CVC_159_CATEGORY.CHILD_FAMILY,
4535
+ [CVC_159_RELATIONSHIP_TIES.CO_PARENTING]: CVC_159_CATEGORY.CHILD_FAMILY,
4536
+ [CVC_159_RELATIONSHIP_TIES.FAMILY_CARE_OBLIGATION]: CVC_159_CATEGORY.CHILD_FAMILY,
4537
+ // Legal / Formal
4538
+ [CVC_159_RELATIONSHIP_TIES.LEGALLY_MARRIED]: CVC_159_CATEGORY.LEGAL_FORMAL,
4539
+ [CVC_159_RELATIONSHIP_TIES.SHARED_LEGAL_CASE_OR_ORDER]: CVC_159_CATEGORY.LEGAL_FORMAL,
4540
+ [CVC_159_RELATIONSHIP_TIES.CUSTODY_OR_VISITATION_LINK]: CVC_159_CATEGORY.LEGAL_FORMAL,
4541
+ [CVC_159_RELATIONSHIP_TIES.PROTECTIVE_ORDER_LINK]: CVC_159_CATEGORY.LEGAL_FORMAL,
4542
+ [CVC_159_RELATIONSHIP_TIES.LEGAL_GUARDIANSHIP]: CVC_159_CATEGORY.LEGAL_FORMAL,
4543
+ // Financial / Resource
4544
+ [CVC_159_RELATIONSHIP_TIES.FINANCIAL_DEPENDENCE]: CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4545
+ [CVC_159_RELATIONSHIP_TIES.SHARED_EMPLOYMENT_OR_INCOME_LINK]: CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4546
+ [CVC_159_RELATIONSHIP_TIES.SHARED_PROPERTY_OR_LEASE]: CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4547
+ [CVC_159_RELATIONSHIP_TIES.SHARED_FINANCES]: CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4548
+ // Access / Logistics
4549
+ [CVC_159_RELATIONSHIP_TIES.DOCUMENT_OR_ID_LINK]: CVC_159_CATEGORY.ACCESS_LOGISTICS,
4550
+ [CVC_159_RELATIONSHIP_TIES.TRANSPORTATION_DEPENDENCE]: CVC_159_CATEGORY.ACCESS_LOGISTICS,
4551
+ [CVC_159_RELATIONSHIP_TIES.REGULAR_UNAVOIDABLE_CONTACT]: CVC_159_CATEGORY.ACCESS_LOGISTICS,
4552
+ [CVC_159_RELATIONSHIP_TIES.COMMUNICATION_ACCESS_LINK]: CVC_159_CATEGORY.ACCESS_LOGISTICS,
4553
+ // Other
4554
+ [CVC_159_RELATIONSHIP_TIES.OTHER]: CVC_159_CATEGORY.OTHER_FALLBACK,
4555
+ };
4556
+
4557
+ /** UI option type for grouped dropdowns */
4558
+ export interface CVC159Option {
4559
+ value: CVC159Value;
4560
+ label: string;
4561
+ category: CVC159Category;
4562
+ categoryLabel: string;
4563
+ }
4564
+
4565
+ /** Generate options array grouped by category */
4566
+ export const CVC_159_OPTIONS: readonly CVC159Option[] = Object.entries(
4567
+ CVC_159_TYPE_TO_CATEGORY,
4568
+ ).map(([value, category]) => ({
4569
+ value: value as CVC159Value,
4570
+ label: CVC_159_LABELS[value as CVC159Value],
4571
+ category,
4572
+ categoryLabel: CVC_159_CATEGORY_LABELS[category],
4573
+ }));
4574
+
4575
+ /** Get selectable options (excludes missingness for most UIs) */
4576
+ export const CVC_159_SELECTABLE_OPTIONS: readonly CVC159Option[] =
4577
+ CVC_159_OPTIONS.filter((opt) => opt.category !== CVC_159_CATEGORY.MISSINGNESS);
4578
+
4579
+ /** Category display order for UI */
4580
+ export const CVC_159_CATEGORY_ORDER: readonly CVC159Category[] = [
4581
+ CVC_159_CATEGORY.HOUSEHOLD_LIVING,
4582
+ CVC_159_CATEGORY.CHILD_FAMILY,
4583
+ CVC_159_CATEGORY.LEGAL_FORMAL,
4584
+ CVC_159_CATEGORY.FINANCIAL_RESOURCE,
4585
+ CVC_159_CATEGORY.ACCESS_LOGISTICS,
4586
+ CVC_159_CATEGORY.OTHER_FALLBACK,
4587
+ ];
4588
+
3438
4589
  // ─── CVC-126: Person Relationships ─────────────────────────────────
3439
4590
  // Standard person-to-person relationship types with L1 category groupings.
3440
4591
  // Used across case management for victim-offender, family, and support relationships.
@@ -3616,3 +4767,407 @@ export const CVC_126_OPTIONS: readonly CVC126Option[] = Object.entries(
3616
4767
  category,
3617
4768
  categoryLabel: CVC_126_CATEGORY_LABELS[category],
3618
4769
  }));
4770
+
4771
+ // ─── CVC-72: Human Trafficking Type ─────────────────────────────────
4772
+ // Sub-type of human trafficking when victimization type is HT (IC-5: ST or LT)
4773
+
4774
+ export const CVC_72_HT_TYPE = {
4775
+ SEX: "sex",
4776
+ LABOR: "labor",
4777
+ SEX_AND_LABOR: "sex_and_labor",
4778
+ UNKNOWN: "unknown",
4779
+ } as const;
4780
+
4781
+ export type CVC72Value = (typeof CVC_72_HT_TYPE)[keyof typeof CVC_72_HT_TYPE];
4782
+
4783
+ export const CVC_72_VALUES = [
4784
+ CVC_72_HT_TYPE.SEX,
4785
+ CVC_72_HT_TYPE.LABOR,
4786
+ CVC_72_HT_TYPE.SEX_AND_LABOR,
4787
+ CVC_72_HT_TYPE.UNKNOWN,
4788
+ ] as const;
4789
+
4790
+ export const CVC_72_LABELS: Record<CVC72Value, string> = {
4791
+ [CVC_72_HT_TYPE.SEX]: "Sex Trafficking",
4792
+ [CVC_72_HT_TYPE.LABOR]: "Labor Trafficking",
4793
+ [CVC_72_HT_TYPE.SEX_AND_LABOR]: "Sex & Labor Trafficking",
4794
+ [CVC_72_HT_TYPE.UNKNOWN]: "Unknown",
4795
+ };
4796
+
4797
+ // ─── CVC-136: Alert Indicator Type ──────────────────────────────────
4798
+ // Indicators of victimization, risk, and vulnerability for alerts and assessments.
4799
+ // Organized by category for UI grouping.
4800
+
4801
+ export const CVC_136_INDICATOR_CATEGORY = {
4802
+ MEDICAL_PHYSICAL: "medical_physical",
4803
+ SAFETY_RISK: "safety_risk",
4804
+ BEHAVIORAL_MENTAL_HEALTH: "behavioral_mental_health",
4805
+ HISTORY_BACKGROUND: "history_background",
4806
+ SOCIAL_ENVIRONMENTAL: "social_environmental",
4807
+ OTHER: "other",
4808
+ } as const;
4809
+
4810
+ export type CVC136Category =
4811
+ (typeof CVC_136_INDICATOR_CATEGORY)[keyof typeof CVC_136_INDICATOR_CATEGORY];
4812
+
4813
+ export const CVC_136_CATEGORY_LABELS: Record<CVC136Category, string> = {
4814
+ [CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL]: "Medical / Physical",
4815
+ [CVC_136_INDICATOR_CATEGORY.SAFETY_RISK]: "Safety / Risk",
4816
+ [CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH]:
4817
+ "Behavioral / Mental Health",
4818
+ [CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND]: "History / Background",
4819
+ [CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL]: "Social / Environmental",
4820
+ [CVC_136_INDICATOR_CATEGORY.OTHER]: "Other",
4821
+ };
4822
+
4823
+ export const CVC_136_ALERT_INDICATOR = {
4824
+ // Medical/Physical Indicators
4825
+ HEAD_INJURY: "head_injury",
4826
+ STRANGULATION: "strangulation",
4827
+ PREGNANCY_ABUSE: "pregnancy_abuse",
4828
+ CHRONIC_PAIN: "chronic_pain",
4829
+ UNEXPLAINED_INJURIES: "unexplained_injuries",
4830
+ TRAUMATIC_BRAIN_INJURY: "traumatic_brain_injury",
4831
+ BROKEN_BONES: "broken_bones",
4832
+ BURNS: "burns",
4833
+ BRUISING: "bruising",
4834
+ HEARING_LOSS: "hearing_loss",
4835
+ VISION_PROBLEMS: "vision_problems",
4836
+ DENTAL_INJURIES: "dental_injuries",
4837
+ PREGNANCY_COMPLICATIONS: "pregnancy_complications",
4838
+ STI_HISTORY: "sti_history",
4839
+ HIV_AIDS: "hiv_aids",
4840
+ SLEEP_DISORDERS: "sleep_disorders",
4841
+ EATING_DISORDERS: "eating_disorders",
4842
+ CHRONIC_FATIGUE: "chronic_fatigue",
4843
+
4844
+ // Safety/Risk Indicators
4845
+ WEAPONS_ACCESS: "weapons_access",
4846
+ THREATS_TO_KILL: "threats_to_kill",
4847
+ ATTEMPTED_MURDER: "attempted_murder",
4848
+ FORCED_SEX: "forced_sex",
4849
+ ESCALATING_VIOLENCE: "escalating_violence",
4850
+ STALKING_BEHAVIOR: "stalking_behavior",
4851
+ COERCIVE_CONTROL: "coercive_control",
4852
+ ISOLATION_FROM_SUPPORT: "isolation_from_support",
4853
+ FINANCIAL_CONTROL: "financial_control",
4854
+ TECHNOLOGY_ABUSE: "technology_abuse",
4855
+ THREATS_TO_CHILDREN: "threats_to_children",
4856
+ THREATS_TO_PETS: "threats_to_pets",
4857
+ HARM_TO_PETS: "harm_to_pets",
4858
+ RECENT_SEPARATION: "recent_separation",
4859
+ JEALOUSY_POSSESSIVENESS: "jealousy_possessiveness",
4860
+ VIOLATED_PROTECTION_ORDER: "violated_protection_order",
4861
+
4862
+ // Behavioral/Mental Health Indicators
4863
+ SUBSTANCE_USE: "substance_use",
4864
+ MENTAL_HEALTH: "mental_health",
4865
+ DEPRESSION: "depression",
4866
+ ANXIETY: "anxiety",
4867
+ PTSD: "ptsd",
4868
+ SUICIDAL_IDEATION: "suicidal_ideation",
4869
+ SELF_HARM: "self_harm",
4870
+ DISSOCIATION: "dissociation",
4871
+ HYPERVIGILANCE: "hypervigilance",
4872
+ EMOTIONAL_DYSREGULATION: "emotional_dysregulation",
4873
+ ATTACHMENT_ISSUES: "attachment_issues",
4874
+ COGNITIVE_DIFFICULTIES: "cognitive_difficulties",
4875
+ TRUST_ISSUES: "trust_issues",
4876
+ LOW_SELF_ESTEEM: "low_self_esteem",
4877
+
4878
+ // History/Background Indicators
4879
+ PRIOR_DV: "prior_dv",
4880
+ PRIOR_SEXUAL_ASSAULT: "prior_sexual_assault",
4881
+ PRIOR_HT: "prior_ht",
4882
+ CHILDHOOD_ABUSE: "childhood_abuse",
4883
+ CHILDHOOD_NEGLECT: "childhood_neglect",
4884
+ WITNESS_TO_DV_AS_CHILD: "witness_to_dv_as_child",
4885
+ FOSTER_CARE_HISTORY: "foster_care_history",
4886
+ PRIOR_EXPLOITATION: "prior_exploitation",
4887
+ CRIMINAL_RECORD: "criminal_record",
4888
+ INCARCERATION_HISTORY: "incarceration_history",
4889
+
4890
+ // Social/Environmental Indicators
4891
+ HOMELESSNESS: "homelessness",
4892
+ HOUSING_INSTABILITY: "housing_instability",
4893
+ UNEMPLOYMENT: "unemployment",
4894
+ FINANCIAL_INSTABILITY: "financial_instability",
4895
+ LACK_OF_TRANSPORTATION: "lack_of_transportation",
4896
+ IMMIGRATION_STATUS: "immigration_status",
4897
+ LANGUAGE_BARRIERS: "language_barriers",
4898
+ LIMITED_EDUCATION: "limited_education",
4899
+ SOCIAL_ISOLATION: "social_isolation",
4900
+ LACK_OF_SUPPORT_NETWORK: "lack_of_support_network",
4901
+ RUNAWAY_HISTORY: "runaway_history",
4902
+ GANG_INVOLVEMENT: "gang_involvement",
4903
+
4904
+ // Other
4905
+ OTHER: "other",
4906
+ } as const;
4907
+
4908
+ export type CVC136Value =
4909
+ (typeof CVC_136_ALERT_INDICATOR)[keyof typeof CVC_136_ALERT_INDICATOR];
4910
+
4911
+ export const CVC_136_VALUES = Object.values(
4912
+ CVC_136_ALERT_INDICATOR,
4913
+ ) as readonly CVC136Value[];
4914
+
4915
+ export const CVC_136_LABELS: Record<CVC136Value, string> = {
4916
+ // Medical/Physical Indicators
4917
+ [CVC_136_ALERT_INDICATOR.HEAD_INJURY]: "History of Head Injury",
4918
+ [CVC_136_ALERT_INDICATOR.STRANGULATION]: "History of Strangulation",
4919
+ [CVC_136_ALERT_INDICATOR.PREGNANCY_ABUSE]: "Abuse During Pregnancy",
4920
+ [CVC_136_ALERT_INDICATOR.CHRONIC_PAIN]: "Chronic Pain",
4921
+ [CVC_136_ALERT_INDICATOR.UNEXPLAINED_INJURIES]: "Unexplained Injuries",
4922
+ [CVC_136_ALERT_INDICATOR.TRAUMATIC_BRAIN_INJURY]:
4923
+ "Traumatic Brain Injury (TBI)",
4924
+ [CVC_136_ALERT_INDICATOR.BROKEN_BONES]: "Broken Bones / Fractures",
4925
+ [CVC_136_ALERT_INDICATOR.BURNS]: "Burns",
4926
+ [CVC_136_ALERT_INDICATOR.BRUISING]: "Bruising in Various Stages",
4927
+ [CVC_136_ALERT_INDICATOR.HEARING_LOSS]: "Hearing Loss",
4928
+ [CVC_136_ALERT_INDICATOR.VISION_PROBLEMS]: "Vision Problems",
4929
+ [CVC_136_ALERT_INDICATOR.DENTAL_INJURIES]: "Dental Injuries",
4930
+ [CVC_136_ALERT_INDICATOR.PREGNANCY_COMPLICATIONS]: "Pregnancy Complications",
4931
+ [CVC_136_ALERT_INDICATOR.STI_HISTORY]: "History of STIs",
4932
+ [CVC_136_ALERT_INDICATOR.HIV_AIDS]: "HIV/AIDS",
4933
+ [CVC_136_ALERT_INDICATOR.SLEEP_DISORDERS]: "Sleep Disorders",
4934
+ [CVC_136_ALERT_INDICATOR.EATING_DISORDERS]: "Eating Disorders",
4935
+ [CVC_136_ALERT_INDICATOR.CHRONIC_FATIGUE]: "Chronic Fatigue",
4936
+
4937
+ // Safety/Risk Indicators
4938
+ [CVC_136_ALERT_INDICATOR.WEAPONS_ACCESS]: "Abuser Has Access to Weapons",
4939
+ [CVC_136_ALERT_INDICATOR.THREATS_TO_KILL]: "Threats to Kill",
4940
+ [CVC_136_ALERT_INDICATOR.ATTEMPTED_MURDER]: "Attempted Murder / Near-Fatal",
4941
+ [CVC_136_ALERT_INDICATOR.FORCED_SEX]: "Forced Sexual Acts",
4942
+ [CVC_136_ALERT_INDICATOR.ESCALATING_VIOLENCE]: "Escalating Violence",
4943
+ [CVC_136_ALERT_INDICATOR.STALKING_BEHAVIOR]: "Stalking Behavior",
4944
+ [CVC_136_ALERT_INDICATOR.COERCIVE_CONTROL]: "Coercive Control",
4945
+ [CVC_136_ALERT_INDICATOR.ISOLATION_FROM_SUPPORT]:
4946
+ "Isolation from Support System",
4947
+ [CVC_136_ALERT_INDICATOR.FINANCIAL_CONTROL]: "Financial Control / Abuse",
4948
+ [CVC_136_ALERT_INDICATOR.TECHNOLOGY_ABUSE]: "Technology-Facilitated Abuse",
4949
+ [CVC_136_ALERT_INDICATOR.THREATS_TO_CHILDREN]: "Threats Against Children",
4950
+ [CVC_136_ALERT_INDICATOR.THREATS_TO_PETS]: "Threats Against Pets",
4951
+ [CVC_136_ALERT_INDICATOR.HARM_TO_PETS]: "Harm to Pets / Animals",
4952
+ [CVC_136_ALERT_INDICATOR.RECENT_SEPARATION]: "Recent Separation / Left Abuser",
4953
+ [CVC_136_ALERT_INDICATOR.JEALOUSY_POSSESSIVENESS]:
4954
+ "Extreme Jealousy / Possessiveness",
4955
+ [CVC_136_ALERT_INDICATOR.VIOLATED_PROTECTION_ORDER]:
4956
+ "Violated Protection Order",
4957
+
4958
+ // Behavioral/Mental Health Indicators
4959
+ [CVC_136_ALERT_INDICATOR.SUBSTANCE_USE]: "Substance Use Concerns",
4960
+ [CVC_136_ALERT_INDICATOR.MENTAL_HEALTH]: "Mental Health Concerns",
4961
+ [CVC_136_ALERT_INDICATOR.DEPRESSION]: "Depression",
4962
+ [CVC_136_ALERT_INDICATOR.ANXIETY]: "Anxiety Disorder",
4963
+ [CVC_136_ALERT_INDICATOR.PTSD]: "PTSD / Trauma Response",
4964
+ [CVC_136_ALERT_INDICATOR.SUICIDAL_IDEATION]: "Suicidal Ideation",
4965
+ [CVC_136_ALERT_INDICATOR.SELF_HARM]: "Self-Harm",
4966
+ [CVC_136_ALERT_INDICATOR.DISSOCIATION]: "Dissociation",
4967
+ [CVC_136_ALERT_INDICATOR.HYPERVIGILANCE]: "Hypervigilance",
4968
+ [CVC_136_ALERT_INDICATOR.EMOTIONAL_DYSREGULATION]: "Emotional Dysregulation",
4969
+ [CVC_136_ALERT_INDICATOR.ATTACHMENT_ISSUES]: "Attachment Issues",
4970
+ [CVC_136_ALERT_INDICATOR.COGNITIVE_DIFFICULTIES]: "Cognitive Difficulties",
4971
+ [CVC_136_ALERT_INDICATOR.TRUST_ISSUES]: "Trust Issues",
4972
+ [CVC_136_ALERT_INDICATOR.LOW_SELF_ESTEEM]: "Low Self-Esteem",
4973
+
4974
+ // History/Background Indicators
4975
+ [CVC_136_ALERT_INDICATOR.PRIOR_DV]: "Prior Domestic Violence",
4976
+ [CVC_136_ALERT_INDICATOR.PRIOR_SEXUAL_ASSAULT]: "Prior Sexual Assault",
4977
+ [CVC_136_ALERT_INDICATOR.PRIOR_HT]: "Prior Human Trafficking",
4978
+ [CVC_136_ALERT_INDICATOR.CHILDHOOD_ABUSE]: "History of Childhood Abuse",
4979
+ [CVC_136_ALERT_INDICATOR.CHILDHOOD_NEGLECT]: "History of Childhood Neglect",
4980
+ [CVC_136_ALERT_INDICATOR.WITNESS_TO_DV_AS_CHILD]: "Witnessed DV as Child",
4981
+ [CVC_136_ALERT_INDICATOR.FOSTER_CARE_HISTORY]: "Foster Care History",
4982
+ [CVC_136_ALERT_INDICATOR.PRIOR_EXPLOITATION]: "Prior Exploitation",
4983
+ [CVC_136_ALERT_INDICATOR.CRIMINAL_RECORD]: "Criminal Record",
4984
+ [CVC_136_ALERT_INDICATOR.INCARCERATION_HISTORY]: "Incarceration History",
4985
+
4986
+ // Social/Environmental Indicators
4987
+ [CVC_136_ALERT_INDICATOR.HOMELESSNESS]: "History of Homelessness",
4988
+ [CVC_136_ALERT_INDICATOR.HOUSING_INSTABILITY]: "Housing Instability",
4989
+ [CVC_136_ALERT_INDICATOR.UNEMPLOYMENT]: "Unemployment",
4990
+ [CVC_136_ALERT_INDICATOR.FINANCIAL_INSTABILITY]: "Financial Instability",
4991
+ [CVC_136_ALERT_INDICATOR.LACK_OF_TRANSPORTATION]: "Lack of Transportation",
4992
+ [CVC_136_ALERT_INDICATOR.IMMIGRATION_STATUS]: "Immigration Status Concerns",
4993
+ [CVC_136_ALERT_INDICATOR.LANGUAGE_BARRIERS]: "Language Barriers",
4994
+ [CVC_136_ALERT_INDICATOR.LIMITED_EDUCATION]: "Limited Education",
4995
+ [CVC_136_ALERT_INDICATOR.SOCIAL_ISOLATION]: "Social Isolation",
4996
+ [CVC_136_ALERT_INDICATOR.LACK_OF_SUPPORT_NETWORK]: "Lack of Support Network",
4997
+ [CVC_136_ALERT_INDICATOR.RUNAWAY_HISTORY]: "Runaway History",
4998
+ [CVC_136_ALERT_INDICATOR.GANG_INVOLVEMENT]: "Gang Involvement",
4999
+
5000
+ // Other
5001
+ [CVC_136_ALERT_INDICATOR.OTHER]: "Other",
5002
+ };
5003
+
5004
+ /** Map each indicator to its category */
5005
+ export const CVC_136_TYPE_TO_CATEGORY: Record<CVC136Value, CVC136Category> = {
5006
+ // Medical/Physical
5007
+ [CVC_136_ALERT_INDICATOR.HEAD_INJURY]:
5008
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5009
+ [CVC_136_ALERT_INDICATOR.STRANGULATION]:
5010
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5011
+ [CVC_136_ALERT_INDICATOR.PREGNANCY_ABUSE]:
5012
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5013
+ [CVC_136_ALERT_INDICATOR.CHRONIC_PAIN]:
5014
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5015
+ [CVC_136_ALERT_INDICATOR.UNEXPLAINED_INJURIES]:
5016
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5017
+ [CVC_136_ALERT_INDICATOR.TRAUMATIC_BRAIN_INJURY]:
5018
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5019
+ [CVC_136_ALERT_INDICATOR.BROKEN_BONES]:
5020
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5021
+ [CVC_136_ALERT_INDICATOR.BURNS]: CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5022
+ [CVC_136_ALERT_INDICATOR.BRUISING]:
5023
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5024
+ [CVC_136_ALERT_INDICATOR.HEARING_LOSS]:
5025
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5026
+ [CVC_136_ALERT_INDICATOR.VISION_PROBLEMS]:
5027
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5028
+ [CVC_136_ALERT_INDICATOR.DENTAL_INJURIES]:
5029
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5030
+ [CVC_136_ALERT_INDICATOR.PREGNANCY_COMPLICATIONS]:
5031
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5032
+ [CVC_136_ALERT_INDICATOR.STI_HISTORY]:
5033
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5034
+ [CVC_136_ALERT_INDICATOR.HIV_AIDS]:
5035
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5036
+ [CVC_136_ALERT_INDICATOR.SLEEP_DISORDERS]:
5037
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5038
+ [CVC_136_ALERT_INDICATOR.EATING_DISORDERS]:
5039
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5040
+ [CVC_136_ALERT_INDICATOR.CHRONIC_FATIGUE]:
5041
+ CVC_136_INDICATOR_CATEGORY.MEDICAL_PHYSICAL,
5042
+
5043
+ // Safety/Risk
5044
+ [CVC_136_ALERT_INDICATOR.WEAPONS_ACCESS]:
5045
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5046
+ [CVC_136_ALERT_INDICATOR.THREATS_TO_KILL]:
5047
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5048
+ [CVC_136_ALERT_INDICATOR.ATTEMPTED_MURDER]:
5049
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5050
+ [CVC_136_ALERT_INDICATOR.FORCED_SEX]: CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5051
+ [CVC_136_ALERT_INDICATOR.ESCALATING_VIOLENCE]:
5052
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5053
+ [CVC_136_ALERT_INDICATOR.STALKING_BEHAVIOR]:
5054
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5055
+ [CVC_136_ALERT_INDICATOR.COERCIVE_CONTROL]:
5056
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5057
+ [CVC_136_ALERT_INDICATOR.ISOLATION_FROM_SUPPORT]:
5058
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5059
+ [CVC_136_ALERT_INDICATOR.FINANCIAL_CONTROL]:
5060
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5061
+ [CVC_136_ALERT_INDICATOR.TECHNOLOGY_ABUSE]:
5062
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5063
+ [CVC_136_ALERT_INDICATOR.THREATS_TO_CHILDREN]:
5064
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5065
+ [CVC_136_ALERT_INDICATOR.THREATS_TO_PETS]:
5066
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5067
+ [CVC_136_ALERT_INDICATOR.HARM_TO_PETS]:
5068
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5069
+ [CVC_136_ALERT_INDICATOR.RECENT_SEPARATION]:
5070
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5071
+ [CVC_136_ALERT_INDICATOR.JEALOUSY_POSSESSIVENESS]:
5072
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5073
+ [CVC_136_ALERT_INDICATOR.VIOLATED_PROTECTION_ORDER]:
5074
+ CVC_136_INDICATOR_CATEGORY.SAFETY_RISK,
5075
+
5076
+ // Behavioral/Mental Health
5077
+ [CVC_136_ALERT_INDICATOR.SUBSTANCE_USE]:
5078
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5079
+ [CVC_136_ALERT_INDICATOR.MENTAL_HEALTH]:
5080
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5081
+ [CVC_136_ALERT_INDICATOR.DEPRESSION]:
5082
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5083
+ [CVC_136_ALERT_INDICATOR.ANXIETY]:
5084
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5085
+ [CVC_136_ALERT_INDICATOR.PTSD]:
5086
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5087
+ [CVC_136_ALERT_INDICATOR.SUICIDAL_IDEATION]:
5088
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5089
+ [CVC_136_ALERT_INDICATOR.SELF_HARM]:
5090
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5091
+ [CVC_136_ALERT_INDICATOR.DISSOCIATION]:
5092
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5093
+ [CVC_136_ALERT_INDICATOR.HYPERVIGILANCE]:
5094
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5095
+ [CVC_136_ALERT_INDICATOR.EMOTIONAL_DYSREGULATION]:
5096
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5097
+ [CVC_136_ALERT_INDICATOR.ATTACHMENT_ISSUES]:
5098
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5099
+ [CVC_136_ALERT_INDICATOR.COGNITIVE_DIFFICULTIES]:
5100
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5101
+ [CVC_136_ALERT_INDICATOR.TRUST_ISSUES]:
5102
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5103
+ [CVC_136_ALERT_INDICATOR.LOW_SELF_ESTEEM]:
5104
+ CVC_136_INDICATOR_CATEGORY.BEHAVIORAL_MENTAL_HEALTH,
5105
+
5106
+ // History/Background
5107
+ [CVC_136_ALERT_INDICATOR.PRIOR_DV]:
5108
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5109
+ [CVC_136_ALERT_INDICATOR.PRIOR_SEXUAL_ASSAULT]:
5110
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5111
+ [CVC_136_ALERT_INDICATOR.PRIOR_HT]:
5112
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5113
+ [CVC_136_ALERT_INDICATOR.CHILDHOOD_ABUSE]:
5114
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5115
+ [CVC_136_ALERT_INDICATOR.CHILDHOOD_NEGLECT]:
5116
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5117
+ [CVC_136_ALERT_INDICATOR.WITNESS_TO_DV_AS_CHILD]:
5118
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5119
+ [CVC_136_ALERT_INDICATOR.FOSTER_CARE_HISTORY]:
5120
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5121
+ [CVC_136_ALERT_INDICATOR.PRIOR_EXPLOITATION]:
5122
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5123
+ [CVC_136_ALERT_INDICATOR.CRIMINAL_RECORD]:
5124
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5125
+ [CVC_136_ALERT_INDICATOR.INCARCERATION_HISTORY]:
5126
+ CVC_136_INDICATOR_CATEGORY.HISTORY_BACKGROUND,
5127
+
5128
+ // Social/Environmental
5129
+ [CVC_136_ALERT_INDICATOR.HOMELESSNESS]:
5130
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5131
+ [CVC_136_ALERT_INDICATOR.HOUSING_INSTABILITY]:
5132
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5133
+ [CVC_136_ALERT_INDICATOR.UNEMPLOYMENT]:
5134
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5135
+ [CVC_136_ALERT_INDICATOR.FINANCIAL_INSTABILITY]:
5136
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5137
+ [CVC_136_ALERT_INDICATOR.LACK_OF_TRANSPORTATION]:
5138
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5139
+ [CVC_136_ALERT_INDICATOR.IMMIGRATION_STATUS]:
5140
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5141
+ [CVC_136_ALERT_INDICATOR.LANGUAGE_BARRIERS]:
5142
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5143
+ [CVC_136_ALERT_INDICATOR.LIMITED_EDUCATION]:
5144
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5145
+ [CVC_136_ALERT_INDICATOR.SOCIAL_ISOLATION]:
5146
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5147
+ [CVC_136_ALERT_INDICATOR.LACK_OF_SUPPORT_NETWORK]:
5148
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5149
+ [CVC_136_ALERT_INDICATOR.RUNAWAY_HISTORY]:
5150
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5151
+ [CVC_136_ALERT_INDICATOR.GANG_INVOLVEMENT]:
5152
+ CVC_136_INDICATOR_CATEGORY.SOCIAL_ENVIRONMENTAL,
5153
+
5154
+ // Other
5155
+ [CVC_136_ALERT_INDICATOR.OTHER]: CVC_136_INDICATOR_CATEGORY.OTHER,
5156
+ };
5157
+
5158
+ /** UI dropdown options grouped by category */
5159
+ export type CVC136Option = {
5160
+ value: CVC136Value;
5161
+ label: string;
5162
+ category: CVC136Category;
5163
+ categoryLabel: string;
5164
+ };
5165
+
5166
+ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5167
+ CVC_136_TYPE_TO_CATEGORY,
5168
+ ).map(([value, category]) => ({
5169
+ value: value as CVC136Value,
5170
+ label: CVC_136_LABELS[value as CVC136Value],
5171
+ category,
5172
+ categoryLabel: CVC_136_CATEGORY_LABELS[category],
5173
+ }));