psytools 0.3.1 → 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.
- package/README.md +4 -1
- package/SOURCES.md +61 -33
- package/dist/cjs/index.d.ts +1 -1
- package/dist/cjs/index.js +3 -1
- package/dist/cjs/inventories/aq10.js +3 -1
- package/dist/cjs/inventories/asrs6.js +3 -1
- package/dist/cjs/inventories/audit.d.ts +10 -0
- package/dist/cjs/inventories/audit.js +231 -0
- package/dist/cjs/inventories/dass21.js +3 -1
- package/dist/cjs/inventories/gad7.js +3 -1
- package/dist/cjs/inventories/index.d.ts +4 -2
- package/dist/cjs/inventories/index.js +7 -1
- package/dist/cjs/inventories/mini-ipip.d.ts +11 -0
- package/dist/cjs/inventories/mini-ipip.js +272 -0
- package/dist/cjs/inventories/phq9.js +3 -1
- package/dist/cjs/inventories/who5.js +3 -1
- package/dist/esm/index.d.ts +1 -1
- package/dist/esm/index.js +1 -1
- package/dist/esm/inventories/aq10.js +3 -1
- package/dist/esm/inventories/asrs6.js +3 -1
- package/dist/esm/inventories/audit.d.ts +10 -0
- package/dist/esm/inventories/audit.js +228 -0
- package/dist/esm/inventories/dass21.js +3 -1
- package/dist/esm/inventories/gad7.js +3 -1
- package/dist/esm/inventories/index.d.ts +4 -2
- package/dist/esm/inventories/index.js +5 -1
- package/dist/esm/inventories/mini-ipip.d.ts +11 -0
- package/dist/esm/inventories/mini-ipip.js +269 -0
- package/dist/esm/inventories/phq9.js +3 -1
- package/dist/esm/inventories/who5.js +3 -1
- package/package.json +6 -2
- package/src/index.ts +2 -0
- package/src/inventories/aq10.ts +5 -1
- package/src/inventories/asrs6.ts +5 -1
- package/src/inventories/audit.ts +234 -0
- package/src/inventories/dass21.ts +4 -1
- package/src/inventories/gad7.ts +4 -1
- package/src/inventories/index.ts +14 -2
- package/src/inventories/mini-ipip.ts +274 -0
- package/src/inventories/phq9.ts +4 -1
- package/src/inventories/who5.ts +4 -1
package/README.md
CHANGED
|
@@ -87,6 +87,8 @@ const response = AssessmentResponse.parse(assessment, rowFromDb); // answers re-
|
|
|
87
87
|
| `who5` | WHO-5 Well-Being Index | 5 | Sum × 4 → 0–100 (higher is better), 3 well-being bands | en, tr, de |
|
|
88
88
|
| `asrs6` | Adult ADHD Self-Report Scale (ASRS-v1.1) screener | 6 | Count of screen-positive items (per-item thresholds), ≥4 positive | en, tr, de |
|
|
89
89
|
| `aq10` | Autism Spectrum Quotient (AQ-10, adult) | 10 | 1 point per item in trait direction (agree/disagree), ≥6 refer | en, tr, de |
|
|
90
|
+
| `audit` | Alcohol Use Disorders Identification Test (WHO) | 10 | Sum 0–40 with per-question point systems, 4 WHO risk zones | en, tr, de |
|
|
91
|
+
| `mini-ipip` | Mini-IPIP Big Five personality scale | 20 | 5 trait subscales (4–20 each), reverse-keyed items, no cutoffs | en, tr, de |
|
|
90
92
|
|
|
91
93
|
```ts
|
|
92
94
|
import { loadInventory, inventories, dass21 } from "psytools";
|
|
@@ -200,7 +202,8 @@ npm run build # ESM + CJS + type declarations into dist/
|
|
|
200
202
|
|
|
201
203
|
- **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.
|
|
202
204
|
- **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.
|
|
203
|
-
- **Instrument licensing
|
|
205
|
+
- **Instrument licensing.** [SOURCES.md](SOURCES.md) flags every bundled instrument as **Free** (PHQ-9, GAD-7, DASS-21, WHO-5 — usable without permission, including commercially) or **Free with conditions** (ASRS v1.1, AQ-10 — free for clinical/research use; verify with the rights holder before embedding in commercial products). Each inventory's `meta.licenseFlag` carries the same flag programmatically.
|
|
206
|
+
- **Translation provenance.** English texts are reproduced from the original instruments. Turkish and German texts are AI translations (Anthropic Claude, model `claude-fable-5`) of the original English — official translations were **not** consulted and the texts are unverified; see [SOURCES.md](SOURCES.md). Obtain and compare the official version for your language before clinical use. Corrections: <samed@luckys.dev>.
|
|
204
207
|
|
|
205
208
|
## License
|
|
206
209
|
|
package/SOURCES.md
CHANGED
|
@@ -1,53 +1,81 @@
|
|
|
1
|
-
# Sources &
|
|
1
|
+
# Sources, licenses & translations
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
psytools is integrated into real products, so this file states precisely — per instrument — where every text comes from, who holds the rights, and what you are allowed to do with it. Each inventory also carries a machine-readable summary in its `meta` field.
|
|
4
4
|
|
|
5
|
-
**Corrections and requests:** if you find a wording that deviates from an official version, hold rights to an instrument, or want an instrument added or removed,
|
|
5
|
+
**Corrections and requests:** if you find a wording that deviates from an official version, hold rights to an instrument, or want an instrument added, corrected, or removed, email <samed@luckys.dev> or open an issue at <https://github.com/urtuba/psytools/issues>.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## License flags
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
9
|
+
| Flag | Meaning |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| **Free** | Public domain or explicitly free for any use, including commercial products, without permission. |
|
|
12
|
+
| **Free with conditions** | Free for clinical and research use as distributed; embedding in commercial products is not explicitly licensed — verify with the rights holder before shipping. |
|
|
13
|
+
| **Research only** | Usable in research contexts only. *(No bundled instrument currently carries this flag, and none will be added without it being stated here.)* |
|
|
14
|
+
|
|
15
|
+
## Translation provenance — read this before clinical use
|
|
16
|
+
|
|
17
|
+
The same provenance applies to every bundled inventory. If an inventory ever deviates (e.g. an official translation is adopted and verified), it will be stated in its section below.
|
|
18
|
+
|
|
19
|
+
| Language | Text source | Verified against an official version |
|
|
20
|
+
| --- | --- | --- |
|
|
21
|
+
| en | Reproduced from the original published instrument | Yes |
|
|
22
|
+
| tr | AI translation (Anthropic Claude, `claude-fable-5`) from the original English | No |
|
|
23
|
+
| de | AI translation (Anthropic Claude, `claude-fable-5`) from the original English | No |
|
|
24
|
+
|
|
25
|
+
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 Turkish and German 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. Verification contributions from native speakers are very welcome.
|
|
12
26
|
|
|
13
27
|
## PHQ-9 — Patient Health Questionnaire-9 (`phq9`)
|
|
14
28
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
- **
|
|
18
|
-
- **Scoring:** Sum
|
|
29
|
+
**License: Free.** Developed with an educational grant from Pfizer Inc. The copyright holders state that no permission is required to reproduce, translate, display, or distribute the PHQ screeners. Official repository: <https://www.phqscreeners.com>.
|
|
30
|
+
|
|
31
|
+
- **Citation:** Kroenke, K., Spitzer, R. L., & Williams, J. B. W. (2001). The PHQ-9: Validity of a brief depression severity measure. *Journal of General Internal Medicine, 16*(9), 606–613.
|
|
32
|
+
- **Scoring:** Sum 0–27; severity bands per Kroenke et al. (2001). The item-9 `suicidality` flag is an implementation aid, not part of the published instrument.
|
|
19
33
|
|
|
20
34
|
## GAD-7 — Generalized Anxiety Disorder Scale (`gad7`)
|
|
21
35
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
- **
|
|
25
|
-
- **Scoring:** Sum
|
|
36
|
+
**License: Free.** Same rights statement and repository as the PHQ-9 (Pfizer educational grant; no permission required).
|
|
37
|
+
|
|
38
|
+
- **Citation:** Spitzer, R. L., Kroenke, K., Williams, J. B. W., & Löwe, B. (2006). A brief measure for assessing generalized anxiety disorder: The GAD-7. *Archives of Internal Medicine, 166*(10), 1092–1097.
|
|
39
|
+
- **Scoring:** Sum 0–21; severity bands per Spitzer et al. (2006).
|
|
40
|
+
|
|
41
|
+
## DASS-21 — Depression Anxiety Stress Scales, short form (`dass21`)
|
|
42
|
+
|
|
43
|
+
**License: Free.** The official DASS site states the questionnaires and their translations are in the public domain and may be used without permission. Official site: <http://www2.psy.unsw.edu.au/dass/>.
|
|
44
|
+
|
|
45
|
+
- **Citation:** Lovibond, S. H., & Lovibond, P. F. (1995). *Manual for the Depression Anxiety Stress Scales* (2nd ed.). Sydney: Psychology Foundation of Australia.
|
|
46
|
+
- **Scoring:** Three 7-item subscales; sums doubled to match DASS-42 severity cutoffs, per the DASS manual.
|
|
26
47
|
|
|
27
48
|
## WHO-5 — World Health Organization Well-Being Index (`who5`)
|
|
28
49
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
- **
|
|
32
|
-
- **Scoring:** Raw sum (0–25)
|
|
50
|
+
**License: Free.** The WHO-5 may be used without permission; official versions and translations are distributed by the Psychiatric Research Unit, Mental Health Centre North Zealand (on behalf of the WHO Regional Office for Europe).
|
|
51
|
+
|
|
52
|
+
- **Citation:** 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.
|
|
53
|
+
- **Scoring:** Raw sum (0–25) × 4, reported 0–100 (higher is better); cutoffs (≤50 reduced well-being, ≤28 likely depression) per Topp et al. (2015).
|
|
54
|
+
|
|
55
|
+
## AUDIT — Alcohol Use Disorders Identification Test (`audit`)
|
|
56
|
+
|
|
57
|
+
**License: Free.** Developed by the World Health Organization; the WHO's AUDIT manual permits reproduction and use of the questionnaire without permission.
|
|
58
|
+
|
|
59
|
+
- **Citation:** Babor, T. F., Higgins-Biddle, J. C., Saunders, J. B., & Monteiro, M. G. (2001). *AUDIT: The Alcohol Use Disorders Identification Test — Guidelines for Use in Primary Care* (2nd ed.). Geneva: World Health Organization.
|
|
60
|
+
- **Scoring:** Sum 0–40 with item-specific point systems (items 1–8 score 0–4, items 9–10 score 0/2/4); interpreted in the four risk zones of the WHO manual.
|
|
61
|
+
|
|
62
|
+
## Mini-IPIP — Big Five personality scale (`mini-ipip`)
|
|
63
|
+
|
|
64
|
+
**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.
|
|
65
|
+
|
|
66
|
+
- **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.
|
|
67
|
+
- **Scoring:** Five trait subscales (extraversion, agreeableness, conscientiousness, neuroticism, openness) of 4 items each on a 1–5 accuracy scale, half reverse-keyed; scores 4–20 per trait are descriptive — no clinical cutoffs exist, so no bands are defined.
|
|
33
68
|
|
|
34
69
|
## ASRS v1.1 — Adult ADHD Self-Report Scale, 6-item screener (`asrs6`)
|
|
35
70
|
|
|
36
|
-
|
|
37
|
-
- **Rights:** Free to reproduce, distribute, and score.
|
|
38
|
-
- **Translations:** Turkish text follows the validated Turkish adaptation (Doğan et al., 2009); German text follows the WHO's German ASRS-v1.1 distribution.
|
|
39
|
-
- **Scoring:** Count of screen-positive items — items 1–3 from "Sometimes", items 4–6 from "Often"; 4 or more positives indicate symptoms highly consistent with adult ADHD, per the ASRS-v1.1 screener key.
|
|
71
|
+
**License: Free with conditions.** Copyright is held by the World Health Organization and the Workgroup on Adult ADHD (Harvard Medical School / NYU). The screener is distributed free of charge for clinical and research use. Embedding in commercial products is not explicitly covered by the public distribution terms — verify with the rights holders (Harvard NCS/ASRS distribution) before shipping commercially.
|
|
40
72
|
|
|
41
|
-
|
|
73
|
+
- **Citation:** Kessler, R. C., Adler, L., Ames, M., Demler, O., Faraone, S., Hiripi, E., et al. (2005). The World Health Organization Adult ADHD Self-Report Scale (ASRS): A short screening scale for use in the general population. *Psychological Medicine, 35*(2), 245–256.
|
|
74
|
+
- **Scoring:** Count of screen-positive items (items 1–3 from "Sometimes", items 4–6 from "Often"); ≥4 positives = positive screen, per the ASRS-v1.1 screener key.
|
|
42
75
|
|
|
43
|
-
|
|
44
|
-
- **Rights:** Free to use for clinical and research purposes.
|
|
45
|
-
- **Translations:** Turkish text follows the Turkish adaptation of the Autism Spectrum Quotient (Köse et al.); German text follows the published German AQ translations. Both were condensed to the AQ-10 item set — treat them as provisional and verify before clinical use.
|
|
46
|
-
- **Scoring:** 1 point per item answered in the trait direction (agree on items 1, 7, 8, 10; disagree on items 2–6 and 9); a total of 6 or more suggests referral for specialist assessment, per Allison et al. (2012).
|
|
76
|
+
## AQ-10 — Autism Spectrum Quotient, 10-item adult version (`aq10`)
|
|
47
77
|
|
|
48
|
-
|
|
78
|
+
**License: Free with conditions.** Copyright is held by the Autism Research Centre (ARC), University of Cambridge. ARC distributes its measures free of charge and the AQ-10 is recommended by NICE (CG142) for adult screening in clinical practice. Commercial redistribution is not explicitly licensed — verify with ARC before shipping commercially.
|
|
49
79
|
|
|
50
|
-
- **
|
|
51
|
-
- **
|
|
52
|
-
- **Translations:** Turkish text follows the validated short-form adaptation (Sarıçam, 2018); German text follows the published German DASS (Nilges & Essau, 2015).
|
|
53
|
-
- **Scoring:** Three 7-item subscales (depression, anxiety, stress); sums doubled to match DASS-42 severity cutoffs, per the DASS manual.
|
|
80
|
+
- **Citation:** Allison, C., Auyeung, B., & Baron-Cohen, S. (2012). Toward brief "Red Flags" for autism screening: The Short Autism Spectrum Quotient and the Short Quantitative Checklist in 1,000 cases and 3,000 controls. *Journal of the American Academy of Child & Adolescent Psychiatry, 51*(2), 202–212.
|
|
81
|
+
- **Scoring:** 1 point per item in the trait direction (agree on items 1, 7, 8, 10; disagree on the rest); ≥6 suggests specialist referral, per Allison et al. (2012).
|
package/dist/cjs/index.d.ts
CHANGED
|
@@ -4,5 +4,5 @@ export { localize, collectLocales } from "./i18n.ts";
|
|
|
4
4
|
export { Assessment, validateDefinition } from "./assessment.ts";
|
|
5
5
|
export { AssessmentResponse } from "./response.ts";
|
|
6
6
|
export { evaluate } from "./evaluation.ts";
|
|
7
|
-
export { phq9, gad7, dass21, who5, asrs6, aq10, inventories, loadInventory, twoWeekFrequencyOptions, twoWeekInstructions, } from "./inventories/index.ts";
|
|
7
|
+
export { phq9, gad7, dass21, who5, asrs6, aq10, audit, miniIpip, inventories, loadInventory, twoWeekFrequencyOptions, twoWeekInstructions, } from "./inventories/index.ts";
|
|
8
8
|
export type { InventoryId } from "./inventories/index.ts";
|
package/dist/cjs/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.loadInventory = exports.inventories = exports.aq10 = exports.asrs6 = exports.who5 = exports.dass21 = exports.gad7 = exports.phq9 = exports.evaluate = exports.AssessmentResponse = exports.validateDefinition = exports.Assessment = exports.collectLocales = exports.localize = exports.PsytoolsError = void 0;
|
|
3
|
+
exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.loadInventory = exports.inventories = exports.miniIpip = exports.audit = exports.aq10 = exports.asrs6 = exports.who5 = exports.dass21 = exports.gad7 = exports.phq9 = exports.evaluate = exports.AssessmentResponse = exports.validateDefinition = exports.Assessment = exports.collectLocales = exports.localize = exports.PsytoolsError = void 0;
|
|
4
4
|
var errors_ts_1 = require("./errors.js");
|
|
5
5
|
Object.defineProperty(exports, "PsytoolsError", { enumerable: true, get: function () { return errors_ts_1.PsytoolsError; } });
|
|
6
6
|
var i18n_ts_1 = require("./i18n.js");
|
|
@@ -20,6 +20,8 @@ Object.defineProperty(exports, "dass21", { enumerable: true, get: function () {
|
|
|
20
20
|
Object.defineProperty(exports, "who5", { enumerable: true, get: function () { return index_ts_1.who5; } });
|
|
21
21
|
Object.defineProperty(exports, "asrs6", { enumerable: true, get: function () { return index_ts_1.asrs6; } });
|
|
22
22
|
Object.defineProperty(exports, "aq10", { enumerable: true, get: function () { return index_ts_1.aq10; } });
|
|
23
|
+
Object.defineProperty(exports, "audit", { enumerable: true, get: function () { return index_ts_1.audit; } });
|
|
24
|
+
Object.defineProperty(exports, "miniIpip", { enumerable: true, get: function () { return index_ts_1.miniIpip; } });
|
|
23
25
|
Object.defineProperty(exports, "inventories", { enumerable: true, get: function () { return index_ts_1.inventories; } });
|
|
24
26
|
Object.defineProperty(exports, "loadInventory", { enumerable: true, get: function () { return index_ts_1.loadInventory; } });
|
|
25
27
|
Object.defineProperty(exports, "twoWeekFrequencyOptions", { enumerable: true, get: function () { return index_ts_1.twoWeekFrequencyOptions; } });
|
|
@@ -175,7 +175,9 @@ exports.aq10 = {
|
|
|
175
175
|
},
|
|
176
176
|
meta: {
|
|
177
177
|
reference: "Allison, C., Auyeung, B., & Baron-Cohen, S. (2012). Toward brief \"Red Flags\" for autism screening: The Short Autism Spectrum Quotient and the Short Quantitative Checklist in 1,000 cases and 3,000 controls. Journal of the American Academy of Child & Adolescent Psychiatry, 51(2), 202-212.",
|
|
178
|
-
license: "Free
|
|
178
|
+
license: "Free with conditions — (c) Autism Research Centre, University of Cambridge; distributed free of charge, NICE-recommended for clinical screening. Verify licensing with ARC before embedding in commercial products.",
|
|
179
|
+
licenseFlag: "free-with-conditions",
|
|
180
|
+
translationProvenance: "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.",
|
|
179
181
|
note: "Each item scores 1 point in the trait direction; disagree-scored items are modeled as reverseScored.",
|
|
180
182
|
},
|
|
181
183
|
};
|
|
@@ -121,7 +121,9 @@ exports.asrs6 = {
|
|
|
121
121
|
},
|
|
122
122
|
meta: {
|
|
123
123
|
reference: "Kessler, R. C., Adler, L., Ames, M., Demler, O., Faraone, S., Hiripi, E., et al. (2005). The World Health Organization Adult ADHD Self-Report Scale (ASRS): a short screening scale for use in the general population. Psychological Medicine, 35(2), 245-256.",
|
|
124
|
-
license: "Free
|
|
124
|
+
license: "Free with conditions — (c) WHO / Workgroup on Adult ADHD; free for clinical and research use. Verify licensing with the rights holders before embedding in commercial products.",
|
|
125
|
+
licenseFlag: "free-with-conditions",
|
|
126
|
+
translationProvenance: "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.",
|
|
125
127
|
timeframe: "past 6 months",
|
|
126
128
|
note: "The score counts screen-positive items, not symptom severity.",
|
|
127
129
|
},
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { AssessmentDefinition } from "../types.ts";
|
|
2
|
+
/**
|
|
3
|
+
* AUDIT — Alcohol Use Disorders Identification Test.
|
|
4
|
+
*
|
|
5
|
+
* 10 items developed by the WHO to detect hazardous and harmful alcohol
|
|
6
|
+
* consumption. Items use variable point systems: 1–8 score 0–4 on
|
|
7
|
+
* item-specific scales, 9–10 score 0/2/4. Total 0–40, interpreted in the
|
|
8
|
+
* four risk zones of the WHO manual (Babor et al., 2001). Free to use.
|
|
9
|
+
*/
|
|
10
|
+
export declare const audit: AssessmentDefinition;
|
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.audit = void 0;
|
|
4
|
+
const yearlyFrequencyOptions = [
|
|
5
|
+
{ value: 0, label: { en: "Never", tr: "Hiçbir zaman", de: "Nie" } },
|
|
6
|
+
{
|
|
7
|
+
value: 1,
|
|
8
|
+
label: { en: "Less than monthly", tr: "Ayda birden az", de: "Seltener als einmal im Monat" },
|
|
9
|
+
},
|
|
10
|
+
{ value: 2, label: { en: "Monthly", tr: "Ayda bir", de: "Einmal im Monat" } },
|
|
11
|
+
{ value: 3, label: { en: "Weekly", tr: "Haftada bir", de: "Einmal pro Woche" } },
|
|
12
|
+
{
|
|
13
|
+
value: 4,
|
|
14
|
+
label: { en: "Daily or almost daily", tr: "Hemen her gün", de: "Täglich oder fast täglich" },
|
|
15
|
+
},
|
|
16
|
+
];
|
|
17
|
+
// Items 9 and 10 score 0 / 2 / 4 — there is no 1 or 3.
|
|
18
|
+
const injuryOptions = [
|
|
19
|
+
{ value: 0, label: { en: "No", tr: "Hayır", de: "Nein" } },
|
|
20
|
+
{
|
|
21
|
+
value: 2,
|
|
22
|
+
label: {
|
|
23
|
+
en: "Yes, but not in the last year",
|
|
24
|
+
tr: "Evet, ama geçen yıl içinde değil",
|
|
25
|
+
de: "Ja, aber nicht im letzten Jahr",
|
|
26
|
+
},
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
value: 4,
|
|
30
|
+
label: {
|
|
31
|
+
en: "Yes, during the last year",
|
|
32
|
+
tr: "Evet, geçen yıl içinde",
|
|
33
|
+
de: "Ja, im letzten Jahr",
|
|
34
|
+
},
|
|
35
|
+
},
|
|
36
|
+
];
|
|
37
|
+
/**
|
|
38
|
+
* AUDIT — Alcohol Use Disorders Identification Test.
|
|
39
|
+
*
|
|
40
|
+
* 10 items developed by the WHO to detect hazardous and harmful alcohol
|
|
41
|
+
* consumption. Items use variable point systems: 1–8 score 0–4 on
|
|
42
|
+
* item-specific scales, 9–10 score 0/2/4. Total 0–40, interpreted in the
|
|
43
|
+
* four risk zones of the WHO manual (Babor et al., 2001). Free to use.
|
|
44
|
+
*/
|
|
45
|
+
exports.audit = {
|
|
46
|
+
id: "audit",
|
|
47
|
+
version: "1.0.0",
|
|
48
|
+
title: {
|
|
49
|
+
en: "Alcohol Use Disorders Identification Test (AUDIT)",
|
|
50
|
+
tr: "Alkol Kullanım Bozuklukları Tanıma Testi (AUDIT)",
|
|
51
|
+
de: "Alcohol Use Disorders Identification Test (AUDIT)",
|
|
52
|
+
},
|
|
53
|
+
description: {
|
|
54
|
+
en: "A 10-item WHO screening instrument for hazardous and harmful alcohol consumption and possible alcohol dependence.",
|
|
55
|
+
tr: "Tehlikeli ve zararlı alkol kullanımı ile olası alkol bağımlılığını taramak için DSÖ tarafından geliştirilmiş 10 maddelik bir ölçek.",
|
|
56
|
+
de: "Ein 10-Item-Screeninginstrument der WHO für riskanten und schädlichen Alkoholkonsum sowie mögliche Alkoholabhängigkeit.",
|
|
57
|
+
},
|
|
58
|
+
instructions: {
|
|
59
|
+
en: "Please answer the following questions about your use of alcoholic beverages during the past 12 months. One drink means one standard drink (e.g. a glass of beer or wine, or a single measure of spirits).",
|
|
60
|
+
tr: "Lütfen aşağıdaki soruları son 12 ay içindeki alkollü içecek kullanımınızı düşünerek yanıtlayın. Bir kadeh, bir standart içkiyi ifade eder (örneğin bir bardak bira ya da şarap veya tek ölçü yüksek alkollü içki).",
|
|
61
|
+
de: "Bitte beantworten Sie die folgenden Fragen zu Ihrem Konsum alkoholischer Getränke in den letzten 12 Monaten. Ein Glas entspricht einem Standardgetränk (z. B. ein Glas Bier oder Wein oder ein einfacher Schnaps).",
|
|
62
|
+
},
|
|
63
|
+
defaultLocale: "en",
|
|
64
|
+
options: yearlyFrequencyOptions,
|
|
65
|
+
questions: [
|
|
66
|
+
{
|
|
67
|
+
id: "audit-1",
|
|
68
|
+
text: {
|
|
69
|
+
en: "How often do you have a drink containing alcohol?",
|
|
70
|
+
tr: "Ne sıklıkla alkollü içki içersiniz?",
|
|
71
|
+
de: "Wie oft trinken Sie Alkohol?",
|
|
72
|
+
},
|
|
73
|
+
options: [
|
|
74
|
+
{ value: 0, label: { en: "Never", tr: "Hiçbir zaman", de: "Nie" } },
|
|
75
|
+
{
|
|
76
|
+
value: 1,
|
|
77
|
+
label: { en: "Monthly or less", tr: "Ayda bir ya da daha az", de: "Einmal im Monat oder seltener" },
|
|
78
|
+
},
|
|
79
|
+
{
|
|
80
|
+
value: 2,
|
|
81
|
+
label: { en: "2 to 4 times a month", tr: "Ayda 2-4 kez", de: "2- bis 4-mal im Monat" },
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
value: 3,
|
|
85
|
+
label: { en: "2 to 3 times a week", tr: "Haftada 2-3 kez", de: "2- bis 3-mal pro Woche" },
|
|
86
|
+
},
|
|
87
|
+
{
|
|
88
|
+
value: 4,
|
|
89
|
+
label: {
|
|
90
|
+
en: "4 or more times a week",
|
|
91
|
+
tr: "Haftada 4 ya da daha fazla",
|
|
92
|
+
de: "4-mal oder öfter pro Woche",
|
|
93
|
+
},
|
|
94
|
+
},
|
|
95
|
+
],
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
id: "audit-2",
|
|
99
|
+
text: {
|
|
100
|
+
en: "How many drinks containing alcohol do you have on a typical day when you are drinking?",
|
|
101
|
+
tr: "İçki içtiğiniz normal bir günde kaç kadeh içersiniz?",
|
|
102
|
+
de: "Wenn Sie Alkohol trinken, wie viele Gläser trinken Sie dann üblicherweise an einem Tag?",
|
|
103
|
+
},
|
|
104
|
+
options: [
|
|
105
|
+
{ value: 0, label: { en: "1 or 2", tr: "1 ya da 2", de: "1 oder 2" } },
|
|
106
|
+
{ value: 1, label: { en: "3 or 4", tr: "3 ya da 4", de: "3 oder 4" } },
|
|
107
|
+
{ value: 2, label: { en: "5 or 6", tr: "5 ya da 6", de: "5 oder 6" } },
|
|
108
|
+
{ value: 3, label: { en: "7 to 9", tr: "7 ila 9", de: "7 bis 9" } },
|
|
109
|
+
{ value: 4, label: { en: "10 or more", tr: "10 ya da daha fazla", de: "10 oder mehr" } },
|
|
110
|
+
],
|
|
111
|
+
},
|
|
112
|
+
{
|
|
113
|
+
id: "audit-3",
|
|
114
|
+
text: {
|
|
115
|
+
en: "How often do you have six or more drinks on one occasion?",
|
|
116
|
+
tr: "Bir seferde altı ya da daha fazla kadeh içtiğiniz ne sıklıkla olur?",
|
|
117
|
+
de: "Wie oft trinken Sie sechs oder mehr Gläser Alkohol bei einer Gelegenheit?",
|
|
118
|
+
},
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
id: "audit-4",
|
|
122
|
+
text: {
|
|
123
|
+
en: "How often during the last year have you found that you were not able to stop drinking once you had started?",
|
|
124
|
+
tr: "Geçtiğimiz yıl içinde, içmeye başladıktan sonra kendinizi durduramadığınızı ne sıklıkla fark ettiniz?",
|
|
125
|
+
de: "Wie oft konnten Sie im letzten Jahr nicht mehr mit dem Trinken aufhören, nachdem Sie einmal angefangen hatten?",
|
|
126
|
+
},
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
id: "audit-5",
|
|
130
|
+
text: {
|
|
131
|
+
en: "How often during the last year have you failed to do what was normally expected from you because of drinking?",
|
|
132
|
+
tr: "Geçtiğimiz yıl içinde, içki yüzünden sizden normalde beklenenleri ne sıklıkla yapamadınız?",
|
|
133
|
+
de: "Wie oft konnten Sie im letzten Jahr Ihren Verpflichtungen nicht nachkommen, weil Sie getrunken hatten?",
|
|
134
|
+
},
|
|
135
|
+
},
|
|
136
|
+
{
|
|
137
|
+
id: "audit-6",
|
|
138
|
+
text: {
|
|
139
|
+
en: "How often during the last year have you needed a first drink in the morning to get yourself going after a heavy drinking session?",
|
|
140
|
+
tr: "Geçtiğimiz yıl içinde, yoğun içilen bir geceden sonra kendinize gelmek için sabah ilk iş olarak bir içkiye ne sıklıkla ihtiyaç duydunuz?",
|
|
141
|
+
de: "Wie oft brauchten Sie im letzten Jahr morgens ein erstes Glas Alkohol, um nach einem Abend mit viel Alkohol wieder auf die Beine zu kommen?",
|
|
142
|
+
},
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
id: "audit-7",
|
|
146
|
+
text: {
|
|
147
|
+
en: "How often during the last year have you had a feeling of guilt or remorse after drinking?",
|
|
148
|
+
tr: "Geçtiğimiz yıl içinde, içki içtikten sonra ne sıklıkla suçluluk ya da pişmanlık duydunuz?",
|
|
149
|
+
de: "Wie oft hatten Sie im letzten Jahr Schuldgefühle oder Gewissensbisse, nachdem Sie getrunken hatten?",
|
|
150
|
+
},
|
|
151
|
+
},
|
|
152
|
+
{
|
|
153
|
+
id: "audit-8",
|
|
154
|
+
text: {
|
|
155
|
+
en: "How often during the last year have you been unable to remember what happened the night before because you had been drinking?",
|
|
156
|
+
tr: "Geçtiğimiz yıl içinde, içki yüzünden bir önceki gece olanları ne sıklıkla hatırlayamadınız?",
|
|
157
|
+
de: "Wie oft konnten Sie sich im letzten Jahr nicht an das erinnern, was am Vorabend geschehen war, weil Sie getrunken hatten?",
|
|
158
|
+
},
|
|
159
|
+
},
|
|
160
|
+
{
|
|
161
|
+
id: "audit-9",
|
|
162
|
+
text: {
|
|
163
|
+
en: "Have you or someone else been injured as a result of your drinking?",
|
|
164
|
+
tr: "İçki içmeniz yüzünden siz ya da bir başkası yaralandı mı?",
|
|
165
|
+
de: "Haben Sie sich oder eine andere Person schon einmal verletzt, weil Sie getrunken hatten?",
|
|
166
|
+
},
|
|
167
|
+
options: injuryOptions,
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
id: "audit-10",
|
|
171
|
+
text: {
|
|
172
|
+
en: "Has a relative or friend or a doctor or another health worker been concerned about your drinking or suggested you cut down?",
|
|
173
|
+
tr: "Bir yakınınız, arkadaşınız, bir doktor ya da başka bir sağlık çalışanı içki içmenizden kaygı duydu mu ya da azaltmanızı önerdi mi?",
|
|
174
|
+
de: "Hat ein Verwandter, Freund, Arzt oder eine andere medizinische Fachkraft sich schon einmal Sorgen über Ihren Alkoholkonsum gemacht oder Ihnen geraten, weniger zu trinken?",
|
|
175
|
+
},
|
|
176
|
+
options: injuryOptions,
|
|
177
|
+
},
|
|
178
|
+
],
|
|
179
|
+
scoring: {
|
|
180
|
+
kind: "sum",
|
|
181
|
+
bands: [
|
|
182
|
+
{
|
|
183
|
+
id: "zone-1",
|
|
184
|
+
min: 0,
|
|
185
|
+
max: 7,
|
|
186
|
+
label: {
|
|
187
|
+
en: "Zone I: low risk — alcohol education",
|
|
188
|
+
tr: "Bölge I: düşük risk — alkol konusunda bilgilendirme",
|
|
189
|
+
de: "Zone I: geringes Risiko — Aufklärung über Alkohol",
|
|
190
|
+
},
|
|
191
|
+
},
|
|
192
|
+
{
|
|
193
|
+
id: "zone-2",
|
|
194
|
+
min: 8,
|
|
195
|
+
max: 15,
|
|
196
|
+
label: {
|
|
197
|
+
en: "Zone II: hazardous drinking — simple advice recommended",
|
|
198
|
+
tr: "Bölge II: tehlikeli içme — basit öneri/danışmanlık önerilir",
|
|
199
|
+
de: "Zone II: riskanter Konsum — einfache Beratung empfohlen",
|
|
200
|
+
},
|
|
201
|
+
},
|
|
202
|
+
{
|
|
203
|
+
id: "zone-3",
|
|
204
|
+
min: 16,
|
|
205
|
+
max: 19,
|
|
206
|
+
label: {
|
|
207
|
+
en: "Zone III: harmful drinking — brief counselling and continued monitoring",
|
|
208
|
+
tr: "Bölge III: zararlı içme — kısa danışmanlık ve izlem",
|
|
209
|
+
de: "Zone III: schädlicher Konsum — Kurzintervention und weitere Beobachtung",
|
|
210
|
+
},
|
|
211
|
+
},
|
|
212
|
+
{
|
|
213
|
+
id: "zone-4",
|
|
214
|
+
min: 20,
|
|
215
|
+
max: 40,
|
|
216
|
+
label: {
|
|
217
|
+
en: "Zone IV: possible dependence — referral for diagnostic evaluation",
|
|
218
|
+
tr: "Bölge IV: olası bağımlılık — tanısal değerlendirme için yönlendirme",
|
|
219
|
+
de: "Zone IV: mögliche Abhängigkeit — Überweisung zur diagnostischen Abklärung",
|
|
220
|
+
},
|
|
221
|
+
},
|
|
222
|
+
],
|
|
223
|
+
},
|
|
224
|
+
meta: {
|
|
225
|
+
reference: "Babor, T. F., Higgins-Biddle, J. C., Saunders, J. B., & Monteiro, M. G. (2001). AUDIT: The Alcohol Use Disorders Identification Test — Guidelines for Use in Primary Care (2nd ed.). Geneva: World Health Organization.",
|
|
226
|
+
license: "Free — WHO permits reproduction and use of the AUDIT without permission",
|
|
227
|
+
licenseFlag: "free",
|
|
228
|
+
translationProvenance: "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.",
|
|
229
|
+
timeframe: "past 12 months",
|
|
230
|
+
},
|
|
231
|
+
};
|
|
@@ -282,7 +282,9 @@ exports.dass21 = {
|
|
|
282
282
|
},
|
|
283
283
|
meta: {
|
|
284
284
|
reference: "Lovibond, S. H., & Lovibond, P. F. (1995). Manual for the Depression Anxiety Stress Scales (2nd ed.). Sydney: Psychology Foundation.",
|
|
285
|
-
license: "
|
|
285
|
+
license: "Free — public domain per the official DASS site, including translations",
|
|
286
|
+
licenseFlag: "free",
|
|
287
|
+
translationProvenance: "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.",
|
|
286
288
|
timeframe: "past week",
|
|
287
289
|
},
|
|
288
290
|
};
|
|
@@ -115,7 +115,9 @@ exports.gad7 = {
|
|
|
115
115
|
},
|
|
116
116
|
meta: {
|
|
117
117
|
reference: "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: "
|
|
118
|
+
license: "Free — no permission required to reproduce, translate, display or distribute (Pfizer educational grant)",
|
|
119
|
+
licenseFlag: "free",
|
|
120
|
+
translationProvenance: "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
121
|
timeframe: "past 2 weeks",
|
|
120
122
|
},
|
|
121
123
|
};
|
|
@@ -6,11 +6,13 @@ import { dass21 } from "./dass21.ts";
|
|
|
6
6
|
import { who5 } from "./who5.ts";
|
|
7
7
|
import { asrs6 } from "./asrs6.ts";
|
|
8
8
|
import { aq10 } from "./aq10.ts";
|
|
9
|
-
|
|
9
|
+
import { audit } from "./audit.ts";
|
|
10
|
+
import { miniIpip } from "./mini-ipip.ts";
|
|
11
|
+
export { phq9, gad7, dass21, who5, asrs6, aq10, audit, miniIpip };
|
|
10
12
|
export { twoWeekFrequencyOptions, twoWeekInstructions } from "./common.ts";
|
|
11
13
|
/** All predefined inventory definitions shipped with psytools, by id. */
|
|
12
14
|
export declare const inventories: Readonly<Record<string, AssessmentDefinition>>;
|
|
13
|
-
export type InventoryId = "phq9" | "gad7" | "dass21" | "who5" | "asrs6" | "aq10";
|
|
15
|
+
export type InventoryId = "phq9" | "gad7" | "dass21" | "who5" | "asrs6" | "aq10" | "audit" | "mini-ipip";
|
|
14
16
|
/**
|
|
15
17
|
* Instantiates a predefined inventory as an `Assessment`.
|
|
16
18
|
* @throws PsytoolsError `unknown_inventory`
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.inventories = exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.aq10 = exports.asrs6 = exports.who5 = exports.dass21 = exports.gad7 = exports.phq9 = void 0;
|
|
3
|
+
exports.inventories = exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.miniIpip = exports.audit = exports.aq10 = exports.asrs6 = exports.who5 = exports.dass21 = exports.gad7 = exports.phq9 = void 0;
|
|
4
4
|
exports.loadInventory = loadInventory;
|
|
5
5
|
const assessment_ts_1 = require("../assessment.js");
|
|
6
6
|
const errors_ts_1 = require("../errors.js");
|
|
@@ -16,6 +16,10 @@ const asrs6_ts_1 = require("./asrs6.js");
|
|
|
16
16
|
Object.defineProperty(exports, "asrs6", { enumerable: true, get: function () { return asrs6_ts_1.asrs6; } });
|
|
17
17
|
const aq10_ts_1 = require("./aq10.js");
|
|
18
18
|
Object.defineProperty(exports, "aq10", { enumerable: true, get: function () { return aq10_ts_1.aq10; } });
|
|
19
|
+
const audit_ts_1 = require("./audit.js");
|
|
20
|
+
Object.defineProperty(exports, "audit", { enumerable: true, get: function () { return audit_ts_1.audit; } });
|
|
21
|
+
const mini_ipip_ts_1 = require("./mini-ipip.js");
|
|
22
|
+
Object.defineProperty(exports, "miniIpip", { enumerable: true, get: function () { return mini_ipip_ts_1.miniIpip; } });
|
|
19
23
|
var common_ts_1 = require("./common.js");
|
|
20
24
|
Object.defineProperty(exports, "twoWeekFrequencyOptions", { enumerable: true, get: function () { return common_ts_1.twoWeekFrequencyOptions; } });
|
|
21
25
|
Object.defineProperty(exports, "twoWeekInstructions", { enumerable: true, get: function () { return common_ts_1.twoWeekInstructions; } });
|
|
@@ -27,6 +31,8 @@ exports.inventories = {
|
|
|
27
31
|
who5: who5_ts_1.who5,
|
|
28
32
|
asrs6: asrs6_ts_1.asrs6,
|
|
29
33
|
aq10: aq10_ts_1.aq10,
|
|
34
|
+
audit: audit_ts_1.audit,
|
|
35
|
+
"mini-ipip": mini_ipip_ts_1.miniIpip,
|
|
30
36
|
};
|
|
31
37
|
/**
|
|
32
38
|
* Instantiates a predefined inventory as an `Assessment`.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { AssessmentDefinition } from "../types.ts";
|
|
2
|
+
/**
|
|
3
|
+
* Mini-IPIP — 20-item short form of the International Personality Item
|
|
4
|
+
* Pool Five-Factor Model measure (Donnellan et al., 2006).
|
|
5
|
+
*
|
|
6
|
+
* Measures the Big Five personality traits with 4 items each on a 1–5
|
|
7
|
+
* accuracy scale; half the items are reverse-keyed. Trait scores are
|
|
8
|
+
* descriptive (4–20 per trait, higher = more of the trait) — there are no
|
|
9
|
+
* clinical cutoffs, so no bands are defined. IPIP items are public domain.
|
|
10
|
+
*/
|
|
11
|
+
export declare const miniIpip: AssessmentDefinition;
|