@skdx/react 0.28.0 → 0.29.0

package/dist/tags-input/types.d.cts

@@ -1,20 +1,13 @@
 import type { FormValidityHandle } from '../utils/formControl.cjs';
 import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
 /**
- * Refusal detail: which validation rule rejected a candidate tag and the
- * trimmed text that failed. Fired once per refused candidate via `onValueInvalid`.
+ * Refusal detail: which validation rule rejected a candidate tag, fired once per refused candidate via `onValueInvalid`.
  */
 export interface TagsInputInvalidDetail {
     /** The candidate, already trimmed — the same text that would have been committed. */
     tag: string;
-    /**
-     * The rule that refused it, in the fixed order the contract's
-     * `validationBehavior` sets: `'empty'` (blank after trimming), `'max'` (the
-     * list is already full), `'validate'` (the consumer predicate returned
-     * `false`) and `'duplicate'` (the built-in rule `allowDuplicates` switches
-     * off).
-     */
-    reason: 'empty' | 'max' | 'validate' | 'duplicate';
+    /** The rule that refused it: `'empty'`, `'max'`, `'validator'`, or `'duplicate'`. */
+    reason: 'empty' | 'max' | 'validator' | 'duplicate';
 }
 /** @internal Context state distributed from TagsInput to its parts. */
 export interface TagsInputContextValue {
@@ -24,38 +17,27 @@ export interface TagsInputContextValue {
     disabled: boolean;
     invalid: boolean;
     readOnly: boolean;
-    max?: number;
+    /** Default accessible name for the draft field, so a hand-composed `TagsInputInput` is never unnamed. */
+    inputLabel: string;
+    max?: number | undefined;
     delimiter: string | string[];
     addOnPaste: boolean;
     /** What an unfocused draft does with text the user typed but never committed. */
     blurBehavior: 'keep' | 'clear' | 'commit';
     /** Whether a committed tag may be opened for editing in a `TagsInputItemInput`. */
     editable: boolean;
-    /**
-     * Which tag is currently open for editing, or `null`. Clamped against the tag
-     * count, so a tag removed while another was being edited cannot leave an
-     * editor open over an index that no longer exists.
-     */
+    /** Which tag is currently open for editing, or `null`, clamped against the tag count. */
     editingIndex: number | null;
     /** Opens (or, with `null`, closes) the editor over the tag at that index. */
     setEditingIndex: (index: number | null) => void;
-    /**
-     * Writes `tag` back to the tag at `index`, through the same ordered refusal
-     * rules a new tag runs — minus `max`, which an edit cannot breach. The
-     * candidate is judged against the list *without* the edited tag in it, or
-     * re-committing a tag unchanged would be a duplicate of itself.
-     */
+    /** Writes `tag` back to the tag at `index`, through the same refusal rules a new tag runs, minus `max`. */
     setTagAtIndex: (index: number, tag: string) => void;
-    /** Empties the whole list in one change. A no-op on an already-empty field. */
+    /** Empties the whole list in one change, a no-op when it is already empty. */
     clearTags: () => void;
     addTag: (tag: string) => void;
     addTags: (tags: string[]) => void;
     removeTag: (index: number) => void;
-    /**
-     * Index of the tag currently owning the strip's single Tab stop. Clamped
-     * against the tag count, so removing the tag that held it never leaves the
-     * whole strip out of the tab order.
-     */
+    /** Index of the tag currently owning the strip's single Tab stop, clamped against the tag count. */
     tabStopIndex: number;
     /** Claims the Tab stop for the tag at `index` — called when one takes focus, and after a removal hands focus on. */
     setActiveIndex: (index: number) => void;
@@ -63,164 +45,133 @@ export interface TagsInputContextValue {
 /** Props for the {@link TagsInput} root. */
 export interface TagsInputProps extends Omit<PrimitivePropsWithRef<'div'>, 'defaultValue' | 'onChange'> {
     /**
-     * Placeholder for the derived draft field. Forwarded onto the `<input>`
-     * itself, never onto the root wrapper. Ignored when `children` is given,
-     * which switches to full manual composition.
+     * Placeholder for the derived draft field, forwarded onto the `<input>` and ignored when `children` is given.
      * @default undefined — the draft field has no placeholder.
      */
-    placeholder?: string;
+    placeholder?: string | undefined;
     /**
-     * Accessible name of the derived draft field, emitted as its `aria-label`.
-     * A placeholder is not a name, so this is what the field is announced as.
-     * Ignored when `children` is given.
+     * Accessible name of the derived draft field, emitted as its `aria-label`; ignored when `children` is given.
      * @default 'Add a tag'
      */
-    inputLabel?: string;
+    inputLabel?: string | undefined;
     /**
-     * Renders the derived `TagsInputClear` button, which empties the whole list in one
-     * press. Ignored when `children` is given.
+     * Renders the derived `TagsInputClear` button, which empties the whole list in one press; ignored with `children`.
      * @default false
      */
-    clearable?: boolean;
+    clearable?: boolean | undefined;
     /**
-     * Current tags, for controlled usage. Pair with `onValueChange`.
+     * Current tags, for controlled usage; pair with `onValueChange`.
      * @default undefined — uncontrolled, tracks its own tag list internally.
      */
-    value?: string[];
+    value?: string[] | undefined;
     /**
      * Initial tags, for uncontrolled usage — seeds the internally-tracked list.
      * @default []
      */
-    defaultValue?: string[];
+    defaultValue?: string[] | undefined;
     /**
      * Fires with the new tag list whenever it changes (add or remove), controlled or not.
      * @default undefined — no-op.
      */
-    onValueChange?: (tags: string[]) => void;
+    onValueChange?: ((tags: string[]) => void) | undefined;
     /**
      * Disables adding/removing tags and marks the root and its parts with
      * `data-disabled`.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Marks the field as invalid, exposed as `data-invalid` on the root and
      * `aria-invalid`/`data-invalid` on `TagsInputInput`.
      * @default false
      */
-    invalid?: boolean;
+    invalid?: boolean | undefined;
     /**
      * Makes `TagsInputInput` read-only (native `readOnly`, plus
      * `aria-readonly`/`data-readonly` on the root and the input).
      * @default false
      */
-    readOnly?: boolean;
+    readOnly?: boolean | undefined;
     /**
      * Maximum number of tags; further `addTag` calls are no-ops once reached.
      * @default undefined — unlimited.
      */
-    max?: number;
+    max?: number | undefined;
     /**
-     * Characters that commit the draft as a tag while typing, and that pasted
-     * text is split on. Pasted text is split on every entry; the typed commit
-     * only ever fires for an entry that is a single character, since it is
-     * compared against a `KeyboardEvent.key`. The newline in the default is what
-     * makes a list pasted out of a spreadsheet or a textarea arrive as tags
-     * rather than as one tag holding the whole clipboard.
+     * Characters that commit the draft while typing and that pasted text is split on; only single-character entries can trigger a typed commit.
      * @default [',', '\n']
      */
-    delimiter?: string | string[];
+    delimiter?: string | string[] | undefined;
     /**
-     * What happens to typed but uncommitted draft text when `TagsInputInput`
-     * loses focus: `'keep'` leaves it in place, `'clear'` discards it, and
-     * `'commit'` adds it as a tag through the same ordered refusal rules a typed
-     * commit runs.
+     * What happens to uncommitted draft text when `TagsInputInput` loses focus: `'keep'`, `'clear'`, or `'commit'`.
      * @default 'keep'
      */
-    blurBehavior?: 'keep' | 'clear' | 'commit';
+    blurBehavior?: 'keep' | 'clear' | 'commit' | undefined;
     /**
-     * Whether a committed tag can be edited in place rather than deleted and
-     * retyped. `Enter` on a focused tag opens its `TagsInputItemInput`, `Enter`
-     * commits the edit and `Escape` leaves the tag as it was.
+     * Whether a committed tag can be edited in place via `Enter` on a focused tag, committed by `Enter` and cancelled by `Escape`.
      * @default false
      */
-    editable?: boolean;
+    editable?: boolean | undefined;
     /**
      * Commit pasted text as tags (split on `delimiter`) instead of dropping it
      * into the draft field.
      * @default true
      */
-    addOnPaste?: boolean;
+    addOnPaste?: boolean | undefined;
     /**
-     * Decides whether a tag may be added, given the trimmed candidate and the
-     * tags accepted so far. Return `false` to reject it. Must be pure — it runs
-     * inside the state updater, so React may call it more than once per commit.
+     * Decides whether a tag may be added, given the trimmed candidate and the tags accepted so far; must be pure, since it can run more than once per commit.
      * @default undefined — every non-empty, non-duplicate tag is accepted.
      */
-    validate?: (tag: string, tags: string[]) => boolean;
+    validator?: ((tag: string, tags: string[]) => boolean) | undefined;
     /**
-     * Whether the same tag may appear more than once.
-     *
-     * The built-in rule is an exact match on the trimmed candidate, which is not
-     * everyone's idea of a duplicate — "React" and "react" are two tags here and
-     * one tag in most products. `validate` runs *before* it and a `true` return
-     * overrides it, so a caller can implement case-insensitive or normalised
-     * matching; set this when duplicates are simply allowed.
+     * Whether the same tag, matched by exact trimmed text, may appear more than once.
      * @default false
      */
-    allowDuplicates?: boolean;
+    allowDuplicates?: boolean | undefined;
     /**
-     * Current draft text in `TagsInputInput`, for controlled usage. Pair with
-     * `onInputValueChange`.
+     * Current draft text in `TagsInputInput`, for controlled usage; pair with `onInputValueChange`.
      * @default undefined — uncontrolled, the root tracks the draft internally.
      */
-    inputValue?: string;
+    inputValue?: string | undefined;
     /**
      * Initial draft text, for uncontrolled usage.
      * @default ''
      */
-    defaultInputValue?: string;
+    defaultInputValue?: string | undefined;
     /**
      * Fires with the new draft text whenever it changes — typing, or the reset
      * to empty after a tag is committed.
      * @default undefined — no-op.
      */
-    onInputValueChange?: (inputValue: string) => void;
+    onInputValueChange?: ((inputValue: string) => void) | undefined;
     /**
-     * Fires once for every candidate tag the field refuses, carrying the trimmed
-     * candidate and which rule refused it. A refused tag otherwise simply
-     * vanishes, so this is the only way an application can tell a rejected paste
-     * from an accepted one, or announce why nothing appeared.
+     * Fires once for every candidate tag the field refuses, carrying the trimmed candidate and the rule that refused it.
      * @default undefined — no-op.
      */
-    onValueInvalid?: (detail: TagsInputInvalidDetail) => void;
+    onValueInvalid?: ((detail: TagsInputInvalidDetail) => void) | undefined;
     /**
-     * Form field name. Every tag is submitted as its own entry under it — the
-     * shape a set of repeated same-named inputs produces — so
-     * `new FormData(form).getAll(name)` gives back the tags in order.
+     * Form field name; every tag submits as its own entry under it, so `formData.getAll(name)` returns them in order.
      * @default undefined — the field submits nothing.
      */
-    name?: string;
+    name?: string | undefined;
     /**
-     * Marks the field required: `valueMissing` while there are no tags, reported
-     * through `checkValidity()`/`reportValidity()` on the ref. Only meaningful
-     * with `name`, since a field that submits nothing cannot be invalid.
+     * Marks the field required, reporting `valueMissing` while there are no tags through `checkValidity()`/`reportValidity()`.
      * @default false
      */
-    required?: boolean;
+    required?: boolean | undefined;
     /**
-     * Id of the `<form>` this field submits to, for a TagsInput rendered outside
-     * it — the native `form` attribute, set on every mirrored input.
+     * Id of the `<form>` this field submits to, set as the native `form` attribute on every mirrored input.
      * @default undefined — the enclosing `<form>`, if any.
      */
-    form?: string;
+    form?: string | undefined;
+    /**
+     * Size rung the skin scales the field by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
 }
 /**
- * What a `ref` on {@link TagsInput} gives you: the root `<div>` — still the
- * node to focus, measure and `contains()` — with the constraint-validation
- * methods assigned onto it, since a tags input has no native element of its
- * own for them to be inherited from. Type the ref with it to reach them:
- * `React.useRef<TagsInputHandle>(null)`.
+ * What a `ref` on {@link TagsInput} gives you: the root `<div>` with constraint-validation methods assigned onto it.
  */
 export type TagsInputHandle = HTMLDivElement & FormValidityHandle;
 /** Props for a single {@link TagsInputItem} — a rendered tag. */
@@ -236,10 +187,7 @@ export interface TagsInputItemDeleteProps extends PrimitivePropsWithRef<'button'
 /** Props for {@link TagsInputInput}, the text field used to type and commit new tags. */
 export interface TagsInputInputProps extends Omit<PrimitivePropsWithRef<'input'>, 'value' | 'defaultValue'> {
 }
-/**
- * Props for {@link TagsInputItemInput}, the field a tag becomes while it is
- * being edited.
- */
+/** Props for {@link TagsInputItemInput}, the field a tag becomes while it is being edited. */
 export interface TagsInputItemInputProps extends Omit<PrimitivePropsWithRef<'input'>, 'value' | 'defaultValue'> {
     /** Position of the tag this editor edits, in the root's `value` array. */
     index: number;

package/dist/tags-input/types.d.ts

@@ -1,20 +1,13 @@
 import type { FormValidityHandle } from '../utils/formControl.js';
 import type { PrimitivePropsWithRef } from '../utils/primitive.js';
 /**
- * Refusal detail: which validation rule rejected a candidate tag and the
- * trimmed text that failed. Fired once per refused candidate via `onValueInvalid`.
+ * Refusal detail: which validation rule rejected a candidate tag, fired once per refused candidate via `onValueInvalid`.
  */
 export interface TagsInputInvalidDetail {
     /** The candidate, already trimmed — the same text that would have been committed. */
     tag: string;
-    /**
-     * The rule that refused it, in the fixed order the contract's
-     * `validationBehavior` sets: `'empty'` (blank after trimming), `'max'` (the
-     * list is already full), `'validate'` (the consumer predicate returned
-     * `false`) and `'duplicate'` (the built-in rule `allowDuplicates` switches
-     * off).
-     */
-    reason: 'empty' | 'max' | 'validate' | 'duplicate';
+    /** The rule that refused it: `'empty'`, `'max'`, `'validator'`, or `'duplicate'`. */
+    reason: 'empty' | 'max' | 'validator' | 'duplicate';
 }
 /** @internal Context state distributed from TagsInput to its parts. */
 export interface TagsInputContextValue {
@@ -24,38 +17,27 @@ export interface TagsInputContextValue {
     disabled: boolean;
     invalid: boolean;
     readOnly: boolean;
-    max?: number;
+    /** Default accessible name for the draft field, so a hand-composed `TagsInputInput` is never unnamed. */
+    inputLabel: string;
+    max?: number | undefined;
     delimiter: string | string[];
     addOnPaste: boolean;
     /** What an unfocused draft does with text the user typed but never committed. */
     blurBehavior: 'keep' | 'clear' | 'commit';
     /** Whether a committed tag may be opened for editing in a `TagsInputItemInput`. */
     editable: boolean;
-    /**
-     * Which tag is currently open for editing, or `null`. Clamped against the tag
-     * count, so a tag removed while another was being edited cannot leave an
-     * editor open over an index that no longer exists.
-     */
+    /** Which tag is currently open for editing, or `null`, clamped against the tag count. */
     editingIndex: number | null;
     /** Opens (or, with `null`, closes) the editor over the tag at that index. */
     setEditingIndex: (index: number | null) => void;
-    /**
-     * Writes `tag` back to the tag at `index`, through the same ordered refusal
-     * rules a new tag runs — minus `max`, which an edit cannot breach. The
-     * candidate is judged against the list *without* the edited tag in it, or
-     * re-committing a tag unchanged would be a duplicate of itself.
-     */
+    /** Writes `tag` back to the tag at `index`, through the same refusal rules a new tag runs, minus `max`. */
     setTagAtIndex: (index: number, tag: string) => void;
-    /** Empties the whole list in one change. A no-op on an already-empty field. */
+    /** Empties the whole list in one change, a no-op when it is already empty. */
     clearTags: () => void;
     addTag: (tag: string) => void;
     addTags: (tags: string[]) => void;
     removeTag: (index: number) => void;
-    /**
-     * Index of the tag currently owning the strip's single Tab stop. Clamped
-     * against the tag count, so removing the tag that held it never leaves the
-     * whole strip out of the tab order.
-     */
+    /** Index of the tag currently owning the strip's single Tab stop, clamped against the tag count. */
     tabStopIndex: number;
     /** Claims the Tab stop for the tag at `index` — called when one takes focus, and after a removal hands focus on. */
     setActiveIndex: (index: number) => void;
@@ -63,164 +45,133 @@ export interface TagsInputContextValue {
 /** Props for the {@link TagsInput} root. */
 export interface TagsInputProps extends Omit<PrimitivePropsWithRef<'div'>, 'defaultValue' | 'onChange'> {
     /**
-     * Placeholder for the derived draft field. Forwarded onto the `<input>`
-     * itself, never onto the root wrapper. Ignored when `children` is given,
-     * which switches to full manual composition.
+     * Placeholder for the derived draft field, forwarded onto the `<input>` and ignored when `children` is given.
      * @default undefined — the draft field has no placeholder.
      */
-    placeholder?: string;
+    placeholder?: string | undefined;
     /**
-     * Accessible name of the derived draft field, emitted as its `aria-label`.
-     * A placeholder is not a name, so this is what the field is announced as.
-     * Ignored when `children` is given.
+     * Accessible name of the derived draft field, emitted as its `aria-label`; ignored when `children` is given.
      * @default 'Add a tag'
      */
-    inputLabel?: string;
+    inputLabel?: string | undefined;
     /**
-     * Renders the derived `TagsInputClear` button, which empties the whole list in one
-     * press. Ignored when `children` is given.
+     * Renders the derived `TagsInputClear` button, which empties the whole list in one press; ignored with `children`.
      * @default false
      */
-    clearable?: boolean;
+    clearable?: boolean | undefined;
     /**
-     * Current tags, for controlled usage. Pair with `onValueChange`.
+     * Current tags, for controlled usage; pair with `onValueChange`.
      * @default undefined — uncontrolled, tracks its own tag list internally.
      */
-    value?: string[];
+    value?: string[] | undefined;
     /**
      * Initial tags, for uncontrolled usage — seeds the internally-tracked list.
      * @default []
      */
-    defaultValue?: string[];
+    defaultValue?: string[] | undefined;
     /**
      * Fires with the new tag list whenever it changes (add or remove), controlled or not.
      * @default undefined — no-op.
      */
-    onValueChange?: (tags: string[]) => void;
+    onValueChange?: ((tags: string[]) => void) | undefined;
     /**
      * Disables adding/removing tags and marks the root and its parts with
      * `data-disabled`.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Marks the field as invalid, exposed as `data-invalid` on the root and
      * `aria-invalid`/`data-invalid` on `TagsInputInput`.
      * @default false
      */
-    invalid?: boolean;
+    invalid?: boolean | undefined;
     /**
      * Makes `TagsInputInput` read-only (native `readOnly`, plus
      * `aria-readonly`/`data-readonly` on the root and the input).
      * @default false
      */
-    readOnly?: boolean;
+    readOnly?: boolean | undefined;
     /**
      * Maximum number of tags; further `addTag` calls are no-ops once reached.
      * @default undefined — unlimited.
      */
-    max?: number;
+    max?: number | undefined;
     /**
-     * Characters that commit the draft as a tag while typing, and that pasted
-     * text is split on. Pasted text is split on every entry; the typed commit
-     * only ever fires for an entry that is a single character, since it is
-     * compared against a `KeyboardEvent.key`. The newline in the default is what
-     * makes a list pasted out of a spreadsheet or a textarea arrive as tags
-     * rather than as one tag holding the whole clipboard.
+     * Characters that commit the draft while typing and that pasted text is split on; only single-character entries can trigger a typed commit.
      * @default [',', '\n']
      */
-    delimiter?: string | string[];
+    delimiter?: string | string[] | undefined;
     /**
-     * What happens to typed but uncommitted draft text when `TagsInputInput`
-     * loses focus: `'keep'` leaves it in place, `'clear'` discards it, and
-     * `'commit'` adds it as a tag through the same ordered refusal rules a typed
-     * commit runs.
+     * What happens to uncommitted draft text when `TagsInputInput` loses focus: `'keep'`, `'clear'`, or `'commit'`.
      * @default 'keep'
      */
-    blurBehavior?: 'keep' | 'clear' | 'commit';
+    blurBehavior?: 'keep' | 'clear' | 'commit' | undefined;
     /**
-     * Whether a committed tag can be edited in place rather than deleted and
-     * retyped. `Enter` on a focused tag opens its `TagsInputItemInput`, `Enter`
-     * commits the edit and `Escape` leaves the tag as it was.
+     * Whether a committed tag can be edited in place via `Enter` on a focused tag, committed by `Enter` and cancelled by `Escape`.
      * @default false
      */
-    editable?: boolean;
+    editable?: boolean | undefined;
     /**
      * Commit pasted text as tags (split on `delimiter`) instead of dropping it
      * into the draft field.
      * @default true
      */
-    addOnPaste?: boolean;
+    addOnPaste?: boolean | undefined;
     /**
-     * Decides whether a tag may be added, given the trimmed candidate and the
-     * tags accepted so far. Return `false` to reject it. Must be pure — it runs
-     * inside the state updater, so React may call it more than once per commit.
+     * Decides whether a tag may be added, given the trimmed candidate and the tags accepted so far; must be pure, since it can run more than once per commit.
      * @default undefined — every non-empty, non-duplicate tag is accepted.
      */
-    validate?: (tag: string, tags: string[]) => boolean;
+    validator?: ((tag: string, tags: string[]) => boolean) | undefined;
     /**
-     * Whether the same tag may appear more than once.
-     *
-     * The built-in rule is an exact match on the trimmed candidate, which is not
-     * everyone's idea of a duplicate — "React" and "react" are two tags here and
-     * one tag in most products. `validate` runs *before* it and a `true` return
-     * overrides it, so a caller can implement case-insensitive or normalised
-     * matching; set this when duplicates are simply allowed.
+     * Whether the same tag, matched by exact trimmed text, may appear more than once.
      * @default false
      */
-    allowDuplicates?: boolean;
+    allowDuplicates?: boolean | undefined;
     /**
-     * Current draft text in `TagsInputInput`, for controlled usage. Pair with
-     * `onInputValueChange`.
+     * Current draft text in `TagsInputInput`, for controlled usage; pair with `onInputValueChange`.
      * @default undefined — uncontrolled, the root tracks the draft internally.
      */
-    inputValue?: string;
+    inputValue?: string | undefined;
     /**
      * Initial draft text, for uncontrolled usage.
      * @default ''
      */
-    defaultInputValue?: string;
+    defaultInputValue?: string | undefined;
     /**
      * Fires with the new draft text whenever it changes — typing, or the reset
      * to empty after a tag is committed.
      * @default undefined — no-op.
      */
-    onInputValueChange?: (inputValue: string) => void;
+    onInputValueChange?: ((inputValue: string) => void) | undefined;
     /**
-     * Fires once for every candidate tag the field refuses, carrying the trimmed
-     * candidate and which rule refused it. A refused tag otherwise simply
-     * vanishes, so this is the only way an application can tell a rejected paste
-     * from an accepted one, or announce why nothing appeared.
+     * Fires once for every candidate tag the field refuses, carrying the trimmed candidate and the rule that refused it.
      * @default undefined — no-op.
      */
-    onValueInvalid?: (detail: TagsInputInvalidDetail) => void;
+    onValueInvalid?: ((detail: TagsInputInvalidDetail) => void) | undefined;
     /**
-     * Form field name. Every tag is submitted as its own entry under it — the
-     * shape a set of repeated same-named inputs produces — so
-     * `new FormData(form).getAll(name)` gives back the tags in order.
+     * Form field name; every tag submits as its own entry under it, so `formData.getAll(name)` returns them in order.
      * @default undefined — the field submits nothing.
      */
-    name?: string;
+    name?: string | undefined;
     /**
-     * Marks the field required: `valueMissing` while there are no tags, reported
-     * through `checkValidity()`/`reportValidity()` on the ref. Only meaningful
-     * with `name`, since a field that submits nothing cannot be invalid.
+     * Marks the field required, reporting `valueMissing` while there are no tags through `checkValidity()`/`reportValidity()`.
      * @default false
      */
-    required?: boolean;
+    required?: boolean | undefined;
     /**
-     * Id of the `<form>` this field submits to, for a TagsInput rendered outside
-     * it — the native `form` attribute, set on every mirrored input.
+     * Id of the `<form>` this field submits to, set as the native `form` attribute on every mirrored input.
      * @default undefined — the enclosing `<form>`, if any.
      */
-    form?: string;
+    form?: string | undefined;
+    /**
+     * Size rung the skin scales the field by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
 }
 /**
- * What a `ref` on {@link TagsInput} gives you: the root `<div>` — still the
- * node to focus, measure and `contains()` — with the constraint-validation
- * methods assigned onto it, since a tags input has no native element of its
- * own for them to be inherited from. Type the ref with it to reach them:
- * `React.useRef<TagsInputHandle>(null)`.
+ * What a `ref` on {@link TagsInput} gives you: the root `<div>` with constraint-validation methods assigned onto it.
  */
 export type TagsInputHandle = HTMLDivElement & FormValidityHandle;
 /** Props for a single {@link TagsInputItem} — a rendered tag. */
@@ -236,10 +187,7 @@ export interface TagsInputItemDeleteProps extends PrimitivePropsWithRef<'button'
 /** Props for {@link TagsInputInput}, the text field used to type and commit new tags. */
 export interface TagsInputInputProps extends Omit<PrimitivePropsWithRef<'input'>, 'value' | 'defaultValue'> {
 }
-/**
- * Props for {@link TagsInputItemInput}, the field a tag becomes while it is
- * being edited.
- */
+/** Props for {@link TagsInputItemInput}, the field a tag becomes while it is being edited. */
 export interface TagsInputItemInputProps extends Omit<PrimitivePropsWithRef<'input'>, 'value' | 'defaultValue'> {
     /** Position of the tag this editor edits, in the root's `value` array. */
     index: number;

package/dist/text/Text.cjs

@@ -1 +1,2 @@
-"use strict";var n=Object.create;var m=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var c=Object.getPrototypeOf,l=Object.prototype.hasOwnProperty;var d=(t,e)=>{for(var r in e)m(t,r,{get:e[r],enumerable:!0})},a=(t,e,r,p)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of P(e))!l.call(t,o)&&o!==r&&m(t,o,{get:()=>e[o],enumerable:!(p=y(e,o))||p.enumerable});return t};var R=(t,e,r)=>(r=t!=null?n(c(t)):{},a(e||!t||!t.__esModule?m(r,"default",{value:t,enumerable:!0}):r,t)),v=t=>a(m({},"__esModule",{value:!0}),t);var E={};d(E,{Text:()=>s});module.exports=v(E);var f=R(require("react"),1),i=require("../utils/part.cjs"),x=require("../utils/primitive.cjs"),T=require("react/jsx-runtime"),s=f.forwardRef(({as:t="span",...e},r)=>{let p=x.Primitive[t];return(0,T.jsx)(p,{...e,...(0,i.skdxPart)("text","root",e.className),ref:r})});s.displayName="Text";0&&(module.exports={Text});
+'use client';
+"use strict";var a=Object.defineProperty;var n=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var d=(e,t)=>{for(var o in t)a(e,o,{get:t[o],enumerable:!0})},l=(e,t,o,p)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of P(t))!T.call(e,r)&&r!==o&&a(e,r,{get:()=>t[r],enumerable:!(p=n(t,r))||p.enumerable});return e};var N=e=>l(a({},"__esModule",{value:!0}),e);var R={};d(R,{Text:()=>s});module.exports=N(R);var i=require("../utils/appearance.cjs"),f=require("../utils/part.cjs"),x=require("../utils/primitive.cjs"),c=require("react/jsx-runtime"),s=({as:e="span",size:t,tone:o,variant:p,ref:r,...m})=>{let y=x.Primitive[e];return(0,c.jsx)(y,{...m,...(0,i.appearanceAttrs)({size:t,tone:o,variant:p},m),...(0,f.skdxPart)("text","root",m.className),ref:r})};s.displayName="Text";0&&(module.exports={Text});

package/dist/text/Text.d.cts

@@ -1,11 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { TextProps } from './types.cjs';
 /**
- * A typographic primitive: one element with `.skdx-text`, tag chosen via `as`.
- *
- * Tone, weight, and scale are **attributes**, not props — `data-tone`,
- * `data-variant`, `data-size` — because they're skin concerns and independent.
- * `data-variant="numeric"` aligns tabular figures; `mono` is the monospace variant.
+ * A typographic primitive rendering one element with `.skdx-text`, tag chosen via `as` and tone/weight/scale set as `data-*` attributes.
  *
  * @example
  * ```tsx
@@ -14,4 +10,7 @@ import type { TextProps } from './types.cjs';
  * <Text as="code" data-variant="mono">--skdx-color-text-muted</Text>
  * ```
  */
-export declare const Text: React.ForwardRefExoticComponent<Omit<TextProps, "ref"> & React.RefAttributes<HTMLElement>>;
+export declare const Text: {
+    ({ as, size, tone, variant, ref: forwardedRef, ...props }: TextProps): React.ReactNode;
+    displayName: string;
+};

package/dist/text/Text.d.ts

@@ -1,11 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { TextProps } from './types.js';
 /**
- * A typographic primitive: one element with `.skdx-text`, tag chosen via `as`.
- *
- * Tone, weight, and scale are **attributes**, not props — `data-tone`,
- * `data-variant`, `data-size` — because they're skin concerns and independent.
- * `data-variant="numeric"` aligns tabular figures; `mono` is the monospace variant.
+ * A typographic primitive rendering one element with `.skdx-text`, tag chosen via `as` and tone/weight/scale set as `data-*` attributes.
  *
  * @example
  * ```tsx
@@ -14,4 +10,7 @@ import type { TextProps } from './types.js';
  * <Text as="code" data-variant="mono">--skdx-color-text-muted</Text>
  * ```
  */
-export declare const Text: React.ForwardRefExoticComponent<Omit<TextProps, "ref"> & React.RefAttributes<HTMLElement>>;
+export declare const Text: {
+    ({ as, size, tone, variant, ref: forwardedRef, ...props }: TextProps): React.ReactNode;
+    displayName: string;
+};

package/dist/text/Text.js

@@ -1 +1,2 @@
-import*as e from"react";import{skdxPart as s}from"../utils/part.js";import{Primitive as a}from"../utils/primitive.js";import{jsx as f}from"react/jsx-runtime";var r=e.forwardRef(({as:o="span",...t},p)=>{let m=a[o];return f(m,{...t,...s("text","root",t.className),ref:p})});r.displayName="Text";export{r as Text};
+'use client';
+import{appearanceAttrs as i}from"../utils/appearance.js";import{skdxPart as f}from"../utils/part.js";import{Primitive as x}from"../utils/primitive.js";import{jsx as c}from"react/jsx-runtime";var e=({as:r="span",size:o,tone:p,variant:m,ref:a,...t})=>{let s=x[r];return c(s,{...t,...i({size:o,tone:p,variant:m},t),...f("text","root",t.className),ref:a})};e.displayName="Text";export{e as Text};