Skip to main content

BehavioralTreatmentPlan

ComplexSpecialty<co-behavioral-treatment-plan>

BehavioralTreatmentPlan lays out a behavioral health plan as problems, goals, measurable objectives and the interventions for each, with target dates, progress, review date and signatures.

import { BehavioralTreatmentPlan } from 'health-components';

Examples​

Review Overdue​

Storybook

Usage​

<BehavioralTreatmentPlan problems={[{ code: "F33.1", label: "Major depressive disorder, recurrent, moderate", goals: [{ text: "Reduce depressive symptoms", objectives: [{ text: "PHQ-9 under 10", target: "12/15/2026", status: "progressing", measure: { name: "PHQ-9", baseline: 17, current: 12, target: 9 }, interventions: [{ text: "CBT", frequency: "weekly", who: "LCSW" }] }] }] }]} />

When to use​

  • Mental health and substance use treatment plans at intake, at each review and at discharge.

When not to use​

  • Crisis safety planning: a safety plan form.
  • Medical problem lists: ProblemList.

Variants and states​

VariantWhat it is
problemCode, label, priority and the evidence for it.
goalClinical wording plus the client’s own words.
objectiveMeasurable step with a measure (baseline, now, target), a target date and status: met, progressing, not started, not met, revised.
interventionWhat the clinician does, how often and who.
signaturesClient and clinician badges, signed or needed.
reviewNext review date, or overdue in danger.

Clinical values​

Every number goes through the shared clinical value rules (CareOS.fmt and ClinicalValue from the clinical-values card): tabular digits, the unit always shown, a fixed precision per measure, the reference range in the tooltip, and H, L or critical flags. Medication amounts follow the ISMP dose style through fmt.doseNumber: rounded to the stated precision, then shown with no trailing zero (5 mg, never 5.0 mg) and a leading zero (0.5 mL). The specialty measures this card adds sit in CareOS.specialty.MEAS with their precision: scale scores whole points. Ranges in the previews are sample values for the design system, not clinical guidance; a real deployment passes its own.

Accessibility​

  • Each problem is a labelled region; numbering (1.1a) ties objectives to goals in text.
  • Status is a word badge.

Do and don't​

  • Do: Write objectives the client can see progress on.
  • Do: Keep the client’s own words beside the goal.
  • Don't: List interventions without frequency or owner.
  • Don't: Let the review date pass silently.

Props​

PropTypeDefaultDescription
problemsReadonlyArray<TreatmentProblem>[]Problems with goals, objectives and interventions
reviewDuestringnoneNext review date
reviewOverduebooleanfalseThe review date has passed
signaturesReadonlyArray<PlanSignature>[]Signatures
titlestring'Treatment plan'Card title
subtitlestringnoneLine under the title
readOnlybooleanfalseHides Review Plan and Sign Plan
onReviewPlan() => voidnoneReview Plan action
onSignPlan() => voidnoneSign Plan action
rangeContextRangeContextIdthe global context, else 'outpatient'Which shared reference range flags use; the lab range on a result still wins

Also accepts native attributes, including defaultChecked, defaultValue, autoFocus, plus className and event handlers on the root element.

Angular, Vue and HTML​

Register the elements once (Angular guide), then use <co-behavioral-treatment-plan>. Attributes take strings; arrays and objects are set as properties (Angular [prop], Vue :prop) or as JSON attributes. Callbacks are DOM events with the value in event.detail.

Angular template
<co-behavioral-treatment-plan review-due="…" review-overdue [problems]="problems" (co-review-plan)="onReviewPlan($event.detail)"></co-behavioral-treatment-plan>
KindNameDescription
property / JSON attributeproblemsProblems with goals, objectives and interventions; default []
attributereview-due / reviewDueNext review date; default none
attributereview-overdue / reviewOverdueThe review date has passed; default false
property / JSON attributesignaturesSignatures; default []
attributetitleCard title; default 'Treatment plan'
attributesubtitleLine under the title; default none
attributeread-only / readOnlyHides Review Plan and Sign Plan; default false
attributerange-context / rangeContextWhich shared reference range flags use; the lab range on a result still wins; default the global context, else 'outpatient'
attributedefault-checked / defaultChecked
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus
eventco-review-planReview Plan action; default none (React: onReviewPlan)
eventco-sign-planSign Plan action; default none (React: onSignPlan)