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

package/dist/index-DoYYWsNc.d.ts

@@ -0,0 +1,127 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * 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;
+}
+
+interface ViewOption {
+    id: ViewId;
+    /** Overrides the built-in English label. */
+    label?: string;
+    /** Overrides the built-in icon. */
+    icon?: React.ComponentType<{
+        className?: string;
+        'aria-hidden'?: boolean;
+    }>;
+    disabled?: boolean;
+}
+interface ViewSwitcherProps extends VariantProps<typeof viewSwitcherVariants> {
+    /** Views to offer, in order. Accepts bare ids or `ViewOption`s. */
+    views: readonly (ViewId | ViewOption)[];
+    value: ViewId;
+    onValueChange: (view: ViewId) => void;
+    /** Accessible name of the group. */
+    label?: string;
+    /** Show labels beside the icons. `responsive` hides them below `sm`. */
+    showLabels?: boolean | 'responsive';
+    className?: string;
+    classNames?: Partial<Record<'option' | 'activeOption', string>>;
+}
+declare const viewSwitcherVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/**
+ * Keyboard model is a radio group: one tab stop, arrows move *and* select.
+ * Every option is visible, so moving the selection is the whole interaction —
+ * there is nothing to "commit" afterwards.
+ */
+declare const ViewSwitcher: React.ForwardRefExoticComponent<ViewSwitcherProps & React.RefAttributes<HTMLDivElement>>;
+
+export { type Stage as S, type ViewBaseProps as V, type ViewLabels as a, type ViewId as b, type ViewOption as c, ViewSwitcher as d, type ViewSwitcherProps as e, viewSwitcherVariants as v };

package/dist/index.cjs

@@ -27,8 +27,8 @@ var chunkYGA35Z2P_cjs = require('./chunk-YGA35Z2P.cjs');
 var chunk2G75X6TS_cjs = require('./chunk-2G75X6TS.cjs');
 var chunk7RV6CAP6_cjs = require('./chunk-7RV6CAP6.cjs');
 var chunkMYHV2ND3_cjs = require('./chunk-MYHV2ND3.cjs');
-var chunkOD47TTAW_cjs = require('./chunk-OD47TTAW.cjs');
-var chunkX4XPNTCZ_cjs = require('./chunk-X4XPNTCZ.cjs');
+var chunkV43ZFGCE_cjs = require('./chunk-V43ZFGCE.cjs');
+var chunkYQ2NQV5C_cjs = require('./chunk-YQ2NQV5C.cjs');
 var chunkJTSKPDPH_cjs = require('./chunk-JTSKPDPH.cjs');
 var chunkGD7EBGC4_cjs = require('./chunk-GD7EBGC4.cjs');
 var chunk3SZQRMHM_cjs = require('./chunk-3SZQRMHM.cjs');
@@ -1429,7 +1429,7 @@ function AIEmptyState({
     /* @__PURE__ */ jsxRuntime.jsx(SuggestedActions, { actions: suggestions, onSelect: onSuggestionSelect })
   ] }) : void 0;
   return /* @__PURE__ */ jsxRuntime.jsx(
-    chunkOD47TTAW_cjs.EmptyState,
+    chunkV43ZFGCE_cjs.EmptyState,
     {
       title,
       description,
@@ -1490,7 +1490,7 @@ function AIChat({
   renderMessageFooter
 }) {
   React13__namespace.useEffect(() => {
-    chunkX4XPNTCZ_cjs.notifyComposerMigrationOnce("AIChat");
+    chunkYQ2NQV5C_cjs.notifyComposerMigrationOnce("AIChat");
   }, []);
   const messages = React13__namespace.useMemo(
     () => session?.messages || messagesProp || [],
@@ -1626,7 +1626,7 @@ function AIChat({
     },
     [isHostControlled, hostOnValueChange]
   );
-  const { stopTyping } = chunkOD47TTAW_cjs.useTypingEmulation({
+  const { stopTyping } = chunkV43ZFGCE_cjs.useTypingEmulation({
     value: composerValue,
     onTypingStart,
     onTypingStop
@@ -1793,7 +1793,7 @@ function AIChat({
                 }
               ) }),
               /* @__PURE__ */ jsxRuntime.jsx("div", { "data-slot": "ai-chat-composer", className: "p-3", children: /* @__PURE__ */ jsxRuntime.jsx(
-                chunkX4XPNTCZ_cjs.ChatComposer,
+                chunkYQ2NQV5C_cjs.ChatComposer,
                 {
                   onSend: hostOnSend ? (message) => sendWithRestore(message, hostOnSend) : handleSend,
                   placeholder: inputPlaceholder,
@@ -1815,8 +1815,8 @@ function AIChat({
                   allowAttachments: composerRest.allowAttachments ?? legacyAttachments,
                   maxLength: composerRest.maxLength ?? 1600,
                   inputLabel: composerRest.inputLabel ?? "Message",
-                  acceptedFileTypes: composerRest.acceptedFileTypes ?? (legacyAttachments ? chunkX4XPNTCZ_cjs.DEFAULT_ACCEPTED_FILE_TYPES : void 0),
-                  maxFileSize: composerRest.maxFileSize ?? (legacyAttachments ? chunkX4XPNTCZ_cjs.DEFAULT_MAX_FILE_SIZE : void 0),
+                  acceptedFileTypes: composerRest.acceptedFileTypes ?? (legacyAttachments ? chunkYQ2NQV5C_cjs.DEFAULT_ACCEPTED_FILE_TYPES : void 0),
+                  maxFileSize: composerRest.maxFileSize ?? (legacyAttachments ? chunkYQ2NQV5C_cjs.DEFAULT_MAX_FILE_SIZE : void 0),
                   value: composerValue,
                   onValueChange: handleComposerValueChange
                 }
@@ -44821,159 +44821,159 @@ Object.defineProperty(exports, "getToolIcon", {
 });
 Object.defineProperty(exports, "AttachmentPreview", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.AttachmentPreview; }
+  get: function () { return chunkV43ZFGCE_cjs.AttachmentPreview; }
 });
 Object.defineProperty(exports, "ConversationHeader", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.ConversationHeader; }
+  get: function () { return chunkV43ZFGCE_cjs.ConversationHeader; }
 });
 Object.defineProperty(exports, "ConversationListItem", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.ConversationListItem; }
+  get: function () { return chunkV43ZFGCE_cjs.ConversationListItem; }
 });
 Object.defineProperty(exports, "ConversationListSkeleton", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.ConversationListSkeleton; }
+  get: function () { return chunkV43ZFGCE_cjs.ConversationListSkeleton; }
 });
 Object.defineProperty(exports, "DateSeparator", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.DateSeparator; }
+  get: function () { return chunkV43ZFGCE_cjs.DateSeparator; }
 });
 Object.defineProperty(exports, "EmptyState", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.EmptyState; }
+  get: function () { return chunkV43ZFGCE_cjs.EmptyState; }
 });
 Object.defineProperty(exports, "LightboxModal", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.LightboxModal; }
+  get: function () { return chunkV43ZFGCE_cjs.LightboxModal; }
 });
 Object.defineProperty(exports, "LoadMoreButton", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.LoadMoreButton; }
+  get: function () { return chunkV43ZFGCE_cjs.LoadMoreButton; }
 });
 Object.defineProperty(exports, "MessageBubble", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.MessageBubble; }
+  get: function () { return chunkV43ZFGCE_cjs.MessageBubble; }
 });
 Object.defineProperty(exports, "MessageList", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.MessageList; }
+  get: function () { return chunkV43ZFGCE_cjs.MessageList; }
 });
 Object.defineProperty(exports, "MessageStatusIcon", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.MessageStatusIcon; }
+  get: function () { return chunkV43ZFGCE_cjs.MessageStatusIcon; }
 });
 Object.defineProperty(exports, "MessageThread", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.MessageThread; }
+  get: function () { return chunkV43ZFGCE_cjs.MessageThread; }
 });
 Object.defineProperty(exports, "MessagingSplitView", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.MessagingSplitView; }
+  get: function () { return chunkV43ZFGCE_cjs.MessagingSplitView; }
 });
 Object.defineProperty(exports, "ReadReceiptIndicator", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.ReadReceiptIndicator; }
+  get: function () { return chunkV43ZFGCE_cjs.ReadReceiptIndicator; }
 });
 Object.defineProperty(exports, "SkeletonMessage", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.SkeletonMessage; }
+  get: function () { return chunkV43ZFGCE_cjs.SkeletonMessage; }
 });
 Object.defineProperty(exports, "TypingIndicator", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.TypingIndicator; }
+  get: function () { return chunkV43ZFGCE_cjs.TypingIndicator; }
 });
 Object.defineProperty(exports, "bubbleVariants", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.bubbleVariants; }
+  get: function () { return chunkV43ZFGCE_cjs.bubbleVariants; }
 });
 Object.defineProperty(exports, "formatDateLabel", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.formatDateLabel; }
+  get: function () { return chunkV43ZFGCE_cjs.formatDateLabel; }
 });
 Object.defineProperty(exports, "formatFileSize", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.formatFileSize; }
+  get: function () { return chunkV43ZFGCE_cjs.formatFileSize; }
 });
 Object.defineProperty(exports, "formatLastSeen", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.formatLastSeen; }
+  get: function () { return chunkV43ZFGCE_cjs.formatLastSeen; }
 });
 Object.defineProperty(exports, "getConversationSubtitle", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.getConversationSubtitle; }
+  get: function () { return chunkV43ZFGCE_cjs.getConversationSubtitle; }
 });
 Object.defineProperty(exports, "getConversationTitle", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.getConversationTitle; }
+  get: function () { return chunkV43ZFGCE_cjs.getConversationTitle; }
 });
 Object.defineProperty(exports, "groupMessagesByDate", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.groupMessagesByDate; }
+  get: function () { return chunkV43ZFGCE_cjs.groupMessagesByDate; }
 });
 Object.defineProperty(exports, "headerVariants", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.headerVariants; }
+  get: function () { return chunkV43ZFGCE_cjs.headerVariants; }
 });
 Object.defineProperty(exports, "isSameSenderGroup", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.isSameSenderGroup; }
+  get: function () { return chunkV43ZFGCE_cjs.isSameSenderGroup; }
 });
 Object.defineProperty(exports, "useMessageScroll", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.useMessageScroll; }
+  get: function () { return chunkV43ZFGCE_cjs.useMessageScroll; }
 });
 Object.defineProperty(exports, "useMessages", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.useMessages; }
+  get: function () { return chunkV43ZFGCE_cjs.useMessages; }
 });
 Object.defineProperty(exports, "useReadReceipts", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.useReadReceipts; }
+  get: function () { return chunkV43ZFGCE_cjs.useReadReceipts; }
 });
 Object.defineProperty(exports, "useTypingEmulation", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.useTypingEmulation; }
+  get: function () { return chunkV43ZFGCE_cjs.useTypingEmulation; }
 });
 Object.defineProperty(exports, "useTypingIndicator", {
   enumerable: true,
-  get: function () { return chunkOD47TTAW_cjs.useTypingIndicator; }
+  get: function () { return chunkV43ZFGCE_cjs.useTypingIndicator; }
 });
 Object.defineProperty(exports, "AttachmentPicker", {
   enumerable: true,
-  get: function () { return chunkX4XPNTCZ_cjs.AttachmentPicker; }
+  get: function () { return chunkYQ2NQV5C_cjs.AttachmentPicker; }
 });
 Object.defineProperty(exports, "AttachmentPreviewItem", {
   enumerable: true,
-  get: function () { return chunkX4XPNTCZ_cjs.AttachmentPreviewItem; }
+  get: function () { return chunkYQ2NQV5C_cjs.AttachmentPreviewItem; }
 });
 Object.defineProperty(exports, "CameraButton", {
   enumerable: true,
-  get: function () { return chunkX4XPNTCZ_cjs.CameraButton; }
+  get: function () { return chunkYQ2NQV5C_cjs.CameraButton; }
 });
 Object.defineProperty(exports, "ChatComposer", {
   enumerable: true,
-  get: function () { return chunkX4XPNTCZ_cjs.ChatComposer; }
+  get: function () { return chunkYQ2NQV5C_cjs.ChatComposer; }
 });
 Object.defineProperty(exports, "ComposerModelSelector", {
   enumerable: true,
-  get: function () { return chunkX4XPNTCZ_cjs.ComposerModelSelector; }
+  get: function () { return chunkYQ2NQV5C_cjs.ComposerModelSelector; }
 });
 Object.defineProperty(exports, "DragDropZone", {
   enumerable: true,
-  get: function () { return chunkX4XPNTCZ_cjs.DragDropZone; }
+  get: function () { return chunkYQ2NQV5C_cjs.DragDropZone; }
 });
 Object.defineProperty(exports, "generateAttachmentId", {
   enumerable: true,
-  get: function () { return chunkX4XPNTCZ_cjs.generateAttachmentId; }
+  get: function () { return chunkYQ2NQV5C_cjs.generateAttachmentId; }
 });
 Object.defineProperty(exports, "getFileType", {
   enumerable: true,
-  get: function () { return chunkX4XPNTCZ_cjs.getFileType; }
+  get: function () { return chunkYQ2NQV5C_cjs.getFileType; }
 });
 Object.defineProperty(exports, "validateFile", {
   enumerable: true,
-  get: function () { return chunkX4XPNTCZ_cjs.validateFile; }
+  get: function () { return chunkYQ2NQV5C_cjs.validateFile; }
 });
 Object.defineProperty(exports, "RecordButton", {
   enumerable: true,