Skip to content

抽象现有高亮与提示机制,统一供内部和外部建模工具使用 #178

Description

@vilicvane

将现有的高亮与辅助提示机制抽象出来,供内置工具、Layout 等模型库以及外部自定义建模函数共同使用。内部实现也应迁移为这套抽象的消费者,让同一种高亮能力拥有统一的描述、上下文解析和渲染路径。

现有参数高亮、模型/几何元素高亮、bounds、尺寸及关系提示已经提供了实际使用场景。以这些实现为基础提炼共用能力,使函数能够表达此次调用需要突出哪些参与者、元素或边界,以及它们与源码焦点的对应关系。

需求已明确:

  • 提炼现有机制的共同职责与扩展边界,内部和外部实现使用同一套能力。
  • 同步迁移受影响的内置高亮实现,移除被统一抽象替代的专用分支和重复路径。
  • 外部建模库能够通过稳定、清晰的入口接入,不需要向 App 添加按函数名称判断的专用逻辑。
  • 保留具体调用/参数的源码上下文、运行实例及坐标归属,涵盖循环、多次调用、嵌套组合、编辑重新求值和撤销。
  • 保留模型值语义,并沿用既有焦点、高亮主次、辅助标记及渲染约定。

Layout(#176)是这套能力的一个消费场景:pack(model, space, config)distribute(models, space, config) 可以表达目标空间、padding 后的有效区间、相关 bounds,以及 gap、轴向等提示。应同时用代表性的已有内置高亮与外部模型函数验证抽象是否成立。

JSDoc、运行时元数据或二者结合只是可能的接入方式;具体接口、元数据表达、公开入口及代码归属需要结合现有实现设计。本 issue 当前记录需求,尚未开始实现。

相关工作:

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions