a2ui-project / a2ui-project/a2ui

[FEATURE]: Add a public pure-Dart adapter for Flutter catalogs and functions

未关闭
#2,244 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
P2 status: first-line-handled status: needs-team-input type: feature/enhancement
主要语言
TypeScript
星标
16.4k
派生
1.3k
平均合并
2 天 13 小时
30 天内合并 PR
134

描述

- [x] I have searched the existing issues to make sure this feature has not already been requested.

## Is your feature request related to a problem? Please describe.

Flutter applications define catalogs/functions through Flutter GenUI APIs, while pure-Dart tooling uses a2ui_core types. No supported adapter proves which Flutter behavior is representable headlessly. Copying JSON Schema alone misses references, structural slots, bindings, validation, functions, and renderer fallbacks.

## Describe the Proposed Solution

Provide a public pure-Dart adaptation API that consumes serializable/public Flutter catalog definitions and produces a resolved a2ui_core catalog, explicit unsupported-schema or unresolved-$ref diagnostics, structural/dynamic/action metadata, a registry of caller-supplied pure deterministic function stubs, and a compatibility report distinguishing adapted, custom-driver-required, and unsupported components. Fail closed; do not serialize widget builders or arbitrary closures.

## Describe Alternatives Considered

Manual redeclaration drifts from the catalog shown to the agent. Flutter widget reflection is not portable. Treating schema conversion as behavior parity is unsafe.

## Additional Context

#1528 provides schema-driven binding/reference-resolution groundwork and #1282 provides relevant Node Layer work. This request focuses on the public Dart/Flutter adaptation boundary.

贡献指南

打开贡献指南

调研方向

Review issues #1528 and #1282 for groundwork on schema binding and Node Layer. Examine the Flutter GenUI APIs and a2ui_core types to understand the adaptation boundary. The goal is to create a public Dart API that converts Flutter catalog definitions into resolved a2ui_core catalogs with diagnostics and compatibility reports. Start by exploring existing serialization and reference-resolution code.

由索引模型根据 Issue 内容生成。

评估

技术栈
dart, flutter, typescript
领域
backend-api-design, tooling
Issue 类型
功能
难度
5/5
预计耗时
一周以上
活跃度
活跃
描述清晰度
基本清楚
新手友好度
35/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。