psytools 0.6.2 → 0.6.4

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.
Files changed (290) hide show
  1. package/LICENSE +8 -5
  2. package/README.md +24 -7
  3. package/SOURCES.md +165 -3
  4. package/dist/cjs/inventories/cbi.d.ts +31 -0
  5. package/dist/cjs/inventories/cbi.js +122 -0
  6. package/dist/cjs/inventories/csi16.d.ts +10 -0
  7. package/dist/cjs/inventories/csi16.js +160 -0
  8. package/dist/cjs/inventories/eat26.d.ts +12 -0
  9. package/dist/cjs/inventories/eat26.js +111 -0
  10. package/dist/cjs/inventories/gds15.d.ts +11 -0
  11. package/dist/cjs/inventories/gds15.js +81 -0
  12. package/dist/cjs/inventories/index.d.ts +14 -1
  13. package/dist/cjs/inventories/index.js +34 -1
  14. package/dist/cjs/inventories/pc-ptsd-5.d.ts +12 -0
  15. package/dist/cjs/inventories/pc-ptsd-5.js +91 -0
  16. package/dist/cjs/inventories/pcl5.d.ts +10 -0
  17. package/dist/cjs/inventories/pcl5.js +124 -0
  18. package/dist/cjs/inventories/phq15.d.ts +10 -0
  19. package/dist/cjs/inventories/phq15.js +74 -0
  20. package/dist/cjs/inventories/phq4.d.ts +11 -0
  21. package/dist/cjs/inventories/phq4.js +73 -0
  22. package/dist/cjs/inventories/phq8.d.ts +11 -0
  23. package/dist/cjs/inventories/phq8.js +71 -0
  24. package/dist/cjs/inventories/tipi.d.ts +10 -0
  25. package/dist/cjs/inventories/tipi.js +70 -0
  26. package/dist/cjs/inventories/ucla-ls3.d.ts +10 -0
  27. package/dist/cjs/inventories/ucla-ls3.js +127 -0
  28. package/dist/cjs/locales/de/cbi.d.ts +7 -0
  29. package/dist/cjs/locales/de/cbi.js +110 -0
  30. package/dist/cjs/locales/de/csi16.d.ts +3 -0
  31. package/dist/cjs/locales/de/csi16.js +61 -0
  32. package/dist/cjs/locales/de/eat26.d.ts +3 -0
  33. package/dist/cjs/locales/de/eat26.js +47 -0
  34. package/dist/cjs/locales/de/gds15.d.ts +4 -0
  35. package/dist/cjs/locales/de/gds15.js +34 -0
  36. package/dist/cjs/locales/de/pc-ptsd-5.d.ts +4 -0
  37. package/dist/cjs/locales/de/pc-ptsd-5.js +32 -0
  38. package/dist/cjs/locales/de/pcl5.d.ts +4 -0
  39. package/dist/cjs/locales/de/pcl5.js +48 -0
  40. package/dist/cjs/locales/de/phq15.d.ts +4 -0
  41. package/dist/cjs/locales/de/phq15.js +35 -0
  42. package/dist/cjs/locales/de/phq4.d.ts +4 -0
  43. package/dist/cjs/locales/de/phq4.js +35 -0
  44. package/dist/cjs/locales/de/phq8.d.ts +4 -0
  45. package/dist/cjs/locales/de/phq8.js +35 -0
  46. package/dist/cjs/locales/de/tipi.d.ts +4 -0
  47. package/dist/cjs/locales/de/tipi.js +39 -0
  48. package/dist/cjs/locales/de/ucla-ls3.d.ts +4 -0
  49. package/dist/cjs/locales/de/ucla-ls3.js +48 -0
  50. package/dist/cjs/locales/es/cbi.d.ts +7 -0
  51. package/dist/cjs/locales/es/cbi.js +110 -0
  52. package/dist/cjs/locales/es/csi16.d.ts +3 -0
  53. package/dist/cjs/locales/es/csi16.js +68 -0
  54. package/dist/cjs/locales/es/eat26.d.ts +3 -0
  55. package/dist/cjs/locales/es/eat26.js +47 -0
  56. package/dist/cjs/locales/es/gds15.d.ts +4 -0
  57. package/dist/cjs/locales/es/gds15.js +34 -0
  58. package/dist/cjs/locales/es/pc-ptsd-5.d.ts +4 -0
  59. package/dist/cjs/locales/es/pc-ptsd-5.js +32 -0
  60. package/dist/cjs/locales/es/pcl5.d.ts +4 -0
  61. package/dist/cjs/locales/es/pcl5.js +48 -0
  62. package/dist/cjs/locales/es/phq15.d.ts +4 -0
  63. package/dist/cjs/locales/es/phq15.js +35 -0
  64. package/dist/cjs/locales/es/phq4.d.ts +4 -0
  65. package/dist/cjs/locales/es/phq4.js +35 -0
  66. package/dist/cjs/locales/es/phq8.d.ts +4 -0
  67. package/dist/cjs/locales/es/phq8.js +35 -0
  68. package/dist/cjs/locales/es/tipi.d.ts +4 -0
  69. package/dist/cjs/locales/es/tipi.js +39 -0
  70. package/dist/cjs/locales/es/ucla-ls3.d.ts +4 -0
  71. package/dist/cjs/locales/es/ucla-ls3.js +44 -0
  72. package/dist/cjs/locales/index.js +66 -0
  73. package/dist/cjs/locales/tr/cbi.d.ts +8 -0
  74. package/dist/cjs/locales/tr/cbi.js +111 -0
  75. package/dist/cjs/locales/tr/csi16.d.ts +3 -0
  76. package/dist/cjs/locales/tr/csi16.js +68 -0
  77. package/dist/cjs/locales/tr/eat26.d.ts +3 -0
  78. package/dist/cjs/locales/tr/eat26.js +47 -0
  79. package/dist/cjs/locales/tr/gds15.d.ts +4 -0
  80. package/dist/cjs/locales/tr/gds15.js +34 -0
  81. package/dist/cjs/locales/tr/pc-ptsd-5.d.ts +4 -0
  82. package/dist/cjs/locales/tr/pc-ptsd-5.js +32 -0
  83. package/dist/cjs/locales/tr/pcl5.d.ts +4 -0
  84. package/dist/cjs/locales/tr/pcl5.js +48 -0
  85. package/dist/cjs/locales/tr/phq15.d.ts +4 -0
  86. package/dist/cjs/locales/tr/phq15.js +35 -0
  87. package/dist/cjs/locales/tr/phq4.d.ts +4 -0
  88. package/dist/cjs/locales/tr/phq4.js +35 -0
  89. package/dist/cjs/locales/tr/phq8.d.ts +4 -0
  90. package/dist/cjs/locales/tr/phq8.js +33 -0
  91. package/dist/cjs/locales/tr/tipi.d.ts +4 -0
  92. package/dist/cjs/locales/tr/tipi.js +39 -0
  93. package/dist/cjs/locales/tr/ucla-ls3.d.ts +4 -0
  94. package/dist/cjs/locales/tr/ucla-ls3.js +44 -0
  95. package/dist/cjs/locales/zh/cbi.d.ts +7 -0
  96. package/dist/cjs/locales/zh/cbi.js +110 -0
  97. package/dist/cjs/locales/zh/csi16.d.ts +3 -0
  98. package/dist/cjs/locales/zh/csi16.js +46 -0
  99. package/dist/cjs/locales/zh/eat26.d.ts +3 -0
  100. package/dist/cjs/locales/zh/eat26.js +45 -0
  101. package/dist/cjs/locales/zh/gds15.d.ts +4 -0
  102. package/dist/cjs/locales/zh/gds15.js +34 -0
  103. package/dist/cjs/locales/zh/pc-ptsd-5.d.ts +4 -0
  104. package/dist/cjs/locales/zh/pc-ptsd-5.js +32 -0
  105. package/dist/cjs/locales/zh/pcl5.d.ts +4 -0
  106. package/dist/cjs/locales/zh/pcl5.js +44 -0
  107. package/dist/cjs/locales/zh/phq15.d.ts +4 -0
  108. package/dist/cjs/locales/zh/phq15.js +35 -0
  109. package/dist/cjs/locales/zh/phq4.d.ts +4 -0
  110. package/dist/cjs/locales/zh/phq4.js +35 -0
  111. package/dist/cjs/locales/zh/phq8.d.ts +4 -0
  112. package/dist/cjs/locales/zh/phq8.js +31 -0
  113. package/dist/cjs/locales/zh/tipi.d.ts +4 -0
  114. package/dist/cjs/locales/zh/tipi.js +31 -0
  115. package/dist/cjs/locales/zh/ucla-ls3.d.ts +4 -0
  116. package/dist/cjs/locales/zh/ucla-ls3.js +34 -0
  117. package/dist/cjs/types.d.ts +10 -2
  118. package/dist/esm/inventories/cbi.d.ts +31 -0
  119. package/dist/esm/inventories/cbi.js +119 -0
  120. package/dist/esm/inventories/csi16.d.ts +10 -0
  121. package/dist/esm/inventories/csi16.js +157 -0
  122. package/dist/esm/inventories/eat26.d.ts +12 -0
  123. package/dist/esm/inventories/eat26.js +108 -0
  124. package/dist/esm/inventories/gds15.d.ts +11 -0
  125. package/dist/esm/inventories/gds15.js +78 -0
  126. package/dist/esm/inventories/index.d.ts +14 -1
  127. package/dist/esm/inventories/index.js +24 -0
  128. package/dist/esm/inventories/pc-ptsd-5.d.ts +12 -0
  129. package/dist/esm/inventories/pc-ptsd-5.js +88 -0
  130. package/dist/esm/inventories/pcl5.d.ts +10 -0
  131. package/dist/esm/inventories/pcl5.js +121 -0
  132. package/dist/esm/inventories/phq15.d.ts +10 -0
  133. package/dist/esm/inventories/phq15.js +71 -0
  134. package/dist/esm/inventories/phq4.d.ts +11 -0
  135. package/dist/esm/inventories/phq4.js +70 -0
  136. package/dist/esm/inventories/phq8.d.ts +11 -0
  137. package/dist/esm/inventories/phq8.js +68 -0
  138. package/dist/esm/inventories/tipi.d.ts +10 -0
  139. package/dist/esm/inventories/tipi.js +67 -0
  140. package/dist/esm/inventories/ucla-ls3.d.ts +10 -0
  141. package/dist/esm/inventories/ucla-ls3.js +124 -0
  142. package/dist/esm/locales/de/cbi.d.ts +7 -0
  143. package/dist/esm/locales/de/cbi.js +108 -0
  144. package/dist/esm/locales/de/csi16.d.ts +3 -0
  145. package/dist/esm/locales/de/csi16.js +59 -0
  146. package/dist/esm/locales/de/eat26.d.ts +3 -0
  147. package/dist/esm/locales/de/eat26.js +45 -0
  148. package/dist/esm/locales/de/gds15.d.ts +4 -0
  149. package/dist/esm/locales/de/gds15.js +32 -0
  150. package/dist/esm/locales/de/pc-ptsd-5.d.ts +4 -0
  151. package/dist/esm/locales/de/pc-ptsd-5.js +30 -0
  152. package/dist/esm/locales/de/pcl5.d.ts +4 -0
  153. package/dist/esm/locales/de/pcl5.js +46 -0
  154. package/dist/esm/locales/de/phq15.d.ts +4 -0
  155. package/dist/esm/locales/de/phq15.js +33 -0
  156. package/dist/esm/locales/de/phq4.d.ts +4 -0
  157. package/dist/esm/locales/de/phq4.js +33 -0
  158. package/dist/esm/locales/de/phq8.d.ts +4 -0
  159. package/dist/esm/locales/de/phq8.js +33 -0
  160. package/dist/esm/locales/de/tipi.d.ts +4 -0
  161. package/dist/esm/locales/de/tipi.js +37 -0
  162. package/dist/esm/locales/de/ucla-ls3.d.ts +4 -0
  163. package/dist/esm/locales/de/ucla-ls3.js +46 -0
  164. package/dist/esm/locales/es/cbi.d.ts +7 -0
  165. package/dist/esm/locales/es/cbi.js +108 -0
  166. package/dist/esm/locales/es/csi16.d.ts +3 -0
  167. package/dist/esm/locales/es/csi16.js +66 -0
  168. package/dist/esm/locales/es/eat26.d.ts +3 -0
  169. package/dist/esm/locales/es/eat26.js +45 -0
  170. package/dist/esm/locales/es/gds15.d.ts +4 -0
  171. package/dist/esm/locales/es/gds15.js +32 -0
  172. package/dist/esm/locales/es/pc-ptsd-5.d.ts +4 -0
  173. package/dist/esm/locales/es/pc-ptsd-5.js +30 -0
  174. package/dist/esm/locales/es/pcl5.d.ts +4 -0
  175. package/dist/esm/locales/es/pcl5.js +46 -0
  176. package/dist/esm/locales/es/phq15.d.ts +4 -0
  177. package/dist/esm/locales/es/phq15.js +33 -0
  178. package/dist/esm/locales/es/phq4.d.ts +4 -0
  179. package/dist/esm/locales/es/phq4.js +33 -0
  180. package/dist/esm/locales/es/phq8.d.ts +4 -0
  181. package/dist/esm/locales/es/phq8.js +33 -0
  182. package/dist/esm/locales/es/tipi.d.ts +4 -0
  183. package/dist/esm/locales/es/tipi.js +37 -0
  184. package/dist/esm/locales/es/ucla-ls3.d.ts +4 -0
  185. package/dist/esm/locales/es/ucla-ls3.js +42 -0
  186. package/dist/esm/locales/index.js +66 -0
  187. package/dist/esm/locales/tr/cbi.d.ts +8 -0
  188. package/dist/esm/locales/tr/cbi.js +109 -0
  189. package/dist/esm/locales/tr/csi16.d.ts +3 -0
  190. package/dist/esm/locales/tr/csi16.js +66 -0
  191. package/dist/esm/locales/tr/eat26.d.ts +3 -0
  192. package/dist/esm/locales/tr/eat26.js +45 -0
  193. package/dist/esm/locales/tr/gds15.d.ts +4 -0
  194. package/dist/esm/locales/tr/gds15.js +32 -0
  195. package/dist/esm/locales/tr/pc-ptsd-5.d.ts +4 -0
  196. package/dist/esm/locales/tr/pc-ptsd-5.js +30 -0
  197. package/dist/esm/locales/tr/pcl5.d.ts +4 -0
  198. package/dist/esm/locales/tr/pcl5.js +46 -0
  199. package/dist/esm/locales/tr/phq15.d.ts +4 -0
  200. package/dist/esm/locales/tr/phq15.js +33 -0
  201. package/dist/esm/locales/tr/phq4.d.ts +4 -0
  202. package/dist/esm/locales/tr/phq4.js +33 -0
  203. package/dist/esm/locales/tr/phq8.d.ts +4 -0
  204. package/dist/esm/locales/tr/phq8.js +31 -0
  205. package/dist/esm/locales/tr/tipi.d.ts +4 -0
  206. package/dist/esm/locales/tr/tipi.js +37 -0
  207. package/dist/esm/locales/tr/ucla-ls3.d.ts +4 -0
  208. package/dist/esm/locales/tr/ucla-ls3.js +42 -0
  209. package/dist/esm/locales/zh/cbi.d.ts +7 -0
  210. package/dist/esm/locales/zh/cbi.js +108 -0
  211. package/dist/esm/locales/zh/csi16.d.ts +3 -0
  212. package/dist/esm/locales/zh/csi16.js +44 -0
  213. package/dist/esm/locales/zh/eat26.d.ts +3 -0
  214. package/dist/esm/locales/zh/eat26.js +43 -0
  215. package/dist/esm/locales/zh/gds15.d.ts +4 -0
  216. package/dist/esm/locales/zh/gds15.js +32 -0
  217. package/dist/esm/locales/zh/pc-ptsd-5.d.ts +4 -0
  218. package/dist/esm/locales/zh/pc-ptsd-5.js +30 -0
  219. package/dist/esm/locales/zh/pcl5.d.ts +4 -0
  220. package/dist/esm/locales/zh/pcl5.js +42 -0
  221. package/dist/esm/locales/zh/phq15.d.ts +4 -0
  222. package/dist/esm/locales/zh/phq15.js +33 -0
  223. package/dist/esm/locales/zh/phq4.d.ts +4 -0
  224. package/dist/esm/locales/zh/phq4.js +33 -0
  225. package/dist/esm/locales/zh/phq8.d.ts +4 -0
  226. package/dist/esm/locales/zh/phq8.js +29 -0
  227. package/dist/esm/locales/zh/tipi.d.ts +4 -0
  228. package/dist/esm/locales/zh/tipi.js +29 -0
  229. package/dist/esm/locales/zh/ucla-ls3.d.ts +4 -0
  230. package/dist/esm/locales/zh/ucla-ls3.js +32 -0
  231. package/dist/esm/types.d.ts +10 -2
  232. package/package.json +22 -3
  233. package/src/inventories/cbi.ts +131 -0
  234. package/src/inventories/csi16.ts +189 -0
  235. package/src/inventories/eat26.ts +118 -0
  236. package/src/inventories/gds15.ts +87 -0
  237. package/src/inventories/index.ts +36 -1
  238. package/src/inventories/pc-ptsd-5.ts +96 -0
  239. package/src/inventories/pcl5.ts +127 -0
  240. package/src/inventories/phq15.ts +77 -0
  241. package/src/inventories/phq4.ts +76 -0
  242. package/src/inventories/phq8.ts +73 -0
  243. package/src/inventories/tipi.ts +74 -0
  244. package/src/inventories/ucla-ls3.ts +131 -0
  245. package/src/locales/de/cbi.ts +111 -0
  246. package/src/locales/de/csi16.ts +66 -0
  247. package/src/locales/de/eat26.ts +52 -0
  248. package/src/locales/de/gds15.ts +35 -0
  249. package/src/locales/de/pc-ptsd-5.ts +35 -0
  250. package/src/locales/de/pcl5.ts +51 -0
  251. package/src/locales/de/phq15.ts +38 -0
  252. package/src/locales/de/phq4.ts +37 -0
  253. package/src/locales/de/phq8.ts +37 -0
  254. package/src/locales/de/tipi.ts +42 -0
  255. package/src/locales/de/ucla-ls3.ts +51 -0
  256. package/src/locales/es/cbi.ts +111 -0
  257. package/src/locales/es/csi16.ts +73 -0
  258. package/src/locales/es/eat26.ts +52 -0
  259. package/src/locales/es/gds15.ts +35 -0
  260. package/src/locales/es/pc-ptsd-5.ts +35 -0
  261. package/src/locales/es/pcl5.ts +51 -0
  262. package/src/locales/es/phq15.ts +37 -0
  263. package/src/locales/es/phq4.ts +37 -0
  264. package/src/locales/es/phq8.ts +38 -0
  265. package/src/locales/es/tipi.ts +42 -0
  266. package/src/locales/es/ucla-ls3.ts +47 -0
  267. package/src/locales/index.ts +66 -0
  268. package/src/locales/tr/cbi.ts +112 -0
  269. package/src/locales/tr/csi16.ts +73 -0
  270. package/src/locales/tr/eat26.ts +52 -0
  271. package/src/locales/tr/gds15.ts +35 -0
  272. package/src/locales/tr/pc-ptsd-5.ts +35 -0
  273. package/src/locales/tr/pcl5.ts +51 -0
  274. package/src/locales/tr/phq15.ts +37 -0
  275. package/src/locales/tr/phq4.ts +37 -0
  276. package/src/locales/tr/phq8.ts +35 -0
  277. package/src/locales/tr/tipi.ts +42 -0
  278. package/src/locales/tr/ucla-ls3.ts +46 -0
  279. package/src/locales/zh/cbi.ts +111 -0
  280. package/src/locales/zh/csi16.ts +51 -0
  281. package/src/locales/zh/eat26.ts +48 -0
  282. package/src/locales/zh/gds15.ts +35 -0
  283. package/src/locales/zh/pc-ptsd-5.ts +35 -0
  284. package/src/locales/zh/pcl5.ts +46 -0
  285. package/src/locales/zh/phq15.ts +36 -0
  286. package/src/locales/zh/phq4.ts +36 -0
  287. package/src/locales/zh/phq8.ts +32 -0
  288. package/src/locales/zh/tipi.ts +33 -0
  289. package/src/locales/zh/ucla-ls3.ts +36 -0
  290. package/src/types.ts +10 -1
@@ -0,0 +1,96 @@
1
+ import type { AssessmentDefinition, AssessmentOption } from "../types.ts";
2
+
3
+ /** The yes/no answer scale of the PC-PTSD-5. A "yes" scores 1. */
4
+ const yesNoOptions: AssessmentOption[] = [
5
+ { value: 1, label: { en: "Yes" } },
6
+ { value: 0, label: { en: "No" } },
7
+ ];
8
+
9
+ /** The VA form's lead-in to the five symptom items, prepended to each one. */
10
+ const leadIn = "In the past month, have you";
11
+
12
+ /**
13
+ * PC-PTSD-5: Primary Care PTSD Screen for DSM-5.
14
+ *
15
+ * A lifetime trauma-exposure question followed by five yes/no symptom
16
+ * items about the past month. The score is the count of "yes" answers to
17
+ * the five symptom items (0-5); the exposure question gates them and is
18
+ * not scored. Developed by staff at the VA's National Center for PTSD,
19
+ * public domain. No bands: the VA's cut-point of 4 is explicitly
20
+ * sample-dependent, see `meta.scoringNote`.
21
+ */
22
+ export const pcPtsd5: AssessmentDefinition = {
23
+ id: "pc-ptsd-5",
24
+ version: "1.0.0",
25
+ categories: ["post-traumatic-stress"],
26
+ audience: ["adult"],
27
+ respondent: "self",
28
+ title: {
29
+ en: "Primary Care PTSD Screen for DSM-5 (PC-PTSD-5)",
30
+ },
31
+ description: {
32
+ en: "A brief screen for probable posttraumatic stress disorder: one question about lifetime trauma exposure, then five yes/no questions about how the trauma has affected the person in the past month.",
33
+ },
34
+ instructions: {
35
+ en: "Sometimes things happen to people that are unusually or especially frightening, horrible, or traumatic. For example: a serious accident or fire; a physical or sexual assault or abuse; an earthquake or flood; a war; seeing someone be killed or seriously injured; having a loved one die through homicide or suicide.",
36
+ },
37
+ defaultLocale: "en",
38
+ options: yesNoOptions,
39
+ questions: [
40
+ {
41
+ id: "pc-ptsd-5-trauma",
42
+ text: {
43
+ en: "Have you ever experienced this kind of event? If no, screen total = 0. Please stop here. If yes, please answer the questions below.",
44
+ },
45
+ },
46
+ {
47
+ id: "pc-ptsd-5-1",
48
+ text: {
49
+ en: `${leadIn} had nightmares about the event(s) or thought about the event(s) when you did not want to?`,
50
+ },
51
+ optional: true,
52
+ },
53
+ {
54
+ id: "pc-ptsd-5-2",
55
+ text: {
56
+ en: `${leadIn} tried hard not to think about the event(s) or went out of your way to avoid situations that reminded you of the event(s)?`,
57
+ },
58
+ optional: true,
59
+ },
60
+ {
61
+ id: "pc-ptsd-5-3",
62
+ text: { en: `${leadIn} been constantly on guard, watchful, or easily startled?` },
63
+ optional: true,
64
+ },
65
+ {
66
+ id: "pc-ptsd-5-4",
67
+ text: { en: `${leadIn} felt numb or detached from people, activities, or your surroundings?` },
68
+ optional: true,
69
+ },
70
+ {
71
+ id: "pc-ptsd-5-5",
72
+ text: {
73
+ en: `${leadIn} felt guilty or unable to stop blaming yourself or others for the event(s) or any problems the event(s) may have caused?`,
74
+ },
75
+ optional: true,
76
+ },
77
+ ],
78
+ scoring: {
79
+ kind: "count",
80
+ missing: { strategy: "ignore" },
81
+ items: [1, 2, 3, 4, 5].map((n) => ({ questionId: `pc-ptsd-5-${n}`, minValue: 1 })),
82
+ },
83
+ meta: {
84
+ reference:
85
+ "Prins, A., Bovin, M. J., Kimerling, R., Kaloupek, D. G., Marx, B. P., Pless Kaiser, A., & Schnurr, P. P. (2015). The Primary Care PTSD Screen for DSM-5 (PC-PTSD-5) [Measurement instrument]. Available from https://www.ptsd.va.gov",
86
+ license: "Free: developed by staff at the VA's National Center for PTSD, in the public domain and not copyrighted",
87
+ licenseFlag: "free",
88
+ translationProvenance:
89
+ "en: transcribed from the VA's own PC-PTSD-5 form PDF (version date 2022), https://www.ptsd.va.gov/professional/assessment/screens/pc-ptsd.asp; the form's lead-in \"In the past month, have you...\" is prepended to each symptom item and the six bulleted examples are joined into one sentence (see SOURCES.md). Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-opus-5-5) from the original English; the VA's own Spanish version was not consulted and the texts are unverified. See SOURCES.md.",
90
+ timeframe: "exposure: lifetime; symptoms: past month",
91
+ scoringNote:
92
+ "Count of \"yes\" answers to the five symptom items, 0-5. The exposure question (pc-ptsd-5-trauma) is not scored; it gates the symptom items, which are marked optional so a respondent who answers \"no\" and stops is scored 0, as the VA specifies. psytools cannot enforce the gate: render the symptom items only after a \"yes\", and treat a response that answers them after a \"no\" as invalid. No bands are defined on purpose: the VA reports that \"a cut-point of 4 ideally balanced false negatives and false positives for the overall sample and for men\", that it produced many false negatives for women, and that \"clinicians should consider sample characteristics and screening purposes when selecting a cut-point.\" Apply your own cut-point over `score`.",
93
+ renderingNote:
94
+ "Show pc-ptsd-5-trauma first. Show pc-ptsd-5-1 to pc-ptsd-5-5 only when it is answered \"yes\" (value 1).",
95
+ },
96
+ };
@@ -0,0 +1,127 @@
1
+ import type { AssessmentDefinition, AssessmentOption } from "../types.ts";
2
+
3
+ /** The 0–4 bother scale of the PCL-5 ("in the past month"). */
4
+ const botherOptions: AssessmentOption[] = [
5
+ { value: 0, label: { en: "Not at all" } },
6
+ { value: 1, label: { en: "A little bit" } },
7
+ { value: 2, label: { en: "Moderately" } },
8
+ { value: 3, label: { en: "Quite a bit" } },
9
+ { value: 4, label: { en: "Extremely" } },
10
+ ];
11
+
12
+ /**
13
+ * PCL-5 — PTSD Checklist for DSM-5, standard (past month) form.
14
+ *
15
+ * 20 items, 0–4 scale, total 0–80. Developed by staff at the VA's
16
+ * National Center for PTSD and in the public domain. No bands are
17
+ * defined: the VA publishes a cutoff *range* (31–33) it calls initial
18
+ * research, not a settled threshold — see `meta.scoringNote`.
19
+ */
20
+ export const pcl5: AssessmentDefinition = {
21
+ id: "pcl5",
22
+ version: "1.0.0",
23
+ categories: ["post-traumatic-stress"],
24
+ audience: ["adult"],
25
+ respondent: "self",
26
+ title: {
27
+ en: "PTSD Checklist for DSM-5 (PCL-5)",
28
+ },
29
+ description: {
30
+ en: "A 20-item self-report measure of the DSM-5 symptoms of posttraumatic stress disorder over the past month.",
31
+ },
32
+ instructions: {
33
+ en: "Below is a list of problems that people sometimes have in response to a very stressful experience. Keeping your worst event in mind, please read each problem carefully and then select one of the numbers to the right to indicate how much you have been bothered by that problem in the past month.",
34
+ },
35
+ defaultLocale: "en",
36
+ options: botherOptions,
37
+ questions: [
38
+ {
39
+ id: "pcl5-1",
40
+ text: { en: "Repeated, disturbing, and unwanted memories of the stressful experience?" },
41
+ },
42
+ { id: "pcl5-2", text: { en: "Repeated, disturbing dreams of the stressful experience?" } },
43
+ {
44
+ id: "pcl5-3",
45
+ text: {
46
+ en: "Suddenly feeling or acting as if the stressful experience were actually happening again (as if you were actually back there reliving it)?",
47
+ },
48
+ },
49
+ {
50
+ id: "pcl5-4",
51
+ text: { en: "Feeling very upset when something reminded you of the stressful experience?" },
52
+ },
53
+ {
54
+ id: "pcl5-5",
55
+ text: {
56
+ en: "Having strong physical reactions when something reminded you of the stressful experience (for example, heart pounding, trouble breathing, sweating)?",
57
+ },
58
+ },
59
+ {
60
+ id: "pcl5-6",
61
+ text: { en: "Avoiding memories, thoughts, or feelings related to the stressful experience?" },
62
+ },
63
+ {
64
+ id: "pcl5-7",
65
+ text: {
66
+ en: "Avoiding external reminders of the stressful experience (for example, people, places, conversations, activities, objects, or situations)?",
67
+ },
68
+ },
69
+ {
70
+ id: "pcl5-8",
71
+ text: { en: "Trouble remembering important parts of the stressful experience?" },
72
+ },
73
+ {
74
+ id: "pcl5-9",
75
+ text: {
76
+ en: "Having strong negative beliefs about yourself, other people, or the world (for example, having thoughts such as: I am bad, there is something seriously wrong with me, no one can be trusted, the world is completely dangerous)?",
77
+ },
78
+ },
79
+ {
80
+ id: "pcl5-10",
81
+ text: {
82
+ en: "Blaming yourself or someone else for the stressful experience or what happened after it?",
83
+ },
84
+ },
85
+ {
86
+ id: "pcl5-11",
87
+ text: {
88
+ en: "Having strong negative feelings such as fear, horror, anger, guilt, or shame?",
89
+ },
90
+ },
91
+ { id: "pcl5-12", text: { en: "Loss of interest in activities that you used to enjoy?" } },
92
+ { id: "pcl5-13", text: { en: "Feeling distant or cut off from other people?" } },
93
+ {
94
+ id: "pcl5-14",
95
+ text: {
96
+ en: "Trouble experiencing positive feelings (for example, being unable to feel happiness or have loving feelings for people close to you)?",
97
+ },
98
+ },
99
+ {
100
+ id: "pcl5-15",
101
+ text: { en: "Irritable behavior, angry outbursts, or acting aggressively?" },
102
+ },
103
+ {
104
+ id: "pcl5-16",
105
+ text: { en: "Taking too many risks or doing things that could cause you harm?" },
106
+ },
107
+ { id: "pcl5-17", text: { en: "Being “superalert” or watchful or on guard?" } },
108
+ { id: "pcl5-18", text: { en: "Feeling jumpy or easily startled?" } },
109
+ { id: "pcl5-19", text: { en: "Having difficulty concentrating?" } },
110
+ { id: "pcl5-20", text: { en: "Trouble falling or staying asleep?" } },
111
+ ],
112
+ scoring: {
113
+ kind: "sum",
114
+ missing: { strategy: "prorate", minAnswered: 16 },
115
+ },
116
+ meta: {
117
+ reference:
118
+ "Weathers, F. W., Litz, B. T., Keane, T. M., Palmieri, P. A., Marx, B. P., & Schnurr, P. P. (2013). The PTSD Checklist for DSM-5 (PCL-5) - Standard [Measurement instrument]. National Center for PTSD. Available from https://www.ptsd.va.gov/",
119
+ license: "Free — developed by staff at the VA's National Center for PTSD, in the public domain and not copyrighted",
120
+ licenseFlag: "free",
121
+ translationProvenance:
122
+ "en: transcribed from the VA's own PCL-5 Standard form PDF (version date 29 August 2023), https://www.ptsd.va.gov/professional/assessment/adult-sr/ptsd-checklist.asp. Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-opus-5) from the original English; the VA's own Spanish version was not consulted and the texts are unverified. See SOURCES.md.",
123
+ timeframe: "past month",
124
+ scoringNote:
125
+ "Sum 0-80. No severity bands are defined on purpose: the VA states that \"initial research suggests that a PCL-5 cutoff score between 31-33 is indicative of probable PTSD across samples\" — a range offered as initial research, not a settled threshold, and one the VA asks users to weigh against their own setting. Encoding one number of that range as a band boundary would render a provisional finding to a user as a categorical verdict. Apply your own cutoff over `score` if your protocol names one. The VA's separate DSM-5 provisional-diagnosis rule (at least 1 item from cluster B, 1 from C, 2 from D and 2 from E, each rated 2 or higher) is not implemented; the clusters are B: items 1-5, C: items 6-7, D: items 8-14, E: items 15-20.",
126
+ },
127
+ };
@@ -0,0 +1,77 @@
1
+ import type { AssessmentDefinition, AssessmentOption } from "../types.ts";
2
+
3
+ /** The 0–2 bother scale of the PHQ-15 ("during the last 4 weeks"). */
4
+ const botherOptions: AssessmentOption[] = [
5
+ { value: 0, label: { en: "Not bothered at all" } },
6
+ { value: 1, label: { en: "Bothered a little" } },
7
+ { value: 2, label: { en: "Bothered a lot" } },
8
+ ];
9
+
10
+ /**
11
+ * PHQ-15 — Patient Health Questionnaire-15 (somatic symptom severity).
12
+ *
13
+ * 15 items, 0–2 bother scale, total 0–30, recall window 4 weeks. Same
14
+ * Pfizer grant as the bundled PHQ-9 and GAD-7: no permission required to
15
+ * reproduce, translate, display or distribute. Item 4 is printed
16
+ * "[women only]" on the instrument, so it is `optional`.
17
+ */
18
+ export const phq15: AssessmentDefinition = {
19
+ id: "phq15",
20
+ version: "1.0.0",
21
+ categories: ["somatic-symptoms"],
22
+ audience: ["adult"],
23
+ respondent: "self",
24
+ title: {
25
+ en: "Patient Health Questionnaire-15 (PHQ-15)",
26
+ },
27
+ description: {
28
+ en: "A 15-item self-report scale measuring the severity of common physical symptoms, used to screen for somatization and somatoform disorders.",
29
+ },
30
+ instructions: {
31
+ en: "During the last 4 weeks, how much have you been bothered by any of the following problems?",
32
+ },
33
+ defaultLocale: "en",
34
+ options: botherOptions,
35
+ questions: [
36
+ { id: "phq15-1", text: { en: "Stomach pain" } },
37
+ { id: "phq15-2", text: { en: "Back pain" } },
38
+ { id: "phq15-3", text: { en: "Pain in your arms, legs, or joints (knees, hips, etc)" } },
39
+ {
40
+ id: "phq15-4",
41
+ text: { en: "Menstrual cramps or other problems with your periods [women only]" },
42
+ optional: true,
43
+ },
44
+ { id: "phq15-5", text: { en: "Headaches" } },
45
+ { id: "phq15-6", text: { en: "Chest pain" } },
46
+ { id: "phq15-7", text: { en: "Dizziness" } },
47
+ { id: "phq15-8", text: { en: "Fainting spells" } },
48
+ { id: "phq15-9", text: { en: "Feeling your heart pound or race" } },
49
+ { id: "phq15-10", text: { en: "Shortness of breath" } },
50
+ { id: "phq15-11", text: { en: "Pain or problems during sexual intercourse" } },
51
+ { id: "phq15-12", text: { en: "Constipation, loose bowels, or diarrhea" } },
52
+ { id: "phq15-13", text: { en: "Nausea, gas, or indigestion" } },
53
+ { id: "phq15-14", text: { en: "Feeling tired or having low energy" } },
54
+ { id: "phq15-15", text: { en: "Trouble sleeping" } },
55
+ ],
56
+ scoring: {
57
+ kind: "sum",
58
+ missing: { strategy: "ignore" },
59
+ bands: [
60
+ { id: "minimal", min: 0, max: 4, label: { en: "Minimal somatic symptoms" } },
61
+ { id: "low", min: 5, max: 9, label: { en: "Low somatic symptom severity" } },
62
+ { id: "medium", min: 10, max: 14, label: { en: "Medium somatic symptom severity" } },
63
+ { id: "high", min: 15, max: 30, label: { en: "High somatic symptom severity" } },
64
+ ],
65
+ },
66
+ meta: {
67
+ reference:
68
+ "Kroenke, K., Spitzer, R. L., & Williams, J. B. W. (2002). The PHQ-15: Validity of a new measure for evaluating the severity of somatic symptoms. Psychosomatic Medicine, 64(2), 258-266.",
69
+ license: "Free — no permission required to reproduce, translate, display or distribute (Pfizer educational grant)",
70
+ licenseFlag: "free",
71
+ translationProvenance:
72
+ "en: transcribed from the Pfizer instrument (footer: \"Copyright Pfizer Inc. No permission required to reproduce, translate, display, or distribute.\"), source instrument https://www.phqscreeners.com. Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-opus-5) from the original English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
73
+ timeframe: "past 4 weeks",
74
+ scoringNote:
75
+ "Sum 0-30. Item 4 is printed \"[women only]\" on the instrument and is marked optional; unanswered items contribute 0. Two of the fifteen items are shared with the PHQ-9 — item 14 (tired) is PHQ-9 item 4 and item 15 (sleep) is PHQ-9 item 3 — but on the PHQ-15's 0-2 scale, not the PHQ-9's 0-3, so answers are not interchangeable between the two inventories.",
76
+ },
77
+ };
@@ -0,0 +1,76 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+ import { twoWeekFrequencyOptions } from "./common.ts";
3
+
4
+ /** Bands shared by both 2-item subscales: the manual's cutpoint of 3. */
5
+ const screenBands = (followUp: string) => [
6
+ { id: "below-cutoff", min: 0, max: 2, label: { en: "Below the screening cutpoint" } },
7
+ { id: "positive", min: 3, max: 6, label: { en: `Positive screen: follow up with ${followUp}` } },
8
+ ];
9
+
10
+ /**
11
+ * PHQ-4: Patient Health Questionnaire for Depression and Anxiety.
12
+ *
13
+ * 4 items on the 0-3 frequency scale: the GAD-2 (items 1-2) and the PHQ-2
14
+ * (items 3-4), in the order Pfizer's own PHQ-4 form prints them. Scored
15
+ * as three scales: anxiety (0-6), depression (0-6) and the total (0-12).
16
+ * The two subscales carry the PHQ manual's screening cutpoint of 3; the
17
+ * total carries no bands, see `meta.scoringNote`.
18
+ */
19
+ export const phq4: AssessmentDefinition = {
20
+ id: "phq4",
21
+ version: "1.0.0",
22
+ categories: ["depression", "anxiety"],
23
+ audience: ["adult"],
24
+ respondent: "self",
25
+ title: {
26
+ en: "Patient Health Questionnaire-4 (PHQ-4)",
27
+ },
28
+ description: {
29
+ en: "An ultra-brief 4-item screener for anxiety and depression, made of the 2-item GAD-2 and PHQ-2.",
30
+ },
31
+ instructions: {
32
+ en: "Over the last 2 weeks, how often have you been bothered by the following problems?",
33
+ },
34
+ defaultLocale: "en",
35
+ options: twoWeekFrequencyOptions,
36
+ questions: [
37
+ { id: "phq4-1", text: { en: "Feeling nervous, anxious or on edge" } },
38
+ { id: "phq4-2", text: { en: "Not being able to stop or control worrying" } },
39
+ { id: "phq4-3", text: { en: "Little interest or pleasure in doing things" } },
40
+ { id: "phq4-4", text: { en: "Feeling down, depressed, or hopeless" } },
41
+ ],
42
+ scoring: {
43
+ kind: "subscales",
44
+ missing: { strategy: "require-complete" },
45
+ subscales: [
46
+ {
47
+ id: "anxiety",
48
+ label: { en: "Anxiety (GAD-2)" },
49
+ questionIds: ["phq4-1", "phq4-2"],
50
+ bands: screenBands("the GAD-7 and a clinical interview"),
51
+ },
52
+ {
53
+ id: "depression",
54
+ label: { en: "Depression (PHQ-2)" },
55
+ questionIds: ["phq4-3", "phq4-4"],
56
+ bands: screenBands("the PHQ-9 and a clinical interview"),
57
+ },
58
+ {
59
+ id: "total",
60
+ label: { en: "Total (PHQ-4)" },
61
+ questionIds: ["phq4-1", "phq4-2", "phq4-3", "phq4-4"],
62
+ },
63
+ ],
64
+ },
65
+ meta: {
66
+ reference:
67
+ "Kroenke, K., Spitzer, R. L., Williams, J. B. W., & Löwe, B. (2009). An ultra-brief screening scale for anxiety and depression: The PHQ-4. Psychosomatics, 50(6), 613-621.",
68
+ license: "Free: no permission required to reproduce, translate, display or distribute (Pfizer educational grant)",
69
+ licenseFlag: "free",
70
+ translationProvenance:
71
+ "en: transcribed from Pfizer's own English PHQ-4 form (footer: \"No permission required to reproduce, translate, display or distribute\"), downloaded from https://www.phqscreeners.com/select-screener. Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-opus-5-5) from the original English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
72
+ timeframe: "past 2 weeks",
73
+ scoringNote:
74
+ "Three scales over the same four answers: anxiety = items 1-2 (GAD-2, 0-6), depression = items 3-4 (PHQ-2, 0-6), total = items 1-4 (0-12). The subscale bands split at 3, the PHQ manual's screening cutpoint for the PHQ-2 and GAD-2 (\"a score of 3 or greater should prompt administration of the full PHQ-9 and/or GAD-7, as well as a clinical interview\"). The total has no bands: total-score categories (0-2, 3-5, 6-8, 9-12) circulate widely and are attributed to Kroenke et al. (2009), but neither that paper nor the PHQ manual could be read to confirm them, so none are bundled. Apply them over the total's `score` if your protocol uses them.",
75
+ },
76
+ };
@@ -0,0 +1,73 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+ import { twoWeekFrequencyOptions, twoWeekInstructions } from "./common.ts";
3
+
4
+ /**
5
+ * PHQ-8: Patient Health Questionnaire-8 (depression severity).
6
+ *
7
+ * The PHQ-9 without item 9 (self-harm): 8 items on the 0-3 frequency
8
+ * scale, total 0-24. The PHQ manual states that the PHQ-8 "is scored just
9
+ * like the PHQ-9" and that its cutpoints "are identical to the PHQ-9", so
10
+ * the bands are the PHQ-9's, capped at 24. Same Pfizer grant as the
11
+ * bundled PHQ-9.
12
+ */
13
+ export const phq8: AssessmentDefinition = {
14
+ id: "phq8",
15
+ version: "1.0.0",
16
+ categories: ["depression"],
17
+ audience: ["adult"],
18
+ respondent: "self",
19
+ title: {
20
+ en: "Patient Health Questionnaire-8 (PHQ-8)",
21
+ },
22
+ description: {
23
+ en: "An 8-item self-report measure of depression severity: the PHQ-9 without its item on thoughts of self-harm.",
24
+ },
25
+ instructions: twoWeekInstructions,
26
+ defaultLocale: "en",
27
+ options: twoWeekFrequencyOptions,
28
+ questions: [
29
+ { id: "phq8-1", text: { en: "Little interest or pleasure in doing things" } },
30
+ { id: "phq8-2", text: { en: "Feeling down, depressed, or hopeless" } },
31
+ { id: "phq8-3", text: { en: "Trouble falling or staying asleep, or sleeping too much" } },
32
+ { id: "phq8-4", text: { en: "Feeling tired or having little energy" } },
33
+ { id: "phq8-5", text: { en: "Poor appetite or overeating" } },
34
+ {
35
+ id: "phq8-6",
36
+ text: {
37
+ en: "Feeling bad about yourself — or that you are a failure or have let yourself or your family down",
38
+ },
39
+ },
40
+ {
41
+ id: "phq8-7",
42
+ text: { en: "Trouble concentrating on things, such as reading the newspaper or watching television" },
43
+ },
44
+ {
45
+ id: "phq8-8",
46
+ text: {
47
+ en: "Moving or speaking so slowly that other people could have noticed? Or the opposite — being so fidgety or restless that you have been moving around a lot more than usual",
48
+ },
49
+ },
50
+ ],
51
+ scoring: {
52
+ kind: "sum",
53
+ missing: { strategy: "prorate", minAnswered: 6 },
54
+ bands: [
55
+ { id: "minimal", min: 0, max: 4, label: { en: "Minimal depression" } },
56
+ { id: "mild", min: 5, max: 9, label: { en: "Mild depression" } },
57
+ { id: "moderate", min: 10, max: 14, label: { en: "Moderate depression" } },
58
+ { id: "moderately-severe", min: 15, max: 19, label: { en: "Moderately severe depression" } },
59
+ { id: "severe", min: 20, max: 24, label: { en: "Severe depression" } },
60
+ ],
61
+ },
62
+ meta: {
63
+ reference:
64
+ "Kroenke, K., Strine, T. W., Spitzer, R. L., Williams, J. B. W., Berry, J. T., & Mokdad, A. H. (2009). The PHQ-8 as a measure of current depression in the general population. Journal of Affective Disorders, 114(1-3), 163-173.",
65
+ license: "Free: no permission required to reproduce, translate, display or distribute (Pfizer educational grant)",
66
+ licenseFlag: "free",
67
+ translationProvenance:
68
+ "en: transcribed from Pfizer's own PHQ-8 form, \"English for Canada\" (footer: \"No permission required to reproduce, translate, display or distribute\"), downloaded from https://www.phqscreeners.com/select-screener; the site offers no PHQ-8 form labelled plain English, and this one matches items 1-8 of Pfizer's English PHQ-9 form word for word. Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-opus-5-5) from the original English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
69
+ timeframe: "past 2 weeks",
70
+ scoringNote:
71
+ "Sum 0-24. Bands use the PHQ-9 cutpoints of 5, 10, 15 and 20, which the PHQ manual says apply to the PHQ-8 unchanged. A score of 10 or more, the start of the moderate band, is the manual's \"yellow flag\" for a possible clinically significant condition and the cut-point usually used for current depression. The PHQ-8 has no self-harm item, so unlike `phq9` it raises no suicidality flag; do not use it where self-harm needs to be screened.",
72
+ },
73
+ };
@@ -0,0 +1,74 @@
1
+ import type { AssessmentDefinition, AssessmentOption } from "../types.ts";
2
+
3
+ /** The fully labelled 1-7 agreement scale printed on the TIPI form. */
4
+ const tipiOptions: AssessmentOption[] = [
5
+ { value: 1, label: { en: "Disagree strongly" } },
6
+ { value: 2, label: { en: "Disagree moderately" } },
7
+ { value: 3, label: { en: "Disagree a little" } },
8
+ { value: 4, label: { en: "Neither agree nor disagree" } },
9
+ { value: 5, label: { en: "Agree a little" } },
10
+ { value: 6, label: { en: "Agree moderately" } },
11
+ { value: 7, label: { en: "Agree strongly" } },
12
+ ];
13
+
14
+ /**
15
+ * TIPI: Ten-Item Personality Inventory.
16
+ *
17
+ * 10 trait-pair items on a 1-7 agreement scale, five 2-item Big Five
18
+ * scales, each with one reverse-keyed item (items 2, 4, 6, 8, 10). Sums
19
+ * 2-14 per scale; the authors' published score is the mean of the two
20
+ * items. No cutoffs exist, so no bands.
21
+ */
22
+ export const tipi: AssessmentDefinition = {
23
+ id: "tipi",
24
+ version: "1.0.0",
25
+ categories: ["personality"],
26
+ audience: ["adult"],
27
+ respondent: "self",
28
+ title: {
29
+ en: "Ten-Item Personality Inventory (TIPI)",
30
+ },
31
+ description: {
32
+ en: "A 10-item measure of the Big Five personality dimensions, for settings where a very short measure is needed.",
33
+ },
34
+ instructions: {
35
+ en: "Here are a number of personality traits that may or may not apply to you. Please write a number next to each statement to indicate the extent to which you agree or disagree with that statement. You should rate the extent to which the pair of traits applies to you, even if one characteristic applies more strongly than the other. I see myself as:",
36
+ },
37
+ defaultLocale: "en",
38
+ options: tipiOptions,
39
+ questions: [
40
+ { id: "tipi-1", text: { en: "Extraverted, enthusiastic." } },
41
+ { id: "tipi-2", text: { en: "Critical, quarrelsome." }, reverseScored: true },
42
+ { id: "tipi-3", text: { en: "Dependable, self-disciplined." } },
43
+ { id: "tipi-4", text: { en: "Anxious, easily upset." }, reverseScored: true },
44
+ { id: "tipi-5", text: { en: "Open to new experiences, complex." } },
45
+ { id: "tipi-6", text: { en: "Reserved, quiet." }, reverseScored: true },
46
+ { id: "tipi-7", text: { en: "Sympathetic, warm." } },
47
+ { id: "tipi-8", text: { en: "Disorganized, careless." }, reverseScored: true },
48
+ { id: "tipi-9", text: { en: "Calm, emotionally stable." } },
49
+ { id: "tipi-10", text: { en: "Conventional, uncreative." }, reverseScored: true },
50
+ ],
51
+ scoring: {
52
+ kind: "subscales",
53
+ missing: { strategy: "require-complete" },
54
+ subscales: [
55
+ { id: "extraversion", label: { en: "Extraversion" }, questionIds: ["tipi-1", "tipi-6"] },
56
+ { id: "agreeableness", label: { en: "Agreeableness" }, questionIds: ["tipi-2", "tipi-7"] },
57
+ { id: "conscientiousness", label: { en: "Conscientiousness" }, questionIds: ["tipi-3", "tipi-8"] },
58
+ { id: "emotional-stability", label: { en: "Emotional Stability" }, questionIds: ["tipi-4", "tipi-9"] },
59
+ { id: "openness", label: { en: "Openness to Experiences" }, questionIds: ["tipi-5", "tipi-10"] },
60
+ ],
61
+ },
62
+ meta: {
63
+ reference:
64
+ "Gosling, S. D., Rentfrow, P. J., & Swann, W. B., Jr. (2003). A very brief measure of the Big-Five personality domains. Journal of Research in Personality, 37(6), 504-528.",
65
+ license:
66
+ "Free: \"Anyone can use it for any purpose. No need to ask me for permission.\" (S. D. Gosling, https://gosling.psy.utexas.edu/scales-weve-developed/ten-item-personality-measure-tipi/)",
67
+ licenseFlag: "free",
68
+ translationProvenance:
69
+ "en: transcribed from the authors' TIPI form PDF (dated 2003), linked as \"TIPI scale (pdf)\" from https://gosling.psy.utexas.edu/scales-weve-developed/ten-item-personality-measure-tipi/. Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-opus-5-5) from the original English; the translations hosted on the authors' page were not consulted and the texts are unverified. See SOURCES.md.",
70
+ timeframe: "general (no recall window)",
71
+ scoringNote:
72
+ "Five scales of two items each: extraversion 1, 6R; agreeableness 2R, 7; conscientiousness 3, 8R; emotional stability 4R, 9; openness to experiences 5, 10R. Reverse-keyed items are recoded 8 - answer. psytools reports sums (2-14); the authors' score is the mean of the two items, so divide by 2. No cutoffs exist; the authors publish norms instead. Emotional stability is the reverse pole of neuroticism. Two items per scale give low internal consistency by design; the authors point to test-retest reliability as the better index.",
73
+ },
74
+ };
@@ -0,0 +1,131 @@
1
+ import type { AssessmentDefinition, AssessmentOption } from "../types.ts";
2
+
3
+ /** The 1–4 frequency scale of the UCLA Loneliness Scale, Version 3. */
4
+ const frequencyOptions: AssessmentOption[] = [
5
+ { value: 1, label: { en: "Never" } },
6
+ { value: 2, label: { en: "Rarely" } },
7
+ { value: 3, label: { en: "Sometimes" } },
8
+ { value: 4, label: { en: "Always" } },
9
+ ];
10
+
11
+ /**
12
+ * UCLA Loneliness Scale, Version 3 (Russell, 1996).
13
+ *
14
+ * 20 items on a 1–4 frequency scale, total 20–80, higher is lonelier.
15
+ * Nine positively worded items (1, 5, 6, 9, 10, 15, 16, 19, 20) are
16
+ * reverse scored. Russell publishes no cutoffs — the scale is scored
17
+ * continuously — so no bands are defined.
18
+ */
19
+ export const uclaLs3: AssessmentDefinition = {
20
+ id: "ucla-ls3",
21
+ version: "1.0.0",
22
+ categories: ["loneliness"],
23
+ audience: ["adult"],
24
+ respondent: "self",
25
+ title: {
26
+ en: "UCLA Loneliness Scale (Version 3)",
27
+ },
28
+ description: {
29
+ en: "A 20-item self-report measure of subjective feelings of loneliness and social isolation.",
30
+ },
31
+ instructions: {
32
+ en: "The following statements describe how people sometimes feel. For each statement, please indicate how often you feel the way described. Here is an example: How often do you feel happy? If you never felt happy, you would respond “never”; if you always feel happy, you would respond “always”.",
33
+ },
34
+ defaultLocale: "en",
35
+ options: frequencyOptions,
36
+ questions: [
37
+ {
38
+ id: "ucla-ls3-1",
39
+ text: { en: "How often do you feel that you are “in tune” with the people around you?" },
40
+ reverseScored: true,
41
+ },
42
+ { id: "ucla-ls3-2", text: { en: "How often do you feel that you lack companionship?" } },
43
+ {
44
+ id: "ucla-ls3-3",
45
+ text: { en: "How often do you feel that there is no one you can turn to?" },
46
+ },
47
+ { id: "ucla-ls3-4", text: { en: "How often do you feel alone?" } },
48
+ {
49
+ id: "ucla-ls3-5",
50
+ text: { en: "How often do you feel part of a group of friends?" },
51
+ reverseScored: true,
52
+ },
53
+ {
54
+ id: "ucla-ls3-6",
55
+ text: {
56
+ en: "How often do you feel that you have a lot in common with the people around you?",
57
+ },
58
+ reverseScored: true,
59
+ },
60
+ {
61
+ id: "ucla-ls3-7",
62
+ text: { en: "How often do you feel that you are no longer close to anyone?" },
63
+ },
64
+ {
65
+ id: "ucla-ls3-8",
66
+ text: {
67
+ en: "How often do you feel that your interests and ideas are not shared by those around you?",
68
+ },
69
+ },
70
+ {
71
+ id: "ucla-ls3-9",
72
+ text: { en: "How often do you feel outgoing and friendly?" },
73
+ reverseScored: true,
74
+ },
75
+ {
76
+ id: "ucla-ls3-10",
77
+ text: { en: "How often do you feel close to people?" },
78
+ reverseScored: true,
79
+ },
80
+ { id: "ucla-ls3-11", text: { en: "How often do you feel left out?" } },
81
+ {
82
+ id: "ucla-ls3-12",
83
+ text: { en: "How often do you feel that your relationships with others are not meaningful?" },
84
+ },
85
+ {
86
+ id: "ucla-ls3-13",
87
+ text: { en: "How often do you feel that no one really knows you well?" },
88
+ },
89
+ { id: "ucla-ls3-14", text: { en: "How often do you feel isolated from others?" } },
90
+ {
91
+ id: "ucla-ls3-15",
92
+ text: { en: "How often do you feel that you can find companionship when you want it?" },
93
+ reverseScored: true,
94
+ },
95
+ {
96
+ id: "ucla-ls3-16",
97
+ text: { en: "How often do you feel that there are people who really understand you?" },
98
+ reverseScored: true,
99
+ },
100
+ { id: "ucla-ls3-17", text: { en: "How often do you feel shy?" } },
101
+ {
102
+ id: "ucla-ls3-18",
103
+ text: { en: "How often do you feel that people are around you but not with you?" },
104
+ },
105
+ {
106
+ id: "ucla-ls3-19",
107
+ text: { en: "How often do you feel that there are people you can talk to?" },
108
+ reverseScored: true,
109
+ },
110
+ {
111
+ id: "ucla-ls3-20",
112
+ text: { en: "How often do you feel that there are people you can turn to?" },
113
+ reverseScored: true,
114
+ },
115
+ ],
116
+ scoring: {
117
+ kind: "sum",
118
+ missing: { strategy: "prorate", minAnswered: 16 },
119
+ },
120
+ meta: {
121
+ reference:
122
+ "Russell, D. W. (1996). UCLA Loneliness Scale (Version 3): Reliability, validity, and factor structure. Journal of Personality Assessment, 66(1), 20-40.",
123
+ license:
124
+ "Free with conditions — the author has publicly disclaimed any requirement to seek his permission, but no formal licence exists and commercial redistribution has not been addressed by anyone",
125
+ licenseFlag: "free-with-conditions",
126
+ translationProvenance:
127
+ "en: transcribed from two independent reproductions of Russell (1996), checked against each other — the Stanford SPARQ Measuring Mobility toolkit copy (https://sparqtools.org/mobility-measure/ucla-loneliness-scale-version-3/) and the Fetzer Institute self-measures compendium. The rights holder distributes no copy of his own and the 1996 article is paywalled, so no first-party source was available. Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-opus-5) from the English above; published adaptations were not consulted and the texts are unverified. See SOURCES.md.",
128
+ scoringNote:
129
+ "Sum 20-80, higher is lonelier, with the nine positively worded items (1, 5, 6, 9, 10, 15, 16, 19, 20) reverse scored. No bands are defined: Russell publishes no cutoffs and the scale is scored continuously. Severity bandings for this scale circulate widely on the web; none of them traces to Russell, so none is bundled. The two reproductions used differ on the top anchor — one prints \"Often\", the other \"Always\" — and psytools follows \"Always\", which is the anchor Russell's own instruction example uses (\"if you always feel happy, you would respond 'always'\"). \"Often\" belongs to the earlier Revised UCLA Loneliness Scale.",
130
+ },
131
+ };