psytools 0.3.0 → 0.3.2

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 (61) hide show
  1. package/README.md +37 -16
  2. package/SOURCES.md +81 -0
  3. package/dist/cjs/assessment.d.ts +3 -2
  4. package/dist/cjs/assessment.js +13 -3
  5. package/dist/cjs/evaluation.d.ts +5 -3
  6. package/dist/cjs/evaluation.js +49 -8
  7. package/dist/cjs/index.d.ts +2 -2
  8. package/dist/cjs/index.js +6 -1
  9. package/dist/cjs/inventories/aq10.d.ts +12 -0
  10. package/dist/cjs/inventories/aq10.js +183 -0
  11. package/dist/cjs/inventories/asrs6.d.ts +11 -0
  12. package/dist/cjs/inventories/asrs6.js +130 -0
  13. package/dist/cjs/inventories/audit.d.ts +10 -0
  14. package/dist/cjs/inventories/audit.js +231 -0
  15. package/dist/cjs/inventories/dass21.js +3 -1
  16. package/dist/cjs/inventories/gad7.js +3 -1
  17. package/dist/cjs/inventories/index.d.ts +7 -2
  18. package/dist/cjs/inventories/index.js +16 -1
  19. package/dist/cjs/inventories/mini-ipip.d.ts +11 -0
  20. package/dist/cjs/inventories/mini-ipip.js +272 -0
  21. package/dist/cjs/inventories/phq9.js +3 -1
  22. package/dist/cjs/inventories/who5.d.ts +11 -0
  23. package/dist/cjs/inventories/who5.js +152 -0
  24. package/dist/cjs/types.d.ts +24 -2
  25. package/dist/esm/assessment.d.ts +3 -2
  26. package/dist/esm/assessment.js +13 -3
  27. package/dist/esm/evaluation.d.ts +5 -3
  28. package/dist/esm/evaluation.js +49 -8
  29. package/dist/esm/index.d.ts +2 -2
  30. package/dist/esm/index.js +1 -1
  31. package/dist/esm/inventories/aq10.d.ts +12 -0
  32. package/dist/esm/inventories/aq10.js +180 -0
  33. package/dist/esm/inventories/asrs6.d.ts +11 -0
  34. package/dist/esm/inventories/asrs6.js +127 -0
  35. package/dist/esm/inventories/audit.d.ts +10 -0
  36. package/dist/esm/inventories/audit.js +228 -0
  37. package/dist/esm/inventories/dass21.js +3 -1
  38. package/dist/esm/inventories/gad7.js +3 -1
  39. package/dist/esm/inventories/index.d.ts +7 -2
  40. package/dist/esm/inventories/index.js +11 -1
  41. package/dist/esm/inventories/mini-ipip.d.ts +11 -0
  42. package/dist/esm/inventories/mini-ipip.js +269 -0
  43. package/dist/esm/inventories/phq9.js +3 -1
  44. package/dist/esm/inventories/who5.d.ts +11 -0
  45. package/dist/esm/inventories/who5.js +149 -0
  46. package/dist/esm/types.d.ts +24 -2
  47. package/package.json +14 -3
  48. package/schema/assessment-definition.schema.json +27 -1
  49. package/src/assessment.ts +14 -3
  50. package/src/evaluation.ts +55 -9
  51. package/src/index.ts +7 -0
  52. package/src/inventories/aq10.ts +185 -0
  53. package/src/inventories/asrs6.ts +132 -0
  54. package/src/inventories/audit.ts +234 -0
  55. package/src/inventories/dass21.ts +4 -1
  56. package/src/inventories/gad7.ts +4 -1
  57. package/src/inventories/index.ts +20 -2
  58. package/src/inventories/mini-ipip.ts +274 -0
  59. package/src/inventories/phq9.ts +4 -1
  60. package/src/inventories/who5.ts +153 -0
  61. package/src/types.ts +26 -2
@@ -285,7 +285,10 @@ export const dass21: AssessmentDefinition = {
285
285
  meta: {
286
286
  reference:
287
287
  "Lovibond, S. H., & Lovibond, P. F. (1995). Manual for the Depression Anxiety Stress Scales (2nd ed.). Sydney: Psychology Foundation.",
288
- license: "Public domain",
288
+ license: "Free — public domain per the official DASS site, including translations",
289
+ licenseFlag: "free",
290
+ translationProvenance:
291
+ "en: reproduced from the original. tr/de: AI translation (Anthropic Claude, claude-fable-5) from the original English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
289
292
  timeframe: "past week",
290
293
  },
291
294
  };
@@ -115,7 +115,10 @@ export const gad7: AssessmentDefinition = {
115
115
  meta: {
116
116
  reference:
117
117
  "Spitzer, R. L., Kroenke, K., Williams, J. B., & Löwe, B. (2006). A brief measure for assessing generalized anxiety disorder: the GAD-7. Archives of Internal Medicine, 166(10), 1092-1097.",
118
- license: "Public domain",
118
+ license: "Free — no permission required to reproduce, translate, display or distribute (Pfizer educational grant)",
119
+ licenseFlag: "free",
120
+ translationProvenance:
121
+ "en: reproduced from the original. tr/de: AI translation (Anthropic Claude, claude-fable-5) from the original English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
119
122
  timeframe: "past 2 weeks",
120
123
  },
121
124
  };
@@ -4,8 +4,13 @@ import { PsytoolsError } from "../errors.ts";
4
4
  import { phq9 } from "./phq9.ts";
5
5
  import { gad7 } from "./gad7.ts";
6
6
  import { dass21 } from "./dass21.ts";
7
+ import { who5 } from "./who5.ts";
8
+ import { asrs6 } from "./asrs6.ts";
9
+ import { aq10 } from "./aq10.ts";
10
+ import { audit } from "./audit.ts";
11
+ import { miniIpip } from "./mini-ipip.ts";
7
12
 
8
- export { phq9, gad7, dass21 };
13
+ export { phq9, gad7, dass21, who5, asrs6, aq10, audit, miniIpip };
9
14
  export { twoWeekFrequencyOptions, twoWeekInstructions } from "./common.ts";
10
15
 
11
16
  /** All predefined inventory definitions shipped with psytools, by id. */
@@ -13,9 +18,22 @@ export const inventories: Readonly<Record<string, AssessmentDefinition>> = {
13
18
  phq9,
14
19
  gad7,
15
20
  dass21,
21
+ who5,
22
+ asrs6,
23
+ aq10,
24
+ audit,
25
+ "mini-ipip": miniIpip,
16
26
  };
17
27
 
18
- export type InventoryId = "phq9" | "gad7" | "dass21";
28
+ export type InventoryId =
29
+ | "phq9"
30
+ | "gad7"
31
+ | "dass21"
32
+ | "who5"
33
+ | "asrs6"
34
+ | "aq10"
35
+ | "audit"
36
+ | "mini-ipip";
19
37
 
20
38
  /**
21
39
  * Instantiates a predefined inventory as an `Assessment`.
@@ -0,0 +1,274 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+
3
+ /**
4
+ * Mini-IPIP — 20-item short form of the International Personality Item
5
+ * Pool Five-Factor Model measure (Donnellan et al., 2006).
6
+ *
7
+ * Measures the Big Five personality traits with 4 items each on a 1–5
8
+ * accuracy scale; half the items are reverse-keyed. Trait scores are
9
+ * descriptive (4–20 per trait, higher = more of the trait) — there are no
10
+ * clinical cutoffs, so no bands are defined. IPIP items are public domain.
11
+ */
12
+ export const miniIpip: AssessmentDefinition = {
13
+ id: "mini-ipip",
14
+ version: "1.0.0",
15
+ title: {
16
+ en: "Mini-IPIP Big Five Personality Scale",
17
+ tr: "Mini-IPIP Beş Faktör Kişilik Ölçeği",
18
+ de: "Mini-IPIP Big-Five-Persönlichkeitsskala",
19
+ },
20
+ description: {
21
+ en: "A 20-item public-domain measure of the Big Five personality traits (extraversion, agreeableness, conscientiousness, neuroticism, openness), drawn from the International Personality Item Pool.",
22
+ tr: "Uluslararası Kişilik Madde Havuzu'ndan (IPIP) türetilmiş, Beş Faktör kişilik özelliklerini (dışadönüklük, uyumluluk, sorumluluk, duygusal dengesizlik, deneyime açıklık) ölçen 20 maddelik kamu malı bir ölçek.",
23
+ de: "Ein gemeinfreies 20-Item-Instrument zur Messung der Big-Five-Persönlichkeitsmerkmale (Extraversion, Verträglichkeit, Gewissenhaftigkeit, Neurotizismus, Offenheit) aus dem International Personality Item Pool.",
24
+ },
25
+ instructions: {
26
+ en: "Describe yourself as you generally are now, not as you wish to be in the future. Indicate how accurately each statement describes you.",
27
+ tr: "Kendinizi gelecekte olmak istediğiniz gibi değil, şu anda genel olarak olduğunuz gibi tanımlayın. Her ifadenin sizi ne kadar doğru tanımladığını belirtin.",
28
+ de: "Beschreiben Sie sich so, wie Sie im Allgemeinen jetzt sind, nicht wie Sie in Zukunft sein möchten. Geben Sie an, wie zutreffend jede Aussage Sie beschreibt.",
29
+ },
30
+ defaultLocale: "en",
31
+ options: [
32
+ {
33
+ value: 1,
34
+ label: { en: "Very inaccurate", tr: "Bana hiç uymuyor", de: "Trifft überhaupt nicht zu" },
35
+ },
36
+ {
37
+ value: 2,
38
+ label: { en: "Moderately inaccurate", tr: "Bana pek uymuyor", de: "Trifft eher nicht zu" },
39
+ },
40
+ {
41
+ value: 3,
42
+ label: {
43
+ en: "Neither accurate nor inaccurate",
44
+ tr: "Ne uyuyor ne uymuyor",
45
+ de: "Weder zutreffend noch unzutreffend",
46
+ },
47
+ },
48
+ {
49
+ value: 4,
50
+ label: { en: "Moderately accurate", tr: "Bana oldukça uyuyor", de: "Trifft eher zu" },
51
+ },
52
+ {
53
+ value: 5,
54
+ label: { en: "Very accurate", tr: "Bana tamamen uyuyor", de: "Trifft voll und ganz zu" },
55
+ },
56
+ ],
57
+ questions: [
58
+ {
59
+ id: "mini-ipip-1",
60
+ text: {
61
+ en: "I am the life of the party",
62
+ tr: "Bulunduğum ortamın neşe kaynağıyımdır",
63
+ de: "Ich bin der Mittelpunkt jeder Party",
64
+ },
65
+ },
66
+ {
67
+ id: "mini-ipip-2",
68
+ text: {
69
+ en: "I sympathize with others' feelings",
70
+ tr: "Başkalarının duygularını paylaşırım",
71
+ de: "Ich fühle mit anderen mit",
72
+ },
73
+ },
74
+ {
75
+ id: "mini-ipip-3",
76
+ text: {
77
+ en: "I get chores done right away",
78
+ tr: "Günlük işlerimi hemen hallederim",
79
+ de: "Ich erledige anstehende Aufgaben sofort",
80
+ },
81
+ },
82
+ {
83
+ id: "mini-ipip-4",
84
+ text: {
85
+ en: "I have frequent mood swings",
86
+ tr: "Ruh halim sık sık değişir",
87
+ de: "Meine Stimmung schwankt häufig",
88
+ },
89
+ },
90
+ {
91
+ id: "mini-ipip-5",
92
+ text: {
93
+ en: "I have a vivid imagination",
94
+ tr: "Canlı bir hayal gücüm vardır",
95
+ de: "Ich habe eine lebhafte Fantasie",
96
+ },
97
+ },
98
+ {
99
+ id: "mini-ipip-6",
100
+ text: {
101
+ en: "I don't talk a lot",
102
+ tr: "Çok konuşmam",
103
+ de: "Ich rede nicht viel",
104
+ },
105
+ reverseScored: true,
106
+ },
107
+ {
108
+ id: "mini-ipip-7",
109
+ text: {
110
+ en: "I am not interested in other people's problems",
111
+ tr: "Başkalarının sorunlarıyla ilgilenmem",
112
+ de: "Die Probleme anderer Menschen interessieren mich nicht",
113
+ },
114
+ reverseScored: true,
115
+ },
116
+ {
117
+ id: "mini-ipip-8",
118
+ text: {
119
+ en: "I often forget to put things back in their proper place",
120
+ tr: "Eşyaları yerine koymayı sık sık unuturum",
121
+ de: "Ich vergesse oft, Dinge an ihren Platz zurückzulegen",
122
+ },
123
+ reverseScored: true,
124
+ },
125
+ {
126
+ id: "mini-ipip-9",
127
+ text: {
128
+ en: "I am relaxed most of the time",
129
+ tr: "Çoğu zaman rahat ve sakinimdir",
130
+ de: "Ich bin die meiste Zeit entspannt",
131
+ },
132
+ reverseScored: true,
133
+ },
134
+ {
135
+ id: "mini-ipip-10",
136
+ text: {
137
+ en: "I am not interested in abstract ideas",
138
+ tr: "Soyut fikirlerle ilgilenmem",
139
+ de: "Ich interessiere mich nicht für abstrakte Ideen",
140
+ },
141
+ reverseScored: true,
142
+ },
143
+ {
144
+ id: "mini-ipip-11",
145
+ text: {
146
+ en: "I talk to a lot of different people at parties",
147
+ tr: "Sosyal ortamlarda birçok farklı insanla konuşurum",
148
+ de: "Auf Partys spreche ich mit vielen verschiedenen Leuten",
149
+ },
150
+ },
151
+ {
152
+ id: "mini-ipip-12",
153
+ text: {
154
+ en: "I feel others' emotions",
155
+ tr: "Başkalarının duygularını hissederim",
156
+ de: "Ich spüre die Gefühle anderer",
157
+ },
158
+ },
159
+ {
160
+ id: "mini-ipip-13",
161
+ text: {
162
+ en: "I like order",
163
+ tr: "Düzeni severim",
164
+ de: "Ich mag Ordnung",
165
+ },
166
+ },
167
+ {
168
+ id: "mini-ipip-14",
169
+ text: {
170
+ en: "I get upset easily",
171
+ tr: "Kolayca keyfim kaçar",
172
+ de: "Ich rege mich leicht auf",
173
+ },
174
+ },
175
+ {
176
+ id: "mini-ipip-15",
177
+ text: {
178
+ en: "I have difficulty understanding abstract ideas",
179
+ tr: "Soyut fikirleri anlamakta zorlanırım",
180
+ de: "Es fällt mir schwer, abstrakte Ideen zu verstehen",
181
+ },
182
+ reverseScored: true,
183
+ },
184
+ {
185
+ id: "mini-ipip-16",
186
+ text: {
187
+ en: "I keep in the background",
188
+ tr: "Arka planda kalmayı tercih ederim",
189
+ de: "Ich halte mich im Hintergrund",
190
+ },
191
+ reverseScored: true,
192
+ },
193
+ {
194
+ id: "mini-ipip-17",
195
+ text: {
196
+ en: "I am not really interested in others",
197
+ tr: "Başkalarıyla pek ilgilenmem",
198
+ de: "Ich interessiere mich nicht wirklich für andere",
199
+ },
200
+ reverseScored: true,
201
+ },
202
+ {
203
+ id: "mini-ipip-18",
204
+ text: {
205
+ en: "I make a mess of things",
206
+ tr: "Ortalığı dağınık bırakırım",
207
+ de: "Bei mir geht alles drunter und drüber",
208
+ },
209
+ reverseScored: true,
210
+ },
211
+ {
212
+ id: "mini-ipip-19",
213
+ text: {
214
+ en: "I seldom feel blue",
215
+ tr: "Nadiren hüzünlenirim",
216
+ de: "Ich fühle mich selten niedergeschlagen",
217
+ },
218
+ reverseScored: true,
219
+ },
220
+ {
221
+ id: "mini-ipip-20",
222
+ text: {
223
+ en: "I do not have a good imagination",
224
+ tr: "İyi bir hayal gücüm yoktur",
225
+ de: "Ich habe keine gute Vorstellungskraft",
226
+ },
227
+ reverseScored: true,
228
+ },
229
+ ],
230
+ scoring: {
231
+ kind: "subscales",
232
+ subscales: [
233
+ {
234
+ id: "extraversion",
235
+ label: { en: "Extraversion", tr: "Dışadönüklük", de: "Extraversion" },
236
+ questionIds: ["mini-ipip-1", "mini-ipip-6", "mini-ipip-11", "mini-ipip-16"],
237
+ },
238
+ {
239
+ id: "agreeableness",
240
+ label: { en: "Agreeableness", tr: "Uyumluluk", de: "Verträglichkeit" },
241
+ questionIds: ["mini-ipip-2", "mini-ipip-7", "mini-ipip-12", "mini-ipip-17"],
242
+ },
243
+ {
244
+ id: "conscientiousness",
245
+ label: { en: "Conscientiousness", tr: "Sorumluluk", de: "Gewissenhaftigkeit" },
246
+ questionIds: ["mini-ipip-3", "mini-ipip-8", "mini-ipip-13", "mini-ipip-18"],
247
+ },
248
+ {
249
+ id: "neuroticism",
250
+ label: { en: "Neuroticism", tr: "Duygusal Dengesizlik", de: "Neurotizismus" },
251
+ questionIds: ["mini-ipip-4", "mini-ipip-9", "mini-ipip-14", "mini-ipip-19"],
252
+ },
253
+ {
254
+ id: "openness",
255
+ label: {
256
+ en: "Openness (Intellect/Imagination)",
257
+ tr: "Deneyime Açıklık",
258
+ de: "Offenheit (Intellekt/Vorstellungskraft)",
259
+ },
260
+ questionIds: ["mini-ipip-5", "mini-ipip-10", "mini-ipip-15", "mini-ipip-20"],
261
+ },
262
+ ],
263
+ },
264
+ meta: {
265
+ reference:
266
+ "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.",
267
+ license:
268
+ "Free — public domain (International Personality Item Pool, ipip.ori.org), created explicitly to be free of copyright restrictions",
269
+ licenseFlag: "free",
270
+ translationProvenance:
271
+ "en: reproduced from the original. tr/de: AI translation (Anthropic Claude, claude-fable-5) from the original English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
272
+ note: "Descriptive personality traits, not a clinical screen — no cutoff bands are defined.",
273
+ },
274
+ };
@@ -150,7 +150,10 @@ export const phq9: AssessmentDefinition = {
150
150
  meta: {
151
151
  reference:
152
152
  "Kroenke, K., Spitzer, R. L., & Williams, J. B. (2001). The PHQ-9: validity of a brief depression severity measure. Journal of General Internal Medicine, 16(9), 606-613.",
153
- license: "Public domain",
153
+ license: "Free — no permission required to reproduce, translate, display or distribute (Pfizer educational grant)",
154
+ licenseFlag: "free",
155
+ translationProvenance:
156
+ "en: reproduced from the original. tr/de: AI translation (Anthropic Claude, claude-fable-5) from the original English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
154
157
  timeframe: "past 2 weeks",
155
158
  },
156
159
  };
@@ -0,0 +1,153 @@
1
+ import type { AssessmentDefinition } from "../types.ts";
2
+
3
+ /**
4
+ * WHO-5 — World Health Organization Well-Being Index.
5
+ *
6
+ * 5 positively worded items, 0–5 frequency scale over the past two weeks.
7
+ * The raw sum (0–25) is multiplied by 4 and reported as a 0–100 percentage;
8
+ * higher scores mean better well-being. A score of 50 or below indicates
9
+ * reduced well-being and warrants screening for depression; 28 or below
10
+ * indicates likely depression (Topp et al., 2015). Free to use.
11
+ */
12
+ export const who5: AssessmentDefinition = {
13
+ id: "who5",
14
+ version: "1.0.0",
15
+ title: {
16
+ en: "WHO-5 Well-Being Index",
17
+ tr: "WHO-5 İyilik Hali İndeksi",
18
+ de: "WHO-5-Index zum Wohlbefinden",
19
+ },
20
+ description: {
21
+ en: "A 5-item self-report scale measuring subjective psychological well-being over the past two weeks. Higher scores mean better well-being.",
22
+ tr: "Son iki hafta içindeki öznel psikolojik iyilik halini ölçen 5 maddelik bir öz bildirim ölçeği. Yüksek puan daha iyi bir iyilik haline işaret eder.",
23
+ de: "Eine Selbstbeurteilungsskala mit 5 Items zur Messung des subjektiven psychischen Wohlbefindens in den letzten zwei Wochen. Höhere Werte bedeuten besseres Wohlbefinden.",
24
+ },
25
+ instructions: {
26
+ en: "Please indicate for each of the five statements which is closest to how you have been feeling over the last two weeks.",
27
+ tr: "Lütfen aşağıdaki beş ifadenin her biri için, son iki hafta içinde kendinizi nasıl hissettiğinize en yakın olan seçeneği işaretleyin.",
28
+ de: "Bitte geben Sie für jede der fünf Aussagen an, welche Antwort Ihrem Befinden in den letzten zwei Wochen am nächsten kommt.",
29
+ },
30
+ defaultLocale: "en",
31
+ options: [
32
+ {
33
+ value: 0,
34
+ label: { en: "At no time", tr: "Hiçbir zaman", de: "Zu keinem Zeitpunkt" },
35
+ },
36
+ {
37
+ value: 1,
38
+ label: { en: "Some of the time", tr: "Bazen", de: "Ab und zu" },
39
+ },
40
+ {
41
+ value: 2,
42
+ label: {
43
+ en: "Less than half of the time",
44
+ tr: "Zamanın yarısından az",
45
+ de: "Etwas weniger als die Hälfte der Zeit",
46
+ },
47
+ },
48
+ {
49
+ value: 3,
50
+ label: {
51
+ en: "More than half of the time",
52
+ tr: "Zamanın yarısından çok",
53
+ de: "Etwas mehr als die Hälfte der Zeit",
54
+ },
55
+ },
56
+ {
57
+ value: 4,
58
+ label: { en: "Most of the time", tr: "Çoğu zaman", de: "Meistens" },
59
+ },
60
+ {
61
+ value: 5,
62
+ label: { en: "All of the time", tr: "Her zaman", de: "Die ganze Zeit" },
63
+ },
64
+ ],
65
+ questions: [
66
+ {
67
+ id: "who5-1",
68
+ text: {
69
+ en: "I have felt cheerful and in good spirits",
70
+ tr: "Kendimi neşeli ve keyifli hissettim",
71
+ de: "Ich war froh und guter Laune",
72
+ },
73
+ },
74
+ {
75
+ id: "who5-2",
76
+ text: {
77
+ en: "I have felt calm and relaxed",
78
+ tr: "Kendimi sakin ve rahatlamış hissettim",
79
+ de: "Ich habe mich ruhig und entspannt gefühlt",
80
+ },
81
+ },
82
+ {
83
+ id: "who5-3",
84
+ text: {
85
+ en: "I have felt active and vigorous",
86
+ tr: "Kendimi aktif ve dinç hissettim",
87
+ de: "Ich habe mich energisch und aktiv gefühlt",
88
+ },
89
+ },
90
+ {
91
+ id: "who5-4",
92
+ text: {
93
+ en: "I woke up feeling fresh and rested",
94
+ tr: "Uyandığımda kendimi dinlenmiş ve zinde hissettim",
95
+ de: "Ich habe mich beim Aufwachen frisch und ausgeruht gefühlt",
96
+ },
97
+ },
98
+ {
99
+ id: "who5-5",
100
+ text: {
101
+ en: "My daily life has been filled with things that interest me",
102
+ tr: "Günlük yaşamım ilgimi çeken şeylerle doluydu",
103
+ de: "Mein Alltag war voller Dinge, die mich interessieren",
104
+ },
105
+ },
106
+ ],
107
+ scoring: {
108
+ kind: "sum",
109
+ multiplier: 4,
110
+ bands: [
111
+ {
112
+ id: "low",
113
+ min: 0,
114
+ max: 28,
115
+ label: {
116
+ en: "Low well-being — indicates likely depression, assessment recommended",
117
+ tr: "Düşük iyilik hali — olası depresyona işaret eder, değerlendirme önerilir",
118
+ de: "Niedriges Wohlbefinden — Hinweis auf wahrscheinliche Depression, Abklärung empfohlen",
119
+ },
120
+ },
121
+ {
122
+ id: "reduced",
123
+ min: 29,
124
+ max: 50,
125
+ label: {
126
+ en: "Reduced well-being — screening for depression recommended",
127
+ tr: "Azalmış iyilik hali — depresyon taraması önerilir",
128
+ de: "Vermindertes Wohlbefinden — Depressionsscreening empfohlen",
129
+ },
130
+ },
131
+ {
132
+ id: "good",
133
+ min: 51,
134
+ max: 100,
135
+ label: {
136
+ en: "Good well-being",
137
+ tr: "İyi düzeyde iyilik hali",
138
+ de: "Gutes Wohlbefinden",
139
+ },
140
+ },
141
+ ],
142
+ },
143
+ meta: {
144
+ reference:
145
+ "Topp, C. W., Østergaard, S. D., Søndergaard, S., & Bech, P. (2015). The WHO-5 Well-Being Index: a systematic review of the literature. Psychotherapy and Psychosomatics, 84(3), 167-176.",
146
+ license: "Free — may be used without permission (WHO Regional Office for Europe / Psychiatric Research Unit, Hillerød)",
147
+ licenseFlag: "free",
148
+ translationProvenance:
149
+ "en: reproduced from the original. tr/de: AI translation (Anthropic Claude, claude-fable-5) from the original English; official translations were not consulted and the texts are unverified. See SOURCES.md.",
150
+ timeframe: "past 2 weeks",
151
+ note: "Positively worded: higher scores mean better well-being.",
152
+ },
153
+ };
package/src/types.ts CHANGED
@@ -66,7 +66,9 @@ export interface ScoreFlag {
66
66
  /** Sums all answers into a single total score (PHQ-9, GAD-7, ...). */
67
67
  export interface SumScoring {
68
68
  kind: "sum";
69
- /** Severity bands the total is matched against. */
69
+ /** Multiplier applied to the raw sum (WHO-5 reports raw x 4 as 0-100). */
70
+ multiplier?: number;
71
+ /** Severity bands the (multiplied) total is matched against. */
70
72
  bands?: ScoreBand[];
71
73
  flags?: ScoreFlag[];
72
74
  }
@@ -90,8 +92,30 @@ export interface SubscaleScoring {
90
92
  flags?: ScoreFlag[];
91
93
  }
92
94
 
95
+ /** One item of a `count` scoring: when it counts as screen-positive. */
96
+ export interface CountScoringItem {
97
+ questionId: string;
98
+ /**
99
+ * The item counts as positive when its answer value is >= this.
100
+ * `reverseScored` questions are inverted against their scale first.
101
+ */
102
+ minValue: number;
103
+ }
104
+
105
+ /**
106
+ * Counts how many items cross their per-item threshold (ASRS v1.1,
107
+ * AQ-10, ...). The score is the number of positive items.
108
+ */
109
+ export interface CountScoring {
110
+ kind: "count";
111
+ items: CountScoringItem[];
112
+ /** Bands the positive-item count is matched against. */
113
+ bands?: ScoreBand[];
114
+ flags?: ScoreFlag[];
115
+ }
116
+
93
117
  /** Declarative, serializable scoring rules built into psytools. */
94
- export type ScoringDefinition = SumScoring | SubscaleScoring;
118
+ export type ScoringDefinition = SumScoring | SubscaleScoring | CountScoring;
95
119
 
96
120
  /**
97
121
  * The complete, serializable description of an assessment.