yugoo-design 0.2.3 → 0.2.6

package/payload/desktop-preparation/qwenwork-template/authoring/studio-creators/source/.agents/skills/design-bundle-creator/scripts/inspect-panel-component.mjs

@@ -19,7 +19,12 @@ async function inspectionContext(repo) {
   const contractPath = 'packages/core/src/panel-dsl.ts'
   const source = ts.createSourceFile(contractPath,
     await readFile(join(repo, contractPath), 'utf8'), ts.ScriptTarget.Latest, true, ts.ScriptKind.TS)
-  const declarations = new Map(source.statements
+  // These trusted local contract sources are parsed as data, never executed or
+  // resolved through arbitrary imports. PanelManifest imports its i18n shape.
+  const i18nPath = 'packages/core/src/panel-i18n.ts'
+  const i18nSource = ts.createSourceFile(i18nPath,
+    await readFile(join(repo, i18nPath), 'utf8'), ts.ScriptTarget.Latest, true, ts.ScriptKind.TS)
+  const declarations = new Map([...source.statements, ...i18nSource.statements]
     .filter(node => ts.isInterfaceDeclaration(node) || ts.isTypeAliasDeclaration(node))
     .map(node => [node.name.text, node]))
   const constants = new Map(source.statements
@@ -35,7 +40,7 @@ async function inspectionContext(repo) {
     function visit(node) {
       if (ts.isTypeQueryNode(node)) {
         if (!ts.isIdentifier(node.exprName)) {
-          throw new Error(`Unsupported local typeof contract reference: ${node.exprName.getText(source)}`)
+          throw new Error(`Unsupported local typeof contract reference: ${node.exprName.getText(node.getSourceFile())}`)
         }
         const name = node.exprName.text
         const constant = constants.get(name)
@@ -61,7 +66,7 @@ export async function inspectPanelComponent(repo, name, typeName, options = {})
 }
 
 async function inspectWithContext(context, name, typeName, options = {}) {
-  const { repo, ts, PANEL_COMPONENT_CATALOG, GENERATED_COMPONENT_KINDS, contractPath, source, declarations } = context
+  const { repo, ts, PANEL_COMPONENT_CATALOG, GENERATED_COMPONENT_KINDS, contractPath, declarations } = context
   if (!Object.hasOwn(PANEL_COMPONENT_CATALOG, name)) throw new Error(`Unknown component: ${name}`)
   function contract(name) {
     const [root, ...properties] = name.split('.')
@@ -88,8 +93,9 @@ async function inspectWithContext(context, name, typeName, options = {}) {
       ts.forEachChild(child, visit)
     }
     visit(node)
+    const source = node.getSourceFile()
     return {
-      name, file: contractPath,
+      name, file: source.fileName,
       line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1,
       declaration: node.getText(source),
       references: [...references].sort().map(name => ({ name, read: `--type ${name}` })),

package/payload/desktop-preparation/qwenwork-template/authoring/studio-creators/source/docs/dsl-spec.md

@@ -35,6 +35,34 @@ ui: {…}
 
 `evidence_workbook | capability_map | process | lifecycle | page_spec | document`
 
+### UI text and locale resources
+
+Declare the locale-to-file map at the manifest root, alongside `sections`,
+`fields` and `ui`. Paths are relative to this Bundle:
+
+```yaml
+i18n:
+  default_locale: zh-CN
+  locales:
+    zh-CN: locales/zh-CN.json
+    en-US: locales/en-US.json
+```
+
+For example, `ui.title: $t:workspaceTitle` reads `workspaceTitle` from these
+JSON objects: `locales/zh-CN.json` contains
+`{"workspaceTitle":"交付验收点"}`, and `locales/en-US.json` contains
+`{"workspaceTitle":"Delivery acceptance points"}`. The Kit loader reads the
+declared files and supplies the resolved `i18n.messages`; authors maintain the
+locale files rather than duplicating their messages in `panel.yaml`.
+
+Use whole `$t:key` tokens for display titles, labels, descriptions and other
+supported text properties. The default locale must cover every referenced key;
+missing keys in other locales fall back to it. Locale switching does not
+translate saved user text, IDs, field keys, enum values or canonical defaults.
+Shared component action copy stays in Panel's shared dictionaries. The owning
+type is `PanelTranslations` in `packages/core/src/panel-i18n.ts`; installed
+component contract reads expose it through `PanelManifest`'s returned reference.
+
 ## `sections`
 
 ```yaml

package/payload/desktop-preparation/qwenwork-template/authoring/studio-creators/source/docs/panel-uiux-standard.md

@@ -18,6 +18,7 @@
 `packages/panel/src/visual-components.css` 这一基础样式维护入口，不各自复制
 样式、追加覆盖文件或重新拼装常见操作。交互行为由组件实现，不能只靠 CSS 或
 文档约定保证一致。主题资源、宿主壳和专业图形资源不构成另一套 Kit 基础样式。
+独立预览入口须带齐组件所需的基础与画布样式，不能依赖宿主先加载；实际检查画布定位和控件图标，不能只核对节点存在。
 
 Bundle 作者决定业务信息的归属、关系、次序和合适的已支持形态，组件自动承担
 共同的视觉与交互默认值。信息组织是否帮助人理解和改写仍须审视，但作者无需
@@ -516,6 +517,8 @@ Studio 统一按用户需要采取的动作选择反馈形态，复用 `packages
 
 通知不遮挡输入框、保存/取消操作或键盘焦点，遵循 Studio 的边界和语义层级。普通状态更新使用非打断的可访问通告，重要失败按需告警；不得让逐条校验输出反复抢读。明暗主题、长错误、窄内容区和展开详情均须实际检查。`role="alert"` 只提供语义，不提供样式或正确的布局；仅添加类名或统一红色不能证明符合本规范。
 
+读取待保存修改失败时，现有保存错误对话框提供“重试读取”，重新准备原样草稿；恢复后仍由用户明确保存。不能要求用户改一个字、丢弃草稿或重开页面才能解除旧网络错误，也不能借重试自动重发写入或对话。已提交但结果未确认的保存仍沿用原有核对流程。
+
 Studio 与 Companion 的宿主会话复用同一消息和工作记录组件。展示实际公开回复、
 工具动作及其结果；工作记录可折叠，用户主动收起后轮询不重新展开。工作中使用
 同一圆形等待指示，停止操作放在输入框的发送按钮位置，不增加估算进度条。