psytools 0.6.1 → 0.6.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.
- package/LICENSE +8 -5
- package/README.md +23 -9
- package/SOURCES.md +164 -4
- package/dist/cjs/inventories/bis-bas.d.ts +17 -0
- package/dist/cjs/inventories/bis-bas.js +118 -0
- package/dist/cjs/inventories/cbi.d.ts +31 -0
- package/dist/cjs/inventories/cbi.js +122 -0
- package/dist/cjs/inventories/common.d.ts +8 -0
- package/dist/cjs/inventories/common.js +17 -1
- package/dist/cjs/inventories/csi16.d.ts +10 -0
- package/dist/cjs/inventories/csi16.js +160 -0
- package/dist/cjs/inventories/eat26.d.ts +12 -0
- package/dist/cjs/inventories/eat26.js +111 -0
- package/dist/cjs/inventories/index.d.ts +13 -1
- package/dist/cjs/inventories/index.js +31 -1
- package/dist/cjs/inventories/ipip-neo-60.d.ts +18 -0
- package/dist/cjs/inventories/ipip-neo-60.js +157 -0
- package/dist/cjs/inventories/ipip-via-r.d.ts +17 -0
- package/dist/cjs/inventories/ipip-via-r.js +267 -0
- package/dist/cjs/inventories/mini-ipip.d.ts +1 -1
- package/dist/cjs/inventories/mini-ipip.js +4 -36
- package/dist/cjs/inventories/mini-ipip6.d.ts +16 -0
- package/dist/cjs/inventories/mini-ipip6.js +104 -0
- package/dist/cjs/inventories/pcl5.d.ts +10 -0
- package/dist/cjs/inventories/pcl5.js +124 -0
- package/dist/cjs/inventories/phq15.d.ts +10 -0
- package/dist/cjs/inventories/phq15.js +74 -0
- package/dist/cjs/inventories/ucla-ls3.d.ts +10 -0
- package/dist/cjs/inventories/ucla-ls3.js +127 -0
- package/dist/cjs/locales/de/bis-bas.d.ts +4 -0
- package/dist/cjs/locales/de/bis-bas.js +142 -0
- package/dist/cjs/locales/de/cbi.d.ts +7 -0
- package/dist/cjs/locales/de/cbi.js +110 -0
- package/dist/cjs/locales/de/csi16.d.ts +3 -0
- package/dist/cjs/locales/de/csi16.js +61 -0
- package/dist/cjs/locales/de/eat26.d.ts +3 -0
- package/dist/cjs/locales/de/eat26.js +47 -0
- package/dist/cjs/locales/de/ipip-neo-60.d.ts +4 -0
- package/dist/cjs/locales/de/ipip-neo-60.js +217 -0
- package/dist/cjs/locales/de/ipip-via-r.d.ts +4 -0
- package/dist/cjs/locales/de/ipip-via-r.js +382 -0
- package/dist/cjs/locales/de/mini-ipip6.d.ts +4 -0
- package/dist/cjs/locales/de/mini-ipip6.js +112 -0
- package/dist/cjs/locales/de/pcl5.d.ts +4 -0
- package/dist/cjs/locales/de/pcl5.js +48 -0
- package/dist/cjs/locales/de/phq15.d.ts +4 -0
- package/dist/cjs/locales/de/phq15.js +35 -0
- package/dist/cjs/locales/de/ucla-ls3.d.ts +4 -0
- package/dist/cjs/locales/de/ucla-ls3.js +48 -0
- package/dist/cjs/locales/es/bis-bas.d.ts +4 -0
- package/dist/cjs/locales/es/bis-bas.js +142 -0
- package/dist/cjs/locales/es/cbi.d.ts +7 -0
- package/dist/cjs/locales/es/cbi.js +110 -0
- package/dist/cjs/locales/es/csi16.d.ts +3 -0
- package/dist/cjs/locales/es/csi16.js +68 -0
- package/dist/cjs/locales/es/eat26.d.ts +3 -0
- package/dist/cjs/locales/es/eat26.js +47 -0
- package/dist/cjs/locales/es/ipip-neo-60.d.ts +4 -0
- package/dist/cjs/locales/es/ipip-neo-60.js +217 -0
- package/dist/cjs/locales/es/ipip-via-r.d.ts +4 -0
- package/dist/cjs/locales/es/ipip-via-r.js +382 -0
- package/dist/cjs/locales/es/mini-ipip6.d.ts +4 -0
- package/dist/cjs/locales/es/mini-ipip6.js +112 -0
- package/dist/cjs/locales/es/pcl5.d.ts +4 -0
- package/dist/cjs/locales/es/pcl5.js +48 -0
- package/dist/cjs/locales/es/phq15.d.ts +4 -0
- package/dist/cjs/locales/es/phq15.js +35 -0
- package/dist/cjs/locales/es/ucla-ls3.d.ts +4 -0
- package/dist/cjs/locales/es/ucla-ls3.js +44 -0
- package/dist/cjs/locales/index.js +60 -0
- package/dist/cjs/locales/tr/bis-bas.d.ts +4 -0
- package/dist/cjs/locales/tr/bis-bas.js +142 -0
- package/dist/cjs/locales/tr/cbi.d.ts +8 -0
- package/dist/cjs/locales/tr/cbi.js +111 -0
- package/dist/cjs/locales/tr/csi16.d.ts +3 -0
- package/dist/cjs/locales/tr/csi16.js +68 -0
- package/dist/cjs/locales/tr/eat26.d.ts +3 -0
- package/dist/cjs/locales/tr/eat26.js +47 -0
- package/dist/cjs/locales/tr/ipip-neo-60.d.ts +4 -0
- package/dist/cjs/locales/tr/ipip-neo-60.js +217 -0
- package/dist/cjs/locales/tr/ipip-via-r.d.ts +4 -0
- package/dist/cjs/locales/tr/ipip-via-r.js +382 -0
- package/dist/cjs/locales/tr/mini-ipip6.d.ts +4 -0
- package/dist/cjs/locales/tr/mini-ipip6.js +112 -0
- package/dist/cjs/locales/tr/pcl5.d.ts +4 -0
- package/dist/cjs/locales/tr/pcl5.js +48 -0
- package/dist/cjs/locales/tr/phq15.d.ts +4 -0
- package/dist/cjs/locales/tr/phq15.js +35 -0
- package/dist/cjs/locales/tr/ucla-ls3.d.ts +4 -0
- package/dist/cjs/locales/tr/ucla-ls3.js +44 -0
- package/dist/cjs/locales/zh/bis-bas.d.ts +4 -0
- package/dist/cjs/locales/zh/bis-bas.js +142 -0
- package/dist/cjs/locales/zh/cbi.d.ts +7 -0
- package/dist/cjs/locales/zh/cbi.js +110 -0
- package/dist/cjs/locales/zh/csi16.d.ts +3 -0
- package/dist/cjs/locales/zh/csi16.js +46 -0
- package/dist/cjs/locales/zh/eat26.d.ts +3 -0
- package/dist/cjs/locales/zh/eat26.js +45 -0
- package/dist/cjs/locales/zh/ipip-neo-60.d.ts +4 -0
- package/dist/cjs/locales/zh/ipip-neo-60.js +217 -0
- package/dist/cjs/locales/zh/ipip-via-r.d.ts +4 -0
- package/dist/cjs/locales/zh/ipip-via-r.js +382 -0
- package/dist/cjs/locales/zh/mini-ipip6.d.ts +4 -0
- package/dist/cjs/locales/zh/mini-ipip6.js +112 -0
- package/dist/cjs/locales/zh/pcl5.d.ts +4 -0
- package/dist/cjs/locales/zh/pcl5.js +44 -0
- package/dist/cjs/locales/zh/phq15.d.ts +4 -0
- package/dist/cjs/locales/zh/phq15.js +35 -0
- package/dist/cjs/locales/zh/ucla-ls3.d.ts +4 -0
- package/dist/cjs/locales/zh/ucla-ls3.js +34 -0
- package/dist/cjs/types.d.ts +13 -1
- package/dist/esm/inventories/bis-bas.d.ts +17 -0
- package/dist/esm/inventories/bis-bas.js +115 -0
- package/dist/esm/inventories/cbi.d.ts +31 -0
- package/dist/esm/inventories/cbi.js +119 -0
- package/dist/esm/inventories/common.d.ts +8 -0
- package/dist/esm/inventories/common.js +16 -0
- package/dist/esm/inventories/csi16.d.ts +10 -0
- package/dist/esm/inventories/csi16.js +157 -0
- package/dist/esm/inventories/eat26.d.ts +12 -0
- package/dist/esm/inventories/eat26.js +108 -0
- package/dist/esm/inventories/index.d.ts +13 -1
- package/dist/esm/inventories/index.js +22 -0
- package/dist/esm/inventories/ipip-neo-60.d.ts +18 -0
- package/dist/esm/inventories/ipip-neo-60.js +154 -0
- package/dist/esm/inventories/ipip-via-r.d.ts +17 -0
- package/dist/esm/inventories/ipip-via-r.js +264 -0
- package/dist/esm/inventories/mini-ipip.d.ts +1 -1
- package/dist/esm/inventories/mini-ipip.js +4 -36
- package/dist/esm/inventories/mini-ipip6.d.ts +16 -0
- package/dist/esm/inventories/mini-ipip6.js +101 -0
- package/dist/esm/inventories/pcl5.d.ts +10 -0
- package/dist/esm/inventories/pcl5.js +121 -0
- package/dist/esm/inventories/phq15.d.ts +10 -0
- package/dist/esm/inventories/phq15.js +71 -0
- package/dist/esm/inventories/ucla-ls3.d.ts +10 -0
- package/dist/esm/inventories/ucla-ls3.js +124 -0
- package/dist/esm/locales/de/bis-bas.d.ts +4 -0
- package/dist/esm/locales/de/bis-bas.js +140 -0
- package/dist/esm/locales/de/cbi.d.ts +7 -0
- package/dist/esm/locales/de/cbi.js +108 -0
- package/dist/esm/locales/de/csi16.d.ts +3 -0
- package/dist/esm/locales/de/csi16.js +59 -0
- package/dist/esm/locales/de/eat26.d.ts +3 -0
- package/dist/esm/locales/de/eat26.js +45 -0
- package/dist/esm/locales/de/ipip-neo-60.d.ts +4 -0
- package/dist/esm/locales/de/ipip-neo-60.js +215 -0
- package/dist/esm/locales/de/ipip-via-r.d.ts +4 -0
- package/dist/esm/locales/de/ipip-via-r.js +380 -0
- package/dist/esm/locales/de/mini-ipip6.d.ts +4 -0
- package/dist/esm/locales/de/mini-ipip6.js +110 -0
- package/dist/esm/locales/de/pcl5.d.ts +4 -0
- package/dist/esm/locales/de/pcl5.js +46 -0
- package/dist/esm/locales/de/phq15.d.ts +4 -0
- package/dist/esm/locales/de/phq15.js +33 -0
- package/dist/esm/locales/de/ucla-ls3.d.ts +4 -0
- package/dist/esm/locales/de/ucla-ls3.js +46 -0
- package/dist/esm/locales/es/bis-bas.d.ts +4 -0
- package/dist/esm/locales/es/bis-bas.js +140 -0
- package/dist/esm/locales/es/cbi.d.ts +7 -0
- package/dist/esm/locales/es/cbi.js +108 -0
- package/dist/esm/locales/es/csi16.d.ts +3 -0
- package/dist/esm/locales/es/csi16.js +66 -0
- package/dist/esm/locales/es/eat26.d.ts +3 -0
- package/dist/esm/locales/es/eat26.js +45 -0
- package/dist/esm/locales/es/ipip-neo-60.d.ts +4 -0
- package/dist/esm/locales/es/ipip-neo-60.js +215 -0
- package/dist/esm/locales/es/ipip-via-r.d.ts +4 -0
- package/dist/esm/locales/es/ipip-via-r.js +380 -0
- package/dist/esm/locales/es/mini-ipip6.d.ts +4 -0
- package/dist/esm/locales/es/mini-ipip6.js +110 -0
- package/dist/esm/locales/es/pcl5.d.ts +4 -0
- package/dist/esm/locales/es/pcl5.js +46 -0
- package/dist/esm/locales/es/phq15.d.ts +4 -0
- package/dist/esm/locales/es/phq15.js +33 -0
- package/dist/esm/locales/es/ucla-ls3.d.ts +4 -0
- package/dist/esm/locales/es/ucla-ls3.js +42 -0
- package/dist/esm/locales/index.js +60 -0
- package/dist/esm/locales/tr/bis-bas.d.ts +4 -0
- package/dist/esm/locales/tr/bis-bas.js +140 -0
- package/dist/esm/locales/tr/cbi.d.ts +8 -0
- package/dist/esm/locales/tr/cbi.js +109 -0
- package/dist/esm/locales/tr/csi16.d.ts +3 -0
- package/dist/esm/locales/tr/csi16.js +66 -0
- package/dist/esm/locales/tr/eat26.d.ts +3 -0
- package/dist/esm/locales/tr/eat26.js +45 -0
- package/dist/esm/locales/tr/ipip-neo-60.d.ts +4 -0
- package/dist/esm/locales/tr/ipip-neo-60.js +215 -0
- package/dist/esm/locales/tr/ipip-via-r.d.ts +4 -0
- package/dist/esm/locales/tr/ipip-via-r.js +380 -0
- package/dist/esm/locales/tr/mini-ipip6.d.ts +4 -0
- package/dist/esm/locales/tr/mini-ipip6.js +110 -0
- package/dist/esm/locales/tr/pcl5.d.ts +4 -0
- package/dist/esm/locales/tr/pcl5.js +46 -0
- package/dist/esm/locales/tr/phq15.d.ts +4 -0
- package/dist/esm/locales/tr/phq15.js +33 -0
- package/dist/esm/locales/tr/ucla-ls3.d.ts +4 -0
- package/dist/esm/locales/tr/ucla-ls3.js +42 -0
- package/dist/esm/locales/zh/bis-bas.d.ts +4 -0
- package/dist/esm/locales/zh/bis-bas.js +140 -0
- package/dist/esm/locales/zh/cbi.d.ts +7 -0
- package/dist/esm/locales/zh/cbi.js +108 -0
- package/dist/esm/locales/zh/csi16.d.ts +3 -0
- package/dist/esm/locales/zh/csi16.js +44 -0
- package/dist/esm/locales/zh/eat26.d.ts +3 -0
- package/dist/esm/locales/zh/eat26.js +43 -0
- package/dist/esm/locales/zh/ipip-neo-60.d.ts +4 -0
- package/dist/esm/locales/zh/ipip-neo-60.js +215 -0
- package/dist/esm/locales/zh/ipip-via-r.d.ts +4 -0
- package/dist/esm/locales/zh/ipip-via-r.js +380 -0
- package/dist/esm/locales/zh/mini-ipip6.d.ts +4 -0
- package/dist/esm/locales/zh/mini-ipip6.js +110 -0
- package/dist/esm/locales/zh/pcl5.d.ts +4 -0
- package/dist/esm/locales/zh/pcl5.js +42 -0
- package/dist/esm/locales/zh/phq15.d.ts +4 -0
- package/dist/esm/locales/zh/phq15.js +33 -0
- package/dist/esm/locales/zh/ucla-ls3.d.ts +4 -0
- package/dist/esm/locales/zh/ucla-ls3.js +32 -0
- package/dist/esm/types.d.ts +13 -1
- package/package.json +22 -3
- package/src/inventories/bis-bas.ts +122 -0
- package/src/inventories/cbi.ts +131 -0
- package/src/inventories/common.ts +18 -0
- package/src/inventories/csi16.ts +189 -0
- package/src/inventories/eat26.ts +118 -0
- package/src/inventories/index.ts +33 -1
- package/src/inventories/ipip-neo-60.ts +161 -0
- package/src/inventories/ipip-via-r.ts +271 -0
- package/src/inventories/mini-ipip.ts +4 -36
- package/src/inventories/mini-ipip6.ts +108 -0
- package/src/inventories/pcl5.ts +127 -0
- package/src/inventories/phq15.ts +77 -0
- package/src/inventories/ucla-ls3.ts +131 -0
- package/src/locales/de/bis-bas.ts +143 -0
- package/src/locales/de/cbi.ts +111 -0
- package/src/locales/de/csi16.ts +66 -0
- package/src/locales/de/eat26.ts +52 -0
- package/src/locales/de/ipip-neo-60.ts +218 -0
- package/src/locales/de/ipip-via-r.ts +383 -0
- package/src/locales/de/mini-ipip6.ts +113 -0
- package/src/locales/de/pcl5.ts +51 -0
- package/src/locales/de/phq15.ts +38 -0
- package/src/locales/de/ucla-ls3.ts +51 -0
- package/src/locales/es/bis-bas.ts +143 -0
- package/src/locales/es/cbi.ts +111 -0
- package/src/locales/es/csi16.ts +73 -0
- package/src/locales/es/eat26.ts +52 -0
- package/src/locales/es/ipip-neo-60.ts +218 -0
- package/src/locales/es/ipip-via-r.ts +383 -0
- package/src/locales/es/mini-ipip6.ts +113 -0
- package/src/locales/es/pcl5.ts +51 -0
- package/src/locales/es/phq15.ts +37 -0
- package/src/locales/es/ucla-ls3.ts +47 -0
- package/src/locales/index.ts +60 -0
- package/src/locales/tr/bis-bas.ts +143 -0
- package/src/locales/tr/cbi.ts +112 -0
- package/src/locales/tr/csi16.ts +73 -0
- package/src/locales/tr/eat26.ts +52 -0
- package/src/locales/tr/ipip-neo-60.ts +218 -0
- package/src/locales/tr/ipip-via-r.ts +383 -0
- package/src/locales/tr/mini-ipip6.ts +113 -0
- package/src/locales/tr/pcl5.ts +51 -0
- package/src/locales/tr/phq15.ts +37 -0
- package/src/locales/tr/ucla-ls3.ts +46 -0
- package/src/locales/zh/bis-bas.ts +143 -0
- package/src/locales/zh/cbi.ts +111 -0
- package/src/locales/zh/csi16.ts +51 -0
- package/src/locales/zh/eat26.ts +48 -0
- package/src/locales/zh/ipip-neo-60.ts +218 -0
- package/src/locales/zh/ipip-via-r.ts +383 -0
- package/src/locales/zh/mini-ipip6.ts +113 -0
- package/src/locales/zh/pcl5.ts +46 -0
- package/src/locales/zh/phq15.ts +36 -0
- package/src/locales/zh/ucla-ls3.ts +36 -0
- package/src/types.ts +14 -1
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
|
|
9
|
+
item wording, and answer-option labels of the twenty-seven 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
|
|
@@ -20,10 +20,13 @@ permission before commercial use: the ECR-R, the ERQ, and the HSPS,
|
|
|
20
20
|
which SOURCES.md tags "Research only," and the SWLS and the
|
|
21
21
|
Flourishing Scale, which SOURCES.md tags "Free with conditions" but
|
|
22
22
|
whose own terms are non-commercial-only — the same restriction in
|
|
23
|
-
substance, under a different tag.
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
23
|
+
substance, under a different tag. One more, the EAT-26, is free for
|
|
24
|
+
individual use but requires a licensing agreement from its copyright
|
|
25
|
+
holder for commercial web platforms that charge user fees. Four
|
|
26
|
+
others — the AQ-10, the RSES, the CSI-16, and the UCLA Loneliness
|
|
27
|
+
Scale — are neither free nor restricted for commercial use: their
|
|
28
|
+
rights holders simply haven't addressed it, so confirm with them
|
|
29
|
+
before shipping commercially. Read SOURCES.md before you rely on any
|
|
27
30
|
instrument's text, particularly before commercial use.
|
|
28
31
|
|
|
29
32
|
The MIT License below is the license for the code. The bundled
|
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** —
|
|
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).
|
|
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.
|
|
@@ -90,7 +90,8 @@ const response = AssessmentResponse.parse(assessment, rowFromDb); // answers re-
|
|
|
90
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
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
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
|
|
93
|
+
| `mini-ipip` | Mini-IPIP Big Five personality scale | personality | 20 | 5 trait subscales (4–20 each), 11 reverse-keyed, no cutoffs | en, tr, de, zh, es |
|
|
94
|
+
| `mini-ipip6` | Mini-IPIP6 Big Six personality scale | personality | 24 | 6 factor subscales (4–20 each), 15 reverse-keyed, no cutoffs | en, tr, de, zh, es |
|
|
94
95
|
| `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
96
|
| `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
97
|
| `erq` | Emotion Regulation Questionnaire | emotion-regulation | 10 | 2 subscales (reappraisal 6, suppression 4), no reversals, no cutoffs | en, tr, de, zh, es |
|
|
@@ -100,8 +101,19 @@ const response = AssessmentResponse.parse(assessment, rowFromDb); // answers re-
|
|
|
100
101
|
| `k10` | Kessler Psychological Distress Scale (K10) | distress | 10 | Sum 10–50 (1–5 coding), 4 severity bands | en, tr, de, zh, es |
|
|
101
102
|
| `k6` | Kessler Psychological Distress Scale (K6) | distress | 6 | Sum 0–24 (0–4 coding), ≥13 serious distress | en, tr, de, zh, es |
|
|
102
103
|
| `rses` | Rosenberg Self-Esteem Scale | self-esteem | 10 | Sum 0–30, 5 reverse-keyed items, 15–25 normal range | en, tr, de, zh, es |
|
|
104
|
+
| `bis-bas` | IPIP BIS/BAS scales (approach and avoidance motivation) | personality, motivation | 36 | 4 subscales (BIS 10, fun-seeking 10, drive 10, reward responsiveness 6), 10 reverse-keyed, no cutoffs | en, tr, de, zh, es |
|
|
105
|
+
| `ipip-neo-60` | IPIP-NEO-60 personality inventory | personality | 60 | 5 domain subscales × 12 items (12–60 each), 23 reverse-keyed, no cutoffs | en, tr, de, zh, es |
|
|
106
|
+
| `ipip-via-r` | IPIP-VIA-R short scales (24 character strengths) | character-strengths, personality | 96 | 24 strength subscales × 4 items (4–20 each), balanced 2 positive / 2 reverse, no cutoffs | en, tr, de, zh, es |
|
|
107
|
+
| `phq15` | Patient Health Questionnaire-15 (somatic symptoms) | somatic-symptoms | 15 | Sum 0–30 (0–2 coding), 4 severity bands, item 4 optional (women only) | en, tr, de, zh, es |
|
|
108
|
+
| `pcl5` | PTSD Checklist for DSM-5 (PCL-5), standard form | post-traumatic-stress | 20 | Sum 0–80, no bands² | en, tr, de, zh, es |
|
|
109
|
+
| `eat26` | Eating Attitudes Test (EAT-26) | disordered-eating | 26 | Sum 0–78 on an asymmetric key, referral at ≥20 | en, tr, de, zh, es |
|
|
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
|
+
| `ucla-ls3` | UCLA Loneliness Scale (Version 3) | loneliness | 20 | Sum 20–80, 9 reverse-keyed items, no bands² | en, tr, de, zh, es |
|
|
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 |
|
|
103
113
|
|
|
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. `asrs6` is free to ship, commercially included, but its license makes attribution mandatory: render `meta.attribution` wherever it appears.
|
|
114
|
+
¹ 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
|
+
|
|
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.
|
|
105
117
|
|
|
106
118
|
```ts
|
|
107
119
|
import { loadInventory, inventories, dass21 } from "psytools";
|
|
@@ -127,7 +139,9 @@ Every definition carries three optional fields for picking the right instrument:
|
|
|
127
139
|
|
|
128
140
|
Audience and respondent are separate axes because instruments *about* children are commonly filled in by someone else — a parent-report ADHD scale is `audience: ["child"]`, `respondent: "parent"`. `audience` is an array, since one wording is often validated across bands; `respondent` is a single value, since a definition is written from exactly one point of view. Parent- and teacher-report forms of the same instrument say "your child" and "this student", so they are separate definitions with separate ids, not one definition with two respondents.
|
|
129
141
|
|
|
130
|
-
Neither field encodes the recall timeframe or the administration mode: a retrospective instrument answered by an adult about their own childhood is `["adult"]` + `"self"`, with the childhood framing in `instructions`, and a clinician reading items aloud to a client is still `"self"` because the answers are the client's own report. Every bundled inventory is `respondent: "self"` and `audience: ["adult"]`, except `rses` — Rosenberg developed
|
|
142
|
+
Neither field encodes the recall timeframe or the administration mode: a retrospective instrument answered by an adult about their own childhood is `["adult"]` + `"self"`, with the childhood framing in `instructions`, and a clinician reading items aloud to a client is still `"self"` because the answers are the client's own report. Every bundled inventory is `respondent: "self"` and `audience: ["adult"]`, except `rses` and `eat26`, which are both `["adolescent", "adult"]` — Rosenberg developed his scale on high-school students, Garner names high school and college among the EAT-26's screening populations, and neither instrument changes its wording between bands.
|
|
143
|
+
|
|
144
|
+
No bundled inventory is adolescent- or child-only yet, and none has a `respondent` other than `"self"`. That reflects who licenses their instruments freely, not what exists — the parent- and teacher-report scales that would fill those gaps are recorded, with their terms, under [instruments evaluated and not bundled](SOURCES.md#instruments-evaluated-and-not-bundled).
|
|
131
145
|
|
|
132
146
|
## Defining your own assessment
|
|
133
147
|
|
|
@@ -223,7 +237,7 @@ scoring: {
|
|
|
223
237
|
|
|
224
238
|
`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.
|
|
225
239
|
|
|
226
|
-
The bundled inventories ship with policies (PHQ-9/GAD-7/DASS-21
|
|
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.
|
|
227
241
|
|
|
228
242
|
## Custom evaluation
|
|
229
243
|
|
|
@@ -281,17 +295,17 @@ npm run build # ESM + CJS + type declarations into dist/
|
|
|
281
295
|
|
|
282
296
|
- **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.
|
|
283
297
|
- **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.
|
|
284
|
-
- **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,
|
|
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.
|
|
285
299
|
- **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.
|
|
286
|
-
- **Translation provenance.** English texts are reproduced from the original instruments. Turkish, German, Simplified Chinese, and Spanish texts are AI translations (Anthropic Claude
|
|
300
|
+
- **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>.
|
|
287
301
|
|
|
288
302
|
## License
|
|
289
303
|
|
|
290
304
|
The code is MIT — Samed Kahyaoglu, 2026. See [LICENSE](LICENSE).
|
|
291
305
|
|
|
292
|
-
The bundled instrument text is a separate matter: each of the
|
|
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:
|
|
293
307
|
|
|
294
|
-
- **
|
|
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.
|
|
295
309
|
- **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.
|
|
296
310
|
- **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'.
|
|
297
311
|
- **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).
|
|
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).
|
|
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
|
|
|
@@ -36,7 +36,9 @@ This table is the only place translation status is tracked — psytools has no `
|
|
|
36
36
|
|
|
37
37
|
Each inventory declares two independent axes in its definition: `audience`, the age band(s) the instrument is written and validated for — who it is *about* — and `respondent`, whose report the answers are. They are separate because instruments about children are commonly completed by a parent or a teacher rather than by the child.
|
|
38
38
|
|
|
39
|
-
**Every bundled inventory is `respondent: "self"` and `audience: ["adult"]`, except where its section below states otherwise.**
|
|
39
|
+
**Every bundled inventory is `respondent: "self"` and `audience: ["adult"]`, except where its section below states otherwise.** Two deviate today, both by widening rather than narrowing: the RSES and the EAT-26 are each `["adolescent", "adult"]`, because the same wording is standard for both bands.
|
|
40
|
+
|
|
41
|
+
Two gaps are worth naming, since they are what the fields exist for and neither is filled yet. **No bundled inventory is written for adolescents or children only**, and **none has a `respondent` other than `"self"`** — no parent- or teacher-report form is bundled. The instruments that would fill those gaps are, so far, the ones whose rights holders restrict redistribution: the parent and teacher Vanderbilt scales, the SDQ, and the CRAFFT all sit in [instruments evaluated and not bundled](#instruments-evaluated-and-not-bundled) below. Filter on `audience` and `respondent` by all means, but do not read today's values as a survey of what exists.
|
|
40
42
|
|
|
41
43
|
Two things `audience` and `respondent` deliberately do *not* encode:
|
|
42
44
|
|
|
@@ -61,6 +63,16 @@ Bundled inventories ship with declarative missing-data policies (`scoring.missin
|
|
|
61
63
|
| `hsps` | prorate, ≥21 of 27 answered | Total is mean-based in the literature; prorating is equivalent |
|
|
62
64
|
| `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) |
|
|
63
65
|
| `rses` | prorate, ≥8 of 10 answered | Common research practice (80% completion) |
|
|
66
|
+
| `mini-ipip6` | prorate, ≥3 of 4 per factor | Same as `mini-ipip` |
|
|
67
|
+
| `bis-bas` | prorate, ≥5 per subscale | One threshold serves subscales of 10, 10, 10, and 6 items, so it is pinned to the strictest value the 6-item subscale allows — 5 of 6 there, 5 of 10 on the others |
|
|
68
|
+
| `ipip-neo-60` | prorate, ≥9 of 12 per domain | Common research practice (75% completion) |
|
|
69
|
+
| `ipip-via-r` | prorate, ≥3 of 4 per strength | 75% completion; note that dropping one item of a balanced 2-positive/2-negative scale reintroduces acquiescence bias |
|
|
70
|
+
| `phq15` | ignore | Item 4 is printed "[women only]" on the instrument, so it is legitimately unanswered by around half of respondents; an unanswered item contributes 0, which is what the instrument's own total-score line does. Prorating would inflate a man's score by 15/14 for answering the form as printed. The usual `ignore` caveat still applies to an accidental skip |
|
|
71
|
+
| `pcl5` | prorate, ≥16 of 20 | Common research practice (≈80% completion) — the same threshold as `cesd`, the package's other 20-item sum. The VA publishes no prorating rule of its own |
|
|
72
|
+
| `eat26` | prorate, ≥21 of 26 | Common research practice (≈80% completion) |
|
|
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
|
+
| `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
|
+
| `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 |
|
|
64
76
|
|
|
65
77
|
## PHQ-9 — Patient Health Questionnaire-9 (`phq9`)
|
|
66
78
|
|
|
@@ -102,7 +114,7 @@ Bundled inventories ship with declarative missing-data policies (`scoring.missin
|
|
|
102
114
|
**License: Free.** The International Personality Item Pool (Lewis Goldberg; <https://ipip.ori.org>) was created explicitly as a public-domain alternative to copyrighted commercial personality tests — items are free for any use, including commercial, without permission.
|
|
103
115
|
|
|
104
116
|
- **Citation:** Donnellan, M. B., Oswald, F. L., Baird, B. M., & Lucas, R. E. (2006). The Mini-IPIP scales: Tiny-yet-effective measures of the Big Five factors of personality. *Psychological Assessment, 18*(2), 192–203.
|
|
105
|
-
- **Scoring:** Five trait subscales (extraversion, agreeableness, conscientiousness, neuroticism, openness) of 4 items each on a 1–5 accuracy scale,
|
|
117
|
+
- **Scoring:** Five trait subscales (extraversion, agreeableness, conscientiousness, neuroticism, openness) of 4 items each on a 1–5 accuracy scale, 11 of the 20 items reverse-keyed; scores 4–20 per trait are descriptive — no clinical cutoffs exist, so no bands are defined. See [the IPIP shared record](#the-international-personality-item-pool--shared-record) for the license text, item rendering, and scoring rule this instrument shares with the other four IPIP inventories.
|
|
106
118
|
|
|
107
119
|
## ASRS v1.1 — Adult ADHD Self-Report Scale, 6-item screener (`asrs6`)
|
|
108
120
|
|
|
@@ -194,9 +206,148 @@ Bundled inventories ship with declarative missing-data policies (`scoring.missin
|
|
|
194
206
|
- **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).
|
|
195
207
|
- **Audience — deviates from the default:** `audience: ["adolescent", "adult"]`. Rosenberg developed the scale on high-school students (*Society and the Adolescent Self-Image*), and the same ten items are the standard self-esteem measure for adolescents and adults alike — the wording does not change between bands.
|
|
196
208
|
|
|
209
|
+
## The International Personality Item Pool — shared record
|
|
210
|
+
|
|
211
|
+
Five bundled inventories are drawn from the International Personality Item Pool (IPIP), a public-domain item bank maintained by Lewis Goldberg at the Oregon Research Institute: `mini-ipip`, `mini-ipip6`, `bis-bas`, `ipip-neo-60`, and `ipip-via-r`. What they have in common is recorded once here; each has its own section below.
|
|
212
|
+
|
|
213
|
+
- **License: Free — the least conditional in this package.** IPIP's permissions page states it in full: "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" (<https://ipip.ori.org/newPermission.htm>). There is no attribution requirement, no commercial carve-out, and no need to contact anyone. The scientific citation in each `meta.reference` is scholarly courtesy, not a license condition.
|
|
214
|
+
- **Item source.** English item text is transcribed from IPIP's own scoring-key pages, fetched 2026-07-29; each inventory's section names the page it came from and `meta.translationProvenance` carries the URL. Secondary sources and reconstructions from memory were not used.
|
|
215
|
+
- **Item rendering.** IPIP publishes item stems without the subject ("Am the life of the party."). psytools renders them as first-person sentences by prepending "I", lower-casing the stem's first letter, and dropping the trailing period — "I am the life of the party". The transformation is mechanical and applied uniformly; it reproduces the shipped `mini-ipip` wording exactly, which is how it was checked.
|
|
216
|
+
- **Response scale.** All five use IPIP's 1–5 accuracy scale (Very inaccurate … Very accurate), shared as `ipipAccuracyOptions`.
|
|
217
|
+
- **Scoring.** psytools reports subscale **sums**, which is IPIP's own published rule: reverse-keyed items are inverted (6 − answer), then all values in a scale are summed (<https://ipip.ori.org/newScoringInstructions.htm>). Divide by the item count for the item mean if you prefer it. None of the five has clinical cutoffs, so none defines bands.
|
|
218
|
+
- **Reverse keys.** IPIP marks reverse-keyed items with a minus sign on its key pages. A mis-keyed item produces a plausible but wrong score that no test would otherwise catch, so the counts are asserted in `test/ipip-inventories.test.ts`: `mini-ipip` 11 of 20, `mini-ipip6` 15 of 24, `bis-bas` 10 of 36, `ipip-neo-60` 23 of 60, `ipip-via-r` 48 of 96.
|
|
219
|
+
- **Item order.** IPIP publishes its keys grouped by scale and recommends mixing items when administering them. `bis-bas`, `ipip-neo-60`, and `ipip-via-r` keep the key page's grouped order because no authoritative mixed order is published; shuffle the questions in your own presentation layer if order effects matter for your use.
|
|
220
|
+
|
|
221
|
+
## Mini-IPIP6 — Big Six personality scale (`mini-ipip6`)
|
|
222
|
+
|
|
223
|
+
**License: Free.** Public domain via the IPIP grant quoted above — any use, commercial or non-commercial, no permission and no attribution required.
|
|
224
|
+
|
|
225
|
+
- **Citation:** Sibley, C. G., Luyten, N., Purnomo, M., Mobberley, A., Wootton, L. W., Hammond, M. D., Sengupta, N., Perry, R., West-Newman, T., Wilson, M. S., McLellan, V. L., Hoverd, W. J., & Robertson, A. (2011). The Mini-IPIP6: Validation and extension of a short measure of the Big-Six factors of personality in New Zealand. *New Zealand Journal of Psychology, 40*(3), 142–159.
|
|
226
|
+
- **Item source:** IPIP scoring key, <https://ipip.ori.org/MiniIPIP6Key.htm>.
|
|
227
|
+
- **Scoring:** Six factor subscales of 4 items each on the 1–5 accuracy scale — extraversion, agreeableness, conscientiousness, neuroticism, openness to experience, honesty-humility. **15 of the 24 items are reverse-keyed** (2 per factor for the first four, 3 for openness, all 4 for honesty-humility). Sums of 4–20 per factor are descriptive; no clinical cutoffs exist, so no bands are defined.
|
|
228
|
+
- **Item order — deviates from the group note above:** items 1–20 keep the order the bundled `mini-ipip` uses (Donnellan et al., 2006), so the two inventories line up item for item and share their translations; the four honesty-humility items are appended as 21–24. Every one of the 20 shared items appears verbatim on the Mini-IPIP6 key page with the same key, which is asserted in the tests.
|
|
229
|
+
- **Relation to `mini-ipip`:** the Mini-IPIP6 is the Mini-IPIP plus a sixth factor. Both are bundled because the Big Five form is the one most consumers expect; use `mini-ipip6` when honesty-humility matters.
|
|
230
|
+
|
|
231
|
+
## IPIP BIS/BAS Scales — approach and avoidance motivation (`bis-bas`)
|
|
232
|
+
|
|
233
|
+
**License: Free.** Public domain via the IPIP grant quoted above.
|
|
234
|
+
|
|
235
|
+
- **Citation:** Goldberg, L. R., Johnson, J. A., Eber, H. W., Hogan, R., Ashton, M. C., Cloninger, C. R., & Gough, H. G. (2006). The International Personality Item Pool and the future of public-domain personality measures. *Journal of Research in Personality, 40*(1), 84–96. Constructs after Carver, C. S., & White, T. L. (1994). Behavioral inhibition, behavioral activation, and affective responses to impending reward and punishment: The BIS/BAS scales. *Journal of Personality and Social Psychology, 67*(2), 319–333.
|
|
236
|
+
- **Item source:** IPIP scoring key, <https://ipip.ori.org/newBIS_BASkey.htm>; scale statistics from the comparison table at <https://ipip.ori.org/newBIS_BAStable.htm>.
|
|
237
|
+
- **Scoring:** Four subscales on the 1–5 accuracy scale — BIS/anxiety (10 items, 10–50), BAS fun-seeking (10, 10–50), BAS drive (10, 10–50), BAS reward responsiveness (6, 6–30). **10 of the 36 items are reverse-keyed** (2, 3, 3, and 2 respectively). Descriptive trait scores; no cutoffs, so no bands.
|
|
238
|
+
- **These are IPIP's *preliminary* scales, and they are proxies.** IPIP's own pages label them "the Preliminary IPIP Scales Measuring the Constructs in Gray's Behavioral Inhibition and Activation Systems". They measure constructs *similar to* those of Carver and White's BIS/BAS scales — they are not that instrument and are not a translation of it. IPIP reports correlations with the original scales of .69 (BIS), .63 (fun-seeking), .54 (drive), and .41 (reward responsiveness); corrected for unreliability, .86, .92, .72, and .59. The reward-responsiveness proxy is the weakest of the four and its alpha (.68) is the lowest — read that subscale with more caution than the other three. If your protocol requires the Carver and White instrument specifically, these items are not a substitute for it.
|
|
239
|
+
|
|
240
|
+
## IPIP-NEO-60 — 60-item personality inventory (`ipip-neo-60`)
|
|
241
|
+
|
|
242
|
+
**License: Free.** Public domain via the IPIP grant quoted above.
|
|
243
|
+
|
|
244
|
+
- **Citation:** Maples-Keller, J. L., Williamson, R. L., Sleep, C. E., Carter, N. T., Campbell, W. K., & Miller, J. D. (2019). Using item response theory to develop a 60-item representation of the NEO PI-R using the International Personality Item Pool: Development of the IPIP-NEO-60. *Journal of Personality Assessment, 101*(1), 4–15.
|
|
245
|
+
- **Item source:** IPIP scoring key, <https://ipip.ori.org/IPIP-NEO-60ScoringKeys.htm>.
|
|
246
|
+
- **Scoring:** Five domain subscales of 12 items each on the 1–5 accuracy scale — neuroticism, extraversion, openness to experience, agreeableness, conscientiousness. **23 of the 60 items are reverse-keyed** (4, 1, 7, 6, and 5 by domain). Sums of 12–60 per domain are descriptive; no cutoffs, so no bands.
|
|
247
|
+
- **Facets are documented but not scored.** Each domain draws two items from each of six facets (neuroticism: anxiety, anger, depression, self-consciousness, immoderation, vulnerability; extraversion: friendliness, gregariousness, assertiveness, activity level, excitement-seeking, cheerfulness; openness: imagination, artistic interests, emotionality, adventurousness, intellect, liberalism; agreeableness: trust, morality, altruism, cooperation, modesty, sympathy; conscientiousness: self-efficacy, orderliness, dutifulness, achievement-striving, self-discipline, cautiousness). Two items are far too few for a reliable facet score, so psytools scores the five domains only and records the facet composition in `meta.scoringNote`.
|
|
248
|
+
- **Naming.** `IPIP-NEO-60` is IPIP's own scale label and the name the authors gave the measure, which is what IPIP's citation guidance says to use. psytools describes it only as measuring constructs *similar to* five broad personality domains, built from public-domain IPIP items — the framing IPIP itself uses. It is **not** a version, edition, or short form of any commercially published inventory, and psytools claims no relationship with or endorsement by any test publisher. "NEO" and related marks belong to their owners; the one place the string appears in psytools' data is inside `meta.reference`, where it is part of the authors' own article title and is reproduced accurately rather than rewritten. A test asserts that psytools' own prose about this instrument stays clear of it.
|
|
249
|
+
|
|
250
|
+
## IPIP-VIA-R Short Scales — 24 character strengths (`ipip-via-r`)
|
|
251
|
+
|
|
252
|
+
**License: Free.** Public domain via the IPIP grant quoted above.
|
|
253
|
+
|
|
254
|
+
- **Citation:** Bluemke, M., Partsch, M. V., Saucier, G., & Lechner, C. M. (2021, December 16). *Human character in the IPIP: Towards shorter, more content-valid, and cross-culturally comparable IPIP-VIA character strength scales.* PsyArXiv. <https://doi.org/10.31234/osf.io/k79qf>. Strengths taxonomy after Peterson, C., & Seligman, M. E. P. (2004). *Character Strengths and Virtues: A Handbook and Classification.* New York: Oxford University Press / Washington, DC: American Psychological Association.
|
|
255
|
+
- **Item source:** IPIP scoring key, <https://ipip.ori.org/IPIP-VIA-R_Key.html>; reliability figures from <https://ipip.ori.org/IPIP-VIA-R_Table.html>.
|
|
256
|
+
- **Scoring:** Twenty-four strength subscales of 4 items each on the 1–5 accuracy scale, sums of 4–20. **48 of the 96 items are reverse-keyed — exactly half, by design.** Every scale is balanced with two positively and two negatively worded items so that acquiescent responding cancels within the scale; that balance is the instrument's defining feature, and a prorated score computed from three of the four items no longer has it. No cutoffs exist, and scores are most often read as a rank order across a person's strengths rather than against a norm.
|
|
257
|
+
- **Reliability is modest for several scales, by construction.** Four items divided between two wordings buys balance at the cost of internal consistency. The authors report McDonald's ω between .57 and .84 across German and UK samples and argue that Cronbach's α is the wrong estimate for a balanced scale of this shape; α runs as low as .42 (self-regulation, UK). Treat single-strength scores as indicative, not precise. The 2–3 week retest reliabilities (.53–.84) are the more useful number for most applications.
|
|
258
|
+
- **Scale labels.** IPIP lists several strengths under two or three names (for example "Industry/Perseverance/Persistence"). psytools keeps a descriptive label carrying the alternatives and uses a single short id (`perseverance`); the mapping is visible in the definition.
|
|
259
|
+
|
|
260
|
+
## PHQ-15 — Patient Health Questionnaire-15 (`phq15`)
|
|
261
|
+
|
|
262
|
+
**License: Free.** The same Pfizer grant as the bundled PHQ-9 and GAD-7, confirmed twice from primary sources. The instrument's own footer reads: "Copyright Pfizer Inc. No permission required to reproduce, translate, display, or distribute." The PHQ family's instruction manual says the same of the whole family and names the PHQ-15 explicitly in its table of measures: "All of the measures included in Table 1 are in the public domain. No permission is required to reproduce, translate, display or distribute." Official repository: <https://www.phqscreeners.com>.
|
|
263
|
+
|
|
264
|
+
- **Citation:** Kroenke, K., Spitzer, R. L., & Williams, J. B. W. (2002). The PHQ-15: Validity of a new measure for evaluating the severity of somatic symptoms. *Psychosomatic Medicine, 64*(2), 258–266.
|
|
265
|
+
- **Scoring:** Sum 0–30 on a 0–2 bother scale over the past 4 weeks. Bands split at the PHQ manual's own cutpoints of 5, 10 and 15 for low, medium and high somatic symptom severity.
|
|
266
|
+
- **Item 4 is optional, because the instrument says so.** "Menstrual cramps or other problems with your periods" is printed "[women only]" on the form. psytools marks it `optional`, and the missing-data policy is `ignore` so that a respondent who skips it is scored on what they answered — see [missing-data policies](#missing-data-policies) for why prorating would be wrong here.
|
|
267
|
+
- **Two items are shared with the PHQ-9, and the answers are not interchangeable.** Item 14 (tired) and item 15 (sleep) cover the same symptoms as PHQ-9 items 4 and 3. The wording is shorter here and, more importantly, the scale runs 0–2 rather than 0–3. Do not copy an answer from one inventory to the other; administer each on its own scale.
|
|
268
|
+
|
|
269
|
+
## PCL-5 — PTSD Checklist for DSM-5 (`pcl5`)
|
|
270
|
+
|
|
271
|
+
**License: Free.** The rights holder's own page states it without qualification: "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/adult-sr/ptsd-checklist.asp>). English text transcribed from the VA's own PCL-5 Standard form PDF, version date 29 August 2023.
|
|
272
|
+
|
|
273
|
+
- **Citation:** Weathers, F. W., Litz, B. T., Keane, T. M., Palmieri, P. A., Marx, B. P., & Schnurr, P. P. (2013). *The PTSD Checklist for DSM-5 (PCL-5) — Standard* [Measurement instrument]. National Center for PTSD. Available from <https://www.ptsd.va.gov/>.
|
|
274
|
+
- **Scoring:** Sum 0–80 on a 0–4 scale, recall window one month. psytools bundles the standard form; the VA also publishes forms with a Criterion A event checklist and with an extended timeframe, which are not included.
|
|
275
|
+
- **No bands, and that is deliberate — the cutoff is provisional in the VA's own words.** The VA writes that "initial research suggests that a PCL-5 cutoff score between 31–33 is indicative of probable PTSD across samples," and asks users to weigh their own setting when choosing one. That is a range offered as initial research, not a settled threshold. A `band` renders to whoever is reading the result as a categorical verdict, so encoding one number out of 31–33 as a boundary would present a provisional finding as a decided one. The range is recorded in `meta.scoringNote` instead; apply your own cutoff over `score` if your protocol names one.
|
|
276
|
+
- **The DSM-5 provisional-diagnosis rule is not implemented.** The VA's second scoring route — at least one item from cluster B, one from C, two from D and two from E, each rated 2 or higher — needs per-cluster counts of items above a threshold, which none of psytools' three declarative scorings expresses. The cluster composition is recorded in `meta.scoringNote` (B: 1–5, C: 6–7, D: 8–14, E: 15–20) so a custom evaluator can implement it in a few lines.
|
|
277
|
+
|
|
278
|
+
## EAT-26 — Eating Attitudes Test (`eat26`)
|
|
279
|
+
|
|
280
|
+
**License: Free with conditions.** Copyright is held by David M. Garner / Eating Attitudes LLC. Fees and royalties are waived for individual users, and permission letters to reproduce paper or electronic copies are granted on request through the copyright holder's own site (<https://www.eat-26.com/permission/>). One exception is stated explicitly, and a consumer building a paid product needs to see it before they build:
|
|
281
|
+
|
|
282
|
+
> Commercial WEB platforms that charge user fees must obtain a licensing agreement from the copyright holder.
|
|
283
|
+
|
|
284
|
+
**Our position, stated separately from the rights holder's words above:** psytools is an open-source library, not a commercial web platform, and it charges no user fees — so we read that condition as landing on the deployment, not on the library, and bundle the text on that basis. **If you are building a web platform that charges user fees, the condition lands on you.** Contact <dmgarner@gmail.com> for a licensing agreement before you ship. The flag does not encode our reading; it says `free-with-conditions` and this section is the condition.
|
|
285
|
+
|
|
286
|
+
- **Citation:** Garner, D. M., Olmsted, M. P., Bohr, Y., & Garfinkel, P. E. (1982). The Eating Attitudes Test: Psychometric features and clinical correlates. *Psychological Medicine, 12*(4), 871–878.
|
|
287
|
+
- **Scoring:** Sum 0–78 on Garner's own asymmetric key, taken from his scoring and interpretation document. For items 1–25, Always scores 3, Usually 2, Often 1, and Sometimes, Rarely and Never all score 0; item 26 is keyed the other way round (Never 3, Rarely 2, Sometimes 1, the rest 0). A score of 20 or above is his referral criterion, which is where the two bands split. His three subscales — dieting, bulimia and food preoccupation, oral control — are recorded in `meta.scoringNote` but not scored, because the total is what carries the cutoff.
|
|
288
|
+
- **Three of the six answer anchors score the same number, so key your UI by option position.** That collapse is the instrument's, not ours: Garner's scoring table gives Sometimes, Rarely and Never an identical 0 on items 1–25. psytools' model stores an answer as its score contribution, so `value` alone cannot say which of the three a respondent picked. Render options and store raw responses by their index in the `options` array — `meta.renderingNote` repeats this next to the data.
|
|
289
|
+
- **psytools bundles Part B only, and Garner's referral logic is wider than that.** His full form has three parts: a demographic and BMI section (Part A), the 26 scored items (Part B), and five behavioural questions about bingeing, vomiting, laxatives, exercise and weight loss (Part C). Only Part B carries the 0–78 score, so only Part B is bundled. Garner refers a respondent on a score of 20 or above **or** on low age-referenced BMI **or** on any flagged behavioural answer — so a score below 20 does not, on its own, complete his screening protocol. Implement Parts A and C alongside if you are reproducing that protocol rather than the scale.
|
|
290
|
+
- **Audience — deviates from the default:** `audience: ["adolescent", "adult"]`. Garner's own scoring document describes the EAT-26 as "particularly useful as a screening tool to assess 'eating disorder risk' in high school, college and other special risk samples such as athletes," and the BMI referral criteria he publishes with it are age-referenced from age 9 upward. The item wording does not change between bands. We stop at adolescent rather than following the BMI table down to age 9, because high school and college is what the rights holder names.
|
|
291
|
+
|
|
292
|
+
## CSI-16 — Couples Satisfaction Index (`csi16`)
|
|
293
|
+
|
|
294
|
+
**License: Free with conditions.** Ronald Rogge and colleagues (University of Rochester) distribute the CSI scales from their own lab site, and the grant is printed both on the site and on the instrument file itself. The site says:
|
|
295
|
+
|
|
296
|
+
> These scales are freely available for use in both clinical and research settings. No additional permission is necessary for their use.
|
|
297
|
+
|
|
298
|
+
The CSI-16 file adds:
|
|
299
|
+
|
|
300
|
+
> PERMISSION FOR USE: We developed the CSI scales to be freely available for research and clinical use. No further permission is required beyond this form and the authors will not generate study-specific permission letters.
|
|
301
|
+
|
|
302
|
+
**This is the cleanest, least hedged grant of the four conditional instruments — and it still never says "commercial", in either direction.** Both statements scope themselves to clinical and research settings. There is no commercial carve-out to comply with, and no commercial permission to rely on; the authors simply did not address it, most likely because they had individual clinicians and researchers in mind rather than software redistribution. That silence is the whole of the condition, and the reason the flag is not `free`. **Our position:** we read a grant this unhedged as covering distribution of the item text in an open-source library, and bundle it. If your own use is commercial and you want certainty rather than a reasonable reading, ask the authors — the scales are hosted at <https://couples-research.com/measures/>.
|
|
303
|
+
|
|
304
|
+
- **Citation:** Funk, J. L., & Rogge, R. D. (2007). Testing the ruler with item response theory: Increasing precision of measurement for relationship satisfaction with the Couples Satisfaction Index. *Journal of Family Psychology, 21*(4), 572–583.
|
|
305
|
+
- **Scoring:** Sum 0–81. **Higher is more satisfied** — the opposite direction from every other bundled inventory, where a higher score means more of a problem. Do not wire a shared "higher is worse" display to this one. The authors' cutoff is 51.5, so the bands split at 51/52.
|
|
306
|
+
- **Four different answer scales, which is why most items carry their own `options`.** Item 1 is a 7-point 0–6 happiness scale ending in "Perfect"; item 2 runs 5 down to 0; items 3–6 are 0–5 agreement; items 7–10 use the assessment-level 0–5 scale; items 11–16 are semantic differentials.
|
|
307
|
+
- **Items 11–16 are semantic differentials and need a renderer that knows it.** Each is a pair of opposing words with six positions between them. psytools puts both poles in the question `text`, in the order the authors print them left to right, and labels the six options with the position numbers as printed on the authors' form. The authors note that when they administer the scale they replace those numbers with blank circles; a renderer wanting that should draw the poles from `text` at each end of a row of six controls. The locale packs restate the same digits rather than inventing words for the intermediate positions.
|
|
308
|
+
- **`instructions` is the form's only instruction line, and on paper it introduces items 11–16.** Items 1–10 carry self-contained stems and need no preamble. psytools has one instruction field per assessment, so that line is promoted to the assessment's `instructions`; it is reproduced verbatim rather than rewritten to cover all sixteen.
|
|
309
|
+
- **This inventory is the first to populate the `relationships` category on its own.** The category has been declared since the first release and was carried only as a secondary label on `ecr-r`, which measures attachment.
|
|
310
|
+
|
|
311
|
+
## UCLA Loneliness Scale, Version 3 (`ucla-ls3`)
|
|
312
|
+
|
|
313
|
+
**License: Free with conditions.** This is the thinnest licensing record of anything bundled, and the section is long because the reader deserves both halves of it.
|
|
314
|
+
|
|
315
|
+
Daniel W. Russell (Iowa State University) developed the scale and has publicly disclaimed any requirement to seek his permission. In a 2022 openly-licensed interview he described the daily requests he receives from graduate students "whose committees are telling them 'you have to get permission from the developer to use the scale' which is not true." That is current, first-person and unambiguous as far as it goes. What it is not is a formal licence: it is a remark in an interview, it is addressed to researchers rather than to redistributors, and it does not mention commercial use in either direction.
|
|
316
|
+
|
|
317
|
+
Set against it, without contradicting it: HealthMeasures lists Russell and the UCLA Loneliness Scale among the third-party content PROMIS uses **with the permission of the copyright holders**. The two facts sit together perfectly well — an author who tells students they need not ask can still receive and grant a formal institutional request — but a reader weighing their own risk should have both, so both are here.
|
|
318
|
+
|
|
319
|
+
**Our position:** on the strength of the author's own words we bundle the text and flag it `free-with-conditions` rather than `free`, because no licence exists to point at. If your use is commercial and you want certainty, write to Russell. We have not.
|
|
320
|
+
|
|
321
|
+
- **Citation:** Russell, D. W. (1996). UCLA Loneliness Scale (Version 3): Reliability, validity, and factor structure. *Journal of Personality Assessment, 66*(1), 20–40.
|
|
322
|
+
- **Item source — no first-party copy exists.** Russell distributes no copy of his own and the 1996 article is paywalled, so unlike every other instrument in this file the English text does not come from the rights holder. It is transcribed from two independent reproductions of Russell (1996), read and checked against each other: Stanford SPARQ's *Measuring Mobility* toolkit (<https://sparqtools.org/mobility-measure/ucla-loneliness-scale-version-3/>) and the Fetzer Institute's self-measures compendium. They agree item for item and on the reverse keys.
|
|
323
|
+
- **They disagree on the top anchor, and psytools follows "Always".** One prints Never / Rarely / Sometimes / **Often**, the other Never / Rarely / Sometimes / **Always**. Russell's own instruction example settles it — it ends "if you always feel happy, you would respond 'always'" — and "Often" belongs to the earlier Revised UCLA Loneliness Scale, a different instrument. This is exactly the kind of drift a single source would have shipped unnoticed.
|
|
324
|
+
- **Scoring:** Sum 20–80 on a 1–4 frequency scale, higher is lonelier. **Nine of the twenty items are reverse-keyed** — 1, 5, 6, 9, 10, 15, 16, 19 and 20, the positively worded ones. (Nine, not ten: descriptions of this scale sometimes quote "10 of the 20 items reverse scored", which is a statement about the earlier Revised version, not about Version 3.)
|
|
325
|
+
- **No bands, because Russell publishes no cutoffs.** The scale is scored continuously. Severity bandings for it circulate widely on the web; none of them traces back to Russell, so none is bundled.
|
|
326
|
+
|
|
327
|
+
## CBI — Copenhagen Burnout Inventory (`cbi`)
|
|
328
|
+
|
|
329
|
+
**License: Free with conditions.** Like the UCLA scale above, this record has two halves and you should have both.
|
|
330
|
+
|
|
331
|
+
**What supports it.** NFA — Det Nationale Forskningscenter for Arbejdsmiljø, Denmark's national occupational-health research institute — hosts the complete instrument in its public questionnaire library with no registration, no fee and no gate of any kind, under a named live contact (Thomas Clausen, <tcl@nfa.dk>). An independent peer-reviewed validation study describes it, citing Kristensen et al. by name, as "a public domain questionnaire." And the two published Turkish adaptations (2009, 2013) describe their method without describing a permission-seeking step — which carries some weight in this file specifically, because the Turkish teams behind the WURS-25, the WFIRS and the Athens Insomnia Scale all state plainly that they wrote and asked first.
|
|
332
|
+
|
|
333
|
+
**What is missing.** No statement from the rights holders themselves. NFA stewards and distributes the instrument; it did not write it. Two independent research passes went looking for a first-party grant and neither found one, and the original Kristensen et al. (2005) paper stayed paywalled across every route tried, so if it settles the question either way we have not read it. Nothing in the first-edition document itself — read in full — carries a copyright line, a licence, or a permission statement.
|
|
334
|
+
|
|
335
|
+
**Our position:** bundled on the strength of NFA's open hosting, and flagged `free-with-conditions` rather than `free` because there is no grant to point at. If your use is commercial and you want certainty, write to NFA. We have not.
|
|
336
|
+
|
|
337
|
+
- **Citation:** Kristensen, T. S., Borritz, M., Villadsen, E., & Christensen, K. B. (2005). The Copenhagen Burnout Inventory: A new tool for the assessment of burnout. *Work & Stress, 19*(3), 192–207.
|
|
338
|
+
- **Item source:** the authors' own English first edition (February 2004), by Marianne Borritz and Tage S. Kristensen at the National Institute of Occupational Health, Copenhagen, as hosted by NFA. Read in full, including the normative tables. **Single source** — unlike `ucla-ls3` there was no second reproduction to cross-check against, but unlike `ucla-ls3` this one comes from the authors themselves.
|
|
339
|
+
- **Development language was Danish**, for the PUMA study on a Danish population. The English text bundled here is the authors' own, not a third-party translation, so the file's general provenance rule still holds — but this is the first bundled instrument whose *development* language is not English, and that distinction is worth keeping in view as more non-English-origin instruments are considered.
|
|
340
|
+
- **Three scales, scored separately, no total.** Personal burnout (6 items), work-related burnout (7), client-related burnout (6). There is deliberately no score across all nineteen: the three ask about the same exhaustion under different attributions, and the authors treat them as independent.
|
|
341
|
+
- **Two response scales are mixed within a scale.** Items phrased as "is your work…" take a degree scale (To a very high degree … To a very low degree); items phrased as "how often…" take a frequency scale (Always … Never/almost never). Both map to the same 100 / 75 / 50 / 25 / 0 key, so a mis-assigned scale would produce a wrong score rather than an out-of-range answer — `test/evaluation.test.ts` pins which items carry which.
|
|
342
|
+
- **Scoring:** the published score for each scale is the **mean** of its items, on 0–100. psytools reports subscale sums; divide by 6, 7 and 6 respectively — the same convention the ECR-R, ERQ and HSPS entries follow. **One item is reverse-keyed**: work-burnout item 7 (`cbi-13`), on having energy left for family and friends, where more energy means less burnout.
|
|
343
|
+
- **Missing data:** the authors' own rule classifies a respondent as a non-responder below 3 of 6 answered (personal), 4 of 7 (work) and 3 of 6 (client). A single policy cannot carry three thresholds, so `minAnswered` is pinned to 4 — stricter than the authors on the two 6-item scales, which fails safe by refusing to score rather than scoring thin data.
|
|
344
|
+
- **No bands, because the authors publish norms rather than cutoffs.** The first edition gives population means (around 32.7 for personal burnout in a representative Danish sample, SD 15.7) and no severity thresholds, so none are bundled.
|
|
345
|
+
- **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
|
+
- **"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
|
+
|
|
197
348
|
## Instruments evaluated and not bundled
|
|
198
349
|
|
|
199
|
-
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.
|
|
350
|
+
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.
|
|
200
351
|
|
|
201
352
|
- **ASRS v1.1, full 18-item Symptom Checklist** — © New York University and the President and Fellows of Harvard College. A separate product on the same NYU TOV platform from the 6-item screener, and the screener's free-commercial grant does not extend to it: clinical use is routed to a different site, research use requires an institutional signatory, and no commercial tier is offered. Not bundled.
|
|
202
353
|
- **ASRS-5 (DSM-5-aligned, 6 items)** — © New York University / NYU Langone Health. A different instrument from the v1.1 screener despite the similar name and length. Only a research-and-academic license is publicly offered, and the rights holder's own product listing calls the scoring rules proprietary. Not bundled.
|
|
@@ -204,5 +355,14 @@ Instruments considered for inclusion and not shipped, each checked against the r
|
|
|
204
355
|
- **SNAP-IV** — James M. Swanson / University of California, Irvine. Neither the instrument nor the developer's own published history of the scale carries a copyright or license statement at all. The absence of a grant is not a grant. Not bundled.
|
|
205
356
|
- **NICHQ Vanderbilt Assessment Scales (parent and teacher forms)** — © 2012 American Academy of Pediatrics, printed "All Rights Reserved" on the instrument. Free to download and administer, which is not the same as licensed to redistribute inside a package. Not bundled.
|
|
206
357
|
- **WFIRS-P / WFIRS-S (Weiss Functional Impairment Rating Scale)** — © Margaret Danielle Weiss, MD PhD. Permissive terms, but the notice asks that the author be contacted before translation. **Blocked on a permission request we intend to make, not on a refusal** — so this one may yet arrive.
|
|
358
|
+
- **CRAFFT 2.1 (adolescent substance-use screener)** — © John R. Knight, MD / Boston Children's Hospital, distributed by the Center for Adolescent Behavioral Health Research. Free of charge, warmly distributed, and it would have been the first non-adult instrument in the package. Held back on three grounds, any one of which is enough, all three read off the rights holder's own CRAFFT 2.1 Manual (version 28 October 2021):
|
|
359
|
+
|
|
360
|
+
1. **The permission we would need is the one that has not been asked for.** The manual grants clinicians permission-free use in their own practice "provided that questions are presented exactly as they appear in the copyrighted version," and then says plainly: "You do need to request approval to re-publish the CRAFFT in another print or electronic format. There is no fee for use or to request permission." Bundling the item text in a package *is* re-publishing it in another electronic format. That obligation lands on psytools at the moment we publish, not on the consumer at the moment they deploy — so it is not the kind of condition this file can pass downstream and let a reader apply to their own use. It is the same shape as the WFIRS entry above, and a degree stronger.
|
|
361
|
+
2. **Our translations would conflict with the condition attached to the grant.** Permission-free use is conditioned on questions appearing exactly as in the copyrighted version, and the rights holder maintains official translations in 27 languages — including all four psytools ships: Turkish, German, Chinese (Simplified) and Spanish. Shipping unverified AI translations next to that is not defensible, and it is a sharper conflict than the unresolved ASRS-6 translation question, where no official Turkish version exists to have used instead.
|
|
362
|
+
3. **Part A cannot be represented in this data model at all.** The CRAFFT's three opening questions ask on how many days in the past 12 months the respondent drank, used cannabis, or used anything else to get high, and the answer is a number written in a box. Every psytools question resolves to an enumerated option scale; there is no numeric-entry question type. Any enumerated scale we invented for Part A would be an answer format the instrument does not have — which independently breaks the "exactly as they appear" condition — and the earlier CRAFFT's yes/no opening questions are not a substitute, since 2.1 replaced them deliberately after finding they under-detected use.
|
|
363
|
+
|
|
364
|
+
**On the conditional structure specifically, since it is the interesting part and the next person should not have to re-derive it.** Part A gates Part B: if all three frequency answers are 0 the respondent is asked only the first Part B question (CAR, a riding-with-an-impaired-driver safety item asked of everyone), and otherwise all six. The score is the count of "yes" answers across Part B, 0–6, and 2 or more is the referral threshold. Two thirds of that *is* expressible declaratively — `count` scoring naming only the six Part B items, `optional: true` on the five that the gate can skip, and an `ignore` missing-data policy. That combination produces the right answer rather than a quietly wrong one: a respondent who reports no use is scored on the CAR item alone, giving 0 or 1, which is what the manual says their score is and is below the threshold either way. What it cannot do is *enforce* the gate — nothing in a declarative definition stops a consumer showing all six Part B items to a respondent who reported no use, or requires the other five when use is reported. So the honest summary is that the scoring survives the model and the administration logic does not.
|
|
365
|
+
|
|
366
|
+
**Blocked on a permission request, not on a refusal.** The ask is narrow and the manual says there is no fee for it: approval to re-publish the CRAFFT 2.1 English text inside an open-source package, and separately whether the official translations may be used in place of ours. Contact: <crafft@childrens.harvard.edu>. Until that comes back, `audience: ["adolescent"]` has no bundled instrument and the note in [target audience & respondent](#target-audience--respondent) above says so.
|
|
207
367
|
|
|
208
368
|
Hold rights to any of these, or know of a grant we missed? Please write to <samed@luckys.dev> — a correction here is as welcome as one to a bundled instrument.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { AssessmentDefinition } from "../types.ts";
|
|
2
|
+
/**
|
|
3
|
+
* IPIP BIS/BAS Scales — 36-item public-domain measure of approach and
|
|
4
|
+
* avoidance motivation.
|
|
5
|
+
*
|
|
6
|
+
* Four subscales on IPIP's 1-5 accuracy scale: behavioral inhibition
|
|
7
|
+
* (BIS/anxiety, 10 items), and three behavioral-activation facets —
|
|
8
|
+
* fun-seeking (10), drive (10), and reward responsiveness (6). Ten
|
|
9
|
+
* items are reverse-keyed. Subscale sums are descriptive; no clinical
|
|
10
|
+
* cutoffs exist, so no bands are defined.
|
|
11
|
+
*
|
|
12
|
+
* These are IPIP's own *preliminary* scales measuring constructs
|
|
13
|
+
* similar to those in the BIS/BAS scales of Carver and White (1994) —
|
|
14
|
+
* public-domain proxies, not that instrument. IPIP items are public
|
|
15
|
+
* domain.
|
|
16
|
+
*/
|
|
17
|
+
export declare const bisBas: AssessmentDefinition;
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.bisBas = void 0;
|
|
4
|
+
const common_ts_1 = require("./common.js");
|
|
5
|
+
/**
|
|
6
|
+
* IPIP BIS/BAS Scales — 36-item public-domain measure of approach and
|
|
7
|
+
* avoidance motivation.
|
|
8
|
+
*
|
|
9
|
+
* Four subscales on IPIP's 1-5 accuracy scale: behavioral inhibition
|
|
10
|
+
* (BIS/anxiety, 10 items), and three behavioral-activation facets —
|
|
11
|
+
* fun-seeking (10), drive (10), and reward responsiveness (6). Ten
|
|
12
|
+
* items are reverse-keyed. Subscale sums are descriptive; no clinical
|
|
13
|
+
* cutoffs exist, so no bands are defined.
|
|
14
|
+
*
|
|
15
|
+
* These are IPIP's own *preliminary* scales measuring constructs
|
|
16
|
+
* similar to those in the BIS/BAS scales of Carver and White (1994) —
|
|
17
|
+
* public-domain proxies, not that instrument. IPIP items are public
|
|
18
|
+
* domain.
|
|
19
|
+
*/
|
|
20
|
+
exports.bisBas = {
|
|
21
|
+
id: "bis-bas",
|
|
22
|
+
version: "1.0.0",
|
|
23
|
+
categories: ["personality", "motivation"],
|
|
24
|
+
audience: ["adult"],
|
|
25
|
+
respondent: "self",
|
|
26
|
+
title: {
|
|
27
|
+
en: "IPIP BIS/BAS Scales",
|
|
28
|
+
},
|
|
29
|
+
description: {
|
|
30
|
+
en: "A 36-item public-domain measure of approach and avoidance motivation, built from International Personality Item Pool items keyed to the behavioral inhibition and activation constructs: sensitivity to punishment (BIS) and three facets of sensitivity to reward (BAS drive, fun-seeking, and reward responsiveness).",
|
|
31
|
+
},
|
|
32
|
+
instructions: common_ts_1.ipipInstructions,
|
|
33
|
+
defaultLocale: "en",
|
|
34
|
+
options: common_ts_1.ipipAccuracyOptions,
|
|
35
|
+
questions: [
|
|
36
|
+
{ id: "bis-bas-1", text: { en: "I worry about what people think of me" } },
|
|
37
|
+
{ id: "bis-bas-2", text: { en: "I am always worried about something" } },
|
|
38
|
+
{ id: "bis-bas-3", text: { en: "I often worry about things that turn out to be unimportant" } },
|
|
39
|
+
{ id: "bis-bas-4", text: { en: "I am afraid that I will do the wrong thing" } },
|
|
40
|
+
{ id: "bis-bas-5", text: { en: "I am easily hurt" } },
|
|
41
|
+
{ id: "bis-bas-6", text: { en: "I begin to panic when there is danger" } },
|
|
42
|
+
{ id: "bis-bas-7", text: { en: "I become overwhelmed by events" } },
|
|
43
|
+
{ id: "bis-bas-8", text: { en: "I get stressed out easily" } },
|
|
44
|
+
{ id: "bis-bas-9", text: { en: "I rarely worry" }, reverseScored: true },
|
|
45
|
+
{ id: "bis-bas-10", text: { en: "I am not embarrassed easily" }, reverseScored: true },
|
|
46
|
+
{ id: "bis-bas-11", text: { en: "I like to behave spontaneously" } },
|
|
47
|
+
{ id: "bis-bas-12", text: { en: "I have persuaded others to do something really adventurous or crazy" } },
|
|
48
|
+
{ id: "bis-bas-13", text: { en: "I am willing to try anything once" } },
|
|
49
|
+
{ id: "bis-bas-14", text: { en: "I like to act on a whim" } },
|
|
50
|
+
{ id: "bis-bas-15", text: { en: "I prefer friends who are excitingly unpredictable" } },
|
|
51
|
+
{ id: "bis-bas-16", text: { en: "I do crazy things" } },
|
|
52
|
+
{ id: "bis-bas-17", text: { en: "I enjoy being reckless" } },
|
|
53
|
+
{ id: "bis-bas-18", text: { en: "I would never go hang gliding or bungee jumping" }, reverseScored: true },
|
|
54
|
+
{ id: "bis-bas-19", text: { en: "I rarely enjoy behaving in a silly manner" }, reverseScored: true },
|
|
55
|
+
{ id: "bis-bas-20", text: { en: "I avoid dangerous situations" }, reverseScored: true },
|
|
56
|
+
{ id: "bis-bas-21", text: { en: "I want to be in charge" } },
|
|
57
|
+
{ id: "bis-bas-22", text: { en: "I try to surpass others' accomplishments" } },
|
|
58
|
+
{ id: "bis-bas-23", text: { en: "I like to show off my body" } },
|
|
59
|
+
{ id: "bis-bas-24", text: { en: "I know how to get around the rules" } },
|
|
60
|
+
{ id: "bis-bas-25", text: { en: "I have a strong need for power" } },
|
|
61
|
+
{ id: "bis-bas-26", text: { en: "I take charge" } },
|
|
62
|
+
{ id: "bis-bas-27", text: { en: "I push myself very hard to succeed" } },
|
|
63
|
+
{ id: "bis-bas-28", text: { en: "I am not highly motivated to succeed" }, reverseScored: true },
|
|
64
|
+
{ id: "bis-bas-29", text: { en: "I am not an extraordinary person" }, reverseScored: true },
|
|
65
|
+
{ id: "bis-bas-30", text: { en: "I hate being the center of attention" }, reverseScored: true },
|
|
66
|
+
{ id: "bis-bas-31", text: { en: "I feel excited or happy for no apparent reason" } },
|
|
67
|
+
{ id: "bis-bas-32", text: { en: "I get caught up in the excitement when others are celebrating" } },
|
|
68
|
+
{ id: "bis-bas-33", text: { en: "I am eager to soothe hurt feelings" } },
|
|
69
|
+
{ id: "bis-bas-34", text: { en: "I get so happy or energetic that I am almost giddy" } },
|
|
70
|
+
{ id: "bis-bas-35", text: { en: "I rarely get caught up in the excitement" }, reverseScored: true },
|
|
71
|
+
{ id: "bis-bas-36", text: { en: "I don't get excited about things" }, reverseScored: true },
|
|
72
|
+
],
|
|
73
|
+
scoring: {
|
|
74
|
+
kind: "subscales",
|
|
75
|
+
missing: { strategy: "prorate", minAnswered: 5 },
|
|
76
|
+
subscales: [
|
|
77
|
+
{
|
|
78
|
+
id: "bis-anxiety",
|
|
79
|
+
label: { en: "BIS — Behavioural inhibition / anxiety" },
|
|
80
|
+
questionIds: [
|
|
81
|
+
"bis-bas-1", "bis-bas-2", "bis-bas-3", "bis-bas-4", "bis-bas-5", "bis-bas-6",
|
|
82
|
+
"bis-bas-7", "bis-bas-8", "bis-bas-9", "bis-bas-10",
|
|
83
|
+
],
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
id: "bas-fun-seeking",
|
|
87
|
+
label: { en: "BAS — Fun-seeking" },
|
|
88
|
+
questionIds: [
|
|
89
|
+
"bis-bas-11", "bis-bas-12", "bis-bas-13", "bis-bas-14", "bis-bas-15", "bis-bas-16",
|
|
90
|
+
"bis-bas-17", "bis-bas-18", "bis-bas-19", "bis-bas-20",
|
|
91
|
+
],
|
|
92
|
+
},
|
|
93
|
+
{
|
|
94
|
+
id: "bas-drive",
|
|
95
|
+
label: { en: "BAS — Drive" },
|
|
96
|
+
questionIds: [
|
|
97
|
+
"bis-bas-21", "bis-bas-22", "bis-bas-23", "bis-bas-24", "bis-bas-25", "bis-bas-26",
|
|
98
|
+
"bis-bas-27", "bis-bas-28", "bis-bas-29", "bis-bas-30",
|
|
99
|
+
],
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
id: "bas-reward-responsiveness",
|
|
103
|
+
label: { en: "BAS — Reward responsiveness" },
|
|
104
|
+
questionIds: [
|
|
105
|
+
"bis-bas-31", "bis-bas-32", "bis-bas-33", "bis-bas-34", "bis-bas-35", "bis-bas-36",
|
|
106
|
+
],
|
|
107
|
+
},
|
|
108
|
+
],
|
|
109
|
+
},
|
|
110
|
+
meta: {
|
|
111
|
+
reference: "Goldberg, L. R., Johnson, J. A., Eber, H. W., Hogan, R., Ashton, M. C., Cloninger, C. R., & Gough, H. G. (2006). The International Personality Item Pool and the future of public-domain personality measures. Journal of Research in Personality, 40(1), 84-96. Constructs after Carver, C. S., & White, T. L. (1994). Behavioral inhibition, behavioral activation, and affective responses to impending reward and punishment: The BIS/BAS scales. Journal of Personality and Social Psychology, 67(2), 319-333.",
|
|
112
|
+
license: "Free — public domain (International Personality Item Pool, ipip.ori.org). IPIP states that permission is automatically granted to any person to use IPIP items, scales, and inventories for any purpose, commercial or non-commercial; no attribution is required.",
|
|
113
|
+
licenseFlag: "free",
|
|
114
|
+
scoringNote: "Four subscale sums (BIS 10 items 10-50; BAS fun-seeking 10 items 10-50; BAS drive 10 items 10-50; BAS reward responsiveness 6 items 6-30), 10 of the 36 items reverse-keyed. Summing is IPIP's own published scoring rule (ipip.ori.org/newScoringInstructions.htm); divide by the item count for the item mean. The prorating threshold is a single number across subscales, so it is set to the strictest value the 6-item subscale allows (>=5), which is 5 of 6 there and 5 of 10 on the others — an implementation choice, not part of the published scoring.",
|
|
115
|
+
translationProvenance: "en: item stems reproduced from the IPIP scoring key at https://ipip.ori.org/newBIS_BASkey.htm, rendered as first-person sentences (\"Am the life of the party.\" -> \"I am the life of the party\"). Other locales (tr, de, zh, es): AI translation (Anthropic Claude, claude-opus-5) from that English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
|
|
116
|
+
note: "IPIP labels these its *preliminary* scales for the BIS/BAS constructs. They measure constructs similar to those of the Carver and White (1994) BIS/BAS scales rather than reproducing them; IPIP reports correlations with the original scales of .69 (BIS), .63 (fun-seeking), .54 (drive), and .41 (reward responsiveness), .86/.92/.72/.59 corrected for unreliability. Descriptive trait scores, not a clinical screen — no cutoff bands exist.",
|
|
117
|
+
},
|
|
118
|
+
};
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type { AssessmentDefinition } from "../types.ts";
|
|
2
|
+
/**
|
|
3
|
+
* CBI — Copenhagen Burnout Inventory (Kristensen, Borritz, Villadsen &
|
|
4
|
+
* Christensen, 2005).
|
|
5
|
+
*
|
|
6
|
+
* 19 items in three independent scales: personal burnout (6), work-related
|
|
7
|
+
* burnout (7), and client-related burnout (6). Each scale is scored on its
|
|
8
|
+
* own; there is no total across all 19, because the three ask about
|
|
9
|
+
* different attributions of the same exhaustion.
|
|
10
|
+
*
|
|
11
|
+
* Two response scales are mixed within the work and client scales — the
|
|
12
|
+
* degree scale on the items phrased as "is your work..." and the frequency
|
|
13
|
+
* scale on those phrased as "how often...". Both map to the same 100/75/50/
|
|
14
|
+
* 25/0 key, which is why the published score for each scale is the mean of
|
|
15
|
+
* its items on a 0–100 range. psytools reports subscale sums; divide by 6,
|
|
16
|
+
* 7, and 6 to get the published figure (the same convention the ECR-R, ERQ
|
|
17
|
+
* and HSPS entries follow).
|
|
18
|
+
*
|
|
19
|
+
* One item is reverse-keyed: work-burnout item 7, on having energy left for
|
|
20
|
+
* family and friends, where more energy means less burnout.
|
|
21
|
+
*
|
|
22
|
+
* No cutoffs are defined. The authors publish population norms (Danish
|
|
23
|
+
* means around 32 for personal burnout) rather than severity thresholds, so
|
|
24
|
+
* no bands are declared — see SOURCES.md.
|
|
25
|
+
*
|
|
26
|
+
* Item text is reproduced from the authors' own English first edition
|
|
27
|
+
* (February 2004), hosted by NFA, Denmark's National Research Centre for
|
|
28
|
+
* the Working Environment. Rights: no first-party grant exists — read the
|
|
29
|
+
* SOURCES.md entry before shipping this commercially.
|
|
30
|
+
*/
|
|
31
|
+
export declare const cbi: AssessmentDefinition;
|