@forthtilliath/forth-ui 0.2.5 → 0.4.0

package/dist/components/code-block/code-block.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
 import type { BundledLanguage, BundledTheme, SpecialLanguage } from "shiki";
+import { type UiLocale } from "../../locale/locale.js";
 export interface CodeBlockProps {
     code: string;
     language?: BundledLanguage | SpecialLanguage;
@@ -14,6 +15,11 @@ export interface CodeBlockProps {
     };
     showLineNumbers?: boolean;
     className?: string;
+    /**
+     * Language of the built-in labels — French by default, or the nearest
+     * `UiLocaleProvider`'s. Explicit text props still win.
+     */
+    locale?: UiLocale;
 }
 /**
  * A syntax-highlighted code block with a copy-to-clipboard button, an
@@ -27,5 +33,5 @@ export interface CodeBlockProps {
  * @author Forth
  * @copyright 2026 Forth
  */
-export declare function CodeBlock({ code, language, filename, theme, showLineNumbers, className, }: CodeBlockProps): React.JSX.Element;
+export declare function CodeBlock({ code, language, filename, theme, showLineNumbers, className, locale, }: CodeBlockProps): React.JSX.Element;
 //# sourceMappingURL=code-block.d.ts.map

package/dist/components/code-block/code-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-block.d.ts","sourceRoot":"","sources":["../../../src/components/code-block/code-block.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAO5E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe,CAAC;IAC7C,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,YAAY,CAAA;KAAE,CAAC;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,QAAiB,EACjB,QAAQ,EACR,KAAqB,EACrB,eAAuB,EACvB,SAAS,GACV,EAAE,cAAc,qBAkFhB"}
+{"version":3,"file":"code-block.d.ts","sourceRoot":"","sources":["../../../src/components/code-block/code-block.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAO5E,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,wBAAwB,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe,CAAC;IAC7C,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,YAAY,CAAA;KAAE,CAAC;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,QAAiB,EACjB,QAAQ,EACR,KAAqB,EACrB,eAAuB,EACvB,SAAS,EACT,MAAM,GACP,EAAE,cAAc,qBAqFhB"}

package/dist/components/code-block/code-block.js

@@ -6,6 +6,7 @@ import { codeToHtml } from "shiki";
 import { Badge } from "@forthtilliath/shadcn-ui/components/badge";
 import { Button } from "@forthtilliath/shadcn-ui/components/button";
 import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
+import { useUiMessages } from "../../locale/locale.js";
 const DEFAULT_THEME = { light: "github-light", dark: "github-dark" };
 const COPY_FEEDBACK_MS = 2000;
 /**
@@ -20,7 +21,8 @@ const COPY_FEEDBACK_MS = 2000;
  * @author Forth
  * @copyright 2026 Forth
  */
-export function CodeBlock({ code, language = "text", filename, theme = DEFAULT_THEME, showLineNumbers = false, className, }) {
+export function CodeBlock({ code, language = "text", filename, theme = DEFAULT_THEME, showLineNumbers = false, className, locale, }) {
+    const messages = useUiMessages(locale);
     const [html, setHtml] = React.useState(null);
     const [copied, setCopied] = React.useState(false);
     React.useEffect(() => {
@@ -46,7 +48,7 @@ export function CodeBlock({ code, language = "text", filename, theme = DEFAULT_T
             }, COPY_FEEDBACK_MS);
         });
     }
-    return (_jsxs("div", { className: cn("border-border bg-card overflow-hidden rounded-lg border text-sm", className), children: [(filename ?? language !== "text") && (_jsx("div", { className: "border-border bg-muted/40 flex items-center justify-between border-b px-3 py-1.5", children: _jsxs("div", { className: "flex items-center gap-2", children: [filename && (_jsx("span", { className: "text-muted-foreground font-mono text-xs", children: filename })), _jsx(Badge, { variant: "outline", className: "font-mono text-[10px]", children: language })] }) })), _jsxs("div", { className: "group relative", children: [_jsx(Button, { variant: "ghost", size: "icon", onClick: handleCopy, "aria-label": copied ? "Copied" : "Copy code", className: "absolute top-2 right-2 size-7 opacity-0 transition-opacity group-hover:opacity-100", children: copied ? _jsx(CheckIcon, {}) : _jsx(CopyIcon, {}) }), html ? (_jsx("div", { className: cn("[&_pre]:overflow-x-auto [&_pre]:p-4", showLineNumbers &&
+    return (_jsxs("div", { className: cn("border-border bg-card overflow-hidden rounded-lg border text-sm", className), children: [(filename ?? language !== "text") && (_jsx("div", { className: "border-border bg-muted/40 flex items-center justify-between border-b px-3 py-1.5", children: _jsxs("div", { className: "flex items-center gap-2", children: [filename && (_jsx("span", { className: "text-muted-foreground font-mono text-xs", children: filename })), _jsx(Badge, { variant: "outline", className: "font-mono text-[10px]", children: language })] }) })), _jsxs("div", { className: "group relative", children: [_jsx(Button, { variant: "ghost", size: "icon", onClick: handleCopy, "aria-label": copied ? messages.codeBlock.copied : messages.codeBlock.copy, className: "absolute top-2 right-2 size-7 opacity-0 transition-opacity group-hover:opacity-100", children: copied ? _jsx(CheckIcon, {}) : _jsx(CopyIcon, {}) }), html ? (_jsx("div", { className: cn("[&_pre]:overflow-x-auto [&_pre]:p-4", showLineNumbers &&
                             "[&_code]:[counter-reset:line] [&_.line]:[counter-increment:line] [&_.line]:before:text-muted-foreground [&_.line]:before:mr-4 [&_.line]:before:inline-block [&_.line]:before:w-4 [&_.line]:before:text-right [&_.line]:before:content-[counter(line)]"), 
                         // Shiki generates static markup from the given `code` string
                         // server-side-safe (no user input reaches this beyond the

package/dist/components/code-block/index.d.ts

@@ -1,3 +1,3 @@
-export type { CodeBlockProps } from "./code-block";
-export { CodeBlock } from "./code-block";
+export type { CodeBlockProps } from "./code-block.js";
+export { CodeBlock } from "./code-block.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/code-block/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/code-block/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/code-block/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/components/code-block/index.js

@@ -1 +1 @@
-export { CodeBlock } from "./code-block";
+export { CodeBlock } from "./code-block.js";

package/dist/components/collapsible/index.d.ts

@@ -1,7 +1,7 @@
-export type { CollapsibleProps } from "./collapsible";
-export type { CollapsibleContentProps } from "./collapsible";
-export type { CollapsibleTriggerProps } from "./collapsible";
-export { Collapsible } from "./collapsible";
-export { CollapsibleContent } from "./collapsible";
-export { CollapsibleTrigger } from "./collapsible";
+export type { CollapsibleProps } from "./collapsible.js";
+export type { CollapsibleContentProps } from "./collapsible.js";
+export type { CollapsibleTriggerProps } from "./collapsible.js";
+export { Collapsible } from "./collapsible.js";
+export { CollapsibleContent } from "./collapsible.js";
+export { CollapsibleTrigger } from "./collapsible.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/collapsible/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/collapsible/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/collapsible/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/collapsible/index.js

@@ -1,3 +1,3 @@
-export { Collapsible } from "./collapsible";
-export { CollapsibleContent } from "./collapsible";
-export { CollapsibleTrigger } from "./collapsible";
+export { Collapsible } from "./collapsible.js";
+export { CollapsibleContent } from "./collapsible.js";
+export { CollapsibleTrigger } from "./collapsible.js";

package/dist/components/color-picker/color-picker.d.ts

@@ -1,4 +1,5 @@
 import * as React from "react";
+import { type UiLocale } from "../../locale/locale.js";
 export interface ColorPickerProps {
     value?: string;
     defaultValue?: string;
@@ -7,6 +8,11 @@ export interface ColorPickerProps {
     className?: string;
     /** Accessible name for the color swatch, which otherwise has no visible text. */
     ariaLabel?: string;
+    /**
+     * Language of the built-in labels — French by default, or the nearest
+     * `UiLocaleProvider`'s. Explicit text props still win.
+     */
+    locale?: UiLocale;
 }
 /**
  * A color swatch + hex text input, kept in sync — built on the browser's
@@ -22,5 +28,5 @@ export interface ColorPickerProps {
  * @author Forth
  * @copyright 2026 Forth
  */
-export declare function ColorPicker({ value, defaultValue, onValueChange, disabled, className, ariaLabel, }: ColorPickerProps): React.JSX.Element;
+export declare function ColorPicker({ value, defaultValue, onValueChange, disabled, className, ariaLabel, locale, }: ColorPickerProps): React.JSX.Element;
 //# sourceMappingURL=color-picker.d.ts.map

package/dist/components/color-picker/color-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-picker.d.ts","sourceRoot":"","sources":["../../../src/components/color-picker/color-picker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,YAAwB,EACxB,aAAa,EACb,QAAgB,EAChB,SAAS,EACT,SAA0B,GAC3B,EAAE,gBAAgB,qBAoDlB"}
+{"version":3,"file":"color-picker.d.ts","sourceRoot":"","sources":["../../../src/components/color-picker/color-picker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,wBAAwB,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,YAAwB,EACxB,aAAa,EACb,QAAgB,EAChB,SAAS,EACT,SAAS,EACT,MAAM,GACP,EAAE,gBAAgB,qBAsDlB"}

package/dist/components/color-picker/color-picker.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import { Input } from "@forthtilliath/shadcn-ui/components/input";
 import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
+import { useUiMessages } from "../../locale/locale.js";
 const HEX_PATTERN = /^#[0-9a-f]{6}$/i;
 /**
  * A color swatch + hex text input, kept in sync — built on the browser's
@@ -18,7 +19,8 @@ const HEX_PATTERN = /^#[0-9a-f]{6}$/i;
  * @author Forth
  * @copyright 2026 Forth
  */
-export function ColorPicker({ value, defaultValue = "#000000", onValueChange, disabled = false, className, ariaLabel = "Choose color", }) {
+export function ColorPicker({ value, defaultValue = "#000000", onValueChange, disabled = false, className, ariaLabel, locale, }) {
+    const messages = useUiMessages(locale);
     const [uncontrolledValue, setUncontrolledValue] = React.useState(defaultValue);
     const [textValue, setTextValue] = React.useState(defaultValue);
     const color = value ?? uncontrolledValue;
@@ -27,9 +29,9 @@ export function ColorPicker({ value, defaultValue = "#000000", onValueChange, di
         setTextValue(next);
         onValueChange?.(next);
     }
-    return (_jsxs("div", { "data-slot": "color-picker", className: cn("flex items-center gap-2", className), children: [_jsx("label", { "aria-label": ariaLabel, className: cn("border-input size-9 shrink-0 overflow-hidden rounded-md border shadow-xs", disabled && "pointer-events-none opacity-50"), style: { backgroundColor: color }, children: _jsx("input", { type: "color", value: color, disabled: disabled, onChange: (e) => {
+    return (_jsxs("div", { "data-slot": "color-picker", className: cn("flex items-center gap-2", className), children: [_jsx("label", { "aria-label": ariaLabel ?? messages.colorPicker.choose, className: cn("border-input size-9 shrink-0 overflow-hidden rounded-md border shadow-xs", disabled && "pointer-events-none opacity-50"), style: { backgroundColor: color }, children: _jsx("input", { type: "color", value: color, disabled: disabled, onChange: (e) => {
                         commit(e.target.value);
-                    }, className: "size-full cursor-pointer opacity-0" }) }), _jsx(Input, { value: textValue, disabled: disabled, onChange: (e) => {
+                    }, className: "size-full cursor-pointer opacity-0" }) }), _jsx(Input, { value: textValue, "aria-label": messages.colorPicker.hex, disabled: disabled, onChange: (e) => {
                     setTextValue(e.target.value);
                     if (HEX_PATTERN.test(e.target.value)) {
                         commit(e.target.value);

package/dist/components/color-picker/index.d.ts

@@ -1,3 +1,3 @@
-export type { ColorPickerProps } from "./color-picker";
-export { ColorPicker } from "./color-picker";
+export type { ColorPickerProps } from "./color-picker.js";
+export { ColorPicker } from "./color-picker.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/color-picker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/color-picker/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/color-picker/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/color-picker/index.js

@@ -1 +1 @@
-export { ColorPicker } from "./color-picker";
+export { ColorPicker } from "./color-picker.js";

package/dist/components/column-menu/column-menu.d.ts

@@ -0,0 +1,39 @@
+import type { ColumnMenuColumn, ColumnMenuLabels } from "./types.js";
+export interface ColumnMenuProps<C extends ColumnMenuColumn> {
+    columns: C[];
+    /** Restored by the reset button. */
+    defaultColumns: C[];
+    /** Receives an updater, so a `useState` setter can be passed directly. */
+    onColumnsChange: (update: (prev: C[]) => C[]) => void;
+    /** Overrides some or all of the displayed texts. */
+    labels?: Partial<ColumnMenuLabels>;
+    /** Side of the trigger the dropdown is aligned to (default: `"end"`). */
+    align?: "start" | "end";
+    /**
+     * Custom classes for each part of the component.
+     *
+     * - `root` wraps the trigger and the dropdown.
+     * - `trigger` is the toggle button.
+     * - `badge` is the "visible / total" counter inside the trigger.
+     * - `content` is the dropdown panel.
+     * - `header` is the title + reset bar.
+     * - `hint` is the usage hint under the header.
+     * - `list` wraps the rows.
+     * - `row` is applied to every column row.
+     */
+    className?: Partial<Record<"root" | "trigger" | "badge" | "content" | "header" | "hint" | "list" | "row", string>>;
+}
+/**
+ * A dropdown to show/hide and reorder (drag and drop, touch and keyboard
+ * included) the columns of a table, with a "visible / total" counter and a
+ * reset button. Closes on outside click and `Escape`.
+ *
+ * Pair it with `createColumnStorage` from `@forthtilliath/ts-kit` to persist
+ * the user's layout.
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export declare function ColumnMenu<C extends ColumnMenuColumn>({ columns, defaultColumns, onColumnsChange, labels, align, className, }: ColumnMenuProps<C>): import("react").JSX.Element;
+//# sourceMappingURL=column-menu.d.ts.map

package/dist/components/column-menu/column-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-menu.d.ts","sourceRoot":"","sources":["../../../src/components/column-menu/column-menu.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAIrE,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,gBAAgB;IACzD,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,oCAAoC;IACpC,cAAc,EAAE,CAAC,EAAE,CAAC;IACpB,0EAA0E;IAC1E,eAAe,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC;IACtD,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACxB;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,OAAO,CACjB,MAAM,CACF,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,GACN,KAAK,EACP,MAAM,CACP,CACF,CAAC;CACH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,gBAAgB,EAAE,EACrD,OAAO,EACP,cAAc,EACd,eAAe,EACf,MAAM,EACN,KAAa,EACb,SAAS,GACV,EAAE,eAAe,CAAC,CAAC,CAAC,+BAyJpB"}

package/dist/components/column-menu/column-menu.js

@@ -0,0 +1,74 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useId, useRef, useState } from "react";
+import { closestCenter, DndContext } from "@dnd-kit/core";
+import { arrayMove, SortableContext, verticalListSortingStrategy, } from "@dnd-kit/sortable";
+import { ChevronDown, RotateCcw } from "lucide-react";
+import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
+import { SortableColumnRow } from "./sortable-column-row.js";
+import { DEFAULT_COLUMN_MENU_LABELS } from "./types.js";
+import { useDndSensors } from "./use-dnd-sensors.js";
+/**
+ * A dropdown to show/hide and reorder (drag and drop, touch and keyboard
+ * included) the columns of a table, with a "visible / total" counter and a
+ * reset button. Closes on outside click and `Escape`.
+ *
+ * Pair it with `createColumnStorage` from `@forthtilliath/ts-kit` to persist
+ * the user's layout.
+ *
+ * @version 0.1.0
+ * @author Forth
+ * @copyright 2026 Forth
+ */
+export function ColumnMenu({ columns, defaultColumns, onColumnsChange, labels, align = "end", className, }) {
+    const text = { ...DEFAULT_COLUMN_MENU_LABELS, ...labels };
+    // Stable id: avoids a hydration mismatch on dnd-kit's aria-describedby
+    const dndId = useId();
+    const contentId = useId();
+    const rootRef = useRef(null);
+    const [open, setOpen] = useState(false);
+    const sensors = useDndSensors();
+    const visibleCount = columns.filter((c) => c.visible).length;
+    const allVisible = visibleCount === columns.length;
+    useEffect(() => {
+        if (!open)
+            return;
+        function handlePointerDown(event) {
+            if (!rootRef.current?.contains(event.target))
+                setOpen(false);
+        }
+        function handleKeyDown(event) {
+            if (event.key === "Escape")
+                setOpen(false);
+        }
+        document.addEventListener("pointerdown", handlePointerDown);
+        document.addEventListener("keydown", handleKeyDown);
+        return () => {
+            document.removeEventListener("pointerdown", handlePointerDown);
+            document.removeEventListener("keydown", handleKeyDown);
+        };
+    }, [open]);
+    function handleDragEnd({ active, over }) {
+        if (!over || active.id === over.id)
+            return;
+        onColumnsChange((prev) => {
+            const oldIndex = prev.findIndex((c) => c.key === active.id);
+            const newIndex = prev.findIndex((c) => c.key === over.id);
+            return arrayMove(prev, oldIndex, newIndex);
+        });
+    }
+    function toggleColumn(key) {
+        onColumnsChange((prev) => prev.map((c) => (c.key === key ? { ...c, visible: !c.visible } : c)));
+    }
+    function reset() {
+        onColumnsChange(() => defaultColumns);
+        setOpen(false);
+    }
+    return (_jsxs("div", { ref: rootRef, "data-slot": "column-menu", className: cn("relative", className?.root), children: [_jsxs("button", { type: "button", "aria-expanded": open, "aria-controls": contentId, onClick: () => {
+                    setOpen((v) => !v);
+                }, className: cn("flex items-center gap-1.5 rounded-lg border px-2.5 py-1.5 text-sm transition-all", open
+                    ? "border-primary bg-primary/10 text-primary"
+                    : "border-border text-foreground/60 hover:border-primary hover:text-foreground", className?.trigger), children: [_jsx("span", { className: "hidden sm:inline", children: text.trigger }), _jsxs("span", { className: cn("rounded-full px-1.5 py-0.5 text-xs font-medium", allVisible
+                            ? "bg-foreground/10 text-foreground/40"
+                            : "bg-primary text-primary-foreground", className?.badge), children: [visibleCount, "/", columns.length] }), _jsx(ChevronDown, { className: cn("size-3.5 opacity-60 transition-transform", open && "rotate-180"), "aria-hidden": "true" })] }), open && (_jsxs("div", { id: contentId, "data-slot": "column-menu-content", className: cn("bg-background border-border absolute top-full z-20 mt-2 w-64 overflow-hidden rounded-xl border shadow-xl", align === "end" ? "right-0" : "left-0", className?.content), children: [_jsxs("div", { className: cn("border-border bg-muted flex items-center justify-between border-b px-4 py-3", className?.header), children: [_jsx("p", { className: "text-foreground text-xs font-medium", children: text.title }), _jsxs("button", { type: "button", onClick: reset, className: "text-foreground/50 hover:text-primary flex items-center gap-1 text-xs transition-colors", children: [_jsx(RotateCcw, { className: "size-3", "aria-hidden": "true" }), text.reset] })] }), _jsx("p", { className: cn("border-border bg-muted/50 text-foreground/50 border-b px-4 py-2 text-xs", className?.hint), children: text.hint }), _jsx("div", { className: cn("p-2", className?.list), children: _jsx(DndContext, { id: dndId, sensors: sensors, collisionDetection: closestCenter, onDragEnd: handleDragEnd, children: _jsx(SortableContext, { items: columns.map((c) => c.key), strategy: verticalListSortingStrategy, children: columns.map((column, index) => (_jsx(SortableColumnRow, { column: column, index: index, total: columns.length, dragHandleLabel: text.dragHandle(column.label), onToggle: toggleColumn, className: className?.row }, column.key))) }) }) })] }))] }));
+}

package/dist/components/column-menu/index.d.ts

@@ -0,0 +1,6 @@
+export type { ColumnMenuProps } from "./column-menu.js";
+export { ColumnMenu } from "./column-menu.js";
+export type { ColumnMenuColumn, ColumnMenuLabels } from "./types.js";
+export { DEFAULT_COLUMN_MENU_LABELS } from "./types.js";
+export { useDndSensors } from "./use-dnd-sensors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/column-menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/column-menu/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/components/column-menu/index.js

@@ -0,0 +1,3 @@
+export { ColumnMenu } from "./column-menu.js";
+export { DEFAULT_COLUMN_MENU_LABELS } from "./types.js";
+export { useDndSensors } from "./use-dnd-sensors.js";

package/dist/components/column-menu/sortable-column-row.d.ts

@@ -0,0 +1,13 @@
+import type { ColumnMenuColumn } from "./types.js";
+export interface SortableColumnRowProps<K extends string> {
+    column: ColumnMenuColumn<K>;
+    index: number;
+    total: number;
+    dragHandleLabel: string;
+    onToggle: (key: K) => void;
+    /** Carries `data-dragging` while the row is being dragged. */
+    className?: string;
+}
+/** One row of `ColumnMenu`: drag handle, visibility switch, position. */
+export declare function SortableColumnRow<K extends string>({ column, index, total, dragHandleLabel, onToggle, className, }: SortableColumnRowProps<K>): import("react").JSX.Element;
+//# sourceMappingURL=sortable-column-row.d.ts.map

package/dist/components/column-menu/sortable-column-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortable-column-row.d.ts","sourceRoot":"","sources":["../../../src/components/column-menu/sortable-column-row.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,MAAM;IACtD,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,EAClD,MAAM,EACN,KAAK,EACL,KAAK,EACL,eAAe,EACf,QAAQ,EACR,SAAS,GACV,EAAE,sBAAsB,CAAC,CAAC,CAAC,+BAuD3B"}

package/dist/components/column-menu/sortable-column-row.js

@@ -0,0 +1,22 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useSortable } from "@dnd-kit/sortable";
+import { CSS } from "@dnd-kit/utilities";
+import { GripVertical } from "lucide-react";
+import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
+import { ToggleSwitch } from "../toggle-switch/index.js";
+/** One row of `ColumnMenu`: drag handle, visibility switch, position. */
+export function SortableColumnRow({ column, index, total, dragHandleLabel, onToggle, className, }) {
+    const { attributes, listeners, setNodeRef, transform, transition, isDragging, } = useSortable({ id: column.key });
+    return (_jsxs("div", { ref: setNodeRef, "data-slot": "column-menu-row", "data-dragging": isDragging || undefined, style: {
+            transform: CSS.Transform.toString(transform),
+            transition,
+            opacity: isDragging ? 0.5 : 1,
+            zIndex: isDragging ? 10 : undefined,
+        }, className: cn("flex items-center gap-3 rounded-lg px-3 py-2 transition-colors", isDragging ? "bg-primary/5 border-primary/20 border" : "hover:bg-muted", className), children: [_jsx("button", { type: "button", ...attributes, ...listeners, "aria-label": dragHandleLabel, title: dragHandleLabel, className: "text-foreground/30 hover:text-foreground/60 shrink-0 cursor-grab touch-none transition-colors active:cursor-grabbing", children: _jsx(GripVertical, { className: "size-4", "aria-hidden": "true" }) }), _jsx(ToggleSwitch, { size: "sm", checked: column.visible, onCheckedChange: () => {
+                    onToggle(column.key);
+                }, label: column.label, className: {
+                    root: "flex-1 gap-3",
+                    label: "text-foreground/40 group-data-[state=checked]/toggle-switch:text-foreground flex-1 text-left transition-colors",
+                } }), _jsxs("span", { className: "text-foreground/30 shrink-0 font-mono text-xs", children: [index + 1, "/", total] })] }));
+}

package/dist/components/column-menu/types.d.ts

@@ -0,0 +1,21 @@
+/** A table column the user can show/hide and reorder. */
+export interface ColumnMenuColumn<K extends string = string> {
+    key: K;
+    label: string;
+    visible: boolean;
+}
+/** Texts displayed by `ColumnMenu` (English by default). */
+export interface ColumnMenuLabels {
+    /** Trigger button text (hidden on small screens). */
+    trigger: string;
+    /** Menu title. */
+    title: string;
+    /** Reset button text. */
+    reset: string;
+    /** Usage hint under the title. */
+    hint: string;
+    /** Tooltip / accessible name of a row's drag handle. */
+    dragHandle: (label: string) => string;
+}
+export declare const DEFAULT_COLUMN_MENU_LABELS: ColumnMenuLabels;
+//# sourceMappingURL=types.d.ts.map

package/dist/components/column-menu/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/column-menu/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACzD,GAAG,EAAE,CAAC,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACvC;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAMxC,CAAC"}

package/dist/components/column-menu/types.js

@@ -0,0 +1,7 @@
+export const DEFAULT_COLUMN_MENU_LABELS = {
+    trigger: "Columns",
+    title: "Visible columns",
+    reset: "Reset",
+    hint: "Drag to reorder · toggle to show/hide",
+    dragHandle: (label) => `Move column ${label}`,
+};

package/dist/components/column-menu/use-dnd-sensors.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mouse (5px threshold, so clicks still work), touch (250ms long press, so
+ * the list still scrolls) and keyboard sensors for a sortable list.
+ */
+export declare function useDndSensors(): import("@dnd-kit/core").SensorDescriptor<import("@dnd-kit/core").SensorOptions>[];
+//# sourceMappingURL=use-dnd-sensors.d.ts.map

package/dist/components/column-menu/use-dnd-sensors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dnd-sensors.d.ts","sourceRoot":"","sources":["../../../src/components/column-menu/use-dnd-sensors.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,aAAa,sFAU5B"}

package/dist/components/column-menu/use-dnd-sensors.js

@@ -0,0 +1,14 @@
+"use client";
+import { KeyboardSensor, MouseSensor, TouchSensor, useSensor, useSensors, } from "@dnd-kit/core";
+import { sortableKeyboardCoordinates } from "@dnd-kit/sortable";
+/**
+ * Mouse (5px threshold, so clicks still work), touch (250ms long press, so
+ * the list still scrolls) and keyboard sensors for a sortable list.
+ */
+export function useDndSensors() {
+    return useSensors(useSensor(MouseSensor, { activationConstraint: { distance: 5 } }), useSensor(TouchSensor, {
+        activationConstraint: { delay: 250, tolerance: 5 },
+    }), useSensor(KeyboardSensor, {
+        coordinateGetter: sortableKeyboardCoordinates,
+    }));
+}

package/dist/components/combobox/combobox.d.ts

@@ -1,4 +1,5 @@
 import * as React from "react";
+import { type UiLocale } from "../../locale/locale.js";
 export interface ComboboxOption {
     label: string;
     value: string;
@@ -12,6 +13,20 @@ export interface ComboboxProps {
     emptyMessage?: string;
     disabled?: boolean;
     className?: string;
+    /** `id` of the trigger — set by `Field`, or for a `<label htmlFor>`. */
+    id?: string;
+    /**
+     * Accessible name of the trigger (a combobox takes no name from its text).
+     * Defaults to the placeholder, unless a `<label>` targets `id`.
+     */
+    ariaLabel?: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: boolean;
+    /**
+     * Language of the built-in labels — French by default, or the nearest
+     * `UiLocaleProvider`'s. Explicit text props still win.
+     */
+    locale?: UiLocale;
 }
 /**
  * An autocomplete/searchable select — shadcn-ui doesn't ship a standalone
@@ -27,5 +42,5 @@ export interface ComboboxProps {
  * @author Forth
  * @copyright 2026 Forth
  */
-export declare function Combobox({ options, value, onValueChange, placeholder, emptyMessage, disabled, className, }: ComboboxProps): React.JSX.Element;
+export declare function Combobox({ options, value, onValueChange, placeholder, emptyMessage, disabled, className, locale, id, ariaLabel, "aria-describedby": ariaDescribedBy, "aria-invalid": ariaInvalid, }: ComboboxProps): React.JSX.Element;
 //# sourceMappingURL=combobox.d.ts.map

package/dist/components/combobox/combobox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../src/components/combobox/combobox.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAoB/B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,KAAK,EACL,aAAa,EACb,WAAuB,EACvB,YAAkC,EAClC,QAAgB,EAChB,SAAS,GACV,EAAE,aAAa,qBAkDf"}
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../src/components/combobox/combobox.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,wBAAwB,CAAC;AAGtE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,KAAK,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,QAAgB,EAChB,SAAS,EACT,MAAM,EACN,EAAE,EACF,SAAS,EACT,kBAAkB,EAAE,eAAe,EACnC,cAAc,EAAE,WAAW,GAC5B,EAAE,aAAa,qBA8Df"}

package/dist/components/combobox/combobox.js

@@ -5,7 +5,8 @@ import { CheckIcon, ChevronsUpDownIcon } from "lucide-react";
 import { Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, } from "@forthtilliath/shadcn-ui/components/command";
 import { Popover, PopoverContent, PopoverTrigger, } from "@forthtilliath/shadcn-ui/components/popover";
 import { cn } from "@forthtilliath/shadcn-ui/lib/utils";
-import { Button } from "../button";
+import { useUiMessages } from "../../locale/locale.js";
+import { Button } from "../button/index.js";
 /**
  * An autocomplete/searchable select — shadcn-ui doesn't ship a standalone
  * Combobox primitive, only a docs recipe combining `Popover` + `Command`
@@ -20,10 +21,13 @@ import { Button } from "../button";
  * @author Forth
  * @copyright 2026 Forth
  */
-export function Combobox({ options, value, onValueChange, placeholder = "Select…", emptyMessage = "No results found.", disabled = false, className, }) {
+export function Combobox({ options, value, onValueChange, placeholder, emptyMessage, disabled = false, className, locale, id, ariaLabel, "aria-describedby": ariaDescribedBy, "aria-invalid": ariaInvalid, }) {
+    const messages = useUiMessages(locale);
+    const emptyMessageText = emptyMessage ?? messages.emptyResults;
+    const placeholderText = placeholder ?? messages.combobox.placeholder;
     const [open, setOpen] = React.useState(false);
     const selected = options.find((option) => option.value === value);
-    return (_jsxs(Popover, { open: open, onOpenChange: setOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { type: "button", variant: "outline", role: "combobox", "aria-expanded": open, disabled: disabled, className: cn("w-full justify-between font-normal", className), children: [selected?.label ?? placeholder, _jsx(ChevronsUpDownIcon, { className: "opacity-50" })] }) }), _jsx(PopoverContent, { className: "w-(--radix-popover-trigger-width) p-0", children: _jsxs(Command, { children: [_jsx(CommandInput, { placeholder: placeholder }), _jsxs(CommandList, { children: [_jsx(CommandEmpty, { children: emptyMessage }), _jsx(CommandGroup, { children: options.map((option) => (_jsxs(CommandItem, { value: option.label, disabled: option.disabled, onSelect: () => {
+    return (_jsxs(Popover, { open: open, onOpenChange: setOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { type: "button", variant: "outline", id: id, role: "combobox", "aria-expanded": open, "aria-label": ariaLabel ?? (id === undefined ? placeholderText : undefined), "aria-describedby": ariaDescribedBy, "aria-invalid": ariaInvalid, disabled: disabled, className: cn("w-full justify-between font-normal", className), children: [selected?.label ?? placeholderText, _jsx(ChevronsUpDownIcon, { className: "opacity-50" })] }) }), _jsx(PopoverContent, { "aria-label": ariaLabel ?? placeholderText, className: "w-(--radix-popover-trigger-width) p-0", children: _jsxs(Command, { children: [_jsx(CommandInput, { placeholder: placeholderText }), _jsxs(CommandList, { children: [_jsx(CommandEmpty, { children: emptyMessageText }), _jsx(CommandGroup, { children: options.map((option) => (_jsxs(CommandItem, { value: option.label, disabled: option.disabled, onSelect: () => {
                                             onValueChange?.(option.value === value ? "" : option.value);
                                             setOpen(false);
                                         }, children: [_jsx(CheckIcon, { className: cn("size-4", option.value === value ? "opacity-100" : "opacity-0") }), option.label] }, option.value))) })] })] }) })] }));

package/dist/components/combobox/index.d.ts

@@ -1,5 +1,5 @@
-export type { ComboboxOption, ComboboxProps } from "./combobox";
-export { Combobox } from "./combobox";
-export type { MultiSelectOption, MultiSelectProps } from "./multi-select";
-export { MultiSelect } from "./multi-select";
+export type { ComboboxOption, ComboboxProps } from "./combobox.js";
+export { Combobox } from "./combobox.js";
+export type { MultiSelectOption, MultiSelectProps } from "./multi-select.js";
+export { MultiSelect } from "./multi-select.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/combobox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/combobox/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/combobox/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/combobox/index.js

@@ -1,2 +1,2 @@
-export { Combobox } from "./combobox";
-export { MultiSelect } from "./multi-select";
+export { Combobox } from "./combobox.js";
+export { MultiSelect } from "./multi-select.js";

package/dist/components/combobox/multi-select.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
-import type { ComboboxOption } from "./combobox";
+import { type UiLocale } from "../../locale/locale.js";
+import type { ComboboxOption } from "./combobox.js";
 export type MultiSelectOption = ComboboxOption;
 export interface MultiSelectProps {
     options: MultiSelectOption[];
@@ -10,6 +11,20 @@ export interface MultiSelectProps {
     emptyMessage?: string;
     disabled?: boolean;
     className?: string;
+    /** `id` of the trigger — set by `Field`, or for a `<label htmlFor>`. */
+    id?: string;
+    /**
+     * Accessible name of the trigger (a combobox takes no name from its text).
+     * Defaults to the placeholder, unless a `<label>` targets `id`.
+     */
+    ariaLabel?: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: boolean;
+    /**
+     * Language of the built-in labels — French by default, or the nearest
+     * `UiLocaleProvider`'s. Explicit text props still win.
+     */
+    locale?: UiLocale;
 }
 /**
  * `Combobox`'s multi-value sibling — selected options render as removable
@@ -26,5 +41,5 @@ export interface MultiSelectProps {
  * @author Forth
  * @copyright 2026 Forth
  */
-export declare function MultiSelect({ options, value, defaultValue, onValueChange, placeholder, emptyMessage, disabled, className, }: MultiSelectProps): React.JSX.Element;
+export declare function MultiSelect({ options, value, defaultValue, onValueChange, placeholder, emptyMessage, disabled, className, locale, id, ariaLabel, "aria-describedby": ariaDescribedBy, "aria-invalid": ariaInvalid, }: MultiSelectProps): React.JSX.Element;
 //# sourceMappingURL=multi-select.d.ts.map

package/dist/components/combobox/multi-select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi-select.d.ts","sourceRoot":"","sources":["../../../src/components/combobox/multi-select.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqB/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,YAAY,EACZ,aAAa,EACb,WAAuB,EACvB,YAAkC,EAClC,QAAgB,EAChB,SAAS,GACV,EAAE,gBAAgB,qBAoHlB"}
+{"version":3,"file":"multi-select.d.ts","sourceRoot":"","sources":["../../../src/components/combobox/multi-select.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmB/B,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,wBAAwB,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,QAAgB,EAChB,SAAS,EACT,MAAM,EACN,EAAE,EACF,SAAS,EACT,kBAAkB,EAAE,eAAe,EACnC,cAAc,EAAE,WAAW,GAC5B,EAAE,gBAAgB,qBA4HlB"}