@gridui/input 2.0.0 → 3.0.1

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

@@ -0,0 +1,14 @@
+/**
+ * @author WMXPY
+ * @package Input
+ * @namespace PasswordInput
+ * @description Password Input
+ */
+import { type InputProps } from "../input/input";
+import { type FC } from "react";
+export type PasswordInputProps = Omit<InputProps, "type"> & {
+    readonly showLabel: string;
+    readonly hideLabel: string;
+    readonly rootClassName?: string;
+};
+export declare const PasswordInput: FC<PasswordInputProps>;

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

@@ -0,0 +1,15 @@
+/**
+ * @author WMXPY
+ * @package Input
+ * @namespace SearchInput
+ * @description Search Input
+ */
+import { type InputProps } from "../input/input";
+import { type FC } from "react";
+export type SearchInputProps = Omit<InputProps, "type"> & {
+    readonly clearLabel: string;
+    readonly loading?: boolean;
+    readonly loadingLabel?: string;
+    readonly rootClassName?: string;
+};
+export declare const SearchInput: FC<SearchInputProps>;

package/dist/shared/input-group-context.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @author WMXPY
+ * @package Input
+ * @namespace Shared
+ * @description Input Group Context
+ */
+export declare const inputGroupContext: import("react").Context<"standard" | "small" | null>;
+export declare const useInputGroupSize: () => "standard" | "small" | null;

package/dist/styles.css

@@ -8,18 +8,27 @@
   .gridui-u-input--inline-flex {
     display: inline-flex;
   }
+  .gridui-u-input--min-h-\(--_gridui-textarea-min-height\) {
+    min-height: var(--_gridui-textarea-min-height);
+  }
   .gridui-u-input--min-h-gridui-control {
     min-height: var(--gridui-control-min-height);
   }
   .gridui-u-input--min-h-gridui-control-small {
     min-height: var(--gridui-control-min-height-small);
   }
+  .gridui-u-input--w-0 {
+    width: 0px;
+  }
   .gridui-u-input--w-full {
     width: 100%;
   }
   .gridui-u-input--min-w-0 {
     min-width: 0px;
   }
+  .gridui-u-input--flex-1 {
+    flex: 1;
+  }
   .gridui-u-input--shrink-0 {
     flex-shrink: 0;
   }
@@ -45,6 +54,10 @@
     border-style: var(--tw-border-style);
     border-width: 1px;
   }
+  .gridui-u-input--border-0 {
+    border-style: var(--tw-border-style);
+    border-width: 0px;
+  }
   .gridui-u-input--border-solid {
     --tw-border-style: solid;
     border-style: solid;
@@ -55,6 +68,9 @@
   .gridui-u-input--bg-background {
     background-color: var(--gridui-background);
   }
+  .gridui-u-input--bg-transparent {
+    background-color: transparent;
+  }
   .gridui-u-input--p-gridui-8 {
     padding: var(--gridui-space-8);
   }
@@ -89,6 +105,96 @@
     height: var(--gridui-space-16);
   }
 }
+@layer components {
+  .gridui-input-group {
+    --_gridui-input-height: var(--gridui-control-min-height);
+    position: relative;
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    min-width: 0;
+    min-height: var(--_gridui-input-height);
+    width: 100%;
+    box-sizing: border-box;
+    border: 1px solid var(--gridui-border);
+    border-radius: var(--gridui-control-radius);
+    color: var(--gridui-foreground);
+    background: var(--gridui-background);
+    &[data-control-size="small"] {
+      --_gridui-input-height: var(--gridui-control-min-height-small);
+    }
+    > .gridui-control {
+      flex: 1;
+      width: 0;
+      border: 0;
+      background: transparent;
+      outline: none;
+    }
+    > textarea.gridui-control {
+      flex-basis: 100%;
+      width: 100%;
+    }
+    &:has(> .gridui-control:focus-visible) {
+      z-index: var(--gridui-z-interaction);
+      outline: var(--gridui-focus-width) solid var(--gridui-focus-color);
+      outline-offset: var(--gridui-focus-offset);
+    }
+    &:has(> .gridui-control[aria-invalid="true"]) {
+      border-color: var(--gridui-danger-foreground);
+    }
+    @media (hover: hover) and (pointer: fine) {
+      &:has(> .gridui-control:hover:not(:disabled, [readonly])):not(:has(:focus-visible)) {
+        outline: var(--gridui-hover-width) solid var(--gridui-focus-color);
+        @supports (color: color-mix(in lab, red, red)) {
+          outline: var(--gridui-hover-width) solid color-mix(in srgb, var(--gridui-focus-color) var(--gridui-hover-opacity), transparent);
+        }
+        outline-offset: var(--gridui-hover-offset);
+      }
+    }
+  }
+  .gridui-input-group-addon {
+    display: flex;
+    flex: none;
+    align-items: center;
+    gap: var(--gridui-space-8);
+    min-width: 0;
+    padding-inline: var(--gridui-space-8);
+    &[data-align="inline-start"] {
+      order: -1;
+    }
+    &[data-align="block-start"], &[data-align="block-end"] {
+      flex-basis: 100%;
+      box-sizing: border-box;
+      padding-block: var(--gridui-space-8);
+    }
+    &[data-align="block-start"] {
+      order: -2;
+    }
+    &[data-align="block-end"] {
+      order: 2;
+    }
+  }
+  .gridui-input-group-button {
+    flex: none;
+  }
+  .gridui-textarea[data-autosize] {
+    --_gridui-textarea-inset: calc(2 * var(--gridui-space-8) + 2px);
+    --_gridui-textarea-minimum: var(--gridui-control-min-height);
+    field-sizing: content;
+    height: auto;
+    --_gridui-textarea-min-height: max(var(--_gridui-textarea-minimum), calc(var(--_gridui-textarea-rows) * 1lh + var(--_gridui-textarea-inset)));
+    &.gridui-control-small {
+      --_gridui-textarea-inset: calc(2 * var(--gridui-space-4) + 2px);
+      --_gridui-textarea-minimum: var(--gridui-control-min-height-small);
+    }
+    &[data-max-rows] {
+      max-height: calc(var(--_gridui-textarea-max-rows) * 1lh + var(--_gridui-textarea-inset));
+    }
+  }
+  .gridui-input-group > input[type="search"]::-webkit-search-cancel-button {
+    appearance: none;
+  }
+}
 @property --tw-border-style {
   syntax: "*";
   inherits: false;

package/dist/textarea/textarea.d.ts

@@ -9,5 +9,6 @@ import { type ComponentPropsWithRef, type FC } from "react";
 export type TextareaProps = ComponentPropsWithRef<"textarea"> & TextControlOptions & {
     readonly autoSize?: boolean;
     readonly maxHeight?: number;
+    readonly maxRows?: number;
 };
 export declare const Textarea: FC<TextareaProps>;

package/docs/catalog.json

@@ -1,13 +1,22 @@
 {
   "schemaVersion": 1,
   "name": "@gridui/input",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "category": "core",
   "description": "GridUI React input",
   "usage": "`Label` owns inline label alignment and an optional decorative `icon` slot. Icons use the standard 16px token size without an ancestor layout styling labels.",
   "documentation": [
     "README.md",
     "docs/common-inputs.md",
+    "docs/reference/README.md",
+    "docs/reference/input-group-addon.md",
+    "docs/reference/input-group-button.md",
+    "docs/reference/input-group.md",
+    "docs/reference/input.md",
+    "docs/reference/label.md",
+    "docs/reference/password-input.md",
+    "docs/reference/search-input.md",
+    "docs/reference/textarea.md",
     "docs/textarea.md"
   ],
   "exports": [
@@ -21,6 +30,36 @@
       "kind": "component",
       "importPath": "@gridui/input"
     },
+    {
+      "name": "InputGroup",
+      "kind": "component",
+      "importPath": "@gridui/input"
+    },
+    {
+      "name": "InputGroupAddon",
+      "kind": "component",
+      "importPath": "@gridui/input"
+    },
+    {
+      "name": "InputGroupAddonProps",
+      "kind": "type",
+      "importPath": "@gridui/input"
+    },
+    {
+      "name": "InputGroupButton",
+      "kind": "component",
+      "importPath": "@gridui/input"
+    },
+    {
+      "name": "InputGroupButtonProps",
+      "kind": "type",
+      "importPath": "@gridui/input"
+    },
+    {
+      "name": "InputGroupProps",
+      "kind": "type",
+      "importPath": "@gridui/input"
+    },
     {
       "name": "InputProps",
       "kind": "type",
@@ -36,6 +75,26 @@
       "kind": "type",
       "importPath": "@gridui/input"
     },
+    {
+      "name": "PasswordInput",
+      "kind": "component",
+      "importPath": "@gridui/input"
+    },
+    {
+      "name": "PasswordInputProps",
+      "kind": "type",
+      "importPath": "@gridui/input"
+    },
+    {
+      "name": "SearchInput",
+      "kind": "component",
+      "importPath": "@gridui/input"
+    },
+    {
+      "name": "SearchInputProps",
+      "kind": "type",
+      "importPath": "@gridui/input"
+    },
     {
       "name": "Textarea",
       "kind": "component",
@@ -49,10 +108,18 @@
   ],
   "styles": [
     "@gridui/theme/styles.css",
+    "@gridui/button/styles.css",
     "@gridui/overlay/styles.css",
     "@gridui/input/styles.css"
   ],
   "examples": [
+    "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/addons.mdx",
+    "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/multiline.mdx",
+    "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/password-entry.mdx",
+    "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/search-entry.mdx",
+    "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/input-group.stories.tsx",
+    "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/password-input.stories.tsx",
+    "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/search-input.stories.tsx",
     "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/textarea.stories.tsx"
   ]
 }

package/docs/reference/README.md

@@ -0,0 +1,11 @@
+<!-- Generated by pnpm docs:storybook. -->
+# Component reference
+
+- [Input](input.md)
+- [InputGroup](input-group.md)
+- [InputGroupAddon](input-group-addon.md)
+- [InputGroupButton](input-group-button.md)
+- [Label](label.md)
+- [PasswordInput](password-input.md)
+- [SearchInput](search-input.md)
+- [Textarea](textarea.md)

package/docs/reference/input-group-addon.md

@@ -0,0 +1,63 @@
+<!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
+# InputGroupAddon
+
+Compose InputGroupAddon with InputGroup inside the same @gridui/input component family.
+
+Import from ``@gridui/input`` and load Theme before this family's stylesheet.
+
+```tsx
+import { InputGroupAddon } from "@gridui/input";
+import "@gridui/theme/styles.css";
+import "@gridui/input/styles.css";
+```
+
+Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/README.md) for shared behavior and stylesheet dependencies.
+
+The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/input-group.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
+
+## API
+
+The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
+
+### children
+
+``ReactNode`` · Optional
+
+Content rendered inside the component.
+
+### onFocus
+
+``(event: FocusEvent<HTMLDivElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onBlur
+
+``(event: FocusEvent<HTMLDivElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onChange
+
+``(event: ChangeEvent<HTMLDivElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onSubmit
+
+``(event: SubmitEvent<HTMLDivElement>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onClick
+
+``(event: MouseEvent<HTMLDivElement, MouseEvent>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### align
+
+``"inline-start" | "inline-end" | "block-start" | "block-end" | undefined`` · Optional
+
+Default: ``"inline-start"``
+

package/docs/reference/input-group-button.md

@@ -0,0 +1,99 @@
+<!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
+# InputGroupButton
+
+Compose InputGroupButton with InputGroup inside the same @gridui/input component family.
+
+Import from ``@gridui/input`` and load Theme before this family's stylesheet.
+
+```tsx
+import { InputGroupButton } from "@gridui/input";
+import "@gridui/theme/styles.css";
+import "@gridui/input/styles.css";
+```
+
+Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/README.md) for shared behavior and stylesheet dependencies.
+
+The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/input-group.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
+
+## API
+
+The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
+
+### children
+
+``ReactNode`` · Optional
+
+Content rendered inside the component.
+
+### onFocus
+
+``(event: FocusEvent<HTMLButtonElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onBlur
+
+``(event: FocusEvent<HTMLButtonElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onChange
+
+``(event: ChangeEvent<HTMLButtonElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onSubmit
+
+``(event: SubmitEvent<HTMLButtonElement>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onClick
+
+``(event: MouseEvent<HTMLButtonElement, MouseEvent>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### size
+
+``"small" | "standard" | "large" | "extra-large" | null | undefined`` · Optional
+
+Component size preset.
+
+### iconMotion
+
+``"none" | "outward" | null | undefined`` · Optional
+
+### variant
+
+``"text" | "primary" | "secondary" | "quiet" | "highlight" | "underlined" | null | undefined`` · Optional
+
+Visual variant.
+
+### layout
+
+``"cell" | "standard" | "icon" | "entry" | "rail" | "divided" | null | undefined`` · Optional
+
+Layout within the containing region.
+
+### startIcon
+
+``ReactNode`` · Optional
+
+### startIconLayout
+
+``"divided" | "inline" | undefined`` · Optional
+
+### startIconSize
+
+``"standard" | "large" | "extra-large" | undefined`` · Optional
+
+### endIcon
+
+``ReactNode`` · Optional
+
+### loading
+
+``boolean | undefined`` · Optional
+

package/docs/reference/input-group.md

@@ -0,0 +1,63 @@
+<!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
+# InputGroup
+
+Combines a native text control with units, icons, or actions inside one outline. Use block addons for multiline tools.
+
+Import from ``@gridui/input`` and load Theme before this family's stylesheet.
+
+```tsx
+import { InputGroup } from "@gridui/input";
+import "@gridui/theme/styles.css";
+import "@gridui/input/styles.css";
+```
+
+Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/README.md) for shared behavior and stylesheet dependencies.
+
+The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/stories/input-group.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
+
+## API
+
+The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
+
+### children
+
+``ReactNode`` · Optional
+
+Content rendered inside the component.
+
+### onFocus
+
+``(event: FocusEvent<HTMLDivElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onBlur
+
+``(event: FocusEvent<HTMLDivElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onChange
+
+``(event: ChangeEvent<HTMLDivElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onSubmit
+
+``(event: SubmitEvent<HTMLDivElement>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onClick
+
+``(event: MouseEvent<HTMLDivElement, MouseEvent>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### controlSize
+
+``"small" | "standard" | undefined`` · Optional
+
+Default: ``"standard"``
+

package/docs/reference/input.md

@@ -0,0 +1,69 @@
+<!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
+# Input
+
+Accepts a single line of text within a form. Use it with a visible label and field feedback to explain the expected value.
+
+Import from ``@gridui/input`` and load Theme before this family's stylesheet.
+
+```tsx
+import { Input } from "@gridui/input";
+import "@gridui/theme/styles.css";
+import "@gridui/input/styles.css";
+```
+
+Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/README.md) for shared behavior and stylesheet dependencies.
+
+The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/storybook/scenarios/controls/input.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
+
+## API
+
+The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
+
+### onChange
+
+``(event: ChangeEvent<HTMLInputElement, HTMLInputElement>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### children
+
+``ReactNode`` · Optional
+
+Content rendered inside the component.
+
+### onFocus
+
+``(event: FocusEvent<HTMLInputElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onBlur
+
+``(event: FocusEvent<HTMLInputElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onSubmit
+
+``(event: SubmitEvent<HTMLInputElement>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onClick
+
+``(event: MouseEvent<HTMLInputElement, MouseEvent>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### controlSize
+
+``"small" | "standard" | undefined`` · Optional
+
+Default: ``groupSize ?? "standard"``
+
+### onValueChange
+
+``(value: string): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+

package/docs/reference/label.md

@@ -0,0 +1,61 @@
+<!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
+# Label
+
+Compose Label with ActionForm inside the same @gridui/input component family.
+
+Import from ``@gridui/input`` and load Theme before this family's stylesheet.
+
+```tsx
+import { Label } from "@gridui/input";
+import "@gridui/theme/styles.css";
+import "@gridui/input/styles.css";
+```
+
+Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/input/README.md) for shared behavior and stylesheet dependencies.
+
+The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/action-form.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
+
+## API
+
+The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
+
+### children
+
+``ReactNode`` · Optional
+
+Content rendered inside the component.
+
+### onFocus
+
+``(event: FocusEvent<HTMLLabelElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onBlur
+
+``(event: FocusEvent<HTMLLabelElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onChange
+
+``(event: ChangeEvent<HTMLLabelElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onSubmit
+
+``(event: SubmitEvent<HTMLLabelElement>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onClick
+
+``(event: MouseEvent<HTMLLabelElement, MouseEvent>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### icon
+
+``ReactNode`` · Optional
+