psytools 0.6.3 → 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 (137) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +13 -6
  3. package/SOURCES.md +58 -1
  4. package/dist/cjs/inventories/gds15.d.ts +11 -0
  5. package/dist/cjs/inventories/gds15.js +81 -0
  6. package/dist/cjs/inventories/index.d.ts +7 -1
  7. package/dist/cjs/inventories/index.js +16 -1
  8. package/dist/cjs/inventories/pc-ptsd-5.d.ts +12 -0
  9. package/dist/cjs/inventories/pc-ptsd-5.js +91 -0
  10. package/dist/cjs/inventories/phq4.d.ts +11 -0
  11. package/dist/cjs/inventories/phq4.js +73 -0
  12. package/dist/cjs/inventories/phq8.d.ts +11 -0
  13. package/dist/cjs/inventories/phq8.js +71 -0
  14. package/dist/cjs/inventories/tipi.d.ts +10 -0
  15. package/dist/cjs/inventories/tipi.js +70 -0
  16. package/dist/cjs/locales/de/gds15.d.ts +4 -0
  17. package/dist/cjs/locales/de/gds15.js +34 -0
  18. package/dist/cjs/locales/de/pc-ptsd-5.d.ts +4 -0
  19. package/dist/cjs/locales/de/pc-ptsd-5.js +32 -0
  20. package/dist/cjs/locales/de/phq4.d.ts +4 -0
  21. package/dist/cjs/locales/de/phq4.js +35 -0
  22. package/dist/cjs/locales/de/phq8.d.ts +4 -0
  23. package/dist/cjs/locales/de/phq8.js +35 -0
  24. package/dist/cjs/locales/de/tipi.d.ts +4 -0
  25. package/dist/cjs/locales/de/tipi.js +39 -0
  26. package/dist/cjs/locales/es/gds15.d.ts +4 -0
  27. package/dist/cjs/locales/es/gds15.js +34 -0
  28. package/dist/cjs/locales/es/pc-ptsd-5.d.ts +4 -0
  29. package/dist/cjs/locales/es/pc-ptsd-5.js +32 -0
  30. package/dist/cjs/locales/es/phq4.d.ts +4 -0
  31. package/dist/cjs/locales/es/phq4.js +35 -0
  32. package/dist/cjs/locales/es/phq8.d.ts +4 -0
  33. package/dist/cjs/locales/es/phq8.js +35 -0
  34. package/dist/cjs/locales/es/tipi.d.ts +4 -0
  35. package/dist/cjs/locales/es/tipi.js +39 -0
  36. package/dist/cjs/locales/index.js +30 -0
  37. package/dist/cjs/locales/tr/gds15.d.ts +4 -0
  38. package/dist/cjs/locales/tr/gds15.js +34 -0
  39. package/dist/cjs/locales/tr/pc-ptsd-5.d.ts +4 -0
  40. package/dist/cjs/locales/tr/pc-ptsd-5.js +32 -0
  41. package/dist/cjs/locales/tr/phq4.d.ts +4 -0
  42. package/dist/cjs/locales/tr/phq4.js +35 -0
  43. package/dist/cjs/locales/tr/phq8.d.ts +4 -0
  44. package/dist/cjs/locales/tr/phq8.js +33 -0
  45. package/dist/cjs/locales/tr/tipi.d.ts +4 -0
  46. package/dist/cjs/locales/tr/tipi.js +39 -0
  47. package/dist/cjs/locales/zh/gds15.d.ts +4 -0
  48. package/dist/cjs/locales/zh/gds15.js +34 -0
  49. package/dist/cjs/locales/zh/pc-ptsd-5.d.ts +4 -0
  50. package/dist/cjs/locales/zh/pc-ptsd-5.js +32 -0
  51. package/dist/cjs/locales/zh/phq4.d.ts +4 -0
  52. package/dist/cjs/locales/zh/phq4.js +35 -0
  53. package/dist/cjs/locales/zh/phq8.d.ts +4 -0
  54. package/dist/cjs/locales/zh/phq8.js +31 -0
  55. package/dist/cjs/locales/zh/tipi.d.ts +4 -0
  56. package/dist/cjs/locales/zh/tipi.js +31 -0
  57. package/dist/esm/inventories/gds15.d.ts +11 -0
  58. package/dist/esm/inventories/gds15.js +78 -0
  59. package/dist/esm/inventories/index.d.ts +7 -1
  60. package/dist/esm/inventories/index.js +11 -0
  61. package/dist/esm/inventories/pc-ptsd-5.d.ts +12 -0
  62. package/dist/esm/inventories/pc-ptsd-5.js +88 -0
  63. package/dist/esm/inventories/phq4.d.ts +11 -0
  64. package/dist/esm/inventories/phq4.js +70 -0
  65. package/dist/esm/inventories/phq8.d.ts +11 -0
  66. package/dist/esm/inventories/phq8.js +68 -0
  67. package/dist/esm/inventories/tipi.d.ts +10 -0
  68. package/dist/esm/inventories/tipi.js +67 -0
  69. package/dist/esm/locales/de/gds15.d.ts +4 -0
  70. package/dist/esm/locales/de/gds15.js +32 -0
  71. package/dist/esm/locales/de/pc-ptsd-5.d.ts +4 -0
  72. package/dist/esm/locales/de/pc-ptsd-5.js +30 -0
  73. package/dist/esm/locales/de/phq4.d.ts +4 -0
  74. package/dist/esm/locales/de/phq4.js +33 -0
  75. package/dist/esm/locales/de/phq8.d.ts +4 -0
  76. package/dist/esm/locales/de/phq8.js +33 -0
  77. package/dist/esm/locales/de/tipi.d.ts +4 -0
  78. package/dist/esm/locales/de/tipi.js +37 -0
  79. package/dist/esm/locales/es/gds15.d.ts +4 -0
  80. package/dist/esm/locales/es/gds15.js +32 -0
  81. package/dist/esm/locales/es/pc-ptsd-5.d.ts +4 -0
  82. package/dist/esm/locales/es/pc-ptsd-5.js +30 -0
  83. package/dist/esm/locales/es/phq4.d.ts +4 -0
  84. package/dist/esm/locales/es/phq4.js +33 -0
  85. package/dist/esm/locales/es/phq8.d.ts +4 -0
  86. package/dist/esm/locales/es/phq8.js +33 -0
  87. package/dist/esm/locales/es/tipi.d.ts +4 -0
  88. package/dist/esm/locales/es/tipi.js +37 -0
  89. package/dist/esm/locales/index.js +30 -0
  90. package/dist/esm/locales/tr/gds15.d.ts +4 -0
  91. package/dist/esm/locales/tr/gds15.js +32 -0
  92. package/dist/esm/locales/tr/pc-ptsd-5.d.ts +4 -0
  93. package/dist/esm/locales/tr/pc-ptsd-5.js +30 -0
  94. package/dist/esm/locales/tr/phq4.d.ts +4 -0
  95. package/dist/esm/locales/tr/phq4.js +33 -0
  96. package/dist/esm/locales/tr/phq8.d.ts +4 -0
  97. package/dist/esm/locales/tr/phq8.js +31 -0
  98. package/dist/esm/locales/tr/tipi.d.ts +4 -0
  99. package/dist/esm/locales/tr/tipi.js +37 -0
  100. package/dist/esm/locales/zh/gds15.d.ts +4 -0
  101. package/dist/esm/locales/zh/gds15.js +32 -0
  102. package/dist/esm/locales/zh/pc-ptsd-5.d.ts +4 -0
  103. package/dist/esm/locales/zh/pc-ptsd-5.js +30 -0
  104. package/dist/esm/locales/zh/phq4.d.ts +4 -0
  105. package/dist/esm/locales/zh/phq4.js +33 -0
  106. package/dist/esm/locales/zh/phq8.d.ts +4 -0
  107. package/dist/esm/locales/zh/phq8.js +29 -0
  108. package/dist/esm/locales/zh/tipi.d.ts +4 -0
  109. package/dist/esm/locales/zh/tipi.js +29 -0
  110. package/package.json +11 -3
  111. package/src/inventories/gds15.ts +87 -0
  112. package/src/inventories/index.ts +17 -1
  113. package/src/inventories/pc-ptsd-5.ts +96 -0
  114. package/src/inventories/phq4.ts +76 -0
  115. package/src/inventories/phq8.ts +73 -0
  116. package/src/inventories/tipi.ts +74 -0
  117. package/src/locales/de/gds15.ts +35 -0
  118. package/src/locales/de/pc-ptsd-5.ts +35 -0
  119. package/src/locales/de/phq4.ts +37 -0
  120. package/src/locales/de/phq8.ts +37 -0
  121. package/src/locales/de/tipi.ts +42 -0
  122. package/src/locales/es/gds15.ts +35 -0
  123. package/src/locales/es/pc-ptsd-5.ts +35 -0
  124. package/src/locales/es/phq4.ts +37 -0
  125. package/src/locales/es/phq8.ts +38 -0
  126. package/src/locales/es/tipi.ts +42 -0
  127. package/src/locales/index.ts +30 -0
  128. package/src/locales/tr/gds15.ts +35 -0
  129. package/src/locales/tr/pc-ptsd-5.ts +35 -0
  130. package/src/locales/tr/phq4.ts +37 -0
  131. package/src/locales/tr/phq8.ts +35 -0
  132. package/src/locales/tr/tipi.ts +42 -0
  133. package/src/locales/zh/gds15.ts +35 -0
  134. package/src/locales/zh/pc-ptsd-5.ts +35 -0
  135. package/src/locales/zh/phq4.ts +36 -0
  136. package/src/locales/zh/phq8.ts +32 -0
  137. package/src/locales/zh/tipi.ts +33 -0
package/LICENSE CHANGED
@@ -6,7 +6,7 @@ everything that makes psytools run — is licensed under the MIT
6
6
  License below. Copyright (c) 2026 Samed Kahyaoglu.
7
7
 
8
8
  The bundled instrument text — the titles, descriptions, instructions,
9
- item wording, and answer-option labels of the twenty-seven third-party
9
+ item wording, and answer-option labels of the thirty-two third-party
10
10
  psychological assessment instruments psytools ships, in every
11
11
  language psytools provides them — is licensed by each instrument's
12
12
  own rights holder, on the terms recorded instrument by instrument in
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** — twenty-six instruments (PHQ-9, PHQ-15, GAD-7, DASS-21, WHO-5, ASRS, AQ-10, AUDIT, Mini-IPIP, Mini-IPIP6, CES-D, ECR-R, ERQ, HSPS, SWLS, Flourishing, K10, K6, RSES, IPIP BIS/BAS, IPIP-NEO-60, IPIP-VIA-R, PCL-5, EAT-26, CSI-16, UCLA Loneliness Scale) ship ready to use in up to five languages (English, Turkish, German, Chinese, Spanish — see the table below), with published scoring rules, citations, and filtering metadata (category, target audience, respondent role).
22
+ - **Batteries included** — thirty-two instruments (PHQ-9, PHQ-15, GAD-7, DASS-21, WHO-5, ASRS, AQ-10, AUDIT, Mini-IPIP, Mini-IPIP6, CES-D, ECR-R, ERQ, HSPS, SWLS, Flourishing, K10, K6, RSES, IPIP BIS/BAS, IPIP-NEO-60, IPIP-VIA-R, PCL-5, EAT-26, CSI-16, UCLA Loneliness Scale, CBI, PC-PTSD-5, PHQ-4, PHQ-8, GDS-15, TIPI) ship ready to use in up to five languages (English, Turkish, German, Chinese, Spanish — see the table below), with published scoring rules, citations, and filtering metadata (category, target audience, respondent role).
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.
@@ -110,10 +110,17 @@ const response = AssessmentResponse.parse(assessment, rowFromDb); // answers re-
110
110
  | `csi16` | Couples Satisfaction Index (CSI-16) | relationships | 16 | Sum 0–81, **higher is better**, dissatisfied below 51.5 | en, tr, de, zh, es |
111
111
  | `ucla-ls3` | UCLA Loneliness Scale (Version 3) | loneliness | 20 | Sum 20–80, 9 reverse-keyed items, no bands² | en, tr, de, zh, es |
112
112
  | `cbi` | Copenhagen Burnout Inventory (CBI) | burnout | 19 | Three scales scored separately, sums; published score is the mean on 0–100, no bands² | en, tr, de, zh, es |
113
+ | `pc-ptsd-5` | Primary Care PTSD Screen for DSM-5 (PC-PTSD-5) | post-traumatic-stress | 1 + 5 | Lifetime trauma-exposure question gating 5 yes/no items; count of yes 0–5, no bands² | en, tr, de, zh, es |
114
+ | `phq4` | Patient Health Questionnaire-4 (anxiety and depression) | depression, anxiety | 4 | GAD-2 and PHQ-2 subscales (0–6, positive at ≥3) plus the 0–12 total, total unbanded³ | en, tr, de, zh, es |
115
+ | `phq8` | Patient Health Questionnaire-8 (PHQ-9 without the self-harm item) | depression | 8 | Sum 0–24, PHQ-9 cutpoints (5, 10, 15, 20), no suicidality flag | en, tr, de, zh, es |
116
+ | `gds15` | Geriatric Depression Scale, short form (GDS-15) | depression | 15 | Yes/no, 1 point per depressive answer (5 keyed on no), 0–15; >5 suggestive, >10 almost always depression | en, tr, de, zh, es |
117
+ | `tipi` | Ten-Item Personality Inventory (TIPI) | personality | 10 | 5 Big Five scales × 2 items (2–14 each), one reverse-keyed item per scale, no cutoffs | en, tr, de, zh, es |
113
118
 
114
119
  ¹ 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. `asrs6` is free to ship, commercially included, but its license makes attribution mandatory: render `meta.attribution` wherever it appears. `eat26` is free for individual use but a **commercial web platform that charges user fees needs a licensing agreement** from its copyright holder — read its section in [SOURCES.md](SOURCES.md) before you build one. `cbi` has the thinnest licensing record of anything bundled — its steward publishes it openly but its rights holders have never granted anything in writing; read its section too.
115
120
 
116
- ² `pcl5`, `ucla-ls3` and `cbi` ship no severity bands, because their rights holders publish none to ship: the VA offers a cutoff *range* (31–33) it describes as initial research, Russell scores the loneliness scale continuously, and the CBI's authors publish population norms rather than thresholds. Each records what is published in `meta.scoringNote` so you can apply your own threshold. Note also that `csi16` runs the opposite way to every other inventory here — a high score is a good result — so do not wire it to a shared "higher is worse" display.
121
+ ² `pcl5`, `ucla-ls3`, `cbi` and `pc-ptsd-5` ship no severity bands, because their rights holders publish none to ship: the VA offers a PCL-5 cutoff *range* (31–33) it describes as initial research and tells PC-PTSD-5 users to choose a cut-point for their own sample, Russell scores the loneliness scale continuously, and the CBI's authors publish population norms rather than thresholds. Each records what is published in `meta.scoringNote` so you can apply your own threshold. Note also that `csi16` runs the opposite way to every other inventory here — a high score is a good result — so do not wire it to a shared "higher is worse" display. `pc-ptsd-5` opens with a trauma-exposure question that gates the five symptom items; psytools scores a "no" correctly as 0 but cannot hide the items for you, so show them only after a "yes" (see `meta.renderingNote`).
122
+
123
+ ³ The PHQ-4 total-score categories that circulate (0–2, 3–5, 6–8, 9–12) could not be checked against the rights holder's manual or the validation paper, so the total ships unbanded; its two subscales carry the manual's cutpoint of 3. See [SOURCES.md](SOURCES.md).
117
124
 
118
125
  ```ts
119
126
  import { loadInventory, inventories, dass21 } from "psytools";
@@ -237,7 +244,7 @@ scoring: {
237
244
 
238
245
  `ignore` sums what is answered (partial totals understate severity — use deliberately); `prorate` scales the raw score up to the full item count (rounded) and refuses to score below `minAnswered`; `require-complete` throws unless every contributing non-optional item is answered. For subscale scoring the policy applies to each subscale independently.
239
246
 
240
- The bundled inventories ship with policies (PHQ-9/GAD-7/DASS-21 and the five IPIP inventories prorate with thresholds, WHO-5/ASRS/AQ-10/CSI-16 require-complete, AUDIT ignores to match its skip logic, PHQ-15 ignores because its item 4 is marked women-only on the instrument) — see [SOURCES.md](SOURCES.md#missing-data-policies) for the rationale and how to override.
247
+ The bundled inventories ship with policies (PHQ-9/GAD-7/DASS-21 and the five IPIP inventories prorate with thresholds, WHO-5/ASRS/AQ-10/CSI-16 require-complete, AUDIT ignores to match its skip logic, PHQ-15 ignores because its item 4 is marked women-only on the instrument, PC-PTSD-5 ignores because its symptom items are skipped after a "no" to the exposure question, GDS-15 prorates by its authors' own rule) — see [SOURCES.md](SOURCES.md#missing-data-policies) for the rationale and how to override.
241
248
 
242
249
  ## Custom evaluation
243
250
 
@@ -295,7 +302,7 @@ npm run build # ESM + CJS + type declarations into dist/
295
302
 
296
303
  - **Not a diagnostic tool.** Scores, severity bands, and flags implement the published scoring rules of screening instruments; they are not diagnoses and do not replace clinical judgment.
297
304
  - **Crisis-relevant answers.** PHQ-9 item 9 raises a `suicidality` flag — applications should surface this to a responsible clinician and provide crisis resources to respondents.
298
- - **Instrument licensing.** [SOURCES.md](SOURCES.md) records who holds the rights to each bundled instrument and flags it **Free** (PHQ-9, GAD-7, DASS-21, WHO-5, AUDIT, CES-D, K10, K6, and the five IPIP inventories — usable without permission, including commercially), **Free with conditions** (ASRS screener, AQ-10, SWLS, Flourishing Scale, RSES — free as distributed, but the conditions differ per instrument: the ASRS screener requires attribution, the AQ-10's commercial terms are unstated), or **Research only** (ECR-R, ERQ, HSPS — not licensed for clinical products or personnel selection). Each inventory's `meta.licenseFlag` carries the flag programmatically; read the instrument's section before shipping it.
305
+ - **Instrument licensing.** [SOURCES.md](SOURCES.md) records who holds the rights to each bundled instrument and flags it **Free** (PHQ-9, GAD-7, DASS-21, WHO-5, AUDIT, CES-D, K10, K6, the five IPIP inventories, PC-PTSD-5, PHQ-4, PHQ-8, GDS-15 and TIPI — usable without permission, including commercially), **Free with conditions** (ASRS screener, AQ-10, SWLS, Flourishing Scale, RSES — free as distributed, but the conditions differ per instrument: the ASRS screener requires attribution, the AQ-10's commercial terms are unstated), or **Research only** (ECR-R, ERQ, HSPS — not licensed for clinical products or personnel selection). Each inventory's `meta.licenseFlag` carries the flag programmatically; read the instrument's section before shipping it.
299
306
  - **Required attribution.** Where a license fixes the exact credit line that must be displayed, the inventory carries it verbatim in `meta.attribution` — render it wherever the instrument or its results appear. Today only `asrs6` sets it (© New York University and the President and Fellows of Harvard College). It is deliberately separate from `meta.reference`, which is the scientific citation: an academic reference is not a copyright attribution, and only one of the two is a license obligation.
300
307
  - **Translation provenance.** English texts are reproduced from the original instruments. Turkish, German, Simplified Chinese, and Spanish texts are AI translations (Anthropic Claude — the exact model is named per inventory in `meta.translationProvenance`) of the original English — official translations were **not** consulted and the texts are unverified. This status is documentation-only: psytools does not track or expose per-pack verification programmatically (no `verified` field, no gating option, no status API) — read [SOURCES.md](SOURCES.md) and decide for yourself whether the bundled wording is fit for your use case. If it isn't for a specific item, use [local overrides](#local-translation-overrides) rather than forking the package. Obtain and compare the official version for your language before clinical use. Corrections: <samed@luckys.dev>.
301
308
 
@@ -303,9 +310,9 @@ npm run build # ESM + CJS + type declarations into dist/
303
310
 
304
311
  The code is MIT — Samed Kahyaoglu, 2026. See [LICENSE](LICENSE).
305
312
 
306
- The bundled instrument text is a separate matter: each of the twenty-one instruments is licensed by its own rights holder, on terms that differ instrument to instrument. The quick answer:
313
+ The bundled instrument text is a separate matter: each of the thirty-two instruments is licensed by its own rights holder, on terms that differ instrument to instrument. The quick answer:
307
314
 
308
- - **Thirteen ship free, including in commercial products, no permission needed:** PHQ-9, GAD-7, DASS-21, WHO-5, AUDIT, CES-D, K10, K6, and the five International Personality Item Pool inventories — Mini-IPIP, Mini-IPIP6, IPIP BIS/BAS, IPIP-NEO-60, IPIP-VIA-R. The IPIP five carry the least conditional terms in the package: "Because the IPIP has been placed in the public domain, permission has already been automatically granted for any person to use IPIP items, scales, and inventories for any purpose, commercial or non-commercial" — no attribution required, no one to ask.
315
+ - **Eighteen ship free, including in commercial products, no permission needed:** PHQ-9, GAD-7, DASS-21, WHO-5, AUDIT, CES-D, K10, K6, PC-PTSD-5, PHQ-4, PHQ-8, GDS-15, TIPI, and the five International Personality Item Pool inventories — Mini-IPIP, Mini-IPIP6, IPIP BIS/BAS, IPIP-NEO-60, IPIP-VIA-R. The IPIP five carry the least conditional terms in the package: "Because the IPIP has been placed in the public domain, permission has already been automatically granted for any person to use IPIP items, scales, and inventories for any purpose, commercial or non-commercial" — no attribution required, no one to ask.
309
316
  - **The ASRS-v1.1 screener (`asrs6`) ships free, including commercially, with one mandatory condition — attribution.** Render the credit line psytools ships in `meta.attribution` wherever the screener or its results appear.
310
317
  - **Three ship for non-commercial research only: ECR-R, ERQ, and HSPS.** Commercial use of any of these needs permission directly from that instrument's own rights holder (R. C. Fraley for the ECR-R; the Stanford Psychophysiology Laboratory for the ERQ; Elaine Aron for the HSPS) — that permission is theirs to give, not psytools'.
311
318
  - **AQ-10, RSES, SWLS, and the Flourishing Scale ship free with conditions of their own, and the conditions aren't uniform.** AQ-10's and RSES's rights holders haven't addressed commercial use (confirm with them before shipping commercially). SWLS's and the Flourishing Scale's rights holder (Ed Diener and co-authors) licenses them for non-commercial purposes only — treat those two like the research-only three for commercial shipping.
package/SOURCES.md CHANGED
@@ -24,7 +24,7 @@ The same provenance applies to every bundled inventory **except where an invento
24
24
  | zh | AI translation (Anthropic Claude) from the original English | No |
25
25
  | es | AI translation (Anthropic Claude) from the original English | No |
26
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, `claude-opus-5` for the IPIP batch and the 2026-07 coverage wave).
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, `claude-opus-5` for the IPIP batch and the 2026-07 coverage wave, `claude-opus-5-5` for the 2026-11 free-screeners wave).
28
28
 
29
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.
30
30
 
@@ -73,6 +73,11 @@ Bundled inventories ship with declarative missing-data policies (`scoring.missin
73
73
  | `csi16` | require-complete | The authors' scoring instruction is a plain sum over all sixteen items, and their 51.5 cutoff is calibrated to the full 0–81 range. No prorating rule is published, and inventing one would move a clinical threshold |
74
74
  | `ucla-ls3` | prorate, ≥16 of 20 | Common research practice (≈80% completion); the score is continuous with no cutoff, so prorating carries no risk of tipping a respondent across a threshold |
75
75
  | `cbi` | prorate, ≥4 per scale | The authors' own rule is 3 of 6 (personal), 4 of 7 (work), 3 of 6 (client). One policy cannot carry three thresholds, so it is pinned to the strictest — stricter than the authors on the two 6-item scales, which fails safe. Prorating is the authors' method: their score is the mean of the answered items |
76
+ | `pc-ptsd-5` | ignore | The five symptom items are gated: a respondent who denies trauma exposure stops after the first question, and the VA scores that response 0. The symptom items are therefore `optional`, and an unanswered one contributes 0. Prorating would be wrong for the same reason it is wrong for `phq15`. The usual `ignore` caveat applies to an accidental skip after a "yes" |
77
+ | `phq4` | require-complete | Each subscale has two items, so one missing answer removes half of it, and the cutpoint of 3 is undefined for a single item |
78
+ | `phq8` | prorate, ≥6 of 8 answered | Common research practice (75% completion), the same rate as `phq9` |
79
+ | `gds15` | prorate, ≥10 of 15 answered | The authors' own rule: prorate the answered items to 15, and treat more than 5 missing as invalid (<https://web.stanford.edu/~yesavage/GDS.html>). They round a fractional result up; psytools rounds to the nearest integer, so a .5 lands the same way and anything else may land one point lower |
80
+ | `tipi` | require-complete | Two items per scale; a score from one item is not the instrument's score |
76
81
 
77
82
  ## PHQ-9 — Patient Health Questionnaire-9 (`phq9`)
78
83
 
@@ -345,6 +350,58 @@ Set against it, without contradicting it: HealthMeasures lists Russell and the U
345
350
  - **The authors ask that the items not be presented in the printed order**, and say they may be interleaved with questions on other topics, to avoid stereotyped response patterns. psytools keeps the published order so the definition stays checkable against the source — shuffle at presentation time if you follow the recommendation.
346
351
  - **"Clients" is meant to be substituted.** The authors instruct that the term should match the setting — patients for nurses, students or children for teachers. The bundled instructions say so; the Turkish pack uses *danışan*, which is already the right word for a therapy setting.
347
352
 
353
+ ## PC-PTSD-5: Primary Care PTSD Screen for DSM-5 (`pc-ptsd-5`)
354
+
355
+ **License: Free.** The rights holder's own page states it in the same words as for the PCL-5: "This measure was developed by staff at VA's National Center for PTSD and is in the public domain and not copyrighted" (<https://www.ptsd.va.gov/professional/assessment/screens/pc-ptsd.asp>). English text transcribed from the VA's own PC-PTSD-5 form PDF (`pc-ptsd-5-v6.pdf`, version date 2022), page 2, the respondent form. The VA's page renders the same items with the same wording.
356
+
357
+ - **Citation:** 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>. Validation: Prins, A., Bovin, M. J., Smolenski, D. J., et al. (2016). The Primary Care PTSD Screen for DSM-5 (PC-PTSD-5): Development and evaluation within a Veteran primary care sample. *Journal of General Internal Medicine, 31*, 1206–1211.
358
+ - **Scoring:** count of "yes" answers to the five symptom items, 0–5, recall window one month. The form's lead question on lifetime trauma exposure is not scored.
359
+ - **How the exposure gate is represented.** On paper the form asks "Have you ever experienced this kind of event?" and then says "If no, screen total = 0. Please stop here. If yes, please answer the questions below." psytools has no conditional display, so the gate is modelled the way the CRAFFT analysis below works it out: the exposure question is a required, unscored question (`pc-ptsd-5-trauma`); the five symptom items are `optional`; the scoring is a `count` over the five symptom items only; the missing-data policy is `ignore`. A respondent who answers "no" and stops is scored 0, which is the VA's rule. What the model cannot do is enforce the gate: nothing stops a consumer showing the symptom items after a "no", or requires them after a "yes". `meta.renderingNote` says so next to the data. Show the symptom items only after a "yes".
360
+ - **Two rendering changes, both mechanical.** The form introduces the five symptom items with one lead-in, "In the past month, have you...", and prints each item as its continuation ("had nightmares about the event(s)..."). psytools has one instruction field and no section headings, so the lead-in is prepended to each item, giving self-contained questions ("In the past month, have you had nightmares about the event(s)..."); the item wording after the lead-in is unchanged and a test checks every item carries it. The six bulleted trauma examples are joined into one sentence, separated by semicolons, in `instructions`. The gate sentences stay with the exposure question, as on the form. The answer labels "YES" / "NO" are rendered "Yes" / "No".
361
+ - **No bands, following the PCL-5 precedent.** The VA reports that "a cut-point of 4 ideally balanced false negatives and false positives for the overall sample and for men," that for women the same cut-point "resulted in high numbers of false negatives," and that "clinicians should consider sample characteristics and screening purposes when selecting a cut-point." A cut-point the rights holder tells users to choose per setting is the same situation as the PCL-5's provisional range, so it is recorded in `meta.scoringNote` rather than encoded as a band. Apply your own cut-point over `score`.
362
+ - **A positive screen is not a diagnosis.** The VA writes that those screening positive "require further assessment," preferably with a structured interview, and names the bundled `pcl5` as the self-report follow-up.
363
+
364
+ ## PHQ-4: Patient Health Questionnaire for Depression and Anxiety (`phq4`)
365
+
366
+ **License: Free.** The same Pfizer grant as the bundled PHQ-9, GAD-7 and PHQ-15, read from three places: the screener page lists the PHQ-4 and says "no permission is required to reproduce, translate, display or distribute them" (<https://www.phqscreeners.com/select-screener>); the form's own footer reads "No permission required to reproduce, translate, display or distribute"; and the PHQ instruction manual lists the PHQ-4 in its Table 1 and says "All of the measures included in Table 1 are in the public domain."
367
+
368
+ - **Citation:** 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.
369
+ - **Item source:** Pfizer's own English PHQ-4 form, the file the screener page offers for "PHQ-4" / "English" (fetched 2026-11-21). Item order follows that form: the two GAD-2 items first, then the two PHQ-2 items. The wording matches the corresponding items of Pfizer's English GAD-7 and PHQ-9 forms word for word.
370
+ - **Scoring:** three scales over the same four answers, on the PHQ's 0–3 frequency scale: anxiety (GAD-2, items 1–2, 0–6), depression (PHQ-2, items 3–4, 0–6) and the total (0–12). The manual says of the two subscales that "the recommended cutpoints for each when used as screeners is a score of 3 or greater," and that such a score "should prompt administration of the full PHQ-9 and/or GAD-7, as well as a clinical interview." Both subscales are banded there.
371
+ - **The total has no bands, because they could not be verified.** Total-score categories of 0–2 normal, 3–5 mild, 6–8 moderate and 9–12 severe are reproduced widely and attributed to Kroenke et al. (2009). The PHQ manual does not give them, and the 2009 paper and the 2010 general-population validation (Löwe et al.) are both paywalled with no open copy, so the attribution could not be checked against either. This file only bundles cut-offs read from the rights holder or the validation paper, so the total ships as a score without bands. If your protocol uses those categories, apply them over the total's `score`.
372
+ - **Overlapping scales.** The `total` scale reuses the four items the two subscales already score. A consumer summing all three scales would count every answer twice; read the total from its own scale.
373
+
374
+ ## PHQ-8: Patient Health Questionnaire-8 (`phq8`)
375
+
376
+ **License: Free.** The same Pfizer grant and the same three sources as the PHQ-4 above: the screener page lists the PHQ-8, each PHQ-8 form carries the "No permission required to reproduce, translate, display or distribute" footer, and the manual's Table 1 lists it among the public-domain measures.
377
+
378
+ - **Citation:** 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.
379
+ - **Item source:** Pfizer's own PHQ-8 form, "English for Canada" (fetched 2026-11-21). The screener page offers PHQ-8 English forms only for Australia, Canada, Singapore and the UK, none labelled plain English. The Canada and Singapore forms are identical, and both match items 1–8 and the instruction line of Pfizer's English PHQ-9 form word for word, so this is the US wording without item 9. The UK form differs by one character (a full stop for the question mark in item 8); the Australian form is a reworded adaptation.
380
+ - **Scoring:** sum 0–24 on the 0–3 frequency scale, past two weeks. The manual states "The PHQ-8 is scored just like the PHQ-9 and its total score ranges from 0 to 24. Cutpoints on the PHQ-8 are identical to the PHQ-9." The bands are therefore the PHQ-9's (5 mild, 10 moderate, 15 moderately severe, 20 severe), with the top band capped at 24. A score of 10 or more, the start of the moderate band, is the manual's "yellow flag" and the usual cut-point for current depression.
381
+ - **No self-harm item, so no flag.** The manual describes the PHQ-8 as "mainly used in non-depression research studies." Without item 9 it raises no `suicidality` flag. Do not use it where self-harm needs to be screened; use `phq9`.
382
+
383
+ ## GDS-15: Geriatric Depression Scale, short form (`gds15`)
384
+
385
+ **License: Free.** The authors' page states: "The original scale is in the public domain due to it being partly the result of Federal support" (J. A. Yesavage, <https://web.stanford.edu/~yesavage/GDS.html>). The same page links the short form under "Original English Forms", offers it free in the authors' own apps, and invites anyone to submit translations for posting.
386
+
387
+ **How that statement is read for the short form.** "The original scale" could mean the original English text as opposed to the translations listed below it, or the original 30-item long form as opposed to the 15-item short form. The page itself supports the first reading: it files the short form under "Original English Forms", and nothing on the page treats the short form differently from the long form. The short form was developed by the same group (Sheikh and Yesavage, at Stanford and the VA Palo Alto). We read the statement as covering it, flag it `free`, and record the reading here so you can weigh it yourself.
388
+
389
+ - **Citation:** Sheikh, J. I., & Yesavage, J. A. (1986). Geriatric Depression Scale (GDS): Recent evidence and development of a shorter version. In *Clinical Gerontology: A Guide to Assessment and Intervention* (pp. 165–173). New York: The Haworth Press. Original scale: Yesavage, J. A., Brink, T. L., Rose, T. L., et al. (1983). Development and validation of a geriatric depression screening scale: A preliminary report. *Journal of Psychiatric Research, 17*, 37–49.
390
+ - **Item source:** the authors' "Short Form English" page (<https://web.stanford.edu/~yesavage/GDS.english.short.html>), fetched 2026-11-21. The page is headed "MOOD SCALE (short form)"; psytools titles it by the scale's published name instead.
391
+ - **Scoring:** 15 yes/no items about the past week, one point per answer in the depressive direction, total 0–15. The keys come from the authors' "Short Form English Scoring" page (<https://web.stanford.edu/~yesavage/GDS.english.short.score.html>), which prints the depressive answer in bold: "no" on items 1, 5, 7, 11 and 13, "yes" on the other ten. In psytools "Yes" stores 1 and "No" stores 0, and the five "no"-keyed items are `reverseScored`; a test pins the five.
392
+ - **Bands come from the authors' scoring page:** "for clinical purposes a score > 5 points is suggestive of depression and should warrent a follow-up interview. Scores > 10 are almost always depression." The bands split there: 0–5, 6–10, 11–15. The same sentence opens with "Although differing sensitivities and specificities have been obtained across studies," and the authors' main page calls the GDS "really a screening measure", so read the bands as the authors' clinical rule of thumb, not as a diagnosis.
393
+ - **Audience:** `audience: ["adult"]`. The scale is written and validated for older adults. psytools' audience vocabulary has no older-adult band, so it is filed with the adults and the title and description say what it is for.
394
+
395
+ ## TIPI: Ten-Item Personality Inventory (`tipi`)
396
+
397
+ **License: Free.** The author's page says, in capitals: "Want to use the TIPI? Go ahead. 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/>). There is no attribution condition and no commercial carve-out; like the IPIP grant, it is among the least conditional in this file.
398
+
399
+ - **Citation:** 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.
400
+ - **Item source:** the authors' TIPI form PDF, linked as "TIPI scale (pdf)" from the page above (PDF dated 2003, fetched 2026-11-21). The form's lead-in "I see myself as:" closes the `instructions`, and the items keep the form's wording, including the trailing full stop. The form's instruction to "write a number next to each statement" is reproduced verbatim even though a screen will use a control instead, following the PCL-5 precedent.
401
+ - **Scoring:** five scales of two items each on the 1–7 agreement scale, one reverse-keyed item per scale: extraversion 1, 6R; agreeableness 2R, 7; conscientiousness 3, 8R; emotional stability 4R, 9; openness to experiences 5, 10R (the key printed on the form, matching the author's page: "The reverse scored items are 2, 4, 6, 8, & 10"). psytools reports scale **sums** (2–14); the author's published score is the **mean** of the two items, so divide by 2. Emotional stability is the reverse pole of the neuroticism scale the IPIP inventories report.
402
+ - **No bands.** No cutoffs exist. The author publishes norms (Gosling, Rentfrow & Potter, 2014, on the page above) for comparison instead.
403
+ - **Low internal consistency is by design.** The author asks users to read his note on alpha reliability before using the TIPI: with two broad items per scale, alpha and factor structure look weak, and he points to test-retest reliability as the better index. Treat single-scale scores as indicative, the same caution recorded for `ipip-via-r`.
404
+
348
405
  ## Instruments evaluated and not bundled
349
406
 
350
407
  Instruments considered for inclusion and not shipped, each checked against the rights holder's own published terms. Recorded so the same ground is not covered twice. Six entries come from a sweep of widely used ADHD instruments (July 2026) and one from the 2026-07 coverage wave; five are blocked by their licensing and two are waiting on a permission request.
@@ -0,0 +1,11 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+ /**
3
+ * GDS-15: Geriatric Depression Scale, short form.
4
+ *
5
+ * 15 yes/no items about the past week, one point per answer in the
6
+ * depressive direction, total 0-15. "No" is the depressive answer on
7
+ * items 1, 5, 7, 11 and 13 (modelled as `reverseScored`), "yes" on the
8
+ * other ten. Bands follow the authors' own scoring page: more than 5
9
+ * suggests depression, more than 10 is almost always depression.
10
+ */
11
+ export declare const gds15: AssessmentDefinition;
@@ -0,0 +1,81 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.gds15 = void 0;
4
+ /** Yes/no, with "yes" scoring 1. Items keyed on "no" are `reverseScored`. */
5
+ const yesNoOptions = [
6
+ { value: 1, label: { en: "Yes" } },
7
+ { value: 0, label: { en: "No" } },
8
+ ];
9
+ /** Items where "no" is the answer that indicates depression. */
10
+ const keyedNo = new Set([1, 5, 7, 11, 13]);
11
+ const items = [
12
+ "Are you basically satisfied with your life?",
13
+ "Have you dropped many of your activities and interests?",
14
+ "Do you feel that your life is empty?",
15
+ "Do you often get bored?",
16
+ "Are you in good spirits most of the time?",
17
+ "Are you afraid that something bad is going to happen to you?",
18
+ "Do you feel happy most of the time?",
19
+ "Do you often feel helpless?",
20
+ "Do you prefer to stay at home, rather than going out and doing new things?",
21
+ "Do you feel you have more problems with memory than most?",
22
+ "Do you think it is wonderful to be alive now?",
23
+ "Do you feel pretty worthless the way you are now?",
24
+ "Do you feel full of energy?",
25
+ "Do you feel that your situation is hopeless?",
26
+ "Do you think that most people are better off than you are?",
27
+ ];
28
+ /**
29
+ * GDS-15: Geriatric Depression Scale, short form.
30
+ *
31
+ * 15 yes/no items about the past week, one point per answer in the
32
+ * depressive direction, total 0-15. "No" is the depressive answer on
33
+ * items 1, 5, 7, 11 and 13 (modelled as `reverseScored`), "yes" on the
34
+ * other ten. Bands follow the authors' own scoring page: more than 5
35
+ * suggests depression, more than 10 is almost always depression.
36
+ */
37
+ exports.gds15 = {
38
+ id: "gds15",
39
+ version: "1.0.0",
40
+ categories: ["depression"],
41
+ audience: ["adult"],
42
+ respondent: "self",
43
+ title: {
44
+ en: "Geriatric Depression Scale, Short Form (GDS-15)",
45
+ },
46
+ description: {
47
+ en: "A 15-item yes/no screening scale for depression in older adults.",
48
+ },
49
+ instructions: {
50
+ en: "Choose the best answer for how you have felt over the past week:",
51
+ },
52
+ defaultLocale: "en",
53
+ options: yesNoOptions,
54
+ questions: items.map((text, i) => ({
55
+ id: `gds15-${i + 1}`,
56
+ text: { en: text },
57
+ ...(keyedNo.has(i + 1) ? { reverseScored: true } : {}),
58
+ })),
59
+ scoring: {
60
+ kind: "sum",
61
+ missing: { strategy: "prorate", minAnswered: 10 },
62
+ bands: [
63
+ { id: "below-cutoff", min: 0, max: 5, label: { en: "Below the follow-up threshold" } },
64
+ {
65
+ id: "suggestive",
66
+ min: 6,
67
+ max: 10,
68
+ label: { en: "Suggestive of depression: a follow-up interview is warranted" },
69
+ },
70
+ { id: "likely", min: 11, max: 15, label: { en: "Almost always depression" } },
71
+ ],
72
+ },
73
+ meta: {
74
+ reference: "Sheikh, J. I., & Yesavage, J. A. (1986). Geriatric Depression Scale (GDS): Recent evidence and development of a shorter version. In Clinical Gerontology: A Guide to Assessment and Intervention (pp. 165-173). New York: The Haworth Press.",
75
+ license: "Free: \"The original scale is in the public domain due to it being partly the result of Federal support\" (J. A. Yesavage, https://web.stanford.edu/~yesavage/GDS.html). See SOURCES.md for how this statement is read for the short form.",
76
+ licenseFlag: "free",
77
+ translationProvenance: "en: transcribed from the authors' \"Short Form English\" page, https://web.stanford.edu/~yesavage/GDS.english.short.html, with the keyed answers taken from \"Short Form English Scoring\", https://web.stanford.edu/~yesavage/GDS.english.short.score.html (fetched 2026-11-21). Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-opus-5-5) from the original English; the translations listed on the authors' page were not consulted and the texts are unverified. See SOURCES.md.",
78
+ timeframe: "past week",
79
+ scoringNote: "Sum 0-15, one point per answer in the depressive direction: \"no\" on items 1, 5, 7, 11, 13 and \"yes\" on the rest. Bands follow the authors' scoring page: \"for clinical purposes a score > 5 points is suggestive of depression and should warrent a follow-up interview. Scores > 10 are almost always depression.\" The same page notes that sensitivity and specificity differ across studies. Missing data: the authors prorate (score x 15 / answered) and would treat more than 5 missing items as invalid, so at least 10 answers are required; they round a fractional result up, while psytools rounds to the nearest integer.",
80
+ },
81
+ };
@@ -27,13 +27,19 @@ import { eat26 } from "./eat26.ts";
27
27
  import { csi16 } from "./csi16.ts";
28
28
  import { uclaLs3 } from "./ucla-ls3.ts";
29
29
  import { cbi } from "./cbi.ts";
30
+ import { pcPtsd5 } from "./pc-ptsd-5.ts";
31
+ import { phq4 } from "./phq4.ts";
32
+ import { phq8 } from "./phq8.ts";
33
+ import { gds15 } from "./gds15.ts";
34
+ import { tipi } from "./tipi.ts";
30
35
  export { phq9, gad7, dass21, who5, asrs6, aq10, audit, miniIpip, cesd, ecrR, erq, hsps, swls, flourishing, k10, k6, rses };
31
36
  export { miniIpip6, bisBas, ipipNeo60, ipipViaR };
32
37
  export { phq15, pcl5, eat26, csi16, uclaLs3, cbi };
38
+ export { pcPtsd5, phq4, phq8, gds15, tipi };
33
39
  export { twoWeekFrequencyOptions, twoWeekInstructions } from "./common.ts";
34
40
  /** All predefined inventory definitions shipped with psytools, by id. */
35
41
  export declare const inventories: Readonly<Record<string, AssessmentDefinition>>;
36
- export type InventoryId = "phq9" | "gad7" | "dass21" | "who5" | "asrs6" | "aq10" | "audit" | "mini-ipip" | "cesd" | "ecr-r" | "erq" | "hsps" | "swls" | "flourishing" | "k10" | "k6" | "rses" | "mini-ipip6" | "bis-bas" | "ipip-neo-60" | "ipip-via-r" | "phq15" | "pcl5" | "eat26" | "csi16" | "ucla-ls3" | "cbi";
42
+ export type InventoryId = "phq9" | "gad7" | "dass21" | "who5" | "asrs6" | "aq10" | "audit" | "mini-ipip" | "cesd" | "ecr-r" | "erq" | "hsps" | "swls" | "flourishing" | "k10" | "k6" | "rses" | "mini-ipip6" | "bis-bas" | "ipip-neo-60" | "ipip-via-r" | "phq15" | "pcl5" | "eat26" | "csi16" | "ucla-ls3" | "cbi" | "pc-ptsd-5" | "phq4" | "phq8" | "gds15" | "tipi";
37
43
  /**
38
44
  * Instantiates a predefined inventory as an `Assessment`.
39
45
  *
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.inventories = exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.cbi = exports.uclaLs3 = exports.csi16 = exports.eat26 = exports.pcl5 = exports.phq15 = exports.ipipViaR = exports.ipipNeo60 = exports.bisBas = exports.miniIpip6 = 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 = void 0;
3
+ exports.inventories = exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.tipi = exports.gds15 = exports.phq8 = exports.phq4 = exports.pcPtsd5 = exports.cbi = exports.uclaLs3 = exports.csi16 = exports.eat26 = exports.pcl5 = exports.phq15 = exports.ipipViaR = exports.ipipNeo60 = exports.bisBas = exports.miniIpip6 = 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 = void 0;
4
4
  exports.loadInventory = loadInventory;
5
5
  const assessment_ts_1 = require("../assessment.js");
6
6
  const errors_ts_1 = require("../errors.js");
@@ -60,6 +60,16 @@ const ucla_ls3_ts_1 = require("./ucla-ls3.js");
60
60
  Object.defineProperty(exports, "uclaLs3", { enumerable: true, get: function () { return ucla_ls3_ts_1.uclaLs3; } });
61
61
  const cbi_ts_1 = require("./cbi.js");
62
62
  Object.defineProperty(exports, "cbi", { enumerable: true, get: function () { return cbi_ts_1.cbi; } });
63
+ const pc_ptsd_5_ts_1 = require("./pc-ptsd-5.js");
64
+ Object.defineProperty(exports, "pcPtsd5", { enumerable: true, get: function () { return pc_ptsd_5_ts_1.pcPtsd5; } });
65
+ const phq4_ts_1 = require("./phq4.js");
66
+ Object.defineProperty(exports, "phq4", { enumerable: true, get: function () { return phq4_ts_1.phq4; } });
67
+ const phq8_ts_1 = require("./phq8.js");
68
+ Object.defineProperty(exports, "phq8", { enumerable: true, get: function () { return phq8_ts_1.phq8; } });
69
+ const gds15_ts_1 = require("./gds15.js");
70
+ Object.defineProperty(exports, "gds15", { enumerable: true, get: function () { return gds15_ts_1.gds15; } });
71
+ const tipi_ts_1 = require("./tipi.js");
72
+ Object.defineProperty(exports, "tipi", { enumerable: true, get: function () { return tipi_ts_1.tipi; } });
63
73
  var common_ts_1 = require("./common.js");
64
74
  Object.defineProperty(exports, "twoWeekFrequencyOptions", { enumerable: true, get: function () { return common_ts_1.twoWeekFrequencyOptions; } });
65
75
  Object.defineProperty(exports, "twoWeekInstructions", { enumerable: true, get: function () { return common_ts_1.twoWeekInstructions; } });
@@ -92,6 +102,11 @@ exports.inventories = {
92
102
  csi16: csi16_ts_1.csi16,
93
103
  "ucla-ls3": ucla_ls3_ts_1.uclaLs3,
94
104
  cbi: cbi_ts_1.cbi,
105
+ "pc-ptsd-5": pc_ptsd_5_ts_1.pcPtsd5,
106
+ phq4: phq4_ts_1.phq4,
107
+ phq8: phq8_ts_1.phq8,
108
+ gds15: gds15_ts_1.gds15,
109
+ tipi: tipi_ts_1.tipi,
95
110
  };
96
111
  /**
97
112
  * Instantiates a predefined inventory as an `Assessment`.
@@ -0,0 +1,12 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+ /**
3
+ * PC-PTSD-5: Primary Care PTSD Screen for DSM-5.
4
+ *
5
+ * A lifetime trauma-exposure question followed by five yes/no symptom
6
+ * items about the past month. The score is the count of "yes" answers to
7
+ * the five symptom items (0-5); the exposure question gates them and is
8
+ * not scored. Developed by staff at the VA's National Center for PTSD,
9
+ * public domain. No bands: the VA's cut-point of 4 is explicitly
10
+ * sample-dependent, see `meta.scoringNote`.
11
+ */
12
+ export declare const pcPtsd5: AssessmentDefinition;
@@ -0,0 +1,91 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.pcPtsd5 = void 0;
4
+ /** The yes/no answer scale of the PC-PTSD-5. A "yes" scores 1. */
5
+ const yesNoOptions = [
6
+ { value: 1, label: { en: "Yes" } },
7
+ { value: 0, label: { en: "No" } },
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
+ * PC-PTSD-5: Primary Care PTSD Screen for DSM-5.
13
+ *
14
+ * A lifetime trauma-exposure question followed by five yes/no symptom
15
+ * items about the past month. The score is the count of "yes" answers to
16
+ * the five symptom items (0-5); the exposure question gates them and is
17
+ * not scored. Developed by staff at the VA's National Center for PTSD,
18
+ * public domain. No bands: the VA's cut-point of 4 is explicitly
19
+ * sample-dependent, see `meta.scoringNote`.
20
+ */
21
+ exports.pcPtsd5 = {
22
+ id: "pc-ptsd-5",
23
+ version: "1.0.0",
24
+ categories: ["post-traumatic-stress"],
25
+ audience: ["adult"],
26
+ respondent: "self",
27
+ title: {
28
+ en: "Primary Care PTSD Screen for DSM-5 (PC-PTSD-5)",
29
+ },
30
+ description: {
31
+ 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.",
32
+ },
33
+ instructions: {
34
+ 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.",
35
+ },
36
+ defaultLocale: "en",
37
+ options: yesNoOptions,
38
+ questions: [
39
+ {
40
+ id: "pc-ptsd-5-trauma",
41
+ text: {
42
+ en: "Have you ever experienced this kind of event? If no, screen total = 0. Please stop here. If yes, please answer the questions below.",
43
+ },
44
+ },
45
+ {
46
+ id: "pc-ptsd-5-1",
47
+ text: {
48
+ en: `${leadIn} had nightmares about the event(s) or thought about the event(s) when you did not want to?`,
49
+ },
50
+ optional: true,
51
+ },
52
+ {
53
+ id: "pc-ptsd-5-2",
54
+ text: {
55
+ 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)?`,
56
+ },
57
+ optional: true,
58
+ },
59
+ {
60
+ id: "pc-ptsd-5-3",
61
+ text: { en: `${leadIn} been constantly on guard, watchful, or easily startled?` },
62
+ optional: true,
63
+ },
64
+ {
65
+ id: "pc-ptsd-5-4",
66
+ text: { en: `${leadIn} felt numb or detached from people, activities, or your surroundings?` },
67
+ optional: true,
68
+ },
69
+ {
70
+ id: "pc-ptsd-5-5",
71
+ text: {
72
+ 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?`,
73
+ },
74
+ optional: true,
75
+ },
76
+ ],
77
+ scoring: {
78
+ kind: "count",
79
+ missing: { strategy: "ignore" },
80
+ items: [1, 2, 3, 4, 5].map((n) => ({ questionId: `pc-ptsd-5-${n}`, minValue: 1 })),
81
+ },
82
+ meta: {
83
+ reference: "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",
84
+ license: "Free: developed by staff at the VA's National Center for PTSD, in the public domain and not copyrighted",
85
+ licenseFlag: "free",
86
+ translationProvenance: "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.",
87
+ timeframe: "exposure: lifetime; symptoms: past month",
88
+ scoringNote: "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`.",
89
+ renderingNote: "Show pc-ptsd-5-trauma first. Show pc-ptsd-5-1 to pc-ptsd-5-5 only when it is answered \"yes\" (value 1).",
90
+ },
91
+ };
@@ -0,0 +1,11 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+ /**
3
+ * PHQ-4: Patient Health Questionnaire for Depression and Anxiety.
4
+ *
5
+ * 4 items on the 0-3 frequency scale: the GAD-2 (items 1-2) and the PHQ-2
6
+ * (items 3-4), in the order Pfizer's own PHQ-4 form prints them. Scored
7
+ * as three scales: anxiety (0-6), depression (0-6) and the total (0-12).
8
+ * The two subscales carry the PHQ manual's screening cutpoint of 3; the
9
+ * total carries no bands, see `meta.scoringNote`.
10
+ */
11
+ export declare const phq4: AssessmentDefinition;
@@ -0,0 +1,73 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.phq4 = void 0;
4
+ const common_ts_1 = require("./common.js");
5
+ /** Bands shared by both 2-item subscales: the manual's cutpoint of 3. */
6
+ const screenBands = (followUp) => [
7
+ { id: "below-cutoff", min: 0, max: 2, label: { en: "Below the screening cutpoint" } },
8
+ { id: "positive", min: 3, max: 6, label: { en: `Positive screen: follow up with ${followUp}` } },
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
+ exports.phq4 = {
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: common_ts_1.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: "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.",
67
+ license: "Free: no permission required to reproduce, translate, display or distribute (Pfizer educational grant)",
68
+ licenseFlag: "free",
69
+ translationProvenance: "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.",
70
+ timeframe: "past 2 weeks",
71
+ scoringNote: "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.",
72
+ },
73
+ };
@@ -0,0 +1,11 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+ /**
3
+ * PHQ-8: Patient Health Questionnaire-8 (depression severity).
4
+ *
5
+ * The PHQ-9 without item 9 (self-harm): 8 items on the 0-3 frequency
6
+ * scale, total 0-24. The PHQ manual states that the PHQ-8 "is scored just
7
+ * like the PHQ-9" and that its cutpoints "are identical to the PHQ-9", so
8
+ * the bands are the PHQ-9's, capped at 24. Same Pfizer grant as the
9
+ * bundled PHQ-9.
10
+ */
11
+ export declare const phq8: AssessmentDefinition;
@@ -0,0 +1,71 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.phq8 = void 0;
4
+ const common_ts_1 = require("./common.js");
5
+ /**
6
+ * PHQ-8: Patient Health Questionnaire-8 (depression severity).
7
+ *
8
+ * The PHQ-9 without item 9 (self-harm): 8 items on the 0-3 frequency
9
+ * scale, total 0-24. The PHQ manual states that the PHQ-8 "is scored just
10
+ * like the PHQ-9" and that its cutpoints "are identical to the PHQ-9", so
11
+ * the bands are the PHQ-9's, capped at 24. Same Pfizer grant as the
12
+ * bundled PHQ-9.
13
+ */
14
+ exports.phq8 = {
15
+ id: "phq8",
16
+ version: "1.0.0",
17
+ categories: ["depression"],
18
+ audience: ["adult"],
19
+ respondent: "self",
20
+ title: {
21
+ en: "Patient Health Questionnaire-8 (PHQ-8)",
22
+ },
23
+ description: {
24
+ en: "An 8-item self-report measure of depression severity: the PHQ-9 without its item on thoughts of self-harm.",
25
+ },
26
+ instructions: common_ts_1.twoWeekInstructions,
27
+ defaultLocale: "en",
28
+ options: common_ts_1.twoWeekFrequencyOptions,
29
+ questions: [
30
+ { id: "phq8-1", text: { en: "Little interest or pleasure in doing things" } },
31
+ { id: "phq8-2", text: { en: "Feeling down, depressed, or hopeless" } },
32
+ { id: "phq8-3", text: { en: "Trouble falling or staying asleep, or sleeping too much" } },
33
+ { id: "phq8-4", text: { en: "Feeling tired or having little energy" } },
34
+ { id: "phq8-5", text: { en: "Poor appetite or overeating" } },
35
+ {
36
+ id: "phq8-6",
37
+ text: {
38
+ en: "Feeling bad about yourself — or that you are a failure or have let yourself or your family down",
39
+ },
40
+ },
41
+ {
42
+ id: "phq8-7",
43
+ text: { en: "Trouble concentrating on things, such as reading the newspaper or watching television" },
44
+ },
45
+ {
46
+ id: "phq8-8",
47
+ text: {
48
+ 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",
49
+ },
50
+ },
51
+ ],
52
+ scoring: {
53
+ kind: "sum",
54
+ missing: { strategy: "prorate", minAnswered: 6 },
55
+ bands: [
56
+ { id: "minimal", min: 0, max: 4, label: { en: "Minimal depression" } },
57
+ { id: "mild", min: 5, max: 9, label: { en: "Mild depression" } },
58
+ { id: "moderate", min: 10, max: 14, label: { en: "Moderate depression" } },
59
+ { id: "moderately-severe", min: 15, max: 19, label: { en: "Moderately severe depression" } },
60
+ { id: "severe", min: 20, max: 24, label: { en: "Severe depression" } },
61
+ ],
62
+ },
63
+ meta: {
64
+ reference: "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: "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.",
68
+ timeframe: "past 2 weeks",
69
+ scoringNote: "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.",
70
+ },
71
+ };