@endfield-ui/react 1.0.1 → 1.1.0

package/NOTICE.md

@@ -9,19 +9,49 @@
 
 ## 本仓库不包含
 
+除了下一节单独说明的 Game 实机风格入口，本仓库不包含：
+
 - 官方截图、立绘、Logo、图标、纹理、视频或音频；
 - 官方网站或游戏客户端使用的字体文件（含 Novecento Sans Wide、Gilroy 等商业字体）；
 - 从官方网站或客户端提取的源码与样式表。
 
 文档中出现的色值、字号、时长等数据来自对**公开网页**的观察与测量，属于对事实的记录；所有官方画面一律以外部链接引用，不做转存。
 
+字体、音频、视频和从官方提取的源码，Game 实机风格入口同样不包含。
+
+## Game 实机风格入口的官方图片
+
+组件库有一个单独的入口 `@endfield-ui/react/game`（源码在 `packages/ui/src/game`），收的是照游戏内界面复刻的一组控件。**它带着 25 张官方图片**，这是本仓库里唯一有官方素材的地方：
+
+| 用在哪 | 张数 | 位置（相对 `packages/ui/src/game`） | 随 npm 包 |
+| --- | --- | --- | --- |
+| `RoundedIconButton` 的纹理 | 1 | `rounded-button/assets/` | 是 |
+| `BannerAlert`、`FullWidthAlert` 的横幅、底图与标志底图 | 4 | `banner-alert/assets/` | 是 |
+| `ItemCard` 的亮暗背景与稀有度底边 | 12 | `item-card/assets/` | 是 |
+| `ItemTooltipCard` 的标题纹理、详情入口图标、正文底图 | 3 | `item-tooltip-card/assets/` | 是 |
+| 预览站里物品示例用的图标 | 5 | `item-card/assets/` | 否 |
+
+- 这些图片取自游戏界面与物品图，经社区项目 [EndfieldMap](https://github.com/ArkEndfield/EndfieldMap) 和 EndfieldWiki 转来。**本仓库没有取得授权**，两个上游仓库也没有为它们标明许可。
+- 它们的权利归鹰角网络及其权利人。**MIT 许可不覆盖这些图片**，本仓库不宣称对它们有任何权利，也给不了使用方使用它们的权利。
+- 其中 `banner-alert/assets/deco_common_logo_bg.png` 里是官方的「终末地 / ENDFIELD INDUSTRIES」标志；`AnimatedDialog` 的装饰条上有代码画的 `ARKNIGHTS:ENDFIELD`、`ENDFIELD` 字样。这两处涉及商标。
+- 逐张的路径、尺寸、字节数、SHA256 和来源登记在 [`packages/ui/src/game/resource-provenance.json`](packages/ui/src/game/resource-provenance.json)，随包在 `dist/game/resource-provenance.json`。发布的包里，这些图片只在 `dist/game/assets/` 一处。
+- 主入口（`@endfield-ui/react`）、主样式、令牌和母题工具类里没有它们。不引 `@endfield-ui/react/game` 和 `@endfield-ui/react/game.css`，就不会加载其中任何一张。
+- 使用方可以整类关掉这些图片（在 `<html>` 上写 `data-ef-game-images="off"`，控件退回代码画的样子），也可以经变量逐张换成自己的。
+- 权利人提出异议时，我们会拿掉被指出的图片、发补丁版本，并把受影响的旧版本在 npm 上标记为弃用。这个入口的图片不在语义化版本的承诺之内。
+
+风险和处理的完整说明、给使用方的建议，见 [docs/design/game/README.md](docs/design/game/README.md#风险与处理)。
+
+物品详情卡"获取途径"的两个图标用的是 [Lucide](https://lucide.dev) 的 `package-search`、`chevrons-right` 路径，不是本库的原创图标，也不是官方素材。Lucide 的 ISC 许可与其中 Feather 图标的 MIT 声明保存在 `packages/ui/src/game/item-tooltip-card/LICENSE.lucide`，随包在 `dist/game/LICENSE.lucide`。
+
 ## 使用本项目时请注意
 
 - 本项目提供的是"受终末地视觉语言启发"的设计规范和按它实现的组件库，不是官方设计规范，也不代表官方立场。
 - 请不要用它制作可能被误认为官方产品、官方公告或官方周边的内容。
-- 公开发布或商业使用衍生作品前，请自行确认符合鹰角网络的同人创作与素材使用政策；截至本文档撰写时，我们没有检索到针对《终末地》的官方同人创作规范原文，以官方最新公告为准。
+- 公开发布或商业使用衍生作品前，请自行确认符合鹰角网络的同人创作与素材使用政策；截至本文档撰写时，我们没有检索到针对《终末地》的官方同人创作规范原文，以官方最新公告为准。用了 Game 实机风格入口的，这一条尤其要紧：那里的图片是官方素材。
 - 权利人如认为本仓库内容不妥，请通过 Issue 联系，我们会及时处理。
 
 ## 引用的开源项目
 
-文档参考了若干社区开源项目的方法与结论，逐项出处与许可证见 [docs/design/references/open-source-projects.md](docs/design/references/open-source-projects.md)。这些项目的内容版权归各自作者所有；本仓库没有复制它们的代码或素材。
+文档参考了若干社区开源项目的方法与结论，逐项出处与许可证见 [docs/design/references/open-source-projects.md](docs/design/references/open-source-projects.md)。这些项目的内容版权归各自作者所有；主库没有复制它们的代码或素材。
+
+Game 实机风格入口的控件迁自 [EndfieldMap](https://github.com/ArkEndfield/EndfieldMap/tree/main/packages/web-components) 的组件实现，物品卡片与详情卡的排版参考了 EndfieldWiki，经 [icaruszezen/endfield-ui#1](https://github.com/icaruszezen/endfield-ui/pull/1) 从 ArkEndfield 组织的仓库提交进来。交互行为改由 Base UI 承担，没有带入音效、字体文件或外链资源；带入的图片见上一节。

package/README.md

@@ -14,6 +14,8 @@
 | 导航 | SideRail（含二级）、TopBar、NavMenu、NavAction、PageHeader、Breadcrumb、Pagination、Navigator、AvatarSwitcher、DashIndicator、Steps、Toc、BackToTop |
 | 母题 | CornerBrackets、Viewfinder、GhostText、Hatch、Texture、RegistrationStrip、TickRing、HazardStripe |
 
+另有一组照游戏内界面复刻的控件，走单独的入口 `@endfield-ui/react/game`，带官方图片，不在上面这张表里，见 [Game 实机风格](#game-实机风格独立入口)。
+
 每个控件的变体与状态见[在线预览](https://icaruszezen.github.io/endfield-ui/)；各版本改了什么见[更新记录](https://github.com/icaruszezen/endfield-ui/blob/main/CHANGELOG.md)。
 
 ## 安装
@@ -653,7 +655,7 @@ import {
 - `ScrollArea` 是一块限高、自己滚的区域，滚动条是画出来的；高度（或上限）用 `className` 给。只有真的溢出才有滚动条，也才是一个能聚焦的区域，所以 `aria-label` 必填。整页的滚动留给浏览器，不要包。`viewportRef` 交出真正在滚的元素，给 `Toc`、`BackToTop` 的 `target`。
 - `Schedule` 的条目只写起止日期，位置和错行都是算出来的；放不下时在自己的容器里横向滚动。
 - `BackToTop` 滚过 400px 才出现，默认钉在视口右下角；点了回到顶部，焦点也交还给页面的头上。要看某个滚动容器时传 `target`，并用 `className` 改位置。祖先上有 `transform` 或容器查询（`@container`）时 `fixed` 不再相对视口：把它放在那一栏的最后，加 `className="sticky bottom-4 self-end"`。
-- 本库不带任何图片：头像、轮播和排期里的图都由使用方给。
+- 主入口不带任何图片：头像、轮播和排期里的图都由使用方给。
 
 每一页顶上放一个页头：
 
@@ -799,6 +801,38 @@ import { GhostText, TickRing, Viewfinder } from "@endfield-ui/react";
 
 用 Tailwind 的项目也可以直接用工具类（`cut-tr`、`wedge-r`、`corner-brackets`、`ghost-hatch`、`hatch`、`hazard`、`dot-grid`、`blueprint-grid`、`contour`），见 [styles/README.md](src/styles/README.md)。这些母题最容易用过头，什么时候该用见 [母题文档](https://github.com/icaruszezen/endfield-ui/blob/main/docs/design/elements/corner-and-wedge.md)。
 
+### Game 实机风格（独立入口）
+
+照游戏内界面复刻的一组控件，迁自社区项目 EndfieldMap 与 EndfieldWiki。它和上面的控件是两套东西：固定的灰与黄，不随主题变；样式是每个控件一份纯 CSS，不是工具类；**带着官方图片**。所以它不从主入口导出，样式也不在主样式里：
+
+```tsx
+import "@endfield-ui/react/game.css";
+import {
+  AnimatedDialog,
+  BannerAlert,
+  ItemCard,
+  RoundedButton,
+  RoundedSelect,
+} from "@endfield-ui/react/game";
+```
+
+| 控件 | 是什么 | 文档 |
+| --- | --- | --- |
+| `AnimatedDialog` | 分段入场的装饰弹窗 | [动画弹窗与圆角下拉](https://github.com/icaruszezen/endfield-ui/blob/main/docs/design/game/dialog-and-select.md) |
+| `RoundedSelect` | 圆角触发器、灰色面板的下拉，接得进 `Field` | 同上 |
+| `RoundedButton`、`RoundedIconButton`、`RoundedToggle`、`RoundedSwitch` | 圆角的按钮、图标按钮、分段选择、ON / OFF 文字开关 | [圆角控件](https://github.com/icaruszezen/endfield-ui/blob/main/docs/design/game/rounded-controls.md) |
+| `BannerAlert`、`FullWidthAlert` | 紧凑卡片与通栏面板两种确认提示，确认、取消都能异步否决 | [确认提示](https://github.com/icaruszezen/endfield-ui/blob/main/docs/design/game/confirmation-alerts.md) |
+| `ItemCard`、`ItemIcon` | 带稀有度、库存的物品卡片与分层图标 | [物品卡片](https://github.com/icaruszezen/endfield-ui/blob/main/docs/design/game/item-cards.md) |
+| `ItemTooltipCard`、`ItemHoverCard`、`ItemHoverCardLayer` | 物品详情卡，单个控件或整片网格的悬浮预览 | [物品悬浮卡](https://github.com/icaruszezen/endfield-ui/blob/main/docs/design/game/item-hover-cards.md) |
+
+- `game.css` 用不用 Tailwind 都是这一份，**和主样式一起引**（`tailwind.css` 或 `styles.css`）。从脚本里 `import`，让打包工具去处理里面图片的相对地址。
+- 规则都在 `components` 层：你在 `className`、`classNames` 里写的工具类盖得掉默认值；和主样式谁先加载都一样。
+- 和主库的控件可以混着用：用到的 `Field` 上下文、局部主题和主入口是同一份。弹窗和确认提示的正文区是一块局部的亮色主题，暗色页面上放进去的主库控件也按亮色取值。
+- 不想加载官方图片：在 `<html>` 上写 `data-ef-game-images="off"`，整类退回代码画的样子；每张图也能经 `--ef-game-*` 变量单独换掉，变量表见[换掉或关掉图片](https://github.com/icaruszezen/endfield-ui/blob/main/docs/design/game/README.md#换掉或关掉图片)。
+- 主库里名字相近的 `Dialog`、`Select`、`Button`、`SegmentedControl`、`Switch`、`Alert`、`ItemSlot`、`HoverCard` 不因为它而变。
+
+> **这个入口带着 25 张官方图片**（界面纹理、卡片背景、一张官方标志；其中 20 张随包发在 `dist/game/assets`），没有取得授权，MIT 许可不覆盖它们。权利人提出异议时我们会撤下并发补丁版本——这些图片不在语义化版本的承诺之内。不引这个入口，你的产物里不会有其中任何一张，但 npm 包里仍然带着这些文件。用之前请读[风险与处理](https://github.com/icaruszezen/endfield-ui/blob/main/docs/design/game/README.md#风险与处理)。
+
 ### 主题
 
 默认亮色。在 `<html>`（或任意容器）上加 `data-theme="dark"` 切到暗色；暗色区域里也可以用 `data-theme="light"` 切回来。
@@ -871,6 +905,7 @@ packages/ui/
 └── src/
     ├── index.ts      入口
     ├── components/   一组件一目录，见 components/README.md
+    ├── game/         Game 实机风格：独立入口，带官方图片，见 game/README.md
     ├── styles/       令牌、母题工具类、样式入口，见 styles/README.md
     ├── hooks/        与组件无关的通用 hooks（主题、受控状态、浮层的局部主题）
     ├── lib/          纯函数工具
@@ -888,7 +923,7 @@ packages/ui/
 | `pnpm test:browser` | 在真的浏览器里测键盘、焦点与布局（先 `pnpm build:docs`），见 [apps/docs](https://github.com/icaruszezen/endfield-ui/blob/main/apps/docs/README.md#浏览器实测) |
 | `pnpm typecheck` | 类型检查全部工作区包 |
 | `pnpm lint` | 用 oxlint 查写错的地方：漏掉的 `await`、钩子的用法、已弃用的接口等 |
-| `pnpm build` | 生成 `dist/index.js`、`dist/index.d.ts`、`dist/styles.css` |
+| `pnpm build` | 生成 `dist/index.js`、`dist/index.d.ts`、`dist/styles.css`，以及 Game 入口的 `dist/game.js`、`dist/game.d.ts` 和 `dist/game/`（样式、图片、来源清单） |
 | `pnpm format` | 用 Prettier 格式化全仓库；`pnpm format:check` 只检查不改，CI 跑的是它 |
 
 格式用 Prettier 的默认配置，提交前跑一次 `pnpm format`。Markdown 不在它的范围里（它会把表格逐列补空格对齐）；Tailwind 的类名顺序也不归它管。

package/dist/game/LICENSE.lucide

@@ -0,0 +1,43 @@
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/game/resource-provenance.json

@@ -0,0 +1,384 @@
+{
+  "note": "Game 实机风格这一类带的全部图片。它们取自游戏与官方素材，经下面两个社区仓库转来，没有取得授权，上游也没有标许可；权利归鹰角网络及其权利人，本仓库的 MIT 许可不覆盖它们。风险与处理见 docs/design/game/README.md。path 相对 packages/ui/src/game；shipped 为 true 的被样式引用、随 npm 包发在 dist/game/assets，为 false 的只有预览站的示例在用。来源地址的后缀是 .png 的几张实际编码是 WebP，迁入时只复制字节，没有下载、转换或重新编码。",
+  "sources": {
+    "ArkEndfield/EndfieldMap": {
+      "revision": "75fd60a82ca7c91305cb2e7dadc33fd5047c7ac2",
+      "note": "圆形按钮纹理与确认提示的四张图直接取自这里；物品与详情卡的图是它保存的 EndfieldWiki 资源副本"
+    },
+    "ArkEndfield/EndfieldWiki": {
+      "revision": "bbcc1813b2e4fafd90b70c97704ddf40d7d528ef",
+      "implementation": [
+        "apps/web/src/plugins/endfield/_shared/item-icon.tsx",
+        "apps/web/src/plugins/endfield/_shared/item-card.tsx",
+        "apps/web/src/plugins/endfield/_shared/item-tooltip/ItemTooltipCard.tsx"
+      ]
+    }
+  },
+  "icons": {
+    "note": "获取途径的两个 SVG 用的是 Lucide 的路径（package-search、chevrons-right），不是本库的原创图标，也不是官方素材；没有运行时依赖。",
+    "licenseFile": "item-tooltip-card/LICENSE.lucide",
+    "packageSearch": "https://github.com/lucide-icons/lucide/blob/main/icons/package-search.svg",
+    "chevronsRight": "https://github.com/lucide-icons/lucide/blob/main/icons/chevrons-right.svg"
+  },
+  "assets": [
+    {
+      "path": "rounded-button/assets/pag-button-texture.png",
+      "usedBy": ["RoundedIconButton"],
+      "role": "button-texture",
+      "shipped": true,
+      "format": "PNG",
+      "width": 75,
+      "height": 75,
+      "bytes": 1871,
+      "sha256": "87df952dae4e1a85e95a00447889acca95cd237281e00b8a66107aa33ac89cee",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/pag-button-texture.png"
+    },
+    {
+      "path": "banner-alert/assets/alert_banner_bg_left.png",
+      "usedBy": ["BannerAlert", "FullWidthAlert"],
+      "role": "alert-banner",
+      "shipped": true,
+      "format": "PNG",
+      "width": 73,
+      "height": 228,
+      "bytes": 14728,
+      "sha256": "28f5931c6d83da86b4009d2ab81ee693bf32e1a09061aea79c7dacb990a78406",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/alert/alert_banner_bg_left.png"
+    },
+    {
+      "path": "banner-alert/assets/alert_banner_bg_right.png",
+      "usedBy": ["BannerAlert", "FullWidthAlert"],
+      "role": "alert-banner",
+      "shipped": true,
+      "format": "PNG",
+      "width": 353,
+      "height": 228,
+      "bytes": 71872,
+      "sha256": "a456f08725960827b094bc7f437b42f0c62393f03e209365cd0446313c2657db",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/alert/alert_banner_bg_right.png"
+    },
+    {
+      "path": "banner-alert/assets/alert_bg.png",
+      "usedBy": ["BannerAlert"],
+      "role": "alert-background",
+      "shipped": true,
+      "format": "PNG",
+      "width": 663,
+      "height": 239,
+      "bytes": 93941,
+      "sha256": "c4aa2906120eaf34b823cf29987fa187cf19dd78c4478560f1bf3ae3e06071de",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/alert/alert_bg.png"
+    },
+    {
+      "path": "banner-alert/assets/deco_common_logo_bg.png",
+      "usedBy": ["FullWidthAlert"],
+      "role": "alert-logo",
+      "shipped": true,
+      "format": "PNG",
+      "width": 666,
+      "height": 577,
+      "bytes": 63063,
+      "sha256": "e16e0981ebd19db0771edb876b3e48378b6e42e73672a5317eaa14b3ca0f8d6c",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/deco_common_logo_bg.png",
+      "trademark": "图里是官方的「终末地 / ENDFIELD INDUSTRIES」标志，涉及商标，是这一类里风险最高的一张"
+    },
+    {
+      "path": "item-card/assets/copper-bottle-content.webp",
+      "usedBy": ["（只有预览站的示例在用）"],
+      "role": "bottled-content",
+      "label": "赤铜瓶",
+      "shipped": false,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 7626,
+      "sha256": "416600559dee16682727b420baec35878824cfb479d5be079722fd25470a7530",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/copper-bottle-content.webp",
+      "sourceUrl": "https://assets.fz.wiki/c3338b6b5f3d4283/14e38b22e4e29abb.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/dev/item-tooltips/samples.generated.json",
+      "sourceRecordKey": "item_fbottle_copper_acid",
+      "sourceField": "iconContentUrl"
+    },
+    {
+      "path": "item-card/assets/copper-bottle.webp",
+      "usedBy": ["（只有预览站的示例在用）"],
+      "role": "item-art",
+      "label": "赤铜瓶",
+      "shipped": false,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 8284,
+      "sha256": "2952d75c8e5c1ae01afe91b112ad110d969b1df6a37d3bcf80e287fe2b836678",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/copper-bottle.webp",
+      "sourceUrl": "https://assets.fz.wiki/c3338b6b5f3d4283/0755478d4d182d2e.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/dev/item-tooltips/samples.generated.json",
+      "sourceRecordKey": "item_fbottle_copper_acid",
+      "sourceField": "iconUrl"
+    },
+    {
+      "path": "item-card/assets/crystal-shell.webp",
+      "usedBy": ["（只有预览站的示例在用）"],
+      "role": "item-art",
+      "label": "晶体外壳",
+      "shipped": false,
+      "format": "WebP",
+      "width": 260,
+      "height": 260,
+      "bytes": 9372,
+      "sha256": "ce76426d29c74e2a3c86fe753e3c7905f03484710e90472f7e0557f25d0277b9",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/crystal-shell.webp",
+      "sourceUrl": "https://assets.fz.wiki/c3338b6b5f3d4283/7d371ef776ddd7db.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/dev/item-tooltips/samples.generated.json",
+      "sourceRecordKey": "item_crystal_shell",
+      "sourceField": "iconUrl"
+    },
+    {
+      "path": "item-card/assets/enemies_background.webp",
+      "usedBy": ["ItemCard"],
+      "role": "card-background",
+      "theme": "light",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 2888,
+      "sha256": "7bf2f10113aebcc909458894f274e1254194225ccee0d72339d27a7ff12a52e7",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/enemies_background.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/enemies_background.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/globals.css:216-227"
+    },
+    {
+      "path": "item-card/assets/enemies_background_dark.webp",
+      "usedBy": ["ItemCard"],
+      "role": "card-background",
+      "theme": "dark",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 2874,
+      "sha256": "539a24fc5eed3dd6528de74150be41b99961705ab592c79ef5e85bd7aec962f8",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/enemies_background_dark.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/enemies_background_dark.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/globals.css:216-227"
+    },
+    {
+      "path": "item-card/assets/gold-ticket.webp",
+      "usedBy": ["（只有预览站的示例在用）"],
+      "role": "item-art",
+      "label": "折金票",
+      "shipped": false,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 14284,
+      "sha256": "60263983ffc30a2d1f70cb96f7b18a864db9ba3255b2e65b0d357e0eddbcc5bd",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/gold-ticket.webp",
+      "sourceUrl": "https://assets.fz.wiki/c3338b6b5f3d4283/a691dce3769cdd24.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/dev/item-tooltips/samples.generated.json",
+      "sourceRecordKey": "item_gold",
+      "sourceField": "iconUrl"
+    },
+    {
+      "path": "item-card/assets/icon_card_rarity_1_bottom_edge.webp",
+      "usedBy": ["ItemCard"],
+      "role": "rarity-edge",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 85,
+      "bytes": 3504,
+      "sha256": "cee32291e195472afa904b9ea2d831351befb8e1ab564c96476541e490f68eb0",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/icon_card_rarity_1_bottom_edge.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/icon_card_rarity_1_bottom_edge.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/plugins/endfield/_shared/item-card.tsx:179"
+    },
+    {
+      "path": "item-card/assets/icon_card_rarity_2_bottom_edge.webp",
+      "usedBy": ["ItemCard"],
+      "role": "rarity-edge",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 85,
+      "bytes": 3124,
+      "sha256": "7527e391978328db1b93a6a27c3ccee59748af92ab7dc519885855162e932a03",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/icon_card_rarity_2_bottom_edge.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/icon_card_rarity_2_bottom_edge.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/plugins/endfield/_shared/item-card.tsx:179"
+    },
+    {
+      "path": "item-card/assets/icon_card_rarity_3_bottom_edge.webp",
+      "usedBy": ["ItemCard"],
+      "role": "rarity-edge",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 85,
+      "bytes": 4106,
+      "sha256": "cf91fdad3e6d64cb85633be9f37db0024f74a91f0bef446494d1e643b62fc9c3",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/icon_card_rarity_3_bottom_edge.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/icon_card_rarity_3_bottom_edge.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/plugins/endfield/_shared/item-card.tsx:179"
+    },
+    {
+      "path": "item-card/assets/icon_card_rarity_4_bottom_edge.webp",
+      "usedBy": ["ItemCard"],
+      "role": "rarity-edge",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 85,
+      "bytes": 3682,
+      "sha256": "a15f4609e121daf9f95c345fe8ec71f1c37315b816470b7a5aa5a41d375ac494",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/icon_card_rarity_4_bottom_edge.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/icon_card_rarity_4_bottom_edge.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/plugins/endfield/_shared/item-card.tsx:179"
+    },
+    {
+      "path": "item-card/assets/icon_card_rarity_5_bottom_edge.webp",
+      "usedBy": ["ItemCard"],
+      "role": "rarity-edge",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 85,
+      "bytes": 4088,
+      "sha256": "0d8458f0b27ddb453b934f12aed5ce25cb0f129dd720a0b5131340a2954f6842",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/icon_card_rarity_5_bottom_edge.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/icon_card_rarity_5_bottom_edge.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/plugins/endfield/_shared/item-card.tsx:179"
+    },
+    {
+      "path": "item-card/assets/icon_card_rarity_6_bottom_edge.webp",
+      "usedBy": ["ItemCard"],
+      "role": "rarity-edge",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 85,
+      "bytes": 3312,
+      "sha256": "a8249b19af540380b938dd1e5da8a74cbbf666f6e870d9856f42f180540823df",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/icon_card_rarity_6_bottom_edge.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/icon_card_rarity_6_bottom_edge.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/plugins/endfield/_shared/item-card.tsx:179"
+    },
+    {
+      "path": "item-card/assets/items_background.webp",
+      "usedBy": ["ItemCard"],
+      "role": "card-background",
+      "theme": "light",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 2088,
+      "sha256": "c3c286958a445586c07657eed1939d13c6055546a8c2856dd345c20d9af9df2c",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/items_background.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/items_background.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/globals.css:216-227"
+    },
+    {
+      "path": "item-card/assets/items_background_dark.webp",
+      "usedBy": ["ItemCard"],
+      "role": "card-background",
+      "theme": "dark",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 2552,
+      "sha256": "0b320f7befcb2117ea554f273e86bfd22e8f8858ec6a5a9fdaf705cf98cc429f",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/items_background_dark.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/items_background_dark.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/globals.css:216-227"
+    },
+    {
+      "path": "item-card/assets/prism.webp",
+      "usedBy": ["（只有预览站的示例在用）"],
+      "role": "item-art",
+      "label": "协议棱柱组",
+      "shipped": false,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 14828,
+      "sha256": "1db3cb2ea16890be902370eabd2b1d1378fe2cf4a502c6337e7bfafd04f2ab45",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/prism.webp",
+      "sourceUrl": "https://assets.fz.wiki/c3338b6b5f3d4283/8f5cde16cf986e1a.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/dev/item-tooltips/samples.generated.json",
+      "sourceRecordKey": "item_char_skill_level_7_12",
+      "sourceField": "iconUrl"
+    },
+    {
+      "path": "item-card/assets/weapons_background.webp",
+      "usedBy": ["ItemCard"],
+      "role": "card-background",
+      "theme": "light",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 2908,
+      "sha256": "c420ff1d061b9dfc02f6a808254faa3970c5afd0f166af72afa43726ba4624cc",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/weapons_background.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/weapons_background.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/globals.css:216-227"
+    },
+    {
+      "path": "item-card/assets/weapons_background_dark.webp",
+      "usedBy": ["ItemCard"],
+      "role": "card-background",
+      "theme": "dark",
+      "shipped": true,
+      "format": "WebP",
+      "width": 256,
+      "height": 256,
+      "bytes": 2898,
+      "sha256": "5b7d20c7d40e8539bd8f46f4b1cb911535685faac681711c28bd63d531b121fa",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/items/weapons_background_dark.webp",
+      "sourceUrl": "https://assets.fz.wiki/upload/dev/icon_card/weapons_background_dark.png",
+      "sourceEvidence": "EndfieldWiki/apps/web/src/app/globals.css:216-227"
+    },
+    {
+      "path": "item-tooltip-card/assets/header.webp",
+      "usedBy": ["ItemTooltipCard", "ItemHoverCard"],
+      "role": "tooltip-header-texture",
+      "shipped": true,
+      "format": "WebP",
+      "width": 568,
+      "height": 80,
+      "bytes": 14812,
+      "sha256": "0abb6d08cbe0b06c142bd02c0fd3f570be94f2ebee56d935ad3ef6550d296703",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/item-tooltip",
+      "sourceUrl": "https://assets.fz.wiki/0f1bfaac667a4bf6/646d3d3aaa2e8a74.png"
+    },
+    {
+      "path": "item-tooltip-card/assets/link.webp",
+      "usedBy": ["ItemTooltipCard", "ItemHoverCard"],
+      "role": "tooltip-detail-link-icon",
+      "shipped": true,
+      "format": "WebP",
+      "width": 84,
+      "height": 84,
+      "bytes": 738,
+      "sha256": "8478f50adb20f3f69a085b0e5cf2afec7d2a323d128a348a8e554f226908d9e4",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/item-tooltip",
+      "sourceUrl": "https://assets.fz.wiki/cc5243ea76178097/2128e62936f3ba56.png"
+    },
+    {
+      "path": "item-tooltip-card/assets/detail.png",
+      "usedBy": ["ItemTooltipCard", "ItemHoverCard"],
+      "role": "tooltip-detail-background",
+      "shipped": true,
+      "format": "PNG",
+      "width": 64,
+      "height": 252,
+      "bytes": 4203,
+      "sha256": "478e03ef19b647366fb782918a0c4faf61e7e7875b35305fde3ee4e20c1b3f34",
+      "copiedFrom": "ArkEndfield/EndfieldMap/packages/web-components/src/assets/item-tooltip",
+      "sourceFile": "EndfieldWiki/apps/web/public/deco/item-tooltip/bg_tips_a_2.png"
+    }
+  ]
+}