@broberg/bodymap 0.1.0

package/README.md

@@ -0,0 +1,109 @@
+# @broberg/bodymap
+
+Interactive body **pain-map**: a genderless body a patient clicks to mark where it
+hurts, producing a structured `PainReport` (the shared `bodymap/v1` wire format) —
+never a bare image. The clinical region taxonomy, the data model and the selection
+engine are **framework-neutral**; the renderer is swappable. This release ships the
+headless core + a 2D SVG React renderer (front view). A rotatable 3D renderer
+(vanilla Three.js) and a 2D back view land in follow-up `0.1.x` releases on the
+same core.
+
+```bash
+npm i @broberg/bodymap
+```
+
+## The data model
+
+One `PainReport` is an array of points — one per marked region, latest wins:
+
+```ts
+type PainPoint = {
+  region: string;      // a region key, e.g. "shoulder_left"
+  intensity: number;   // 0–10
+  type?: "stikkende" | "dump" | "konstant" | "jagende";
+  timestamp: string;   // ISO
+};
+type PainReport = PainPoint[];
+```
+
+The taxonomy is the authoritative fd-sundhed clinical set: **18 side-less codes**
+(HEAD, NECK, SHOULDER, UARM, ELBOW, FARM, WRIST, HAND, CHEST, THORA, LUMBAR, HIP,
+GROIN, THIGH, KNEE, LOWLEG, ANKLE, FOOT) × a `side` (`left` / `right` / centre) →
+30 concrete regions. `REGIONS` is the full list; `getRegion(key)` looks one up.
+
+## Core (no React)
+
+```ts
+import { createPainSelection, serializeReport, deserializeReport } from "@broberg/bodymap";
+
+const sel = createPainSelection();
+sel.set("shoulder_left", 7, "jagende");
+sel.set("lumbar", 4);
+sel.getReport();                 // validated PainReport
+
+const wire = serializeReport(sel.getReport(), { view: "front" });
+// → { schema: "bodymap/v1", view: "front",
+//     points: [{ region: "SHOULDER", side: "left", intensity: 7, quality: "jagende" }, …] }
+
+deserializeReport(wire);         // bodymap/v1 → internal PainReport
+```
+
+`serializeReport` maps each region key to its side-less clinical **code** + side, so
+the report is portable across the web components and the native mobile apps.
+`painReportSchema` (zod) is exported for validating untrusted input.
+
+## 2D renderer (React)
+
+```tsx
+import { BodyMap } from "@broberg/bodymap/react";
+
+<BodyMap
+  defaultValue={[]}                        // or `value` for a controlled component
+  onChange={(report) => save(report)}      // full validated PainReport on every change
+  config={{ groin: { visible: false } }}   // per-app region toggles (optional)
+/>;
+```
+
+Click a region → pick intensity (0–10) and quality → the region fills by intensity
+and `onChange` fires. No native form controls; every control carries a
+`data-testid` (`bodymap-region-<key>`) for E2E/visual testing. `react` is an
+optional peer dependency — the core works without it.
+
+### Per-app region config
+
+```ts
+type RegionConfig = Record<string, { visible?: boolean; selectable?: boolean }>;
+```
+
+An absent key is visible + selectable. Hidden ⇒ never selectable. `resolveRegions`
+and `isSelectable` apply the config for custom renderers.
+
+## Colour control — `BodymapPalette`
+
+Both renderers theme off one palette (consumer-defined):
+
+```ts
+import { defaultPalette, heatFor, baseColorFor, type BodymapPalette } from "@broberg/bodymap";
+
+const palette: BodymapPalette = {
+  body: "#c8ccdd",
+  hover: "#5CC4B7",
+  selected: "#141969",
+  heat: { low: "#FFE049", mid: "#F09A3E", high: "#D61C64" },
+  regions: { chest: "#e6e9f2" },   // optional per-region base colours
+};
+
+heatFor(8, palette);               // → "#D61C64"  (intensity → heat colour)
+baseColorFor("chest", palette);    // → "#e6e9f2"  (per-region override, else body)
+```
+
+## Roadmap
+
+- 2D **back view** (LUMBAR / THORA / HIP posterior) — `0.1.x`
+- Rotatable **3D** renderer (vanilla Three.js, realistic Blender Studio CC0 body,
+  click-to-colour by pain) — `0.1.x`
+- Preact adapter
+
+## License
+
+MIT · part of the [`@broberg/*`](https://discovery.broberg.ai) shared inventory.

package/dist/index.cjs

@@ -0,0 +1,157 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/index.ts
+var REGIONS = [
+  // axis / centre-line (serialised side "center")
+  { key: "head", label: "Hoved", code: "HEAD" },
+  { key: "neck", label: "Nakke", code: "NECK" },
+  { key: "chest", label: "Bryst", code: "CHEST" },
+  { key: "thora", label: "\xD8vre ryg (thorakal)", code: "THORA" },
+  { key: "lumbar", label: "L\xE6nd (lumbal)", code: "LUMBAR" },
+  { key: "groin", label: "Lyske", code: "GROIN" },
+  // paired limbs / sides (L / R)
+  { key: "shoulder_left", label: "Skulder, venstre", code: "SHOULDER", side: "left" },
+  { key: "shoulder_right", label: "Skulder, h\xF8jre", code: "SHOULDER", side: "right" },
+  { key: "uarm_left", label: "Overarm, venstre", code: "UARM", side: "left" },
+  { key: "uarm_right", label: "Overarm, h\xF8jre", code: "UARM", side: "right" },
+  { key: "elbow_left", label: "Albue, venstre", code: "ELBOW", side: "left" },
+  { key: "elbow_right", label: "Albue, h\xF8jre", code: "ELBOW", side: "right" },
+  { key: "farm_left", label: "Underarm, venstre", code: "FARM", side: "left" },
+  { key: "farm_right", label: "Underarm, h\xF8jre", code: "FARM", side: "right" },
+  { key: "wrist_left", label: "H\xE5ndled, venstre", code: "WRIST", side: "left" },
+  { key: "wrist_right", label: "H\xE5ndled, h\xF8jre", code: "WRIST", side: "right" },
+  { key: "hand_left", label: "H\xE5nd, venstre", code: "HAND", side: "left" },
+  { key: "hand_right", label: "H\xE5nd, h\xF8jre", code: "HAND", side: "right" },
+  { key: "hip_left", label: "Hofte, venstre", code: "HIP", side: "left" },
+  { key: "hip_right", label: "Hofte, h\xF8jre", code: "HIP", side: "right" },
+  { key: "thigh_left", label: "L\xE5r, venstre", code: "THIGH", side: "left" },
+  { key: "thigh_right", label: "L\xE5r, h\xF8jre", code: "THIGH", side: "right" },
+  { key: "knee_left", label: "Kn\xE6, venstre", code: "KNEE", side: "left" },
+  { key: "knee_right", label: "Kn\xE6, h\xF8jre", code: "KNEE", side: "right" },
+  { key: "lowleg_left", label: "Underben, venstre", code: "LOWLEG", side: "left" },
+  { key: "lowleg_right", label: "Underben, h\xF8jre", code: "LOWLEG", side: "right" },
+  { key: "ankle_left", label: "Ankel, venstre", code: "ANKLE", side: "left" },
+  { key: "ankle_right", label: "Ankel, h\xF8jre", code: "ANKLE", side: "right" },
+  { key: "foot_left", label: "Fod, venstre", code: "FOOT", side: "left" },
+  { key: "foot_right", label: "Fod, h\xF8jre", code: "FOOT", side: "right" }
+];
+var REGION_KEY_SET = new Set(REGIONS.map((r) => r.key));
+var REGION_KEYS = REGIONS.map((r) => r.key);
+function getRegion(key) {
+  return REGIONS.find((r) => r.key === key);
+}
+var PAIN_TYPES = ["stikkende", "dump", "konstant", "jagende"];
+var painPointSchema = zod.z.object({
+  region: zod.z.string().refine((k) => REGION_KEY_SET.has(k), { message: "unknown region" }),
+  intensity: zod.z.number().int().min(0).max(10),
+  type: zod.z.enum(PAIN_TYPES).optional(),
+  timestamp: zod.z.string()
+});
+var painReportSchema = zod.z.array(painPointSchema);
+function createPainSelection(initial = [], opts = {}) {
+  const now = opts.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
+  const map = /* @__PURE__ */ new Map();
+  for (const p of initial) {
+    const v = painPointSchema.parse(p);
+    map.set(v.region, v);
+  }
+  return {
+    set(region, intensity, type) {
+      const point = painPointSchema.parse({ region, intensity, type, timestamp: now() });
+      map.set(point.region, point);
+      return point;
+    },
+    remove: (region) => map.delete(region),
+    get: (region) => map.get(region),
+    has: (region) => map.has(region),
+    clear: () => map.clear(),
+    getReport: () => painReportSchema.parse(Array.from(map.values()))
+  };
+}
+function resolveRegions(config = {}) {
+  return REGIONS.filter((r) => config[r.key]?.visible ?? true);
+}
+function isSelectable(key, config = {}) {
+  const s = config[key];
+  if (s?.visible === false) return false;
+  return s?.selectable ?? true;
+}
+var defaultPalette = {
+  body: "#d2d7de",
+  hover: "#8fd0cd",
+  selected: "#5cc4b7",
+  heat: { low: "#fcd34d", mid: "#fb923c", high: "#ef4444" }
+};
+function heatFor(intensity, palette = defaultPalette) {
+  return intensity >= 7 ? palette.heat.high : intensity >= 4 ? palette.heat.mid : palette.heat.low;
+}
+function baseColorFor(regionKey, palette = defaultPalette) {
+  return palette.regions?.[regionKey] ?? palette.body;
+}
+var bodymapReportV1Schema = zod.z.object({
+  schema: zod.z.literal("bodymap/v1"),
+  view: zod.z.enum(["front", "back", "left", "right"]),
+  points: zod.z.array(
+    zod.z.object({
+      region: zod.z.string(),
+      side: zod.z.enum(["left", "right", "center"]),
+      intensity: zod.z.number().int().min(0).max(10),
+      quality: zod.z.enum(PAIN_TYPES).optional()
+    })
+  )
+});
+function serializeReport(report, opts = {}) {
+  return {
+    schema: "bodymap/v1",
+    view: opts.view ?? "front",
+    points: report.map((p) => {
+      const r = getRegion(p.region);
+      return {
+        region: r?.code ?? p.region,
+        side: r?.side ?? "center",
+        intensity: p.intensity,
+        quality: p.type
+      };
+    })
+  };
+}
+function deserializeReport(env, now = () => (/* @__PURE__ */ new Date()).toISOString()) {
+  const parsed = bodymapReportV1Schema.parse(env);
+  const byCodeSide = new Map(
+    REGIONS.map((r) => [`${r.code}|${r.side ?? "center"}`, r.key])
+  );
+  const out = [];
+  for (const sp of parsed.points) {
+    const key = byCodeSide.get(`${sp.region}|${sp.side}`);
+    if (!key) continue;
+    out.push(
+      painPointSchema.parse({
+        region: key,
+        intensity: sp.intensity,
+        type: sp.quality,
+        timestamp: now()
+      })
+    );
+  }
+  return out;
+}
+
+exports.PAIN_TYPES = PAIN_TYPES;
+exports.REGIONS = REGIONS;
+exports.REGION_KEYS = REGION_KEYS;
+exports.baseColorFor = baseColorFor;
+exports.bodymapReportV1Schema = bodymapReportV1Schema;
+exports.createPainSelection = createPainSelection;
+exports.defaultPalette = defaultPalette;
+exports.deserializeReport = deserializeReport;
+exports.getRegion = getRegion;
+exports.heatFor = heatFor;
+exports.isSelectable = isSelectable;
+exports.painPointSchema = painPointSchema;
+exports.painReportSchema = painReportSchema;
+exports.resolveRegions = resolveRegions;
+exports.serializeReport = serializeReport;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["z"],"mappings":";;;;;AA6BO,IAAM,OAAA,GAAiC;AAAA;AAAA,EAE5C,EAAE,GAAA,EAAK,MAAA,EAAQ,KAAA,EAAO,OAAA,EAAS,MAAM,MAAA,EAAO;AAAA,EAC5C,EAAE,GAAA,EAAK,MAAA,EAAQ,KAAA,EAAO,OAAA,EAAS,MAAM,MAAA,EAAO;AAAA,EAC5C,EAAE,GAAA,EAAK,OAAA,EAAS,KAAA,EAAO,OAAA,EAAS,MAAM,OAAA,EAAQ;AAAA,EAC9C,EAAE,GAAA,EAAK,OAAA,EAAS,KAAA,EAAO,wBAAA,EAAuB,MAAM,OAAA,EAAQ;AAAA,EAC5D,EAAE,GAAA,EAAK,QAAA,EAAU,KAAA,EAAO,kBAAA,EAAiB,MAAM,QAAA,EAAS;AAAA,EACxD,EAAE,GAAA,EAAK,OAAA,EAAS,KAAA,EAAO,OAAA,EAAS,MAAM,OAAA,EAAQ;AAAA;AAAA,EAE9C,EAAE,KAAK,eAAA,EAAiB,KAAA,EAAO,oBAAoB,IAAA,EAAM,UAAA,EAAY,MAAM,MAAA,EAAO;AAAA,EAClF,EAAE,KAAK,gBAAA,EAAkB,KAAA,EAAO,qBAAkB,IAAA,EAAM,UAAA,EAAY,MAAM,OAAA,EAAQ;AAAA,EAClF,EAAE,KAAK,WAAA,EAAa,KAAA,EAAO,oBAAoB,IAAA,EAAM,MAAA,EAAQ,MAAM,MAAA,EAAO;AAAA,EAC1E,EAAE,KAAK,YAAA,EAAc,KAAA,EAAO,qBAAkB,IAAA,EAAM,MAAA,EAAQ,MAAM,OAAA,EAAQ;AAAA,EAC1E,EAAE,KAAK,YAAA,EAAc,KAAA,EAAO,kBAAkB,IAAA,EAAM,OAAA,EAAS,MAAM,MAAA,EAAO;AAAA,EAC1E,EAAE,KAAK,aAAA,EAAe,KAAA,EAAO,mBAAgB,IAAA,EAAM,OAAA,EAAS,MAAM,OAAA,EAAQ;AAAA,EAC1E,EAAE,KAAK,WAAA,EAAa,KAAA,EAAO,qBAAqB,IAAA,EAAM,MAAA,EAAQ,MAAM,MAAA,EAAO;AAAA,EAC3E,EAAE,KAAK,YAAA,EAAc,KAAA,EAAO,sBAAmB,IAAA,EAAM,MAAA,EAAQ,MAAM,OAAA,EAAQ;AAAA,EAC3E,EAAE,KAAK,YAAA,EAAc,KAAA,EAAO,uBAAoB,IAAA,EAAM,OAAA,EAAS,MAAM,MAAA,EAAO;AAAA,EAC5E,EAAE,KAAK,aAAA,EAAe,KAAA,EAAO,wBAAkB,IAAA,EAAM,OAAA,EAAS,MAAM,OAAA,EAAQ;AAAA,EAC5E,EAAE,KAAK,WAAA,EAAa,KAAA,EAAO,oBAAiB,IAAA,EAAM,MAAA,EAAQ,MAAM,MAAA,EAAO;AAAA,EACvE,EAAE,KAAK,YAAA,EAAc,KAAA,EAAO,qBAAe,IAAA,EAAM,MAAA,EAAQ,MAAM,OAAA,EAAQ;AAAA,EACvE,EAAE,KAAK,UAAA,EAAY,KAAA,EAAO,kBAAkB,IAAA,EAAM,KAAA,EAAO,MAAM,MAAA,EAAO;AAAA,EACtE,EAAE,KAAK,WAAA,EAAa,KAAA,EAAO,mBAAgB,IAAA,EAAM,KAAA,EAAO,MAAM,OAAA,EAAQ;AAAA,EACtE,EAAE,KAAK,YAAA,EAAc,KAAA,EAAO,mBAAgB,IAAA,EAAM,OAAA,EAAS,MAAM,MAAA,EAAO;AAAA,EACxE,EAAE,KAAK,aAAA,EAAe,KAAA,EAAO,oBAAc,IAAA,EAAM,OAAA,EAAS,MAAM,OAAA,EAAQ;AAAA,EACxE,EAAE,KAAK,WAAA,EAAa,KAAA,EAAO,mBAAgB,IAAA,EAAM,MAAA,EAAQ,MAAM,MAAA,EAAO;AAAA,EACtE,EAAE,KAAK,YAAA,EAAc,KAAA,EAAO,oBAAc,IAAA,EAAM,MAAA,EAAQ,MAAM,OAAA,EAAQ;AAAA,EACtE,EAAE,KAAK,aAAA,EAAe,KAAA,EAAO,qBAAqB,IAAA,EAAM,QAAA,EAAU,MAAM,MAAA,EAAO;AAAA,EAC/E,EAAE,KAAK,cAAA,EAAgB,KAAA,EAAO,sBAAmB,IAAA,EAAM,QAAA,EAAU,MAAM,OAAA,EAAQ;AAAA,EAC/E,EAAE,KAAK,YAAA,EAAc,KAAA,EAAO,kBAAkB,IAAA,EAAM,OAAA,EAAS,MAAM,MAAA,EAAO;AAAA,EAC1E,EAAE,KAAK,aAAA,EAAe,KAAA,EAAO,mBAAgB,IAAA,EAAM,OAAA,EAAS,MAAM,OAAA,EAAQ;AAAA,EAC1E,EAAE,KAAK,WAAA,EAAa,KAAA,EAAO,gBAAgB,IAAA,EAAM,MAAA,EAAQ,MAAM,MAAA,EAAO;AAAA,EACtE,EAAE,KAAK,YAAA,EAAc,KAAA,EAAO,iBAAc,IAAA,EAAM,MAAA,EAAQ,MAAM,OAAA;AAChE;AAEA,IAAM,cAAA,GAAiB,IAAI,GAAA,CAAI,OAAA,CAAQ,IAAI,CAAC,CAAA,KAAM,CAAA,CAAE,GAAG,CAAC,CAAA;AACjD,IAAM,cAAiC,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,GAAG;AAG/D,SAAS,UAAU,GAAA,EAAqC;AAC7D,EAAA,OAAO,QAAQ,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,QAAQ,GAAG,CAAA;AAC1C;AAIO,IAAM,UAAA,GAAa,CAAC,WAAA,EAAa,MAAA,EAAQ,YAAY,SAAS;AAK9D,IAAM,eAAA,GAAkBA,MAAE,MAAA,CAAO;AAAA,EACtC,MAAA,EAAQA,KAAA,CAAE,MAAA,EAAO,CAAE,OAAO,CAAC,CAAA,KAAM,cAAA,CAAe,GAAA,CAAI,CAAC,CAAA,EAAG,EAAE,OAAA,EAAS,kBAAkB,CAAA;AAAA,EACrF,SAAA,EAAWA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,GAAM,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA;AAAA,EACzC,IAAA,EAAMA,KAAA,CAAE,IAAA,CAAK,UAAU,EAAE,QAAA,EAAS;AAAA,EAClC,SAAA,EAAWA,MAAE,MAAA;AACf,CAAC;AAGM,IAAM,gBAAA,GAAmBA,KAAA,CAAE,KAAA,CAAM,eAAe;AAuBhD,SAAS,oBACd,OAAA,GAAsB,EAAC,EACvB,IAAA,GAA6B,EAAC,EACf;AACf,EAAA,MAAM,MAAM,IAAA,CAAK,GAAA,KAAQ,uBAAM,IAAI,IAAA,IAAO,WAAA,EAAY,CAAA;AACtD,EAAA,MAAM,GAAA,uBAAU,GAAA,EAAuB;AACvC,EAAA,KAAA,MAAW,KAAK,OAAA,EAAS;AACvB,IAAA,MAAM,CAAA,GAAI,eAAA,CAAgB,KAAA,CAAM,CAAC,CAAA;AACjC,IAAA,GAAA,CAAI,GAAA,CAAI,CAAA,CAAE,MAAA,EAAQ,CAAC,CAAA;AAAA,EACrB;AACA,EAAA,OAAO;AAAA,IACL,GAAA,CAAI,MAAA,EAAQ,SAAA,EAAW,IAAA,EAAM;AAC3B,MAAA,MAAM,KAAA,GAAQ,eAAA,CAAgB,KAAA,CAAM,EAAE,MAAA,EAAQ,WAAW,IAAA,EAAM,SAAA,EAAW,GAAA,EAAI,EAAG,CAAA;AACjF,MAAA,GAAA,CAAI,GAAA,CAAI,KAAA,CAAM,MAAA,EAAQ,KAAK,CAAA;AAC3B,MAAA,OAAO,KAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAA,EAAQ,CAAC,MAAA,KAAW,GAAA,CAAI,OAAO,MAAM,CAAA;AAAA,IACrC,GAAA,EAAK,CAAC,MAAA,KAAW,GAAA,CAAI,IAAI,MAAM,CAAA;AAAA,IAC/B,GAAA,EAAK,CAAC,MAAA,KAAW,GAAA,CAAI,IAAI,MAAM,CAAA;AAAA,IAC/B,KAAA,EAAO,MAAM,GAAA,CAAI,KAAA,EAAM;AAAA,IACvB,SAAA,EAAW,MAAM,gBAAA,CAAiB,KAAA,CAAM,MAAM,IAAA,CAAK,GAAA,CAAI,MAAA,EAAQ,CAAC;AAAA,GAClE;AACF;AAeO,SAAS,cAAA,CAAe,MAAA,GAAuB,EAAC,EAAiB;AACtE,EAAA,OAAO,OAAA,CAAQ,OAAO,CAAC,CAAA,KAAM,OAAO,CAAA,CAAE,GAAG,CAAA,EAAG,OAAA,IAAW,IAAI,CAAA;AAC7D;AAGO,SAAS,YAAA,CAAa,GAAA,EAAa,MAAA,GAAuB,EAAC,EAAY;AAC5E,EAAA,MAAM,CAAA,GAAI,OAAO,GAAG,CAAA;AACpB,EAAA,IAAI,CAAA,EAAG,OAAA,KAAY,KAAA,EAAO,OAAO,KAAA;AACjC,EAAA,OAAO,GAAG,UAAA,IAAc,IAAA;AAC1B;AAqBO,IAAM,cAAA,GAAiC;AAAA,EAC5C,IAAA,EAAM,SAAA;AAAA,EACN,KAAA,EAAO,SAAA;AAAA,EACP,QAAA,EAAU,SAAA;AAAA,EACV,MAAM,EAAE,GAAA,EAAK,WAAW,GAAA,EAAK,SAAA,EAAW,MAAM,SAAA;AAChD;AAGO,SAAS,OAAA,CAAQ,SAAA,EAAmB,OAAA,GAA0B,cAAA,EAAwB;AAC3F,EAAA,OAAO,SAAA,IAAa,CAAA,GAAI,OAAA,CAAQ,IAAA,CAAK,IAAA,GAAO,SAAA,IAAa,CAAA,GAAI,OAAA,CAAQ,IAAA,CAAK,GAAA,GAAM,OAAA,CAAQ,IAAA,CAAK,GAAA;AAC/F;AAGO,SAAS,YAAA,CAAa,SAAA,EAAmB,OAAA,GAA0B,cAAA,EAAwB;AAChG,EAAA,OAAO,OAAA,CAAQ,OAAA,GAAU,SAAS,CAAA,IAAK,OAAA,CAAQ,IAAA;AACjD;AA2BO,IAAM,qBAAA,GAAwBA,MAAE,MAAA,CAAO;AAAA,EAC5C,MAAA,EAAQA,KAAA,CAAE,OAAA,CAAQ,YAAY,CAAA;AAAA,EAC9B,IAAA,EAAMA,MAAE,IAAA,CAAK,CAAC,SAAS,MAAA,EAAQ,MAAA,EAAQ,OAAO,CAAC,CAAA;AAAA,EAC/C,QAAQA,KAAA,CAAE,KAAA;AAAA,IACRA,MAAE,MAAA,CAAO;AAAA,MACP,MAAA,EAAQA,MAAE,MAAA,EAAO;AAAA,MACjB,MAAMA,KAAA,CAAE,IAAA,CAAK,CAAC,MAAA,EAAQ,OAAA,EAAS,QAAQ,CAAC,CAAA;AAAA,MACxC,SAAA,EAAWA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,GAAM,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA;AAAA,MACzC,OAAA,EAASA,KAAA,CAAE,IAAA,CAAK,UAAU,EAAE,QAAA;AAAS,KACtC;AAAA;AAEL,CAAC;AAGM,SAAS,eAAA,CACd,MAAA,EACA,IAAA,GAA4B,EAAC,EACZ;AACjB,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,YAAA;AAAA,IACR,IAAA,EAAM,KAAK,IAAA,IAAQ,OAAA;AAAA,IACnB,MAAA,EAAQ,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM;AACxB,MAAA,MAAM,CAAA,GAAI,SAAA,CAAU,CAAA,CAAE,MAAM,CAAA;AAC5B,MAAA,OAAO;AAAA,QACL,MAAA,EAAQ,CAAA,EAAG,IAAA,IAAQ,CAAA,CAAE,MAAA;AAAA,QACrB,IAAA,EAAO,GAAG,IAAA,IAAQ,QAAA;AAAA,QAClB,WAAW,CAAA,CAAE,SAAA;AAAA,QACb,SAAS,CAAA,CAAE;AAAA,OACb;AAAA,IACF,CAAC;AAAA,GACH;AACF;AAIO,SAAS,iBAAA,CACd,KACA,GAAA,GAAoB,MAAA,qBAAU,IAAA,EAAK,EAAE,aAAY,EACrC;AACZ,EAAA,MAAM,MAAA,GAAS,qBAAA,CAAsB,KAAA,CAAM,GAAG,CAAA;AAE9C,EAAA,MAAM,aAAa,IAAI,GAAA;AAAA,IACrB,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAC,CAAA,EAAG,CAAA,CAAE,IAAI,CAAA,CAAA,EAAI,EAAE,IAAA,IAAQ,QAAQ,CAAA,CAAA,EAAI,CAAA,CAAE,GAAG,CAAU;AAAA,GACxE;AACA,EAAA,MAAM,MAAkB,EAAC;AACzB,EAAA,KAAA,MAAW,EAAA,IAAM,OAAO,MAAA,EAAQ;AAC9B,IAAA,MAAM,GAAA,GAAM,WAAW,GAAA,CAAI,CAAA,EAAG,GAAG,MAAM,CAAA,CAAA,EAAI,EAAA,CAAG,IAAI,CAAA,CAAE,CAAA;AACpD,IAAA,IAAI,CAAC,GAAA,EAAK;AACV,IAAA,GAAA,CAAI,IAAA;AAAA,MACF,gBAAgB,KAAA,CAAM;AAAA,QACpB,MAAA,EAAQ,GAAA;AAAA,QACR,WAAW,EAAA,CAAG,SAAA;AAAA,QACd,MAAM,EAAA,CAAG,OAAA;AAAA,QACT,WAAW,GAAA;AAAI,OAChB;AAAA,KACH;AAAA,EACF;AACA,EAAA,OAAO,GAAA;AACT","file":"index.cjs","sourcesContent":["// @broberg/bodymap — headless core (F052.1).\n//\n// Framework-neutral: the region taxonomy + the PainReport data model (zod) + a\n// selection engine + per-app region config. NO React/Preact/DOM import — the 2D\n// (SVG) and 3D (Three.js) renderers, and all three FD apps, share this one\n// contract. Output is a structured PainReport, never a bare image.\n\nimport { z } from \"zod\";\n\nexport type Side = \"left\" | \"right\";\n\nexport interface BodyRegion {\n  /** Stable, unique identifier (snake_case) — the key used in a PainReport. */\n  key: string;\n  /** Human label (Danish). */\n  label: string;\n  /** Clinical short code (unique). */\n  code: string;\n  /** Body side, when the region is paired. */\n  side?: Side;\n}\n\n/** The canonical body regions — the AUTHORITATIVE fd-sundhed clinical taxonomy\n *  (docs/BODYMAP-TAKSONOMI.md, broberg-ai/fd-sundhed @360842f): 18 SIDE-LESS\n *  clinical codes + a separate `side` field (L/R on limbs, C=center on axis\n *  regions). The `key` is a unique per-side identifier; `code` is the side-less\n *  clinical code that goes on the bodymap/v1 wire. NOT an anatomical atlas —\n *  ~30 named surface regions for a pain-map. The 2D front renderer draws the\n *  front-visible subset; the 3D body (F052.6) drives them all. */\nexport const REGIONS: readonly BodyRegion[] = [\n  // axis / centre-line (serialised side \"center\")\n  { key: \"head\", label: \"Hoved\", code: \"HEAD\" },\n  { key: \"neck\", label: \"Nakke\", code: \"NECK\" },\n  { key: \"chest\", label: \"Bryst\", code: \"CHEST\" },\n  { key: \"thora\", label: \"Øvre ryg (thorakal)\", code: \"THORA\" },\n  { key: \"lumbar\", label: \"Lænd (lumbal)\", code: \"LUMBAR\" },\n  { key: \"groin\", label: \"Lyske\", code: \"GROIN\" },\n  // paired limbs / sides (L / R)\n  { key: \"shoulder_left\", label: \"Skulder, venstre\", code: \"SHOULDER\", side: \"left\" },\n  { key: \"shoulder_right\", label: \"Skulder, højre\", code: \"SHOULDER\", side: \"right\" },\n  { key: \"uarm_left\", label: \"Overarm, venstre\", code: \"UARM\", side: \"left\" },\n  { key: \"uarm_right\", label: \"Overarm, højre\", code: \"UARM\", side: \"right\" },\n  { key: \"elbow_left\", label: \"Albue, venstre\", code: \"ELBOW\", side: \"left\" },\n  { key: \"elbow_right\", label: \"Albue, højre\", code: \"ELBOW\", side: \"right\" },\n  { key: \"farm_left\", label: \"Underarm, venstre\", code: \"FARM\", side: \"left\" },\n  { key: \"farm_right\", label: \"Underarm, højre\", code: \"FARM\", side: \"right\" },\n  { key: \"wrist_left\", label: \"Håndled, venstre\", code: \"WRIST\", side: \"left\" },\n  { key: \"wrist_right\", label: \"Håndled, højre\", code: \"WRIST\", side: \"right\" },\n  { key: \"hand_left\", label: \"Hånd, venstre\", code: \"HAND\", side: \"left\" },\n  { key: \"hand_right\", label: \"Hånd, højre\", code: \"HAND\", side: \"right\" },\n  { key: \"hip_left\", label: \"Hofte, venstre\", code: \"HIP\", side: \"left\" },\n  { key: \"hip_right\", label: \"Hofte, højre\", code: \"HIP\", side: \"right\" },\n  { key: \"thigh_left\", label: \"Lår, venstre\", code: \"THIGH\", side: \"left\" },\n  { key: \"thigh_right\", label: \"Lår, højre\", code: \"THIGH\", side: \"right\" },\n  { key: \"knee_left\", label: \"Knæ, venstre\", code: \"KNEE\", side: \"left\" },\n  { key: \"knee_right\", label: \"Knæ, højre\", code: \"KNEE\", side: \"right\" },\n  { key: \"lowleg_left\", label: \"Underben, venstre\", code: \"LOWLEG\", side: \"left\" },\n  { key: \"lowleg_right\", label: \"Underben, højre\", code: \"LOWLEG\", side: \"right\" },\n  { key: \"ankle_left\", label: \"Ankel, venstre\", code: \"ANKLE\", side: \"left\" },\n  { key: \"ankle_right\", label: \"Ankel, højre\", code: \"ANKLE\", side: \"right\" },\n  { key: \"foot_left\", label: \"Fod, venstre\", code: \"FOOT\", side: \"left\" },\n  { key: \"foot_right\", label: \"Fod, højre\", code: \"FOOT\", side: \"right\" },\n];\n\nconst REGION_KEY_SET = new Set(REGIONS.map((r) => r.key));\nexport const REGION_KEYS: readonly string[] = REGIONS.map((r) => r.key);\n\n/** Look up a region by its key. */\nexport function getRegion(key: string): BodyRegion | undefined {\n  return REGIONS.find((r) => r.key === key);\n}\n\n// ---- PainReport model ---------------------------------------------------\n\nexport const PAIN_TYPES = [\"stikkende\", \"dump\", \"konstant\", \"jagende\"] as const;\nexport type PainType = (typeof PAIN_TYPES)[number];\n\n/** One marked pain point. `region` MUST be a known region key; `intensity` is a\n *  0-10 integer; `type` is optional but constrained; `timestamp` is an ISO string. */\nexport const painPointSchema = z.object({\n  region: z.string().refine((k) => REGION_KEY_SET.has(k), { message: \"unknown region\" }),\n  intensity: z.number().int().min(0).max(10),\n  type: z.enum(PAIN_TYPES).optional(),\n  timestamp: z.string(),\n});\nexport type PainPoint = z.infer<typeof painPointSchema>;\n\nexport const painReportSchema = z.array(painPointSchema);\nexport type PainReport = PainPoint[];\n\n// ---- Selection engine (framework-agnostic) ------------------------------\n\nexport interface PainSelection {\n  /** Mark (or update) pain on a region. One point per region — latest wins. */\n  set(region: string, intensity: number, type?: PainType): PainPoint;\n  remove(region: string): boolean;\n  get(region: string): PainPoint | undefined;\n  has(region: string): boolean;\n  clear(): void;\n  /** The current, validated PainReport. */\n  getReport(): PainReport;\n}\n\nexport interface PainSelectionOptions {\n  /** Injectable clock (ISO string) — defaults to `new Date().toISOString()`. */\n  now?: () => string;\n}\n\n/** Create a selection engine seeded with an optional report. Pure state — no\n *  DOM, no framework, no network. One point per region. */\nexport function createPainSelection(\n  initial: PainReport = [],\n  opts: PainSelectionOptions = {},\n): PainSelection {\n  const now = opts.now ?? (() => new Date().toISOString());\n  const map = new Map<string, PainPoint>();\n  for (const p of initial) {\n    const v = painPointSchema.parse(p);\n    map.set(v.region, v);\n  }\n  return {\n    set(region, intensity, type) {\n      const point = painPointSchema.parse({ region, intensity, type, timestamp: now() });\n      map.set(point.region, point);\n      return point;\n    },\n    remove: (region) => map.delete(region),\n    get: (region) => map.get(region),\n    has: (region) => map.has(region),\n    clear: () => map.clear(),\n    getReport: () => painReportSchema.parse(Array.from(map.values())),\n  };\n}\n\n// ---- Per-app region config (the toggle) ---------------------------------\n\nexport interface RegionSetting {\n  /** Render this region at all. Default true. */\n  visible?: boolean;\n  /** Allow marking pain on this region. Default true. */\n  selectable?: boolean;\n}\n\n/** Per-app config keyed by region key. An absent key ⇒ visible + selectable. */\nexport type RegionConfig = Record<string, RegionSetting>;\n\n/** The regions an app should render, honouring `visible` (default true). */\nexport function resolveRegions(config: RegionConfig = {}): BodyRegion[] {\n  return REGIONS.filter((r) => config[r.key]?.visible ?? true);\n}\n\n/** Whether a region may be marked. A hidden region is never selectable. */\nexport function isSelectable(key: string, config: RegionConfig = {}): boolean {\n  const s = config[key];\n  if (s?.visible === false) return false;\n  return s?.selectable ?? true;\n}\n\n// ---- palette (consumer-defined colours — shared by the 2D + 3D renderers) ---\n\n/** Colour control for the body renderers. Consumers pass a palette to theme the\n *  body base colour, the hover + selected highlights, the pain-heat colours, and\n *  optional per-region base colours. All values are CSS/hex colour strings. */\nexport interface BodymapPalette {\n  /** Base body colour (an unmarked region). */\n  body: string;\n  /** Region highlight on hover (before click). */\n  hover: string;\n  /** A region selected (clicked) but not yet given an intensity. */\n  selected: string;\n  /** Pain-intensity heat colours: low (0-3), mid (4-6), high (7-10). */\n  heat: { low: string; mid: string; high: string };\n  /** Optional per-region base-colour overrides (region key → colour). */\n  regions?: Record<string, string>;\n}\n\n/** The fleet default palette. Override any field per consumer. */\nexport const defaultPalette: BodymapPalette = {\n  body: \"#d2d7de\",\n  hover: \"#8fd0cd\",\n  selected: \"#5cc4b7\",\n  heat: { low: \"#fcd34d\", mid: \"#fb923c\", high: \"#ef4444\" },\n};\n\n/** The heat colour for a pain intensity, honouring the palette. */\nexport function heatFor(intensity: number, palette: BodymapPalette = defaultPalette): string {\n  return intensity >= 7 ? palette.heat.high : intensity >= 4 ? palette.heat.mid : palette.heat.low;\n}\n\n/** The base colour for a region (a per-region override, else the body colour). */\nexport function baseColorFor(regionKey: string, palette: BodymapPalette = defaultPalette): string {\n  return palette.regions?.[regionKey] ?? palette.body;\n}\n\n// ---- bodymap/v1 serialization (the shared cross-app / native wire format) ---\n//\n// The shape every consumer + the native mobile apps read (aligned with\n// fd-sundhed's bodymap/v1: region CODE + side + intensity + quality + view).\n// The internal PainReport keys on the region KEY; this maps key -> clinical CODE\n// so the report is portable and human-readable on the wire.\n\nexport type BodyView = \"front\" | \"back\" | \"left\" | \"right\";\n/** Side in the serialized report — a midline region (no side) becomes \"center\". */\nexport type SerializedSide = \"left\" | \"right\" | \"center\";\n\nexport interface SerializedPainPoint {\n  /** Clinical region CODE (e.g. \"LUMB\"). */\n  region: string;\n  side: SerializedSide;\n  intensity: number;\n  quality?: PainType;\n}\n\nexport interface BodymapReportV1 {\n  schema: \"bodymap/v1\";\n  view: BodyView;\n  points: SerializedPainPoint[];\n}\n\nexport const bodymapReportV1Schema = z.object({\n  schema: z.literal(\"bodymap/v1\"),\n  view: z.enum([\"front\", \"back\", \"left\", \"right\"]),\n  points: z.array(\n    z.object({\n      region: z.string(),\n      side: z.enum([\"left\", \"right\", \"center\"]),\n      intensity: z.number().int().min(0).max(10),\n      quality: z.enum(PAIN_TYPES).optional(),\n    }),\n  ),\n});\n\n/** Serialize a PainReport to the shared `bodymap/v1` wire format. */\nexport function serializeReport(\n  report: PainReport,\n  opts: { view?: BodyView } = {},\n): BodymapReportV1 {\n  return {\n    schema: \"bodymap/v1\",\n    view: opts.view ?? \"front\",\n    points: report.map((p) => {\n      const r = getRegion(p.region);\n      return {\n        region: r?.code ?? p.region,\n        side: (r?.side ?? \"center\") as SerializedSide,\n        intensity: p.intensity,\n        quality: p.type,\n      };\n    }),\n  };\n}\n\n/** Parse a `bodymap/v1` report back into an internal PainReport. Region CODE →\n *  key; a point whose code is unknown to this taxonomy is dropped. */\nexport function deserializeReport(\n  env: unknown,\n  now: () => string = () => new Date().toISOString(),\n): PainReport {\n  const parsed = bodymapReportV1Schema.parse(env);\n  // code is side-less, so a point is identified by code + side.\n  const byCodeSide = new Map(\n    REGIONS.map((r) => [`${r.code}|${r.side ?? \"center\"}`, r.key] as const),\n  );\n  const out: PainReport = [];\n  for (const sp of parsed.points) {\n    const key = byCodeSide.get(`${sp.region}|${sp.side}`);\n    if (!key) continue;\n    out.push(\n      painPointSchema.parse({\n        region: key,\n        intensity: sp.intensity,\n        type: sp.quality,\n        timestamp: now(),\n      }),\n    );\n  }\n  return out;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+
+type Side = "left" | "right";
+interface BodyRegion {
+    /** Stable, unique identifier (snake_case) — the key used in a PainReport. */
+    key: string;
+    /** Human label (Danish). */
+    label: string;
+    /** Clinical short code (unique). */
+    code: string;
+    /** Body side, when the region is paired. */
+    side?: Side;
+}
+/** The canonical body regions — the AUTHORITATIVE fd-sundhed clinical taxonomy
+ *  (docs/BODYMAP-TAKSONOMI.md, broberg-ai/fd-sundhed @360842f): 18 SIDE-LESS
+ *  clinical codes + a separate `side` field (L/R on limbs, C=center on axis
+ *  regions). The `key` is a unique per-side identifier; `code` is the side-less
+ *  clinical code that goes on the bodymap/v1 wire. NOT an anatomical atlas —
+ *  ~30 named surface regions for a pain-map. The 2D front renderer draws the
+ *  front-visible subset; the 3D body (F052.6) drives them all. */
+declare const REGIONS: readonly BodyRegion[];
+declare const REGION_KEYS: readonly string[];
+/** Look up a region by its key. */
+declare function getRegion(key: string): BodyRegion | undefined;
+declare const PAIN_TYPES: readonly ["stikkende", "dump", "konstant", "jagende"];
+type PainType = (typeof PAIN_TYPES)[number];
+/** One marked pain point. `region` MUST be a known region key; `intensity` is a
+ *  0-10 integer; `type` is optional but constrained; `timestamp` is an ISO string. */
+declare const painPointSchema: z.ZodObject<{
+    region: z.ZodEffects<z.ZodString, string, string>;
+    intensity: z.ZodNumber;
+    type: z.ZodOptional<z.ZodEnum<["stikkende", "dump", "konstant", "jagende"]>>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    region: string;
+    intensity: number;
+    timestamp: string;
+    type?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+}, {
+    region: string;
+    intensity: number;
+    timestamp: string;
+    type?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+}>;
+type PainPoint = z.infer<typeof painPointSchema>;
+declare const painReportSchema: z.ZodArray<z.ZodObject<{
+    region: z.ZodEffects<z.ZodString, string, string>;
+    intensity: z.ZodNumber;
+    type: z.ZodOptional<z.ZodEnum<["stikkende", "dump", "konstant", "jagende"]>>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    region: string;
+    intensity: number;
+    timestamp: string;
+    type?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+}, {
+    region: string;
+    intensity: number;
+    timestamp: string;
+    type?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+}>, "many">;
+type PainReport = PainPoint[];
+interface PainSelection {
+    /** Mark (or update) pain on a region. One point per region — latest wins. */
+    set(region: string, intensity: number, type?: PainType): PainPoint;
+    remove(region: string): boolean;
+    get(region: string): PainPoint | undefined;
+    has(region: string): boolean;
+    clear(): void;
+    /** The current, validated PainReport. */
+    getReport(): PainReport;
+}
+interface PainSelectionOptions {
+    /** Injectable clock (ISO string) — defaults to `new Date().toISOString()`. */
+    now?: () => string;
+}
+/** Create a selection engine seeded with an optional report. Pure state — no
+ *  DOM, no framework, no network. One point per region. */
+declare function createPainSelection(initial?: PainReport, opts?: PainSelectionOptions): PainSelection;
+interface RegionSetting {
+    /** Render this region at all. Default true. */
+    visible?: boolean;
+    /** Allow marking pain on this region. Default true. */
+    selectable?: boolean;
+}
+/** Per-app config keyed by region key. An absent key ⇒ visible + selectable. */
+type RegionConfig = Record<string, RegionSetting>;
+/** The regions an app should render, honouring `visible` (default true). */
+declare function resolveRegions(config?: RegionConfig): BodyRegion[];
+/** Whether a region may be marked. A hidden region is never selectable. */
+declare function isSelectable(key: string, config?: RegionConfig): boolean;
+/** Colour control for the body renderers. Consumers pass a palette to theme the
+ *  body base colour, the hover + selected highlights, the pain-heat colours, and
+ *  optional per-region base colours. All values are CSS/hex colour strings. */
+interface BodymapPalette {
+    /** Base body colour (an unmarked region). */
+    body: string;
+    /** Region highlight on hover (before click). */
+    hover: string;
+    /** A region selected (clicked) but not yet given an intensity. */
+    selected: string;
+    /** Pain-intensity heat colours: low (0-3), mid (4-6), high (7-10). */
+    heat: {
+        low: string;
+        mid: string;
+        high: string;
+    };
+    /** Optional per-region base-colour overrides (region key → colour). */
+    regions?: Record<string, string>;
+}
+/** The fleet default palette. Override any field per consumer. */
+declare const defaultPalette: BodymapPalette;
+/** The heat colour for a pain intensity, honouring the palette. */
+declare function heatFor(intensity: number, palette?: BodymapPalette): string;
+/** The base colour for a region (a per-region override, else the body colour). */
+declare function baseColorFor(regionKey: string, palette?: BodymapPalette): string;
+type BodyView = "front" | "back" | "left" | "right";
+/** Side in the serialized report — a midline region (no side) becomes "center". */
+type SerializedSide = "left" | "right" | "center";
+interface SerializedPainPoint {
+    /** Clinical region CODE (e.g. "LUMB"). */
+    region: string;
+    side: SerializedSide;
+    intensity: number;
+    quality?: PainType;
+}
+interface BodymapReportV1 {
+    schema: "bodymap/v1";
+    view: BodyView;
+    points: SerializedPainPoint[];
+}
+declare const bodymapReportV1Schema: z.ZodObject<{
+    schema: z.ZodLiteral<"bodymap/v1">;
+    view: z.ZodEnum<["front", "back", "left", "right"]>;
+    points: z.ZodArray<z.ZodObject<{
+        region: z.ZodString;
+        side: z.ZodEnum<["left", "right", "center"]>;
+        intensity: z.ZodNumber;
+        quality: z.ZodOptional<z.ZodEnum<["stikkende", "dump", "konstant", "jagende"]>>;
+    }, "strip", z.ZodTypeAny, {
+        side: "left" | "right" | "center";
+        region: string;
+        intensity: number;
+        quality?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+    }, {
+        side: "left" | "right" | "center";
+        region: string;
+        intensity: number;
+        quality?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schema: "bodymap/v1";
+    view: "left" | "right" | "front" | "back";
+    points: {
+        side: "left" | "right" | "center";
+        region: string;
+        intensity: number;
+        quality?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+    }[];
+}, {
+    schema: "bodymap/v1";
+    view: "left" | "right" | "front" | "back";
+    points: {
+        side: "left" | "right" | "center";
+        region: string;
+        intensity: number;
+        quality?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+    }[];
+}>;
+/** Serialize a PainReport to the shared `bodymap/v1` wire format. */
+declare function serializeReport(report: PainReport, opts?: {
+    view?: BodyView;
+}): BodymapReportV1;
+/** Parse a `bodymap/v1` report back into an internal PainReport. Region CODE →
+ *  key; a point whose code is unknown to this taxonomy is dropped. */
+declare function deserializeReport(env: unknown, now?: () => string): PainReport;
+
+export { type BodyRegion, type BodyView, type BodymapPalette, type BodymapReportV1, PAIN_TYPES, type PainPoint, type PainReport, type PainSelection, type PainSelectionOptions, type PainType, REGIONS, REGION_KEYS, type RegionConfig, type RegionSetting, type SerializedPainPoint, type SerializedSide, type Side, baseColorFor, bodymapReportV1Schema, createPainSelection, defaultPalette, deserializeReport, getRegion, heatFor, isSelectable, painPointSchema, painReportSchema, resolveRegions, serializeReport };

package/dist/index.d.ts

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+
+type Side = "left" | "right";
+interface BodyRegion {
+    /** Stable, unique identifier (snake_case) — the key used in a PainReport. */
+    key: string;
+    /** Human label (Danish). */
+    label: string;
+    /** Clinical short code (unique). */
+    code: string;
+    /** Body side, when the region is paired. */
+    side?: Side;
+}
+/** The canonical body regions — the AUTHORITATIVE fd-sundhed clinical taxonomy
+ *  (docs/BODYMAP-TAKSONOMI.md, broberg-ai/fd-sundhed @360842f): 18 SIDE-LESS
+ *  clinical codes + a separate `side` field (L/R on limbs, C=center on axis
+ *  regions). The `key` is a unique per-side identifier; `code` is the side-less
+ *  clinical code that goes on the bodymap/v1 wire. NOT an anatomical atlas —
+ *  ~30 named surface regions for a pain-map. The 2D front renderer draws the
+ *  front-visible subset; the 3D body (F052.6) drives them all. */
+declare const REGIONS: readonly BodyRegion[];
+declare const REGION_KEYS: readonly string[];
+/** Look up a region by its key. */
+declare function getRegion(key: string): BodyRegion | undefined;
+declare const PAIN_TYPES: readonly ["stikkende", "dump", "konstant", "jagende"];
+type PainType = (typeof PAIN_TYPES)[number];
+/** One marked pain point. `region` MUST be a known region key; `intensity` is a
+ *  0-10 integer; `type` is optional but constrained; `timestamp` is an ISO string. */
+declare const painPointSchema: z.ZodObject<{
+    region: z.ZodEffects<z.ZodString, string, string>;
+    intensity: z.ZodNumber;
+    type: z.ZodOptional<z.ZodEnum<["stikkende", "dump", "konstant", "jagende"]>>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    region: string;
+    intensity: number;
+    timestamp: string;
+    type?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+}, {
+    region: string;
+    intensity: number;
+    timestamp: string;
+    type?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+}>;
+type PainPoint = z.infer<typeof painPointSchema>;
+declare const painReportSchema: z.ZodArray<z.ZodObject<{
+    region: z.ZodEffects<z.ZodString, string, string>;
+    intensity: z.ZodNumber;
+    type: z.ZodOptional<z.ZodEnum<["stikkende", "dump", "konstant", "jagende"]>>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    region: string;
+    intensity: number;
+    timestamp: string;
+    type?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+}, {
+    region: string;
+    intensity: number;
+    timestamp: string;
+    type?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+}>, "many">;
+type PainReport = PainPoint[];
+interface PainSelection {
+    /** Mark (or update) pain on a region. One point per region — latest wins. */
+    set(region: string, intensity: number, type?: PainType): PainPoint;
+    remove(region: string): boolean;
+    get(region: string): PainPoint | undefined;
+    has(region: string): boolean;
+    clear(): void;
+    /** The current, validated PainReport. */
+    getReport(): PainReport;
+}
+interface PainSelectionOptions {
+    /** Injectable clock (ISO string) — defaults to `new Date().toISOString()`. */
+    now?: () => string;
+}
+/** Create a selection engine seeded with an optional report. Pure state — no
+ *  DOM, no framework, no network. One point per region. */
+declare function createPainSelection(initial?: PainReport, opts?: PainSelectionOptions): PainSelection;
+interface RegionSetting {
+    /** Render this region at all. Default true. */
+    visible?: boolean;
+    /** Allow marking pain on this region. Default true. */
+    selectable?: boolean;
+}
+/** Per-app config keyed by region key. An absent key ⇒ visible + selectable. */
+type RegionConfig = Record<string, RegionSetting>;
+/** The regions an app should render, honouring `visible` (default true). */
+declare function resolveRegions(config?: RegionConfig): BodyRegion[];
+/** Whether a region may be marked. A hidden region is never selectable. */
+declare function isSelectable(key: string, config?: RegionConfig): boolean;
+/** Colour control for the body renderers. Consumers pass a palette to theme the
+ *  body base colour, the hover + selected highlights, the pain-heat colours, and
+ *  optional per-region base colours. All values are CSS/hex colour strings. */
+interface BodymapPalette {
+    /** Base body colour (an unmarked region). */
+    body: string;
+    /** Region highlight on hover (before click). */
+    hover: string;
+    /** A region selected (clicked) but not yet given an intensity. */
+    selected: string;
+    /** Pain-intensity heat colours: low (0-3), mid (4-6), high (7-10). */
+    heat: {
+        low: string;
+        mid: string;
+        high: string;
+    };
+    /** Optional per-region base-colour overrides (region key → colour). */
+    regions?: Record<string, string>;
+}
+/** The fleet default palette. Override any field per consumer. */
+declare const defaultPalette: BodymapPalette;
+/** The heat colour for a pain intensity, honouring the palette. */
+declare function heatFor(intensity: number, palette?: BodymapPalette): string;
+/** The base colour for a region (a per-region override, else the body colour). */
+declare function baseColorFor(regionKey: string, palette?: BodymapPalette): string;
+type BodyView = "front" | "back" | "left" | "right";
+/** Side in the serialized report — a midline region (no side) becomes "center". */
+type SerializedSide = "left" | "right" | "center";
+interface SerializedPainPoint {
+    /** Clinical region CODE (e.g. "LUMB"). */
+    region: string;
+    side: SerializedSide;
+    intensity: number;
+    quality?: PainType;
+}
+interface BodymapReportV1 {
+    schema: "bodymap/v1";
+    view: BodyView;
+    points: SerializedPainPoint[];
+}
+declare const bodymapReportV1Schema: z.ZodObject<{
+    schema: z.ZodLiteral<"bodymap/v1">;
+    view: z.ZodEnum<["front", "back", "left", "right"]>;
+    points: z.ZodArray<z.ZodObject<{
+        region: z.ZodString;
+        side: z.ZodEnum<["left", "right", "center"]>;
+        intensity: z.ZodNumber;
+        quality: z.ZodOptional<z.ZodEnum<["stikkende", "dump", "konstant", "jagende"]>>;
+    }, "strip", z.ZodTypeAny, {
+        side: "left" | "right" | "center";
+        region: string;
+        intensity: number;
+        quality?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+    }, {
+        side: "left" | "right" | "center";
+        region: string;
+        intensity: number;
+        quality?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schema: "bodymap/v1";
+    view: "left" | "right" | "front" | "back";
+    points: {
+        side: "left" | "right" | "center";
+        region: string;
+        intensity: number;
+        quality?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+    }[];
+}, {
+    schema: "bodymap/v1";
+    view: "left" | "right" | "front" | "back";
+    points: {
+        side: "left" | "right" | "center";
+        region: string;
+        intensity: number;
+        quality?: "stikkende" | "dump" | "konstant" | "jagende" | undefined;
+    }[];
+}>;
+/** Serialize a PainReport to the shared `bodymap/v1` wire format. */
+declare function serializeReport(report: PainReport, opts?: {
+    view?: BodyView;
+}): BodymapReportV1;
+/** Parse a `bodymap/v1` report back into an internal PainReport. Region CODE →
+ *  key; a point whose code is unknown to this taxonomy is dropped. */
+declare function deserializeReport(env: unknown, now?: () => string): PainReport;
+
+export { type BodyRegion, type BodyView, type BodymapPalette, type BodymapReportV1, PAIN_TYPES, type PainPoint, type PainReport, type PainSelection, type PainSelectionOptions, type PainType, REGIONS, REGION_KEYS, type RegionConfig, type RegionSetting, type SerializedPainPoint, type SerializedSide, type Side, baseColorFor, bodymapReportV1Schema, createPainSelection, defaultPalette, deserializeReport, getRegion, heatFor, isSelectable, painPointSchema, painReportSchema, resolveRegions, serializeReport };