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

package/dist/{types-B97JNRNQ.d.cts → types-DOxdTwmq.d.cts}

@@ -1,5 +1,173 @@
 import * as React from 'react';
-import { A as AIMessageContent, a as AIMessageStatus } from './types-CnPEwzlp.cjs';
+
+/**
+ * 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-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.11",
+  "version": "0.10.0-dev.13",
   "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",