diff --git a/AGENTS.md b/AGENTS.md index f3b48b7..24f5949 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,5 +24,15 @@ For UI changes, also inspect affected demo routes with `npm run dev` (port 5180) There is no automated test script. Documentation-only changes need path and format validation rather than application builds. +`CHANGELOG.md` is for consumers and is written by release-please from the +squash-merged PR title, so make that title a Conventional Commit that describes +the change as a consumer sees it (`feat:` new components or options, `fix:` +behaviour and skill corrections, `fix(deps):` runtime dependencies; `chore:`, +`ci:` and `docs:` stay out of the changelog). When one PR carries several +consumer-visible changes, list each as its own Conventional Commit between +`BEGIN_COMMIT_OVERRIDE` and `END_COMMIT_OVERRIDE` in the PR body. If an upgrade +needs action from consumers, add an "Upgrading" note to the release PR's +`CHANGELOG.md` entry before merging it. + Preserve the Claude plugin and marketplace configuration. Before editing a subdirectory, read any nested agent guidance and applicable scoped rules. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..43c994c --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/README.md b/README.md index 44d94fa..7dc1994 100644 --- a/README.md +++ b/README.md @@ -17,9 +17,10 @@ npm install @liasoft/lit-ui bootstrap ```ts import '@liasoft/lit-ui/styles.css'; -import { initTheme } from '@liasoft/lit-ui'; +import { initTheme, installConfirmHandler } from '@liasoft/lit-ui'; initTheme(); +const uninstallConfirm = installConfirmHandler(); // call on app teardown ``` Import the whole kit, or just the families you need: @@ -57,10 +58,21 @@ working in your repo loads exactly the component knowledge it needs — nothing After that, asking Claude Code to "add a members listing with row actions" makes it reach for `TableListing` and `lia-data-table` the way this README would. +The same skills ship in the npm package, matching the installed version, under +`node_modules/@liasoft/lit-ui/plugins/lit-ui/skills/`. Point other agents (Codex, +Copilot) at `overview/SKILL.md` there, for example from your `AGENTS.md`. + +## What changed + +[CHANGELOG.md](CHANGELOG.md) lists every release: new components and options, fixes, +and what to change when you upgrade. + --- ## A complete page +For a routed app, start with the [complete shell and page recipe](plugins/lit-ui/skills/layout/SKILL.md#compose-a-routed-application). Extend `LiaTransparentElement` for app/view wrappers, let `lia-page` own the heading and gutter, and use `lia-card` for titled sections. Set the shell’s `content-class=""` when a router view or error boundary wraps the page. + ```ts import { html, render } from 'lit'; import '@liasoft/lit-ui'; @@ -70,12 +82,13 @@ render(html` brand-label="Orbit Console" .navItems=${nav} .user=${{ loginname: 'amara', isAdmin: true }} - search-enabled + .searchEnabled=${false} > - + console.log(e.detail.action.id, e.detail.row)} - > + >`}> `, document.querySelector('#app')); ``` -That is the whole page: sidebar, navbar with global search, heading bar with a toolbar, -sortable and selectable table with bulk actions, per-row confirm dialogs, pagination, -column manager and search. +This composes the sidebar, navbar, heading toolbar and attached table with pagination, +column manager and search. Supply `nav`, `members` and your action handlers; install +the confirmation handler from the setup above for styled per-row dialogs. Enable +global search only when the app handles `lia-search` and supplies results. --- diff --git a/package-lock.json b/package-lock.json index d365469..da8ffa1 100644 --- a/package-lock.json +++ b/package-lock.json @@ -61,9 +61,9 @@ } }, "node_modules/@oxc-project/types": { - "version": "0.149.0", - "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.149.0.tgz", - "integrity": "sha512-Efcc+iF0j3Bf67YjEqIqWXbX5XddXoK/Mw4K1/JuXwRCZ8N16VR7iT23nlCc9XrveFVh/E5Rqs2StT0V8v9LdA==", + "version": "0.155.0", + "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.155.0.tgz", + "integrity": "sha512-SeE8JPwW1xs1tHeNycjUtUBdhorRa8o4jlvjwk49R7/Z291i+4DQa7JJIgOm/TaYQZx+QrPQbVJ/9c8dMIZN8Q==", "dev": true, "license": "MIT", "funding": { @@ -198,6 +198,9 @@ "arm" ], "dev": true, + "libc": [ + "glibc" + ], "license": "MIT", "optional": true, "os": [ @@ -219,6 +222,9 @@ "arm" ], "dev": true, + "libc": [ + "musl" + ], "license": "MIT", "optional": true, "os": [ @@ -240,6 +246,9 @@ "arm64" ], "dev": true, + "libc": [ + "glibc" + ], "license": "MIT", "optional": true, "os": [ @@ -261,6 +270,9 @@ "arm64" ], "dev": true, + "libc": [ + "musl" + ], "license": "MIT", "optional": true, "os": [ @@ -282,6 +294,9 @@ "x64" ], "dev": true, + "libc": [ + "glibc" + ], "license": "MIT", "optional": true, "os": [ @@ -303,6 +318,9 @@ "x64" ], "dev": true, + "libc": [ + "musl" + ], "license": "MIT", "optional": true, "os": [ @@ -370,9 +388,9 @@ } }, "node_modules/@rolldown/binding-android-arm-eabi": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.8.tgz", - "integrity": "sha512-tN5aztYkKCte4i5SIrrz5yK/HMjEuCqCSCJa418jOV8tZ1cBY3YF2otxB1ktPxzsLA1BeTqwapK0bfjxNvHJVw==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.15.tgz", + "integrity": "sha512-aLcgK9gIJ3YRvrrtfSBbRa27F5WrpiTaPulnFpsHPxpUHgFlSgnU4854MHwoRGEBhfRJDWCS2WQ7lIjskE9Olw==", "cpu": [ "arm" ], @@ -387,9 +405,9 @@ } }, "node_modules/@rolldown/binding-android-arm64": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.8.tgz", - "integrity": "sha512-dIYTWl9XprMUiQFoc55KUyk/oS8SKYH3zFl0LTR7RT0Xj4hgSVyuJcroH8JUu8RcpF8fTB6E0aOwCkZoYPcDSQ==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.15.tgz", + "integrity": "sha512-xD7DdZCrbThKuxNg7ooQmvp07ys4J/pnSEMTG3/OdOWl6daC67m/Q4fL78sRHMxTH/N4fGUbYhcPM0MF5WFHkg==", "cpu": [ "arm64" ], @@ -404,9 +422,9 @@ } }, "node_modules/@rolldown/binding-darwin-arm64": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.8.tgz", - "integrity": "sha512-PCSDQGXD2IyTEFrcgPyBM8jJuGmrbCMuoIOXdbEGVemruKACXoLQJrb+A45Z0L5t1RQkdfJprAYPkikbh7dzdA==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.15.tgz", + "integrity": "sha512-m2WuQ6r0B4OTYxyPpNLtXaMRbRDUbG8YQV2Q3KTdSSK8Th6KHCnC8jVCJt8bvYeSB5WivkkNbc85mKadaSdOxA==", "cpu": [ "arm64" ], @@ -421,9 +439,9 @@ } }, "node_modules/@rolldown/binding-darwin-x64": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.8.tgz", - "integrity": "sha512-Uk7lRsGhPFHVX/sAUC6D5H9Ol30dFHd6iquokll2th3LpdJ3F5CzQB+7DHn0Ri2mG+U7k2zXiPHDrwZenXhwSA==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.15.tgz", + "integrity": "sha512-5RtnsHM36nodM9WbMy+zip0LGS/G+y5wro5RHrpOlr4ac24+1zSi9kiV2MP1myZeZ/ifEHfulQcWjnAXzc2C2A==", "cpu": [ "x64" ], @@ -438,9 +456,9 @@ } }, "node_modules/@rolldown/binding-freebsd-x64": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.8.tgz", - "integrity": "sha512-DjszaTEVogPqA5bYzsEeqDCQxbcp2fexQwKcRspYji2yzR68fCf+e4fx6kBSRDwX5/brZaHw/hWS9+A/+/w9sQ==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.15.tgz", + "integrity": "sha512-g3l09pyFqhu+135JKkbkwiKGQmwU5hUMUPJ4VdBADvuqR8d33L6H578rh8m7rtxbdp+VmX/+nzI7nvhSZlzpUQ==", "cpu": [ "x64" ], @@ -455,9 +473,9 @@ } }, "node_modules/@rolldown/binding-linux-arm-gnueabihf": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.8.tgz", - "integrity": "sha512-zmwa7FTmdzB6aaEEuuls18H6Ap5JmJPSoPTuXixeJZV6tG40SyLkApQtz1g8ptZtiEKqj9OM0oNLPh1AgvE31Q==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.15.tgz", + "integrity": "sha512-nIe3VugI97nGQtspPxDqA4sXMUpeiocKIP/CqpY/u/vgbT+alX+cVxu1C/oVBPKg4feNTmYovE91v4DgXvXNwQ==", "cpu": [ "arm" ], @@ -472,9 +490,9 @@ } }, "node_modules/@rolldown/binding-linux-arm64-gnu": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.8.tgz", - "integrity": "sha512-KdYQDPHwJVnbFwdTGMgxsI9SqblBlz6STGM+w1We/d5B8OWWidYH0MwkU/uA1wM5fIpO2MkOVxXrNzzuZhw9ew==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.15.tgz", + "integrity": "sha512-iTBjXx+B5QSvgI89lJfmqh4wTh8NabR1YZIIN3hNx4zSG0EVfVqkOvLulNpG4251pbd6/IAmZ/LefVk1Y4rPhw==", "cpu": [ "arm64" ], @@ -492,9 +510,9 @@ } }, "node_modules/@rolldown/binding-linux-arm64-musl": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.8.tgz", - "integrity": "sha512-jFJTifHnNPY+yzOoNZQfSIysrVyXzEQPhPnOUjmD1bcQGHH6s7c8cViKWar8YplQImE5N9JRqMCLrM2CdxOrZA==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.15.tgz", + "integrity": "sha512-uN26XOnVR7rqQupG3V9oAG2EGGatWjcJHOeDOHUFCh4TBWmP2tHTFoVN13aYbwfm0aHqJAEmcwhAu6sooIjfqQ==", "cpu": [ "arm64" ], @@ -512,9 +530,9 @@ } }, "node_modules/@rolldown/binding-linux-ppc64-gnu": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.8.tgz", - "integrity": "sha512-FhiOziBDWPBjbcmRzfLyIJnaP7AVMFXT7YCXPjXxj7wKU3vx24RjrCNN/zjvVa+N2vVoHJwCoUBvsrN/DG3zIA==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.15.tgz", + "integrity": "sha512-9nWkcdd+H+XhaA3fQIwpHnKIrfx/PQ6rO0pivr78Og07tXlUlctBBJoEYLPfhTmCR/QxEVdn6uPjHV5SymPhdw==", "cpu": [ "ppc64" ], @@ -532,9 +550,9 @@ } }, "node_modules/@rolldown/binding-linux-s390x-gnu": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.8.tgz", - "integrity": "sha512-WnHfADMzOV2Y55wlx1hzzQnar/wDt/VdvWSD99r18Mz9ylNieIGOkRx3UV21h7m/eJvjySYJkO26VvGNFkwsIQ==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.15.tgz", + "integrity": "sha512-Ggh0ciFjLwIusLSLz7LZYEaGdxOAUJXI+Qu5JCbhPJJHEt8vP+IjRATTJheiJsdzzTYgUiHUiw3X1Ea3ZpMBdA==", "cpu": [ "s390x" ], @@ -552,9 +570,9 @@ } }, "node_modules/@rolldown/binding-linux-x64-gnu": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.8.tgz", - "integrity": "sha512-H9tRr5ibfXFVLxbPOseVewewFpl28zcEdjRDt2FTUZU7odxP0gEv1ki4/kGmcGOh78oRwZuuQllGLZ9zTJp84g==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.15.tgz", + "integrity": "sha512-FHg60rS6DBePAYZ9X9F67x+JObFdmgn6tupA1C/a3B+CufFmTD4mX+e8M75tCiAO3foR/6xwVBI0KQiI7sn/rw==", "cpu": [ "x64" ], @@ -572,9 +590,9 @@ } }, "node_modules/@rolldown/binding-linux-x64-musl": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.8.tgz", - "integrity": "sha512-UefiqfM3D6IVNlZ8tSGs9+Ejjud2T+oxO0IHADU45Y+lyEjD2dVFyZHbkfX0LUb5Zugo/oIv1eCO/KVYhgYJYA==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.15.tgz", + "integrity": "sha512-/cvV/7v5VGz/moiz0XKRj2dE8DzsKyhIu1KpOvJGPjRywg3yscON889UGvAe8zfiJLHup7VLjBduoGWi3HusWQ==", "cpu": [ "x64" ], @@ -592,9 +610,9 @@ } }, "node_modules/@rolldown/binding-openharmony-arm64": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.8.tgz", - "integrity": "sha512-637Ke4kWSy6rp9cxQ9gMOXlxPgIw/c1beASV4M//3+9I4uwBVOOl74G+e3zyU3u19U7RkRl/HuewixZ/Z6+Rjg==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.15.tgz", + "integrity": "sha512-MyzC5Hrv/sm+Z7TSGKP/j8001RO2xQm1zOpCNVL4j0cY/VhBZviludA2YFQ7i4lH6ZAXxQm0lcMdBzM+99mE7w==", "cpu": [ "arm64" ], @@ -609,9 +627,9 @@ } }, "node_modules/@rolldown/binding-win32-arm64-msvc": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.8.tgz", - "integrity": "sha512-xWBkPOF1Q9k/Gv1nQXnVdLxKu74jXppuOM4Z3mnypVUJJJwLsMl7hNJGRAUJoG8A5MgOI1ACKM+wBFxSJzKy4A==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.15.tgz", + "integrity": "sha512-+PgYiS+AH5omy6L45ZLxybasauJaj3M8buoT83D+nzPmCayXlxUV9hydhciCKVyIg0B/v0BtXPDE1uGqNwCPpg==", "cpu": [ "arm64" ], @@ -626,9 +644,9 @@ } }, "node_modules/@rolldown/binding-win32-x64-msvc": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.8.tgz", - "integrity": "sha512-uz2ZvfgXbxqNwijjjbxrnvALwpyODDcgc1T1N8N3rf/DXKQmaFwmB4LX4yyjggpwN2obdQLb2rgirX5ffCWYng==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.15.tgz", + "integrity": "sha512-HFZd2QNQYn1JbIi+Hpd7H+r/lkWxcfIu28nirZ6eCn2LafuvmExMlb/P96Sfx5tf7pPArw39IdhmCF8vmV+NhQ==", "cpu": [ "x64" ], @@ -1026,9 +1044,9 @@ } }, "node_modules/chart.js": { - "version": "4.5.1", - "resolved": "https://registry.npmjs.org/chart.js/-/chart.js-4.5.1.tgz", - "integrity": "sha512-GIjfiT9dbmHRiYi6Nl2yFCq7kkwdkp1W/lp2J99rX0yo9tgJGn3lKQATztIjb5tVtevcBtIdICNWqlq5+E8/Pw==", + "version": "4.6.1", + "resolved": "https://registry.npmjs.org/chart.js/-/chart.js-4.6.1.tgz", + "integrity": "sha512-hJyniucsFmq//EvXYvJ6c6mahPoI3kaxdjVH8awTaJ/fDNWeSqqqArixMJWkWNN6fcYvPU3HneSANFNYtRi61g==", "dev": true, "license": "MIT", "dependencies": { @@ -1434,9 +1452,9 @@ } }, "node_modules/nanoid": { - "version": "3.3.19", - "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.19.tgz", - "integrity": "sha512-Y2tUNy4ouw6tq5oDSKeQYGOyhkUBhNOcGV/02KC+6kd9eDGqdZd++mjMiIDilrBYvjEnCYvVtsuHCuP+okSfug==", + "version": "3.3.20", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.20.tgz", + "integrity": "sha512-uKdg2G3GNCKQn9byYOpxbGqrT2fGO5KRt5J/8b3pok8rT6qxGWF6hxMyJiEYtAf+FVyYuD9hRaDqX5uPFYJ4ZQ==", "dev": true, "funding": [ { @@ -1481,9 +1499,9 @@ } }, "node_modules/postcss": { - "version": "8.5.28", - "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.28.tgz", - "integrity": "sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A==", + "version": "8.5.32", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.32.tgz", + "integrity": "sha512-LJlKCCAUFKOuZxipUdYw1NzIITEsPcgyOG9LkvRJvuKj/bRzbuRY0ARXvL0pWGpsZvn8jku+LMep2eU0seHp8g==", "dev": true, "funding": [ { @@ -1501,9 +1519,9 @@ ], "license": "MIT", "dependencies": { - "nanoid": "^3.3.18", + "nanoid": "^3.3.20", "picocolors": "^1.1.1", - "source-map-js": "^1.2.1" + "source-map-js": "^1.2.2" }, "engines": { "node": "^10 || ^12 || >=14" @@ -1524,13 +1542,13 @@ } }, "node_modules/rolldown": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.8.tgz", - "integrity": "sha512-Z67nTmhZe7anqnM/EjI392w5i/ANUinjip7QYsOyN37oayduxt3ksdX0hf5OOamkAd53BiIHfbfSzfUmzKFQqQ==", + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.15.tgz", + "integrity": "sha512-6odND+fel5zVw3I4Yc2e69gvguDnX0CAAGiNDZSq4ik5WUcaLrkD2GLuog0XcODbor31hZ5ayEMgVDno+KPV5g==", "dev": true, "license": "MIT", "dependencies": { - "@oxc-project/types": "=0.149.0", + "@oxc-project/types": "=0.155.0", "@rolldown/pluginutils": "^1.0.0" }, "bin": { @@ -1540,27 +1558,27 @@ "node": "^20.19.0 || >=22.12.0" }, "optionalDependencies": { - "@rolldown/binding-android-arm-eabi": "1.2.8", - "@rolldown/binding-android-arm64": "1.2.8", - "@rolldown/binding-darwin-arm64": "1.2.8", - "@rolldown/binding-darwin-x64": "1.2.8", - "@rolldown/binding-freebsd-x64": "1.2.8", - "@rolldown/binding-linux-arm-gnueabihf": "1.2.8", - "@rolldown/binding-linux-arm64-gnu": "1.2.8", - "@rolldown/binding-linux-arm64-musl": "1.2.8", - "@rolldown/binding-linux-ppc64-gnu": "1.2.8", - "@rolldown/binding-linux-s390x-gnu": "1.2.8", - "@rolldown/binding-linux-x64-gnu": "1.2.8", - "@rolldown/binding-linux-x64-musl": "1.2.8", - "@rolldown/binding-openharmony-arm64": "1.2.8", - "@rolldown/binding-win32-arm64-msvc": "1.2.8", - "@rolldown/binding-win32-x64-msvc": "1.2.8" + "@rolldown/binding-android-arm-eabi": "1.2.15", + "@rolldown/binding-android-arm64": "1.2.15", + "@rolldown/binding-darwin-arm64": "1.2.15", + "@rolldown/binding-darwin-x64": "1.2.15", + "@rolldown/binding-freebsd-x64": "1.2.15", + "@rolldown/binding-linux-arm-gnueabihf": "1.2.15", + "@rolldown/binding-linux-arm64-gnu": "1.2.15", + "@rolldown/binding-linux-arm64-musl": "1.2.15", + "@rolldown/binding-linux-ppc64-gnu": "1.2.15", + "@rolldown/binding-linux-s390x-gnu": "1.2.15", + "@rolldown/binding-linux-x64-gnu": "1.2.15", + "@rolldown/binding-linux-x64-musl": "1.2.15", + "@rolldown/binding-openharmony-arm64": "1.2.15", + "@rolldown/binding-win32-arm64-msvc": "1.2.15", + "@rolldown/binding-win32-x64-msvc": "1.2.15" } }, "node_modules/sass": { - "version": "1.104.0", - "resolved": "https://registry.npmjs.org/sass/-/sass-1.104.0.tgz", - "integrity": "sha512-btHMApW2bgolvClhRW8AlQJzgI9lUB3pPSofBQQT+E46GWvf9o0TVQ13SYv5riWZVFyPN+JNz3TKW9XhBlc10w==", + "version": "1.106.1", + "resolved": "https://registry.npmjs.org/sass/-/sass-1.106.1.tgz", + "integrity": "sha512-kD+Gi66vycZcbJt+42NC4z4PXNMcCajVrJPhqoKKXy5cOBMmJQt052CxIBcRjwYXeImHYOpu/ydWWGZQIenl7A==", "dev": true, "license": "MIT", "dependencies": { @@ -1579,9 +1597,9 @@ } }, "node_modules/source-map-js": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", - "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.2.tgz", + "integrity": "sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==", "dev": true, "license": "BSD-3-Clause", "engines": { @@ -1641,16 +1659,16 @@ } }, "node_modules/vite": { - "version": "8.3.0", - "resolved": "https://registry.npmjs.org/vite/-/vite-8.3.0.tgz", - "integrity": "sha512-lhZBVvEHefgE+HQZC9O7EBJgCU/nVzFNl7vkS4RE0APtWLP02/8QVIkQtzBxPquh7lq5/78NHipTj7ODQ6XuyQ==", + "version": "8.3.5", + "resolved": "https://registry.npmjs.org/vite/-/vite-8.3.5.tgz", + "integrity": "sha512-z1YpjieJ9g0ebTmQpLBv/oq9E3F9EIlOe+7LahW8SrE3LTiG3udBRUXQOlYXP9b+IC2q2phHeVxj9xGlw34OEQ==", "dev": true, "license": "MIT", "dependencies": { "lightningcss": "^1.33.0", "picomatch": "^4.0.7", - "postcss": "^8.5.28", - "rolldown": "~1.2.6", + "postcss": "^8.5.30", + "rolldown": "~1.2.14", "tinyglobby": "^0.2.17" }, "bin": { @@ -1667,7 +1685,7 @@ }, "peerDependencies": { "@types/node": "^20.19.0 || >=22.12.0", - "@vitejs/devtools": "^0.7.1", + "@vitejs/devtools": "^0.7.1 || ^0.8.0", "esbuild": "^0.27.0 || ^0.28.0", "jiti": ">=1.21.0", "less": "^4.0.0", diff --git a/package.json b/package.json index aa5b99b..3414e06 100644 --- a/package.json +++ b/package.json @@ -31,7 +31,8 @@ }, "files": [ "dist", - "src" + "src", + "plugins/lit-ui/skills" ], "sideEffects": [ "**/*.css", diff --git a/plugins/lit-ui/skills/dashboard/SKILL.md b/plugins/lit-ui/skills/dashboard/SKILL.md index 5f6da05..06e6f3e 100644 --- a/plugins/lit-ui/skills/dashboard/SKILL.md +++ b/plugins/lit-ui/skills/dashboard/SKILL.md @@ -121,4 +121,4 @@ html`` over hand-assembling navbar + rails + footer: it wires the sidebar toggler, projects your content into `
`, and re-emits every child event. Inside the shell, wrap each screen in `` rather than hand-rolling a title bar + alert region — the shell detects a projected `lia-page` and drops its own padding. Use `` alone only when you need a title bar outside a page (e.g. above a card). ``, ``, `` and `` also work standalone. Heading/banner action toolbars are `ActionDescriptor[]` rendered by the primitives family's `renderActions`, so `confirm:` on an action opens `lia-confirm-dialog` (feedback family) exactly as in a table row. `lia-auth-layout` is NOT here — that is the auth family. +Every screen of an admin app lives inside this chrome. Prefer `` over hand-assembling navbar + rails + footer: it wires the sidebar toggler, projects your content into `
`, and re-emits every child event. Inside the shell, wrap each screen in `` rather than hand-rolling a title bar + alert region — the shell detects a projected `lia-page` and drops its own padding. Use `` alone only when you need a title bar outside a page (e.g. above a card). ``, ``, `` and `` also work standalone. Heading/banner action toolbars are `ActionDescriptor[]` rendered by the primitives family's `renderActions`, so `confirm:` on an action opens `lia-confirm-dialog` after `installConfirmHandler()` is installed (feedback family) exactly as in a table row. `lia-auth-layout` is NOT here — that is the auth family. ## Setup `import '@liasoft/lit-ui'` registers everything (or just `import '@liasoft/lit-ui/components/layout'`); load `@liasoft/lit-ui/styles.css` once globally; call `initTheme()` (from the root export, `core/theme`) once at start-up to apply the persisted colour scheme and track the OS in `auto`. Everything renders into the light DOM — no shadow roots, so Bootstrap classes and page CSS reach every element, and there is no ``. +## Compose a routed application + +Use this structure before adding page-specific styling. It matches the shell and +page composition used by `covdbg-license`: + +- An application root and any router/view wrappers extend `LiaTransparentElement` + (or `LiaDataElement` for a data-loading view). Do not turn them into padded boxes. +- The shell owns the viewport and scrolling. Set `content-class=""` when a routed + view or error boundary sits between the shell and `lia-page`: automatic padding + detection only sees direct `lia-page` children. +- `lia-page` owns the heading, alerts and content gutter. Bind `.title`, `.actions` + and `.alerts`. Put breadcrumbs and sections inside its content, using Bootstrap + `d-flex flex-column gap-3` and `row g-3` / `col-*` for layout. To change the content + gutter, set the page's `content-class`, not padding on an outside wrapper. +- Use `lia-card` for titled sections. Put `lia-data-table` directly in its `.content` + so attached mode shares the card frame and moves table tools to the header. + Prefer `lia-stat-row`, `lia-key-value`, `lia-badge` / `renderBadge` and descriptor + actions over custom metric cards, status chips and button styles. Editors such + as `lia-log-viewer` already own their frame; do not put another card around them. +- Use `lia-auth-layout` for authentication screens outside the shell. Choose a + supplied auth form or a `lia-form` for application-specific credentials. + +This small two-page example includes the shell lifecycle and routing contracts. +It assumes the server serves the app entry point at `/members` and `/settings`. +Replace the page bodies with your own data and forms; do not rebuild the chrome. + +```ts +import { html } from 'lit'; +import { keyed } from 'lit/directives/keyed.js'; +import { + LiaTransparentElement, initTheme, installConfirmHandler, + type ActionEventDetail, +} from '@liasoft/lit-ui'; +import '@liasoft/lit-ui/styles.css'; + +class ConsoleApp extends LiaTransparentElement { + static properties = { path: { state: true } }; + declare path: string; // Do not shadow Lit's reactive accessor with a class field. + private uninstallConfirm?: () => void; + private onPop = () => { this.path = location.pathname; }; + + constructor() { super(); this.path = location.pathname; } + connectedCallback() { + super.connectedCallback(); + this.uninstallConfirm = installConfirmHandler(); + window.addEventListener('popstate', this.onPop); + } + disconnectedCallback() { + this.uninstallConfirm?.(); + window.removeEventListener('popstate', this.onPop); + super.disconnectedCallback(); + } + private go(url: string) { + if (location.pathname !== url) history.pushState(null, '', url); + this.path = url; + this.querySelector('lia-app-shell')?.toggleSidebar(false); + } + private onNavigate = (event: CustomEvent<{ url: string }>) => { + if (!['/members', '/settings'].includes(event.detail.url)) return; + event.preventDefault(); + this.go(event.detail.url); + }; + private onAction = (event: CustomEvent) => { + // Heading/card/table anchors emit lia-action, not lia-navigate. + const href = event.detail.action.href; + if (!href || !['/members', '/settings'].includes(href)) return; + event.preventDefault(); + this.go(href); + }; + render() { + const settings = this.path === '/settings'; + const title = settings ? 'Settings' : 'Members'; + return html` + + ${keyed(this.path, html` + + +
+ + Put your settings form here.

` + : html`` + }>
+
+
+
`)} +
`; + } +} +initTheme(); +customElements.define('console-app', ConsoleApp); +``` + +Place `` in the document body. If you add account +controls, handle `lia-logout` with `preventDefault()` and your logout flow. Native +anchors in custom cell/body templates also need your router's usual delegated +click handler; preserve modified clicks, downloads and external links. + +Before calling the UI complete, inspect a listing, detail, form and auth page at +desktop and mobile widths. Check that the navbar stays in place, only main content +scrolls, the heading spans the main column, gutters line up, tables have one frame, +mobile navigation closes after routing, and confirmations use `lia-confirm-dialog`. +Verify light and dark themes and check for page-wide horizontal overflow. + + +### Compatibility with 0.1.3 and earlier + +Up to 0.1.3, a navbar with search disabled left the empty search container in +place, which pushed the account controls out of position, and a responsive action +lost its accessible name below `lg`. Later versions fix both. On 0.1.3 or earlier, +scope these adjustments to your app root, and supply `title: label` on responsive +action descriptors; remove both after upgrading: + +```css +console-app lia-navbar .lia-collapse-search[hidden] { display: none !important; } +console-app lia-navbar .container-fluid > div.order-md-1 { flex-grow: 1 !important; } +``` + + ## Component reference ### Shared data shapes (core/types) @@ -49,7 +177,7 @@ html` { e.preventDefault(); router.go(e.detail.url); }} @lia-search=${(e) => load(e.detail.text)}> - … + … ` ``` diff --git a/plugins/lit-ui/skills/overview/SKILL.md b/plugins/lit-ui/skills/overview/SKILL.md index 5db9de1..f08a90f 100644 --- a/plugins/lit-ui/skills/overview/SKILL.md +++ b/plugins/lit-ui/skills/overview/SKILL.md @@ -33,7 +33,7 @@ import '@liasoft/lit-ui'; // registers all 70 elements | `auth` | `lia-auth-layout` `lia-login-form` `lia-forgot-password-form` `lia-reset-password-form` `lia-two-factor-form` `lia-two-factor-setup` `lia-otp-prompt` `lia-credentials-prompt` `lia-question-dialog` `lia-profile-form` `lia-password-strength` `lia-code-input` | sign-in, recovery, 2FA, re-auth prompts; presentation-only — they emit events, nothing posts | | `editors` | `lia-record-editor` `lia-log-viewer` `lia-diff-view` `lia-code-block` `lia-api-keys-panel` `lia-file-tree` | specialised views: repeatable-record editing, log tailing, diffs, code display, API keys, file trees | -Typical page: `lia-app-shell` → `lia-page` → `lia-data-table` / `lia-form` / dashboard widgets. Load the family skill before writing components from it. +Typical page: transparent app/view → `lia-app-shell` → `lia-page` → `lia-card` → `lia-data-table` / `lia-form`, with dashboard widgets as needed. Before building an app shell or changing page layout, read the [complete routed application recipe](../layout/SKILL.md#compose-a-routed-application). It covers padding ownership, attached tables, navigation, confirmation setup and responsive checks. Load the family skill before writing components from it. ## Base classes (host apps extend these) @@ -44,7 +44,7 @@ Typical page: `lia-app-shell` → `lia-page` → `lia-data-table` / `lia-form` / ## Cross-cutting contracts -- **`ActionDescriptor`** — every button/toolbar/row action anywhere: `{ id, label, icon, href, variant, size, disabled, visible, confirm, modal, back, data }`. `href` renders an anchor; otherwise a button emitting `lia-action` with detail `{ action, id, row?, rows?, index? }`. `confirm: { message, title?, variant?, confirmLabel? }` routes through `lia-confirm-dialog` before the event fires — identically in page headings, table rows and bulk bars. +- **`ActionDescriptor`** — every button/toolbar/row action anywhere: `{ id, label, icon, href, variant, size, disabled, visible, confirm, modal, back, data }`. `href` renders an anchor; otherwise a button emitting `lia-action` with detail `{ action, id, row?, rows?, index? }`. `confirm: { message, title?, variant?, confirmLabel? }` routes through `lia-confirm-dialog` before the event fires when `installConfirmHandler()` is installed once at the app root; without it the action falls back to native browser confirmation — identically in page headings, table rows and bulk bars. - **Events** — all named `lia-*`, bubbling and composed. Global map includes `lia-action`, `lia-submit` (`{ values }`), `lia-change`, `lia-sort`, `lia-page-change`, `lia-search`, `lia-selection-change`, `lia-columns-change`, `lia-navigate` (`{ url, item? }`), `lia-dismiss`. - **`Variant`** — Bootstrap contextual colors `primary | secondary | success | danger | warning | info | light | dark` (actions also take `outline-*`). **`Size`** — `sm | md | lg`. Icons are icon-font class strings, e.g. `fa-solid fa-user`. - **Dark mode** — Bootstrap 5.3 `data-bs-theme` on ``. `initTheme()` applies the stored preference (`lia-color-scheme`, `light|dark|auto`) and tracks the OS on `auto`; `applyScheme()` sets it and fires `lia-theme-change` on `window`; `lia-theme-toggle` is the user switch. Never toggle theme classes by hand. diff --git a/plugins/lit-ui/skills/primitives/SKILL.md b/plugins/lit-ui/skills/primitives/SKILL.md index d422f55..97d7659 100644 --- a/plugins/lit-ui/skills/primitives/SKILL.md +++ b/plugins/lit-ui/skills/primitives/SKILL.md @@ -17,7 +17,7 @@ These are the blocks every other family composes. Prefer them over hand-rolled B - Copy-to-clipboard → `lia-copy-button`. Identifier that explains itself on hover → `lia-lookup`. - Hot paths (table cells, hundreds of rows): use the inline helpers `renderIcon()`, `renderBadge()`, `renderAction()`/`renderActions()`, `renderSpinner()` instead of instantiating elements. -Actions with `confirm:` compose with the feedback family's `lia-confirm-dialog`; without one on the page, the browser's native `confirm()` is the fallback. +Actions with `confirm:` open the feedback family's `lia-confirm-dialog` once `installConfirmHandler()` is installed at the app root; without it, the browser's native `confirm()` is the fallback. ## Setup @@ -25,7 +25,7 @@ Actions with `confirm:` compose with the feedback family's `lia-confirm-dialog`; ## ActionDescriptor — the shared contract -Every action button in the kit is data: `{ id, label, icon, href, target, title, variant, size, visible, disabled, confirm, modal, labelResponsive, back, data }` (all optional; `visible !== false` shows). `href` renders an `` and navigates; `modal: { id, title, ... }` wires `data-bs-toggle="modal"` (no event fires); `back: true` steps history back. Triggering emits a **cancelable** `lia-action` (`detail: { action, id, row, index }` — cancel it to suppress navigation). With `confirm: { message, title?, confirmLabel?, cancelLabel?, variant? }`, a cancelable `lia-action-confirm-request` fires first (`detail` adds `confirm`, `accept()`, `cancel()`); a confirm dialog claims it via `preventDefault()`, else native `confirm()` runs. `renderAction(action, { host, size, variant, row, index, loading })` and `renderActions([...])` emit this markup inline. +Every action button in the kit is data: `{ id, label, icon, href, target, title, variant, size, visible, disabled, confirm, modal, labelResponsive, back, data }` (all optional; `visible !== false` shows). `href` renders an `` and navigates; `modal: { id, title, ... }` wires `data-bs-toggle="modal"` (no event fires); `back: true` steps history back. Triggering emits a **cancelable** `lia-action` (`detail: { action, id, row, index }` — cancel it to suppress navigation). With `confirm: { message, title?, confirmLabel?, cancelLabel?, variant? }`, a cancelable `lia-action-confirm-request` fires first (`detail` adds `confirm`, `accept()`, `cancel()`); `installConfirmHandler()` claims it via `preventDefault()` and opens `lia-confirm-dialog`, else native `confirm()` runs. `renderAction(action, { host, size, variant, row, index, loading })` and `renderActions([...])` emit this markup inline. ## Component reference @@ -40,7 +40,7 @@ html` +
@@ -115,7 +115,7 @@ html`` renders a filtered stack of setting groups, a rail of section anchors that follows the scroll, and a single save/reset bar. Prefer it over composing `` + hand-rolled anchors whenever a page has more than one titled block of settings. The pieces are usable alone: `` for a single titled block inside your own `
`, `` as an anchor rail for *any* page of titled sections. -This family composes with the **form** family: every group embeds a `FormDefinition` (same `sections.fields` shape, same field types, same validation), and the page's API mirrors `` — `getValues()`, `setValues()`, `reset()`, `validate()`, `rules`, `messages`, `buttons`, `errors`. It also uses `` (heading + `ActionDescriptor[]` toolbar), `` (`AlertMessage[]` via `.alerts`), and `` internally. +This family composes with the **form** family: every group embeds a `FormDefinition` (same `sections.fields` shape, same field types, same synchronous validation; async rules are not run here), and the page's API mirrors `` — `getValues()`, `setValues()`, `reset()`, `validate()` (synchronous, returns `FormErrors`), `rules`, `messages`, `buttons`, `errors`. It also uses `` (heading + `ActionDescriptor[]` toolbar), `` (`AlertMessage[]` via `.alerts`), and `` internally. ## Setup diff --git a/plugins/lit-ui/skills/table/SKILL.md b/plugins/lit-ui/skills/table/SKILL.md index 5c2c131..c0c2568 100644 --- a/plugins/lit-ui/skills/table/SKILL.md +++ b/plugins/lit-ui/skills/table/SKILL.md @@ -57,7 +57,7 @@ html`` — local array -Takes `.columns` and `.rows` as flat properties (no listing object) plus `listing-id`, `per-page` (0 = one page), `.rowActions`, `.rowKey`, `.rowClass`, `.rowDetail`, `.expandedKeys`, `.revealKey`, `selectable`, `.bulkActions`, `.sort`, `.search`, `.help`, `.compare`, `.match`, `.cellValueFor`, `no-search`, `no-column-manager`, and the same chrome props as `lia-table` (`show-summary` defaults **true** here). The same events still fire, so you can observe what it did. Imperative API: `setPage()`, `setSort()`, `setSearch()`, `pageForKey(key)`. +Takes `.columns` and `.rows` as flat properties (no listing object) plus `listing-id`, `per-page` (0 = one page), `.rowActions`, `.rowKey`, `.rowClass`, `.rowDetail`, `.expandedKeys`, `.revealKey`, `selectable`, `.bulkActions`, `.sort`, `.search`, `.help`, `.compare`, `.match`, `.cellValueFor`, `no-search`, `no-column-manager`, and the chrome props `loading`, `compact`, `striped`, `hover`, `caption`, `empty-title`, `empty-message`, `.emptyActions`, `server`, `server-toggle`, `storage-key`, `.visibleColumns`, `show-summary` (defaults **true** here), `show-per-page`, `.labels`, `.format`. It does not expose `lia-table`'s `attached` (inside a `lia-card` the inner table still attaches on its own), `allow-unsorted`, `caption-hidden`, `skeleton-rows`, `hide-pagination`, `empty-icon` or `.selectedKeys`; selection is uncontrolled. The same events still fire, so you can observe what it did. Imperative API: `setPage()`, `setSort()`, `setSearch()`, `pageForKey(key)`. ```ts html` template`) is fully controlled through `expandedKeys` — the table renders the region but never opens or closes it; toggle from your own trigger (typically a row action updating `expandedKeys`). Never sorted/searched/paged; follows its row through re-sorts via `rowKey`. `revealKey` jumps `lia-data-table` to the page containing a key (requires `rowKey`). -- **Sort cycle** is asc → desc → unsorted; unsorted arrives as `{ field: '' }`. Set `allow-unsorted="false"` if your backend cannot return insertion order. +- **Sort cycle** is asc → desc → unsorted; unsorted arrives as `{ field: '' }`. On `lia-table`, set `allow-unsorted="false"` if your backend cannot return insertion order. - Inside a `` the table auto-detects `attached` mode: no second card, tool strip handed to the card header. diff --git a/src/components/layout/navbar.ts b/src/components/layout/navbar.ts index 31ce6c4..2ee8c62 100644 --- a/src/components/layout/navbar.ts +++ b/src/components/layout/navbar.ts @@ -133,8 +133,14 @@ export class LiaNavbar extends LiaElement { this.slotted.pause(); } - protected override updated(_changed: PropertyValues): void { + protected override updated(changed: PropertyValues): void { this.slotted.resume(); + // The search row only exists while search is enabled. + if (changed.has('searchEnabled') && changed.get('searchEnabled') !== undefined) { + this.collapse?.dispose(); + this.collapse = undefined; + this.initPlugins(); + } } protected override firstUpdated(): void { @@ -268,7 +274,11 @@ export class LiaNavbar extends LiaElement { ${this.renderBrand()} -
+
- + > +
` + : nothing} `; } diff --git a/src/components/primitives/lia-action-bar.ts b/src/components/primitives/lia-action-bar.ts index d0cd979..7d4c646 100644 --- a/src/components/primitives/lia-action-bar.ts +++ b/src/components/primitives/lia-action-bar.ts @@ -4,6 +4,7 @@ import { LiaElement } from '../../core/base-element.js'; import { cx } from '../../core/utils.js'; import type { ActionDescriptor, Size, Variant } from '../../core/types.js'; import { isActionVisible, renderAction } from './render-action.js'; +import { flag } from '../layout/flag.js'; /** Horizontal distribution of the controls inside the bar. */ export type ActionBarAlign = 'start' | 'center' | 'end' | 'between'; @@ -53,8 +54,8 @@ export class LiaActionBar extends LiaElement { /** Fallback variant for actions that do not set their own. */ @property({ type: String }) variant: Variant | `outline-${Variant}` = 'outline-primary'; - /** Hide labels below `lg`, keeping the icons. */ - @property({ type: Boolean, attribute: 'label-responsive' }) labelResponsive = true; + /** Hide labels below `lg`, keeping the icons. `label-responsive="false"` turns it off. */ + @property({ converter: flag, attribute: 'label-responsive' }) labelResponsive = true; /** Accessible name for the group. */ @property({ type: String }) label = 'Actions'; diff --git a/src/components/primitives/render-action.ts b/src/components/primitives/render-action.ts index 0cd6938..8f0e11d 100644 --- a/src/components/primitives/render-action.ts +++ b/src/components/primitives/render-action.ts @@ -263,8 +263,13 @@ export function renderAction( const inner = html`${glyph}${actionLabel(action, responsive)}`; const onClick = (event: Event): void => handleActionEvent(action, options, event); - // An icon-only control still needs an accessible name. - const ariaLabel = action.label ? undefined : (action.title ?? action.id); + // An icon-only control still needs an accessible name, and so does one whose + // label is hidden below `lg`. + const ariaLabel = action.label + ? responsive + ? action.label + : undefined + : (action.title ?? action.id); if (action.modal) { const target = `#${action.modal.id}`;