fix(antdx): FileCard / FileCard.List.Item crash when src is a file dict without url

[Linxiushen]

Problem

antdx.FileCard and antdx.FileCard.List.Item accept src either as a string or as a file dict (the frontend type is string | FileData). The dict branch in both constructors reads:

elif isinstance(src, dict):
    if not src.get("url", None) and src.get("path", None):
        self.src = {**src, **self.serve_static_file(self.item["path"])}
    self.src = src

self.item does not exist on either class or on their base classes, so passing a dict with a path but no url raises at construction time:

AttributeError: 'AntdXFileCard' object has no attribute 'item'

That shape is the natural one for files the app produced or received locally. pro.Chatbot.postprocess emits exactly {'path': ..., 'url': None, ...} for a local attachment, for example. Even if the lookup had worked, the following unconditional self.src = src overwrote the served value, so the branch could never take effect.

Reachability, stated plainly: the bundled demo passes an http URL string and is not affected. The crash needs a caller to pass a local-file dict, which is a documented input shape.

Fix

One line in each file: read the path from src itself and merge the served file info back into src before the existing assignment, which is what the code was written to do.

src = {**src, **self.serve_static_file(src["path"])}

I did not drop the branch and pass the raw dict through: a bare path is served via /gradio_api/file= only after serve_static_file has registered it, otherwise the frontend gets a 403 and shows a card that silently fails to open.

Verification

The repo has no tracked tests (the tests directory is git-ignored), so I verified with a local script against the real components under gradio 6.28:

• 8 checks: the two local-file dict cases fail with the AttributeError before the fix and produce a normal FileData with a /gradio_api/file=... url after it. The string, url-bearing dict and {path: None} cases are byte-identical before and after.
• The bundled docs/components/antdx/file_card/demos/basic.py builds with the same number of blocks before and after.

A changeset is included (patch for modelscope_studio).

---

This fix was developed with AI assistance (Claude); the change was reviewed and verified locally before submission.

[changeset-bot]

🦋 Changeset detected

Latest commit: b9cd330

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
modelscope_studio	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Col0ring]

@Linxiushen Thanks for this fix.