@mieweb/ui 0.10.0-dev.1 → 0.10.0-dev.11

package/dist/tailwind-preset.cjs

@@ -2,22 +2,22 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunkPY7XAG4D_cjs = require('./chunk-PY7XAG4D.cjs');
+var chunkASSDGS4F_cjs = require('./chunk-ASSDGS4F.cjs');
 require('./chunk-EUAMEVVI.cjs');
 
 
 
 Object.defineProperty(exports, "default", {
   enumerable: true,
-  get: function () { return chunkPY7XAG4D_cjs.tailwind_preset_default; }
+  get: function () { return chunkASSDGS4F_cjs.tailwind_preset_default; }
 });
 Object.defineProperty(exports, "miewebUIPreset", {
   enumerable: true,
-  get: function () { return chunkPY7XAG4D_cjs.miewebUIPreset; }
+  get: function () { return chunkASSDGS4F_cjs.miewebUIPreset; }
 });
 Object.defineProperty(exports, "miewebUISafelist", {
   enumerable: true,
-  get: function () { return chunkPY7XAG4D_cjs.miewebUISafelist; }
+  get: function () { return chunkASSDGS4F_cjs.miewebUISafelist; }
 });
 //# sourceMappingURL=tailwind-preset.cjs.map
 //# sourceMappingURL=tailwind-preset.cjs.map

package/dist/tailwind-preset.js

@@ -1,4 +1,4 @@
-export { tailwind_preset_default as default, miewebUIPreset, miewebUISafelist } from './chunk-X5YM3KXY.js';
+export { tailwind_preset_default as default, miewebUIPreset, miewebUISafelist } from './chunk-4A3W4TQF.js';
 import './chunk-PX6F3LHL.js';
 //# sourceMappingURL=tailwind-preset.js.map
 //# sourceMappingURL=tailwind-preset.js.map

package/dist/types-CbWXIKbe.d.cts

@@ -0,0 +1,119 @@
+import * as React from 'react';
+import { DateTime } from 'luxon';
+
+/**
+ * The contract every component in the `Modules/Views` family reads through.
+ *
+ * A page describes its collection once — which field is the id, the title, the
+ * status, the start date — and every view understands it. That is the whole
+ * reason the family exists: without it each view needs its own adapter and you
+ * end up re-implementing the same board per entity.
+ *
+ * Views are headless. Nothing here fetches, subscribes, or navigates.
+ * See CONTRIBUTING → "Modules: headless data components".
+ */
+
+/**
+ * Which layout is on screen. `overview` and `table` are rendered by the host
+ * through `ViewSet` slots rather than by a component in this family — a tabular
+ * collection is `DataVisNitroGrid`, and an overview is domain content.
+ */
+type ViewId = 'overview' | 'list' | 'board' | 'calendar' | 'gantt' | 'roadmap' | 'table';
+/**
+ * A semantic colour name, resolved to `--mieweb-*` tokens by each view.
+ *
+ * Accessors return one of these rather than a class string so a caller cannot
+ * hardcode a palette that breaks under another brand or in dark mode.
+ */
+type Accent = 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
+/** A named stage: a board column, and the segments of a stage bar. */
+interface Stage {
+    id: string;
+    label: string;
+    accent?: Accent;
+}
+/**
+ * How a view reads one item. Only `getId` and `getTitle` are always required;
+ * each view documents which of the rest it needs (a board needs `getStatus`, a
+ * Gantt needs `getStart`) and renders an explanatory empty state without them.
+ */
+interface ViewAccessors<T> {
+    getId: (item: T) => string;
+    getTitle: (item: T) => string;
+    /** Secondary line under the title. */
+    getSubtitle?: (item: T) => string | undefined;
+    /** Board column and list group; matched against `Stage['id']`. */
+    getStatus?: (item: T) => string;
+    /** Gantt bar start, calendar placement. */
+    getStart?: (item: T) => Date | string | null | undefined;
+    /** Gantt bar end, calendar span. Falls back to the start when absent. */
+    getEnd?: (item: T) => Date | string | null | undefined;
+    /** Swimlane in a roadmap, row group in a Gantt. */
+    getGroup?: (item: T) => string | undefined;
+    getAccent?: (item: T) => Accent;
+}
+/** Strings a view renders. Every one is overridable; the defaults are English. */
+interface ViewLabels {
+    /** Accessible name of the view switcher group. */
+    viewSwitcher: string;
+    loading: string;
+    empty: string;
+    error: string;
+    /** Action on the error state. */
+    retry: string;
+    /** Heading for the group a record with no status or group falls into. */
+    ungrouped: string;
+}
+declare const defaultViewLabels: ViewLabels;
+/**
+ * Props every view accepts. Views are controlled: selection, the active view and
+ * filter state live in the page, and every change is handed back.
+ */
+interface ViewBaseProps<T> {
+    items: T[];
+    accessors: ViewAccessors<T>;
+    loading?: boolean;
+    error?: Error | null;
+    selectedId?: string | null;
+    /** Called when the user activates an item. */
+    onOpen?: (id: string, item: T) => void;
+    /** Return a URL to render each item as a real anchor — middle-clickable and crawlable. */
+    getHref?: (id: string, item: T) => string;
+    /** Render one item. Receives the active view so one function can serve several. */
+    renderItem?: (item: T, context: {
+        view: ViewId;
+    }) => React.ReactNode;
+    /** Replaces the built-in empty state. */
+    emptyState?: React.ReactNode;
+    labels?: Partial<ViewLabels>;
+    /** Pins "today" so stories, tests and visual snapshots stay deterministic. */
+    now?: Date;
+    className?: string;
+}
+/**
+ * Reads an accessor's date in the view's zone.
+ *
+ * `DateTime.fromISO` is what makes this correct for both shapes an accessor may
+ * return. A date-only string is a wall date — `2026-03-10` means that calendar
+ * day where the collection lives, not UTC midnight, which is the 9th in the
+ * Americas — while a full timestamp is an instant and gets converted. Going via
+ * `new Date()` would collapse the first case into the second and shift the item
+ * onto the previous day in every zone behind UTC.
+ */
+declare function toDateTime(value: Date | string | null | undefined, zone: string): DateTime | null;
+/**
+ * Tailwind classes per accent, so every view tints the same way.
+ *
+ * There is deliberately no text colour here. `--mieweb-success` and friends are
+ * fill tokens: as ink on a surface — even their own 10% wash — they fail WCAG AA
+ * contrast, which axe catches as a serious violation. So an accent is carried by
+ * a wash, a border and a solid marker, and label text always uses a foreground
+ * token. That also means colour is never the only signal.
+ */
+declare const accentClasses: Record<Accent, {
+    tint: string;
+    border: string;
+    marker: string;
+}>;
+
+export { type Accent as A, type Stage as S, type ViewAccessors as V, type ViewBaseProps as a, type ViewId as b, type ViewLabels as c, accentClasses as d, defaultViewLabels as e, toDateTime as t };

package/dist/types-CbWXIKbe.d.ts

@@ -0,0 +1,119 @@
+import * as React from 'react';
+import { DateTime } from 'luxon';
+
+/**
+ * The contract every component in the `Modules/Views` family reads through.
+ *
+ * A page describes its collection once — which field is the id, the title, the
+ * status, the start date — and every view understands it. That is the whole
+ * reason the family exists: without it each view needs its own adapter and you
+ * end up re-implementing the same board per entity.
+ *
+ * Views are headless. Nothing here fetches, subscribes, or navigates.
+ * See CONTRIBUTING → "Modules: headless data components".
+ */
+
+/**
+ * Which layout is on screen. `overview` and `table` are rendered by the host
+ * through `ViewSet` slots rather than by a component in this family — a tabular
+ * collection is `DataVisNitroGrid`, and an overview is domain content.
+ */
+type ViewId = 'overview' | 'list' | 'board' | 'calendar' | 'gantt' | 'roadmap' | 'table';
+/**
+ * A semantic colour name, resolved to `--mieweb-*` tokens by each view.
+ *
+ * Accessors return one of these rather than a class string so a caller cannot
+ * hardcode a palette that breaks under another brand or in dark mode.
+ */
+type Accent = 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
+/** A named stage: a board column, and the segments of a stage bar. */
+interface Stage {
+    id: string;
+    label: string;
+    accent?: Accent;
+}
+/**
+ * How a view reads one item. Only `getId` and `getTitle` are always required;
+ * each view documents which of the rest it needs (a board needs `getStatus`, a
+ * Gantt needs `getStart`) and renders an explanatory empty state without them.
+ */
+interface ViewAccessors<T> {
+    getId: (item: T) => string;
+    getTitle: (item: T) => string;
+    /** Secondary line under the title. */
+    getSubtitle?: (item: T) => string | undefined;
+    /** Board column and list group; matched against `Stage['id']`. */
+    getStatus?: (item: T) => string;
+    /** Gantt bar start, calendar placement. */
+    getStart?: (item: T) => Date | string | null | undefined;
+    /** Gantt bar end, calendar span. Falls back to the start when absent. */
+    getEnd?: (item: T) => Date | string | null | undefined;
+    /** Swimlane in a roadmap, row group in a Gantt. */
+    getGroup?: (item: T) => string | undefined;
+    getAccent?: (item: T) => Accent;
+}
+/** Strings a view renders. Every one is overridable; the defaults are English. */
+interface ViewLabels {
+    /** Accessible name of the view switcher group. */
+    viewSwitcher: string;
+    loading: string;
+    empty: string;
+    error: string;
+    /** Action on the error state. */
+    retry: string;
+    /** Heading for the group a record with no status or group falls into. */
+    ungrouped: string;
+}
+declare const defaultViewLabels: ViewLabels;
+/**
+ * Props every view accepts. Views are controlled: selection, the active view and
+ * filter state live in the page, and every change is handed back.
+ */
+interface ViewBaseProps<T> {
+    items: T[];
+    accessors: ViewAccessors<T>;
+    loading?: boolean;
+    error?: Error | null;
+    selectedId?: string | null;
+    /** Called when the user activates an item. */
+    onOpen?: (id: string, item: T) => void;
+    /** Return a URL to render each item as a real anchor — middle-clickable and crawlable. */
+    getHref?: (id: string, item: T) => string;
+    /** Render one item. Receives the active view so one function can serve several. */
+    renderItem?: (item: T, context: {
+        view: ViewId;
+    }) => React.ReactNode;
+    /** Replaces the built-in empty state. */
+    emptyState?: React.ReactNode;
+    labels?: Partial<ViewLabels>;
+    /** Pins "today" so stories, tests and visual snapshots stay deterministic. */
+    now?: Date;
+    className?: string;
+}
+/**
+ * Reads an accessor's date in the view's zone.
+ *
+ * `DateTime.fromISO` is what makes this correct for both shapes an accessor may
+ * return. A date-only string is a wall date — `2026-03-10` means that calendar
+ * day where the collection lives, not UTC midnight, which is the 9th in the
+ * Americas — while a full timestamp is an instant and gets converted. Going via
+ * `new Date()` would collapse the first case into the second and shift the item
+ * onto the previous day in every zone behind UTC.
+ */
+declare function toDateTime(value: Date | string | null | undefined, zone: string): DateTime | null;
+/**
+ * Tailwind classes per accent, so every view tints the same way.
+ *
+ * There is deliberately no text colour here. `--mieweb-success` and friends are
+ * fill tokens: as ink on a surface — even their own 10% wash — they fail WCAG AA
+ * contrast, which axe catches as a serious violation. So an accent is carried by
+ * a wash, a border and a solid marker, and label text always uses a foreground
+ * token. That also means colour is never the only signal.
+ */
+declare const accentClasses: Record<Accent, {
+    tint: string;
+    border: string;
+    marker: string;
+}>;
+
+export { type Accent as A, type Stage as S, type ViewAccessors as V, type ViewBaseProps as a, type ViewId as b, type ViewLabels as c, accentClasses as d, defaultViewLabels as e, toDateTime as t };

package/dist/utils/index.cjs

@@ -4,8 +4,8 @@ require('../chunk-AT732HC6.cjs');
 var chunkC7RVKV25_cjs = require('../chunk-C7RVKV25.cjs');
 var chunkL7YQBSEL_cjs = require('../chunk-L7YQBSEL.cjs');
 var chunkCW75IKA6_cjs = require('../chunk-CW75IKA6.cjs');
-var chunkS5RVSXDV_cjs = require('../chunk-S5RVSXDV.cjs');
 var chunkSCV7C55E_cjs = require('../chunk-SCV7C55E.cjs');
+var chunkS5RVSXDV_cjs = require('../chunk-S5RVSXDV.cjs');
 require('../chunk-EUAMEVVI.cjs');
 
 
@@ -74,6 +74,10 @@ Object.defineProperty(exports, "parseDateValue", {
   enumerable: true,
   get: function () { return chunkCW75IKA6_cjs.parseDateValue; }
 });
+Object.defineProperty(exports, "isStorybookDocsMode", {
+  enumerable: true,
+  get: function () { return chunkSCV7C55E_cjs.isStorybookDocsMode; }
+});
 Object.defineProperty(exports, "cn", {
   enumerable: true,
   get: function () { return chunkS5RVSXDV_cjs.cn; }
@@ -82,9 +86,5 @@ Object.defineProperty(exports, "miewebUITwMergeConflicts", {
   enumerable: true,
   get: function () { return chunkS5RVSXDV_cjs.miewebUITwMergeConflicts; }
 });
-Object.defineProperty(exports, "isStorybookDocsMode", {
-  enumerable: true,
-  get: function () { return chunkSCV7C55E_cjs.isStorybookDocsMode; }
-});
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/utils/index.js

@@ -2,8 +2,8 @@ import '../chunk-7XUN3OQT.js';
 export { isHtmlEmpty, stripHtmlTags } from '../chunk-ERLPVXOV.js';
 export { formatPhoneNumber, isPhoneNumberEmpty, isValidPhoneNumber, unformatPhoneNumber } from '../chunk-ZVPJ2MH6.js';
 export { calculateAge, dateToDisplayFormat, displayFormatToDateString, formatDateValue, isDateEmpty, isDateInFuture, isDateInPast, isValidDate, isValidDrivingAge, parseDateValue } from '../chunk-RC2YMOMS.js';
-export { cn, miewebUITwMergeConflicts } from '../chunk-TQONQSJO.js';
 export { isStorybookDocsMode } from '../chunk-VSQF22GL.js';
+export { cn, miewebUITwMergeConflicts } from '../chunk-TQONQSJO.js';
 import '../chunk-PX6F3LHL.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mieweb/ui",
-  "version": "0.10.0-dev.1",
+  "version": "0.10.0-dev.11",
   "description": "A themeable, accessible React component library built with Tailwind CSS",
   "author": "Medical Informatics Engineering, Inc.",
   "license": "SEE LICENSE IN LICENSE",
@@ -141,6 +141,16 @@
         "default": "./dist/ag-grid.cjs"
       }
     },
+    "./globe": {
+      "import": {
+        "types": "./dist/globe.d.ts",
+        "default": "./dist/globe.js"
+      },
+      "require": {
+        "types": "./dist/globe.d.cts",
+        "default": "./dist/globe.cjs"
+      }
+    },
     "./datavis": {
       "import": {
         "types": "./dist/datavis.d.ts",
@@ -236,7 +246,7 @@
     "build:datavis": "node scripts/build-datavis.mjs",
     "build:css": "mkdir -p dist && npx @tailwindcss/cli -i ./src/styles/base.css -o ./dist/styles.css --minify",
     "copy:brand-css": "mkdir -p dist/brands && cp src/brands/*.css dist/brands/",
-    "copy:style-css": "mkdir -p dist/styles && cp src/styles/init.css dist/styles/ 2>/dev/null || true",
+    "copy:style-css": "mkdir -p dist/styles && cp src/styles/init.css src/styles/effects.css dist/styles/ 2>/dev/null || true",
     "copy:markdown-css": "mkdir -p dist/components/Markdown && cp src/components/Markdown/styles.css dist/components/Markdown/ 2>/dev/null || true",
     "copy:kerebron-css": "mkdir -p dist && cp src/styles/kerebron.css dist/kerebron.css",
     "typecheck": "tsc --noEmit",
@@ -266,6 +276,7 @@
   "peerDependencies": {
     "@kerebron/editor": ">=0.8.6",
     "@kerebron/editor-kits": ">=0.8.6",
+    "@kerebron/extension-basic-editor": ">=0.8.6",
     "@kerebron/extension-yjs": ">=0.8.6",
     "@kerebron/wasm": ">=0.8.6",
     "@mieweb/q": "1.0.0",
@@ -278,17 +289,25 @@
     "papaparse": ">=5.0.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
+    "react-globe.gl": ">=2.30.0",
     "react-markdown": ">=9.0.0",
     "rehype-highlight": ">=7.0.0",
     "rehype-katex": ">=7.0.0",
     "rehype-sanitize": ">=6.0.0",
     "remark-gfm": ">=4.0.0",
     "remark-math": ">=6.0.0",
+    "three": ">=0.160.0",
     "wavesurfer.js": ">=7.0.0",
     "y-protocols": ">=1.0.6",
     "yjs": ">=13.6.0"
   },
   "peerDependenciesMeta": {
+    "react-globe.gl": {
+      "optional": true
+    },
+    "three": {
+      "optional": true
+    },
     "motion": {
       "optional": true
     },
@@ -298,6 +317,9 @@
     "@kerebron/editor-kits": {
       "optional": true
     },
+    "@kerebron/extension-basic-editor": {
+      "optional": true
+    },
     "@kerebron/extension-yjs": {
       "optional": true
     },
@@ -391,6 +413,7 @@
     "@eslint/js": "^9.39.3",
     "@kerebron/editor": "^0.8.6",
     "@kerebron/editor-kits": "^0.8.6",
+    "@kerebron/extension-basic-editor": "^0.8.6",
     "@kerebron/extension-yjs": "^0.8.6",
     "@kerebron/wasm": "^0.8.6",
     "@mieweb/datavis": "link:./packages/datavis",
@@ -415,6 +438,7 @@
     "@types/papaparse": "^5.3.16",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
+    "@types/three": "^0.185.4",
     "@typescript-eslint/eslint-plugin": "^8.56.1",
     "@typescript-eslint/parser": "^8.56.1",
     "@vitest/coverage-v8": "^3.2.6",
@@ -451,6 +475,7 @@
     "prettier-plugin-tailwindcss": "^0.6.14",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
+    "react-globe.gl": "^2.38.0",
     "react-markdown": "^10.1.0",
     "rehype-highlight": "^7.0.2",
     "rehype-katex": "^7.0.1",
@@ -461,6 +486,7 @@
     "sortablejs": "^1.15.7",
     "storybook": "^10.2.11",
     "tailwindcss": "^4.2.1",
+    "three": "^0.185.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vite": "^7.3.2",

package/dist/CsvBlock-CVYA3HYS.cjs

@@ -1,16 +0,0 @@
-'use strict';
-
-var chunkAHINB2TP_cjs = require('./chunk-AHINB2TP.cjs');
-require('./chunk-6QKMMKRY.cjs');
-require('./chunk-IINZWUGK.cjs');
-require('./chunk-S5RVSXDV.cjs');
-require('./chunk-EUAMEVVI.cjs');
-
-
-
-Object.defineProperty(exports, "CsvBlock", {
-  enumerable: true,
-  get: function () { return chunkAHINB2TP_cjs.CsvBlock; }
-});
-//# sourceMappingURL=CsvBlock-CVYA3HYS.cjs.map
-//# sourceMappingURL=CsvBlock-CVYA3HYS.cjs.map

package/dist/CsvBlock-SM4NKSHA.js

@@ -1,7 +0,0 @@
-export { CsvBlock } from './chunk-NHN6A3ZO.js';
-import './chunk-CK3KLRNF.js';
-import './chunk-KREUYVMZ.js';
-import './chunk-TQONQSJO.js';
-import './chunk-PX6F3LHL.js';
-//# sourceMappingURL=CsvBlock-SM4NKSHA.js.map
-//# sourceMappingURL=CsvBlock-SM4NKSHA.js.map

package/dist/HtmlPreviewBlock-FAMF4W24.js

@@ -1,7 +0,0 @@
-export { HtmlPreviewBlock } from './chunk-EG7XFZ3W.js';
-import './chunk-CK3KLRNF.js';
-import './chunk-KREUYVMZ.js';
-import './chunk-TQONQSJO.js';
-import './chunk-PX6F3LHL.js';
-//# sourceMappingURL=HtmlPreviewBlock-FAMF4W24.js.map
-//# sourceMappingURL=HtmlPreviewBlock-FAMF4W24.js.map

package/dist/HtmlPreviewBlock-JF454L2L.cjs

@@ -1,16 +0,0 @@
-'use strict';
-
-var chunkIB54SKWB_cjs = require('./chunk-IB54SKWB.cjs');
-require('./chunk-6QKMMKRY.cjs');
-require('./chunk-IINZWUGK.cjs');
-require('./chunk-S5RVSXDV.cjs');
-require('./chunk-EUAMEVVI.cjs');
-
-
-
-Object.defineProperty(exports, "HtmlPreviewBlock", {
-  enumerable: true,
-  get: function () { return chunkIB54SKWB_cjs.HtmlPreviewBlock; }
-});
-//# sourceMappingURL=HtmlPreviewBlock-JF454L2L.cjs.map
-//# sourceMappingURL=HtmlPreviewBlock-JF454L2L.cjs.map

package/dist/MermaidBlock-7V5G4K5A.js

@@ -1,7 +0,0 @@
-export { MermaidBlock } from './chunk-ZB54MTMQ.js';
-import './chunk-CK3KLRNF.js';
-import './chunk-KREUYVMZ.js';
-import './chunk-TQONQSJO.js';
-import './chunk-PX6F3LHL.js';
-//# sourceMappingURL=MermaidBlock-7V5G4K5A.js.map
-//# sourceMappingURL=MermaidBlock-7V5G4K5A.js.map

package/dist/MermaidBlock-FR5SQX4Q.cjs

@@ -1,16 +0,0 @@
-'use strict';
-
-var chunkRSCA5AZW_cjs = require('./chunk-RSCA5AZW.cjs');
-require('./chunk-6QKMMKRY.cjs');
-require('./chunk-IINZWUGK.cjs');
-require('./chunk-S5RVSXDV.cjs');
-require('./chunk-EUAMEVVI.cjs');
-
-
-
-Object.defineProperty(exports, "MermaidBlock", {
-  enumerable: true,
-  get: function () { return chunkRSCA5AZW_cjs.MermaidBlock; }
-});
-//# sourceMappingURL=MermaidBlock-FR5SQX4Q.cjs.map
-//# sourceMappingURL=MermaidBlock-FR5SQX4Q.cjs.map

package/dist/SurveyBlock-6K2POV7S.js

@@ -1,7 +0,0 @@
-export { SurveyBlock } from './chunk-OSPTA4UR.js';
-import './chunk-CK3KLRNF.js';
-import './chunk-KREUYVMZ.js';
-import './chunk-TQONQSJO.js';
-import './chunk-PX6F3LHL.js';
-//# sourceMappingURL=SurveyBlock-6K2POV7S.js.map
-//# sourceMappingURL=SurveyBlock-6K2POV7S.js.map

package/dist/SurveyBlock-MCJVWR7H.cjs

@@ -1,16 +0,0 @@
-'use strict';
-
-var chunk5Z6UPVGC_cjs = require('./chunk-5Z6UPVGC.cjs');
-require('./chunk-6QKMMKRY.cjs');
-require('./chunk-IINZWUGK.cjs');
-require('./chunk-S5RVSXDV.cjs');
-require('./chunk-EUAMEVVI.cjs');
-
-
-
-Object.defineProperty(exports, "SurveyBlock", {
-  enumerable: true,
-  get: function () { return chunk5Z6UPVGC_cjs.SurveyBlock; }
-});
-//# sourceMappingURL=SurveyBlock-MCJVWR7H.cjs.map
-//# sourceMappingURL=SurveyBlock-MCJVWR7H.cjs.map