• v0.44.1 5601f3d023

    v0.44.1 Stable

    pienter-release-bot released this 2026-11-21 22:37:54 +00:00 | 2 commits to main since this release

    Fixed

    • useRecordForm's bind types modelValue and baseline as the record
      (PUI-124). They were typed record-or-undefined, which RecordForm's required
      modelValue rejects, so a form without initial failed vue-tsc on
      v-bind="form.bind". Spread bind only where model is set
      (v-else-if="model" when there is no initial). RecordFormBinding loses
      its second type parameter.
    Downloads
  • v0.44.0 6802ee5b7b

    v0.44.0 Stable

    pienter-release-bot released this 2026-11-20 23:01:14 +00:00 | 7 commits to main since this release

    Changed

    • Form and RecordForm no longer move focus or announce the error count
      on every fieldErrors or issues change. A submit's response always
      focuses and announces; otherwise only errors not there before do: for Form
      a fieldErrors entry that differs from the previous one for that field,
      for RecordForm an issue object the previous issues lacked. 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, skipping hidden tab 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 with v-model (PUI-112), replacing hand-built row lists. The app
      supplies create() for new rows and each row's content through the row
      slot; rows carry a key (id, or itemKey). 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, and min and max disable Remove and
      Add at the limit. issues take full paths, with path naming 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's issues still hold them. Rows whose keys are
      empty or repeated log a warning. With
      a path, 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 new repeater messages section, English and Dutch.
    • RecordForm and RecordFields take a list field, { 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 except list and custom), named by their
      full path, so revealField and 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. RecordListRowField is exported from RecordForm.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
      returns model, baseline, dirty (isEqualRecord), loading,
      loadError, busy, issues, errors, submit(input), reload(),
      reset(), clearIssues(path) and bind, which
      <RecordForm v-bind="form.bind" :fields> spreads for the model, baseline,
      issues, errors, busy and the submit, update and field-change listeners.
      clearIssues, the field-change listener, 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. load runs at
      setup and on reload(), setting loading and busy; without it, or when
      it returns undefined, the form starts from initial, a value being
      copied so model edits never reach it. A record resolved by save replaces model and baseline,
      otherwise the submitted input becomes the baseline; a failure fills
      issues and errors through formFailure(error, failure). The latest
      result wins: reload() and unmounting make a running load or save stale,
      a stale result changes nothing, and submit while busy is ignored.
      onLoaded(record) and onSaved(record) run for current results only. It
      announces nothing and leaves useUnsavedChanges to the page. The form
      messages gain loadFailed and saveFailed, the fallbacks when the error
      is not an Error and no failure is given.
    Downloads
  • v0.43.0 964a9f35b7

    v0.43.0 Stable

    pienter-release-bot released this 2026-11-19 12:54:55 +00:00 | 37 commits to main since this release

    Breaking

    • useUrlTab now returns { tab, select } instead of the writable computed
      itself (PUI-80). tab is that computed, unchanged; select(key) writes the
      key like assigning tab.value but returns a promise that resolves once the
      navigation finished and the DOM shows the tab, so a revealField callback
      can await select('seo'). The exported UrlTab type describes the pair.
      To migrate, destructure it under your existing name,
      const { tab: activeTab } = useUrlTab(...); templates and .value reads
      stay as they are.

    Added

    • RecordForm takes an optional revealField(path, { signal }) callback
      (PUI-80), so a page no longer watches issues to switch tabs or open
      blocks before the form's focus. With it, RecordForm picks the first
      invalid field in fields order, 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. RevealField is exported from
      RecordForm.types, and a media field's fieldset now carries the field's
      name so it can be found. Before focusing, RecordForm also waits for a
      just-revealed RichText or MediaField that is still loading its chunk.

    Fixed

    • BlockEditor no 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
      revealField right 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
  • v0.42.0 ccc11790b6

    v0.42.0 Stable

    pienter-release-bot released this 2026-11-19 12:23:43 +00:00 | 59 commits to main since this release

    Added

    • Access forms (PUI-85): LoginForm, RegistrationForm,
      PasswordResetRequestForm and NewPasswordForm, the standard forms an
      application places in AccessPage's main slot. Login defaults to email and
      password and takes identifier="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 composes Form: built-in required, email-format and
      matching-confirmation checks, application validators after them,
      application fields in the default slot, and busy, errors,
      fieldErrors and statusMessage supplied by the application and shown
      verbatim. A form emits submit(values, formData) and never sends a
      request, stores a credential or redirects; while busy it does not submit
      again. Registration, recovery and login links render only when the
      application passes their href, and the link slot takes a router link.
      The new access message section holds their English and Dutch wording; the
      labels prop overrides it per form. Value and slot types ship as
      AccessForm.types.
    Downloads
  • v0.41.0 30617d8d0a

    v0.41.0 Stable

    pienter-release-bot released this 2026-11-18 21:35:48 +00:00 | 77 commits to main since this release

    Added

    • 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. The brand and aside slots fill an
      identity panel beside unboxed, width-constrained main content (the default
      slot, the page's only <main>), with a footer slot 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 library Form or any application content.
      pui-access-page__heading, __title, __description and __tagline are
      public child classes for the page copy, and
      --pui-access-page-content-inline-size sets the main content's width.
    Downloads
  • v0.40.0 0b47f881b9

    v0.40.0 Stable

    pienter-release-bot released this 2026-11-05 21:21:41 +00:00 | 92 commits to main since this release

    Added

    • Media library, picking half (PUI-95). A record form declares
      { type: 'media', collection, multiple?, max? } and RecordFields
      renders MediaField: thumbnail rows for the stored snapshot, remove and
      reorder, and a Choose button opening MediaPicker, a large Modal
      around MediaBrowser in 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; max caps a
      multiple pick. The field stores MediaFieldValue snapshots, null or an
      array, and never refreshes them. createMedia({ api, collections }) is
      installed once (@[secure]/ui/media) and read by useMedia();
      MediaBrowser, MediaPicker and MediaGrid take api and collection
      as props so a page composes them without it. Media.types types the whole
      MediaApi (collection-scoped folder, file, upload, move, delete and
      folder calls, every read with an AbortSignal), docs/cms/backend-contract.md
      and schema.json gain 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_use and
      folder_not_empty codes, and the media message section covers every
      string in English and Dutch. MediaTile stays internal behind the grid's
      #tile slot. Six file-kind icons join the set: file-text,
      file-spreadsheet, file-archive, presentation, video, music.
    • Modal gains size: 'md' | 'lg' (default md); lg widens 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
  • v0.39.0 440dcf7fd8

    v0.39.0 Stable

    pienter-release-bot released this 2026-10-06 12:49:03 +00:00 | 96 commits to main since this release

    Added

    • 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. New navigation, aside, toast, dialog and command
      sections complete the library's message coverage; explicit label props still
      win and unconfigured apps stay English.
    Downloads
  • v0.38.0 170a6fe8be

    v0.38.0 Stable

    pienter-release-bot released this 2026-09-23 20:51:46 +00:00 | 102 commits to main since this release

    Added

    • 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
  • v0.37.0 db25a5cec8

    v0.37.0 Stable

    pienter-release-bot released this 2026-09-23 20:46:28 +00:00 | 108 commits to main since this release

    Added

    • 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
  • v0.36.0 c42b8acb91

    v0.36.0 Stable

    pienter-release-bot released this 2026-09-22 21:27:00 +00:00 | 116 commits to main since this release

    Added

    • TreeIndex gains search and filters that dim rather than remove (ADR 0012).
      Given queryOptions (or a state from useIndexQuery, which no longer
      needs a load), it owns the same query state as Index and provides it, so
      FilterCheckbox, FilterSelect, FilterMultiSelect, FilterRange, the
      search box, the filters slot and the active-filter chips work unchanged,
      in a page aside included, with syncQuery keeping the URL. It never reloads
      for a query: it emits query with the committed search and filters
      (TreeQuery), the project answers with matching, a set of row keys, and
      every row outside the set is dimmed (data-dimmed on 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
      are matchLabels. TreeTable takes the same matching and matchLabels
      for controlled data.
    Downloads