@alexandregme/zljs 1.9.0 → 1.11.0

package/CHANGELOG.md

@@ -8,6 +8,64 @@ A change that needs action in an app has a **Migration** note. When updating, re
 
 ## [Unreleased]
 
+## [1.11.0] - 2026-11-02
+
+### Added
+
+- `Select` takes `aria-label`, `name`, `autoComplete`, `required`, `onBlur` and `onKeyDown`, and forwards `ref`, as `Input` does, so it works with `register` from `react-hook-form`
+
+### Changed
+
+- `Select` requires `label` or `aria-label` in its type, instead of always `label`
+- `Select` 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
+- `Select` border is now `gray-500` instead of `gray-300`, for 3:1 contrast
+
+### Fixed
+
+- `Select` shows its `placeholder` when there is no `value`. It used to start on the first option, so the `placeholder` never showed
+- `Select` with `error` sets `aria-invalid` and points `aria-describedby` to the message, so a screen reader announces both
+
+#### Migration
+
+Only a `Select` with a `placeholder` and no `value`, code that extends `SelectProps`, and tests that assert its old classes need a change. To find them, run the commands below from the app's root. The first also finds other components named `Select`, and those stay as they are:
+
+```sh
+grep -rnE -A6 "<Select([[:space:]/>]|$)" . --include='*.tsx' --exclude-dir=node_modules --exclude-dir=.next | grep -E "placeholder"
+grep -rnE "\bSelectProps\b" . --include='*.ts' --include='*.tsx' --exclude-dir=node_modules --exclude-dir=.next
+grep -rnE "border-gray-300|focus:ring-blue-500|focus:border-transparent" . --include='*.test.*' --exclude-dir=node_modules --exclude-dir=.next
+```
+
+That `Select` now starts empty, so `onChange` runs only after the user picks an option. If the app counted on the first option being selected, pass it as `value`. Replace `interface X extends SelectProps` with `type X = SelectProps & { ... }`, because `SelectProps` is now a union. In tests, replace those classes with `focus-visible:outline-zl-primary` and `border-gray-500`.
+
+## [1.10.0] - 2026-11-02
+
+### Added
+
+- `Input` takes `autoComplete` and `required`
+
+### Changed
+
+- `Input` requires `label` or `aria-label` in its type, so a field can't be left without a name
+- `Input` 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
+- `Input` border is now `gray-500` instead of `gray-300`, for 3:1 contrast, and its placeholder is `gray-500`, for 4.5:1
+
+### Fixed
+
+- `Input` with `error` sets `aria-invalid` and points `aria-describedby` to the message, so a screen reader announces both
+
+#### Migration
+
+Only an `Input` with neither `label` nor `aria-label`, code that extends `InputProps`, and tests that assert its old classes need a change. To find them, run the commands below from the app's root. The first also finds other components named `Input`, and those stay as they are:
+
+```sh
+grep -rnE "<Input([[:space:]/>]|$)|\bInputProps\b" . --include='*.ts' --include='*.tsx' --exclude-dir=node_modules --exclude-dir=.next
+grep -rnE "border-gray-300|focus:ring-blue-500|focus:border-transparent" . --include='*.test.*' --exclude-dir=node_modules --exclude-dir=.next
+```
+
+Give each field a `label`, or an `aria-label` when the context already says what it is. Replace `interface X extends InputProps` with `type X = InputProps & { ... }`, because `InputProps` is now a union. In tests, replace those classes with `focus-visible:outline-zl-primary` and `border-gray-500`.
+
+`FormInput` already requires `label`, so it doesn't change.
+
 ## [1.9.0] - 2026-11-02
 
 ### Added
@@ -48,6 +106,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.9.0...HEAD
+[Unreleased]: https://github.com/alexandregme/zljs/compare/v1.11.0...HEAD
+[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
 [1.8.0]: https://github.com/alexandregme/zljs/compare/v1.7.0...v1.8.0

package/dist/{chunk-WZNUKE6S.js → chunk-2RTPRD3E.js}

@@ -49,7 +49,7 @@ var label = tv2({
   base: "text-sm font-medium text-gray-700"
 });
 var input = tv2({
-  base: "px-3 py-2 border border-gray-300 rounded-md text-sm 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 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-zl-primary disabled:bg-gray-100 disabled:cursor-not-allowed"
 });
 
 // core/forms/input/input.tsx
@@ -61,14 +61,17 @@ var Input = forwardRef(
     name,
     type = "text",
     placeholder,
+    autoComplete,
     value,
     error: error2,
     disabled,
+    required,
     onChange,
     onBlur,
     onKeyDown
   }, ref) => {
     const id = useId();
+    const errorId = `${id}-error`;
     return /* @__PURE__ */ jsxs("div", { className: wrapper(), children: [
       labelText && /* @__PURE__ */ jsx3("label", { htmlFor: id, className: label(), children: labelText }),
       /* @__PURE__ */ jsx3(
@@ -79,16 +82,20 @@ var Input = forwardRef(
           name,
           type,
           placeholder,
+          autoComplete,
           value,
           disabled,
+          required,
           onChange,
           onBlur,
           onKeyDown,
           "aria-label": ariaLabel,
+          "aria-invalid": error2 ? true : void 0,
+          "aria-describedby": error2 ? errorId : void 0,
           className: input()
         }
       ),
-      error2 && /* @__PURE__ */ jsx3(Error, { message: error2 })
+      error2 && /* @__PURE__ */ jsx3(Error, { id: errorId, message: error2 })
     ] });
   }
 );

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, ChangeEvent, FormEvent, FocusEvent, KeyboardEvent } from 'react';
+import { ReactNode, ChangeEvent, FormEvent, HTMLInputAutoCompleteAttribute, FocusEvent, KeyboardEvent, Ref } from 'react';
 export { FormInput, FormInputProps, FormProvider, FormProviderProps } from './rhf/index.js';
 export { toast } from 'sonner';
 import * as zustand from 'zustand';
@@ -98,19 +98,26 @@ interface FormProps {
 
 declare const Form: ({ children, onSubmit, disabled }: FormProps) => react.JSX.Element;
 
-interface InputProps {
-    label?: string;
+type InputName = {
+    label: string;
     "aria-label"?: string;
+} | {
+    label?: undefined;
+    "aria-label": string;
+};
+type InputProps = InputName & {
     name?: string;
     type?: "text" | "password" | "email";
     placeholder?: string;
+    autoComplete?: HTMLInputAutoCompleteAttribute;
     value?: string;
     error?: string;
     disabled?: boolean;
+    required?: boolean;
     onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
     onBlur?: (event: FocusEvent<HTMLInputElement>) => void;
     onKeyDown?: (event: KeyboardEvent<HTMLInputElement>) => void;
-}
+};
 
 declare const Input: react.ForwardRefExoticComponent<InputProps & react.RefAttributes<HTMLInputElement>>;
 
@@ -129,17 +136,29 @@ interface SelectOption {
     value: string;
     label: string;
 }
-interface SelectProps {
+type SelectName = {
     label: string;
+    "aria-label"?: string;
+} | {
+    label?: undefined;
+    "aria-label": string;
+};
+type SelectProps = SelectName & {
+    name?: string;
     options: SelectOption[];
-    value?: string;
     placeholder?: string;
-    disabled?: boolean;
+    autoComplete?: HTMLInputAutoCompleteAttribute;
+    value?: string;
     error?: string;
+    disabled?: boolean;
+    required?: boolean;
     onChange?: (event: ChangeEvent<HTMLSelectElement>) => void;
-}
+    onBlur?: (event: FocusEvent<HTMLSelectElement>) => void;
+    onKeyDown?: (event: KeyboardEvent<HTMLSelectElement>) => void;
+    ref?: Ref<HTMLSelectElement>;
+};
 
-declare const Select: ({ label: labelText, options, value, placeholder, disabled, error, onChange, }: SelectProps) => react.JSX.Element;
+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 {
     label: string;

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   FormInput,
   FormProvider,
   Input
-} from "./chunk-WZNUKE6S.js";
+} from "./chunk-2RTPRD3E.js";
 
 // core/icon/icon.tsx
 import * as LucideIcons from "lucide-react";
@@ -356,30 +356,48 @@ var label3 = tv5({
   base: "text-sm font-medium text-gray-700"
 });
 var select = tv5({
-  base: "px-3 py-2 border border-gray-300 rounded-md text-sm bg-white 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 bg-white focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-zl-primary disabled:bg-gray-100 disabled:cursor-not-allowed"
 });
 
 // core/forms/select/select.tsx
 import { jsx as jsx6, jsxs as jsxs4 } from "react/jsx-runtime";
 var Select = ({
   label: labelText,
+  "aria-label": ariaLabel,
+  name,
   options,
-  value,
   placeholder,
-  disabled,
+  autoComplete,
+  value,
   error,
-  onChange
+  disabled,
+  required,
+  onChange,
+  onBlur,
+  onKeyDown,
+  ref
 }) => {
   const id = useId3();
+  const errorId = `${id}-error`;
   return /* @__PURE__ */ jsxs4("div", { className: wrapper3(), children: [
-    /* @__PURE__ */ jsx6("label", { htmlFor: id, className: label3(), children: labelText }),
+    labelText && /* @__PURE__ */ jsx6("label", { htmlFor: id, className: label3(), children: labelText }),
     /* @__PURE__ */ jsxs4(
       "select",
       {
+        ref,
         id,
+        name,
+        autoComplete,
         value,
+        defaultValue: placeholder && value === void 0 ? "" : void 0,
         disabled,
+        required,
         onChange,
+        onBlur,
+        onKeyDown,
+        "aria-label": ariaLabel,
+        "aria-invalid": error ? true : void 0,
+        "aria-describedby": error ? errorId : void 0,
         className: select(),
         children: [
           placeholder && /* @__PURE__ */ jsx6("option", { value: "", disabled: true, children: placeholder }),
@@ -387,7 +405,7 @@ var Select = ({
         ]
       }
     ),
-    error && /* @__PURE__ */ jsx6(Error, { message: error })
+    error && /* @__PURE__ */ jsx6(Error, { id: errorId, message: error })
   ] });
 };
 

package/dist/rhf/index.js

@@ -2,7 +2,7 @@
 import {
   FormInput,
   FormProvider
-} from "../chunk-WZNUKE6S.js";
+} from "../chunk-2RTPRD3E.js";
 export {
   FormInput,
   FormProvider

package/package.json

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