@gridui/tag-input 1.0.7 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -16,3 +16,22 @@ Input supplies the control surface, Button supplies tag actions, and Form hides
16
16
  Applications own routes, labels, state persistence, and branding.
17
17
 
18
18
  See [component ownership](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/component-ownership.md) and [release history](https://github.com/sudo-ui/GridUI-React-Monorepo/tree/main/packages-core/tag-input/.changeset/history).
19
+
20
+ [Component reference](docs/reference/README.md) contains focused API pages for each public component.
21
+
22
+ ## Drafts and suggestions
23
+
24
+ `draft`/`onDraftChange` control the text being edited independently of committed
25
+ value/onValueChange. Omit draft for local text, optionally initialized with
26
+ defaultDraft. Reset requests the initial draft; controlled consumers can reject
27
+ that request. Draft text is excluded from native form submission.
28
+
29
+ Optional `suggestions` accepts Autocomplete options, searchLabel, emptyLabel,
30
+ filterOptions, loading/error labels and portalContainer. Load Overlay and Select
31
+ styles as well as the existing family styles when using suggestions. Selecting a
32
+ suggestion commits its value through normal tag validation, deduplication and
33
+ limits. Unknown text still commits with Enter/comma. Highlighting a suggestion
34
+ with arrows makes Enter choose it; IME confirmation never commits. onReject keeps
35
+ invalid or limited candidates editable. Use onDraftChange to drive remote options.
36
+ `controlSize` selects standard or small density. Native props/ref target the draft
37
+ input; className continues to target the encompassing tag surface.
package/dist/index.js CHANGED
@@ -35,9 +35,10 @@ import { Button } from "@gridui/button";
35
35
  import { ListFieldControl, useListField } from "@gridui/form";
36
36
  import { controlVariants } from "@gridui/input";
37
37
  import { isComposingKeyEvent } from "@gridui/interaction";
38
+ import { Autocomplete } from "@gridui/select";
38
39
  import { cn } from "@gridui/style-utils";
39
40
  import { X } from "lucide-react";
40
- import { useState } from "react";
41
+ import { useRef, useState } from "react";
41
42
  import { jsx, jsxs } from "react/jsx-runtime";
42
43
  var TagInput = (props) => {
43
44
  const {
@@ -58,15 +59,28 @@ var TagInput = (props) => {
58
59
  readOnly,
59
60
  onKeyDown,
60
61
  onPaste,
62
+ controlSize = "standard",
63
+ draft: controlledDraft,
64
+ defaultDraft = "",
65
+ onDraftChange,
66
+ suggestions,
61
67
  ...restProps
62
68
  } = props;
63
69
  if (maxTags !== Infinity && (!Number.isSafeInteger(maxTags) || maxTags < 1)) {
64
70
  throw new RangeError("TagInput maxTags must be a positive integer.");
65
71
  }
66
72
  const [
67
- draft,
68
- setDraft
69
- ] = useState("");
73
+ localDraft,
74
+ setLocalDraft
75
+ ] = useState(defaultDraft);
76
+ const initialDraft = useRef(defaultDraft);
77
+ const draft = controlledDraft ?? localDraft;
78
+ const setDraft = (next) => {
79
+ if (controlledDraft === void 0) {
80
+ setLocalDraft(next);
81
+ }
82
+ onDraftChange?.(next);
83
+ };
70
84
  const { selected, native, control, change, available } = useListField({
71
85
  value,
72
86
  defaultValue,
@@ -75,7 +89,7 @@ var TagInput = (props) => {
75
89
  readOnly,
76
90
  form
77
91
  }, () => {
78
- setDraft("");
92
+ setDraft(initialDraft.current);
79
93
  });
80
94
  const add = (candidates) => {
81
95
  if (!available()) {
@@ -101,28 +115,80 @@ var TagInput = (props) => {
101
115
  }));
102
116
  control.current?.focus();
103
117
  };
118
+ const inputProps = {
119
+ ...restProps,
120
+ form,
121
+ disabled,
122
+ readOnly,
123
+ value: draft,
124
+ "aria-required": required,
125
+ ref: (element) => {
126
+ control.current = element;
127
+ if (typeof ref === "function") {
128
+ return ref(element);
129
+ }
130
+ if (ref) {
131
+ ref.current = element;
132
+ }
133
+ },
134
+ className: cn("gridui-tag-input-editor gridui-u-tag-input--min-w-24 gridui-u-tag-input--w-full gridui-u-tag-input--min-h-0 gridui-u-tag-input--flex-1 gridui-u-tag-input--border-0 gridui-u-tag-input--bg-transparent gridui-u-tag-input--p-0 gridui-u-tag-input--text-foreground gridui-u-tag-input--type-input gridui-u-tag-input--outline-none"),
135
+ onChange: (event) => {
136
+ setDraft(event.currentTarget.value);
137
+ },
138
+ onKeyDown: (event) => {
139
+ onKeyDown?.(event);
140
+ if (event.defaultPrevented || isComposingKeyEvent(event.nativeEvent) || !available()) {
141
+ return;
142
+ }
143
+ if (event.key === "Enter" && event.currentTarget.getAttribute("aria-expanded") === "true" && event.currentTarget.getAttribute("aria-activedescendant")) {
144
+ return;
145
+ }
146
+ if ((event.key === "Enter" || event.key === ",") && draft.trim()) {
147
+ event.preventDefault();
148
+ add([draft]);
149
+ }
150
+ if (event.key === "Backspace" && !draft && selected.length) {
151
+ event.preventDefault();
152
+ const buttons = event.currentTarget.closest(".gridui-tag-input")?.querySelectorAll("[data-tag-remove]");
153
+ buttons?.item(buttons.length - 1).focus();
154
+ }
155
+ },
156
+ onPaste: (event) => {
157
+ onPaste?.(event);
158
+ if (event.defaultPrevented || !available()) {
159
+ return;
160
+ }
161
+ const text = event.clipboardData.getData("text");
162
+ if (/[\n,]/.test(text)) {
163
+ event.preventDefault();
164
+ const input = event.currentTarget;
165
+ add(`${draft.slice(0, input.selectionStart ?? draft.length)}${text}${draft.slice(input.selectionEnd ?? draft.length)}`.split(/[\n,]/));
166
+ }
167
+ }
168
+ };
104
169
  return /* @__PURE__ */ jsxs(
105
170
  "div",
106
171
  {
107
172
  dir: restProps.dir,
173
+ "data-gridui-outline-target": "",
108
174
  "aria-invalid": restProps["aria-invalid"],
109
- className: cn(controlVariants(), "gridui-u-flex gridui-u-flex-wrap gridui-u-items-center gridui-u-gap-gridui-4 gridui-u-has-[input:disabled]:opacity-50", className),
175
+ className: cn(controlVariants({ size: controlSize }), "gridui-tag-input gridui-u-tag-input--flex gridui-u-tag-input--flex-wrap gridui-u-tag-input--items-center gridui-u-tag-input--gap-gridui-4 gridui-u-tag-input--has-[input:disabled]:opacity-50", className),
110
176
  children: [
111
177
  /* @__PURE__ */ jsx(
112
178
  "ul",
113
179
  {
114
180
  "aria-label": listLabel,
115
- className: "gridui-u-contents gridui-u-list-none",
181
+ className: "gridui-u-tag-input--contents gridui-u-tag-input--list-none",
116
182
  children: selected.map((tag) => {
117
183
  return /* @__PURE__ */ jsxs(
118
184
  "li",
119
185
  {
120
- className: "gridui-u-inline-flex gridui-u-max-w-full gridui-u-items-center gridui-u-gap-gridui-4 gridui-u-border gridui-u-border-border gridui-u-bg-surface gridui-u-ps-gridui-8",
186
+ className: "gridui-u-tag-input--inline-flex gridui-u-tag-input--max-w-full gridui-u-tag-input--items-center gridui-u-tag-input--gap-gridui-4 gridui-u-tag-input--border gridui-u-tag-input--border-border gridui-u-tag-input--bg-surface gridui-u-tag-input--ps-gridui-8",
121
187
  children: [
122
188
  /* @__PURE__ */ jsx(
123
189
  "span",
124
190
  {
125
- className: "gridui-u-min-w-0 gridui-u-wrap-anywhere",
191
+ className: "gridui-u-tag-input--min-w-0 gridui-u-tag-input--wrap-anywhere",
126
192
  children: tag
127
193
  }
128
194
  ),
@@ -159,57 +225,24 @@ var TagInput = (props) => {
159
225
  })
160
226
  }
161
227
  ),
162
- /* @__PURE__ */ jsx(
163
- "input",
228
+ suggestions ? /* @__PURE__ */ jsx(
229
+ Autocomplete,
164
230
  {
165
- ...restProps,
166
- ref: (element) => {
167
- control.current = element;
168
- if (typeof ref === "function") {
169
- return ref(element);
170
- }
171
- if (ref) {
172
- ref.current = element;
173
- }
174
- },
175
- type: "text",
176
- form,
177
- disabled,
178
- readOnly,
231
+ ...inputProps,
232
+ ...suggestions,
179
233
  value: draft,
180
- "aria-required": required,
181
- className: "gridui-u-min-w-24 gridui-u-flex-1 gridui-u-border-0 gridui-u-bg-transparent gridui-u-text-foreground gridui-u-type-input",
182
- onChange: (event) => {
183
- setDraft(event.target.value);
184
- },
185
- onKeyDown: (event) => {
186
- onKeyDown?.(event);
187
- if (event.defaultPrevented || isComposingKeyEvent(event.nativeEvent) || !available()) {
188
- return;
189
- }
190
- if ((event.key === "Enter" || event.key === ",") && draft.trim()) {
191
- event.preventDefault();
192
- add([draft]);
193
- }
194
- if (event.key === "Backspace" && !draft && selected.length) {
195
- event.preventDefault();
196
- const buttons = event.currentTarget.parentElement?.querySelectorAll("[data-tag-remove]");
197
- buttons?.item(buttons.length - 1).focus();
198
- }
199
- },
200
- onPaste: (event) => {
201
- onPaste?.(event);
202
- if (event.defaultPrevented || !available()) {
203
- return;
204
- }
205
- const text = event.clipboardData.getData("text");
206
- if (/[\n,]/.test(text)) {
207
- event.preventDefault();
208
- const input = event.currentTarget;
209
- add(`${draft.slice(0, input.selectionStart ?? draft.length)}${text}${draft.slice(input.selectionEnd ?? draft.length)}`.split(/[\n,]/));
210
- }
234
+ controlSize,
235
+ rootClassName: cn("gridui-tag-input-suggestions gridui-u-tag-input--min-w-24 gridui-u-tag-input--w-0 gridui-u-tag-input--flex-1"),
236
+ onOptionSelect: (option) => {
237
+ add([option.value]);
211
238
  }
212
239
  }
240
+ ) : /* @__PURE__ */ jsx(
241
+ "input",
242
+ {
243
+ ...inputProps,
244
+ type: "text"
245
+ }
213
246
  ),
214
247
  /* @__PURE__ */ jsx(
215
248
  ListFieldControl,
package/dist/index.js.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../src/tag-input/model.ts", "../src/tag-input/tag-input.tsx"],
4
- "sourcesContent": ["/**\n * @author WMXPY\n * @package Tag Input\n * @namespace TagInput\n * @description Model\n */\n\nexport type TagRejectionReason = \"duplicate\" | \"limit\" | \"invalid\";\n\nexport type TagRejection = {\n readonly value: string;\n readonly reason: TagRejectionReason;\n};\n\nexport const appendTags = (\n current: readonly string[], candidates: readonly string[], maxTags: number,\n validate?: (value: string) => boolean,\n): {\n values: string[];\n rejected: TagRejection[];\n} => {\n const values = [...current];\n const rejected: TagRejection[] = [];\n for (const candidate of candidates) {\n const value = candidate.trim();\n if (!value) {\n continue;\n }\n let reason: TagRejectionReason | undefined;\n if (values.includes(value)) {\n reason = \"duplicate\";\n }\n else if (validate && !validate(value)) {\n reason = \"invalid\";\n }\n else if (values.length >= maxTags) {\n reason = \"limit\";\n }\n if (reason) {\n rejected.push({\n value,\n reason,\n });\n } else {\n values.push(value);\n }\n }\n return {\n values,\n rejected,\n };\n};\n", "/**\n * @author WMXPY\n * @package Tag Input\n * @namespace TagInput\n * @description Tag Input\n */\n\nimport { appendTags, type TagRejection } from \"./model\";\nimport { Button } from \"@gridui/button\";\nimport { ListFieldControl, type ListFieldProps, useListField } from \"@gridui/form\";\nimport { controlVariants } from \"@gridui/input\";\nimport { isComposingKeyEvent } from \"@gridui/interaction\";\nimport { cn } from \"@gridui/style-utils\";\nimport { X } from \"lucide-react\";\nimport { type ComponentPropsWithRef, type FC, useState } from \"react\";\n\nexport type TagInputProps = Omit<ComponentPropsWithRef<\"input\">, \"value\" | \"defaultValue\" | \"onChange\" | \"type\" | \"size\"> & ListFieldProps & {\n readonly listLabel: string;\n readonly removeLabel: (tag: string) => string;\n readonly maxTags?: number;\n readonly validateTag?: (tag: string) => boolean;\n readonly onReject?: (rejection: TagRejection) => void;\n};\n\nexport const TagInput: FC<TagInputProps> = (props: TagInputProps) => {\n const { value, defaultValue, onValueChange, listLabel, removeLabel, maxTags = Infinity, validateTag, onReject,\n className, ref, name, required, form, disabled, readOnly, onKeyDown, onPaste, ...restProps } = props;\n if (maxTags !== Infinity && (!Number.isSafeInteger(maxTags) || maxTags < 1)) {\n throw new RangeError(\"TagInput maxTags must be a positive integer.\");\n }\n const [\n draft,\n setDraft,\n ] = useState(\"\");\n const { selected, native, control, change, available } = useListField({\n value,\n defaultValue,\n onValueChange,\n disabled,\n readOnly,\n form,\n }, () => {\n setDraft(\"\");\n });\n const add = (candidates: string[]) => {\n if (!available()) {\n return;\n }\n const result = appendTags(selected, candidates, maxTags, validateTag);\n change(result.values);\n result.rejected.forEach(rejection => {\n onReject?.(rejection);\n });\n setDraft(result.rejected.filter(rejection => {\n return rejection.reason !== \"duplicate\";\n }).map(rejection => {\n return rejection.value;\n })\n .join(\", \"));\n };\n const remove = (tag: string) => {\n if (!available()) {\n return;\n }\n change(selected.filter(entry => {\n return entry !== tag;\n }));\n control.current?.focus();\n };\n return (<div\n dir={restProps.dir}\n aria-invalid={restProps[\"aria-invalid\"]}\n className={cn(controlVariants(), \"gridui-u-flex gridui-u-flex-wrap gridui-u-items-center gridui-u-gap-gridui-4 gridui-u-has-[input:disabled]:opacity-50\", className)}\n >\n <ul\n aria-label={listLabel}\n className=\"gridui-u-contents gridui-u-list-none\"\n >\n {selected.map(tag => {\n return (<li\n key={tag}\n className=\"gridui-u-inline-flex gridui-u-max-w-full gridui-u-items-center gridui-u-gap-gridui-4 gridui-u-border gridui-u-border-border gridui-u-bg-surface gridui-u-ps-gridui-8\"\n >\n <span\n className=\"gridui-u-min-w-0 gridui-u-wrap-anywhere\"\n >\n {tag}\n </span>\n <Button\n variant=\"quiet\"\n layout=\"icon\"\n size=\"small\"\n aria-label={removeLabel(tag)}\n disabled={disabled || readOnly}\n data-tag-remove=\"\"\n onClick={() => {\n remove(tag);\n }}\n onKeyDown={(event) => {\n if (event.key === \"Backspace\" || event.key === \"Delete\") {\n event.preventDefault(); remove(tag);\n }\n }}\n >\n <X\n aria-hidden=\"true\"\n />\n </Button>\n </li>);\n })}\n </ul>\n <input\n {...restProps}\n ref={(element) => {\n control.current = element;\n if (typeof ref === \"function\") {\n return ref(element);\n }\n if (ref) {\n ref.current = element;\n }\n }}\n type=\"text\"\n form={form}\n disabled={disabled}\n readOnly={readOnly}\n value={draft}\n aria-required={required}\n className=\"gridui-u-min-w-24 gridui-u-flex-1 gridui-u-border-0 gridui-u-bg-transparent gridui-u-text-foreground gridui-u-type-input\"\n onChange={(event) => {\n setDraft(event.target.value);\n }}\n onKeyDown={(event) => {\n onKeyDown?.(event);\n if (event.defaultPrevented || isComposingKeyEvent(event.nativeEvent) || !available()) {\n return;\n }\n if ((event.key === \"Enter\" || event.key === \",\") && draft.trim()) {\n event.preventDefault(); add([draft]);\n }\n if (event.key === \"Backspace\" && !draft && selected.length) {\n event.preventDefault();\n const buttons = event.currentTarget.parentElement?.querySelectorAll<HTMLButtonElement>(\"[data-tag-remove]\");\n buttons?.item(buttons.length - 1).focus();\n }\n }}\n onPaste={(event) => {\n onPaste?.(event);\n if (event.defaultPrevented || !available()) {\n return;\n }\n const text = event.clipboardData.getData(\"text\");\n if (/[\\n,]/.test(text)) {\n event.preventDefault(); const input = event.currentTarget;\n add(`${draft.slice(0, input.selectionStart ?? draft.length)}${text}${draft.slice(input.selectionEnd ?? draft.length)}`.split(/[\\n,]/));\n }\n }}\n />\n <ListFieldControl\n ref={native}\n name={name}\n form={form}\n required={required}\n disabled={disabled}\n value={selected}\n onInvalidFocus={() => {\n control.current?.focus();\n }}\n >\n {selected.map(tag => {\n return (<option\n key={tag}\n value={tag}\n >\n {tag}\n </option>);\n })}\n </ListFieldControl>\n </div>);\n};\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["/**\n * @author WMXPY\n * @package Tag Input\n * @namespace TagInput\n * @description Model\n */\n\nexport type TagRejectionReason = \"duplicate\" | \"limit\" | \"invalid\";\n\nexport type TagRejection = {\n readonly value: string;\n readonly reason: TagRejectionReason;\n};\n\nexport const appendTags = (\n current: readonly string[], candidates: readonly string[], maxTags: number,\n validate?: (value: string) => boolean,\n): {\n values: string[];\n rejected: TagRejection[];\n} => {\n const values = [...current];\n const rejected: TagRejection[] = [];\n for (const candidate of candidates) {\n const value = candidate.trim();\n if (!value) {\n continue;\n }\n let reason: TagRejectionReason | undefined;\n if (values.includes(value)) {\n reason = \"duplicate\";\n }\n else if (validate && !validate(value)) {\n reason = \"invalid\";\n }\n else if (values.length >= maxTags) {\n reason = \"limit\";\n }\n if (reason) {\n rejected.push({\n value,\n reason,\n });\n } else {\n values.push(value);\n }\n }\n return {\n values,\n rejected,\n };\n};\n", "/**\n * @author WMXPY\n * @package Tag Input\n * @namespace TagInput\n * @description Tag Input\n */\n\nimport { appendTags, type TagRejection } from \"./model\";\nimport { Button } from \"@gridui/button\";\nimport { ListFieldControl, type ListFieldProps, useListField } from \"@gridui/form\";\nimport { controlVariants } from \"@gridui/input\";\nimport { isComposingKeyEvent } from \"@gridui/interaction\";\nimport { Autocomplete, type AutocompleteProps } from \"@gridui/select\";\nimport { cn } from \"@gridui/style-utils\";\nimport { X } from \"lucide-react\";\nimport { type ComponentPropsWithRef, type FC, useRef, useState } from \"react\";\n\nexport type TagInputProps = Omit<ComponentPropsWithRef<\"input\">, \"value\" | \"defaultValue\" | \"onChange\" | \"type\" | \"size\"> & ListFieldProps & {\n readonly listLabel: string;\n readonly removeLabel: (tag: string) => string;\n readonly maxTags?: number;\n readonly controlSize?: \"standard\" | \"small\";\n readonly draft?: string;\n readonly defaultDraft?: string;\n readonly onDraftChange?: (value: string) => void;\n readonly suggestions?: Pick<AutocompleteProps, \"options\" | \"searchLabel\" | \"emptyLabel\" | \"loading\" | \"loadingLabel\" | \"errorLabel\" | \"resultCountLabel\" | \"filterOptions\" | \"portalContainer\">;\n readonly validateTag?: (tag: string) => boolean;\n readonly onReject?: (rejection: TagRejection) => void;\n};\n\nexport const TagInput: FC<TagInputProps> = (props: TagInputProps) => {\n const { value, defaultValue, onValueChange, listLabel, removeLabel, maxTags = Infinity, validateTag, onReject,\n className, ref, name, required, form, disabled, readOnly, onKeyDown, onPaste, controlSize = \"standard\",\n draft: controlledDraft, defaultDraft = \"\", onDraftChange, suggestions, ...restProps } = props;\n if (maxTags !== Infinity && (!Number.isSafeInteger(maxTags) || maxTags < 1)) {\n throw new RangeError(\"TagInput maxTags must be a positive integer.\");\n }\n const [\n localDraft,\n setLocalDraft,\n ] = useState(defaultDraft);\n const initialDraft = useRef(defaultDraft);\n const draft = controlledDraft ?? localDraft;\n const setDraft = (next: string) => {\n if (controlledDraft === undefined) {\n setLocalDraft(next);\n }\n onDraftChange?.(next);\n };\n const { selected, native, control, change, available } = useListField({\n value,\n defaultValue,\n onValueChange,\n disabled,\n readOnly,\n form,\n }, () => {\n setDraft(initialDraft.current);\n });\n const add = (candidates: string[]) => {\n if (!available()) {\n return;\n }\n const result = appendTags(selected, candidates, maxTags, validateTag);\n change(result.values);\n result.rejected.forEach(rejection => {\n onReject?.(rejection);\n });\n setDraft(result.rejected.filter(rejection => {\n return rejection.reason !== \"duplicate\";\n }).map(rejection => {\n return rejection.value;\n })\n .join(\", \"));\n };\n const remove = (tag: string) => {\n if (!available()) {\n return;\n }\n change(selected.filter(entry => {\n return entry !== tag;\n }));\n control.current?.focus();\n };\n const inputProps: Omit<ComponentPropsWithRef<\"input\">, \"value\" | \"defaultValue\" | \"type\"> & {\n value: string;\n } = {\n ...restProps,\n form,\n disabled,\n readOnly,\n value: draft,\n \"aria-required\": required,\n ref: (element) => {\n control.current = element;\n if (typeof ref === \"function\") {\n return ref(element);\n }\n if (ref) {\n ref.current = element;\n }\n },\n className: cn(\"gridui-tag-input-editor gridui-u-tag-input--min-w-24 gridui-u-tag-input--w-full gridui-u-tag-input--min-h-0 gridui-u-tag-input--flex-1 gridui-u-tag-input--border-0 gridui-u-tag-input--bg-transparent gridui-u-tag-input--p-0 gridui-u-tag-input--text-foreground gridui-u-tag-input--type-input gridui-u-tag-input--outline-none\"),\n onChange: (event) => {\n setDraft(event.currentTarget.value);\n },\n onKeyDown: (event) => {\n onKeyDown?.(event);\n if (event.defaultPrevented || isComposingKeyEvent(event.nativeEvent) || !available()) {\n return;\n }\n if (event.key === \"Enter\" && event.currentTarget.getAttribute(\"aria-expanded\") === \"true\"\n && event.currentTarget.getAttribute(\"aria-activedescendant\")) {\n return;\n }\n if ((event.key === \"Enter\" || event.key === \",\") && draft.trim()) {\n event.preventDefault(); add([draft]);\n }\n if (event.key === \"Backspace\" && !draft && selected.length) {\n event.preventDefault();\n const buttons = event.currentTarget.closest(\".gridui-tag-input\")?.querySelectorAll<HTMLButtonElement>(\"[data-tag-remove]\");\n buttons?.item(buttons.length - 1).focus();\n }\n },\n onPaste: (event) => {\n onPaste?.(event);\n if (event.defaultPrevented || !available()) {\n return;\n }\n const text = event.clipboardData.getData(\"text\");\n if (/[\\n,]/.test(text)) {\n event.preventDefault();\n const input = event.currentTarget;\n add(`${draft.slice(0, input.selectionStart ?? draft.length)}${text}${draft.slice(input.selectionEnd ?? draft.length)}`.split(/[\\n,]/));\n }\n },\n };\n return (<div\n dir={restProps.dir}\n data-gridui-outline-target=\"\"\n aria-invalid={restProps[\"aria-invalid\"]}\n className={cn(controlVariants({ size: controlSize }), \"gridui-tag-input gridui-u-tag-input--flex gridui-u-tag-input--flex-wrap gridui-u-tag-input--items-center gridui-u-tag-input--gap-gridui-4 gridui-u-tag-input--has-[input:disabled]:opacity-50\", className)}\n >\n <ul\n aria-label={listLabel}\n className=\"gridui-u-tag-input--contents gridui-u-tag-input--list-none\"\n >\n {selected.map(tag => {\n return (<li\n key={tag}\n className=\"gridui-u-tag-input--inline-flex gridui-u-tag-input--max-w-full gridui-u-tag-input--items-center gridui-u-tag-input--gap-gridui-4 gridui-u-tag-input--border gridui-u-tag-input--border-border gridui-u-tag-input--bg-surface gridui-u-tag-input--ps-gridui-8\"\n >\n <span\n className=\"gridui-u-tag-input--min-w-0 gridui-u-tag-input--wrap-anywhere\"\n >\n {tag}\n </span>\n <Button\n variant=\"quiet\"\n layout=\"icon\"\n size=\"small\"\n aria-label={removeLabel(tag)}\n disabled={disabled || readOnly}\n data-tag-remove=\"\"\n onClick={() => {\n remove(tag);\n }}\n onKeyDown={(event) => {\n if (event.key === \"Backspace\" || event.key === \"Delete\") {\n event.preventDefault(); remove(tag);\n }\n }}\n >\n <X\n aria-hidden=\"true\"\n />\n </Button>\n </li>);\n })}\n </ul>\n {suggestions ? (<Autocomplete\n {...inputProps}\n {...suggestions}\n value={draft}\n controlSize={controlSize}\n rootClassName={cn(\"gridui-tag-input-suggestions gridui-u-tag-input--min-w-24 gridui-u-tag-input--w-0 gridui-u-tag-input--flex-1\")}\n onOptionSelect={(option) => {\n add([option.value]);\n }}\n />)\n : (<input\n {...inputProps}\n type=\"text\"\n />)}\n <ListFieldControl\n ref={native}\n name={name}\n form={form}\n required={required}\n disabled={disabled}\n value={selected}\n onInvalidFocus={() => {\n control.current?.focus();\n }}\n >\n {selected.map(tag => {\n return (<option\n key={tag}\n value={tag}\n >\n {tag}\n </option>);\n })}\n </ListFieldControl>\n </div>);\n};\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
package/dist/styles.css CHANGED
@@ -1,4 +1,4 @@
1
- /*! tailwindcss v4.3.4 | MIT License | https://tailwindcss.com */
1
+ /*! tailwindcss v4.3.5 | MIT License | https://tailwindcss.com */
2
2
  @layer properties;
3
3
  @layer theme, base, components, utilities;
4
4
  @layer theme {
@@ -7,73 +7,109 @@
7
7
  }
8
8
  }
9
9
  @layer utilities {
10
- .gridui-u-contents {
10
+ .gridui-u-tag-input--contents {
11
11
  display: contents;
12
12
  }
13
- .gridui-u-flex {
13
+ .gridui-u-tag-input--flex {
14
14
  display: flex;
15
15
  }
16
- .gridui-u-inline-flex {
16
+ .gridui-u-tag-input--inline-flex {
17
17
  display: inline-flex;
18
18
  }
19
- .gridui-u-max-w-full {
19
+ .gridui-u-tag-input--min-h-0 {
20
+ min-height: 0px;
21
+ }
22
+ .gridui-u-tag-input--w-0 {
23
+ width: 0px;
24
+ }
25
+ .gridui-u-tag-input--w-full {
26
+ width: 100%;
27
+ }
28
+ .gridui-u-tag-input--max-w-full {
20
29
  max-width: 100%;
21
30
  }
22
- .gridui-u-min-w-0 {
31
+ .gridui-u-tag-input--min-w-0 {
23
32
  min-width: 0px;
24
33
  }
25
- .gridui-u-min-w-24 {
34
+ .gridui-u-tag-input--min-w-24 {
26
35
  min-width: calc(var(--spacing) * 24);
27
36
  }
28
- .gridui-u-flex-1 {
37
+ .gridui-u-tag-input--flex-1 {
29
38
  flex: 1;
30
39
  }
31
- .gridui-u-list-none {
40
+ .gridui-u-tag-input--list-none {
32
41
  list-style-type: none;
33
42
  }
34
- .gridui-u-flex-wrap {
43
+ .gridui-u-tag-input--flex-wrap {
35
44
  flex-wrap: wrap;
36
45
  }
37
- .gridui-u-items-center {
46
+ .gridui-u-tag-input--items-center {
38
47
  align-items: center;
39
48
  }
40
- .gridui-u-gap-gridui-4 {
49
+ .gridui-u-tag-input--gap-gridui-4 {
41
50
  gap: var(--gridui-space-4);
42
51
  }
43
- .gridui-u-border {
52
+ .gridui-u-tag-input--border {
44
53
  border-style: var(--tw-border-style);
45
54
  border-width: 1px;
46
55
  }
47
- .gridui-u-border-0 {
56
+ .gridui-u-tag-input--border-0 {
48
57
  border-style: var(--tw-border-style);
49
58
  border-width: 0px;
50
59
  }
51
- .gridui-u-border-border {
60
+ .gridui-u-tag-input--border-border {
52
61
  border-color: var(--gridui-border);
53
62
  }
54
- .gridui-u-bg-surface {
63
+ .gridui-u-tag-input--bg-surface {
55
64
  background-color: var(--gridui-surface);
56
65
  }
57
- .gridui-u-bg-transparent {
66
+ .gridui-u-tag-input--bg-transparent {
58
67
  background-color: transparent;
59
68
  }
60
- .gridui-u-ps-gridui-8 {
69
+ .gridui-u-tag-input--p-0 {
70
+ padding: 0px;
71
+ }
72
+ .gridui-u-tag-input--ps-gridui-8 {
61
73
  padding-inline-start: var(--gridui-space-8);
62
74
  }
63
- .gridui-u-type-input {
75
+ .gridui-u-tag-input--type-input {
64
76
  font: var(--gridui-type-input);
65
77
  letter-spacing: normal;
66
78
  }
67
- .gridui-u-wrap-anywhere {
79
+ .gridui-u-tag-input--wrap-anywhere {
68
80
  overflow-wrap: anywhere;
69
81
  }
70
- .gridui-u-text-foreground {
82
+ .gridui-u-tag-input--text-foreground {
71
83
  color: var(--gridui-foreground);
72
84
  }
73
- .gridui-u-has-\[input\:disabled\]\:opacity-50:has(:is(input:disabled)) {
85
+ .gridui-u-tag-input--outline-none {
86
+ --tw-outline-style: none;
87
+ outline-style: none;
88
+ }
89
+ .gridui-u-tag-input--has-\[input\:disabled\]\:opacity-50:has(:is(input:disabled)) {
74
90
  opacity: 50%;
75
91
  }
76
92
  }
93
+ @layer components {
94
+ .gridui-tag-input {
95
+ position: relative;
96
+ &:has(input:focus-visible) {
97
+ z-index: var(--gridui-z-interaction);
98
+ outline: var(--gridui-focus-width) solid var(--gridui-focus-color);
99
+ outline-offset: var(--gridui-focus-offset);
100
+ }
101
+ @media (hover: hover) and (pointer: fine) {
102
+ &:has(input:hover:not(:disabled, [readonly])):not(:has(:focus-visible)) {
103
+ z-index: var(--gridui-z-boundary);
104
+ outline: var(--gridui-hover-width) solid var(--gridui-focus-color);
105
+ @supports (color: color-mix(in lab, red, red)) {
106
+ outline: var(--gridui-hover-width) solid color-mix(in srgb, var(--gridui-focus-color) var(--gridui-hover-opacity), transparent);
107
+ }
108
+ outline-offset: var(--gridui-hover-offset);
109
+ }
110
+ }
111
+ }
112
+ }
77
113
  @property --tw-border-style {
78
114
  syntax: "*";
79
115
  inherits: false;
@@ -6,11 +6,17 @@
6
6
  */
7
7
  import { type TagRejection } from "./model";
8
8
  import { type ListFieldProps } from "@gridui/form";
9
+ import { type AutocompleteProps } from "@gridui/select";
9
10
  import { type ComponentPropsWithRef, type FC } from "react";
10
11
  export type TagInputProps = Omit<ComponentPropsWithRef<"input">, "value" | "defaultValue" | "onChange" | "type" | "size"> & ListFieldProps & {
11
12
  readonly listLabel: string;
12
13
  readonly removeLabel: (tag: string) => string;
13
14
  readonly maxTags?: number;
15
+ readonly controlSize?: "standard" | "small";
16
+ readonly draft?: string;
17
+ readonly defaultDraft?: string;
18
+ readonly onDraftChange?: (value: string) => void;
19
+ readonly suggestions?: Pick<AutocompleteProps, "options" | "searchLabel" | "emptyLabel" | "loading" | "loadingLabel" | "errorLabel" | "resultCountLabel" | "filterOptions" | "portalContainer">;
14
20
  readonly validateTag?: (tag: string) => boolean;
15
21
  readonly onReject?: (rejection: TagRejection) => void;
16
22
  };
package/docs/catalog.json CHANGED
@@ -1,12 +1,14 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "name": "@gridui/tag-input",
4
- "version": "1.0.7",
4
+ "version": "1.1.0",
5
5
  "category": "core",
6
6
  "description": "GridUI React tag input",
7
7
  "usage": "Input supplies the control surface, Button supplies tag actions, and Form hides the native multiple-value bridge. Applications own routes, labels, state persistence, and branding.",
8
8
  "documentation": [
9
- "README.md"
9
+ "README.md",
10
+ "docs/reference/README.md",
11
+ "docs/reference/tag-input.md"
10
12
  ],
11
13
  "exports": [
12
14
  {
@@ -36,6 +38,7 @@
36
38
  "@gridui/form/styles.css",
37
39
  "@gridui/overlay/styles.css",
38
40
  "@gridui/input/styles.css",
41
+ "@gridui/select/styles.css",
39
42
  "@gridui/tag-input/styles.css"
40
43
  ],
41
44
  "examples": [
@@ -0,0 +1,4 @@
1
+ <!-- Generated by pnpm docs:storybook. -->
2
+ # Component reference
3
+
4
+ - [TagInput](tag-input.md)
@@ -0,0 +1,135 @@
1
+ <!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
2
+ # TagInput
3
+
4
+ Edits a list of text values as removable tags. Use it for keywords or other entries that users create directly.
5
+
6
+ Import from ``@gridui/tag-input`` and load Theme before this family's stylesheet.
7
+
8
+ ```tsx
9
+ import { TagInput } from "@gridui/tag-input";
10
+ import "@gridui/theme/styles.css";
11
+ import "@gridui/tag-input/styles.css";
12
+ ```
13
+
14
+ Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/tag-input/README.md) for shared behavior and stylesheet dependencies.
15
+
16
+ The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/tag-input/stories/tag-input.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
17
+
18
+ ## API
19
+
20
+ 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.
21
+
22
+ ### form
23
+
24
+ ``string | undefined`` · Optional
25
+
26
+ ### children
27
+
28
+ ``ReactNode`` · Optional
29
+
30
+ Content rendered inside the component.
31
+
32
+ ### onFocus
33
+
34
+ ``(event: FocusEvent<HTMLInputElement, Element>): void`` · Optional
35
+
36
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
37
+
38
+ ### onBlur
39
+
40
+ ``(event: FocusEvent<HTMLInputElement, Element>): void`` · Optional
41
+
42
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
43
+
44
+ ### onSubmit
45
+
46
+ ``(event: SubmitEvent<HTMLInputElement>): void`` · Optional
47
+
48
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
49
+
50
+ ### onClick
51
+
52
+ ``(event: MouseEvent<HTMLInputElement, MouseEvent>): void`` · Optional
53
+
54
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
55
+
56
+ ### disabled
57
+
58
+ ``boolean | undefined`` · Optional
59
+
60
+ Prevents interaction when enabled.
61
+
62
+ ### readOnly
63
+
64
+ ``boolean | undefined`` · Optional
65
+
66
+ Allows reading without changing the value.
67
+
68
+ ### value
69
+
70
+ ``readonly string[] | undefined`` · Optional
71
+
72
+ Controlled value. Pair with the corresponding change callback.
73
+
74
+ ### defaultValue
75
+
76
+ ``readonly string[] | undefined`` · Optional
77
+
78
+ Initial uncontrolled value. Reset the story after changing it.
79
+
80
+ ### onValueChange
81
+
82
+ ``(value: string[]): void`` · Optional
83
+
84
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
85
+
86
+ ### listLabel
87
+
88
+ ``string`` · Required
89
+
90
+ ### removeLabel
91
+
92
+ ``(tag: string) => string`` · Required
93
+
94
+ ### maxTags
95
+
96
+ ``number | undefined`` · Optional
97
+
98
+ Default: ``Infinity``
99
+
100
+ ### controlSize
101
+
102
+ ``"small" | "standard" | undefined`` · Optional
103
+
104
+ Default: ``"standard"``
105
+
106
+ ### draft
107
+
108
+ ``string | undefined`` · Optional
109
+
110
+ ### defaultDraft
111
+
112
+ ``string | undefined`` · Optional
113
+
114
+ Default: ``""``
115
+
116
+ ### onDraftChange
117
+
118
+ ``(value: string): void`` · Optional
119
+
120
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
121
+
122
+ ### suggestions
123
+
124
+ ``Pick<AutocompleteProps, "loading" | "filterOptions" | "loadingLabel" | "errorLabel" | "resultCountLabel" | "options" | "searchLabel" | "emptyLabel" | "portalContainer"> | undefined`` · Optional
125
+
126
+ ### validateTag
127
+
128
+ ``((tag: string) => boolean) | undefined`` · Optional
129
+
130
+ ### onReject
131
+
132
+ ``(rejection: TagRejection): void`` · Optional
133
+
134
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
135
+
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gridui/tag-input",
3
- "version": "1.0.7",
3
+ "version": "1.1.0",
4
4
  "description": "GridUI React tag input",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",
@@ -27,13 +27,14 @@
27
27
  "react-dom": "^19.2.0"
28
28
  },
29
29
  "dependencies": {
30
- "@gridui/button": "^3.1.2",
31
- "@gridui/form": "^3.0.2",
32
- "@gridui/input": "^1.1.6",
30
+ "@gridui/button": "^4.0.0",
31
+ "@gridui/form": "^4.1.0",
32
+ "@gridui/input": "^3.0.0",
33
33
  "@gridui/interaction": "^1.2.1",
34
- "@gridui/style-utils": "^2.2.2",
34
+ "@gridui/select": "^1.2.0",
35
+ "@gridui/style-utils": "^3.0.0",
35
36
  "@gridui/theme": "^2.5.3",
36
- "lucide-react": "1.69.0"
37
+ "lucide-react": "1.70.0"
37
38
  },
38
39
  "devDependencies": {
39
40
  "@gridui-internal/configuration": "0.0.0-internal",