psytools 0.5.2 → 0.5.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.
Files changed (244) hide show
  1. package/README.md +22 -11
  2. package/SOURCES.md +80 -6
  3. package/dist/cjs/index.d.ts +2 -2
  4. package/dist/cjs/index.js +10 -1
  5. package/dist/cjs/inventories/aq10.js +1 -0
  6. package/dist/cjs/inventories/asrs6.js +1 -0
  7. package/dist/cjs/inventories/audit.js +1 -0
  8. package/dist/cjs/inventories/cesd.d.ts +11 -0
  9. package/dist/cjs/inventories/cesd.js +205 -0
  10. package/dist/cjs/inventories/common.d.ts +11 -0
  11. package/dist/cjs/inventories/common.js +26 -1
  12. package/dist/cjs/inventories/dass21.js +1 -0
  13. package/dist/cjs/inventories/ecr-r.d.ts +16 -0
  14. package/dist/cjs/inventories/ecr-r.js +112 -0
  15. package/dist/cjs/inventories/erq.d.ts +16 -0
  16. package/dist/cjs/inventories/erq.js +77 -0
  17. package/dist/cjs/inventories/flourishing.d.ts +12 -0
  18. package/dist/cjs/inventories/flourishing.js +51 -0
  19. package/dist/cjs/inventories/gad7.js +1 -0
  20. package/dist/cjs/inventories/hsps.d.ts +14 -0
  21. package/dist/cjs/inventories/hsps.js +81 -0
  22. package/dist/cjs/inventories/index.d.ts +11 -2
  23. package/dist/cjs/inventories/index.js +28 -1
  24. package/dist/cjs/inventories/k10.d.ts +12 -0
  25. package/dist/cjs/inventories/k10.js +60 -0
  26. package/dist/cjs/inventories/k6.d.ts +12 -0
  27. package/dist/cjs/inventories/k6.js +55 -0
  28. package/dist/cjs/inventories/mini-ipip.js +1 -0
  29. package/dist/cjs/inventories/phq9.js +1 -0
  30. package/dist/cjs/inventories/rses.d.ts +11 -0
  31. package/dist/cjs/inventories/rses.js +61 -0
  32. package/dist/cjs/inventories/swls.d.ts +12 -0
  33. package/dist/cjs/inventories/swls.js +57 -0
  34. package/dist/cjs/inventories/who5.js +1 -0
  35. package/dist/cjs/locales/de/cesd.d.ts +4 -0
  36. package/dist/cjs/locales/de/cesd.js +43 -0
  37. package/dist/cjs/locales/de/erq.d.ts +4 -0
  38. package/dist/cjs/locales/de/erq.js +36 -0
  39. package/dist/cjs/locales/de/flourishing.d.ts +4 -0
  40. package/dist/cjs/locales/de/flourishing.js +30 -0
  41. package/dist/cjs/locales/de/k10.d.ts +4 -0
  42. package/dist/cjs/locales/de/k10.js +36 -0
  43. package/dist/cjs/locales/de/k6.d.ts +4 -0
  44. package/dist/cjs/locales/de/k6.js +31 -0
  45. package/dist/cjs/locales/de/rses.d.ts +4 -0
  46. package/dist/cjs/locales/de/rses.js +34 -0
  47. package/dist/cjs/locales/de/swls.d.ts +4 -0
  48. package/dist/cjs/locales/de/swls.js +36 -0
  49. package/dist/cjs/locales/es/cesd.d.ts +4 -0
  50. package/dist/cjs/locales/es/cesd.js +43 -0
  51. package/dist/cjs/locales/es/erq.d.ts +4 -0
  52. package/dist/cjs/locales/es/erq.js +36 -0
  53. package/dist/cjs/locales/es/flourishing.d.ts +4 -0
  54. package/dist/cjs/locales/es/flourishing.js +46 -0
  55. package/dist/cjs/locales/es/k10.d.ts +4 -0
  56. package/dist/cjs/locales/es/k10.js +56 -0
  57. package/dist/cjs/locales/es/k6.d.ts +4 -0
  58. package/dist/cjs/locales/es/k6.js +43 -0
  59. package/dist/cjs/locales/es/rses.d.ts +4 -0
  60. package/dist/cjs/locales/es/rses.js +54 -0
  61. package/dist/cjs/locales/es/swls.d.ts +4 -0
  62. package/dist/cjs/locales/es/swls.js +46 -0
  63. package/dist/cjs/locales/index.js +51 -0
  64. package/dist/cjs/locales/tr/cesd.d.ts +4 -0
  65. package/dist/cjs/locales/tr/cesd.js +43 -0
  66. package/dist/cjs/locales/tr/ecr-r.d.ts +12 -0
  67. package/dist/cjs/locales/tr/ecr-r.js +70 -0
  68. package/dist/cjs/locales/tr/erq.d.ts +10 -0
  69. package/dist/cjs/locales/tr/erq.js +42 -0
  70. package/dist/cjs/locales/tr/flourishing.d.ts +4 -0
  71. package/dist/cjs/locales/tr/flourishing.js +46 -0
  72. package/dist/cjs/locales/tr/hsps.d.ts +10 -0
  73. package/dist/cjs/locales/tr/hsps.js +55 -0
  74. package/dist/cjs/locales/tr/k10.d.ts +4 -0
  75. package/dist/cjs/locales/tr/k10.js +56 -0
  76. package/dist/cjs/locales/tr/k6.d.ts +4 -0
  77. package/dist/cjs/locales/tr/k6.js +43 -0
  78. package/dist/cjs/locales/tr/rses.d.ts +4 -0
  79. package/dist/cjs/locales/tr/rses.js +54 -0
  80. package/dist/cjs/locales/tr/swls.d.ts +4 -0
  81. package/dist/cjs/locales/tr/swls.js +46 -0
  82. package/dist/cjs/locales/zh/cesd.d.ts +4 -0
  83. package/dist/cjs/locales/zh/cesd.js +43 -0
  84. package/dist/cjs/locales/zh/erq.d.ts +4 -0
  85. package/dist/cjs/locales/zh/erq.js +36 -0
  86. package/dist/cjs/locales/zh/flourishing.d.ts +4 -0
  87. package/dist/cjs/locales/zh/flourishing.js +46 -0
  88. package/dist/cjs/locales/zh/k10.d.ts +4 -0
  89. package/dist/cjs/locales/zh/k10.js +56 -0
  90. package/dist/cjs/locales/zh/k6.d.ts +4 -0
  91. package/dist/cjs/locales/zh/k6.js +43 -0
  92. package/dist/cjs/locales/zh/rses.d.ts +4 -0
  93. package/dist/cjs/locales/zh/rses.js +54 -0
  94. package/dist/cjs/locales/zh/swls.d.ts +4 -0
  95. package/dist/cjs/locales/zh/swls.js +46 -0
  96. package/dist/cjs/types.d.ts +12 -0
  97. package/dist/esm/index.d.ts +2 -2
  98. package/dist/esm/index.js +1 -1
  99. package/dist/esm/inventories/aq10.js +1 -0
  100. package/dist/esm/inventories/asrs6.js +1 -0
  101. package/dist/esm/inventories/audit.js +1 -0
  102. package/dist/esm/inventories/cesd.d.ts +11 -0
  103. package/dist/esm/inventories/cesd.js +202 -0
  104. package/dist/esm/inventories/common.d.ts +11 -0
  105. package/dist/esm/inventories/common.js +25 -0
  106. package/dist/esm/inventories/dass21.js +1 -0
  107. package/dist/esm/inventories/ecr-r.d.ts +16 -0
  108. package/dist/esm/inventories/ecr-r.js +109 -0
  109. package/dist/esm/inventories/erq.d.ts +16 -0
  110. package/dist/esm/inventories/erq.js +74 -0
  111. package/dist/esm/inventories/flourishing.d.ts +12 -0
  112. package/dist/esm/inventories/flourishing.js +48 -0
  113. package/dist/esm/inventories/gad7.js +1 -0
  114. package/dist/esm/inventories/hsps.d.ts +14 -0
  115. package/dist/esm/inventories/hsps.js +78 -0
  116. package/dist/esm/inventories/index.d.ts +11 -2
  117. package/dist/esm/inventories/index.js +19 -1
  118. package/dist/esm/inventories/k10.d.ts +12 -0
  119. package/dist/esm/inventories/k10.js +57 -0
  120. package/dist/esm/inventories/k6.d.ts +12 -0
  121. package/dist/esm/inventories/k6.js +52 -0
  122. package/dist/esm/inventories/mini-ipip.js +1 -0
  123. package/dist/esm/inventories/phq9.js +1 -0
  124. package/dist/esm/inventories/rses.d.ts +11 -0
  125. package/dist/esm/inventories/rses.js +58 -0
  126. package/dist/esm/inventories/swls.d.ts +12 -0
  127. package/dist/esm/inventories/swls.js +54 -0
  128. package/dist/esm/inventories/who5.js +1 -0
  129. package/dist/esm/locales/de/cesd.d.ts +4 -0
  130. package/dist/esm/locales/de/cesd.js +41 -0
  131. package/dist/esm/locales/de/erq.d.ts +4 -0
  132. package/dist/esm/locales/de/erq.js +34 -0
  133. package/dist/esm/locales/de/flourishing.d.ts +4 -0
  134. package/dist/esm/locales/de/flourishing.js +28 -0
  135. package/dist/esm/locales/de/k10.d.ts +4 -0
  136. package/dist/esm/locales/de/k10.js +34 -0
  137. package/dist/esm/locales/de/k6.d.ts +4 -0
  138. package/dist/esm/locales/de/k6.js +29 -0
  139. package/dist/esm/locales/de/rses.d.ts +4 -0
  140. package/dist/esm/locales/de/rses.js +32 -0
  141. package/dist/esm/locales/de/swls.d.ts +4 -0
  142. package/dist/esm/locales/de/swls.js +34 -0
  143. package/dist/esm/locales/es/cesd.d.ts +4 -0
  144. package/dist/esm/locales/es/cesd.js +41 -0
  145. package/dist/esm/locales/es/erq.d.ts +4 -0
  146. package/dist/esm/locales/es/erq.js +34 -0
  147. package/dist/esm/locales/es/flourishing.d.ts +4 -0
  148. package/dist/esm/locales/es/flourishing.js +44 -0
  149. package/dist/esm/locales/es/k10.d.ts +4 -0
  150. package/dist/esm/locales/es/k10.js +54 -0
  151. package/dist/esm/locales/es/k6.d.ts +4 -0
  152. package/dist/esm/locales/es/k6.js +41 -0
  153. package/dist/esm/locales/es/rses.d.ts +4 -0
  154. package/dist/esm/locales/es/rses.js +52 -0
  155. package/dist/esm/locales/es/swls.d.ts +4 -0
  156. package/dist/esm/locales/es/swls.js +44 -0
  157. package/dist/esm/locales/index.js +51 -0
  158. package/dist/esm/locales/tr/cesd.d.ts +4 -0
  159. package/dist/esm/locales/tr/cesd.js +41 -0
  160. package/dist/esm/locales/tr/ecr-r.d.ts +12 -0
  161. package/dist/esm/locales/tr/ecr-r.js +68 -0
  162. package/dist/esm/locales/tr/erq.d.ts +10 -0
  163. package/dist/esm/locales/tr/erq.js +40 -0
  164. package/dist/esm/locales/tr/flourishing.d.ts +4 -0
  165. package/dist/esm/locales/tr/flourishing.js +44 -0
  166. package/dist/esm/locales/tr/hsps.d.ts +10 -0
  167. package/dist/esm/locales/tr/hsps.js +53 -0
  168. package/dist/esm/locales/tr/k10.d.ts +4 -0
  169. package/dist/esm/locales/tr/k10.js +54 -0
  170. package/dist/esm/locales/tr/k6.d.ts +4 -0
  171. package/dist/esm/locales/tr/k6.js +41 -0
  172. package/dist/esm/locales/tr/rses.d.ts +4 -0
  173. package/dist/esm/locales/tr/rses.js +52 -0
  174. package/dist/esm/locales/tr/swls.d.ts +4 -0
  175. package/dist/esm/locales/tr/swls.js +44 -0
  176. package/dist/esm/locales/zh/cesd.d.ts +4 -0
  177. package/dist/esm/locales/zh/cesd.js +41 -0
  178. package/dist/esm/locales/zh/erq.d.ts +4 -0
  179. package/dist/esm/locales/zh/erq.js +34 -0
  180. package/dist/esm/locales/zh/flourishing.d.ts +4 -0
  181. package/dist/esm/locales/zh/flourishing.js +44 -0
  182. package/dist/esm/locales/zh/k10.d.ts +4 -0
  183. package/dist/esm/locales/zh/k10.js +54 -0
  184. package/dist/esm/locales/zh/k6.d.ts +4 -0
  185. package/dist/esm/locales/zh/k6.js +41 -0
  186. package/dist/esm/locales/zh/rses.d.ts +4 -0
  187. package/dist/esm/locales/zh/rses.js +52 -0
  188. package/dist/esm/locales/zh/swls.d.ts +4 -0
  189. package/dist/esm/locales/zh/swls.js +44 -0
  190. package/dist/esm/types.d.ts +12 -0
  191. package/package.json +18 -2
  192. package/schema/assessment-definition.schema.json +5 -0
  193. package/src/index.ts +10 -0
  194. package/src/inventories/aq10.ts +1 -0
  195. package/src/inventories/asrs6.ts +1 -0
  196. package/src/inventories/audit.ts +1 -0
  197. package/src/inventories/cesd.ts +208 -0
  198. package/src/inventories/common.ts +27 -0
  199. package/src/inventories/dass21.ts +1 -0
  200. package/src/inventories/ecr-r.ts +117 -0
  201. package/src/inventories/erq.ts +81 -0
  202. package/src/inventories/flourishing.ts +54 -0
  203. package/src/inventories/gad7.ts +1 -0
  204. package/src/inventories/hsps.ts +86 -0
  205. package/src/inventories/index.ts +29 -2
  206. package/src/inventories/k10.ts +62 -0
  207. package/src/inventories/k6.ts +57 -0
  208. package/src/inventories/mini-ipip.ts +1 -0
  209. package/src/inventories/phq9.ts +1 -0
  210. package/src/inventories/rses.ts +64 -0
  211. package/src/inventories/swls.ts +60 -0
  212. package/src/inventories/who5.ts +1 -0
  213. package/src/locales/de/cesd.ts +44 -0
  214. package/src/locales/de/erq.ts +37 -0
  215. package/src/locales/de/flourishing.ts +31 -0
  216. package/src/locales/de/k10.ts +37 -0
  217. package/src/locales/de/k6.ts +32 -0
  218. package/src/locales/de/rses.ts +35 -0
  219. package/src/locales/de/swls.ts +37 -0
  220. package/src/locales/es/cesd.ts +44 -0
  221. package/src/locales/es/erq.ts +37 -0
  222. package/src/locales/es/flourishing.ts +47 -0
  223. package/src/locales/es/k10.ts +57 -0
  224. package/src/locales/es/k6.ts +44 -0
  225. package/src/locales/es/rses.ts +55 -0
  226. package/src/locales/es/swls.ts +47 -0
  227. package/src/locales/index.ts +51 -0
  228. package/src/locales/tr/cesd.ts +44 -0
  229. package/src/locales/tr/ecr-r.ts +71 -0
  230. package/src/locales/tr/erq.ts +43 -0
  231. package/src/locales/tr/flourishing.ts +47 -0
  232. package/src/locales/tr/hsps.ts +56 -0
  233. package/src/locales/tr/k10.ts +57 -0
  234. package/src/locales/tr/k6.ts +44 -0
  235. package/src/locales/tr/rses.ts +55 -0
  236. package/src/locales/tr/swls.ts +47 -0
  237. package/src/locales/zh/cesd.ts +44 -0
  238. package/src/locales/zh/erq.ts +37 -0
  239. package/src/locales/zh/flourishing.ts +47 -0
  240. package/src/locales/zh/k10.ts +57 -0
  241. package/src/locales/zh/k6.ts +44 -0
  242. package/src/locales/zh/rses.ts +55 -0
  243. package/src/locales/zh/swls.ts +47 -0
  244. package/src/types.ts +27 -0
package/README.md CHANGED
@@ -19,7 +19,7 @@ That's a complete depression screening: standardized items, answer validation, p
19
19
 
20
20
  ## Why psytools
21
21
 
22
- - **Batteries included** — eight instruments (PHQ-9, GAD-7, DASS-21, WHO-5, ASRS, AQ-10, AUDIT, Mini-IPIP) ship ready to use in English, Turkish, German, Chinese, and Spanish, with published scoring rules and citations.
22
+ - **Batteries included** — seventeen instruments (PHQ-9, GAD-7, DASS-21, WHO-5, ASRS, AQ-10, AUDIT, Mini-IPIP, CES-D, ECR-R, ERQ, HSPS, SWLS, Flourishing, K10, K6, RSES) ship ready to use in up to five languages (English, Turkish, German, Chinese, Spanish — see the table below), with published scoring rules, citations, and categories for filtering.
23
23
  - **Your tests too** — therapists and researchers can define their own instruments as one plain JSON object; psytools validates, localizes, and scores them the same way.
24
24
  - **Everything is plain JSON** — assessments and responses `stringify()`/`parse()` losslessly, so definitions live in your database and travel between backend and frontend. Scoring rules are data, not code, and survive the round trip.
25
25
  - **Safe by default** — every answer is validated against the option scale, incomplete responses can't be scored accidentally, and submitted responses are immutable.
@@ -81,16 +81,27 @@ const response = AssessmentResponse.parse(assessment, rowFromDb); // answers re-
81
81
 
82
82
  ## Predefined inventories
83
83
 
84
- | Id | Instrument | Items | Scoring | Locales |
85
- | --- | --- | --- | --- | --- |
86
- | `phq9` | Patient Health Questionnaire-9 (depression) | 9 | Sum 0–27, 5 severity bands, item-9 suicidality flag | en, tr, de, zh, es |
87
- | `gad7` | Generalized Anxiety Disorder-7 | 7 | Sum 0–21, 4 severity bands | en, tr, de, zh, es |
88
- | `dass21` | Depression Anxiety Stress Scales (short form) | 21 | 3 subscales × 7 items, sums doubled, banded per subscale | en, tr, de, zh, es |
89
- | `who5` | WHO-5 Well-Being Index | 5 | Sum × 4 → 0–100 (higher is better), 3 well-being bands | en, tr, de, zh, es |
90
- | `asrs6` | Adult ADHD Self-Report Scale (ASRS-v1.1) screener | 6 | Count of screen-positive items (per-item thresholds), ≥4 positive | en, tr, de, zh, es |
91
- | `aq10` | Autism Spectrum Quotient (AQ-10, adult) | 10 | 1 point per item in trait direction (agree/disagree), ≥6 refer | en, tr, de, zh, es |
92
- | `audit` | Alcohol Use Disorders Identification Test (WHO) | 10 | Sum 0–40 with per-question point systems, 4 WHO risk zones | en, tr, de, zh, es |
93
- | `mini-ipip` | Mini-IPIP Big Five personality scale | 20 | 5 trait subscales (4–20 each), reverse-keyed items, no cutoffs | en, tr, de, zh, es |
84
+ | Id | Instrument | Category | Items | Scoring | Locales |
85
+ | --- | --- | --- | --- | --- | --- |
86
+ | `phq9` | Patient Health Questionnaire-9 (depression) | depression | 9 | Sum 0–27, 5 severity bands, item-9 suicidality flag | en, tr, de, zh, es |
87
+ | `gad7` | Generalized Anxiety Disorder-7 | anxiety | 7 | Sum 0–21, 4 severity bands | en, tr, de, zh, es |
88
+ | `dass21` | Depression Anxiety Stress Scales (short form) | depression, anxiety, stress | 21 | 3 subscales × 7 items, sums doubled, banded per subscale | en, tr, de, zh, es |
89
+ | `who5` | WHO-5 Well-Being Index | well-being | 5 | Sum × 4 → 0–100 (higher is better), 3 well-being bands | en, tr, de, zh, es |
90
+ | `asrs6` | Adult ADHD Self-Report Scale (ASRS-v1.1) screener | adhd | 6 | Count of screen-positive items (per-item thresholds), ≥4 positive | en, tr, de, zh, es |
91
+ | `aq10` | Autism Spectrum Quotient (AQ-10, adult) | autism | 10 | 1 point per item in trait direction (agree/disagree), ≥6 refer | en, tr, de, zh, es |
92
+ | `audit` | Alcohol Use Disorders Identification Test (WHO) | substance-use | 10 | Sum 0–40 with per-question point systems, 4 WHO risk zones | en, tr, de, zh, es |
93
+ | `mini-ipip` | Mini-IPIP Big Five personality scale | personality | 20 | 5 trait subscales (4–20 each), reverse-keyed items, no cutoffs | en, tr, de, zh, es |
94
+ | `cesd` | Center for Epidemiologic Studies Depression Scale (CES-D) | depression | 20 | Sum 0–60, 4 reverse-keyed items, elevated at ≥16 | en, tr, de, zh, es |
95
+ | `ecr-r` | Experiences in Close Relationships-Revised (adult attachment) | attachment, relationships | 36 | 2 subscales × 18 items (anxiety, avoidance), 14 reverse-keyed, no cutoffs | en, tr¹ |
96
+ | `erq` | Emotion Regulation Questionnaire | emotion-regulation | 10 | 2 subscales (reappraisal 6, suppression 4), no reversals, no cutoffs | en, tr, de, zh, es |
97
+ | `hsps` | Highly Sensitive Person Scale | sensory-processing, personality | 27 | Sum 27–189, no reversals, no cutoffs | en, tr¹ |
98
+ | `swls` | Satisfaction with Life Scale | well-being | 5 | Sum 5–35, Diener's 7 score groupings | en, tr, de, zh, es |
99
+ | `flourishing` | Flourishing Scale | well-being | 8 | Sum 8–56, no cutoffs | en, tr, de, zh, es |
100
+ | `k10` | Kessler Psychological Distress Scale (K10) | distress | 10 | Sum 10–50 (1–5 coding), 4 severity bands | en, tr, de, zh, es |
101
+ | `k6` | Kessler Psychological Distress Scale (K6) | distress | 6 | Sum 0–24 (0–4 coding), ≥13 serious distress | en, tr, de, zh, es |
102
+ | `rses` | Rosenberg Self-Esteem Scale | self-esteem | 10 | Sum 0–30, 5 reverse-keyed items, 15–25 normal range | en, tr, de, zh, es |
103
+
104
+ ¹ The `ecr-r` and `hsps` Turkish packs reproduce **published, validated Turkish adaptations** (Sümer and colleagues — see [SOURCES.md](SOURCES.md)); other locales can follow once verified sources are available. `ecr-r`, `erq`, and `hsps` are licensed for **non-commercial research use only** — check [SOURCES.md](SOURCES.md) before shipping them in a product. Each definition also carries `categories` for filtering (e.g. `inventories` entries with `categories.includes("depression")`).
94
105
 
95
106
  ```ts
96
107
  import { loadInventory, inventories, dass21 } from "psytools";
package/SOURCES.md CHANGED
@@ -10,19 +10,21 @@ psytools is integrated into real products, so this file states precisely — per
10
10
  | --- | --- |
11
11
  | **Free** | Public domain or explicitly free for any use, including commercial products, without permission. |
12
12
  | **Free with conditions** | Free for clinical and research use as distributed; embedding in commercial products is not explicitly licensed — verify with the rights holder before shipping. |
13
- | **Research only** | Usable in research contexts only. *(No bundled instrument currently carries this flag, and none will be added without it being stated here.)* |
13
+ | **Research only** | Usable in non-commercial research contexts only; not licensed for clinical products, diagnosis, or personnel selection. Carried by the ECR-R, ERQ, and HSPS — see their sections. |
14
14
 
15
15
  ## Translation provenance — read this before clinical use
16
16
 
17
- The same provenance applies to every bundled inventory. If an inventory ever deviates (e.g. an official translation is adopted and verified), it will be stated in its section below.
17
+ The same provenance applies to every bundled inventory **except where an inventory's section below states otherwise**. Two inventories deviate: the ECR-R and HSPS Turkish packs reproduce published, validated Turkish adaptations (see their sections) instead of AI translations.
18
18
 
19
19
  | Language | Text source | Verified against an official version |
20
20
  | --- | --- | --- |
21
21
  | en | Reproduced from the original published instrument | Yes |
22
- | tr | AI translation (Anthropic Claude, `claude-fable-5`) from the original English | No |
23
- | de | AI translation (Anthropic Claude, `claude-fable-5`) from the original English | No |
24
- | zh | AI translation (Anthropic Claude, `claude-fable-5`) from the original English | No |
25
- | es | AI translation (Anthropic Claude, `claude-fable-5`) from the original English | No |
22
+ | tr | AI translation (Anthropic Claude) from the original English | No |
23
+ | de | AI translation (Anthropic Claude) from the original English | No |
24
+ | zh | AI translation (Anthropic Claude) from the original English | No |
25
+ | es | AI translation (Anthropic Claude) from the original English | No |
26
+
27
+ The exact translating model is stated per inventory in `meta.translationProvenance` (`claude-fable-5` for the original batch, `claude-sonnet-5` for later additions).
26
28
 
27
29
  Official validated translations exist for most of these instruments, but they were **not consulted** in preparing the bundled texts, so they are deliberately not cited as sources. The packaged non-English wording has not been checked against them and has not been psychometrically validated. Validated instruments are only validated for their exact wording — before clinical or research use, obtain the official version for your language and compare or replace the text.
28
30
 
@@ -42,6 +44,12 @@ Bundled inventories ship with declarative missing-data policies (`scoring.missin
42
44
  | `mini-ipip` | prorate, ≥3 of 4 per trait | IPIP scoring is mean-based; prorating is equivalent |
43
45
  | `who5`, `asrs6`, `aq10` | require-complete | Short instruments; cutoffs/counts are undefined for partial data |
44
46
  | `audit` | ignore | Unanswered items score 0, matching the instrument's skip logic (e.g. non-drinkers skipping items 2–8) |
47
+ | `cesd` | prorate, ≥16 of 20 answered | Common research practice (≈80% completion) |
48
+ | `ecr-r` | prorate, ≥14 of 18 per subscale | Subscales are mean-based in the literature; prorating is equivalent |
49
+ | `erq` | require-complete | Short subscales (6 and 4 items); partial means are unstable |
50
+ | `hsps` | prorate, ≥21 of 27 answered | Total is mean-based in the literature; prorating is equivalent |
51
+ | `swls`, `flourishing`, `k10`, `k6` | require-complete | Short instruments; cutoffs are undefined for partial data (K10 note: the interview form scores skipped items 1 — see its section) |
52
+ | `rses` | prorate, ≥8 of 10 answered | Common research practice (80% completion) |
45
53
 
46
54
  ## PHQ-9 — Patient Health Questionnaire-9 (`phq9`)
47
55
 
@@ -98,3 +106,69 @@ Bundled inventories ship with declarative missing-data policies (`scoring.missin
98
106
 
99
107
  - **Citation:** Allison, C., Auyeung, B., & Baron-Cohen, S. (2012). Toward brief "Red Flags" for autism screening: The Short Autism Spectrum Quotient and the Short Quantitative Checklist in 1,000 cases and 3,000 controls. *Journal of the American Academy of Child & Adolescent Psychiatry, 51*(2), 202–212.
100
108
  - **Scoring:** 1 point per item in the trait direction (agree on items 1, 7, 8, 10; disagree on the rest); ≥6 suggests specialist referral, per Allison et al. (2012).
109
+
110
+ ## CES-D — Center for Epidemiologic Studies Depression Scale (`cesd`)
111
+
112
+ **License: Free.** Developed by Lenore Radloff at the U.S. National Institute of Mental Health; as a work of the U.S. government it is in the public domain and may be used without permission. The English text was taken from the NIDA "Seek, Test, Treat and Retain" data harmonization packet (<https://nida.nih.gov/sites/default/files/Mental_HealthV.pdf>).
113
+
114
+ - **Citation:** Radloff, L. S. (1977). The CES-D Scale: A self-report depression scale for research in the general population. *Applied Psychological Measurement, 1*(3), 385–401.
115
+ - **Scoring:** Sum 0–60 with items 4, 8, 12, 16 reverse-scored. The bundled bands split at the classic cutoff — scores ≥16 indicate elevated depressive symptoms (Radloff, 1977). The cutoff screens for risk; it is not a diagnosis.
116
+
117
+ ## ECR-R — Experiences in Close Relationships-Revised (`ecr-r`)
118
+
119
+ **License: Research only.** Per the authors, the items "were published in a scientific journal for use in the public domain" and may be used **in non-commercial research without permission; commercial use requires permission** (R. C. Fraley, <https://labs.psychology.illinois.edu/~rcfraley/measures/>). The Turkish adaptation is distributed at <http://www.nebisumer.com> for scientific research only — explicitly not for clinical diagnosis, psychological evaluation, or personnel selection.
120
+
121
+ - **Citation:** Fraley, R. C., Waller, N. G., & Brennan, K. A. (2000). An item response theory analysis of self-report measures of adult attachment. *Journal of Personality and Social Psychology, 78*(2), 350–365.
122
+ - **Turkish adaptation (validated, reproduced):** Selçuk, E., Günaydın, G., Sümer, N., & Uysal, A. (2005). Yetişkin bağlanma boyutları için yeni bir ölçüm: Yakın İlişkilerde Yaşantılar Envanteri-II'nin Türk örnekleminde psikometrik açıdan değerlendirilmesi. *Türk Psikoloji Yazıları, 8*, 1–11. The `tr` locale pack **deviates from the global provenance table**: it reproduces this published adaptation's wording (via nebisumer.com) rather than an AI translation. The Turkish source presents the same 36 items interleaved (odd = anxiety, even = avoidance); the bundled definition keeps the original English item order, with each Turkish wording attached to its matching item — the item-level reverse keys of both published versions agree under this mapping. The pack's description and final instruction sentence are adapted for on-screen rendering.
123
+ - **Scoring:** Two 18-item subscales (attachment anxiety: items 1–18; avoidance: items 19–36), 14 items reverse-scored. psytools reports subscale sums (18–126); the published convention is the item mean (divide by 18). No clinical cutoffs exist.
124
+
125
+ ## ERQ — Emotion Regulation Questionnaire (`erq`)
126
+
127
+ **License: Research only.** Distributed by the authors free of charge for non-commercial research (Stanford Psychophysiology Laboratory, <https://spl.stanford.edu>); commercial use is not licensed.
128
+
129
+ - **Citation:** Gross, J. J., & John, O. P. (2003). Individual differences in two emotion regulation processes: Implications for affect, relationships, and well-being. *Journal of Personality and Social Psychology, 85*(2), 348–362.
130
+ - **Scoring:** Two subscales, no reversals: cognitive reappraisal (items 1, 3, 5, 7, 8, 10) and expressive suppression (items 2, 4, 6, 9). psytools reports sums; the published convention is item means. The authors instruct not to change the item order (items 1 and 3 define "positive emotion" and "negative emotion").
131
+ - **Turkish note:** A validated Turkish adaptation exists (Ulaşan Özgüle, E. T., 2011, unpublished Ph.D. dissertation, METU; distributed at nebisumer.com), but it uses a **6-point "how true of me" scale and a different item order**, so its wording cannot be attached to this 7-point agreement definition without misrepresenting the validated form. The bundled `tr` pack is therefore an AI translation like the other locales.
132
+
133
+ ## HSPS — Highly Sensitive Person Scale (`hsps`)
134
+
135
+ **License: Research only.** HSP Scale © 1997 Elaine Aron; the scale is distributed for research use (see Aron & Aron, 1997, and <https://hsperson.com>). The Turkish adaptation is distributed at <http://www.nebisumer.com> for scientific research only — explicitly not for clinical diagnosis, psychological evaluation, or personnel selection.
136
+
137
+ - **Citation:** Aron, E. N., & Aron, A. (1997). Sensory-processing sensitivity and its relation to introversion and emotionality. *Journal of Personality and Social Psychology, 73*(2), 345–368.
138
+ - **Turkish adaptation (validated, reproduced):** Şengül-İnal, G., & Sümer, N. (2017). Exploring the multidimensional structure of sensory processing sensitivity in Turkish samples. *Current Psychology.* The `tr` locale pack **deviates from the global provenance table**: items, title, and option anchors reproduce this published adaptation (via nebisumer.com) rather than an AI translation; only the pack's description and instructions are adapted for on-screen rendering. The Turkish item order matches the original 1:1.
139
+ - **Scoring:** Sum over all 27 items (27–189), no reverse-scored items; the literature commonly reports the item mean (divide by 27). Sensory-processing sensitivity is a continuous trait — no clinical cutoffs are defined.
140
+
141
+ ## SWLS — Satisfaction with Life Scale (`swls`)
142
+
143
+ **License: Free with conditions.** Copyrighted by Ed Diener and co-authors; per the authors' site the scale may be used "without permission or charge by all professionals (researchers and practitioners)" as long as credit is given, **for non-commercial purposes only** (<https://eddiener.com/scales/>). Embedding in commercial products is not licensed.
144
+
145
+ - **Citation:** Diener, E., Emmons, R. A., Larsen, R. J., & Griffin, S. (1985). The Satisfaction With Life Scale. *Journal of Personality Assessment, 49*(1), 71–75.
146
+ - **Scoring:** Sum 5–35 on a fully labeled 1–7 agreement scale; interpreted against Diener's published groupings (5–9 extremely dissatisfied … 20 neutral … 31–35 extremely satisfied).
147
+
148
+ ## FS — Flourishing Scale (`flourishing`)
149
+
150
+ **License: Free with conditions.** Same rights statement as the SWLS (copyright Ed Diener and co-authors; free for researchers and practitioners with credit, non-commercial purposes only).
151
+
152
+ - **Citation:** Diener, E., Wirtz, D., Tov, W., Kim-Prieto, C., Choi, D., Oishi, S., & Biswas-Diener, R. (2010). New well-being measures: Short scales to assess flourishing and positive and negative feelings. *Social Indicators Research, 97*(2), 143–156.
153
+ - **Scoring:** Sum 8–56; higher scores indicate more self-perceived psychological resources. No published cutoffs.
154
+
155
+ ## K10 — Kessler Psychological Distress Scale, 10 items (`k10`)
156
+
157
+ **License: Free.** The K10/K6 scales are in the public domain and free for clinical and research use (Kessler and colleagues; distributed via the Harvard NCS site and government health surveys worldwide).
158
+
159
+ - **Citation:** Kessler, R. C., Andrews, G., Colpe, L. J., Hiripi, E., Mroczek, D. K., Normand, S.-L. T., Walters, E. E., & Zaslavsky, A. M. (2002). Short screening scales to monitor population prevalences and trends in non-specific psychological distress. *Psychological Medicine, 32*(6), 959–976.
160
+ - **Scoring:** Items scored 1–5, sum 10–50. The bundled severity groupings (10–19 likely well, 20–24 mild, 25–29 moderate, 30–50 severe) follow the widely used Australian convention; other groupings exist. The full interview administration skips items 3/6 after a "none of the time" answer and scores them 1; this simple form administers all items.
161
+
162
+ ## K6 — Kessler Psychological Distress Scale, 6 items (`k6`)
163
+
164
+ **License: Free.** Same public-domain status as the K10.
165
+
166
+ - **Citation:** Kessler et al. (2002), as above. Serious-distress cutoff: Kessler, R. C., Barker, P. R., Colpe, L. J., et al. (2003). Screening for serious mental illness in the general population. *Archives of General Psychiatry, 60*(2), 184–189. Moderate band: Prochaska, J. J., Sung, H.-Y., Max, W., Shi, Y., & Ong, M. (2012). Validity study of the K6 scale as a measure of moderate mental distress based on mental health treatment need and utilization. *International Journal of Methods in Psychiatric Research, 21*(2), 88–97.
167
+ - **Scoring:** U.S. convention — items scored 0–4, sum 0–24; ≥13 indicates serious psychological distress, 5–12 moderate distress.
168
+
169
+ ## RSES — Rosenberg Self-Esteem Scale (`rses`)
170
+
171
+ **License: Free with conditions.** The Rosenberg family (Morris Rosenberg Foundation) permits use of the scale for educational and professional research without charge or explicit permission, with attribution; see the University of Maryland Department of Sociology FAQ (<https://socy.umd.edu/rosenberg-scale-faq>). Commercial use is not explicitly licensed.
172
+
173
+ - **Citation:** Rosenberg, M. (1965). *Society and the Adolescent Self-Image.* Princeton, NJ: Princeton University Press.
174
+ - **Scoring:** Items scored 0–3 (Strongly disagree = 0 … Strongly agree = 3), items 2, 5, 6, 8, 9 reverse-scored, sum 0–30. Scores 15–25 are commonly described as the normal range (University of Maryland scoring guidance).
@@ -1,4 +1,4 @@
1
- export type { LocalizedText, AssessmentOption, AssessmentQuestion, AssessmentDefinition, ScoreBand, ScoreFlag, SumScoring, SubscaleDefinition, SubscaleScoring, CountScoringItem, CountScoring, MissingDataPolicy, MissingDataStrategy, ScoringDefinition, ValidationIssueCode, AnswerMap, InventoryLocalePack, ResponseStatus, ResponseData, ValidationIssue, ValidationResult, BandResult, TriggeredFlag, ScaleScore, ScaleResult, MultiScaleResult, CategoricalResult, CustomResult, EvaluationResult, Evaluator, LocalizedAssessmentView, } from "./types.ts";
1
+ export type { LocalizedText, AssessmentOption, AssessmentQuestion, AssessmentDefinition, InventoryCategory, ScoreBand, ScoreFlag, SumScoring, SubscaleDefinition, SubscaleScoring, CountScoringItem, CountScoring, MissingDataPolicy, MissingDataStrategy, ScoringDefinition, ValidationIssueCode, AnswerMap, InventoryLocalePack, ResponseStatus, ResponseData, ValidationIssue, ValidationResult, BandResult, TriggeredFlag, ScaleScore, ScaleResult, MultiScaleResult, CategoricalResult, CustomResult, EvaluationResult, Evaluator, LocalizedAssessmentView, } from "./types.ts";
2
2
  export { PsytoolsError } from "./errors.ts";
3
3
  export type { PsytoolsErrorCode } from "./errors.ts";
4
4
  export { localizeText, collectLocales, pickLocales, applyLocale } from "./i18n.ts";
@@ -8,5 +8,5 @@ export { Assessment, validateDefinition } from "./assessment.ts";
8
8
  export { AssessmentResponse } from "./response.ts";
9
9
  export { evaluate } from "./evaluation.ts";
10
10
  export type { EvaluateOptions } from "./evaluation.ts";
11
- export { phq9, gad7, dass21, who5, asrs6, aq10, audit, miniIpip, inventories, loadInventory, twoWeekFrequencyOptions, twoWeekInstructions, } from "./inventories/index.ts";
11
+ export { phq9, gad7, dass21, who5, asrs6, aq10, audit, miniIpip, cesd, ecrR, erq, hsps, swls, flourishing, k10, k6, rses, inventories, loadInventory, twoWeekFrequencyOptions, twoWeekInstructions, } from "./inventories/index.ts";
12
12
  export type { InventoryId } from "./inventories/index.ts";
package/dist/cjs/index.js CHANGED
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.loadInventory = exports.inventories = exports.miniIpip = exports.audit = exports.aq10 = exports.asrs6 = exports.who5 = exports.dass21 = exports.gad7 = exports.phq9 = exports.evaluate = exports.AssessmentResponse = exports.validateDefinition = exports.Assessment = exports.availableLocales = exports.localePacks = exports.applyLocale = exports.pickLocales = exports.collectLocales = exports.localizeText = exports.PsytoolsError = void 0;
3
+ exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.loadInventory = exports.inventories = exports.rses = exports.k6 = exports.k10 = exports.flourishing = exports.swls = exports.hsps = exports.erq = exports.ecrR = exports.cesd = exports.miniIpip = exports.audit = exports.aq10 = exports.asrs6 = exports.who5 = exports.dass21 = exports.gad7 = exports.phq9 = exports.evaluate = exports.AssessmentResponse = exports.validateDefinition = exports.Assessment = exports.availableLocales = exports.localePacks = exports.applyLocale = exports.pickLocales = exports.collectLocales = exports.localizeText = exports.PsytoolsError = void 0;
4
4
  var errors_ts_1 = require("./errors.js");
5
5
  Object.defineProperty(exports, "PsytoolsError", { enumerable: true, get: function () { return errors_ts_1.PsytoolsError; } });
6
6
  var i18n_ts_1 = require("./i18n.js");
@@ -27,6 +27,15 @@ Object.defineProperty(exports, "asrs6", { enumerable: true, get: function () { r
27
27
  Object.defineProperty(exports, "aq10", { enumerable: true, get: function () { return index_ts_2.aq10; } });
28
28
  Object.defineProperty(exports, "audit", { enumerable: true, get: function () { return index_ts_2.audit; } });
29
29
  Object.defineProperty(exports, "miniIpip", { enumerable: true, get: function () { return index_ts_2.miniIpip; } });
30
+ Object.defineProperty(exports, "cesd", { enumerable: true, get: function () { return index_ts_2.cesd; } });
31
+ Object.defineProperty(exports, "ecrR", { enumerable: true, get: function () { return index_ts_2.ecrR; } });
32
+ Object.defineProperty(exports, "erq", { enumerable: true, get: function () { return index_ts_2.erq; } });
33
+ Object.defineProperty(exports, "hsps", { enumerable: true, get: function () { return index_ts_2.hsps; } });
34
+ Object.defineProperty(exports, "swls", { enumerable: true, get: function () { return index_ts_2.swls; } });
35
+ Object.defineProperty(exports, "flourishing", { enumerable: true, get: function () { return index_ts_2.flourishing; } });
36
+ Object.defineProperty(exports, "k10", { enumerable: true, get: function () { return index_ts_2.k10; } });
37
+ Object.defineProperty(exports, "k6", { enumerable: true, get: function () { return index_ts_2.k6; } });
38
+ Object.defineProperty(exports, "rses", { enumerable: true, get: function () { return index_ts_2.rses; } });
30
39
  Object.defineProperty(exports, "inventories", { enumerable: true, get: function () { return index_ts_2.inventories; } });
31
40
  Object.defineProperty(exports, "loadInventory", { enumerable: true, get: function () { return index_ts_2.loadInventory; } });
32
41
  Object.defineProperty(exports, "twoWeekFrequencyOptions", { enumerable: true, get: function () { return index_ts_2.twoWeekFrequencyOptions; } });
@@ -14,6 +14,7 @@ exports.aq10 = void 0;
14
14
  exports.aq10 = {
15
15
  id: "aq10",
16
16
  version: "1.0.0",
17
+ categories: ["autism"],
17
18
  title: {
18
19
  en: "Autism Spectrum Quotient (AQ-10) — Adult",
19
20
  },
@@ -13,6 +13,7 @@ exports.asrs6 = void 0;
13
13
  exports.asrs6 = {
14
14
  id: "asrs6",
15
15
  version: "1.0.0",
16
+ categories: ["adhd"],
16
17
  title: {
17
18
  en: "Adult ADHD Self-Report Scale (ASRS-v1.1) Screener",
18
19
  },
@@ -53,6 +53,7 @@ const injuryOptions = [
53
53
  exports.audit = {
54
54
  id: "audit",
55
55
  version: "1.0.0",
56
+ categories: ["substance-use"],
56
57
  title: {
57
58
  en: "Alcohol Use Disorders Identification Test (AUDIT)",
58
59
  },
@@ -0,0 +1,11 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+ /**
3
+ * CES-D — Center for Epidemiologic Studies Depression Scale.
4
+ *
5
+ * 20 items, 0–3 past-week frequency scale, total score 0–60. Items 4, 8,
6
+ * 12 and 16 are positively worded and reverse scored. Scores of 16 or
7
+ * above indicate elevated depressive symptoms (Radloff, 1977). Developed
8
+ * at the U.S. National Institute of Mental Health; the scale is in the
9
+ * public domain.
10
+ */
11
+ export declare const cesd: AssessmentDefinition;
@@ -0,0 +1,205 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.cesd = void 0;
4
+ /**
5
+ * CES-D — Center for Epidemiologic Studies Depression Scale.
6
+ *
7
+ * 20 items, 0–3 past-week frequency scale, total score 0–60. Items 4, 8,
8
+ * 12 and 16 are positively worded and reverse scored. Scores of 16 or
9
+ * above indicate elevated depressive symptoms (Radloff, 1977). Developed
10
+ * at the U.S. National Institute of Mental Health; the scale is in the
11
+ * public domain.
12
+ */
13
+ exports.cesd = {
14
+ id: "cesd",
15
+ version: "1.0.0",
16
+ categories: ["depression"],
17
+ title: {
18
+ en: "Center for Epidemiologic Studies Depression Scale (CES-D)",
19
+ },
20
+ description: {
21
+ en: "A 20-item self-report scale designed to measure depressive symptomatology in the general population.",
22
+ },
23
+ instructions: {
24
+ en: "Please read each statement carefully, then indicate how often you felt or behaved this way during the past week, including today.",
25
+ },
26
+ defaultLocale: "en",
27
+ options: [
28
+ {
29
+ value: 0,
30
+ label: {
31
+ en: "Rarely or none of the time (less than 1 day)",
32
+ },
33
+ },
34
+ {
35
+ value: 1,
36
+ label: {
37
+ en: "Some or a little of the time (1-2 days)",
38
+ },
39
+ },
40
+ {
41
+ value: 2,
42
+ label: {
43
+ en: "Occasionally or a moderate amount of the time (3-4 days)",
44
+ },
45
+ },
46
+ {
47
+ value: 3,
48
+ label: {
49
+ en: "Most or all of the time (5-7 days)",
50
+ },
51
+ },
52
+ ],
53
+ questions: [
54
+ {
55
+ id: "cesd-1",
56
+ text: {
57
+ en: "I was bothered by things that usually don't bother me",
58
+ },
59
+ },
60
+ {
61
+ id: "cesd-2",
62
+ text: {
63
+ en: "I did not feel like eating; my appetite was poor",
64
+ },
65
+ },
66
+ {
67
+ id: "cesd-3",
68
+ text: {
69
+ en: "I felt that I could not shake off the blues even with help from my family and friends",
70
+ },
71
+ },
72
+ {
73
+ id: "cesd-4",
74
+ text: {
75
+ en: "I felt that I was just as good as other people",
76
+ },
77
+ reverseScored: true,
78
+ },
79
+ {
80
+ id: "cesd-5",
81
+ text: {
82
+ en: "I had trouble keeping my mind on what I was doing",
83
+ },
84
+ },
85
+ {
86
+ id: "cesd-6",
87
+ text: {
88
+ en: "I felt depressed",
89
+ },
90
+ },
91
+ {
92
+ id: "cesd-7",
93
+ text: {
94
+ en: "I felt that everything I did was an effort",
95
+ },
96
+ },
97
+ {
98
+ id: "cesd-8",
99
+ text: {
100
+ en: "I felt hopeful about the future",
101
+ },
102
+ reverseScored: true,
103
+ },
104
+ {
105
+ id: "cesd-9",
106
+ text: {
107
+ en: "I thought my life had been a failure",
108
+ },
109
+ },
110
+ {
111
+ id: "cesd-10",
112
+ text: {
113
+ en: "I felt fearful",
114
+ },
115
+ },
116
+ {
117
+ id: "cesd-11",
118
+ text: {
119
+ en: "My sleep was restless",
120
+ },
121
+ },
122
+ {
123
+ id: "cesd-12",
124
+ text: {
125
+ en: "I was happy",
126
+ },
127
+ reverseScored: true,
128
+ },
129
+ {
130
+ id: "cesd-13",
131
+ text: {
132
+ en: "I talked less than usual",
133
+ },
134
+ },
135
+ {
136
+ id: "cesd-14",
137
+ text: {
138
+ en: "I felt lonely",
139
+ },
140
+ },
141
+ {
142
+ id: "cesd-15",
143
+ text: {
144
+ en: "People were unfriendly",
145
+ },
146
+ },
147
+ {
148
+ id: "cesd-16",
149
+ text: {
150
+ en: "I enjoyed life",
151
+ },
152
+ reverseScored: true,
153
+ },
154
+ {
155
+ id: "cesd-17",
156
+ text: {
157
+ en: "I had crying spells",
158
+ },
159
+ },
160
+ {
161
+ id: "cesd-18",
162
+ text: {
163
+ en: "I felt sad",
164
+ },
165
+ },
166
+ {
167
+ id: "cesd-19",
168
+ text: {
169
+ en: "I felt that people disliked me",
170
+ },
171
+ },
172
+ {
173
+ id: "cesd-20",
174
+ text: {
175
+ en: "I could not get \"going\"",
176
+ },
177
+ },
178
+ ],
179
+ scoring: {
180
+ kind: "sum",
181
+ missing: { strategy: "prorate", minAnswered: 16 },
182
+ bands: [
183
+ {
184
+ id: "below-cutoff",
185
+ min: 0,
186
+ max: 15,
187
+ label: { en: "Below the clinical cutoff" },
188
+ },
189
+ {
190
+ id: "elevated",
191
+ min: 16,
192
+ max: 60,
193
+ label: { en: "Elevated depressive symptoms (at or above the cutoff of 16)" },
194
+ },
195
+ ],
196
+ },
197
+ meta: {
198
+ reference: "Radloff, L. S. (1977). The CES-D Scale: A self-report depression scale for research in the general population. Applied Psychological Measurement, 1(3), 385-401.",
199
+ license: "Free — developed at the U.S. National Institute of Mental Health; the scale is in the public domain and may be used without permission",
200
+ licenseFlag: "free",
201
+ translationProvenance: "en: reproduced from the original instrument (via the NIDA Seek, Test, Treat and Retain data harmonization packet). Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-fable-5) from the original English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
202
+ timeframe: "past week",
203
+ scoringNote: "The >=16 cutoff for elevated depressive symptoms follows Radloff (1977); it screens for risk and is not a diagnosis. The prorating threshold (>=16 of 20 items) is an implementation choice, not part of the published scoring.",
204
+ },
205
+ };
@@ -6,3 +6,14 @@ import type { AssessmentOption, LocalizedText } from "../types.ts";
6
6
  export declare const twoWeekFrequencyOptions: AssessmentOption[];
7
7
  /** Instructions shared by PHQ-9 and GAD-7. */
8
8
  export declare const twoWeekInstructions: LocalizedText;
9
+ /**
10
+ * The fully labeled 1–7 agreement scale shared by the Diener scales
11
+ * (SWLS, Flourishing Scale).
12
+ */
13
+ export declare const sevenPointAgreementOptions: AssessmentOption[];
14
+ /**
15
+ * The past-30-days frequency labels shared by the Kessler distress
16
+ * scales. K10 stores them as 1–5 (sum 10–50), K6 as 0–4 (sum 0–24),
17
+ * matching each instrument's published scoring convention.
18
+ */
19
+ export declare const kesslerFrequencyLabels: string[];
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = void 0;
3
+ exports.kesslerFrequencyLabels = exports.sevenPointAgreementOptions = exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = void 0;
4
4
  /**
5
5
  * The 0–3 frequency scale ("over the last 2 weeks") shared by PHQ-9 and
6
6
  * GAD-7.
@@ -35,3 +35,28 @@ exports.twoWeekFrequencyOptions = [
35
35
  exports.twoWeekInstructions = {
36
36
  en: "Over the last 2 weeks, how often have you been bothered by any of the following problems?",
37
37
  };
38
+ /**
39
+ * The fully labeled 1–7 agreement scale shared by the Diener scales
40
+ * (SWLS, Flourishing Scale).
41
+ */
42
+ exports.sevenPointAgreementOptions = [
43
+ { value: 1, label: { en: "Strongly disagree" } },
44
+ { value: 2, label: { en: "Disagree" } },
45
+ { value: 3, label: { en: "Slightly disagree" } },
46
+ { value: 4, label: { en: "Neither agree nor disagree" } },
47
+ { value: 5, label: { en: "Slightly agree" } },
48
+ { value: 6, label: { en: "Agree" } },
49
+ { value: 7, label: { en: "Strongly agree" } },
50
+ ];
51
+ /**
52
+ * The past-30-days frequency labels shared by the Kessler distress
53
+ * scales. K10 stores them as 1–5 (sum 10–50), K6 as 0–4 (sum 0–24),
54
+ * matching each instrument's published scoring convention.
55
+ */
56
+ exports.kesslerFrequencyLabels = [
57
+ "None of the time",
58
+ "A little of the time",
59
+ "Some of the time",
60
+ "Most of the time",
61
+ "All of the time",
62
+ ];
@@ -34,6 +34,7 @@ const stressBands = [
34
34
  exports.dass21 = {
35
35
  id: "dass21",
36
36
  version: "1.0.0",
37
+ categories: ["depression", "anxiety", "stress"],
37
38
  title: {
38
39
  en: "Depression Anxiety Stress Scales (DASS-21)",
39
40
  },
@@ -0,0 +1,16 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+ /**
3
+ * ECR-R — Experiences in Close Relationships-Revised (adult attachment).
4
+ *
5
+ * 36 items on a 1–7 agreement scale: items 1–18 form the attachment
6
+ * anxiety subscale, items 19–36 attachment avoidance (Fraley, Waller &
7
+ * Brennan, 2000). Subscale results are reported as sums (18–126); the
8
+ * published convention is the item mean — divide by 18. The dimensions
9
+ * are continuous; no clinical cutoffs exist, so no bands are defined.
10
+ *
11
+ * Research use only: the items are published for use in the public
12
+ * domain for non-commercial research; commercial use requires the
13
+ * authors' permission. The Turkish locale pack reproduces the validated
14
+ * YİYE-II adaptation (Selçuk, Günaydın, Sümer & Uysal, 2005).
15
+ */
16
+ export declare const ecrR: AssessmentDefinition;