@godxjp/ui 31.20.0 → 31.21.0

package/README.md

@@ -30,6 +30,11 @@ Writes `.mcp.json`, `CLAUDE.md` and `.ai/rules/` into the consumer repo and wire
 **locked to the version on disk** — the failure it prevents is an agent being told a prop does not
 exist because the catalog was two minors behind (gh#789).
 
+The package's postinstall runs this on every install, so an upgrade moves the MCP pin forward by
+itself. **Where install scripts are off** (`npm config get ignore-scripts` is `true`, which some CI
+images and machines set), it never runs: run `npx @godxjp/ui sync-rules` yourself after each upgrade,
+or the agent keeps asking the catalog of the version you first installed.
+
 ### If your agent can only fetch URLs
 
 ChatGPT on the web, Claude.ai, or any client without a local process. The same data is served as

package/agent/START-HERE.md

@@ -3,7 +3,7 @@
 You are about to write code against a design system you did not author. This file is the whole
 contract. Read it before you write JSX.
 
-**This catalog describes `@godxjp/ui` 31.20.0.** If the project you are editing has a different
+**This catalog describes `@godxjp/ui` 31.21.0.** If the project you are editing has a different
 version in its `package.json`, read the pinned catalog for THAT version instead
 (`…/v<their-version>/agent/…`). A catalog newer than the installed package describes props that do
 not exist yet; older, and it hides props that do. Neither failure announces itself.

package/agent/components/Image.json

@@ -16,9 +16,9 @@
       "type": "string"
     },
     {
-      "description": "antd shape. `false` = a plain, non-clickable picture that also leaves its group. `src` shows a different (larger) file in the preview. Defaults: scaleStep 0.5, minScale 1, maxScale 50.",
+      "description": "antd shape. `false` = a plain, non-clickable picture that also leaves its group. `src` shows a different (larger) file in the preview. Defaults: scaleStep 0.5, minScale 1, maxScale 50. `download` adds a Download action to the preview toolbar (gh#1122): `true` = a link to the picture on show (`<a href download>`; a cross-origin URL opens instead), a function `({ src, index }) => void` = a button for a signed URL or a blob. The same key works on `ImagePreviewGroup preview`.",
       "name": "preview",
-      "type": "boolean | { visible?, onVisibleChange?(visible, prevVisible), src?, mask?, scaleStep?, minScale?, maxScale? }"
+      "type": "boolean | { visible?, onVisibleChange?(visible, prevVisible), src?, mask?, scaleStep?, minScale?, maxScale?, download? }"
     },
     {
       "description": "Shown when `src` fails. A failed picture does not open a preview (antd).",

package/agent/components/Upload.json

@@ -78,7 +78,7 @@
       "type": "React.ReactNode"
     },
     {
-      "description": "Fires with the current file list.",
+      "description": "Fires with the current file list. If it (or `previewFile` / `onRemove`) THROWS, Upload reports the error through `globalThis.reportError` — the console and the window `error` event — and shows a message in the upload area; it is never swallowed (gh#1123).",
       "name": "onValueChange",
       "type": "(items: UploadFileItemProp[]) => void"
     },

package/agent/components.json

@@ -9895,7 +9895,7 @@
         "type": "React.ReactNode"
       },
       {
-        "description": "Fires with the current file list.",
+        "description": "Fires with the current file list. If it (or `previewFile` / `onRemove`) THROWS, Upload reports the error through `globalThis.reportError` — the console and the window `error` event — and shows a message in the upload area; it is never swallowed (gh#1123).",
         "name": "onValueChange",
         "type": "(items: UploadFileItemProp[]) => void"
       },
@@ -16041,9 +16041,9 @@
         "type": "string"
       },
       {
-        "description": "antd shape. `false` = a plain, non-clickable picture that also leaves its group. `src` shows a different (larger) file in the preview. Defaults: scaleStep 0.5, minScale 1, maxScale 50.",
+        "description": "antd shape. `false` = a plain, non-clickable picture that also leaves its group. `src` shows a different (larger) file in the preview. Defaults: scaleStep 0.5, minScale 1, maxScale 50. `download` adds a Download action to the preview toolbar (gh#1122): `true` = a link to the picture on show (`<a href download>`; a cross-origin URL opens instead), a function `({ src, index }) => void` = a button for a signed URL or a blob. The same key works on `ImagePreviewGroup preview`.",
         "name": "preview",
-        "type": "boolean | { visible?, onVisibleChange?(visible, prevVisible), src?, mask?, scaleStep?, minScale?, maxScale? }"
+        "type": "boolean | { visible?, onVisibleChange?(visible, prevVisible), src?, mask?, scaleStep?, minScale?, maxScale?, download? }"
       },
       {
         "description": "Shown when `src` fails. A failed picture does not open a preview (antd).",

package/agent/index.json

@@ -48,7 +48,7 @@
   "note": "Pin to the tag that matches the @godxjp/ui version you installed. A catalog newer than your package describes props you do not have; older, and it hides props you do.",
   "read": {
     "live": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/index.json",
-    "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v31.20.0/agent/index.json"
+    "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v31.21.0/agent/index.json"
   },
   "source": "mcp/src/data — the same data @godxjp/ui-mcp serves — plus the foundation and semantic token tiers, read from src/tokens/*.css",
   "start": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/START-HERE.md",
@@ -62,5 +62,5 @@
     "foundation": "the seeds a consumer is invited to set — --primary, --background, --radius",
     "semantic": "named roles that follow the seeds — --ring, --text-link, --overlay-background"
   },
-  "version": "31.20.0"
+  "version": "31.21.0"
 }

package/agent/llms.txt

@@ -1,10 +1,10 @@
 # @godxjp/ui
 
 > A Japanese-enterprise React design system: 181 components, 2129 design tokens,
-> 50 cardinal rules. This file is the entry point for AI agents. Catalog version 31.20.0.
+> 50 cardinal rules. This file is the entry point for AI agents. Catalog version 31.21.0.
 
 If your client can run a process, do not read these files — run the MCP server instead
-(`npx @godxjp/ui-mcp@31.20.0`). It is searchable and version-locked. These files exist for agents
+(`npx @godxjp/ui-mcp@31.21.0`). It is searchable and version-locked. These files exist for agents
 that can only fetch URLs.
 
 ## Start
@@ -26,7 +26,7 @@ that can only fetch URLs.
 ## Pinning
 
 Every URL above tracks `main`. To pin to the release a project actually installed, swap `main` for
-the tag: `.../godx-jp/godxjp-ui/v31.20.0/agent/...`. A catalog that does not match the installed
+the tag: `.../godx-jp/godxjp-ui/v31.21.0/agent/...`. A catalog that does not match the installed
 package describes props that are absent, or hides props that are present, and says nothing either way.
 
 Pinned catalogs only exist for releases whose tag actually contains `agent/`. If `…/v<version>/agent/index.json` returns 404, that release predates this catalog: read `…/main/…` instead and compare `index.json` → `version` against the package you have, so you at least know which way it drifted.

package/dist/components/data-display/image.js

@@ -6,6 +6,7 @@ import { Dialog as RacDialog, Modal, ModalOverlay } from "react-aria-components"
 import {
   ChevronLeft,
   ChevronRight,
+  Download,
   Eye,
   FlipHorizontal2,
   FlipVertical2,
@@ -70,7 +71,8 @@ function ImagePreviewDialog({
   fallback,
   scaleStep = DEFAULT_SCALE_STEP,
   minScale = DEFAULT_MIN_SCALE,
-  maxScale = DEFAULT_MAX_SCALE
+  maxScale = DEFAULT_MAX_SCALE,
+  download
 }) {
   const { t } = useTranslation();
   const portalContainer = useOverlayPortalContainer();
@@ -296,27 +298,53 @@ function ImagePreviewDialog({
                 ),
                 /* @__PURE__ */ jsx("span", { className: "sr-only", "aria-live": "polite", children: t("dataDisplay.image.position", { current: index + 1, total }) })
               ] }) : null,
-              /* @__PURE__ */ jsx(
+              /* @__PURE__ */ jsxs(
                 "div",
                 {
                   role: "group",
                   "aria-label": t("dataDisplay.image.toolbar"),
                   "data-slot": "image-preview-toolbar",
                   className: "ui-image-preview-toolbar",
-                  children: tools.map((tool) => /* @__PURE__ */ jsx(
-                    "button",
-                    {
-                      type: "button",
-                      "data-action": tool.key,
-                      className: "ui-image-preview-button ui-focus-ring",
-                      "aria-label": tool.label,
-                      title: tool.label,
-                      disabled: tool.off,
-                      onClick: tool.run,
-                      children: /* @__PURE__ */ jsx("span", { className: "ui-image-preview-icon", "aria-hidden": "true", children: tool.icon })
-                    },
-                    tool.key
-                  ))
+                  children: [
+                    download === true && entry ? /* @__PURE__ */ jsx(
+                      "a",
+                      {
+                        href: entry.src,
+                        download: "",
+                        "data-action": "download",
+                        className: "ui-image-preview-button ui-focus-ring",
+                        "aria-label": t("dataDisplay.image.download"),
+                        title: t("dataDisplay.image.download"),
+                        children: /* @__PURE__ */ jsx("span", { className: "ui-image-preview-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx(Download, {}) })
+                      }
+                    ) : null,
+                    typeof download === "function" && entry ? /* @__PURE__ */ jsx(
+                      "button",
+                      {
+                        type: "button",
+                        "data-action": "download",
+                        className: "ui-image-preview-button ui-focus-ring",
+                        "aria-label": t("dataDisplay.image.download"),
+                        title: t("dataDisplay.image.download"),
+                        onClick: () => download({ src: entry.src, index }),
+                        children: /* @__PURE__ */ jsx("span", { className: "ui-image-preview-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx(Download, {}) })
+                      }
+                    ) : null,
+                    tools.map((tool) => /* @__PURE__ */ jsx(
+                      "button",
+                      {
+                        type: "button",
+                        "data-action": tool.key,
+                        className: "ui-image-preview-button ui-focus-ring",
+                        "aria-label": tool.label,
+                        title: tool.label,
+                        disabled: tool.off,
+                        onClick: tool.run,
+                        children: /* @__PURE__ */ jsx("span", { className: "ui-image-preview-icon", "aria-hidden": "true", children: tool.icon })
+                      },
+                      tool.key
+                    ))
+                  ]
                 }
               )
             ] })
@@ -381,7 +409,8 @@ function ImagePreviewGroup({
         fallback,
         scaleStep: config.scaleStep,
         minScale: config.minScale,
-        maxScale: config.maxScale
+        maxScale: config.maxScale,
+        download: config.download
       }
     ) : null
   ] }) });
@@ -531,7 +560,8 @@ const ImageRoot = React.forwardRef(function Image({
           fallback,
           scaleStep: config.scaleStep,
           minScale: config.minScale,
-          maxScale: config.maxScale
+          maxScale: config.maxScale,
+          download: config.download
         }
       )
     ] })

package/dist/components/data-entry/upload.js

@@ -240,6 +240,14 @@ function Upload({
     );
     onReject?.({ file, reason, error });
   };
+  const reportCallbackError = (error, visible = true) => {
+    if (typeof globalThis.reportError === "function") globalThis.reportError(error);
+    else
+      setTimeout(() => {
+        throw error;
+      });
+    if (visible && mounted.current) setRejection(t("dataEntry.upload.callbackFailed"));
+  };
   const pickFiles = (fileList) => {
     if (!fileList?.length || current.current.disabled) return;
     const files = Array.from(fileList);
@@ -302,12 +310,10 @@ function Upload({
                 (entry) => entry.uid === item2.uid ? { ...entry, previewUrl: url } : entry
               )
             );
-          }).catch(() => {
-          });
+          }).catch((error) => reportCallbackError(error, false));
         if (automatic) void startUpload(item2);
       }
-    }).catch(() => {
-    });
+    }).catch((error) => reportCallbackError(error));
   };
   const removeItem = async (uid) => {
     if (current.current.disabled) return;
@@ -315,7 +321,8 @@ function Upload({
     if (!target) return;
     try {
       if (await onRemove?.(target) === false) return;
-    } catch {
+    } catch (error) {
+      reportCallbackError(error, false);
       return;
     }
     if (!mounted.current || current.current.disabled || !current.current.items.some((item2) => item2.uid === uid))

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": "31.20.0",
+  "version": "31.21.0",
   "targetSize": {
     "standard": "WCAG 2.2 SC 2.5.8 Target Size (Minimum), level AA — 24×24 CSS px",
     "min": 24,

package/dist/i18n/messages/en.json

@@ -92,7 +92,8 @@
       "rejectSize": "{name}: file is too large.",
       "rejectCount": "{name}: file limit reached.",
       "rejectBeforeUpload": "{name}: file validation failed.",
-      "readFailed": "Could not read the selected folder."
+      "readFailed": "Could not read the selected folder.",
+      "callbackFailed": "The selected files could not be added."
     },
     "cascader": {
       "placeholder": "Select…",
@@ -407,7 +408,8 @@
       "rotateRight": "Rotate right",
       "zoomIn": "Zoom in",
       "zoomOut": "Zoom out",
-      "reset": "Reset"
+      "reset": "Reset",
+      "download": "Download"
     }
   },
   "ui": {

package/dist/i18n/messages/ja.json

@@ -92,7 +92,8 @@
       "rejectSize": "{name}: ファイルが大きすぎます。",
       "rejectCount": "{name}: ファイル数の上限です。",
       "rejectBeforeUpload": "{name}: ファイルの検証に失敗しました。",
-      "readFailed": "選択したフォルダーを読み取れませんでした。"
+      "readFailed": "選択したフォルダーを読み取れませんでした。",
+      "callbackFailed": "選択したファイルを追加できませんでした。"
     },
     "cascader": {
       "placeholder": "選択…",
@@ -400,7 +401,8 @@
       "rotateRight": "右に回転",
       "zoomIn": "拡大",
       "zoomOut": "縮小",
-      "reset": "リセット"
+      "reset": "リセット",
+      "download": "ダウンロード"
     }
   },
   "ui": {

package/dist/i18n/messages/vi.json

@@ -92,7 +92,8 @@
       "rejectSize": "{name}: tệp quá lớn.",
       "rejectCount": "{name}: đã đủ số lượng tệp.",
       "rejectBeforeUpload": "{name}: kiểm tra tệp thất bại.",
-      "readFailed": "Không thể đọc thư mục đã chọn."
+      "readFailed": "Không thể đọc thư mục đã chọn.",
+      "callbackFailed": "Không thể thêm các tệp đã chọn."
     },
     "cascader": {
       "placeholder": "Chọn…",
@@ -401,7 +402,8 @@
       "rotateRight": "Xoay phải",
       "zoomIn": "Phóng to",
       "zoomOut": "Thu nhỏ",
-      "reset": "Đặt lại"
+      "reset": "Đặt lại",
+      "download": "Tải xuống"
     }
   },
   "ui": {

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

@@ -1273,6 +1273,16 @@ export type ImagePreviewConfigProp = {
     minScale?: number;
     /** Largest zoom. Default `50`. */
     maxScale?: number;
+    /**
+     * A Download action in the preview toolbar (gh#1122). `true`: a link to the picture on show
+     * (`<a href download>` — a cross-origin URL opens instead, since browsers ignore `download`
+     * there). A function: a button that calls it with the picture on show, for a signed URL or a
+     * streamed blob. Off by default.
+     */
+    download?: boolean | ((info: {
+        src: string;
+        index: number;
+    }) => void);
 };
 /** @see ImagePreviewGroup — the group's `preview` object (antd `PreviewGroup preview`). */
 export type ImagePreviewGroupConfigProp = Omit<ImagePreviewConfigProp, "src" | "mask"> & {

package/dist/styles/layers.json

@@ -1,5 +1,5 @@
 {
-  "version": "31.20.0",
+  "version": "31.21.0",
   "generatedBy": "scripts/gen-style-layers.mjs — do not edit by hand; run `pnpm gen:style-layers`",
   "base": "base.css",
   "fonts": "fonts.css",

package/package.json

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