Skip to content

feat: add HelperText input primitive#646

Open
isaquebock wants to merge 16 commits into
devfrom
feat/inputs-helper-text
Open

feat: add HelperText input primitive#646
isaquebock wants to merge 16 commits into
devfrom
feat/inputs-helper-text

Conversation

@isaquebock

Copy link
Copy Markdown
Contributor

Summary

Introduce @aziontech/webkit/inputs/helper-text — auxiliary text below a form field, with a kind prop that drives the visual tone:

  • helper (default) — muted, neutral copy.
  • required — warning-tone copy paired with the Required tag treatment.
  • invalid — danger-tone copy for validation errors; usually wired to aria-describedby on the input.
  • disabled — muted with a leading lock icon.

The component is the helper line only — wrapping form-field components own the wiring of aria-describedby and the conditional rendering.

Test plan

  • pnpm --filter @aziontech/webkit lint — clean.
  • Storybook → Webkit/Inputs/HelperText → all four kind variants render with the expected tokens.

Introduce `@aziontech/webkit/inputs/helper-text` — a small text element
that renders auxiliary copy below a form field. The `kind` prop drives
the visual tone:

- `helper` (default): muted token, neutral copy.
- `required`: warning-tone copy paired with the Required tag treatment.
- `invalid`: danger-tone copy for validation errors; usually wired to
  `aria-describedby` on the input.
- `disabled`: muted with a leading lock icon.

The component is the helper line only — wrapping form-field components
own the wiring of `aria-describedby` and the conditional rendering.
@isaquebock isaquebock requested a review from a team as a code owner June 17, 2026 17:46
@isaquebock isaquebock marked this pull request as draft June 17, 2026 17:55
@isaquebock isaquebock marked this pull request as ready for review June 18, 2026 18:58
HerbertJulio
HerbertJulio previously approved these changes Jun 22, 2026
@isaquebock isaquebock changed the base branch from main to dev June 24, 2026 15:33
@isaquebock isaquebock dismissed HerbertJulio’s stale review June 24, 2026 15:33

The base branch was changed.

pauloSF0
pauloSF0 previously approved these changes Jun 24, 2026
HerbertJulio
HerbertJulio previously approved these changes Jun 24, 2026
@isaquebock isaquebock dismissed stale reviews from HerbertJulio and pauloSF0 via 77abddc June 25, 2026 13:35
HerbertJulio
HerbertJulio previously approved these changes Jun 25, 2026
Comment thread .specs/helper-text.md Outdated
Comment thread packages/webkit/src/components/inputs/helper-text/helper-text.vue Outdated
HerbertJulio
HerbertJulio previously approved these changes Jun 25, 2026
HerbertJulio added a commit that referenced this pull request Jun 25, 2026
… not undefined (#671)

* [NO-ISSUE] chore(specs): default optional text props to empty string, not undefined

Optional string props that hold renderable text now default to '' across the spec template, the spec-create / component-scaffold skills, and the scaffolder agent. Reserve undefined (unquoted) for props where absence differs from empty (open, modelValue, src); never the literal 'undefined'. Prevents the default-value issue raised in review of PR #646.

* [NO-ISSUE] chore(specs): reject string-literal 'undefined' in spec Default cells

Enforces the empty-string default convention documented earlier in this PR via
spec-validate Step 3 plus a shared defaultCellIsStringUndefined helper and a unit
test; status:implemented specs (checkbox/dropdown) are not re-validated so they stay green.

---------

Co-authored-by: ROBSON.JUNIOR <robsongajunior@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

4 participants