psytools 0.6.0 → 0.6.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/LICENSE +12 -6
- package/README.md +11 -7
- package/SOURCES.md +57 -2
- package/dist/cjs/inventories/bis-bas.d.ts +17 -0
- package/dist/cjs/inventories/bis-bas.js +118 -0
- package/dist/cjs/inventories/common.d.ts +8 -0
- package/dist/cjs/inventories/common.js +17 -1
- package/dist/cjs/inventories/index.d.ts +6 -1
- package/dist/cjs/inventories/index.js +13 -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/locales/de/bis-bas.d.ts +4 -0
- package/dist/cjs/locales/de/bis-bas.js +142 -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/es/bis-bas.d.ts +4 -0
- package/dist/cjs/locales/es/bis-bas.js +142 -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/index.js +24 -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/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/zh/bis-bas.d.ts +4 -0
- package/dist/cjs/locales/zh/bis-bas.js +142 -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/types.d.ts +5 -1
- package/dist/esm/inventories/bis-bas.d.ts +17 -0
- package/dist/esm/inventories/bis-bas.js +115 -0
- package/dist/esm/inventories/common.d.ts +8 -0
- package/dist/esm/inventories/common.js +16 -0
- package/dist/esm/inventories/index.d.ts +6 -1
- package/dist/esm/inventories/index.js +9 -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/locales/de/bis-bas.d.ts +4 -0
- package/dist/esm/locales/de/bis-bas.js +140 -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/es/bis-bas.d.ts +4 -0
- package/dist/esm/locales/es/bis-bas.js +140 -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/index.js +24 -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/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/zh/bis-bas.d.ts +4 -0
- package/dist/esm/locales/zh/bis-bas.js +140 -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/types.d.ts +5 -1
- package/package.json +10 -2
- package/src/inventories/bis-bas.ts +122 -0
- package/src/inventories/common.ts +18 -0
- package/src/inventories/index.ts +14 -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/locales/de/bis-bas.ts +143 -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/es/bis-bas.ts +143 -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/index.ts +24 -0
- package/src/locales/tr/bis-bas.ts +143 -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/zh/bis-bas.ts +143 -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/types.ts +5 -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-one 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
|
|
@@ -14,11 +14,17 @@ SOURCES.md. SOURCES.md, not the MIT License below, is where your
|
|
|
14
14
|
rights over any specific instrument's text come from.
|
|
15
15
|
|
|
16
16
|
Most bundled instruments are free to use, including in commercial
|
|
17
|
-
products
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
17
|
+
products, though a few carry a lighter condition of their own —
|
|
18
|
+
mandatory attribution, most notably. Five need their rights holder's
|
|
19
|
+
permission before commercial use: the ECR-R, the ERQ, and the HSPS,
|
|
20
|
+
which SOURCES.md tags "Research only," and the SWLS and the
|
|
21
|
+
Flourishing Scale, which SOURCES.md tags "Free with conditions" but
|
|
22
|
+
whose own terms are non-commercial-only — the same restriction in
|
|
23
|
+
substance, under a different tag. Two more, the AQ-10 and the RSES,
|
|
24
|
+
are neither free nor restricted for commercial use: their rights
|
|
25
|
+
holders simply haven't addressed it, so confirm with them before
|
|
26
|
+
shipping commercially. Read SOURCES.md before you rely on any
|
|
27
|
+
instrument's text, particularly before commercial use.
|
|
22
28
|
|
|
23
29
|
The MIT License below is the license for the code. The bundled
|
|
24
30
|
instrument text is licensed as described above, not under this MIT
|
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-one instruments (PHQ-9, 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) 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,6 +101,9 @@ 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 |
|
|
103
107
|
|
|
104
108
|
¹ 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.
|
|
105
109
|
|
|
@@ -223,7 +227,7 @@ scoring: {
|
|
|
223
227
|
|
|
224
228
|
`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
229
|
|
|
226
|
-
The bundled inventories ship with policies (PHQ-9/GAD-7/DASS-21
|
|
230
|
+
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 require-complete, AUDIT ignores to match its skip logic) — see [SOURCES.md](SOURCES.md#missing-data-policies) for the rationale and how to override.
|
|
227
231
|
|
|
228
232
|
## Custom evaluation
|
|
229
233
|
|
|
@@ -281,17 +285,17 @@ npm run build # ESM + CJS + type declarations into dist/
|
|
|
281
285
|
|
|
282
286
|
- **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
287
|
- **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,
|
|
288
|
+
- **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
289
|
- **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
|
|
290
|
+
- **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
291
|
|
|
288
292
|
## License
|
|
289
293
|
|
|
290
294
|
The code is MIT — Samed Kahyaoglu, 2026. See [LICENSE](LICENSE).
|
|
291
295
|
|
|
292
|
-
The bundled instrument text is a separate matter: each of the
|
|
296
|
+
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
297
|
|
|
294
|
-
- **
|
|
298
|
+
- **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
299
|
- **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
300
|
- **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
301
|
- **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).
|
|
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
|
|
|
@@ -61,6 +61,10 @@ Bundled inventories ship with declarative missing-data policies (`scoring.missin
|
|
|
61
61
|
| `hsps` | prorate, ≥21 of 27 answered | Total is mean-based in the literature; prorating is equivalent |
|
|
62
62
|
| `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
63
|
| `rses` | prorate, ≥8 of 10 answered | Common research practice (80% completion) |
|
|
64
|
+
| `mini-ipip6` | prorate, ≥3 of 4 per factor | Same as `mini-ipip` |
|
|
65
|
+
| `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 |
|
|
66
|
+
| `ipip-neo-60` | prorate, ≥9 of 12 per domain | Common research practice (75% completion) |
|
|
67
|
+
| `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 |
|
|
64
68
|
|
|
65
69
|
## PHQ-9 — Patient Health Questionnaire-9 (`phq9`)
|
|
66
70
|
|
|
@@ -102,7 +106,7 @@ Bundled inventories ship with declarative missing-data policies (`scoring.missin
|
|
|
102
106
|
**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
107
|
|
|
104
108
|
- **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,
|
|
109
|
+
- **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
110
|
|
|
107
111
|
## ASRS v1.1 — Adult ADHD Self-Report Scale, 6-item screener (`asrs6`)
|
|
108
112
|
|
|
@@ -194,6 +198,57 @@ Bundled inventories ship with declarative missing-data policies (`scoring.missin
|
|
|
194
198
|
- **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
199
|
- **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
200
|
|
|
201
|
+
## The International Personality Item Pool — shared record
|
|
202
|
+
|
|
203
|
+
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.
|
|
204
|
+
|
|
205
|
+
- **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.
|
|
206
|
+
- **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.
|
|
207
|
+
- **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.
|
|
208
|
+
- **Response scale.** All five use IPIP's 1–5 accuracy scale (Very inaccurate … Very accurate), shared as `ipipAccuracyOptions`.
|
|
209
|
+
- **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.
|
|
210
|
+
- **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.
|
|
211
|
+
- **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.
|
|
212
|
+
|
|
213
|
+
## Mini-IPIP6 — Big Six personality scale (`mini-ipip6`)
|
|
214
|
+
|
|
215
|
+
**License: Free.** Public domain via the IPIP grant quoted above — any use, commercial or non-commercial, no permission and no attribution required.
|
|
216
|
+
|
|
217
|
+
- **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.
|
|
218
|
+
- **Item source:** IPIP scoring key, <https://ipip.ori.org/MiniIPIP6Key.htm>.
|
|
219
|
+
- **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.
|
|
220
|
+
- **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.
|
|
221
|
+
- **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.
|
|
222
|
+
|
|
223
|
+
## IPIP BIS/BAS Scales — approach and avoidance motivation (`bis-bas`)
|
|
224
|
+
|
|
225
|
+
**License: Free.** Public domain via the IPIP grant quoted above.
|
|
226
|
+
|
|
227
|
+
- **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.
|
|
228
|
+
- **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>.
|
|
229
|
+
- **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.
|
|
230
|
+
- **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.
|
|
231
|
+
|
|
232
|
+
## IPIP-NEO-60 — 60-item personality inventory (`ipip-neo-60`)
|
|
233
|
+
|
|
234
|
+
**License: Free.** Public domain via the IPIP grant quoted above.
|
|
235
|
+
|
|
236
|
+
- **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.
|
|
237
|
+
- **Item source:** IPIP scoring key, <https://ipip.ori.org/IPIP-NEO-60ScoringKeys.htm>.
|
|
238
|
+
- **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.
|
|
239
|
+
- **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`.
|
|
240
|
+
- **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.
|
|
241
|
+
|
|
242
|
+
## IPIP-VIA-R Short Scales — 24 character strengths (`ipip-via-r`)
|
|
243
|
+
|
|
244
|
+
**License: Free.** Public domain via the IPIP grant quoted above.
|
|
245
|
+
|
|
246
|
+
- **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.
|
|
247
|
+
- **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>.
|
|
248
|
+
- **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.
|
|
249
|
+
- **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.
|
|
250
|
+
- **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.
|
|
251
|
+
|
|
197
252
|
## Instruments evaluated and not bundled
|
|
198
253
|
|
|
199
254
|
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. Today's entries all come from one sweep of widely used ADHD instruments (July 2026); five are blocked by their licensing and one is waiting on a permission request.
|
|
@@ -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
|
+
};
|
|
@@ -11,6 +11,14 @@ export declare const twoWeekInstructions: LocalizedText;
|
|
|
11
11
|
* (SWLS, Flourishing Scale).
|
|
12
12
|
*/
|
|
13
13
|
export declare const sevenPointAgreementOptions: AssessmentOption[];
|
|
14
|
+
/**
|
|
15
|
+
* The 1–5 accuracy scale every bundled International Personality Item
|
|
16
|
+
* Pool inventory uses, with IPIP's own anchor wording
|
|
17
|
+
* (<https://ipip.ori.org/newScoringInstructions.htm>).
|
|
18
|
+
*/
|
|
19
|
+
export declare const ipipAccuracyOptions: AssessmentOption[];
|
|
20
|
+
/** Instructions shared by the bundled IPIP inventories. */
|
|
21
|
+
export declare const ipipInstructions: LocalizedText;
|
|
14
22
|
/**
|
|
15
23
|
* The past-30-days frequency labels shared by the Kessler distress
|
|
16
24
|
* scales. K10 stores them as 1–5 (sum 10–50), K6 as 0–4 (sum 0–24),
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.kesslerFrequencyLabels = exports.sevenPointAgreementOptions = exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = void 0;
|
|
3
|
+
exports.kesslerFrequencyLabels = exports.ipipInstructions = exports.ipipAccuracyOptions = exports.sevenPointAgreementOptions = exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = void 0;
|
|
4
4
|
/**
|
|
5
5
|
* The 0–3 frequency scale ("over the last 2 weeks") shared by PHQ-9 and
|
|
6
6
|
* GAD-7.
|
|
@@ -48,6 +48,22 @@ exports.sevenPointAgreementOptions = [
|
|
|
48
48
|
{ value: 6, label: { en: "Agree" } },
|
|
49
49
|
{ value: 7, label: { en: "Strongly agree" } },
|
|
50
50
|
];
|
|
51
|
+
/**
|
|
52
|
+
* The 1–5 accuracy scale every bundled International Personality Item
|
|
53
|
+
* Pool inventory uses, with IPIP's own anchor wording
|
|
54
|
+
* (<https://ipip.ori.org/newScoringInstructions.htm>).
|
|
55
|
+
*/
|
|
56
|
+
exports.ipipAccuracyOptions = [
|
|
57
|
+
{ value: 1, label: { en: "Very inaccurate" } },
|
|
58
|
+
{ value: 2, label: { en: "Moderately inaccurate" } },
|
|
59
|
+
{ value: 3, label: { en: "Neither accurate nor inaccurate" } },
|
|
60
|
+
{ value: 4, label: { en: "Moderately accurate" } },
|
|
61
|
+
{ value: 5, label: { en: "Very accurate" } },
|
|
62
|
+
];
|
|
63
|
+
/** Instructions shared by the bundled IPIP inventories. */
|
|
64
|
+
exports.ipipInstructions = {
|
|
65
|
+
en: "Describe yourself as you generally are now, not as you wish to be in the future. Indicate how accurately each statement describes you.",
|
|
66
|
+
};
|
|
51
67
|
/**
|
|
52
68
|
* The past-30-days frequency labels shared by the Kessler distress
|
|
53
69
|
* scales. K10 stores them as 1–5 (sum 10–50), K6 as 0–4 (sum 0–24),
|
|
@@ -17,11 +17,16 @@ import { flourishing } from "./flourishing.ts";
|
|
|
17
17
|
import { k10 } from "./k10.ts";
|
|
18
18
|
import { k6 } from "./k6.ts";
|
|
19
19
|
import { rses } from "./rses.ts";
|
|
20
|
+
import { miniIpip6 } from "./mini-ipip6.ts";
|
|
21
|
+
import { bisBas } from "./bis-bas.ts";
|
|
22
|
+
import { ipipNeo60 } from "./ipip-neo-60.ts";
|
|
23
|
+
import { ipipViaR } from "./ipip-via-r.ts";
|
|
20
24
|
export { phq9, gad7, dass21, who5, asrs6, aq10, audit, miniIpip, cesd, ecrR, erq, hsps, swls, flourishing, k10, k6, rses };
|
|
25
|
+
export { miniIpip6, bisBas, ipipNeo60, ipipViaR };
|
|
21
26
|
export { twoWeekFrequencyOptions, twoWeekInstructions } from "./common.ts";
|
|
22
27
|
/** All predefined inventory definitions shipped with psytools, by id. */
|
|
23
28
|
export declare const inventories: Readonly<Record<string, AssessmentDefinition>>;
|
|
24
|
-
export type InventoryId = "phq9" | "gad7" | "dass21" | "who5" | "asrs6" | "aq10" | "audit" | "mini-ipip" | "cesd" | "ecr-r" | "erq" | "hsps" | "swls" | "flourishing" | "k10" | "k6" | "rses";
|
|
29
|
+
export type InventoryId = "phq9" | "gad7" | "dass21" | "who5" | "asrs6" | "aq10" | "audit" | "mini-ipip" | "cesd" | "ecr-r" | "erq" | "hsps" | "swls" | "flourishing" | "k10" | "k6" | "rses" | "mini-ipip6" | "bis-bas" | "ipip-neo-60" | "ipip-via-r";
|
|
25
30
|
/**
|
|
26
31
|
* Instantiates a predefined inventory as an `Assessment`.
|
|
27
32
|
*
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.inventories = exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.rses = exports.k6 = exports.k10 = exports.flourishing = exports.swls = exports.hsps = exports.erq = exports.ecrR = exports.cesd = exports.miniIpip = exports.audit = exports.aq10 = exports.asrs6 = exports.who5 = exports.dass21 = exports.gad7 = exports.phq9 = void 0;
|
|
3
|
+
exports.inventories = exports.twoWeekInstructions = exports.twoWeekFrequencyOptions = exports.ipipViaR = exports.ipipNeo60 = exports.bisBas = exports.miniIpip6 = exports.rses = exports.k6 = exports.k10 = exports.flourishing = exports.swls = exports.hsps = exports.erq = exports.ecrR = exports.cesd = exports.miniIpip = exports.audit = exports.aq10 = exports.asrs6 = exports.who5 = exports.dass21 = exports.gad7 = exports.phq9 = void 0;
|
|
4
4
|
exports.loadInventory = loadInventory;
|
|
5
5
|
const assessment_ts_1 = require("../assessment.js");
|
|
6
6
|
const errors_ts_1 = require("../errors.js");
|
|
@@ -40,6 +40,14 @@ const k6_ts_1 = require("./k6.js");
|
|
|
40
40
|
Object.defineProperty(exports, "k6", { enumerable: true, get: function () { return k6_ts_1.k6; } });
|
|
41
41
|
const rses_ts_1 = require("./rses.js");
|
|
42
42
|
Object.defineProperty(exports, "rses", { enumerable: true, get: function () { return rses_ts_1.rses; } });
|
|
43
|
+
const mini_ipip6_ts_1 = require("./mini-ipip6.js");
|
|
44
|
+
Object.defineProperty(exports, "miniIpip6", { enumerable: true, get: function () { return mini_ipip6_ts_1.miniIpip6; } });
|
|
45
|
+
const bis_bas_ts_1 = require("./bis-bas.js");
|
|
46
|
+
Object.defineProperty(exports, "bisBas", { enumerable: true, get: function () { return bis_bas_ts_1.bisBas; } });
|
|
47
|
+
const ipip_neo_60_ts_1 = require("./ipip-neo-60.js");
|
|
48
|
+
Object.defineProperty(exports, "ipipNeo60", { enumerable: true, get: function () { return ipip_neo_60_ts_1.ipipNeo60; } });
|
|
49
|
+
const ipip_via_r_ts_1 = require("./ipip-via-r.js");
|
|
50
|
+
Object.defineProperty(exports, "ipipViaR", { enumerable: true, get: function () { return ipip_via_r_ts_1.ipipViaR; } });
|
|
43
51
|
var common_ts_1 = require("./common.js");
|
|
44
52
|
Object.defineProperty(exports, "twoWeekFrequencyOptions", { enumerable: true, get: function () { return common_ts_1.twoWeekFrequencyOptions; } });
|
|
45
53
|
Object.defineProperty(exports, "twoWeekInstructions", { enumerable: true, get: function () { return common_ts_1.twoWeekInstructions; } });
|
|
@@ -62,6 +70,10 @@ exports.inventories = {
|
|
|
62
70
|
k10: k10_ts_1.k10,
|
|
63
71
|
k6: k6_ts_1.k6,
|
|
64
72
|
rses: rses_ts_1.rses,
|
|
73
|
+
"mini-ipip6": mini_ipip6_ts_1.miniIpip6,
|
|
74
|
+
"bis-bas": bis_bas_ts_1.bisBas,
|
|
75
|
+
"ipip-neo-60": ipip_neo_60_ts_1.ipipNeo60,
|
|
76
|
+
"ipip-via-r": ipip_via_r_ts_1.ipipViaR,
|
|
65
77
|
};
|
|
66
78
|
/**
|
|
67
79
|
* Instantiates a predefined inventory as an `Assessment`.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { AssessmentDefinition } from "../types.ts";
|
|
2
|
+
/**
|
|
3
|
+
* IPIP-NEO-60 — 60-item public-domain personality inventory
|
|
4
|
+
* (Maples-Keller et al., 2019).
|
|
5
|
+
*
|
|
6
|
+
* Twelve items per domain on IPIP's 1-5 accuracy scale, measuring
|
|
7
|
+
* constructs similar to five broad personality domains: neuroticism,
|
|
8
|
+
* extraversion, openness to experience, agreeableness, and
|
|
9
|
+
* conscientiousness. Each domain draws two items from each of six
|
|
10
|
+
* facets. 23 of the 60 items are reverse-keyed. Domain scores are
|
|
11
|
+
* descriptive (12-60 each); no clinical cutoffs exist, so no bands are
|
|
12
|
+
* defined.
|
|
13
|
+
*
|
|
14
|
+
* Facets are two items apiece — far too short to score on their own —
|
|
15
|
+
* so psytools reports the five domains and documents the facet
|
|
16
|
+
* composition in `meta.scoringNote`. IPIP items are public domain.
|
|
17
|
+
*/
|
|
18
|
+
export declare const ipipNeo60: AssessmentDefinition;
|