{ "$schema": "https://ui.shadcn.com/schema/registry-item.json", "name": "multi-select-token-pills", "type": "registry:block", "title": "Multi-Select Token Pills", "description": "Add a tag and it pops in; remove one and the gap closes like it was never there.", "author": "Wensity ", "dependencies": [ "@tabler/icons-react", "clsx", "framer-motion", "tailwind-merge" ], "registryDependencies": [], "files": [ { "path": "registry/wensity/lib/utils.ts", "type": "registry:lib", "target": "@lib/utils.ts", "content": "import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n return twMerge(clsx(inputs));\n}\n" }, { "path": "registry/wensity/multi-select-token-pills.tsx", "type": "registry:component", "target": "@components/wensity/multi-select-token-pills.tsx", "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { motion, AnimatePresence, useReducedMotion, type Variants } from \"framer-motion\";\nimport { IconX } from \"@tabler/icons-react\";\nimport { cn } from \"@/lib/utils\";\n\nexport interface TokenPill {\n id: string;\n /** Visible label. */\n label: string;\n /** Optional secondary value (e.g., the parsed email when label is the display name). */\n value?: string;\n /** Render as invalid (red ring + accent). */\n invalid?: boolean;\n}\n\nexport interface MultiSelectTokenPillsProps {\n /** Controlled tokens. */\n value?: TokenPill[];\n /** Default for uncontrolled usage. */\n defaultValue?: TokenPill[];\n /** Notified on every add/remove. */\n onChange?: (next: TokenPill[]) => void;\n /** Placeholder for the input. */\n placeholder?: string;\n /** Validate a freshly-typed token before it is committed. Return an\n * object with `invalid: true` to keep the pill but mark it red. */\n validate?: (raw: string) => { invalid?: boolean } | void;\n /** Characters that commit the current input as a token. Defaults to\n * comma, semicolon, space, Enter, Tab. */\n delimiters?: RegExp;\n /** Maximum number of tokens. Adding past this is a no-op. */\n max?: number;\n className?: string;\n /** Optional label rendered above the field. */\n label?: string;\n /** Disable the entire control. */\n disabled?: boolean;\n}\n\nconst itemVariants: Variants = {\n hidden: { opacity: 0, scale: 0.8, y: -4 },\n show: {\n opacity: 1,\n scale: 1,\n y: 0,\n transition: { type: \"spring\", stiffness: 460, damping: 26 },\n },\n // The width/margin collapse on exit is the key — adjacent flex children\n // glide naturally into the gap instead of snapping.\n exit: {\n opacity: 0,\n scale: 0.8,\n width: 0,\n marginRight: 0,\n paddingLeft: 0,\n paddingRight: 0,\n transition: { duration: 0.22, ease: [0.7, 0, 0.84, 0] },\n },\n};\n\n/**\n * MultiSelectTokenPills\n *\n * A tag/chip input that animates additions with a spring pop-in and exits\n * by physically collapsing each pill's `width` + horizontal margin to 0 —\n * so siblings glide over to fill the gap (no snap, no layout flicker).\n *\n * Pasting a comma-separated list ripples the new pills in via Framer's\n * `staggerChildren`, like dominoes — the new tokens get a fresh `addBatch`\n * id so AnimatePresence can stagger them as a single wave.\n *\n * GPU contract: animates only `transform` + `opacity` (and exit-only\n * `width`/`margin` which we accept as the trade-off for sibling glide).\n */\nexport function MultiSelectTokenPills({\n value: controlled,\n defaultValue = [],\n onChange,\n placeholder = \"Add a tag…\",\n validate,\n delimiters = /[,;\\s]+/,\n max,\n className,\n label,\n disabled = false,\n}: MultiSelectTokenPillsProps) {\n const isControlled = controlled !== undefined;\n const [internal, setInternal] = React.useState(defaultValue);\n const tokens = isControlled ? (controlled as TokenPill[]) : internal;\n\n const [draft, setDraft] = React.useState(\"\");\n // Tracks the most recent batch of additions so we can stagger them.\n const [, setLastBatchAt] = React.useState(0);\n const reduce = useReducedMotion();\n const inputRef = React.useRef(null);\n\n const commit = React.useCallback(\n (raw: string) => {\n const parts = raw\n .split(delimiters)\n .map((p) => p.trim())\n .filter(Boolean);\n if (!parts.length) return;\n\n const existing = new Set(tokens.map((t) => t.label.toLowerCase()));\n const additions: TokenPill[] = [];\n for (const p of parts) {\n if (max !== undefined && tokens.length + additions.length >= max) break;\n if (existing.has(p.toLowerCase())) continue;\n existing.add(p.toLowerCase());\n const v = validate?.(p);\n additions.push({\n id: `${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,\n label: p,\n invalid: v?.invalid,\n });\n }\n if (!additions.length) return;\n const next = [...tokens, ...additions];\n if (!isControlled) setInternal(next);\n onChange?.(next);\n setLastBatchAt(Date.now());\n },\n [tokens, delimiters, max, validate, isControlled, onChange]\n );\n\n function remove(id: string) {\n const next = tokens.filter((t) => t.id !== id);\n if (!isControlled) setInternal(next);\n onChange?.(next);\n }\n\n function handleKeyDown(e: React.KeyboardEvent) {\n if (disabled) return;\n if (e.key === \"Enter\" || e.key === \"Tab\" || e.key === \",\") {\n if (draft.trim()) {\n e.preventDefault();\n commit(draft);\n setDraft(\"\");\n }\n } else if (e.key === \"Backspace\" && !draft && tokens.length) {\n e.preventDefault();\n remove(tokens[tokens.length - 1].id);\n }\n }\n\n function handlePaste(e: React.ClipboardEvent) {\n if (disabled) return;\n const text = e.clipboardData.getData(\"text\");\n if (!text) return;\n if (delimiters.test(text)) {\n e.preventDefault();\n commit(text);\n setDraft(\"\");\n }\n }\n\n return (\n
\n {label && (\n \n )}\n inputRef.current?.focus()}\n className={cn(\n \"group relative flex min-h-[44px] w-full cursor-text flex-wrap items-center gap-1.5 rounded-xl border border-[var(--border)] bg-[var(--surface)] px-2 py-1.5\",\n \"transition-colors duration-200 focus-within:border-chili-500/50 focus-within:ring-2 focus-within:ring-chili-500/20\",\n disabled && \"pointer-events-none opacity-60\"\n )}\n // Container variants run on every batch so newly-added children\n // ripple in via stagger.\n variants={{\n show: {\n transition: { staggerChildren: reduce ? 0 : 0.05 },\n },\n }}\n initial={false}\n animate=\"show\"\n >\n \n {tokens.map((t) => (\n \n {t.label}\n {\n e.stopPropagation();\n remove(t.id);\n }}\n className=\"grid h-4 w-4 shrink-0 place-items-center rounded-full text-[var(--muted-foreground)] transition-colors hover:bg-[var(--border)] hover:text-[var(--foreground)]\"\n >\n \n \n \n ))}\n \n\n setDraft(e.target.value)}\n onKeyDown={handleKeyDown}\n onPaste={handlePaste}\n onBlur={() => {\n if (draft.trim()) {\n commit(draft);\n setDraft(\"\");\n }\n }}\n placeholder={tokens.length === 0 ? placeholder : \"\"}\n disabled={disabled}\n className=\"min-w-[120px] flex-1 bg-transparent px-1.5 py-1 text-[13px] text-[var(--foreground)] outline-none placeholder:text-[var(--muted-foreground)]\"\n />\n \n
\n );\n}\n" } ], "cssVars": { "theme": { "font-sans": "var(--font-satoshi, ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif)", "font-display": "var(--font-cabinet, ui-sans-serif, system-ui, sans-serif)", "color-background": "var(--background)", "color-foreground": "var(--foreground)", "color-surface": "var(--surface)", "color-surface-muted": "var(--surface-muted)", "color-border": "var(--border)", "color-border-strong": "var(--border-strong)", "color-muted": "var(--muted)", "color-muted-foreground": "var(--muted-foreground)", "color-ring": "var(--ring)", "color-chili-50": "#fff1ee", "color-chili-100": "#ffe2db", "color-chili-200": "#ffa896", "color-chili-300": "#ff8a73", "color-chili-400": "#f15a45", "color-chili-500": "#cd1c18", "color-chili-600": "#b31614", "color-chili-700": "#9b1313", "color-chili-800": "#6a0d0e", "color-chili-900": "#38000a", "color-chili-950": "#1f0006", "color-primitive-surface-elevated": "var(--primitive-surface-elevated)", "color-primitive-surface-overlay": "var(--primitive-surface-overlay)", "color-primitive-surface-hover": "var(--primitive-surface-hover)", "color-primitive-surface-active": "var(--primitive-surface-active)", "color-primitive-surface-selected": "var(--primitive-surface-selected)", "color-primitive-border-subtle": "var(--primitive-border-subtle)", "color-primitive-ring": "var(--primitive-ring)", "color-primitive-text-secondary": "var(--primitive-text-secondary)", "color-primitive-text-placeholder": "var(--primitive-text-placeholder)", "color-primitive-text-inverse": "var(--primitive-text-inverse)", "color-primitive-destructive": "var(--primitive-destructive)", "color-primitive-destructive-hover": "var(--primitive-destructive-hover)", "color-primitive-destructive-active": "var(--primitive-destructive-active)", "color-primitive-destructive-foreground": "var(--primitive-destructive-foreground)", "color-primitive-destructive-surface": "var(--primitive-destructive-surface)", "color-primitive-destructive-border": "var(--primitive-destructive-border)", "color-primitive-success": "var(--primitive-success)", "color-primitive-warning": "var(--primitive-warning)", "color-primitive-info": "var(--primitive-info)", "color-primitive-control-solid": "var(--primitive-control-solid)", "color-primitive-control-solid-hover": "var(--primitive-control-solid-hover)", "color-primitive-control-solid-active": "var(--primitive-control-solid-active)", "color-primitive-control-solid-foreground": "var(--primitive-control-solid-foreground)", "color-primitive-chart-1": "var(--primitive-chart-1)", "color-primitive-chart-2": "var(--primitive-chart-2)", "color-primitive-chart-3": "var(--primitive-chart-3)", "color-primitive-chart-4": "var(--primitive-chart-4)", "color-primitive-chart-5": "var(--primitive-chart-5)", "color-primitive-chart-6": "var(--primitive-chart-6)", "radius-primitive": "var(--primitive-radius)", "radius-primitive-control": "var(--primitive-radius-control)", "radius-primitive-control-sm": "var(--primitive-radius-control-sm)", "radius-primitive-surface": "var(--primitive-radius-surface)", "radius-primitive-item": "var(--primitive-radius-item)", "font-primitive-sans": "var(--primitive-font-sans)", "font-primitive-display": "var(--primitive-font-display)", "font-primitive-mono": "var(--primitive-font-mono)", "spacing-primitive-control-height-sm": "var(--primitive-control-height-sm)", "spacing-primitive-control-height-md": "var(--primitive-control-height-md)", "spacing-primitive-control-height-lg": "var(--primitive-control-height-lg)" }, "light": { "background": "#fafafa", "foreground": "#0a0a0a", "surface": "#ffffff", "surface-muted": "#f4f4f5", "border": "rgba(10, 10, 10, 0.08)", "border-strong": "rgba(10, 10, 10, 0.16)", "muted": "#f4f4f5", "muted-foreground": "#52525b", "ring": "#cd1c18", "pattern-fg": "rgba(10, 10, 10, 0.07)", "llb-primary": "#18181b", "llb-primary-fg": "#ffffff", "llb-success": "#1f883d", "llb-error": "#cf222e", "primitive-surface-elevated": "#ffffff", "primitive-surface-overlay": "#ffffff", "primitive-surface-hover": "color-mix(in srgb, var(--foreground) 4%, transparent)", "primitive-surface-active": "color-mix(in srgb, var(--foreground) 7%, transparent)", "primitive-surface-selected": "color-mix(in srgb, var(--foreground) 6%, transparent)", "primitive-border-subtle": "color-mix(in srgb, var(--border) 60%, transparent)", "primitive-ring": "color-mix(in srgb, var(--foreground) 45%, transparent)", "primitive-text-secondary": "color-mix(in srgb, var(--foreground) 72%, transparent)", "primitive-text-placeholder": "color-mix(in srgb, var(--muted-foreground) 85%, transparent)", "primitive-radius": "0.875rem", "primitive-font-sans": "var(--font-sans)", "primitive-font-display": "var(--font-display)", "primitive-font-mono": "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace", "primitive-control-solid": "#24292d", "primitive-control-solid-hover": "#2c3237", "primitive-control-solid-active": "#1e2326", "primitive-control-solid-foreground": "#ffffff", "primitive-chart-1": "#2a78d6", "primitive-chart-2": "#1baf7a", "primitive-chart-3": "#eda100", "primitive-chart-4": "#008300", "primitive-chart-5": "#4a3aa7", "primitive-chart-6": "#e34948", "primitive-text-inverse": "#ffffff", "primitive-text-hint": "0.6875rem", "primitive-destructive": "#dc2626", "primitive-destructive-hover": "#b91c1c", "primitive-destructive-active": "#991b1b", "primitive-destructive-foreground": "#ffffff", "primitive-destructive-surface": "rgba(220, 38, 38, 0.10)", "primitive-destructive-border": "rgba(220, 38, 38, 0.45)", "primitive-success": "#047857", "primitive-success-surface": "rgba(4, 120, 87, 0.10)", "primitive-success-border": "rgba(4, 120, 87, 0.45)", "primitive-warning": "#b45309", "primitive-warning-surface": "rgba(180, 83, 9, 0.10)", "primitive-warning-border": "rgba(180, 83, 9, 0.45)", "primitive-info": "#0369a1", "primitive-info-surface": "rgba(3, 105, 161, 0.10)", "primitive-info-border": "rgba(3, 105, 161, 0.45)", "primitive-radius-control": "var(--primitive-radius)", "primitive-radius-control-sm": "max(0px, calc(var(--primitive-radius) - 4px))", "primitive-radius-surface": "calc(var(--primitive-radius) + min(2px, var(--primitive-radius)))", "primitive-radius-item": "max(0px, calc(var(--primitive-radius-surface) - 6px))", "primitive-control-height-sm": "2rem", "primitive-control-height-md": "2.25rem", "primitive-control-height-lg": "2.5rem", "primitive-shadow-raised": "0 1px 2px rgba(0, 0, 0, 0.06), 0 8px 24px -12px rgba(0, 0, 0, 0.08)", "primitive-shadow-overlay": "0 1px 2px rgba(0, 0, 0, 0.06), 0 18px 48px -24px rgba(0, 0, 0, 0.35)", "primitive-shadow-modal": "0 1px 2px rgba(0, 0, 0, 0.08), 0 24px 64px -28px rgba(0, 0, 0, 0.42)", "primitive-z-overlay": "100", "primitive-z-popover": "130", "primitive-z-toast": "140", "primitive-backdrop": "rgba(0, 0, 0, 0.6)", "primitive-ease": "cubic-bezier(0.23, 1, 0.32, 1)" }, "dark": { "background": "#0a0a0b", "foreground": "#f5f5f6", "surface": "#111113", "surface-muted": "#18181b", "border": "rgba(255, 255, 255, 0.08)", "border-strong": "rgba(255, 255, 255, 0.14)", "muted": "#1c1c1f", "muted-foreground": "#a1a1aa", "ring": "#cd1c18", "pattern-fg": "rgba(255, 255, 255, 0.06)", "llb-primary": "#f5f5f6", "llb-primary-fg": "#0a0a0b", "llb-success": "#2da44e", "llb-error": "#f85149", "primitive-surface-elevated": "#0f0f10", "primitive-surface-overlay": "#141415", "primitive-surface-hover": "color-mix(in srgb, var(--foreground) 5%, transparent)", "primitive-surface-active": "color-mix(in srgb, var(--foreground) 10%, transparent)", "primitive-surface-selected": "color-mix(in srgb, var(--foreground) 8%, transparent)", "primitive-border-subtle": "color-mix(in srgb, var(--border) 60%, transparent)", "primitive-ring": "color-mix(in srgb, var(--foreground) 45%, transparent)", "primitive-text-secondary": "color-mix(in srgb, var(--foreground) 72%, transparent)", "primitive-text-placeholder": "color-mix(in srgb, var(--muted-foreground) 85%, transparent)", "primitive-radius": "0.875rem", "primitive-font-sans": "var(--font-sans)", "primitive-font-display": "var(--font-display)", "primitive-font-mono": "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace", "primitive-control-solid": "#f5f3ee", "primitive-control-solid-hover": "#ffffff", "primitive-control-solid-active": "#e8e4da", "primitive-control-solid-foreground": "#151719", "primitive-chart-1": "#3987e5", "primitive-chart-2": "#199e70", "primitive-chart-3": "#c98500", "primitive-chart-4": "#008300", "primitive-chart-5": "#9085e9", "primitive-chart-6": "#e66767", "primitive-text-inverse": "#151719", "primitive-text-hint": "0.6875rem", "primitive-destructive": "#e11d2e", "primitive-destructive-hover": "#c1121f", "primitive-destructive-active": "#a4161a", "primitive-destructive-foreground": "#ffffff", "primitive-destructive-surface": "rgba(225, 29, 46, 0.12)", "primitive-destructive-border": "rgba(225, 29, 46, 0.52)", "primitive-success": "#34d399", "primitive-success-surface": "rgba(52, 211, 153, 0.12)", "primitive-success-border": "rgba(52, 211, 153, 0.45)", "primitive-warning": "#fbbf24", "primitive-warning-surface": "rgba(251, 191, 36, 0.12)", "primitive-warning-border": "rgba(251, 191, 36, 0.45)", "primitive-info": "#38bdf8", "primitive-info-surface": "rgba(56, 189, 248, 0.12)", "primitive-info-border": "rgba(56, 189, 248, 0.45)", "primitive-radius-control": "var(--primitive-radius)", "primitive-radius-control-sm": "max(0px, calc(var(--primitive-radius) - 4px))", "primitive-radius-surface": "calc(var(--primitive-radius) + min(2px, var(--primitive-radius)))", "primitive-radius-item": "max(0px, calc(var(--primitive-radius-surface) - 6px))", "primitive-control-height-sm": "2rem", "primitive-control-height-md": "2.25rem", "primitive-control-height-lg": "2.5rem", "primitive-shadow-raised": "0 1px 2px rgba(0, 0, 0, 0.4), 0 8px 24px -12px rgba(0, 0, 0, 0.6)", "primitive-shadow-overlay": "0 1px 2px rgba(0, 0, 0, 0.4), 0 20px 56px -28px rgba(0, 0, 0, 0.72)", "primitive-shadow-modal": "0 1px 2px rgba(0, 0, 0, 0.45), 0 28px 72px -32px rgba(0, 0, 0, 0.8)", "primitive-z-overlay": "100", "primitive-z-popover": "130", "primitive-z-toast": "140", "primitive-backdrop": "rgba(0, 0, 0, 0.6)", "primitive-ease": "cubic-bezier(0.23, 1, 0.32, 1)" } }, "css": { "@layer base": { ":where([data-wensity-primitive])": { "font-family": "var(--primitive-font-sans)" } }, "@utility scrollbar-hidden": { "scrollbar-width": "none", "-ms-overflow-style": "none", "&::-webkit-scrollbar": { "display": "none" } }, "@keyframes wensity-marquee-x": { "from": { "transform": "translate3d(0, 0, 0)" }, "to": { "transform": "translate3d(-50%, 0, 0)" } }, "@keyframes wensity-marquee-x-reverse": { "from": { "transform": "translate3d(-50%, 0, 0)" }, "to": { "transform": "translate3d(0, 0, 0)" } }, "@keyframes wensity-morph-rot-cw": { "from": { "transform": "rotate(0deg)" }, "to": { "transform": "rotate(360deg)" } }, "@keyframes wensity-morph-rot-ccw": { "from": { "transform": "rotate(0deg)" }, "to": { "transform": "rotate(-360deg)" } } }, "docs": "Free Wensity component. Installs to @components/wensity/multi-select-token-pills.tsx. For Pro components and updates, use pnpm dlx wensity@latest add multi-select-token-pills.", "categories": [ "Elite Micro-Interactions", "wensity", "free" ], "meta": { "wensity": { "slug": "multi-select-token-pills", "access": "free", "category": "Elite Micro-Interactions", "kind": "component", "componentUrl": "https://ui.wensity.com/components/multi-select-token-pills", "shadcnUrl": "https://ui.wensity.com/r/multi-select-token-pills", "cliInstall": "pnpm dlx wensity@latest add multi-select-token-pills" } } }