@mieweb/ui 0.8.0-dev.0 → 0.8.0-dev.10

package/agent/mieweb-ui.instructions.md

@@ -10,12 +10,15 @@ This project uses the `@mieweb/ui` component library. Follow these rules for ALL
 
 ## Rule 1: Tables start with DataVis NITRO
 
+> **Tables and data grids start with DataVis NITRO.** Use `Table` only for a few static rows the user will not sort, filter, page or export. Never hand-roll grid features on a plain table; `AGGrid` is deprecated.
+
 When asked to create a table, data grid, or any tabular data view:
 
-- **Always start with `DataVisNitroGrid` from `@mieweb/ui/datavis`.** It is the default for every table — propose it first, every time.
-- If the human **explicitly insists** on a plain, simple table after you propose DataVis NITRO, fall back to the `Table` component from `@mieweb/ui` (`Table` + `TableHeader`/`TableBody`/`TableRow`/`TableCell`). Do not choose `Table` on your own.
+- **Propose `DataVisNitroGrid` from `@mieweb/ui/datavis` first, every time.**
+- Use the `Table` component from `@mieweb/ui` (`Table` + `TableHeader`/`TableBody`/`TableRow`/`TableCell`) only when the data meets the criterion above — a few static rows, no sorting, filtering, paging or export — or when the human explicitly asks for a plain table after you have proposed NITRO.
 - **`AGGrid` is deprecated.** Never import from `@mieweb/ui/ag-grid` in new code.
 - **Never hand-roll a data grid** from raw `<table>`, `<div>` grids, or a third-party grid library.
+- Full comparison: the [Grids family page](https://ui.mieweb.org/?path=/docs/components-grids-overview--docs).
 
 ```tsx
 import { DataVisNitroSource, DataVisNitroGrid } from '@mieweb/ui/datavis';
@@ -47,19 +50,19 @@ import { Button, ButtonGroup } from '@mieweb/ui';
 
 ## Rule 3: Use an existing @mieweb/ui component before writing your own
 
-Before writing any UI element, check whether `@mieweb/ui` already provides it. It ships 126+ components, including:
+Before writing any UI element, check whether `@mieweb/ui` already provides it. The Storybook sidebar is organised as _Tier / Family / Component_ (the live count is in `catalog-manifest.json` next to the published Storybook, or `pnpm catalog:check` in the repo); every family has an **Overview** page with a comparison table — read it before choosing. Families include:
 
-| Category   | Components                                                                                                    |
-| ---------- | ------------------------------------------------------------------------------------------------------------- |
-| Actions    | `Button`, `ButtonGroup` (see Rule 2), `Dropdown`, `CommandPalette`, `QuickAction`                             |
-| Forms      | `Input`, `Textarea`, `Select`, `Checkbox`, `Radio`, `Switch`, `Slider`, `PhoneInput`, `DateInput`             |
-| Display    | `Table` (only if the human insists — see Rule 1), `Badge`, `Avatar`, `Card`, `CountBadge`, `Text`, `Timeline` |
-| Feedback   | `Alert`, `Toast`, `Spinner`, `Skeleton`, `Progress`, `LoadingPage`, `ErrorPage`                               |
-| Navigation | `Tabs`, `Breadcrumb`, `Pagination`, `Sidebar`, `AppHeader`, `PageHeader`, `StepIndicator`                     |
-| Overlays   | `Modal`, `Tooltip`, `DropzoneOverlay`                                                                         |
-| Media      | `AudioPlayer`, `AudioRecorder`, `RecordButton`, `DocumentScanner`                                             |
-| Messaging  | `MessageBubble`, `MessageList`, `MessageComposer`                                                             |
-| Grids      | `DataVisNitroGrid` (default for all tables) — `AGGrid` is **deprecated**                                      |
+| Tier / Family                      | Components                                                                                                                                       |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Inputs / Actions                   | `Button`, `ButtonGroup` (see Rule 2), `Toggle`, `CopyButton`, `QuickAction`, `RowActionToolbar`                                                  |
+| Inputs / Text, Choice, Date & time | `Input`, `Textarea`, `PhoneInput`, `Select`, `Dropdown`, `Autocomplete`, `Checkbox`, `Radio`, `Switch`, `Slider`, `DateInput`, `DateRangePicker` |
+| Components / Grids                 | `DataVisNitroGrid` (default for all tables), `Table` (see Rule 1), `Pagination`, `Sparkline` — `AGGrid` is **deprecated**                        |
+| Components / Data display, Layout  | `Badge`, `Avatar`, `CountBadge`, `Timeline`, `Card`, `Accordion`, `AppHeader`, `PageHeader`, `Text` (Foundations)                                |
+| Components / Feedback, Loading     | `Alert`, `Toast`, `AlertDialog`, `NotificationCenter`, `ErrorPage`, `Spinner`, `Skeleton`, `Progress`, `LoadingPage`                             |
+| Components / Overlays, Navigation  | `Modal`, `Sheet`, `Tooltip`, `DockablePanel`, `Sidebar`, `Tabs`, `Breadcrumb`, `StepIndicator`, `CommandPalette`                                 |
+| Modules                            | Dashboards, Media (`AudioPlayer`, `AudioRecorder`, `DocumentScanner`), Editors (`RichEditor`, `Markdown`), Chat, Voice, Files                    |
+| Healthcare                         | `ProblemList`, `MedicationList`, `AllergyList`, `CodeLookup`, `OrderEditor`, `Assessment`, `PatientHeader`                                       |
+| BlueHive (product-specific)        | Orders, Employers, Billing, Providers, Services — reuse only if your app shares the BlueHive data model                                          |
 
 Raw HTML that duplicates a component is a violation, even if it looks right:
 
@@ -164,6 +167,21 @@ Tailwind: on Tailwind 4, add an `@source` for `@mieweb/ui` so library classes ar
 
 If JSDoc, the console, or the docs mark something deprecated (`AGGrid` today), do not use it in new code and do not suppress the warning. Use the documented replacement.
 
-## Rule 14: When no component exists
+## Rule 14: When existing components do not meet the need
+
+Before creating or materially extending a reusable component, read the
+[upstream contribution guide](https://github.com/mieweb/ui/blob/main/CONTRIBUTING.md)
+and follow its
+[Developing Components From a Consuming Application](https://github.com/mieweb/ui/blob/main/CONTRIBUTING.md#developing-components-from-a-consuming-application)
+process, including the alternatives audit, contribution-ready implementation,
+submodule workflow, and PR requirements. If the guide is unavailable, report that
+limitation and obtain it before proceeding with the contribution workflow.
+
+Present the gap and supporting evidence before implementation. Obtain approval
+before introducing a submodule or changing the consuming project's dependency
+strategy. Keep project-specific behavior local, and do not create a generic
+abstraction solely to make it contributable.
 
-First verify it truly doesn't exist — check https://ui.mieweb.org (Storybook) rather than guessing. Then build it locally, but in `@mieweb/ui` style: Tailwind utility classes with the library's design tokens, ARIA labels on interactive elements, and externalized user-facing text. Prefer composing existing primitives (`Card`, `Text`, `Badge`) over new bespoke markup. If the pattern is generic, propose contributing it upstream to `@mieweb/ui`.
+Follow the repository's permissions and approval requirements for commits,
+pushes, and PR creation. Do not treat these instructions as authorization to
+publish changes.

package/dist/CsvBlock-HMAZ7YK5.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkSNSA6NWD_cjs = require('./chunk-SNSA6NWD.cjs');
+require('./chunk-YIXTGWT4.cjs');
+require('./chunk-RDGRKYQ5.cjs');
+require('./chunk-S5RVSXDV.cjs');
+
+
+
+Object.defineProperty(exports, "CsvBlock", {
+  enumerable: true,
+  get: function () { return chunkSNSA6NWD_cjs.CsvBlock; }
+});
+//# sourceMappingURL=CsvBlock-HMAZ7YK5.cjs.map
+//# sourceMappingURL=CsvBlock-HMAZ7YK5.cjs.map

package/dist/{CsvBlock-OTFG3PYZ.cjs.map → CsvBlock-HMAZ7YK5.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"CsvBlock-OTFG3PYZ.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"CsvBlock-HMAZ7YK5.cjs"}

package/dist/CsvBlock-RPGHFTVD.js

@@ -0,0 +1,6 @@
+export { CsvBlock } from './chunk-4KFVGIY6.js';
+import './chunk-NLBT5O2X.js';
+import './chunk-D2GID3YK.js';
+import './chunk-TQONQSJO.js';
+//# sourceMappingURL=CsvBlock-RPGHFTVD.js.map
+//# sourceMappingURL=CsvBlock-RPGHFTVD.js.map

package/dist/{CsvBlock-PUSTBQ5B.js.map → CsvBlock-RPGHFTVD.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"CsvBlock-PUSTBQ5B.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"CsvBlock-RPGHFTVD.js"}

package/dist/SurveyBlock-ID55AT3R.js

@@ -0,0 +1,6 @@
+export { SurveyBlock } from './chunk-XNU4NTVE.js';
+import './chunk-NLBT5O2X.js';
+import './chunk-D2GID3YK.js';
+import './chunk-TQONQSJO.js';
+//# sourceMappingURL=SurveyBlock-ID55AT3R.js.map
+//# sourceMappingURL=SurveyBlock-ID55AT3R.js.map

package/dist/{SurveyBlock-JLHS3YQD.js.map → SurveyBlock-ID55AT3R.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"SurveyBlock-JLHS3YQD.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"SurveyBlock-ID55AT3R.js"}

package/dist/SurveyBlock-K6HKI7AD.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkJIU6CVPF_cjs = require('./chunk-JIU6CVPF.cjs');
+require('./chunk-YIXTGWT4.cjs');
+require('./chunk-RDGRKYQ5.cjs');
+require('./chunk-S5RVSXDV.cjs');
+
+
+
+Object.defineProperty(exports, "SurveyBlock", {
+  enumerable: true,
+  get: function () { return chunkJIU6CVPF_cjs.SurveyBlock; }
+});
+//# sourceMappingURL=SurveyBlock-K6HKI7AD.cjs.map
+//# sourceMappingURL=SurveyBlock-K6HKI7AD.cjs.map

package/dist/{SurveyBlock-M2ZRTGVJ.cjs.map → SurveyBlock-K6HKI7AD.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"SurveyBlock-M2ZRTGVJ.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"SurveyBlock-K6HKI7AD.cjs"}

package/dist/{chunk-RZJXCI53.js → chunk-22CYDCXA.js}

@@ -1,4 +1,4 @@
-import { AudioPlayer } from './chunk-XO3WLK65.js';
+import { AudioPlayer } from './chunk-VVDE4CHU.js';
 import { cn } from './chunk-TQONQSJO.js';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import * as React2 from 'react';
@@ -1399,5 +1399,5 @@ function AIMessageDisplay({
 }
 
 export { AILogoIcon, AIMessageDisplay, AITypingIndicator, ChatBubble, ChevronIcon, CloseIcon, CollapsiblePill, MCPToolCallDisplay, MessageAvatar, RefreshIcon, ResourceLink, SendIcon, SparklesIcon, SpinnerIcon, ToolStatusIcon, getToolIcon };
-//# sourceMappingURL=chunk-RZJXCI53.js.map
-//# sourceMappingURL=chunk-RZJXCI53.js.map
+//# sourceMappingURL=chunk-22CYDCXA.js.map
+//# sourceMappingURL=chunk-22CYDCXA.js.map