@dcs-tech/ui 0.9.0 → 0.11.0

package/README.md

@@ -30,14 +30,24 @@ export const Example = () => (
 
 ## What's in it
 
-- **Fields** — Input, Select, Suggest, Checkbox, Radio, Switch, ChipInput, all
-  sharing one control surface, a 6-step size scale and one state model
-- **Primitives** — Button, Typography, Tooltip
+- **Fields** — Input, Select, Suggest, DatePicker (a day, a range, or `picker="month"` /
+  `"year"`), Checkbox, Radio, Switch, ChipInput (including free-text `tags`), all sharing one
+  control surface, a 6-step size scale and one state model
+- **Images** — ImagePicker, ImageStrip, ImageViewer, and ImageEditor (crop, zoom, rotate,
+  straighten, flip; each tool can be allowed or restricted). `prepareImage` applies the same
+  transform with no UI
+- **Overlays** — Dialog (`useDialog()` for confirms; `DialogHost` if you do not use `UIProvider`),
+  Popover, DropdownMenu, Toast
+- **Primitives** — Button, Typography, Tooltip, Alert (with a page-wide `banner` form)
+- **Navigation** — Link (`as` takes a router's link), Pagination, CommandPaletteTrigger,
+  PageProgress (a route-change bar, driven by `active`), NavList (a vertical link list for
+  inside a page)
 - **Layout** — Collapsible, FieldWrapper
+- **Lists** — ReorderList (drag to reorder: rows slide live, with mouse, touch or keyboard)
 - **Composites** — Form, Fields, EditableTable
 - **Data** — DataTable (client data or a server `dataSource`: views, search, filters,
-  sort, grouping, column chooser, table / card / split layouts, selection + bulk
-  actions, header / footer summaries with charts, export to xlsx / pdf / csv / html /
+  sort, grouping, column chooser, table / card / split layouts, `toolbarActions`, selection + bulk
+  actions (the table reports what `onRun` returns, and nothing if it returns nothing), header / footer summaries with charts, export to xlsx / pdf / csv / html /
   json / xml) and Charts (Chart, ColumnChart, BarList, Donut, Progress, Legend,
   ChartTable, LineChart, Funnel, Gauge, Treemap, … with a picture menu)
 - **Scroll** — one scrollbar rule (thin, hidden until needed) in `style.css`, edge
@@ -66,8 +76,9 @@ const view: DataTableView<Order> = {
 ```
 
 The table's runtime dependencies (`@tanstack/react-table`, `@tanstack/react-virtual`,
-`@tanstack/match-sorter-utils`, `exceljs`, `pdfmake` — loaded on the first PDF export —
-and `react-icons`) install with the package.
+`@tanstack/match-sorter-utils`, `exceljs` and `pdfmake` — loaded on the first PDF export)
+install with the package. The icons are the library's own (`IconFilter`, `filterIcon`, …): it
+has no icon dependency.
 
 ## Files and the background worker
 
@@ -129,6 +140,31 @@ Every colour, size and spacing value is a CSS custom property. Override them on
 `variant` is per family — `outlined | filled | standard | underlined` for text
 fields, `outlined | filled | standard` for Checkbox and Radio, none for Switch.
 
+### Field width
+
+A text field fills the space its parent gives it, up to 320px. `width` changes that:
+
+| `width` | The field is |
+| --- | --- |
+| not given | the available space, up to 320px |
+| `"full"` | the whole row, with no limit |
+| `"auto"` | as wide as its content |
+| `240`, `"15rem"` | exactly that, never wider than its parent |
+
+In a table cell (`layout="cell"`) the column decides and `width` is ignored. With `layout="horizontal"`
+it sizes the control; the label keeps its column.
+
+### List width
+
+A Select or Suggest list fits its content: never narrower than its field, up to 320px (Select) or
+480px (Suggest), and always on screen. `listWidth="field"` makes it exactly the field's width.
+
+### Icon size
+
+An icon-only button or a Sidebar row sizes its icon with the `--icon-size-xxs` … `--icon-size-xl`
+tokens, which follow `--ui-scale`. Override them on `:root` to change icon sizes across the app. An
+icon given its own `size` keeps it.
+
 ### Dialog width
 
 `Dialog` takes `size="sm | md | lg | xl | full"` (420 / 560 / 720 / 960 px / the whole

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,23 @@
+# Third-party notices
+
+## Lucide
+
+Many of the icon drawings in `src/core/icons` (and so in `dist/index.js`) follow the geometry of
+Lucide icons (https://lucide.dev). The drawings that are new to this library are marked "New" in
+the source. Lucide is distributed under the ISC License:
+
+ISC License
+
+Copyright (c) for portions of Lucide are held by Cole Bemis 2013-2022 as part of Feather (MIT).
+All other copyright (c) for Lucide are held by Lucide Contributors 2022.
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without
+fee is hereby granted, provided that the above copyright notice and this permission notice appear
+in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
+SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
+AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
+NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
+OF THIS SOFTWARE.