@godxjp/ui 26.4.0 → 27.0.0

package/dist/components/data-entry/control-surface.d.ts

@@ -36,8 +36,11 @@ export type ResolvedAllowClear = {
  * Reconcile antd's `allowClear` with this library's own `clearable`.
  *
  * `allowClear` wins when present because it is the more specific statement — the object form
- * carries an icon and a label that `clearable` has no way to express. `clearable` remains the
- * name every existing call site uses, and keeps its `true` default.
+ * carries an icon and a label that `clearable` has no way to express. `clearable` stays as this
+ * library's own alias with the SAME default as antd's `allowClear` for the control: the caller
+ * passes that default (`undefined` reads as OFF — antd Select/TreeSelect/Input; a picker whose antd
+ * default is ON, DatePicker/TimePicker/Cascader, passes `true`). An antd-named prop takes antd's
+ * default too (docs/DESIGN-AUTHORITY.md), so a required select is not one click from empty.
  */
 export declare function resolveAllowClear(allowClear: AllowClearProp | undefined, clearable: boolean | undefined, fallbackLabel?: string): ResolvedAllowClear;
 /**

package/dist/components/data-entry/control-surface.js

@@ -20,7 +20,7 @@ function resolveAllowClear(allowClear, clearable, fallbackLabel) {
       label: allowClear.label ?? fallbackLabel
     };
   }
-  return { enabled: clearable !== false, label: fallbackLabel };
+  return { enabled: clearable === true, label: fallbackLabel };
 }
 function applyMaxTagCount(items, maxTagCount, maxTagPlaceholder) {
   if (maxTagCount === void 0 || maxTagCount < 0 || items.length <= maxTagCount) {

package/dist/components/data-entry/search-select.js

@@ -39,7 +39,7 @@ function SearchSelect(props) {
     loadingMessage,
     errorMessage,
     clearLabel,
-    clearable = true,
+    clearable,
     disabled = false,
     readOnly = false,
     size,

package/dist/components/data-entry/tree-select.js

@@ -237,7 +237,7 @@ function TreeSelectRoot({
         break;
     }
   };
-  const clearControl = resolveAllowClear(allowClear, true, t("dataEntry.treeSelect.clear"));
+  const clearControl = resolveAllowClear(allowClear, false, t("dataEntry.treeSelect.clear"));
   const showClear = clearControl.enabled && displayKeys.length > 0 && !disabled && !readOnly && !loading;
   const surface = controlSurfaceAttrs({ variant, status, size });
   return /* @__PURE__ */ jsxs(Popover, { open, onOpenChange: setOpen, children: [

package/dist/components/navigation/filter-bar.js

@@ -97,6 +97,7 @@ function Toolbar({
                         onValueChange: (selected) => filter.onSelectedChange?.(selected),
                         placeholder: filter.placeholder,
                         disabled: disabled || filter.disabled,
+                        allowClear: true,
                         clearLabel: typeof filter.label === "string" ? t("navigation.filterBar.clearFilter", { label: filter.label }) : void 0
                       }
                     )

package/dist/contracts/measurement.json

@@ -1,6 +1,6 @@
 {
   "$comment": "AUTO-GENERATED by scripts/gen-measurement-contract.mjs — do not edit. Read this instead of guessing: docs/MEASUREMENT-CONTRACT.md.",
-  "version": "26.4.0",
+  "version": "27.0.0",
   "targetSize": {
     "standard": "WCAG 2.2 SC 2.5.8 Target Size (Minimum), level AA — 24×24 CSS px",
     "min": 24,

package/dist/props/components/data-entry.prop.d.ts

@@ -1158,7 +1158,10 @@ export type SearchSelectBaseProp = {
      *  as-is unless `renderError` is provided. */
     errorMessage?: string;
     clearLabel?: string;
-    /** Show a "clear" row when a value is selected (default true). */
+    /**
+     * Show the clear ✕ when a value is selected (default false — antd `allowClear`). This library's
+     * own alias for `allowClear`; pass it on an OPTIONAL field whose empty state is a valid answer.
+     */
     clearable?: boolean;
     disabled?: DisabledProp;
     /**
@@ -1241,9 +1244,10 @@ export type SearchSelectBaseProp = {
      */
     popupMatchSelectWidth?: PopupMatchWidthProp;
     /**
-     * antd `allowClear`. `true`/`false` toggles the clear ✕ (same meaning as `clearable`, which
-     * stays as this library's own name); the OBJECT form additionally replaces the icon and/or the
-     * accessible label. When both are given, `allowClear` wins — it is the more specific statement.
+     * antd `allowClear` (default false, as in antd). `true`/`false` toggles the clear ✕ (same meaning
+     * as `clearable`, which stays as this library's own name); the OBJECT form additionally replaces
+     * the icon and/or the accessible label. When both are given, `allowClear` wins — it is the more
+     * specific statement.
      */
     allowClear?: AllowClearProp;
     /** Fired after the value is cleared through the ✕ (antd `onClear`). */
@@ -1547,6 +1551,10 @@ export type CascaderProp = FieldA11yProps & {
     id?: IdProp;
     expandTrigger?: "click" | "hover";
     fieldNames?: TreeFieldNamesProp;
+    /**
+     * antd `allowClear` — the ✕ that clears the selected path (default true, as in antd's Cascader).
+     * Pass `false` on a required field. The OBJECT form replaces the icon and/or the accessible label.
+     */
     allowClear?: AllowClearProp;
     /** Control height tier (antd `size`) — the shared `--control-height` ladder. */
     size?: SizeProp;
@@ -1622,6 +1630,10 @@ export type TreeSelectProp = FieldA11yProps & {
      * per checked value under the same name (the native `<select multiple>` contract).
      */
     name?: NameProp;
+    /**
+     * antd `allowClear` — the ✕ that clears the selection (default false, as in antd's TreeSelect).
+     * The OBJECT form additionally replaces the icon and/or the accessible label.
+     */
     allowClear?: AllowClearProp;
     className?: ClassNameProp;
     id?: IdProp;

package/docs/data-display/permission-matrix.tsx

@@ -122,7 +122,6 @@ export default function Demo() {
                     value={compareA}
                     onValueChange={setCompareA}
                     options={roleOptions}
-                    clearable={false}
                     className="w-40"
                   />
                 </FormField>
@@ -131,7 +130,6 @@ export default function Demo() {
                     value={compareB}
                     onValueChange={setCompareB}
                     options={roleOptions}
-                    clearable={false}
                     className="w-40"
                   />
                 </FormField>

package/docs/data-entry/chat-composer.tsx

@@ -371,7 +371,6 @@ export default function Demo() {
                         aria-label="ステータス"
                         value={status}
                         onValueChange={setStatus}
-                        clearable={false}
                         options={STATUSES}
                       />
                       <Text size="xs" tone="muted">

package/docs/data-entry/country-picker-recipe.tsx

@@ -95,7 +95,7 @@ export default function Demo() {
               value は ISO 3166-1 alpha-2 コード、ラベルは
               Intl.DisplayNames（CLDR）で生成する（国名を
               ハードコードしない・絵文字フラグも使わない）。 showSearch で絞り込み、name
-              でフォーム送信。 必須項目なので clearable=false でクリア行を出さない。
+              でフォーム送信。 必須項目なのでクリア ✕ は出さない（allowClear はデフォルト false）。
             </CardDescription>
           </CardHeader>
           <CardContent>
@@ -106,7 +106,6 @@ export default function Demo() {
                 value={billing}
                 onValueChange={setBilling}
                 showSearch
-                clearable={false}
                 searchPlaceholder="国名 / ISO コードで検索..."
                 emptyMessage="該当する国がありません"
                 options={COUNTRIES}
@@ -119,8 +118,8 @@ export default function Demo() {
           <CardHeader>
             <CardTitle level={2}>取引先の国（任意・クリア可）</CardTitle>
             <CardDescription>
-              clearable（デフォルト true）で「指定なし」に戻せる。placeholder で空状態を案内する。
-              任意項目なので未選択（プレースホルダー表示）を初期値にしている。
+              allowClear を付けて「指定なし」に戻せるようにする（デフォルトは false）。placeholder
+              で空状態を案内する。 任意項目なので未選択（プレースホルダー表示）を初期値にしている。
             </CardDescription>
           </CardHeader>
           <CardContent>
@@ -131,6 +130,7 @@ export default function Demo() {
                 value={partner}
                 onValueChange={setPartner}
                 showSearch
+                allowClear
                 placeholder="国を選択..."
                 searchPlaceholder="国名 / ISO コードで検索..."
                 emptyMessage="該当する国がありません"

package/docs/data-entry/select-matrix.tsx

@@ -159,6 +159,7 @@ export default function Demo() {
                 onValueChange={setSearchable}
                 showSearch
                 searchPlaceholder="拠点を検索 / Tìm văn phòng"
+                allowClear
                 clearLabel="選択をクリア"
                 options={REGIONS}
               />

package/docs/data-entry/select.tsx

@@ -127,7 +127,6 @@ export default function Demo() {
                 value={currency}
                 onValueChange={setCurrency}
                 showSearch
-                clearable={false}
                 searchPlaceholder="通貨を検索..."
                 options={[
                   { value: "JPY", label: "日本円", group: "アジア" },
@@ -144,8 +143,8 @@ export default function Demo() {
           <CardHeader>
             <CardTitle level={2}>Searchable + clearable</CardTitle>
             <CardDescription>
-              With a value set and clearable (default), an inline ✕ on the trigger resets the
-              selection without opening the list.
+              With a value set and allowClear (off by default, as in antd), an inline ✕ on the
+              trigger resets the selection without opening the list.
             </CardDescription>
           </CardHeader>
           <CardContent>
@@ -156,6 +155,7 @@ export default function Demo() {
                 value={assignee}
                 onValueChange={setAssignee}
                 showSearch
+                allowClear
                 searchPlaceholder="担当者を検索..."
                 placeholder="担当者を選択"
                 options={people}

package/docs/showcase/permission-matrix.tsx

@@ -173,7 +173,6 @@ export default function Demo() {
                   value={compareA}
                   onValueChange={setCompareA}
                   options={roleOptions}
-                  clearable={false}
                   className="w-40"
                 />
               </FormField>
@@ -182,7 +181,6 @@ export default function Demo() {
                   value={compareB}
                   onValueChange={setCompareB}
                   options={roleOptions}
-                  clearable={false}
                   className="w-40"
                 />
               </FormField>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@godxjp/ui",
-  "version": "26.4.0",
-  "godxUiMcp": "26.4.0",
+  "version": "27.0.0",
+  "godxUiMcp": "27.0.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",