@mieweb/ui 0.10.0-dev.3 → 0.10.0-dev.31

package/dist/types-DsdZvEI1.d.ts

@@ -0,0 +1,92 @@
+import * as React from 'react';
+
+/**
+ * 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;
+}
+/**
+ * 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;
+}
+
+export type { Stage as S, ViewLabels as V, ViewBaseProps as a };

package/dist/utils/index.d.cts

@@ -1,5 +1,4 @@
 import { ClassValue } from 'clsx';
-export { i as isHtmlEmpty, s as stripHtmlTags } from '../html-MdxqSzjD.cjs';
 
 declare const miewebUITwMergeConflicts: Record<string, string[]>;
 /**
@@ -18,6 +17,18 @@ declare const miewebUITwMergeConflicts: Record<string, string[]>;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
+/**
+ * Extracts visible text from an HTML string without using regex.
+ * Uses a simple character-by-character state machine to skip tags.
+ * This avoids CodeQL false-positives associated with regex-based tag stripping.
+ */
+declare function stripHtmlTags(html: string): string;
+/**
+ * Returns true when an HTML string has no visible text content.
+ * This is a visibility check, not a sanitizer — do NOT use for XSS prevention.
+ */
+declare function isHtmlEmpty(html: string): boolean;
+
 /**
  * Phone number formatting utilities
  */
@@ -106,4 +117,4 @@ declare function displayFormatToDateString(value: string): string;
  */
 declare function isStorybookDocsMode(): boolean;
 
-export { calculateAge, cn, dateToDisplayFormat, displayFormatToDateString, formatDateValue, formatPhoneNumber, isDateEmpty, isDateInFuture, isDateInPast, isPhoneNumberEmpty, isStorybookDocsMode, isValidDate, isValidDrivingAge, isValidPhoneNumber, miewebUITwMergeConflicts, parseDateValue, unformatPhoneNumber };
+export { calculateAge, cn, dateToDisplayFormat, displayFormatToDateString, formatDateValue, formatPhoneNumber, isDateEmpty, isDateInFuture, isDateInPast, isHtmlEmpty, isPhoneNumberEmpty, isStorybookDocsMode, isValidDate, isValidDrivingAge, isValidPhoneNumber, miewebUITwMergeConflicts, parseDateValue, stripHtmlTags, unformatPhoneNumber };

package/dist/utils/index.d.ts

@@ -1,5 +1,4 @@
 import { ClassValue } from 'clsx';
-export { i as isHtmlEmpty, s as stripHtmlTags } from '../html-MdxqSzjD.js';
 
 declare const miewebUITwMergeConflicts: Record<string, string[]>;
 /**
@@ -18,6 +17,18 @@ declare const miewebUITwMergeConflicts: Record<string, string[]>;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
+/**
+ * Extracts visible text from an HTML string without using regex.
+ * Uses a simple character-by-character state machine to skip tags.
+ * This avoids CodeQL false-positives associated with regex-based tag stripping.
+ */
+declare function stripHtmlTags(html: string): string;
+/**
+ * Returns true when an HTML string has no visible text content.
+ * This is a visibility check, not a sanitizer — do NOT use for XSS prevention.
+ */
+declare function isHtmlEmpty(html: string): boolean;
+
 /**
  * Phone number formatting utilities
  */
@@ -106,4 +117,4 @@ declare function displayFormatToDateString(value: string): string;
  */
 declare function isStorybookDocsMode(): boolean;
 
-export { calculateAge, cn, dateToDisplayFormat, displayFormatToDateString, formatDateValue, formatPhoneNumber, isDateEmpty, isDateInFuture, isDateInPast, isPhoneNumberEmpty, isStorybookDocsMode, isValidDate, isValidDrivingAge, isValidPhoneNumber, miewebUITwMergeConflicts, parseDateValue, unformatPhoneNumber };
+export { calculateAge, cn, dateToDisplayFormat, displayFormatToDateString, formatDateValue, formatPhoneNumber, isDateEmpty, isDateInFuture, isDateInPast, isHtmlEmpty, isPhoneNumberEmpty, isStorybookDocsMode, isValidDate, isValidDrivingAge, isValidPhoneNumber, miewebUITwMergeConflicts, parseDateValue, stripHtmlTags, unformatPhoneNumber };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mieweb/ui",
-  "version": "0.10.0-dev.3",
+  "version": "0.10.0-dev.31",
   "description": "A themeable, accessible React component library built with Tailwind CSS",
   "author": "Medical Informatics Engineering, Inc.",
   "license": "SEE LICENSE IN LICENSE",
@@ -151,6 +151,36 @@
         "default": "./dist/globe.cjs"
       }
     },
+    "./deck": {
+      "import": {
+        "types": "./dist/deck.d.ts",
+        "default": "./dist/deck.js"
+      },
+      "require": {
+        "types": "./dist/deck.d.cts",
+        "default": "./dist/deck.cjs"
+      }
+    },
+    "./maps": {
+      "import": {
+        "types": "./dist/maps.d.ts",
+        "default": "./dist/maps.js"
+      },
+      "require": {
+        "types": "./dist/maps.d.cts",
+        "default": "./dist/maps.cjs"
+      }
+    },
+    "./templates": {
+      "import": {
+        "types": "./dist/templates.d.ts",
+        "default": "./dist/templates.js"
+      },
+      "require": {
+        "types": "./dist/templates.d.cts",
+        "default": "./dist/templates.cjs"
+      }
+    },
     "./datavis": {
       "import": {
         "types": "./dist/datavis.d.ts",
@@ -241,7 +271,8 @@
     "prepare": "npm run build:datavis && npm run build:css && npm run copy:brand-css && npm run copy:style-css && npm run copy:markdown-css && npm run copy:kerebron-css",
     "dev": "tsup --watch",
     "prebuild": "npm run build:esheet && npm run build:datavis",
-    "build": "node --max-old-space-size=8192 ./node_modules/tsup/dist/cli-default.js && npm run build:css && npm run copy:brand-css && npm run copy:style-css && npm run copy:markdown-css && npm run copy:kerebron-css",
+    "build": "node --max-old-space-size=8192 ./node_modules/tsup/dist/cli-default.js && npm run build:dts && npm run build:css && npm run copy:brand-css && npm run copy:style-css && npm run copy:markdown-css && npm run copy:kerebron-css",
+    "build:dts": "node scripts/build-dts.mjs",
     "build:esheet": "if [ ! -f packages/esheet/packages/core/dist/index.d.ts ] || [ ! -f packages/esheet/packages/renderer/src/index.output.css ] || [ ! -f packages/esheet/packages/builder/src/index.output.css ]; then cd packages/esheet && pnpm install --frozen-lockfile && pnpm --filter '@esheet/builder...' --filter '@esheet/renderer...' build; fi",
     "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",
@@ -249,10 +280,11 @@
     "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",
+    "typecheck": "tsc --noEmit && tsc -p .storybook/tsconfig.mobile.json",
     "lint": "eslint \"src/**/*.{ts,tsx}\"",
     "lint:fix": "eslint \"src/**/*.{ts,tsx}\" --fix",
     "rtl:scan": "node scripts/rtl-scan.mjs",
+    "check:templates-rsc": "node --conditions=react-server scripts/check-templates-rsc.mjs",
     "rtl:scan:update": "node scripts/rtl-scan.mjs --update",
     "condensed:scan": "node scripts/condensed-scan.mjs",
     "catalog:check": "node scripts/catalog-check.mjs",
@@ -263,26 +295,33 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "prestorybook": "npm run build:esheet && npm run build:datavis",
-    "storybook": "storybook dev -p 6006",
-    "build-storybook": "npm run build:esheet && npm run build:datavis && storybook build && npm run catalog:manifest",
+    "storybook": "node scripts/build-ozwell-docs.mjs && storybook dev -p 6006",
+    "build-storybook": "npm run build:esheet && npm run build:datavis && node scripts/build-ozwell-docs.mjs && storybook build && npm run catalog:manifest",
     "test:coverage": "vitest run --coverage",
     "playwright:install": "playwright install --with-deps",
     "test:visual": "playwright test",
     "test:visual:ui": "playwright test --ui",
     "test:visual:debug": "playwright test --debug",
+    "mobile:install": "npm ci --prefix tests/mobile",
+    "mobile:doctor": "npm --prefix tests/mobile run doctor",
+    "mobile:server": "npm --prefix tests/mobile run appium",
+    "test:mobile": "npm --prefix tests/mobile test",
+    "test:mobile:device": "IOS_REAL_DEVICE=1 npm --prefix tests/mobile test",
     "test:storybook": "test-storybook --url http://localhost:6006 --maxWorkers 2 --testTimeout 30000",
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
-    "@kerebron/editor": ">=0.8.6",
-    "@kerebron/editor-kits": ">=0.8.6",
-    "@kerebron/extension-yjs": ">=0.8.6",
-    "@kerebron/wasm": ">=0.8.6",
+    "@kerebron/editor": ">=0.8.12",
+    "@kerebron/editor-kits": ">=0.8.12",
+    "@kerebron/extension-basic-editor": ">=0.8.12",
+    "@kerebron/extension-yjs": ">=0.8.12",
+    "@kerebron/wasm": ">=0.8.12",
     "@mieweb/q": "1.0.0",
     "ag-grid-community": ">=32.0.0",
     "ag-grid-react": ">=32.0.0",
     "js-yaml": ">=4.0.0",
     "katex": ">=0.16.0",
+    "leaflet": ">=1.9.0",
     "mermaid": ">=11.0.0",
     "motion": ">=12.0.0",
     "papaparse": ">=5.0.0",
@@ -301,6 +340,9 @@
     "yjs": ">=13.6.0"
   },
   "peerDependenciesMeta": {
+    "leaflet": {
+      "optional": true
+    },
     "react-globe.gl": {
       "optional": true
     },
@@ -316,6 +358,9 @@
     "@kerebron/editor-kits": {
       "optional": true
     },
+    "@kerebron/extension-basic-editor": {
+      "optional": true
+    },
     "@kerebron/extension-yjs": {
       "optional": true
     },
@@ -407,10 +452,11 @@
     "@esheet/fields": "0.0.5",
     "@esheet/renderer": "0.0.5",
     "@eslint/js": "^9.39.3",
-    "@kerebron/editor": "^0.8.6",
-    "@kerebron/editor-kits": "^0.8.6",
-    "@kerebron/extension-yjs": "^0.8.6",
-    "@kerebron/wasm": "^0.8.6",
+    "@kerebron/editor": "^0.8.12",
+    "@kerebron/editor-kits": "^0.8.12",
+    "@kerebron/extension-basic-editor": "^0.8.12",
+    "@kerebron/extension-yjs": "^0.8.12",
+    "@kerebron/wasm": "^0.8.12",
     "@mieweb/datavis": "link:./packages/datavis",
     "@mieweb/q": "1.0.0",
     "@monaco-editor/react": "^4.7.0",
@@ -418,6 +464,7 @@
     "@storybook/addon-a11y": "^10.2.11",
     "@storybook/addon-docs": "^10.2.11",
     "@storybook/addon-links": "^10.2.11",
+    "@storybook/icons": "2.0.1",
     "@storybook/react": "^10.2.11",
     "@storybook/react-vite": "^10.2.11",
     "@storybook/test-runner": "0.24.3",
@@ -428,6 +475,7 @@
     "@testing-library/user-event": "^14.6.1",
     "@types/google-libphonenumber": "^7.4.30",
     "@types/js-yaml": "^4.0.9",
+    "@types/leaflet": "^1.9.22",
     "@types/luxon": "^3.7.1",
     "@types/node": "^22.19.11",
     "@types/papaparse": "^5.3.16",
@@ -462,6 +510,7 @@
     "js-yaml": "^4.1.1",
     "jsdom": "^26.1.0",
     "katex": "^0.17.0",
+    "leaflet": "^1.9.4",
     "mermaid": "^11.15.0",
     "motion": "^12.34.2",
     "papaparse": "^5.5.3",

package/dist/Animated-XmH6k8pZ.d.cts

@@ -1,188 +0,0 @@
-import * as React from 'react';
-
-/**
- * Motion presets — the shared vocabulary of animations.
- *
- * This module is intentionally **free of any `motion` import**. It ships in the
- * main `@mieweb/ui` entry so components can describe *what* they animate
- * without pulling in a runtime to actually do it. The `@mieweb/ui/motion` entry
- * is what turns these descriptions into real animations.
- *
- * Every preset is expressed as an open/closed variant pair so the same
- * definition serves both usages:
- *
- * - **toggle** — the element stays mounted and animates between `open` and
- *   `closed` (a drawer sliding in and out).
- * - **presence** — the element mounts and unmounts, entering on `open` and
- *   exiting back to `closed` (a modal).
- */
-/** Named animation recipes shared by components. */
-type MotionPreset = 'drawerStart' | 'overlay' | 'modalContent' | 'sidebarLabel' | 'menu' | 'collapse' | 'toast' | 'fade' | 'pop';
-/**
- * A physical edge, already resolved from any logical (`start`/`end`) position
- * and from writing direction.
- *
- * Presets that move an element along an axis take one of these as `custom`.
- * Resolution is the component's job, not the preset's: only the component knows
- * whether its `end` means right or left, and — for anything anchored — which
- * side it actually landed on after flipping away from a viewport edge.
- */
-type MotionEdge = 'top' | 'bottom' | 'left' | 'right';
-/**
- * A variant value. Either a plain target object or a function of the element's
- * `custom` value — the latter lets a single preset adapt to context, e.g. a
- * drawer flipping its off-canvas direction in RTL.
- */
-type MotionVariant = Record<string, unknown> | ((custom: unknown) => Record<string, unknown>);
-interface MotionPresetDefinition {
-    variants: {
-        open: MotionVariant;
-        closed: MotionVariant;
-    };
-    transition: Record<string, unknown>;
-}
-/**
- * `custom` contract per preset:
- *
- * - `drawerStart` — `boolean`, whether the document direction is RTL.
- * - `menu`, `toast` — a {@link MotionEdge}, already resolved from logical
- *   position and writing direction by the component.
- * - `overlay`, `modalContent`, `sidebarLabel`, `collapse`, `fade`, `pop` —
- *   unused.
- */
-declare const motionPresets: Record<MotionPreset, MotionPresetDefinition>;
-
-/**
- * Motion runtime — the seam between components and an optional animation library.
- *
- * Components in the main entry never import `motion`. They ask this module for
- * a runtime; if an app has opted in by rendering `<MotionProvider>` from
- * `@mieweb/ui/motion`, they get one and animate. If not, `useMotionRuntime()`
- * returns `null` and they fall back to their existing CSS transitions. That is
- * what keeps `motion` out of the bundle of every app that hasn't asked for it —
- * the opt-in is resolved in the *module graph*, not by a prop.
- *
- * Like `presets`, this module must stay free of any `motion` import.
- */
-
-interface MotionPresenceProps {
-    children?: React.ReactNode;
-    /** Suppress the initial mount animation. */
-    initial?: boolean;
-    /**
-     * Fires once every exiting child has finished and been removed.
-     *
-     * Needed by anything that guards the DOM while it is open — a focus trap, a
-     * scroll lock — because those guards must outlive `open` for as long as the
-     * subtree is still on screen. Never fires when no runtime is active, since
-     * there is no exit to wait for.
-     */
-    onExitComplete?: () => void;
-}
-/**
- * The capabilities a motion library must supply. Deliberately small: element
- * factories, a presence wrapper, and prop builders. Components depend on this
- * interface, never on a concrete library, so swapping or dropping the library
- * stays a one-file change.
- */
-interface MotionRuntime {
-    /**
-     * Whether animations should actually run.
-     *
-     * A disabled provider still supplies a runtime rather than `null` so that
-     * consumers can tell "disabled" apart from "never opted in": `Modal` uses it
-     * to decide whether an exit animation will ever report completion, and
-     * `AnimatedPresence` keeps its wrapper element stable across the flip.
-     * `Animated` itself renders the plain fallback tag whenever this is false —
-     * withholding animation props from a mounted motion component corrupts
-     * `toggle`-mode elements, so the swap (and the remount it implies) is the
-     * correct behaviour. See the render branches in `Animated`.
-     */
-    enabled: boolean;
-    /** Animated `div`. */
-    Div: React.ElementType;
-    /** Animated `nav`. */
-    Nav: React.ElementType;
-    /** Animated `span`, for inline content that must not become a block. */
-    Span: React.ElementType;
-    /** Enables exit animations for conditionally rendered children. */
-    Presence: React.ComponentType<MotionPresenceProps>;
-    /**
-     * Props for an element that stays mounted and animates between states.
-     * Skips the initial animation so a closed drawer doesn't slide out on load.
-     */
-    toggle: (preset: MotionPreset, open: boolean, custom?: unknown) => Record<string, unknown>;
-    /** Props for an element that mounts and unmounts inside `Presence`. */
-    presence: (preset: MotionPreset, custom?: unknown) => Record<string, unknown>;
-}
-/**
- * The active motion runtime, or `null` when the app has not opted in.
- *
- * Components must treat `null` as the normal case and keep a CSS path that
- * looks good on its own — motion is an enhancement, never a requirement.
- */
-declare function useMotionRuntime(): MotionRuntime | null;
-
-/**
- * `Animated` / `AnimatedPresence` — the ergonomic layer components use.
- *
- * These exist so an individual component never has to branch on whether motion
- * is available. It declares the preset it wants and the CSS classes that stand
- * in when motion is absent; this module picks the element to render.
- *
- * Adding motion to a further component should be a matter of swapping its
- * root `<div>` for an `<Animated>` and naming a preset — no new imports, no
- * new dependency, and no behavior change for apps that have not opted in.
- */
-
-interface AnimatedProps extends React.HTMLAttributes<HTMLElement> {
-    /** Intrinsic element to render. */
-    as?: 'div' | 'nav' | 'span';
-    /** Which shared animation recipe to use. */
-    preset: MotionPreset;
-    /**
-     * - `toggle` — element stays mounted and animates between open and closed.
-     * - `presence` — element mounts and unmounts; wrap it in `<AnimatedPresence>`
-     *   so the exit animation gets a chance to run.
-     */
-    mode: 'toggle' | 'presence';
-    /** Current state. Only read in `toggle` mode. */
-    open?: boolean;
-    /** Per-preset context value — see the `custom` contract in `presets.ts`. */
-    custom?: unknown;
-    /**
-     * Classes applied whenever this element is **not** animating — no provider,
-     * a disabled provider, or `enabled={false}`. This is where a component's
-     * existing CSS transition lives, so the two paths never both try to drive
-     * the same property.
-     */
-    fallbackClassName?: string;
-    /**
-     * Set `false` to stop this element animating even when a runtime is active.
-     *
-     * For states where an animated element would be wrong rather than merely
-     * unnecessary. Motion writes a `transform` to hold an element at its resting
-     * position, and a transformed ancestor becomes the containing block for any
-     * `position: fixed` descendant — so an element that is only sometimes
-     * animated should opt out the rest of the time.
-     *
-     * Flipping this (or the provider's `disabled`) swaps the element back to a
-     * plain tag, which **remounts** it — deliberately. See the note on the
-     * render branches below.
-     */
-    enabled?: boolean;
-}
-declare const Animated: React.ForwardRefExoticComponent<AnimatedProps & React.RefAttributes<HTMLElement>>;
-/**
- * Keeps unmounting children on screen long enough to animate out.
- *
- * Without a runtime this is a pass-through, so children disappear immediately —
- * which is exactly what they do today. Children rendered conditionally inside
- * it need a stable `key`.
- */
-declare function AnimatedPresence({ children, initial, onExitComplete, }: MotionPresenceProps): React.JSX.Element;
-declare namespace AnimatedPresence {
-    var displayName: string;
-}
-
-export { Animated as A, type MotionEdge as M, AnimatedPresence as a, type AnimatedProps as b, type MotionPreset as c, type MotionRuntime as d, type MotionPresenceProps as e, type MotionPresetDefinition as f, type MotionVariant as g, motionPresets as m, useMotionRuntime as u };