@mieweb/ui 0.10.0-dev.10 → 0.10.0-dev.12

package/dist/{types-gZXrfLj6.d.ts → types-DOxdTwmq.d.ts}

@@ -1,5 +1,173 @@
 import * as React from 'react';
-import { A as AIMessageContent, a as AIMessageStatus } from './types-CnPEwzlp.js';
+
+/**
+ * AI Component Types
+ *
+ * Type definitions for AI-related components including MCP (Model Context Protocol)
+ * interactions, tool calls, and chat messages.
+ */
+
+/**
+ * Status of an MCP tool invocation
+ */
+type MCPToolStatus = 'pending' | 'running' | 'success' | 'error' | 'cancelled';
+/**
+ * MCP Tool parameter definition
+ */
+interface MCPToolParameter {
+    name: string;
+    type: string;
+    value: unknown;
+    description?: string;
+}
+/**
+ * MCP Tool invocation
+ */
+interface MCPToolCall {
+    /** Unique identifier for this tool call */
+    id: string;
+    /** Name of the tool being invoked */
+    toolName: string;
+    /** Human-readable description of what the tool does */
+    description?: string;
+    /** Parameters passed to the tool */
+    parameters: MCPToolParameter[];
+    /** Current status of the tool execution */
+    status: MCPToolStatus;
+    /** Timestamp when tool was invoked */
+    startedAt: Date | string;
+    /** Timestamp when tool completed */
+    completedAt?: Date | string;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Result data if successful */
+    result?: MCPToolResult;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Result from an MCP tool execution
+ */
+interface MCPToolResult {
+    /** Type of result data */
+    type: 'text' | 'json' | 'link' | 'resource' | 'error';
+    /** The result data */
+    data: unknown;
+    /** Human-readable summary of the result */
+    summary?: string;
+    /** Link to a resource (for link type) */
+    link?: MCPResourceLink;
+    /** Resources created or modified */
+    resources?: MCPResource[];
+}
+/**
+ * Link to a resource
+ */
+interface MCPResourceLink {
+    /** URL or path to the resource */
+    href: string;
+    /** Display text for the link */
+    label: string;
+    /** Type of resource */
+    type?: 'patient' | 'document' | 'appointment' | 'order' | 'provider' | 'external' | 'internal';
+    /** Icon name or component */
+    icon?: string;
+}
+/**
+ * MCP Resource definition
+ */
+interface MCPResource {
+    /** Unique identifier */
+    id: string;
+    /** Resource type (e.g., 'patient', 'appointment', 'document') */
+    type: string;
+    /** Display name */
+    name: string;
+    /** URL to access the resource */
+    uri?: string;
+    /** Brief description */
+    description?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Role of the message sender
+ */
+type AIMessageRole = 'user' | 'assistant' | 'system' | 'tool';
+/**
+ * Status of an AI message
+ */
+type AIMessageStatus = 'pending' | 'streaming' | 'complete' | 'error';
+/**
+ * Content block within a message
+ */
+interface AIMessageContent {
+    /** Type of content */
+    type: 'text' | 'tool_use' | 'tool_result' | 'thinking' | 'code' | 'image' | 'file' | 'audio' | 'video';
+    /** Text content (also used as the label for `audio` and `video` blocks) */
+    text?: string;
+    /** Tool call reference */
+    toolCall?: MCPToolCall;
+    /** Language for code blocks */
+    language?: string;
+    /** Whether this content is collapsed by default */
+    collapsed?: boolean;
+    /** Image source URL (for `image` blocks) */
+    imageUrl?: string;
+    /** Alt text / file name (for `image` and `file` blocks) */
+    name?: string;
+    /** File size in bytes (for `file` blocks) */
+    fileSize?: number;
+    /** MIME type (for `file`, `audio`, and `video` blocks) */
+    mimeType?: string;
+    /** Download/open URL (for `file` blocks) */
+    fileUrl?: string;
+    /** Source URL for `audio` blocks */
+    audioUrl?: string;
+    /** Source URL for `video` blocks */
+    videoUrl?: string;
+    /** Duration in seconds for `audio` blocks */
+    duration?: number;
+}
+/**
+ * AI Chat Message
+ */
+interface AIMessage {
+    /** Unique identifier */
+    id: string;
+    /** Role of sender */
+    role: AIMessageRole;
+    /** Message content blocks */
+    content: AIMessageContent[];
+    /** Timestamp */
+    timestamp: Date | string;
+    /** Current status */
+    status: AIMessageStatus;
+    /** Model used (for assistant messages) */
+    model?: string;
+    /** Token usage info */
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/** Context passed to a custom text content renderer. */
+interface AITextRenderContext {
+    /** id of the parent message (useful as a render cache key) */
+    messageId: string;
+    /** true while the message is still streaming */
+    streaming: boolean;
+    /** role of the parent message */
+    role: AIMessage['role'];
+}
+/**
+ * Render-prop for customizing `text` content blocks. Host is responsible
+ * for sanitizing untrusted input.
+ */
+type AIRenderTextContent = (text: string, ctx: AITextRenderContext) => React.ReactNode;
 
 /**
  * SuperChat Types
@@ -248,4 +416,4 @@ interface GenUIBlockPayload {
     props?: unknown;
 }
 
-export type { AttachmentKind as A, ComposerAttachment as C, GenUIBlockPayload as G, Participant as P, SuperChatConversation as S, SuperChatRenderPlugin as a, SuperChatLinkBuilder as b, SuperChatCopyFormat as c, SuperChatRef as d, GenUIPrefetchPolicy as e, GenUIRegistry as f, GenUIWidgetEntry as g, GenUIWidgetProps as h, ParticipantKind as i, ParticipantStatus as j, StandardSchemaV1 as k, SuperChatChannel as l, SuperChatItemType as m, SuperChatMessage as n, SuperChatPluggable as o, SuperChatPluggableList as p };
+export type { AIRenderTextContent as A, ComposerAttachment as C, GenUIBlockPayload as G, MCPResourceLink as M, Participant as P, SuperChatConversation as S, SuperChatRenderPlugin as a, AttachmentKind as b, SuperChatLinkBuilder as c, SuperChatCopyFormat as d, SuperChatRef as e, AIMessageContent as f, AIMessageStatus as g, AITextRenderContext as h, GenUIPrefetchPolicy as i, GenUIRegistry as j, GenUIWidgetEntry as k, GenUIWidgetProps as l, ParticipantKind as m, ParticipantStatus as n, StandardSchemaV1 as o, SuperChatChannel as p, SuperChatItemType as q, SuperChatMessage as r, SuperChatPluggable as s, SuperChatPluggableList as t };

package/dist/{types-CbWXIKbe.d.cts → types-DsdZvEI1.d.cts}

@@ -1,5 +1,4 @@
 import * as React from 'react';
-import { DateTime } from 'luxon';
 
 /**
  * The contract every component in the `Modules/Views` family reads through.
@@ -64,7 +63,6 @@ interface ViewLabels {
     /** 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.
@@ -90,30 +88,5 @@ interface ViewBaseProps<T> {
     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 };
+export type { Stage as S, ViewLabels as V, ViewBaseProps as a };

package/dist/{types-CbWXIKbe.d.ts → types-DsdZvEI1.d.ts}

@@ -1,5 +1,4 @@
 import * as React from 'react';
-import { DateTime } from 'luxon';
 
 /**
  * The contract every component in the `Modules/Views` family reads through.
@@ -64,7 +63,6 @@ interface ViewLabels {
     /** 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.
@@ -90,30 +88,5 @@ interface ViewBaseProps<T> {
     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 };
+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.10",
+  "version": "0.10.0-dev.12",
   "description": "A themeable, accessible React component library built with Tailwind CSS",
   "author": "Medical Informatics Engineering, Inc.",
   "license": "SEE LICENSE IN LICENSE",
@@ -241,7 +241,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",

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 };