@qualcomm-ui/react 1.5.0 → 1.6.0

package/dist/text-area/qds-text-area-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qds-text-area-context.d.ts","sourceRoot":"","sources":["../../src/text-area/qds-text-area-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iCAAiC,CAAA;AAGnE,eAAO,MAAO,0BAA0B,4CAAE,qBAAqB,8CAK3D,CAAA"}

package/dist/text-area/text-area-counter.d.ts

@@ -0,0 +1,19 @@
+import type { ReactElement, ReactNode } from "react";
+import { type ElementRenderProp } from "@qualcomm-ui/react-core/system";
+export interface TextAreaCounterProps extends ElementRenderProp<"div"> {
+    /**
+     * Customize how the counter is displayed. Receives the current character
+     * count and optional max length, and returns a React node.
+     *
+     * @example
+     * // Display as "42 of 100"
+     * display={(count, max) => max ? `${count} of ${max}` : count}
+     */
+    display?: (count: number, maxLength?: number) => ReactNode;
+}
+/**
+ * Character counter displayed opposite the textarea label. Renders a `<div>`
+ * element by default.
+ */
+export declare function TextAreaCounter({ display, id, ...props }: TextAreaCounterProps): ReactElement;
+//# sourceMappingURL=text-area-counter.d.ts.map

package/dist/text-area/text-area-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-area-counter.d.ts","sourceRoot":"","sources":["../../src/text-area/text-area-counter.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,OAAO,CAAA;AAElD,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,gCAAgC,CAAA;AASvC,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB,CAAC,KAAK,CAAC;IACpE;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,SAAS,CAAA;CAC3D;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAwB,EACxB,EAAE,EACF,GAAG,KAAK,EACT,EAAE,oBAAoB,GAAG,YAAY,CAiBrC"}

package/dist/text-area/text-area-error-text.d.ts

@@ -0,0 +1,14 @@
+import type { ReactElement, ReactNode } from "react";
+import { type ElementRenderProp } from "@qualcomm-ui/react-core/system";
+export interface TextAreaErrorTextProps extends ElementRenderProp<"div"> {
+    /**
+     * React {@link https://react.dev/learn/passing-props-to-a-component#passing-jsx-as-children children} prop.
+     */
+    children?: ReactNode;
+}
+/**
+ * Error message displayed when the textarea is invalid. Renders a `<div>` element by
+ * default.
+ */
+export declare function TextAreaErrorText({ children, id, ...props }: TextAreaErrorTextProps): ReactElement;
+//# sourceMappingURL=text-area-error-text.d.ts.map

package/dist/text-area/text-area-error-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-area-error-text.d.ts","sourceRoot":"","sources":["../../src/text-area/text-area-error-text.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,OAAO,CAAA;AAKlD,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,gCAAgC,CAAA;AAMvC,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB,CAAC,KAAK,CAAC;IACtE;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,EAAE,EACF,GAAG,KAAK,EACT,EAAE,sBAAsB,GAAG,YAAY,CAgBvC"}

package/dist/text-area/text-area-hint.d.ts

@@ -0,0 +1,13 @@
+import type { ReactElement, ReactNode } from "react";
+import { type ElementRenderProp } from "@qualcomm-ui/react-core/system";
+export interface TextAreaHintProps extends ElementRenderProp<"div"> {
+    /**
+     * React {@link https://react.dev/learn/passing-props-to-a-component#passing-jsx-as-children children} prop.
+     */
+    children?: ReactNode;
+}
+/**
+ * Helper text displayed below the textarea. Renders a `<div>` element by default.
+ */
+export declare function TextAreaHint({ children, id, ...props }: TextAreaHintProps): ReactElement;
+//# sourceMappingURL=text-area-hint.d.ts.map

package/dist/text-area/text-area-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-area-hint.d.ts","sourceRoot":"","sources":["../../src/text-area/text-area-hint.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,OAAO,CAAA;AAElD,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,gCAAgC,CAAA;AAMvC,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB,CAAC,KAAK,CAAC;IACjE;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,EAAE,EACF,GAAG,KAAK,EACT,EAAE,iBAAiB,GAAG,YAAY,CAelC"}

package/dist/text-area/text-area-input.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentPropsWithRef, ReactElement } from "react";
+import type { IdProp } from "@qualcomm-ui/react-core/system";
+export interface TextAreaInputProps extends ComponentPropsWithRef<"textarea">, IdProp {
+}
+/**
+ * The text area element. Renders a `<textarea>` element.
+ */
+export declare function TextAreaInput({ id, ...props }: TextAreaInputProps): ReactElement;
+//# sourceMappingURL=text-area-input.d.ts.map

package/dist/text-area/text-area-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-area-input.d.ts","sourceRoot":"","sources":["../../src/text-area/text-area-input.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,qBAAqB,EAAE,YAAY,EAAC,MAAM,OAAO,CAAA;AAE9D,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,gCAAgC,CAAA;AAM1D,MAAM,WAAW,kBACf,SAAQ,qBAAqB,CAAC,UAAU,CAAC,EACvC,MAAM;CAAG;AAEb;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAC5B,EAAE,EACF,GAAG,KAAK,EACT,EAAE,kBAAkB,GAAG,YAAY,CAWnC"}

package/dist/text-area/text-area-label.d.ts

@@ -0,0 +1,14 @@
+import type { ReactElement, ReactNode } from "react";
+import { type ElementRenderProp } from "@qualcomm-ui/react-core/system";
+export interface TextAreaLabelProps extends ElementRenderProp<"label"> {
+    /**
+     * React {@link https://react.dev/learn/passing-props-to-a-component#passing-jsx-as-children children} prop.
+     */
+    children?: ReactNode;
+}
+/**
+ * An accessible label that is automatically associated with the input. Renders a
+ * `<label>` element by default.
+ */
+export declare function TextAreaLabel({ children, id, ...props }: TextAreaLabelProps): ReactElement;
+//# sourceMappingURL=text-area-label.d.ts.map

package/dist/text-area/text-area-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-area-label.d.ts","sourceRoot":"","sources":["../../src/text-area/text-area-label.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,OAAO,CAAA;AAKlD,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,gCAAgC,CAAA;AASvC,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB,CAAC,OAAO,CAAC;IACpE;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,EAAE,EACF,GAAG,KAAK,EACT,EAAE,kBAAkB,GAAG,YAAY,CAwBnC"}

package/dist/text-area/text-area-root.d.ts

@@ -0,0 +1,15 @@
+import { type ReactElement, type ReactNode } from "react";
+import { type TextAreaApiProps } from "@qualcomm-ui/core/text-area";
+import { type QdsTextAreaApiProps } from "@qualcomm-ui/qds-core/text-area";
+import { type ElementRenderProp } from "@qualcomm-ui/react-core/system";
+export interface TextAreaRootProps extends TextAreaApiProps, QdsTextAreaApiProps, Omit<ElementRenderProp<"div">, "dir" | "defaultValue"> {
+    /**
+     * React {@link https://react.dev/learn/passing-props-to-a-component#passing-jsx-as-children children} prop.
+     */
+    children?: ReactNode;
+}
+/**
+ * Groups all parts of the text-area. Renders a `<div>` element by default.
+ */
+export declare function TextAreaRoot({ children, size, ...props }: TextAreaRootProps): ReactElement;
+//# sourceMappingURL=text-area-root.d.ts.map

package/dist/text-area/text-area-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-area-root.d.ts","sourceRoot":"","sources":["../../src/text-area/text-area-root.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAC,KAAK,YAAY,EAAE,KAAK,SAAS,EAAU,MAAM,OAAO,CAAA;AAEhE,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,gCAAgC,CAAA;AASvC,MAAM,WAAW,iBACf,SAAQ,gBAAgB,EACtB,mBAAmB,EACnB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC;IACxD;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,iBAAiB,GAAG,YAAY,CAwBlC"}

package/dist/text-area/text-area.d.ts

@@ -0,0 +1,68 @@
+import type { ReactElement, ReactNode } from "react";
+import { type TextAreaCounterProps } from "./text-area-counter";
+import { type TextAreaErrorTextProps } from "./text-area-error-text";
+import { type TextAreaHintProps } from "./text-area-hint";
+import { type TextAreaInputProps } from "./text-area-input";
+import { type TextAreaLabelProps } from "./text-area-label";
+import { type TextAreaRootProps } from "./text-area-root";
+export interface TextAreaProps extends TextAreaRootProps {
+    /**
+     * The simple TextArea doesn't support children.
+     */
+    children?: never;
+    /**
+     * Controls whether to display the counter element.
+     *
+     * - `true`: always show the counter
+     * - `false`: never show the counter
+     * - `undefined` (default): only show the counter if `maxLength` is set
+     */
+    counter?: boolean;
+    /**
+     * Props applied to the counter element.
+     */
+    counterProps?: TextAreaCounterProps;
+    /**
+     * Optional error that describes the element when {@link invalid} is true.
+     */
+    errorText?: string;
+    /**
+     * Props applied to the error text element.
+     */
+    errorTextProps?: TextAreaErrorTextProps;
+    /**
+     * Optional hint describing the element. This element is automatically
+     * associated with the component's textarea element for accessibility.
+     */
+    hint?: ReactNode;
+    /**
+     * Props applied to the hint element.
+     */
+    hintProps?: TextAreaHintProps;
+    /**
+     * Props applied to the textarea element.
+     */
+    inputProps?: TextAreaInputProps;
+    /**
+     * Optional label describing the element. Recommended. This element is
+     * automatically associated with the component's input element for
+     * accessibility.
+     */
+    label?: ReactNode;
+    /**
+     * Props applied to the label element.
+     */
+    labelProps?: TextAreaLabelProps;
+    /**
+     * HTML {@link https://www.w3schools.com/tags/att_input_maxlength.asp maxlength} attribute,
+     * passed to the underlying textarea element.
+     */
+    maxLength?: number;
+    /**
+     * HTML {@link https://www.w3schools.com/tags/att_input_placeholder.asp placeholder} attribute,
+     * passed to the underlying textarea element.
+     */
+    placeholder?: string;
+}
+export declare function TextArea({ counter, counterProps, errorText, errorTextProps, hint, hintProps, inputProps, label, labelProps, maxLength, placeholder, ...props }: TextAreaProps): ReactElement;
+//# sourceMappingURL=text-area.d.ts.map

package/dist/text-area/text-area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-area.d.ts","sourceRoot":"","sources":["../../src/text-area/text-area.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,OAAO,CAAA;AAKlD,OAAO,EAAkB,KAAK,oBAAoB,EAAC,MAAM,qBAAqB,CAAA;AAC9E,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAe,KAAK,iBAAiB,EAAC,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAgB,KAAK,kBAAkB,EAAC,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAgB,KAAK,kBAAkB,EAAC,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAe,KAAK,iBAAiB,EAAC,MAAM,kBAAkB,CAAA;AAErE,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAA;IAEhB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,oBAAoB,CAAA;IAEnC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAA;IAEvC;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAA;IAE/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAA;IAE/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,YAAY,EACZ,SAAS,EACT,cAAc,EACd,IAAI,EACJ,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,GAAG,KAAK,EACT,EAAE,aAAa,GAAG,YAAY,CA8C9B"}

package/dist/text-input/text-input-input.d.ts

@@ -1,6 +1,7 @@
 import type { ComponentPropsWithRef, ReactElement } from "react";
 import type { IdProp } from "@qualcomm-ui/react-core/system";
-export interface TextInputInputProps extends ComponentPropsWithRef<"input">, IdProp {
+import type { ComponentDataAttributes } from "@qualcomm-ui/utils/attributes";
+export interface TextInputInputProps extends ComponentPropsWithRef<"input">, ComponentDataAttributes, IdProp {
 }
 /**
  * The text input element. Renders an `<input>` element.

package/dist/text-input/text-input-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-input-input.d.ts","sourceRoot":"","sources":["../../src/text-input/text-input-input.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,qBAAqB,EAAE,YAAY,EAAC,MAAM,OAAO,CAAA;AAG9D,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,gCAAgC,CAAA;AAI1D,MAAM,WAAW,mBACf,SAAQ,qBAAqB,CAAC,OAAO,CAAC,EACpC,MAAM;CAAG;AAEb;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAC7B,EAAE,EACF,GAAG,KAAK,EACT,EAAE,mBAAmB,GAAG,YAAY,CAYpC"}
+{"version":3,"file":"text-input-input.d.ts","sourceRoot":"","sources":["../../src/text-input/text-input-input.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,qBAAqB,EAAE,YAAY,EAAC,MAAM,OAAO,CAAA;AAG9D,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,gCAAgC,CAAA;AAE1D,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,+BAA+B,CAAA;AAG1E,MAAM,WAAW,mBACf,SAAQ,qBAAqB,CAAC,OAAO,CAAC,EACpC,uBAAuB,EACvB,MAAM;CAAG;AAEb;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAC7B,EAAE,EACF,GAAG,KAAK,EACT,EAAE,mBAAmB,GAAG,YAAY,CAYpC"}