Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/a2ui-catalog.instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,6 @@ For the built-in `DateTimeInput`, keep date-enabled default output as `YYYY-MM-D

When changing A2UI README content under `packages/genui/a2ui` or `packages/genui/playground/examples`, keep the corresponding Chinese README in sync. Keep the `packages/genui/a2ui` entry READMEs focused on first-time developers, and move deeper package material into topic docs under `docs/` with matching Chinese versions. Keep the playground examples README self-contained unless a split is explicitly requested. The Chinese docs should preserve the same technical boundaries as the English docs: `@lynx-js/genui/a2ui` is the client renderer/store/catalog runtime, `genui a2ui` is build/setup tooling, and the Agent service plus transport adapter are owned by the embedding app.

When adding A2UI website README link rewrites in `website/sidebars/genui.ts`, put longer relative paths before shorter substrings such as `./src/catalog/README.md`, otherwise `../src/catalog/README.md` can become a broken `./guide/...` URL. Keep generated README links to the `/genui` playground as external `https://lynxjs.org/genui` Markdown links; the toolbar/nav item should point at `/genui`, but Rspress dead-link checking treats Markdown `/genui` links as docs pages.
When adding A2UI website README link rewrites in `website/sidebars/genui.ts`, put longer relative paths before shorter substrings such as `./src/catalog/README.md`, otherwise `../src/catalog/README.md` can become a broken `./guide/...` URL. Keep generated README links to the `/genui` playground as external `https://lynx-stack.dev/genui/` Markdown links; the toolbar/nav item should point at `/genui`, but Rspress dead-link checking treats Markdown `/genui` links as docs pages.

When embedding an MCP App inside A2UI on Lynx, use the built-in `McpApp` frame wrapper: select `webUrl` or `url` from `SystemInfo.platform`, pass `mcpAppData` through frame `data` (with `global-props` only as compatibility input), and render the nested host with its embedded layout. Lynx `frame` hosts another Lynx bundle; it is not an HTML iframe sandbox, so bundle URLs and data must come from a host-registered trusted MCP Apps resource rather than agent-generated input. Do not rely on Web block layout to make a frame fill its container: make the wrapper an explicit column Flex container with stretched children, set `align-self: stretch` for Flex parents and `linear-layout-gravity: stretch` for Lynx Linear parents, keep `min-width: 0` on both the wrapper and frame, and retain an explicit inline `width: 100%` on the frame. Enable `auto-width` and `auto-height` when the frame should follow the nested page's reported content size; these attributes do not replace the parent-width stretch constraint. Lynx template encoding does not support the `inset` box-shadow keyword; use a real border with border-box sizing and account for its content-box reduction (for example, a 288 px wrapper with 1 px borders provides 286 px to the frame).
2 changes: 1 addition & 1 deletion packages/genui/a2ui/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,4 +110,4 @@ generated UI actions through `onAction`.
- [Overview and architecture](./docs/overview.md)
- [Catalogs, built-ins, and custom components](./docs/catalog-guide.md)
- [System prompts](./docs/system-prompts.md)
- [Open the GenUI playground](https://lynxjs.org/genui)
- [Open the GenUI playground](https://lynx-stack.dev/genui/)
2 changes: 1 addition & 1 deletion packages/genui/a2ui/README_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,4 +100,4 @@ async function sendPrompt(input: string) {
- [概览与架构](./docs/overview_zh.md)
- [Catalogs、内置组件与自定义组件](./docs/catalog-guide_zh.md)
- [System Prompts](./docs/system-prompts_zh.md)
- [打开 GenUI Playground](https://lynxjs.org/genui)
- [打开 GenUI Playground](https://lynx-stack.dev/genui/)
2 changes: 1 addition & 1 deletion packages/genui/a2ui/docs/catalog-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -423,4 +423,4 @@ All of these are exported from `@lynx-js/genui/a2ui` (and from the
responsibility split, and the export map.
- [System prompts](./system-prompts.md) — generate the model instructions
that pair an Agent with your catalog.
- [Open the GenUI playground](https://lynxjs.org/genui) — try it live.
- [Open the GenUI playground](https://lynx-stack.dev/genui/) — try it live.
2 changes: 1 addition & 1 deletion packages/genui/a2ui/docs/catalog-guide_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -393,4 +393,4 @@ MyChart.displayName = 'MyChart';
- [概览与架构](./overview_zh.md)——一条 message 如何变成 UI、职责划分,以及
export 映射。
- [System Prompts](./system-prompts_zh.md)——生成让 Agent 与你的 catalog 配套的模型指令。
- [打开 GenUI playground](https://lynxjs.org/genui)——在线体验。
- [打开 GenUI playground](https://lynx-stack.dev/genui/)——在线体验。
2 changes: 1 addition & 1 deletion packages/genui/a2ui/docs/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -330,4 +330,4 @@ Lifecycle notes that save debugging time:
the contract, add manifests, and register your own components.
- [System prompts](./system-prompts.md) — generate the model instructions
that pair an Agent with your catalog.
- [Open the GenUI playground](https://lynxjs.org/genui) — try it live.
- [Open the GenUI playground](https://lynx-stack.dev/genui/) — try it live.
2 changes: 1 addition & 1 deletion packages/genui/a2ui/docs/overview_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -286,4 +286,4 @@ MessageStore ──subscribe──► <A2UI> ──► MessageProcessor ──
- [Catalogs、内置组件与自定义组件](./catalog-guide_zh.md)——组合 contract、加入
manifest、注册你自己的组件。
- [System Prompts](./system-prompts_zh.md)——生成让 Agent 与你的 catalog 配套的模型指令。
- [打开 GenUI playground](https://lynxjs.org/genui)——在线体验。
- [打开 GenUI playground](https://lynx-stack.dev/genui/)——在线体验。