@mieweb/ui 0.7.3-dev.15 → 0.7.3-dev.16

package/dist/components/CustomizableDashboard/index.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+var chunkPIQBB2JY_cjs = require('../../chunk-PIQBB2JY.cjs');
+require('../../chunk-S5RVSXDV.cjs');
+
+
+
+Object.defineProperty(exports, "CustomizableDashboard", {
+  enumerable: true,
+  get: function () { return chunkPIQBB2JY_cjs.CustomizableDashboard; }
+});
+Object.defineProperty(exports, "consolidateColumns", {
+  enumerable: true,
+  get: function () { return chunkPIQBB2JY_cjs.consolidateColumns; }
+});
+Object.defineProperty(exports, "mergeColumnOrder", {
+  enumerable: true,
+  get: function () { return chunkPIQBB2JY_cjs.mergeColumnOrder; }
+});
+Object.defineProperty(exports, "moveAcrossColumns", {
+  enumerable: true,
+  get: function () { return chunkPIQBB2JY_cjs.moveAcrossColumns; }
+});
+Object.defineProperty(exports, "reorderOnDrop", {
+  enumerable: true,
+  get: function () { return chunkPIQBB2JY_cjs.reorderOnDrop; }
+});
+Object.defineProperty(exports, "requiredColumns", {
+  enumerable: true,
+  get: function () { return chunkPIQBB2JY_cjs.requiredColumns; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/components/CustomizableDashboard/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/components/CustomizableDashboard/index.d.cts

@@ -0,0 +1,121 @@
+import * as React from 'react';
+
+/** A dashboard item: a stable id plus the rendered content. */
+interface PortletItem {
+    id: string;
+    node: React.ReactNode;
+}
+/** Number of visible columns. */
+type DashboardLayout = 1 | 2 | 3;
+/** Portlet items grouped into three logical columns. */
+type DashboardColumns = [PortletItem[], PortletItem[], PortletItem[]];
+/** Portlet ids grouped into three logical columns. */
+type DashboardOrder = [string[], string[], string[]];
+interface CustomizableDashboardProps {
+    /**
+     * Portlets grouped into three columns. This is the default arrangement;
+     * user reordering (persisted or controlled) takes precedence. Items later
+     * removed from props disappear from saved layouts automatically, and new
+     * items appear in their props column.
+     */
+    columns: DashboardColumns;
+    /** Toolbar heading rendered before the layout toggle. */
+    title?: string;
+    /**
+     * Base localStorage key used to persist column order and layout mode
+     * (`{storageKey}-portlet-order` / `{storageKey}-dashboard-layout`).
+     * Omit to disable built-in persistence (e.g. when using `order` /
+     * `onOrderChange` with a server-side store). Distinct dashboards must
+     * pass distinct keys.
+     */
+    storageKey?: string;
+    /** Accessible label for the dashboard grid region. */
+    ariaLabel?: string;
+    /**
+     * Optional DOM element to portal the toolbar (title + layout toggle)
+     * into, e.g. a page header actions row. When omitted, the toolbar
+     * renders inline above the grid.
+     */
+    toolbarSlot?: HTMLElement | null;
+    /** Initial column order for uncontrolled usage with external persistence. */
+    defaultOrder?: DashboardOrder;
+    /** Controlled column order. Changes are reported via `onOrderChange`. */
+    order?: DashboardOrder;
+    /** Called with the full new order after a drop or layout normalization. */
+    onOrderChange?: (order: DashboardOrder) => void;
+    /** Initial layout mode for uncontrolled usage (default 3). */
+    defaultLayout?: DashboardLayout;
+    /** Controlled layout mode. Changes are reported via `onLayoutChange`. */
+    layout?: DashboardLayout;
+    /** Called when the user changes the column layout (or it auto-shrinks). */
+    onLayoutChange?: (layout: DashboardLayout) => void;
+    /**
+     * CSS selector for the header element inside each portlet that receives
+     * the drag handle. Defaults to the `DashboardWidget` header slot. When no
+     * header matches, the handle floats over the portlet's top end corner.
+     */
+    dragHandleSelector?: string;
+    /** Additional class name for the grid element. */
+    className?: string;
+}
+/**
+ * Merge a saved/provided order with the current props columns: saved
+ * positions win, unknown saved ids are dropped, and new items are appended
+ * to their original props column.
+ */
+declare function mergeColumnOrder(columns: DashboardColumns, saved: DashboardOrder | null): DashboardOrder;
+/**
+ * Move `activeId` into the column named by `overId` (a column id or an item
+ * id), inserted before the hovered item. Returns the same reference when no
+ * cross-column move is needed.
+ */
+declare function moveAcrossColumns(order: DashboardOrder, activeId: string, overId: string): DashboardOrder;
+/**
+ * Final order for a drop. Same-column drags reorder around the hovered
+ * item. After a cross-column move, the one position `moveAcrossColumns`
+ * already chose — active sitting immediately before the hovered item — is
+ * kept (reordering would flip it to the other side of that item), but
+ * hovering any other item in the destination column still reorders, so a
+ * drag can keep moving after it crosses.
+ */
+declare function reorderOnDrop(order: DashboardOrder, activeId: string, overId: string, crossedColumns: boolean): DashboardOrder;
+/**
+ * Consolidate columns beyond the visible count into the last visible one.
+ * Returns the same reference when nothing needs to move so callers can use
+ * reference equality to skip persistence/notification.
+ */
+declare function consolidateColumns(order: DashboardOrder, mode: DashboardLayout): DashboardOrder;
+/**
+ * Columns needed to show every item: the highest occupied index + 1, so a
+ * gap like `[a], [], [c]` still requires three columns.
+ */
+declare function requiredColumns(order: DashboardOrder): DashboardLayout;
+/**
+ * A user-customizable portlet dashboard: a responsive 1–3 column grid whose
+ * items can be dragged between and within columns, with a column-layout
+ * toggle and optional persistence.
+ *
+ * Each portlet's drag handle is appended to the header element matched by
+ * `dragHandleSelector` inside its content — `DashboardWidget` headers are
+ * matched by default. Portlets without a matching header get a floating
+ * handle in their top end corner.
+ *
+ * Order and layout are persisted to localStorage when `storageKey` is set,
+ * or can be controlled via `order`/`onOrderChange` and
+ * `layout`/`onLayoutChange` for server-side persistence.
+ *
+ * @example
+ * ```tsx
+ * <CustomizableDashboard
+ *   storageKey="home"
+ *   columns={[
+ *     [{ id: 'stats', node: <StatsWidget /> }],
+ *     [{ id: 'tasks', node: <TasksWidget /> }],
+ *     [{ id: 'orders', node: <OrdersWidget /> }],
+ *   ]}
+ * />
+ * ```
+ */
+declare const CustomizableDashboard: React.ForwardRefExoticComponent<CustomizableDashboardProps & React.RefAttributes<HTMLDivElement>>;
+
+export { CustomizableDashboard, type CustomizableDashboardProps, type DashboardColumns, type DashboardLayout, type DashboardOrder, type PortletItem, consolidateColumns, mergeColumnOrder, moveAcrossColumns, reorderOnDrop, requiredColumns };

package/dist/components/CustomizableDashboard/index.d.ts

@@ -0,0 +1,121 @@
+import * as React from 'react';
+
+/** A dashboard item: a stable id plus the rendered content. */
+interface PortletItem {
+    id: string;
+    node: React.ReactNode;
+}
+/** Number of visible columns. */
+type DashboardLayout = 1 | 2 | 3;
+/** Portlet items grouped into three logical columns. */
+type DashboardColumns = [PortletItem[], PortletItem[], PortletItem[]];
+/** Portlet ids grouped into three logical columns. */
+type DashboardOrder = [string[], string[], string[]];
+interface CustomizableDashboardProps {
+    /**
+     * Portlets grouped into three columns. This is the default arrangement;
+     * user reordering (persisted or controlled) takes precedence. Items later
+     * removed from props disappear from saved layouts automatically, and new
+     * items appear in their props column.
+     */
+    columns: DashboardColumns;
+    /** Toolbar heading rendered before the layout toggle. */
+    title?: string;
+    /**
+     * Base localStorage key used to persist column order and layout mode
+     * (`{storageKey}-portlet-order` / `{storageKey}-dashboard-layout`).
+     * Omit to disable built-in persistence (e.g. when using `order` /
+     * `onOrderChange` with a server-side store). Distinct dashboards must
+     * pass distinct keys.
+     */
+    storageKey?: string;
+    /** Accessible label for the dashboard grid region. */
+    ariaLabel?: string;
+    /**
+     * Optional DOM element to portal the toolbar (title + layout toggle)
+     * into, e.g. a page header actions row. When omitted, the toolbar
+     * renders inline above the grid.
+     */
+    toolbarSlot?: HTMLElement | null;
+    /** Initial column order for uncontrolled usage with external persistence. */
+    defaultOrder?: DashboardOrder;
+    /** Controlled column order. Changes are reported via `onOrderChange`. */
+    order?: DashboardOrder;
+    /** Called with the full new order after a drop or layout normalization. */
+    onOrderChange?: (order: DashboardOrder) => void;
+    /** Initial layout mode for uncontrolled usage (default 3). */
+    defaultLayout?: DashboardLayout;
+    /** Controlled layout mode. Changes are reported via `onLayoutChange`. */
+    layout?: DashboardLayout;
+    /** Called when the user changes the column layout (or it auto-shrinks). */
+    onLayoutChange?: (layout: DashboardLayout) => void;
+    /**
+     * CSS selector for the header element inside each portlet that receives
+     * the drag handle. Defaults to the `DashboardWidget` header slot. When no
+     * header matches, the handle floats over the portlet's top end corner.
+     */
+    dragHandleSelector?: string;
+    /** Additional class name for the grid element. */
+    className?: string;
+}
+/**
+ * Merge a saved/provided order with the current props columns: saved
+ * positions win, unknown saved ids are dropped, and new items are appended
+ * to their original props column.
+ */
+declare function mergeColumnOrder(columns: DashboardColumns, saved: DashboardOrder | null): DashboardOrder;
+/**
+ * Move `activeId` into the column named by `overId` (a column id or an item
+ * id), inserted before the hovered item. Returns the same reference when no
+ * cross-column move is needed.
+ */
+declare function moveAcrossColumns(order: DashboardOrder, activeId: string, overId: string): DashboardOrder;
+/**
+ * Final order for a drop. Same-column drags reorder around the hovered
+ * item. After a cross-column move, the one position `moveAcrossColumns`
+ * already chose — active sitting immediately before the hovered item — is
+ * kept (reordering would flip it to the other side of that item), but
+ * hovering any other item in the destination column still reorders, so a
+ * drag can keep moving after it crosses.
+ */
+declare function reorderOnDrop(order: DashboardOrder, activeId: string, overId: string, crossedColumns: boolean): DashboardOrder;
+/**
+ * Consolidate columns beyond the visible count into the last visible one.
+ * Returns the same reference when nothing needs to move so callers can use
+ * reference equality to skip persistence/notification.
+ */
+declare function consolidateColumns(order: DashboardOrder, mode: DashboardLayout): DashboardOrder;
+/**
+ * Columns needed to show every item: the highest occupied index + 1, so a
+ * gap like `[a], [], [c]` still requires three columns.
+ */
+declare function requiredColumns(order: DashboardOrder): DashboardLayout;
+/**
+ * A user-customizable portlet dashboard: a responsive 1–3 column grid whose
+ * items can be dragged between and within columns, with a column-layout
+ * toggle and optional persistence.
+ *
+ * Each portlet's drag handle is appended to the header element matched by
+ * `dragHandleSelector` inside its content — `DashboardWidget` headers are
+ * matched by default. Portlets without a matching header get a floating
+ * handle in their top end corner.
+ *
+ * Order and layout are persisted to localStorage when `storageKey` is set,
+ * or can be controlled via `order`/`onOrderChange` and
+ * `layout`/`onLayoutChange` for server-side persistence.
+ *
+ * @example
+ * ```tsx
+ * <CustomizableDashboard
+ *   storageKey="home"
+ *   columns={[
+ *     [{ id: 'stats', node: <StatsWidget /> }],
+ *     [{ id: 'tasks', node: <TasksWidget /> }],
+ *     [{ id: 'orders', node: <OrdersWidget /> }],
+ *   ]}
+ * />
+ * ```
+ */
+declare const CustomizableDashboard: React.ForwardRefExoticComponent<CustomizableDashboardProps & React.RefAttributes<HTMLDivElement>>;
+
+export { CustomizableDashboard, type CustomizableDashboardProps, type DashboardColumns, type DashboardLayout, type DashboardOrder, type PortletItem, consolidateColumns, mergeColumnOrder, moveAcrossColumns, reorderOnDrop, requiredColumns };

package/dist/components/CustomizableDashboard/index.js

@@ -0,0 +1,4 @@
+export { CustomizableDashboard, consolidateColumns, mergeColumnOrder, moveAcrossColumns, reorderOnDrop, requiredColumns } from '../../chunk-K6CSD3S7.js';
+import '../../chunk-TQONQSJO.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/CustomizableDashboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/esheet.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunk35HHCXWC_cjs = require('./chunk-35HHCXWC.cjs');
-require('./chunk-BSDBI6H7.cjs');
+var chunkSETNPK4P_cjs = require('./chunk-SETNPK4P.cjs');
 require('./chunk-WWJIW2IH.cjs');
+require('./chunk-BSDBI6H7.cjs');
 require('./chunk-G7EQ3JPX.cjs');
+require('./chunk-U5TTXN45.cjs');
 require('./chunk-AIJAFPGJ.cjs');
 require('./chunk-56QJHQ5C.cjs');
 require('./chunk-MJWFNV3L.cjs');
-require('./chunk-U5TTXN45.cjs');
 require('./chunk-P2VTQ5AR.cjs');
 require('./chunk-I44YNYI6.cjs');
 require('./chunk-Z5S5JEJD.cjs');
@@ -78,7 +78,7 @@ function MedicationListField({
     return definition.medications ?? [];
   }, [response?.answer, definition.medications]);
   return /* @__PURE__ */ jsxRuntime.jsx(
-    chunk35HHCXWC_cjs.MedicationReconciliation,
+    chunkSETNPK4P_cjs.MedicationReconciliation,
     {
       medications,
       onChange: (next) => onResponse({ answer: JSON.stringify({ medications: next }) }),
@@ -135,7 +135,7 @@ function AllergyListField({
   codeLookup
 }) {
   const definition = field.definition;
-  const ambientCodeLookup = chunk35HHCXWC_cjs.useCodeLookupConfig();
+  const ambientCodeLookup = chunkSETNPK4P_cjs.useCodeLookupConfig();
   const effectiveCodeLookup = codeLookup === false ? void 0 : codeLookup ?? ambientCodeLookup ?? void 0;
   const value = React__namespace.useMemo(() => {
     if (response?.answer) return parseValue2(response.answer);
@@ -145,7 +145,7 @@ function AllergyListField({
     onResponse({ answer: JSON.stringify(next) });
   };
   return /* @__PURE__ */ jsxRuntime.jsx(
-    chunk35HHCXWC_cjs.AllergyManager,
+    chunkSETNPK4P_cjs.AllergyManager,
     {
       allergies: value.allergies,
       onChange: (allergies) => commit({

package/dist/esheet.js

@@ -1,11 +1,11 @@
-import { MedicationReconciliation, useCodeLookupConfig, AllergyManager } from './chunk-33TQ25IK.js';
-import './chunk-H3YO5GBM.js';
+import { MedicationReconciliation, useCodeLookupConfig, AllergyManager } from './chunk-2WLP2ERQ.js';
 import './chunk-FJ7YPVKV.js';
+import './chunk-H3YO5GBM.js';
 import './chunk-EPSB4WTL.js';
+import './chunk-IILJGFI5.js';
 import './chunk-I3WGZPI6.js';
 import './chunk-XBKOZRDO.js';
 import './chunk-QYSUYB3S.js';
-import './chunk-IILJGFI5.js';
 import './chunk-XMCIXHGH.js';
 import './chunk-6NZXWKUE.js';
 import './chunk-3IMM2PM4.js';