@softistx/material 3.249.0 → 3.250.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +16 -0
- package/README.md +2 -2
- package/dist/capture-toolbar.css +1 -1
- package/dist/{components-BbAylWQW.js → components-DUvKQIBi.js} +3 -1
- package/dist/components.js +1 -1
- package/dist/embed-chunks/{dist-C-lAK_LC.js → dist-BVPJSDov.js} +1 -1
- package/dist/embed-chunks/{emoji-picker-BWDQFdQu.js → emoji-picker-CrIXB9pF.js} +22 -22
- package/dist/embed-chunks/{mention-list-CdUr0h3X.js → mention-list-9hwOYNND.js} +1 -1
- package/dist/embed-chunks/{nxgt-theme-provider-DdDsiEPj.js → nxgt-theme-provider-Cjl7Eb8v.js} +703 -592
- package/dist/embed-chunks/switch-control-BrwJRN_V.js +207 -0
- package/dist/embed-chunks/{tabs-root-MF9lEHbq.js → tabs-root-BvPc1aaV.js} +5 -5
- package/dist/embed-chunks/{useLatest-RGIW0nya.js → useLatest-CbcU5ozz.js} +322 -322
- package/dist/embed.css +2 -2
- package/dist/embed.js +1266 -740
- package/dist/image-editor.css +1 -1
- package/dist/image-editor.js +902 -1017
- package/dist/lib/components/ui/layout/account-frame/account-frame.d.ts +2 -2
- package/dist/lib/embed/index.d.ts +4 -1
- package/dist/main.js +1 -1
- package/dist/material.css +1 -1
- package/docs/components/navigation-and-layout.md +2 -2
- package/docs/guides/embed.md +44 -0
- package/docs/roadmap.md +1 -0
- package/lib/components/ui/layout/app-shell/app-header.css +7 -0
- package/package.json +1 -1
- package/dist/embed-chunks/bubble-input-yXAeW84_.js +0 -29
- package/dist/embed-chunks/switch-control-B95ZWvna.js +0 -181
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# @nxgt/material
|
|
2
2
|
|
|
3
|
+
## 3.250.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#5328](https://github.com/softistx/nxgt-material/pull/5328) [`b7d6857`](https://github.com/softistx/nxgt-material/commit/b7d6857e32b771c8e7be5cb2b078db4ba9b97462) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `ActivityLayout`'s app bar no longer leaves a 0.5rem strip of page ground at its trailing edge when `header.surface` is `"sidebar"` (the default look): its fill now reaches the page edge, as it already did at the start, and the actions and avatar keep their place.
|
|
8
|
+
|
|
9
|
+
## 3.250.0
|
|
10
|
+
|
|
11
|
+
### Minor Changes
|
|
12
|
+
|
|
13
|
+
- [#5315](https://github.com/softistx/nxgt-material/pull/5315) [`6f5a5a2`](https://github.com/softistx/nxgt-material/commit/6f5a5a2e21b4bec79a95d66b8fcb5be61da65a19) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `AccountFrame`'s `width` gains `'xl'` (64rem) and `'2xl'` (80rem) beside `'sm'`, `'md'` and `'lg'`, so a signed-out or account page with two columns (a thread and a side card) has room at 1440px. The existing widths and the `'md'` default are unchanged.
|
|
14
|
+
|
|
15
|
+
- [#5317](https://github.com/softistx/nxgt-material/pull/5317) [`2939a67`](https://github.com/softistx/nxgt-material/commit/2939a672e09999eee4f1aedf89942e838e12fb25) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@softistx/material/embed` exports `ConfirmDialog` (and its `ConfirmDialogProps` and `ConfirmTone` types), so a widget in a shadow root can ask a destructive confirm. It opens from inside an already-open `Dialog`, portals into the shadow root, and its CSS ships in `embed.css`. Its footer keeps Cancel on the left and the main action on the right on one row.
|
|
16
|
+
|
|
17
|
+
- [#5316](https://github.com/softistx/nxgt-material/pull/5316) [`c4e11f9`](https://github.com/softistx/nxgt-material/commit/c4e11f9178438fc73696fdd199d5b3ce06376692) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@softistx/material/embed` exports `SwitchField` (with `SwitchFieldProps`) and `SwitchFormField`: a labelled switch whose `plain` variant keeps the label beside it and shows `helperText` under it. The Switch styles are in `embed.css`, and the field works in a shadow root under a strict CSP (the hidden form input is rendered in the browser only, so no inline style is server-rendered).
|
|
18
|
+
|
|
3
19
|
## 3.249.0
|
|
4
20
|
|
|
5
21
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -294,7 +294,7 @@ reads `duotone.svg`, the file that exists (it used to ask for the missing
|
|
|
294
294
|
| `@softistx/material/pdf-form` | The PDF form filler: `<PdfFormFiller source />` draws a PDF with the PdfReader's engine and each AcroForm field (text, several lines, date, check box, radio group, drop-down, list box, signature) as a library-styled control over its page, with a Save action; under it the headless `usePdfForm(source, { values, defaultValues, onValuesChange })`, `readPdfFormFields`, `savePdfForm`, `toPdfFormJson` and `fromPdfFormJson`; `PdfFormFillerFormField` binds it to React Hook Form, and a `ref` (`PdfFormFillerHandle`) gives `save()` to a primary button of your own ([guide](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/guides/pdf-form.md)). **Its own entry, browser-only** (it reuses the PdfReader's pdf.js, loaded on first use). Guided filling: `navigation` (a bar with progress, Previous, Next and "Next missing" that walks the fields in page order), `showFieldPanel` (a Fields panel listing every field with its state, a bottom sheet on a phone), and `activeField` / `onActiveFieldChange` to control the current field; the reader's header height is exposed as `--pdf-reader-header-h`. Signature fields use `@softistx/material/signature` |
|
|
295
295
|
| `@softistx/material/charts` | Native SVG charts (d3-scale and d3-shape for the maths only) with keyboard point navigation, a screen-reader summary, a "View data" table and `patterns`: `LineChart` and `AreaChart` (`LineChartProps`, `AreaChartProps`, `ChartCurve`), `BarChart` (`BarChartProps`, `BarLayout`, `BarOrientation`), `PieChart` (`PieChartProps`), `DonutChart` (`DonutChartProps`), `Gauge` (`GaugeProps`, `GaugeSize`), `RadialBarChart` (`RadialBarChartProps`), `FunnelChart` (`FunnelChartProps`), `PopulationPyramid` (`PopulationPyramidProps`, `PyramidBand`, `PyramidSide`: two groups back to back by band on one scale, `onSelect`), `HeatmapChart` (`HeatmapChartProps`, `HeatColumn`), `RadarChart` (`RadarChartProps`), `ScatterChart` (`ScatterChartProps`, `ScatterSeries`, `ScatterPoint`), `ComboChart` (`ComboChartProps`, `ComboSeries`: bars, areas and lines, each on a left or a right axis), `labelWidth` and `wrapLabels` (a horizontal `BarChart`'s category labels), `maskedLabel` (a `HeatmapChart`'s missing cells), `zoom` (a mini overview with a window and two slider handles that picks the rows shown; `range`, `defaultRange`, `onRangeChange`) and `scroll` (a dense plot scrolls sideways on a phone, the value axis pinned) on the line, area, bar and combo charts (`ChartRangeProps`, `ChartZoomOptions`, `ChartScrollOptions`, `ChartRange`), `bands` (shaded ranges), `thresholds` (labelled lines) and `pointTone` (a ringed point with its word, `toneLabels`) on the line and area charts, read against the value axis and carried into the tooltip, the summary and the "View data" table (`ChartBand`, `ChartThreshold`), `onPointClick` on every chart but `Gauge`, `palette` (`'soft'`: the soft palette, or `data-chart-palette="soft"` on an ancestor; `ChartPalette`) on every chart, and the shared types (`ChartSlice`, `ChartRow`, `ChartValue`, `ChartColor`, `ChartShape`, `ChartSeries`, `ChartAxis`, `ChartXAxis`, `ChartPoint`, `ChartBaseProps`). `categoryLabel` names the "View data" table's category column: on Line, Area, Bar and Combo it defaults to the x axis label, on Radar and Heatmap it is always "Category" unless set. **Its own entry, client-only** (import it from a `'use client'` file), not in the barrel above; replaces the Nivo charts (removed in 3.0) of `/components` ([guide](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/guides/charts.md)) |
|
|
296
296
|
| `@softistx/material/barcode` | `Barcode` (Code 128 and Data Matrix as accessible SVG that follows the theme and dark mode, black on white in print; no runtime dependency) and `LabelSheet` / `Label` (label size, columns, rows, gaps and a start offset for a printed sheet of labels), plus `barcodeGeometry` and `BarcodeError` — **its own entry** ([barcode guide](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/guides/barcode.md)) |
|
|
297
|
-
| `@softistx/material/embed` | The lean entry for a widget in a third-party page: `Dialog` and its parts, `Button`, `TextField`, `TextareaField`, `EmailField` (`EmailFieldProps`) and their React Hook Form wrappers (`TextFormField`, `EmailFormField`, `TextareaFormField`), `Checkbox` (`CheckboxProps`) and `CheckboxFormField`, `Input`, `Textarea`, `Alert`, `Tabs`, `ChipGroupField`, `Badge`, `ListRow`, `EmptyState`, `Skeleton`, `SkeletonText`, `Spinner`, `ChatThread`, `ChatMessageList`, `ChatMessage` (with a plain-text `text` mode), `ChatMessageSeparator` and `ChatComposer`, `AttachmentList` (`AttachmentItem`), `I18nProvider` (`I18nProviderProps`), `NxgtThemeProvider`, `PortalContainerProvider`, `adoptStyles`. No global set on import; `@softistx/material/embed.css` is its shadow-root-ready stylesheet ([embed guide](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/guides/embed.md)) |
|
|
297
|
+
| `@softistx/material/embed` | The lean entry for a widget in a third-party page: `Dialog` and its parts, `Button`, `TextField`, `TextareaField`, `EmailField` (`EmailFieldProps`) and their React Hook Form wrappers (`TextFormField`, `EmailFormField`, `TextareaFormField`), `Checkbox` (`CheckboxProps`) and `CheckboxFormField`, `SwitchField` (`SwitchFieldProps`) and `SwitchFormField`, `Input`, `Textarea`, `Alert`, `ConfirmDialog` (`ConfirmDialogProps`, `ConfirmTone`), `Tabs`, `ChipGroupField`, `Badge`, `ListRow`, `EmptyState`, `Skeleton`, `SkeletonText`, `Spinner`, `ChatThread`, `ChatMessageList`, `ChatMessage` (with a plain-text `text` mode), `ChatMessageSeparator` and `ChatComposer`, `AttachmentList` (`AttachmentItem`), `I18nProvider` (`I18nProviderProps`), `NxgtThemeProvider`, `PortalContainerProvider`, `adoptStyles`. No global set on import; `@softistx/material/embed.css` is its shadow-root-ready stylesheet ([embed guide](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/guides/embed.md)) |
|
|
298
298
|
| `@softistx/material/image-editor` | The photo editor for a widget in a third-party page: `ImageEditor`, `ImageMarkupEditor` (pen, highlighter, arrow, rectangle, text, numbered step markers and redact over a screenshot, `crop` to add the Crop panel, `toolbar="floating"` for the annotate-mode pill; no adjust, filters or download) and `EMBED_MARKUP_TOOLS`, with `NxgtThemeProvider`, `PortalContainerProvider` and `adoptStyles`; `decode="bitmap"` decodes with `createImageBitmap` (no `<img>`, no object URL). No global set on import; `@softistx/material/image-editor.css` is its shadow-root-ready stylesheet ([guide](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/guides/embed.md#the-photo-editor)) |
|
|
299
299
|
| `@softistx/material/embed-css` | Build-time helpers for an embed's own CSS (Bun or Node, never in a browser bundle): `withPropertyFallbacks(css)`, `propertyInitials`, `propertyFallbacks` and `PROPERTY_LAYER`, which restore the `@property` initial values a shadow root ignores ([embed guide](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/guides/embed.md#your-own-css)) |
|
|
300
300
|
| `@softistx/material/calculator` | `Calculator`: exact decimal arithmetic with the usual precedence, a large display, a shaped keypad, a tape of past results, a memory, the physical keyboard, copy and paste, screen-reader announcements and a variant switcher (Standard, Scientific, Point of sale, Financial, Conversion and Programmer) — **its own entry** ([calculator guide](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/guides/calculator.md)) |
|
|
@@ -1270,7 +1270,7 @@ Not components: what the stylesheet gives any element.
|
|
|
1270
1270
|
| <img src="https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/previews/navigation-layout-accountmenu.webp" width="120" alt="AccountMenu"> | [`AccountMenu`](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/components/navigation-and-layout.md#accountmenu) | The app bar's avatar menu: named after the account, the name and e-mail, the app's links, then an optional Theme choice (`themeChoice`) and a destructive Sign out with a busy state. | `AccountMenu` |
|
|
1271
1271
|
| <img src="https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/previews/navigation-layout-authcard.webp" width="120" alt="AuthCard"> | [`AuthCard`](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/components/navigation-and-layout.md#authcard) | The frame of a signed-out page: one `main`, a centred card whose title is the `h1` (focusable on an end state), a status or alert notice, a brand and toolbar row, safe-area padding, an optional backdrop (the theme's by default) that keeps clear of the card. | `AuthCard` |
|
|
1272
1272
|
| <img src="https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/previews/navigation-layout-authcard-authvisual.webp" width="120" alt="AuthVisual"> | [`AuthVisual`](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/components/navigation-and-layout.md#authvisual) | The visual side of `AuthCard layout="split"`: a flat primary tint with a domain `Illustration`, a headline and value line, two or three benefits and a stat or quote; shown from 768px, hidden on a phone, an `h2` under the form's `h1`. | not yet (#5174) |
|
|
1273
|
-
| <img src="https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/previews/navigation-layout-accountframe.webp" width="120" alt="AccountFrame"> | [`AccountFrame`](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/components/navigation-and-layout.md#accountframe) | The frame of a signed-in page beside `AuthCard` on the same base (one `main`, the title as the `h1`, notice, footer, backdrop): the `toolbar` then the signed-in `account` (last, far right) in the brand row, `width` `sm`/`md`/`lg`, `surface` `card`/`plain`, a tinted ground and raised card by default (`ground`, `elevation`), a `hero` band, and an optional workspace trail (`breadcrumb`, `breadcrumbRoot`, `back`). | — (later, #3440) |
|
|
1273
|
+
| <img src="https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/previews/navigation-layout-accountframe.webp" width="120" alt="AccountFrame"> | [`AccountFrame`](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/components/navigation-and-layout.md#accountframe) | The frame of a signed-in page beside `AuthCard` on the same base (one `main`, the title as the `h1`, notice, footer, backdrop): the `toolbar` then the signed-in `account` (last, far right) in the brand row, `width` `sm`/`md`/`lg`/`xl`/`2xl`, `surface` `card`/`plain`, a tinted ground and raised card by default (`ground`, `elevation`), a `hero` band, and an optional workspace trail (`breadcrumb`, `breadcrumbRoot`, `back`). | — (later, #3440) |
|
|
1274
1274
|
| <img src="https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/previews/navigation-layout-workspacepicker.webp" width="120" alt="WorkspacePicker"> | [`WorkspacePicker`](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/components/navigation-and-layout.md#workspacepicker) | The choice of where to continue after sign-in: a `nav` of cards (64px avatar with a photo, icon or initials in a tone, name, secondary line, a reserved badge slot, equal size, lifted on hover and focus) from 640px, a list of tiles on a phone; links (`href`) or buttons (`onSelect`), a search field and a live "n of N" count from 8 options, an empty state for none and for no match; `pendingId` marks the workspace being opened as busy. Put it in `AccountFrame`. | — (later, #3449) |
|
|
1275
1275
|
| <img src="https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/previews/navigation-layout-sidebar.webp" width="120" alt="Sidebar"> | [`Sidebar`](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/components/navigation-and-layout.md#sidebar), `SidebarHeader`, `SidebarContent`, `SidebarFooter`, `SidebarMenuItem`, `SidebarMenuLabel` | Collapsible navigation sidebar with icons, tooltips and active items. | `Sidebar` (same parts) |
|
|
1276
1276
|
| <img src="https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/previews/navigation-layout-topappbar.webp" width="120" alt="TopAppBar"> | [`TopAppBar`](https://github.com/softistx/nxgt-material/blob/develop/packages/material/docs/components/navigation-and-layout.md#topappbar), `BottomAppBar` | The top app bar: four sizes (`size`: small, medium-flexible, large-flexible, search), `align`, a `title` that is the page's `h1` with a `subtitle`, collapse on scroll, free icon `actions` as data with an account menu, a `primaryAction` (a FAB on a phone); and a bottom bar of icon actions with an active state. `AppHeader` is its deprecated wrapper. | `TopAppBar`, `BottomAppBar` |
|