-
v0.44.1 Stable
released this
2026-11-21 22:37:54 +00:00 | 2 commits to main since this releaseFixed
useRecordForm'sbindtypesmodelValueandbaselineas the record
(PUI-124). They were typed record-or-undefined, which RecordForm's required
modelValuerejects, so a form withoutinitialfailed vue-tsc on
v-bind="form.bind". Spreadbindonly wheremodelis set
(v-else-if="model"when there is noinitial).RecordFormBindingloses
its second type parameter.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
v0.44.0 Stable
released this
2026-11-20 23:01:14 +00:00 | 7 commits to main since this releaseChanged
FormandRecordFormno longer move focus or announce the error count
on everyfieldErrorsorissueschange. A submit's response always
focuses and announces; otherwise only errors not there before do: for Form
afieldErrorsentry that differs from the previous one for that field,
for RecordForm an issue object the previousissueslacked. Clearing one
field's issue while the user types, or passing a rebuilt array of the same
issues, no longer pulls focus away or interrupts with an assertive
announcement.
Added
PanelGroup(PUI-10), exported as
@[secure]/ui/components/PanelGroup.vue, joins the Panels inside it into one
bordered surface: each Panel drops its own border, radius and background,
keeps its title above its fields, and a divider separates consecutive
visible Panels, skippinghiddentab panels. It renders a plain<div>
with only a default slot and adds no role, so the Panels keep their section
and heading semantics. A Panel around an editable BlockEditor keeps the
panel padding inside the group, so its blocks don't touch the group border.
Panels outside a PanelGroup and the field look are unchanged.Repeater(@[secure]/ui/components/Repeater.vue) edits an array of like
rows withv-model(PUI-112), replacing hand-built row lists. The app
suppliescreate()for new rows and each row's content through therow
slot; rows carry a key (id, oritemKey). Each row is a fieldset named by
rowLabel(row, index), "Item n" by default, with its fields in one grid
that wraps on narrow screens. Up and down buttons move a row and Remove
deletes it at once, both announced, with focus following the row; Add
focuses the new row's first control, andminandmaxdisable Remove and
Add at the limit.issuestake full paths, withpathnaming the list
in them, and each issue object stays with the row it was first filed under
through adds, removes and moves, so filtering issues out or rebuilding the
array keeps the rest on their rows; a removed row's issues stop showing in
the list, though the caller'sissuesstill hold them. Rows whose keys are
empty or repeated log a warning. With
apath, the list and each row fieldset are named by their path, and a row
with issues of its own is marked invalid.
Wording is in the newrepeatermessages section, English and Dutch.RecordFormandRecordFieldstake alistfield,{ type: 'list', name, label, fields, create, itemKey?, min?, max?, rowLabel?, addLabel? }, built
on Repeater. Row fields use paths relative to the row and render as the
built-in controls (any type exceptlistandcustom), named by their
full path, sorevealFieldand RecordForm's focus reach an invalid row
field, and an issue on a row itself (['social_links', 1]) focuses that
row. RecordForm's focus also finds a row that moved after its issue
arrived.RecordListRowFieldis exported fromRecordForm.types. The
error summary is unchanged.useRecordForm(@[secure]/ui/composables/useRecordForm) owns a
RecordForm's load and save (PUI-113), replacing the revision counter and
the hand-written busy, baseline and failure code of each form page. It
returnsmodel,baseline,dirty(isEqualRecord),loading,
loadError,busy,issues,errors,submit(input),reload(),
reset(),clearIssues(path)andbind, which
<RecordForm v-bind="form.bind" :fields>spreads for the model, baseline,
issues, errors, busy and the submit, update andfield-changelisteners.
clearIssues, thefield-changelistener, drops the issues at the changed
path and its parents (the field's row and list) and keeps the other issue
objects, so the rest stay on their rows and move no focus.loadruns at
setup and onreload(), settingloadingandbusy; without it, or when
it returnsundefined, the form starts frominitial, a value being
copied so model edits never reach it. A record resolved bysavereplaces model and baseline,
otherwise the submitted input becomes the baseline; a failure fills
issuesanderrorsthroughformFailure(error, failure). The latest
result wins:reload()and unmounting make a running load or save stale,
a stale result changes nothing, andsubmitwhile busy is ignored.
onLoaded(record)andonSaved(record)run for current results only. It
announces nothing and leavesuseUnsavedChangesto the page. Theform
messages gainloadFailedandsaveFailed, the fallbacks when the error
is not anErrorand nofailureis given.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
v0.43.0 Stable
released this
2026-11-19 12:54:55 +00:00 | 37 commits to main since this releaseBreaking
useUrlTabnow returns{ tab, select }instead of the writable computed
itself (PUI-80).tabis that computed, unchanged;select(key)writes the
key like assigningtab.valuebut returns a promise that resolves once the
navigation finished and the DOM shows the tab, so arevealFieldcallback
canawait select('seo'). The exportedUrlTabtype describes the pair.
To migrate, destructure it under your existing name,
const { tab: activeTab } = useUrlTab(...); templates and.valuereads
stay as they are.
Added
RecordFormtakes an optionalrevealField(path, { signal })callback
(PUI-80), so a page no longer watchesissuesto switch tabs or open
blocks before the form's focus. With it, RecordForm picks the first
invalid field infieldsorder, even when hidden, passes the issue's full
path (['sections', 2, 'title']) to the callback, awaits it, and focuses
that field's control, or the element the callback returns for a custom or
portalled control. A rejection or an unavailable control focuses the error
summary; issues without a declared field focus the summary without calling
the callback. New issues, cleared issues and unmounting abort the signal,
and a superseded call never moves focus. Form's own first-invalid focus
stands down while RecordForm owns it; plain Form and RecordForm without the
callback are unchanged.RevealFieldis exported from
RecordForm.types, and amediafield's fieldset now carries the field's
nameso it can be found. Before focusing, RecordForm also waits for a
just-revealed RichText or MediaField that is still loading its chunk.
Fixed
BlockEditorno longer re-measures while it sits in a hidden tab panel
(PUI-80). Its zero width read as narrow, so an open block moved into a
modal Sheet nobody could see and the page went inert; opening a block from
revealFieldright after showing the tab hit the same stale layout. It now
keeps the last layout measured while visible, and measures when a block
opens, so a block opened just as a narrowed editor appears goes straight
into the Sheet and keeps the focus RecordForm gave its invalid field. A
block already open when the layout flips between split and Sheet keeps
focus on the same named control instead of jumping to its first field.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
v0.42.0 Stable
released this
2026-11-19 12:23:43 +00:00 | 59 commits to main since this releaseAdded
- Access forms (PUI-85):
LoginForm,RegistrationForm,
PasswordResetRequestFormandNewPasswordForm, the standard forms an
application places inAccessPage's main slot. Login defaults to email and
password and takesidentifier="username"for a username field without
email validation; registration has name, email, password and confirmation;
the reset request has email; the new-password form has password and
confirmation. Each composesForm: built-in required, email-format and
matching-confirmation checks, applicationvalidatorsafter them,
application fields in the default slot, andbusy,errors,
fieldErrorsandstatusMessagesupplied by the application and shown
verbatim. A form emitssubmit(values, formData)and never sends a
request, stores a credential or redirects; whilebusyit does not submit
again. Registration, recovery and login links render only when the
application passes theirhref, and thelinkslot takes a router link.
The newaccessmessage section holds their English and Dutch wording; the
labelsprop overrides it per form. Value and slot types ship as
AccessForm.types.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Access forms (PUI-85):
-
v0.41.0 Stable
released this
2026-11-18 21:35:48 +00:00 | 77 commits to main since this releaseAdded
AccessPage, the Access Page Skeleton (PUI-84): the split-branding frame
chosen in PUI-2 for login, registration, password recovery and any
application-defined access page. Thebrandandasideslots fill an
identity panel beside unboxed, width-constrained main content (the default
slot, the page's only<main>), with afooterslot below it. Below 56em
the brand becomes a strip above the main content and the supporting panel
is hidden, so instructions and actions belong in the main slot. The
skeleton adds no fields, form, requests or authentication state; the main
slot takes a libraryFormor any application content.
pui-access-page__heading,__title,__descriptionand__taglineare
public child classes for the page copy, and
--pui-access-page-content-inline-sizesets the main content's width.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
v0.40.0 Stable
released this
2026-11-05 21:21:41 +00:00 | 92 commits to main since this releaseAdded
- Media library, picking half (PUI-95). A record form declares
{ type: 'media', collection, multiple?, max? }andRecordFields
rendersMediaField: thumbnail rows for the stored snapshot, remove and
reorder, and a Choose button openingMediaPicker, a largeModal
aroundMediaBrowserin pick mode with folders, search, sort, grid or
list layout, and upload into the current folder with per-file progress,
cancel and retry (a finished upload joins the selection). The selection
is a list of ids, so it survives paging and folder changes;maxcaps a
multiple pick. The field storesMediaFieldValuesnapshots,nullor an
array, and never refreshes them.createMedia({ api, collections })is
installed once (@[secure]/ui/media) and read byuseMedia();
MediaBrowser,MediaPickerandMediaGridtakeapiandcollection
as props so a page composes them without it.Media.typestypes the whole
MediaApi(collection-scoped folder, file, upload, move, delete and
folder calls, every read with anAbortSignal),docs/cms/backend-contract.md
andschema.jsongain the folder tree, file list (filter[folder],
search,sort), file, collection-count and upload shapes with the
validation_error,not_found,too_large,unsupported_type,in_useand
folder_not_emptycodes, and themediamessage section covers every
string in English and Dutch.MediaTilestays internal behind the grid's
#tileslot. Six file-kind icons join the set:file-text,
file-spreadsheet,file-archive,presentation,video,music. Modalgainssize: 'md' | 'lg'(defaultmd);lgwidens the dialog
to--container-width-lg. The open dialog's body now scrolls with the
title and footer pinned instead of the whole dialog scrolling.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Media library, picking half (PUI-95). A record form declares
-
v0.39.0 Stable
released this
2026-10-06 12:49:03 +00:00 | 96 commits to main since this releaseAdded
- AppLayout, Sidebar, Navbar, Breadcrumb, PageAside, Toast/ToastHost,
AlertDialog and Command now use shared English/Dutch messages for landmarks,
skip link, drawer and group toggles, notifications, dialog actions and the
command palette. Newnavigation,aside,toast,dialogandcommand
sections complete the library's message coverage; explicit label props still
win and unconfigured apps stay English.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- AppLayout, Sidebar, Navbar, Breadcrumb, PageAside, Toast/ToastHost,
-
v0.38.0 Stable
released this
2026-09-23 20:51:46 +00:00 | 102 commits to main since this releaseAdded
- Form, RecordForm/RecordFields, BlockEditor, RichText and field controls now
use shared English/Dutch messages for actions, validation counts, accessible
names and later editing/reorder announcements. Existing explicit wording,
slots, application content and backend errors retain precedence. createValidators(messages.validation)selects plain validation-helper
messages explicitly outside Vue. Existing helpers remain English by default
and accept custom strings; singular counts use singular wording.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Form, RecordForm/RecordFields, BlockEditor, RichText and field controls now
-
v0.37.0 Stable
released this
2026-09-23 20:46:28 +00:00 | 108 commits to main since this releaseAdded
- Per-Vue-app library messages via
@[secure]/ui/messages: English and Dutch
dictionaries, typed partial overrides, named-input dynamic phrases and an
explicit resolver for plain helpers. Configure once before mounting; no
configuration keeps English and apps cannot share configuration state. - Index, TreeIndex, DataTable, TreeTable, active filters, index-filter controls
and Pagination now use shared wording, including query diagnostics,
error/retry/reset UI and move/match announcements. Existing explicit wording
and slots still win; application/backend content is unchanged. Other component
families are not yet localized.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Per-Vue-app library messages via
-
v0.36.0 Stable
released this
2026-09-22 21:27:00 +00:00 | 116 commits to main since this releaseAdded
TreeIndexgains search and filters that dim rather than remove (ADR 0012).
GivenqueryOptions(or astatefromuseIndexQuery, which no longer
needs aload), it owns the same query state asIndexand provides it, so
FilterCheckbox,FilterSelect,FilterMultiSelect,FilterRange, the
search box, thefiltersslot and the active-filter chips work unchanged,
in a page aside included, withsyncQuerykeeping the URL. It never reloads
for a query: it emitsquerywith the committedsearchandfilters
(TreeQuery), the project answers withmatching, a set of row keys, and
every row outside the set is dimmed (data-dimmedon the row), keeps its
move button and stays offered as a destination, so the tree keeps its shape.
The match count is announced through the table's live region and a dimmed
row's header carries a visually hidden "Does not match." cue; both strings
arematchLabels.TreeTabletakes the samematchingandmatchLabels
for controlled data.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads