@fpkit/acss 0.5.12 → 0.6.0

package/libs/components/form/inputs.d.ts

@@ -1,2 +1,50 @@
-import 'react';
-export { I as Input, a as InputProps, I as default } from '../../inputs-f3a216db.js';
+import React from 'react';
+import { I as InputProps } from '../../form.types-d25ebfac.js';
+
+/**
+ * Input component - Accessible text input with validation support
+ *
+ * A flexible input component that supports various input types, validation states,
+ * and proper ARIA attributes for accessibility. Integrates seamlessly with the
+ * Field component for complete form control composition.
+ *
+ * @component
+ * @example
+ * // Basic text input
+ * <Input
+ *   id="username"
+ *   name="username"
+ *   placeholder="Enter username"
+ *   required
+ * />
+ *
+ * @example
+ * // Input with error state
+ * <Input
+ *   id="email"
+ *   type="email"
+ *   validationState="invalid"
+ *   errorMessage="Please enter a valid email"
+ *   aria-describedby="email-error"
+ * />
+ *
+ * @example
+ * // Controlled input with validation
+ * <Input
+ *   id="password"
+ *   type="password"
+ *   value={password}
+ *   onChange={(e) => setPassword(e.target.value)}
+ *   minLength={8}
+ *   required
+ * />
+ *
+ * @param {InputProps} props - Component props
+ * @returns {JSX.Element} Input element with proper accessibility attributes
+ *
+ * @see {@link https://www.w3.org/WAI/WCAG21/Understanding/error-identification.html|WCAG 3.3.1 Error Identification}
+ * @see {@link https://www.w3.org/WAI/WCAG21/Understanding/name-role-value.html|WCAG 4.1.2 Name, Role, Value}
+ */
+declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
+
+export { Input, InputProps, Input as default };

package/libs/components/form/inputs.js

@@ -1,4 +1,6 @@
-export { a as Input, b as default } from '../../chunk-BHRQBJRY.js';
-import '../../chunk-P7TTEYCD.js';
+export { a as Input, b as default } from '../../chunk-F5EYMVQM.js';
+import '../../chunk-6SAHIYCZ.js';
+import '../../chunk-BFK62VX5.js';
+import '../../chunk-75QHTLFO.js';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=inputs.js.map

package/libs/components/form/textarea.cjs

@@ -2,18 +2,19 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunkLL7HTLMS_cjs = require('../../chunk-LL7HTLMS.cjs');
-require('../../chunk-6TE5QEVE.cjs');
+var chunkWXBFBWYF_cjs = require('../../chunk-WXBFBWYF.cjs');
+require('../../chunk-TON2YGMD.cjs');
+require('../../chunk-ENTCUJ3A.cjs');
 
 
 
 Object.defineProperty(exports, 'Textarea', {
 	enumerable: true,
-	get: function () { return chunkLL7HTLMS_cjs.a; }
+	get: function () { return chunkWXBFBWYF_cjs.a; }
 });
 Object.defineProperty(exports, 'default', {
 	enumerable: true,
-	get: function () { return chunkLL7HTLMS_cjs.b; }
+	get: function () { return chunkWXBFBWYF_cjs.b; }
 });
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=textarea.cjs.map

package/libs/components/form/textarea.d.cts

@@ -1,29 +1,38 @@
-import React__default from 'react';
-import { F as FP } from '../../ui-9a6f9f8d.js';
+import React from 'react';
+import { T as TextareaProps } from '../../form.types-d25ebfac.js';
 
-type TextareaProps = React__default.ComponentProps<'textarea'> & React__default.ComponentProps<typeof FP>;
 /**
- * Textarea component.
+ * Textarea component - Accessible multi-line text input with validation support
  *
- * @param value - The value of the textarea.
- * @param rows - The number of rows.
- * @param cols - The number of columns.
- * @param id - The id of the textarea.
- * @param name - The name of the textarea.
- * @param required - Whether the textarea is required.
- * @param disabled - Whether the textarea is disabled.
- * @param readOnly - Whether the textarea is read only.
- * @param onBlur - Blur event handler.
- * @param onPointerDown - Pointer down event handler.
- * @param onChange - Change event handler.
- * @param ref - Ref for the textarea.
- * @param styles - Styles object for the textarea.
- * @param textareaRef - Ref specifically for the textarea element.
- * @param props - Other props.
+ * A flexible textarea component that supports validation states, proper ARIA attributes
+ * for accessibility, and an onEnter handler for keyboard interactions. The onEnter handler
+ * fires only on Enter without Shift, allowing Shift+Enter to create new lines as expected.
+ *
+ * @component
+ * @example
+ * // Basic textarea
+ * <Textarea
+ *   id="message"
+ *   name="message"
+ *   placeholder="Enter your message"
+ *   required
+ * />
+ *
+ * @example
+ * // Textarea with Enter key handler for quick submission
+ * <Textarea
+ *   id="comment"
+ *   name="comment"
+ *   onEnter={(e) => handleSubmit()}
+ *   placeholder="Press Enter to submit, Shift+Enter for new line"
+ * />
+ *
+ * @param {TextareaProps} props - Component props
+ * @returns {JSX.Element} Textarea element with proper accessibility attributes
+ *
+ * @see {@link https://www.w3.org/WAI/WCAG21/Understanding/keyboard.html|WCAG 2.1.1 Keyboard}
+ * @see {@link https://www.w3.org/WAI/WCAG21/Understanding/name-role-value.html|WCAG 4.1.2 Name, Role, Value}
  */
-declare const Textarea: {
-    ({ id, classes, value, rows, cols, name, required, disabled, readOnly, onBlur, onPointerDown, onChange, ref, styles, placeholder, ...props }: TextareaProps): React__default.JSX.Element;
-    displayName: string;
-};
+declare const Textarea: React.ForwardRefExoticComponent<Omit<TextareaProps, "ref"> & React.RefAttributes<HTMLTextAreaElement>>;
 
 export { Textarea, TextareaProps, Textarea as default };

package/libs/components/form/textarea.d.ts

@@ -1,29 +1,38 @@
-import React__default from 'react';
-import { F as FP } from '../../ui-9a6f9f8d.js';
+import React from 'react';
+import { T as TextareaProps } from '../../form.types-d25ebfac.js';
 
-type TextareaProps = React__default.ComponentProps<'textarea'> & React__default.ComponentProps<typeof FP>;
 /**
- * Textarea component.
+ * Textarea component - Accessible multi-line text input with validation support
  *
- * @param value - The value of the textarea.
- * @param rows - The number of rows.
- * @param cols - The number of columns.
- * @param id - The id of the textarea.
- * @param name - The name of the textarea.
- * @param required - Whether the textarea is required.
- * @param disabled - Whether the textarea is disabled.
- * @param readOnly - Whether the textarea is read only.
- * @param onBlur - Blur event handler.
- * @param onPointerDown - Pointer down event handler.
- * @param onChange - Change event handler.
- * @param ref - Ref for the textarea.
- * @param styles - Styles object for the textarea.
- * @param textareaRef - Ref specifically for the textarea element.
- * @param props - Other props.
+ * A flexible textarea component that supports validation states, proper ARIA attributes
+ * for accessibility, and an onEnter handler for keyboard interactions. The onEnter handler
+ * fires only on Enter without Shift, allowing Shift+Enter to create new lines as expected.
+ *
+ * @component
+ * @example
+ * // Basic textarea
+ * <Textarea
+ *   id="message"
+ *   name="message"
+ *   placeholder="Enter your message"
+ *   required
+ * />
+ *
+ * @example
+ * // Textarea with Enter key handler for quick submission
+ * <Textarea
+ *   id="comment"
+ *   name="comment"
+ *   onEnter={(e) => handleSubmit()}
+ *   placeholder="Press Enter to submit, Shift+Enter for new line"
+ * />
+ *
+ * @param {TextareaProps} props - Component props
+ * @returns {JSX.Element} Textarea element with proper accessibility attributes
+ *
+ * @see {@link https://www.w3.org/WAI/WCAG21/Understanding/keyboard.html|WCAG 2.1.1 Keyboard}
+ * @see {@link https://www.w3.org/WAI/WCAG21/Understanding/name-role-value.html|WCAG 4.1.2 Name, Role, Value}
  */
-declare const Textarea: {
-    ({ id, classes, value, rows, cols, name, required, disabled, readOnly, onBlur, onPointerDown, onChange, ref, styles, placeholder, ...props }: TextareaProps): React__default.JSX.Element;
-    displayName: string;
-};
+declare const Textarea: React.ForwardRefExoticComponent<Omit<TextareaProps, "ref"> & React.RefAttributes<HTMLTextAreaElement>>;
 
 export { Textarea, TextareaProps, Textarea as default };

package/libs/components/form/textarea.js

@@ -1,4 +1,5 @@
-export { a as Textarea, b as default } from '../../chunk-PPOOBUOS.js';
-import '../../chunk-NE6YXTMC.js';
+export { a as Textarea, b as default } from '../../chunk-IRLFZ3OL.js';
+import '../../chunk-75QHTLFO.js';
+import '../../chunk-HHLNOC5T.js';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=textarea.js.map

package/libs/components/heading/heading.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkM5QL5TAE_cjs = require('../../chunk-M5QL5TAE.cjs');
-require('../../chunk-6TE5QEVE.cjs');
+var chunk2NRIP6RB_cjs = require('../../chunk-2NRIP6RB.cjs');
+require('../../chunk-ENTCUJ3A.cjs');
 
 
 
-module.exports = chunkM5QL5TAE_cjs.a;
+module.exports = chunk2NRIP6RB_cjs.b;
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=heading.cjs.map

package/libs/components/heading/heading.d.cts

@@ -1,14 +1,3 @@
-import React__default from 'react';
-import { F as FP } from '../../ui-9a6f9f8d.js';
-
-type TitleProps = {
-    children: React__default.ReactNode;
-    type: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
-    ui?: string;
-} & React__default.ComponentProps<typeof FP>;
-declare const Heading: {
-    ({ type, id, styles, ui, children, ...props }: TitleProps): React__default.JSX.Element;
-    displayName: string;
-};
-
-export { TitleProps, Heading as default };
+import 'react';
+export { c as TitleProps, b as default } from '../../heading-7446cb46.js';
+import '../../ui-d01b50d4.js';

package/libs/components/heading/heading.d.ts

@@ -1,14 +1,3 @@
-import React__default from 'react';
-import { F as FP } from '../../ui-9a6f9f8d.js';
-
-type TitleProps = {
-    children: React__default.ReactNode;
-    type: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
-    ui?: string;
-} & React__default.ComponentProps<typeof FP>;
-declare const Heading: {
-    ({ type, id, styles, ui, children, ...props }: TitleProps): React__default.JSX.Element;
-    displayName: string;
-};
-
-export { TitleProps, Heading as default };
+import 'react';
+export { c as TitleProps, b as default } from '../../heading-7446cb46.js';
+import '../../ui-d01b50d4.js';

package/libs/components/heading/heading.js

@@ -1,4 +1,4 @@
-export { a as default } from '../../chunk-HYBZBN4G.js';
-import '../../chunk-NE6YXTMC.js';
+export { b as default } from '../../chunk-ZFJ4U45S.js';
+import '../../chunk-HHLNOC5T.js';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=heading.js.map

package/libs/components/icons/icon.cjs

@@ -2,18 +2,18 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunkKKLTUJFB_cjs = require('../../chunk-KKLTUJFB.cjs');
-require('../../chunk-6TE5QEVE.cjs');
+var chunk6WTC4JXH_cjs = require('../../chunk-6WTC4JXH.cjs');
+require('../../chunk-ENTCUJ3A.cjs');
 
 
 
 Object.defineProperty(exports, 'Icon', {
 	enumerable: true,
-	get: function () { return chunkKKLTUJFB_cjs.a; }
+	get: function () { return chunk6WTC4JXH_cjs.a; }
 });
 Object.defineProperty(exports, 'default', {
 	enumerable: true,
-	get: function () { return chunkKKLTUJFB_cjs.b; }
+	get: function () { return chunk6WTC4JXH_cjs.b; }
 });
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=icon.cjs.map