@mieweb/ui 0.6.1-dev.159 → 0.6.1-dev.164

package/dist/esheet.d.ts

@@ -1,3 +1,120 @@
+import { FieldComponentProps } from '@esheet/core';
 export { FormDefinition } from '@esheet/core';
 export { EsheetBuilder, EsheetBuilderProps } from '@esheet/builder';
 export { EsheetRenderer, EsheetRendererHandle, EsheetRendererProps } from '@esheet/renderer';
+import * as React from 'react';
+import { C as CodeLookupConfig, M as Medication, A as Allergy } from './MedicationEditor-Bp4NLy7y.js';
+
+/**
+ * MedicationListField — eSheet custom field wrapper around
+ * MedicationReconciliation.
+ *
+ * Thin adapter: all reconciliation UI/behavior lives in the standalone
+ * `MedicationReconciliation` component (main bundle). This file only maps the
+ * eSheet field contract (definition, response, preview/enabled state) onto it.
+ *
+ * Exposed via the `@mieweb/ui/esheet` entry point (NOT the main bundle) so
+ * that @esheet/* stays an optional dependency.
+ *
+ * The field stores its state as JSON in `response.answer`:
+ * `{ medications: Medication[] }`.
+ *
+ * @example
+ * ```tsx
+ * import { registerMedicationListFieldType } from '@mieweb/ui/esheet';
+ *
+ * registerMedicationListFieldType(); // before rendering EsheetBuilder/Renderer
+ * ```
+ */
+
+interface MedicationListFieldValue {
+    medications: Medication[];
+}
+declare function MedicationListField({ field, response, isPreview, isEnabled, onResponse, codeLookup, }: FieldComponentProps & {
+    /** CodeLookup wiring — supplied via registerMedicationListFieldType() */
+    codeLookup?: CodeLookupConfig | false;
+}): React.JSX.Element;
+/**
+ * Register the `medicationList` field type with eSheet.
+ * Call once before rendering EsheetBuilder or EsheetRenderer.
+ *
+ * @param options.codeLookup — wire the offline RxNorm/FDB CodeLookup into the
+ * medication editor (Correct / Add Medication):
+ * ```tsx
+ * import { CodeLookup } from '…/CodeLookup';
+ * registerMedicationListFieldType({
+ *   codeLookup: { component: CodeLookup, indexUrl: '/codify' },
+ * });
+ * ```
+ */
+declare function registerMedicationListFieldType(options?: {
+    codeLookup?: CodeLookupConfig | false;
+}): void;
+
+/**
+ * AllergyListField — eSheet custom field wrapper around AllergyManager.
+ *
+ * Thin adapter, same pattern as MedicationListField. State persists as JSON
+ * in `response.answer`: `{ allergies: Allergy[], noKnownAllergies?: boolean }`.
+ *
+ * @example
+ * ```tsx
+ * import { registerAllergyListFieldType } from '@mieweb/ui/esheet';
+ *
+ * registerAllergyListFieldType({ codeLookup: { component: CodeLookup, indexUrl: '/codify' } });
+ * ```
+ */
+
+interface AllergyListFieldValue {
+    allergies: Allergy[];
+    noKnownAllergies?: boolean;
+}
+declare function AllergyListField({ field, response, isPreview, isEnabled, onResponse, codeLookup, }: FieldComponentProps & {
+    /** CodeLookup wiring — supplied via registerAllergyListFieldType() */
+    codeLookup?: CodeLookupConfig | false;
+}): React.JSX.Element;
+/**
+ * Register the `allergyList` field type with eSheet.
+ * Call once before rendering EsheetBuilder or EsheetRenderer.
+ */
+declare function registerAllergyListFieldType(options?: {
+    codeLookup?: CodeLookupConfig | false;
+}): void;
+
+/**
+ * registerMieEsheetFields — one-call registration for every @mieweb/ui custom
+ * eSheet field type (medication reconciliation + allergy list).
+ *
+ * The @esheet/* packages stay generic and free of medical dependencies; these
+ * fields live in @mieweb/ui and opt in from the consumer side. This helper is
+ * the "batteries included" entry point so an app can enable the full medical
+ * field set with a single call instead of wiring each field type by hand.
+ *
+ * @example
+ * ```tsx
+ * import { registerMieEsheetFields } from '@mieweb/ui/esheet';
+ * import { CodeLookup } from '…/CodeLookup';
+ *
+ * // once, before EsheetBuilder / EsheetRenderer mount
+ * registerMieEsheetFields({
+ *   codeLookup: { component: CodeLookup, indexUrl: '/codify' },
+ * });
+ * ```
+ */
+
+interface RegisterMieEsheetFieldsOptions {
+    /**
+     * Shared CodeLookup wiring applied to every field that supports offline
+     * RxNorm/FDB coding (medication + allergy editors).
+     */
+    codeLookup?: CodeLookupConfig;
+}
+/**
+ * Register all @mieweb/ui custom eSheet field types at once:
+ * `medicationList` and `allergyList`.
+ *
+ * Call once before rendering EsheetBuilder or EsheetRenderer.
+ */
+declare function registerMieEsheetFields(options?: RegisterMieEsheetFieldsOptions): void;
+
+export { AllergyListField, type AllergyListFieldValue, MedicationListField, type MedicationListFieldValue, type RegisterMieEsheetFieldsOptions, registerAllergyListFieldType, registerMedicationListFieldType, registerMieEsheetFields };

package/dist/esheet.js

@@ -1,4 +1,165 @@
+import { MedicationReconciliation, useCodeLookupConfig, AllergyManager } from './chunk-HUXOASEB.js';
+import './chunk-6LFG4JFF.js';
+import './chunk-FZJBFJJR.js';
+import './chunk-EZKRAW2X.js';
+import './chunk-R25H4N4Z.js';
+import './chunk-DUPR6FEL.js';
+import './chunk-5BQE6BEL.js';
+import './chunk-HYEJLKXI.js';
+import './chunk-IUFDGB5O.js';
+import './chunk-PVUDXJAI.js';
+import './chunk-DHKYGVP7.js';
+import './chunk-ZVSW2KS6.js';
+import './chunk-T42BCIUA.js';
+import './chunk-7ZVTLTJF.js';
+import './chunk-HB7C7NB5.js';
+import './chunk-4SMSH4OY.js';
+import './chunk-T4ME7QCT.js';
+import './chunk-RC2YMOMS.js';
+import './chunk-F3SOEIN2.js';
+import './chunk-VSQF22GL.js';
 export { EsheetBuilder } from '@esheet/builder';
 export { EsheetRenderer } from '@esheet/renderer';
+import * as React from 'react';
+import { registerCustomFieldTypes } from '@esheet/fields';
+import { jsx } from 'react/jsx-runtime';
+
+function parseValue(answer) {
+  if (!answer) return { medications: [] };
+  try {
+    const parsed = JSON.parse(answer);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return { medications: [] };
+    }
+    const { medications } = parsed;
+    return {
+      medications: Array.isArray(medications) ? medications : []
+    };
+  } catch {
+    return { medications: [] };
+  }
+}
+function MedicationListField({
+  field,
+  response,
+  isPreview,
+  isEnabled,
+  onResponse,
+  codeLookup
+}) {
+  const definition = field.definition;
+  const medications = React.useMemo(() => {
+    if (response?.answer) return parseValue(response.answer).medications;
+    return definition.medications ?? [];
+  }, [response?.answer, definition.medications]);
+  return /* @__PURE__ */ jsx(
+    MedicationReconciliation,
+    {
+      medications,
+      onChange: (next) => onResponse({ answer: JSON.stringify({ medications: next }) }),
+      title: definition.question ?? "Presenting medications",
+      quickAddOptions: definition.quickAddOptions,
+      codeLookup,
+      readOnly: !(isPreview && isEnabled)
+    }
+  );
+}
+function registerMedicationListFieldType(options) {
+  const Field = (props) => /* @__PURE__ */ jsx(MedicationListField, { ...props, codeLookup: options?.codeLookup });
+  registerCustomFieldTypes({
+    medicationList: {
+      label: "Medication Reconciliation",
+      category: "rich",
+      answerType: "text",
+      hasOptions: false,
+      hasMatrix: false,
+      defaultProps: {
+        question: "Presenting medications",
+        quickAddOptions: [
+          "aspirin 81 mg tablet",
+          "atorvastatin 20 mg tablet",
+          "metformin 500 mg tablet"
+        ]
+      },
+      component: Field
+    }
+  });
+}
+function parseValue2(answer) {
+  if (!answer) return { allergies: [] };
+  try {
+    const parsed = JSON.parse(answer);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return { allergies: [] };
+    }
+    const { allergies, noKnownAllergies } = parsed;
+    return {
+      allergies: Array.isArray(allergies) ? allergies : [],
+      noKnownAllergies: typeof noKnownAllergies === "boolean" ? noKnownAllergies : void 0
+    };
+  } catch {
+    return { allergies: [] };
+  }
+}
+function AllergyListField({
+  field,
+  response,
+  isPreview,
+  isEnabled,
+  onResponse,
+  codeLookup
+}) {
+  const definition = field.definition;
+  const ambientCodeLookup = useCodeLookupConfig();
+  const effectiveCodeLookup = codeLookup === false ? void 0 : codeLookup ?? ambientCodeLookup ?? void 0;
+  const value = React.useMemo(() => {
+    if (response?.answer) return parseValue2(response.answer);
+    return { allergies: definition.allergies ?? [] };
+  }, [response?.answer, definition.allergies]);
+  const commit = (next) => {
+    onResponse({ answer: JSON.stringify(next) });
+  };
+  return /* @__PURE__ */ jsx(
+    AllergyManager,
+    {
+      allergies: value.allergies,
+      onChange: (allergies) => commit({
+        allergies,
+        // any recorded allergy clears NKA
+        noKnownAllergies: allergies.length > 0 ? void 0 : value.noKnownAllergies
+      }),
+      noKnownAllergies: value.noKnownAllergies,
+      onNoKnownAllergiesChange: (nka) => commit({ allergies: value.allergies, noKnownAllergies: nka }),
+      title: definition.question ?? "Allergies",
+      codeLookup,
+      inlineAddSearch: Boolean(effectiveCodeLookup),
+      readOnly: !(isPreview && isEnabled)
+    }
+  );
+}
+function registerAllergyListFieldType(options) {
+  const Field = (props) => /* @__PURE__ */ jsx(AllergyListField, { ...props, codeLookup: options?.codeLookup });
+  registerCustomFieldTypes({
+    allergyList: {
+      label: "Allergy List",
+      category: "rich",
+      answerType: "text",
+      hasOptions: false,
+      hasMatrix: false,
+      defaultProps: {
+        question: "Allergies"
+      },
+      component: Field
+    }
+  });
+}
+
+// src/esheet-fields/registerAll.ts
+function registerMieEsheetFields(options) {
+  registerMedicationListFieldType({ codeLookup: options?.codeLookup });
+  registerAllergyListFieldType({ codeLookup: options?.codeLookup });
+}
+
+export { AllergyListField, MedicationListField, registerAllergyListFieldType, registerMedicationListFieldType, registerMieEsheetFields };
 //# sourceMappingURL=esheet.js.map
 //# sourceMappingURL=esheet.js.map

package/dist/esheet.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"esheet.js","sourcesContent":[]}
+{"version":3,"sources":["../src/esheet-fields/MedicationListField.tsx","../src/esheet-fields/AllergyListField.tsx","../src/esheet-fields/registerAll.ts"],"names":["parseValue","React2","jsx","registerCustomFieldTypes"],"mappings":"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","file":"esheet.js","sourcesContent":["/**\n * MedicationListField — eSheet custom field wrapper around\n * MedicationReconciliation.\n *\n * Thin adapter: all reconciliation UI/behavior lives in the standalone\n * `MedicationReconciliation` component (main bundle). This file only maps the\n * eSheet field contract (definition, response, preview/enabled state) onto it.\n *\n * Exposed via the `@mieweb/ui/esheet` entry point (NOT the main bundle) so\n * that @esheet/* stays an optional dependency.\n *\n * The field stores its state as JSON in `response.answer`:\n * `{ medications: Medication[] }`.\n *\n * @example\n * ```tsx\n * import { registerMedicationListFieldType } from '@mieweb/ui/esheet';\n *\n * registerMedicationListFieldType(); // before rendering EsheetBuilder/Renderer\n * ```\n */\n\nimport * as React from 'react';\nimport type { FieldComponentProps } from '@esheet/core';\nimport { registerCustomFieldTypes } from '@esheet/fields';\nimport {\n  MedicationReconciliation,\n  type CodeLookupConfig,\n  type Medication,\n} from '../components/MedicationList';\n\n// =============================================================================\n// Response (de)serialization\n// =============================================================================\n\nexport interface MedicationListFieldValue {\n  medications: Medication[];\n}\n\nfunction parseValue(answer: string | undefined): MedicationListFieldValue {\n  if (!answer) return { medications: [] };\n  try {\n    // shape-guarded: valid JSON like `null` or `[]` must degrade safely\n    const parsed: unknown = JSON.parse(answer);\n    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n      return { medications: [] };\n    }\n    const { medications } = parsed as { medications?: unknown };\n    return {\n      medications: Array.isArray(medications)\n        ? (medications as Medication[])\n        : [],\n    };\n  } catch {\n    return { medications: [] };\n  }\n}\n\n// =============================================================================\n// Field component\n// =============================================================================\n\nexport function MedicationListField({\n  field,\n  response,\n  isPreview,\n  isEnabled,\n  onResponse,\n  codeLookup,\n}: FieldComponentProps & {\n  /** CodeLookup wiring — supplied via registerMedicationListFieldType() */\n  codeLookup?: CodeLookupConfig | false;\n}): React.JSX.Element {\n  const definition = field.definition as {\n    question?: string;\n    medications?: Medication[];\n    quickAddOptions?: string[];\n  };\n\n  // Response wins; otherwise seed from the field definition's medication list.\n  const medications = React.useMemo(() => {\n    if (response?.answer) return parseValue(response.answer).medications;\n    return definition.medications ?? [];\n  }, [response?.answer, definition.medications]);\n\n  return (\n    <MedicationReconciliation\n      medications={medications}\n      onChange={(next) =>\n        onResponse({ answer: JSON.stringify({ medications: next }) })\n      }\n      title={definition.question ?? 'Presenting medications'}\n      quickAddOptions={definition.quickAddOptions}\n      codeLookup={codeLookup}\n      readOnly={!(isPreview && isEnabled)}\n    />\n  );\n}\n\n// =============================================================================\n// Registration\n// =============================================================================\n\n/**\n * Register the `medicationList` field type with eSheet.\n * Call once before rendering EsheetBuilder or EsheetRenderer.\n *\n * @param options.codeLookup — wire the offline RxNorm/FDB CodeLookup into the\n * medication editor (Correct / Add Medication):\n * ```tsx\n * import { CodeLookup } from '…/CodeLookup';\n * registerMedicationListFieldType({\n *   codeLookup: { component: CodeLookup, indexUrl: '/codify' },\n * });\n * ```\n */\nexport function registerMedicationListFieldType(options?: {\n  codeLookup?: CodeLookupConfig | false;\n}): void {\n  const Field = (props: FieldComponentProps) => (\n    <MedicationListField {...props} codeLookup={options?.codeLookup} />\n  );\n  registerCustomFieldTypes({\n    medicationList: {\n      label: 'Medication Reconciliation',\n      category: 'rich',\n      answerType: 'text',\n      hasOptions: false,\n      hasMatrix: false,\n      defaultProps: {\n        question: 'Presenting medications',\n        quickAddOptions: [\n          'aspirin 81 mg tablet',\n          'atorvastatin 20 mg tablet',\n          'metformin 500 mg tablet',\n        ],\n      },\n      component: Field,\n    },\n  });\n}\n","/**\n * AllergyListField — eSheet custom field wrapper around AllergyManager.\n *\n * Thin adapter, same pattern as MedicationListField. State persists as JSON\n * in `response.answer`: `{ allergies: Allergy[], noKnownAllergies?: boolean }`.\n *\n * @example\n * ```tsx\n * import { registerAllergyListFieldType } from '@mieweb/ui/esheet';\n *\n * registerAllergyListFieldType({ codeLookup: { component: CodeLookup, indexUrl: '/codify' } });\n * ```\n */\n\nimport * as React from 'react';\nimport type { FieldComponentProps } from '@esheet/core';\nimport { registerCustomFieldTypes } from '@esheet/fields';\nimport { AllergyManager, type Allergy } from '../components/AllergyList';\nimport type { CodeLookupConfig } from '../components/MedicationList';\nimport { useCodeLookupConfig } from '../components/CodeLookup/context';\n\n// =============================================================================\n// Response (de)serialization\n// =============================================================================\n\nexport interface AllergyListFieldValue {\n  allergies: Allergy[];\n  noKnownAllergies?: boolean;\n}\n\nfunction parseValue(answer: string | undefined): AllergyListFieldValue {\n  if (!answer) return { allergies: [] };\n  try {\n    // shape-guarded: valid JSON like `null` or `[]` must degrade safely\n    const parsed: unknown = JSON.parse(answer);\n    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n      return { allergies: [] };\n    }\n    const { allergies, noKnownAllergies } = parsed as Partial<\n      Record<keyof AllergyListFieldValue, unknown>\n    >;\n    return {\n      allergies: Array.isArray(allergies) ? (allergies as Allergy[]) : [],\n      noKnownAllergies:\n        typeof noKnownAllergies === 'boolean' ? noKnownAllergies : undefined,\n    };\n  } catch {\n    return { allergies: [] };\n  }\n}\n\n// =============================================================================\n// Field component\n// =============================================================================\n\nexport function AllergyListField({\n  field,\n  response,\n  isPreview,\n  isEnabled,\n  onResponse,\n  codeLookup,\n}: FieldComponentProps & {\n  /** CodeLookup wiring — supplied via registerAllergyListFieldType() */\n  codeLookup?: CodeLookupConfig | false;\n}): React.JSX.Element {\n  const definition = field.definition as {\n    question?: string;\n    allergies?: Allergy[];\n  };\n\n  // Default to the ambient provider; `false` forces plain text.\n  const ambientCodeLookup = useCodeLookupConfig();\n  const effectiveCodeLookup =\n    codeLookup === false\n      ? undefined\n      : (codeLookup ?? ambientCodeLookup ?? undefined);\n\n  const value = React.useMemo(() => {\n    if (response?.answer) return parseValue(response.answer);\n    return { allergies: definition.allergies ?? [] };\n  }, [response?.answer, definition.allergies]);\n\n  const commit = (next: AllergyListFieldValue) => {\n    onResponse({ answer: JSON.stringify(next) });\n  };\n\n  return (\n    <AllergyManager\n      allergies={value.allergies}\n      onChange={(allergies) =>\n        commit({\n          allergies,\n          // any recorded allergy clears NKA\n          noKnownAllergies:\n            allergies.length > 0 ? undefined : value.noKnownAllergies,\n        })\n      }\n      noKnownAllergies={value.noKnownAllergies}\n      onNoKnownAllergiesChange={(nka) =>\n        commit({ allergies: value.allergies, noKnownAllergies: nka })\n      }\n      title={definition.question ?? 'Allergies'}\n      codeLookup={codeLookup}\n      inlineAddSearch={Boolean(effectiveCodeLookup)}\n      readOnly={!(isPreview && isEnabled)}\n    />\n  );\n}\n\n// =============================================================================\n// Registration\n// =============================================================================\n\n/**\n * Register the `allergyList` field type with eSheet.\n * Call once before rendering EsheetBuilder or EsheetRenderer.\n */\nexport function registerAllergyListFieldType(options?: {\n  codeLookup?: CodeLookupConfig | false;\n}): void {\n  const Field = (props: FieldComponentProps) => (\n    <AllergyListField {...props} codeLookup={options?.codeLookup} />\n  );\n  registerCustomFieldTypes({\n    allergyList: {\n      label: 'Allergy List',\n      category: 'rich',\n      answerType: 'text',\n      hasOptions: false,\n      hasMatrix: false,\n      defaultProps: {\n        question: 'Allergies',\n      },\n      component: Field,\n    },\n  });\n}\n","/**\n * registerMieEsheetFields — one-call registration for every @mieweb/ui custom\n * eSheet field type (medication reconciliation + allergy list).\n *\n * The @esheet/* packages stay generic and free of medical dependencies; these\n * fields live in @mieweb/ui and opt in from the consumer side. This helper is\n * the \"batteries included\" entry point so an app can enable the full medical\n * field set with a single call instead of wiring each field type by hand.\n *\n * @example\n * ```tsx\n * import { registerMieEsheetFields } from '@mieweb/ui/esheet';\n * import { CodeLookup } from '…/CodeLookup';\n *\n * // once, before EsheetBuilder / EsheetRenderer mount\n * registerMieEsheetFields({\n *   codeLookup: { component: CodeLookup, indexUrl: '/codify' },\n * });\n * ```\n */\n\nimport type { CodeLookupConfig } from '../components/MedicationList';\nimport { registerMedicationListFieldType } from './MedicationListField';\nimport { registerAllergyListFieldType } from './AllergyListField';\n\nexport interface RegisterMieEsheetFieldsOptions {\n  /**\n   * Shared CodeLookup wiring applied to every field that supports offline\n   * RxNorm/FDB coding (medication + allergy editors).\n   */\n  codeLookup?: CodeLookupConfig;\n}\n\n/**\n * Register all @mieweb/ui custom eSheet field types at once:\n * `medicationList` and `allergyList`.\n *\n * Call once before rendering EsheetBuilder or EsheetRenderer.\n */\nexport function registerMieEsheetFields(\n  options?: RegisterMieEsheetFieldsOptions\n): void {\n  registerMedicationListFieldType({ codeLookup: options?.codeLookup });\n  registerAllergyListFieldType({ codeLookup: options?.codeLookup });\n}\n"]}

package/dist/hooks/index.cjs

@@ -1,59 +1,80 @@
 'use strict';
 
-var chunkFSBFQBNE_cjs = require('../chunk-FSBFQBNE.cjs');
+var chunkDKGUOMBC_cjs = require('../chunk-DKGUOMBC.cjs');
 var chunk2O7D6F67_cjs = require('../chunk-2O7D6F67.cjs');
+var chunkIKMR2ADM_cjs = require('../chunk-IKMR2ADM.cjs');
+var chunkYVPC65ZJ_cjs = require('../chunk-YVPC65ZJ.cjs');
 var chunk6HFFWEM3_cjs = require('../chunk-6HFFWEM3.cjs');
 var chunkNNEFAUHV_cjs = require('../chunk-NNEFAUHV.cjs');
 var chunkFHY3K6PL_cjs = require('../chunk-FHY3K6PL.cjs');
-var chunkIKMR2ADM_cjs = require('../chunk-IKMR2ADM.cjs');
 require('../chunk-SCV7C55E.cjs');
 
 
 
 Object.defineProperty(exports, "useCommandK", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useCommandK; }
+  get: function () { return chunkDKGUOMBC_cjs.useCommandK; }
 });
 Object.defineProperty(exports, "useIsDesktop", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useIsDesktop; }
+  get: function () { return chunkDKGUOMBC_cjs.useIsDesktop; }
 });
 Object.defineProperty(exports, "useIsLargeDesktop", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useIsLargeDesktop; }
+  get: function () { return chunkDKGUOMBC_cjs.useIsLargeDesktop; }
 });
 Object.defineProperty(exports, "useIsMobile", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useIsMobile; }
+  get: function () { return chunkDKGUOMBC_cjs.useIsMobile; }
 });
 Object.defineProperty(exports, "useIsMobileOrTablet", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useIsMobileOrTablet; }
+  get: function () { return chunkDKGUOMBC_cjs.useIsMobileOrTablet; }
 });
 Object.defineProperty(exports, "useIsSmallTablet", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useIsSmallTablet; }
+  get: function () { return chunkDKGUOMBC_cjs.useIsSmallTablet; }
 });
 Object.defineProperty(exports, "useIsTablet", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useIsTablet; }
+  get: function () { return chunkDKGUOMBC_cjs.useIsTablet; }
 });
 Object.defineProperty(exports, "useKeyboardShortcut", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useKeyboardShortcut; }
+  get: function () { return chunkDKGUOMBC_cjs.useKeyboardShortcut; }
 });
 Object.defineProperty(exports, "useMediaQuery", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useMediaQuery; }
+  get: function () { return chunkDKGUOMBC_cjs.useMediaQuery; }
 });
 Object.defineProperty(exports, "useScrollSpy", {
   enumerable: true,
-  get: function () { return chunkFSBFQBNE_cjs.useScrollSpy; }
+  get: function () { return chunkDKGUOMBC_cjs.useScrollSpy; }
 });
 Object.defineProperty(exports, "useTheme", {
   enumerable: true,
   get: function () { return chunk2O7D6F67_cjs.useTheme; }
 });
+Object.defineProperty(exports, "useClickOutside", {
+  enumerable: true,
+  get: function () { return chunkIKMR2ADM_cjs.useClickOutside; }
+});
+Object.defineProperty(exports, "dragIndicatorClasses", {
+  enumerable: true,
+  get: function () { return chunkYVPC65ZJ_cjs.dragIndicatorClasses; }
+});
+Object.defineProperty(exports, "reorderIds", {
+  enumerable: true,
+  get: function () { return chunkYVPC65ZJ_cjs.reorderIds; }
+});
+Object.defineProperty(exports, "useDragReorder", {
+  enumerable: true,
+  get: function () { return chunkYVPC65ZJ_cjs.useDragReorder; }
+});
+Object.defineProperty(exports, "useLiveAnnouncement", {
+  enumerable: true,
+  get: function () { return chunkYVPC65ZJ_cjs.useLiveAnnouncement; }
+});
 Object.defineProperty(exports, "usePrefersReducedMotion", {
   enumerable: true,
   get: function () { return chunk6HFFWEM3_cjs.usePrefersReducedMotion; }
@@ -66,9 +87,5 @@ Object.defineProperty(exports, "useEscapeKey", {
   enumerable: true,
   get: function () { return chunkFHY3K6PL_cjs.useEscapeKey; }
 });
-Object.defineProperty(exports, "useClickOutside", {
-  enumerable: true,
-  get: function () { return chunkIKMR2ADM_cjs.useClickOutside; }
-});
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/index.d.cts

@@ -1,4 +1,5 @@
 export { R as ResolvedTheme, T as Theme, u as useTheme } from '../useTheme-B9SWu6ui.cjs';
+import * as React from 'react';
 import { RefObject } from 'react';
 
 interface UseScrollSpyOptions {
@@ -212,4 +213,64 @@ declare function useIsLargeDesktop(): boolean;
 /** Returns true when viewport is smaller than 1024px (mobile/tablet) */
 declare function useIsMobileOrTablet(): boolean;
 
-export { type KeyboardShortcutOptions, type UseScrollSpyOptions, type UseScrollSpyReturn, useClickOutside, useCommandK, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, usePrefersReducedMotion, useScrollSpy };
+/** Insert `draggedId` before/after `targetId` in `ids`. */
+declare function reorderIds(ids: string[], draggedId: string, targetId: string, after: boolean): string[];
+interface UseDragReorderOptions {
+    /** Current flat order of item ids (props order) */
+    ids: string[];
+    /** Called with the full new id order after a drop. Omit to disable dragging. */
+    onReorder?: (ids: string[]) => void;
+    /** Restrict drops, e.g. to the same status group */
+    canDropOn?: (draggedId: string, targetId: string) => boolean;
+}
+interface DragOverState {
+    id: string;
+    /** Drop indicator position relative to the hovered row */
+    after: boolean;
+}
+interface UseDragReorderReturn {
+    /** Whether drag reordering is active (onReorder provided) */
+    enabled: boolean;
+    /** Id currently being dragged, if any */
+    draggingId: string | null;
+    /** Row currently hovered as a drop target */
+    over: DragOverState | null;
+    /** Spread onto each row element (must be keyed by a stable id) */
+    rowProps: (id: string) => React.HTMLAttributes<HTMLElement>;
+}
+/**
+ * HTML5 drag-and-drop list reordering. Rows spread `rowProps(id)`; on drop the
+ * hook computes the full new id order and reports it via `onReorder` — the
+ * consumer persists it (e.g. on the encounter/patient object) and feeds the
+ * list back in props order.
+ *
+ * Drag-and-drop is a pointer-only affordance: pair it with a keyboard
+ * alternative (e.g. move buttons / Alt+Arrow keys) for accessibility.
+ *
+ * @example
+ * ```tsx
+ * const drag = useDragReorder({ ids: items.map((i) => i.id), onReorder });
+ * // <li {...drag.rowProps(item.id)} className={cn(dragIndicatorClasses(drag, item.id))}>
+ * ```
+ */
+declare function useDragReorder({ ids, onReorder, canDropOn, }: UseDragReorderOptions): UseDragReorderReturn;
+/** Tailwind classes for the drag state of a row: drop indicator + dragging dim. */
+declare function dragIndicatorClasses(drag: Pick<UseDragReorderReturn, 'draggingId' | 'over'>, id: string): string;
+
+/**
+ * State for an `aria-live` region that re-announces even when the same
+ * message is emitted twice in a row. Setting identical React state bails out
+ * (and identical DOM text isn't a mutation), so screen readers would stay
+ * silent for repeated actions like "moved down" — this clears the region
+ * first, then sets the message a tick later.
+ *
+ * @example
+ * ```tsx
+ * const [announcement, announce] = useLiveAnnouncement();
+ * // announce('Item moved down');
+ * // <div aria-live="polite" className="sr-only">{announcement}</div>
+ * ```
+ */
+declare function useLiveAnnouncement(): [string, (message: string) => void];
+
+export { type DragOverState, type KeyboardShortcutOptions, type UseDragReorderOptions, type UseDragReorderReturn, type UseScrollSpyOptions, type UseScrollSpyReturn, dragIndicatorClasses, reorderIds, useClickOutside, useCommandK, useDragReorder, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useLiveAnnouncement, useMediaQuery, usePrefersReducedMotion, useScrollSpy };

package/dist/hooks/index.d.ts

@@ -1,4 +1,5 @@
 export { R as ResolvedTheme, T as Theme, u as useTheme } from '../useTheme-B9SWu6ui.js';
+import * as React from 'react';
 import { RefObject } from 'react';
 
 interface UseScrollSpyOptions {
@@ -212,4 +213,64 @@ declare function useIsLargeDesktop(): boolean;
 /** Returns true when viewport is smaller than 1024px (mobile/tablet) */
 declare function useIsMobileOrTablet(): boolean;
 
-export { type KeyboardShortcutOptions, type UseScrollSpyOptions, type UseScrollSpyReturn, useClickOutside, useCommandK, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, usePrefersReducedMotion, useScrollSpy };
+/** Insert `draggedId` before/after `targetId` in `ids`. */
+declare function reorderIds(ids: string[], draggedId: string, targetId: string, after: boolean): string[];
+interface UseDragReorderOptions {
+    /** Current flat order of item ids (props order) */
+    ids: string[];
+    /** Called with the full new id order after a drop. Omit to disable dragging. */
+    onReorder?: (ids: string[]) => void;
+    /** Restrict drops, e.g. to the same status group */
+    canDropOn?: (draggedId: string, targetId: string) => boolean;
+}
+interface DragOverState {
+    id: string;
+    /** Drop indicator position relative to the hovered row */
+    after: boolean;
+}
+interface UseDragReorderReturn {
+    /** Whether drag reordering is active (onReorder provided) */
+    enabled: boolean;
+    /** Id currently being dragged, if any */
+    draggingId: string | null;
+    /** Row currently hovered as a drop target */
+    over: DragOverState | null;
+    /** Spread onto each row element (must be keyed by a stable id) */
+    rowProps: (id: string) => React.HTMLAttributes<HTMLElement>;
+}
+/**
+ * HTML5 drag-and-drop list reordering. Rows spread `rowProps(id)`; on drop the
+ * hook computes the full new id order and reports it via `onReorder` — the
+ * consumer persists it (e.g. on the encounter/patient object) and feeds the
+ * list back in props order.
+ *
+ * Drag-and-drop is a pointer-only affordance: pair it with a keyboard
+ * alternative (e.g. move buttons / Alt+Arrow keys) for accessibility.
+ *
+ * @example
+ * ```tsx
+ * const drag = useDragReorder({ ids: items.map((i) => i.id), onReorder });
+ * // <li {...drag.rowProps(item.id)} className={cn(dragIndicatorClasses(drag, item.id))}>
+ * ```
+ */
+declare function useDragReorder({ ids, onReorder, canDropOn, }: UseDragReorderOptions): UseDragReorderReturn;
+/** Tailwind classes for the drag state of a row: drop indicator + dragging dim. */
+declare function dragIndicatorClasses(drag: Pick<UseDragReorderReturn, 'draggingId' | 'over'>, id: string): string;
+
+/**
+ * State for an `aria-live` region that re-announces even when the same
+ * message is emitted twice in a row. Setting identical React state bails out
+ * (and identical DOM text isn't a mutation), so screen readers would stay
+ * silent for repeated actions like "moved down" — this clears the region
+ * first, then sets the message a tick later.
+ *
+ * @example
+ * ```tsx
+ * const [announcement, announce] = useLiveAnnouncement();
+ * // announce('Item moved down');
+ * // <div aria-live="polite" className="sr-only">{announcement}</div>
+ * ```
+ */
+declare function useLiveAnnouncement(): [string, (message: string) => void];
+
+export { type DragOverState, type KeyboardShortcutOptions, type UseDragReorderOptions, type UseDragReorderReturn, type UseScrollSpyOptions, type UseScrollSpyReturn, dragIndicatorClasses, reorderIds, useClickOutside, useCommandK, useDragReorder, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useLiveAnnouncement, useMediaQuery, usePrefersReducedMotion, useScrollSpy };

package/dist/hooks/index.js

@@ -1,9 +1,10 @@
-export { useCommandK, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, useScrollSpy } from '../chunk-Q7NBJFEB.js';
+export { useCommandK, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, useScrollSpy } from '../chunk-UVQEHZRF.js';
 export { useTheme } from '../chunk-KJZNEVYM.js';
+export { useClickOutside } from '../chunk-OKBR6PX4.js';
+export { dragIndicatorClasses, reorderIds, useDragReorder, useLiveAnnouncement } from '../chunk-7ZVTLTJF.js';
 export { usePrefersReducedMotion } from '../chunk-HB7C7NB5.js';
 export { useFocusTrap } from '../chunk-4SMSH4OY.js';
 export { useEscapeKey } from '../chunk-T4ME7QCT.js';
-export { useClickOutside } from '../chunk-OKBR6PX4.js';
 import '../chunk-VSQF22GL.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map