@alexandregme/zljs 1.11.0 → 1.12.0

package/CHANGELOG.md

@@ -8,6 +8,34 @@ A change that needs action in an app has a **Migration** note. When updating, re
 
 ## [Unreleased]
 
+## [1.12.0] - 2026-11-02
+
+### Added
+
+- `TextArea` takes `aria-label`, `name`, `autoComplete`, `required`, `onBlur`, `onKeyDown` and `ref`, as `Input` and `Select` do, so it works with `register` from `react-hook-form`
+
+### Changed
+
+- `TextArea` requires `label` or `aria-label` in its type, instead of always `label`
+- `TextArea` draws a real `focus-visible` outline in the theme's `primary` color instead of a `focus:ring`, so focus stays visible in forced colors mode, and an app's own color reaches it
+- `TextArea` border is now `gray-500` instead of `gray-300`, for 3:1 contrast, and its placeholder is `gray-500`, for 4.5:1
+
+### Fixed
+
+- `TextArea` with `error` sets `aria-invalid` and points `aria-describedby` to the message, so a screen reader announces both
+- `TextArea` uses `resize-y`. It had a class that doesn't exist in Tailwind, so it only resized vertically in apps with Tailwind's base styles
+
+#### Migration
+
+Only code that extends `TextAreaProps` and tests that assert its old classes need a change. To find them, run the commands below from the app's root:
+
+```sh
+grep -rnE "\bTextAreaProps\b" . --include='*.ts' --include='*.tsx' --exclude-dir=node_modules --exclude-dir=.next
+grep -rnE "border-gray-300|focus:ring-blue-500|focus:border-transparent|resize-vertical" . --include='*.test.*' --exclude-dir=node_modules --exclude-dir=.next
+```
+
+Replace `interface X extends TextAreaProps` with `type X = TextAreaProps & { ... }`, because `TextAreaProps` is now a union. In tests, replace those classes with `focus-visible:outline-zl-primary`, `border-gray-500` and `resize-y`.
+
 ## [1.11.0] - 2026-11-02
 
 ### Added
@@ -106,7 +134,8 @@ Replace the shade with the class of the `color` being tested, for example `/(^|\
 
 The message of `Error` is `text-zl-danger`. `none` and `ghost` didn't change.
 
-[Unreleased]: https://github.com/alexandregme/zljs/compare/v1.11.0...HEAD
+[Unreleased]: https://github.com/alexandregme/zljs/compare/v1.12.0...HEAD
+[1.12.0]: https://github.com/alexandregme/zljs/compare/v1.11.0...v1.12.0
 [1.11.0]: https://github.com/alexandregme/zljs/compare/v1.10.0...v1.11.0
 [1.10.0]: https://github.com/alexandregme/zljs/compare/v1.9.0...v1.10.0
 [1.9.0]: https://github.com/alexandregme/zljs/compare/v1.8.0...v1.9.0

package/dist/index.d.ts

@@ -160,17 +160,29 @@ type SelectProps = SelectName & {
 
 declare const Select: ({ label: labelText, "aria-label": ariaLabel, name, options, placeholder, autoComplete, value, error, disabled, required, onChange, onBlur, onKeyDown, ref, }: SelectProps) => react.JSX.Element;
 
-interface TextAreaProps {
+type TextAreaName = {
     label: string;
+    "aria-label"?: string;
+} | {
+    label?: undefined;
+    "aria-label": string;
+};
+type TextAreaProps = TextAreaName & {
+    name?: string;
     placeholder?: string;
+    autoComplete?: HTMLInputAutoCompleteAttribute;
     value?: string;
     rows?: number;
     error?: string;
     disabled?: boolean;
+    required?: boolean;
     onChange?: (event: ChangeEvent<HTMLTextAreaElement>) => void;
-}
+    onBlur?: (event: FocusEvent<HTMLTextAreaElement>) => void;
+    onKeyDown?: (event: KeyboardEvent<HTMLTextAreaElement>) => void;
+    ref?: Ref<HTMLTextAreaElement>;
+};
 
-declare const TextArea: ({ label: labelText, placeholder, value, rows, error, disabled, onChange, }: TextAreaProps) => react.JSX.Element;
+declare const TextArea: ({ label: labelText, "aria-label": ariaLabel, name, placeholder, autoComplete, value, rows, error, disabled, required, onChange, onBlur, onKeyDown, ref, }: TextAreaProps) => react.JSX.Element;
 
 declare const Icon: ({ name, size, "aria-label": ariaLabel, }: IconProps) => react.JSX.Element;
 

package/dist/index.js

@@ -421,36 +421,53 @@ var label4 = tv6({
   base: "text-sm font-medium text-gray-700"
 });
 var textarea = tv6({
-  base: "px-3 py-2 border border-gray-300 rounded-md text-sm resize-vertical focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent disabled:bg-gray-100 disabled:cursor-not-allowed"
+  base: "px-3 py-2 border border-gray-500 rounded-md text-sm placeholder:text-gray-500 resize-y focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-zl-primary disabled:bg-gray-100 disabled:cursor-not-allowed"
 });
 
 // core/forms/text-area/text-area.tsx
 import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
 var TextArea = ({
   label: labelText,
+  "aria-label": ariaLabel,
+  name,
   placeholder,
+  autoComplete,
   value,
   rows = 3,
   error,
   disabled,
-  onChange
+  required,
+  onChange,
+  onBlur,
+  onKeyDown,
+  ref
 }) => {
   const id = useId4();
+  const errorId = `${id}-error`;
   return /* @__PURE__ */ jsxs5("div", { className: wrapper4(), children: [
-    /* @__PURE__ */ jsx7("label", { htmlFor: id, className: label4(), children: labelText }),
+    labelText && /* @__PURE__ */ jsx7("label", { htmlFor: id, className: label4(), children: labelText }),
     /* @__PURE__ */ jsx7(
       "textarea",
       {
+        ref,
         id,
+        name,
         placeholder,
+        autoComplete,
         value,
         rows,
         disabled,
+        required,
         onChange,
+        onBlur,
+        onKeyDown,
+        "aria-label": ariaLabel,
+        "aria-invalid": error ? true : void 0,
+        "aria-describedby": error ? errorId : void 0,
         className: textarea()
       }
     ),
-    error && /* @__PURE__ */ jsx7(Error, { message: error })
+    error && /* @__PURE__ */ jsx7(Error, { id: errorId, message: error })
   ] });
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexandregme/zljs",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "Opinionated, accessible React component library for enterprise apps (Next.js, Tailwind CSS v4).",
   "keywords": [
     "react",