openyida 2026.9.21 → 2026.9.22-beta.2

package/lib/design-plan/artifact-updates.js

@@ -1,117 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { CliError } = require('../core/cli-error');
-const { t } = require('../core/i18n');
-const { readJson } = require('./files');
-
-const STATE_FILE = '.build-plan-artifacts.json';
-const DOCUMENTS = new Set(['prd.md', 'design.md', 'build-plan.html']);
-
-function conflict(file, section) {
-  throw new CliError(t('design_document.update_conflict', file, section), {
-    code: 'DESIGN_PLAN_UPDATE_CONFLICT', details: { file, section },
-  });
-}
-
-// Fixed chapter numbers and HTML section IDs survive changes to display titles.
-function blocks(content, html) {
-  const starts = [{ key: 'header', index: 0 }];
-  if (html) {
-    for (const match of content.matchAll(/<section id="(overview|data-models|business-flows|pages)" class="page-section">/g)) {
-      starts.push({ key: match[1], index: match.index });
-    }
-    const end = content.lastIndexOf('</article>');
-    if (end >= 0) {starts.push({ key: 'footer', index: end });}
-  } else {
-    const frontmatter = /^---\r?\n[\s\S]*?\r?\n---\r?\n/.exec(content);
-    if (frontmatter) {starts.push({ key: 'intro', index: frontmatter[0].length });}
-    let offset = 0, fence = null;
-    for (const line of content.split(/(?<=\n)/)) {
-      const marker = /^\s{0,3}(`{3,}|~{3,})/.exec(line);
-      if (marker) {
-        if (!fence) {fence = marker[1];}
-        else if (marker[1][0] === fence[0] && marker[1].length >= fence.length) {fence = null;}
-      } else if (!fence) {
-        const heading = /^## (\d+)\. /.exec(line);
-        if (heading) {starts.push({ key: `chapter-${heading[1]}`, index: offset });}
-      }
-      offset += line.length;
-    }
-  }
-  return starts.map((entry, index) => ({ ...entry, end: starts[index + 1]?.index ?? content.length,
-    text: content.slice(entry.index, starts[index + 1]?.index) }));
-}
-
-function updateBlock(before, after, current, file, key) {
-  if (current === before || current === after) {return after;}
-  const oldLines = before.split(/(?<=\n)/), newLines = after.split(/(?<=\n)/);
-  let start = 0, end = oldLines.length, nextEnd = newLines.length;
-  while (start < end && start < nextEnd && oldLines[start] === newLines[start]) {start++;}
-  while (end > start && nextEnd > start && oldLines[end - 1] === newLines[nextEnd - 1]) {end--; nextEnd--;}
-  const contextStart = Math.max(0, start - 3);
-  const contextEnd = Math.min(oldLines.length, end + 3);
-  const needle = oldLines.slice(contextStart, contextEnd).join('');
-  const replacement = [...oldLines.slice(contextStart, start), ...newLines.slice(start, nextEnd), ...oldLines.slice(end, contextEnd)].join('');
-  const position = current.indexOf(needle);
-  if (!needle || position < 0 || current.indexOf(needle, position + 1) >= 0) {conflict(file, key);}
-  return current.slice(0, position) + replacement + current.slice(position + needle.length);
-}
-
-function mergeDocument(before, after, current, file) {
-  if (before === after || current === after) {return current;}
-  if (current === before) {return after;}
-  const html = file.endsWith('.html');
-  const oldBlocks = blocks(before, html), newBlocks = blocks(after, html), currentBlocks = blocks(current, html);
-  for (const list of [oldBlocks, newBlocks, currentBlocks]) {
-    if (new Set(list.map(block => block.key)).size !== list.length) {conflict(file, 'structure');}
-  }
-  if (oldBlocks.map(block => block.key).join() !== newBlocks.map(block => block.key).join()) {conflict(file, 'structure');}
-  const edits = [];
-  for (let index = 0; index < oldBlocks.length; index++) {
-    const beforeBlock = oldBlocks[index], afterBlock = newBlocks[index];
-    if (beforeBlock.text === afterBlock.text) {continue;}
-    const currentBlock = currentBlocks.find(block => block.key === beforeBlock.key);
-    if (!currentBlock) {conflict(file, beforeBlock.key);}
-    edits.push({ ...currentBlock, text: updateBlock(beforeBlock.text, afterBlock.text, currentBlock.text, file, beforeBlock.key) });
-  }
-  let result = current;
-  for (const edit of edits.sort((a, b) => b.index - a.index)) {
-    result = result.slice(0, edit.index) + edit.text + result.slice(edit.end);
-  }
-  return result;
-}
-
-// Keep the last generated text separate from local edits, so later source changes
-// can update their own sections without treating local notes as generated content.
-function prepareUpdates(artifacts, outputDir, previousArtifacts) {
-  const statePath = path.join(outputDir, STATE_FILE);
-  let baseline = {};
-  if (fs.existsSync(statePath)) {
-    const state = readJson(statePath, STATE_FILE);
-    if (state.version !== 1 || !state.documents || typeof state.documents !== 'object') {conflict(statePath, 'baseline');}
-    baseline = state.documents;
-  } else if (previousArtifacts && artifacts.files.some(([file]) => DOCUMENTS.has(path.basename(file)) && fs.existsSync(file))) {
-    baseline = Object.fromEntries(previousArtifacts().files.filter(([file]) => DOCUMENTS.has(path.basename(file))).map(([file, content]) => [path.basename(file), content]));
-  }
-  const documents = {}, files = [], updated = [];
-  for (const [file, generated] of artifacts.files) {
-    const name = path.basename(file);
-    const current = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : undefined;
-    let content = generated;
-    if (DOCUMENTS.has(name)) {
-      documents[name] = generated;
-      if (current !== undefined && current !== generated) {
-        if (typeof baseline[name] !== 'string') {conflict(file, 'baseline');}
-        content = mergeDocument(baseline[name], generated, current, file);
-      }
-    }
-    if (content !== current) {files.push([file, content]); updated.push(file);}
-  }
-  const state = JSON.stringify({ version: 1, documents }, null, 2) + '\n';
-  if (!fs.existsSync(statePath) || fs.readFileSync(statePath, 'utf8') !== state) {files.push([statePath, state]);}
-  return { files, updated, previousDesign: baseline['design.md'] };
-}
-
-module.exports = { prepareUpdates, mergeDocument };

package/lib/design-plan/confirmation.js

@@ -1,13 +0,0 @@
-'use strict';
-
-function confirmationPayload(outputs, revision) {
-  return {
-    question: '请确认当前搭建方案',
-    options: [{ label: '确认并开始搭建', value: 'confirm_build' }, { label: '继续调整', value: 'continue_editing' }],
-    submitLabel: '提交选择',
-    attachments: [{ name: '搭建方案.html', path: outputs.html }],
-    revision,
-  };
-}
-
-module.exports = { confirmationPayload };

package/lib/design-plan/entry-navigation.js

@@ -1,97 +0,0 @@
-'use strict';
-
-const { CliError } = require('../core/cli-error');
-const { t } = require('../core/i18n');
-const ENTRY_MODES = Object.freeze(['unified', 'service-management', 'frontend-only', 'backend-only']);
-const ENTRY_MODE_SUMMARIES = Object.freeze({
-  unified: '不分前后台：使用同一套业务页面，按职责显示菜单、数据和操作。',
-  'service-management': '分前后台：办事的人使用前台，处理业务的人使用后台，两边共享业务数据。',
-  'frontend-only': '只有访问前台：本次提供办理、查询或展示页面；需要处理的业务由已有系统、人员入口或自动流程承接。',
-  'backend-only': '只有访问后台：工作人员录入、受理、处理或维护业务，办事入口在别处或本次不需要。',
-});
-const filled = value => typeof value === 'string' && value.trim().length > 0;
-const object = value => value && typeof value === 'object' && !Array.isArray(value);
-const assert = (condition, message, details) => {
-  if (!condition) {throw new CliError(message, { code: 'DESIGN_PLAN_INVALID_ENTRY_NAVIGATION', ...(details ? { details } : {}) });}
-};
-
-// Resource names are planning references. Runtime IDs and permissions are resolved after creation.
-function buildEntryNavigation(plan, resources, pages) {
-  const recommendation = plan.execution?.entryRecommendation;
-  if (recommendation === undefined) {return null;}
-  assert(object(recommendation) && ENTRY_MODES.includes(recommendation.mode), t('cli.design_plan_entry_mode_required'));
-  assert(Array.isArray(recommendation.entries) && recommendation.entries.length > 0, '入口方案缺少 entries');
-  const names = new Set(resources.map(resource => resource.name));
-  const entryKeys = new Set();
-  const platformOrder = [];
-  for (const entry of recommendation.entries) {
-    assert(object(entry) && filled(entry.key) && !entryKeys.has(entry.key) && filled(entry.name), '入口 key/name 缺失或重复');
-    entryKeys.add(entry.key);
-    assert(['service', 'management', 'workspace'].includes(entry.role), `入口 ${entry.name} 需要明确业务身份`);
-    const page = filled(entry.sceneKey) ? pages.find(item => item.sceneKey === entry.sceneKey) : undefined;
-    assert(entry.sceneKey === undefined || page, `入口 ${entry.name} 引用了未知 sceneKey`);
-    assert(entry.sceneKey === undefined || pages.filter(item => item.sceneKey === entry.sceneKey).length === 1, `入口 ${entry.name} 的 sceneKey 必须唯一关联页面`);
-    if (entry.role === 'service') {
-      assert(page?.pageSpecHandoff.entryMode === 'standalone', `访客入口 ${entry.name} 必须关联独立页面`);
-    }
-    assert(Array.isArray(entry.menu) && entry.menu.length > 0, `入口 ${entry.name} 缺少任务菜单，单步入口也需记录唯一任务`);
-    const keys = new Set();
-    const leaves = [];
-    const visit = items => {
-      for (const item of items) {
-        assert(object(item) && filled(item.key) && !keys.has(item.key) && filled(item.label), `入口 ${entry.name} 的菜单 key/label 缺失或重复`);
-        keys.add(item.key);
-        if (item.children !== undefined) {
-          assert(Array.isArray(item.children) && item.children.length > 0, `菜单 ${item.label} 的分组为空`);
-          visit(item.children);
-          continue;
-        }
-        assert(names.has(item.resource), `菜单 ${item.label} 引用了未知资源`);
-        assert(['local', 'submission', 'page', 'custom'].includes(item.targetType), `菜单 ${item.label} 缺少入口用途`);
-        if (item.targetType === 'submission') {
-          assert(resources.some(resource => resource.name === item.resource && ['normal-form', 'process-form'].includes(resource.type)), `菜单 ${item.label} 的提交目标必须是表单`);
-        }
-        assert(item.viewUuid === undefined || (filled(item.viewUuid) && item.targetType === 'page'), `菜单 ${item.label} 的 viewUuid 仅用于真实管理视图`);
-        const targetPage = pages.find(candidate => candidate.name === item.resource);
-        if (item.targetType === 'local') {
-          const missingFields = [!filled(entry.sceneKey) && 'entry.sceneKey',
-            (page && item.resource !== page.name) && 'menu.resource', !filled(item.viewKey) && 'menu.viewKey'].filter(Boolean);
-          assert(filled(entry.sceneKey) && page && item.resource === page.name && filled(item.viewKey),
-            t('cli.design_plan_local_menu_binding', item.label, entry.name),
-            { entryKey: entry.key, menuKey: item.key, sceneKey: entry.sceneKey || null,
-              pageName: page?.name || null, resource: item.resource, missingFields });
-        }
-        if (item.targetType === 'custom') {
-          assert(targetPage?.pageSpecHandoff.entryMode === 'standalone', `菜单 ${item.label} 的 custom 目标必须为独立页面`);
-        }
-        if (item.targetType === 'page') {
-          assert(targetPage?.pageSpecHandoff.entryMode !== 'standalone', `菜单 ${item.label} 应使用 custom 路径打开独立页面，避免双导航`);
-        }
-        assert(Array.isArray(item.access) && item.access.length > 0, `菜单 ${item.label} 缺少权限依赖`);
-        for (const requirement of item.access) {
-          assert(object(requirement) && names.has(requirement.resource) && filled(requirement.operation)
-            && filled(requirement.dataScope), `菜单 ${item.label} 需填写权限资源、操作和数据范围`);
-          assert(requirement.viewUuid === undefined || filled(requirement.viewUuid), `菜单 ${item.label} 的权限视图无效`);
-        }
-        const operation = item.targetType === 'submission' ? 'OPERATE_CREATE' : 'OPERATE_VIEW';
-        assert(item.access.some(requirement => requirement.resource === item.resource && requirement.operation === operation
-          && (requirement.viewUuid || '') === (item.viewUuid || '')), `菜单 ${item.label} 缺少目标用途对应的 ${operation} 权限`);
-        leaves.push(item);
-      }
-    };
-    visit(entry.menu);
-    assert(leaves.some(item => item.key === entry.defaultMenuKey), `入口 ${entry.name} 的默认菜单必须指向有效任务`);
-    if (entry.role !== 'service') {
-      const first = leaves.find(item => item.key === entry.defaultMenuKey);
-      assert(first.targetType !== 'custom', `管理入口 ${entry.name} 不能默认跳到独立前台`);
-      platformOrder.push(first.resource, ...leaves.filter(item => item.targetType !== 'custom').map(item => item.resource));
-    }
-  }
-  const roles = recommendation.entries.map(entry => entry.role);
-  assert(recommendation.mode !== 'service-management' || (roles.includes('service') && roles.includes('management')), '前后台方案必须同时包含访客端和业务管理端');
-  assert(recommendation.mode !== 'frontend-only' || roles.every(role => role === 'service'), '仅前台方案不能包含管理入口');
-  assert(recommendation.mode !== 'backend-only' || roles.every(role => role === 'management'), t('cli.design_plan_backend_only_roles'));
-  return { recommendation: JSON.parse(JSON.stringify(recommendation)), platformOrder: [...new Set(platformOrder)] };
-}
-
-module.exports = { buildEntryNavigation, ENTRY_MODES, ENTRY_MODE_SUMMARIES };

package/lib/design-plan/navigation-policy.js

@@ -1,38 +0,0 @@
-'use strict';
-
-// Shared by the materialized page handoff and CLI manifest. This is an output
-// contract, not a new authoring field or a claim about the live platform config.
-function getPageNavigationContract() {
-  return {
-    output_path: 'pages[].navigationPolicy in the PRD execution handoff',
-    input_policy: 'Derived from app navigation and pageSpecHandoff; do not write navigationPolicy into build-plan.json or page-spec.json.',
-    platform_shell: {
-      applicationMenuOwner: 'platform', pageLayout: 'content-only',
-      renderApplicationMenu: false, localTabs: 'same-task-only', duplicatePlatformMenu: false,
-    },
-    page_owned: {
-      applicationMenuOwner: 'page', pageLayout: 'standalone',
-      renderApplicationMenu: true, localTabs: 'planned-views', duplicatePlatformMenu: false,
-    },
-    no_menu: {
-      applicationMenuOwner: 'none', pageLayout: 'standalone',
-      renderApplicationMenu: false, localTabs: 'same-task-only', duplicatePlatformMenu: false,
-    },
-    selection: 'platform-shell uses platform_shell; standalone uses page_owned only for explicit custom page menus or application custom navigation. Explicit none and standalone without a planned menu use no_menu.',
-    discussion: {
-      plan: 'Include frontend and workspace navigation in the overall plan discussion and confirmation; material changes follow the existing revision confirmation workflow.',
-      fast: 'Explain and use the recorded decision; no additional navigation approval gate.',
-      existing: 'Preserve explicit user requirements and existing navigation for local changes; page Tabs or state preservation alone do not authorize replacing platform navigation.',
-    },
-  };
-}
-
-function buildPageNavigationPolicy(spec, applicationNavigationType) {
-  const contract = getPageNavigationContract();
-  if (spec.entryMode === 'platform-shell') { return contract.platform_shell; }
-  if (spec.navigation?.type === 'none') { return contract.no_menu; }
-  return spec.navigation?.type === 'custom' || applicationNavigationType === 'custom'
-    ? contract.page_owned : contract.no_menu;
-}
-
-module.exports = { getPageNavigationContract, buildPageNavigationPolicy };

package/lib/design-plan/rebase.js

@@ -1,60 +0,0 @@
-'use strict';
-
-const path = require('path');
-const fs = require('fs');
-const { CliError } = require('../core/cli-error');
-const { readJson } = require('./files');
-const { t } = require('../core/i18n');
-
-const BASE_FILE = '.build-plan-base.json';
-const equal = (a, b) => JSON.stringify(a) === JSON.stringify(b);
-const object = value => value && typeof value === 'object' && !Array.isArray(value);
-
-// Arrays represent ordered business facts; conflicting edits require a decision.
-function reconcile(base, current, proposed, field, conflicts) {
-  if (equal(current, proposed) || equal(proposed, base)) { return current; }
-  if (equal(current, base)) { return proposed; }
-  if (object(base) && object(current) && object(proposed)) {
-    const result = {};
-    for (const key of new Set([...Object.keys(base), ...Object.keys(current), ...Object.keys(proposed)])) {
-      const value = reconcile(base[key], current[key], proposed[key], field ? `${field}.${key}` : key, conflicts);
-      if (value !== undefined) { result[key] = value; }
-    }
-    return result;
-  }
-  conflicts.push(field);
-  return proposed;
-}
-
-function rebaseParts(source, input, businessFile, visualFile) {
-  const { planBase } = require('./parallel');
-  const baselinePath = path.join(path.dirname(path.resolve(input)), BASE_FILE);
-  const fail = (code, details) => { throw new CliError(t('design_plan.rebase_required'), { code, details: { baselinePath, ...details } }); };
-  if (!fs.existsSync(baselinePath)) { fail('DESIGN_PLAN_BASELINE_MISSING', { nextStep: t('design_plan.baseline_missing') }); }
-  const saved = readJson(baselinePath);
-  if (saved.schemaVersion !== 1 || !object(saved.plan) || !equal(saved.base, planBase(saved.plan))) {
-    fail('DESIGN_PLAN_BASELINE_INVALID', { nextStep: t('design_plan.baseline_missing') });
-  }
-  if (source.meta?.status !== 'draft' || source.meta?.planState?.presentedRevision
-      || source.meta?.planState?.planConfirmed || !equal(source.meta, saved.plan.meta)) {
-    fail('DESIGN_PLAN_REBASE_STAGE_INVALID', { nextStep: t('design_plan.rebase_stage_invalid') });
-  }
-  const parts = [businessFile, visualFile].map(file => readJson(file));
-  for (const [index, part] of parts.entries()) {
-    if (!equal(part.base, saved.base) || !object(part.facts)) {
-      fail('DESIGN_PLAN_BASELINE_MISMATCH', { sourcePath: [businessFile, visualFile][index], nextStep: t('design_plan.baseline_missing') });
-    }
-  }
-  return parts.map((part, index) => {
-    const conflicts = [];
-    const facts = Object.fromEntries(Object.keys(part.facts).map(key => [key,
-      reconcile(saved.plan[key], source[key], part.facts[key], key, conflicts),
-    ]));
-    if (conflicts.length) {
-      fail('DESIGN_PLAN_REBASE_CONFLICT', { sourcePath: [businessFile, visualFile][index], conflicts, nextStep: t('design_plan.rebase_conflict') });
-    }
-    return { ...part, facts, base: planBase(source) };
-  });
-}
-
-module.exports = { BASE_FILE, rebaseParts };

package/lib/design-plan/themes.js

@@ -1,101 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { CliError } = require('../core/cli-error');
-const { readJson } = require('./files');
-const { parseDesignDocument } = require('../design/document');
-
-const DESIGN_SKILL_ROOT = path.resolve(__dirname, '../../yida-skills/skills/yida-design');
-const PLAN_SKILL_ROOT = path.join(DESIGN_SKILL_ROOT, 'sub_skill/yida-design-plan');
-const THEME_DIR = path.join(DESIGN_SKILL_ROOT, 'templates/design-themes');
-
-function loadThemeIndex() {
-  return readJson(path.join(THEME_DIR, 'index.json'), '主题索引');
-}
-
-function themeTemplatePath(theme) {
-  const file = path.resolve(DESIGN_SKILL_ROOT, theme.templatePath);
-  if (!file.startsWith(`${THEME_DIR}${path.sep}`) || !fs.existsSync(file)) {
-    throw new CliError(`主题模板不可读：${theme.templatePath}`, { code: 'DESIGN_PLAN_THEME_UNREADABLE' });
-  }
-  return file;
-}
-
-function themeNavTheme(theme) {
-  if (theme.mode === 'creative') {return undefined;}
-  const file = themeTemplatePath(theme);
-  const metadata = parseDesignDocument(fs.readFileSync(file, 'utf8')).metadata;
-  const navTheme = metadata.themeProfile?.navTheme || metadata.navTheme;
-  if (!['light', 'dark'].includes(navTheme)) {
-    throw new CliError(`主题模板 navTheme 无效：${theme.themeId}`, {
-      code: 'DESIGN_PLAN_THEME_NAV_THEME_INVALID',
-      details: { themeId: theme.themeId, navTheme: metadata.navTheme, templatePath: theme.templatePath },
-    });
-  }
-  return navTheme;
-}
-
-// Color recipes live with the visual theme. Resolve their token dependencies rather
-// than duplicating per-theme palettes in JavaScript.
-function resolveThemeColors(source) {
-  const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(source);
-  const tokenSource = frontmatter ? frontmatter[1] : source;
-  const definitions = new Map([...tokenSource.matchAll(/^\s*"(--[\w-]+)":\s*"([^"\n]*)"/gm)]
-    .map(([, name, value]) => [name, value]));
-  const resolved = new Map();
-  const resolving = new Set();
-  const invalid = value => { throw new CliError(`主题色值无法生成：${value}`, { code: 'DESIGN_PLAN_THEME_COLOR_INVALID' }); };
-  function color(value) {
-    if (value.startsWith('--')) {return resolve(value);}
-    if (/^#[\da-f]{6}$/i.test(value)) {return value.toUpperCase();}
-    const alias = /^var\((--[\w-]+)(?:,\s*[^)]+)?\)$/.exec(value);
-    if (alias) {return resolve(alias[1]);}
-    return invalid(value);
-  }
-  function channels(value) {
-    const hex = color(value);
-    if (!/^#[\da-f]{6}$/i.test(hex)) {return invalid(value);}
-    return [1, 3, 5].map(index => parseInt(hex.slice(index, index + 2), 16));
-  }
-  function resolve(name) {
-    if (resolved.has(name)) {return resolved.get(name);}
-    if (resolving.has(name) || !definitions.has(name)) {return invalid(name);}
-    resolving.add(name);
-    const raw = definitions.get(name);
-    let result = raw;
-    if (raw.startsWith('<生成实际色值：')) {
-      const mix = /^<生成实际色值：(--[\w-]+|#[\da-f]{6}) (\d+(?:\.\d+)?)% \+ (--[\w-]+|#[\da-f]{6}) (\d+(?:\.\d+)?)%，sRGB 逐通道混合>$/i.exec(raw);
-      const alpha = /^<生成实际色值：取 (--[\w-]+) 的 sRGB 三通道，alpha 设为 (0(?:\.\d+)?|1(?:\.0+)?)，输出 rgba>$/.exec(raw);
-      if (mix) {
-        const [, left, leftPercent, right, rightPercent] = mix;
-        if (Math.abs(Number(leftPercent) + Number(rightPercent) - 100) > 0.001) {return invalid(raw);}
-        const a = channels(left);
-        const b = channels(right);
-        result = `#${a.map((channel, index) => Math.round((channel * Number(leftPercent) + b[index] * Number(rightPercent)) / 100)
-          .toString(16).padStart(2, '0')).join('').toUpperCase()}`;
-      } else if (alpha) {
-        result = `rgba(${channels(alpha[1]).join(', ')}, ${alpha[2]})`;
-      } else {return invalid(raw);}
-    } else if (raw.startsWith('var(')) {
-      result = color(raw);
-    }
-    resolving.delete(name);
-    resolved.set(name, result);
-    return result;
-  }
-  const output = tokenSource.replace(/^(\s*"(--[\w-]+)":\s*)"(<生成实际色值：[^"\n]*>)"/gm,
-    (line, prefix, name) => `${prefix}"${resolve(name)}"`);
-  return frontmatter ? frontmatter[0].replace(frontmatter[1], () => output) + source.slice(frontmatter[0].length) : output;
-}
-
-function resolveColorToken(tokens, name, seen = new Set()) {
-  if (seen.has(name)) {return null;}
-  seen.add(name);
-  const value = tokens[name];
-  if (/^#[\da-f]{6}$/i.test(value || '')) {return value.toUpperCase();}
-  const alias = /^var\((--[\w-]+)(?:,\s*([^)]+))?\)$/.exec(value || '');
-  return alias ? resolveColorToken(tokens, alias[1], seen) || alias[2] || null : null;
-}
-
-module.exports = { DESIGN_SKILL_ROOT, PLAN_SKILL_ROOT, loadThemeIndex, themeTemplatePath, themeNavTheme, resolveThemeColors, resolveColorToken };

package/lib/design-plan/visual-policy.js

@@ -1,42 +0,0 @@
-'use strict';
-
-function getVisualDecisionPolicy() {
-  return {
-    reference: 'yida-skills/skills/yida-design/references/theme-selection.md#设计方向比较',
-    preserve: 'explicit_user_direction_brand_and_existing_app_theme',
-    applicationStyle: {
-      scope: ['navigation', 'application_shell', 'native_form', 'custom_page', 'record_detail'],
-      navigationTokens: 'tokens.application-global.appearance.navigation',
-      navigationRoles: ['surface', 'text', 'hover', 'selected', 'disabled', 'logo', 'group', 'search', 'popup', 'action', 'border', 'radius', 'shadow', 'density'],
-      navigationShape: {
-        reference: 'yida-skills/skills/yida-design/references/application-theme-consistency.md#导航形状与密度的案例经验',
-        inputs: ['radius', 'normal_hover_selected_borders', 'selected_shadow', 'item_height', 'padding', 'gap', 'shell_spacing'],
-        authoring: { fast: 'design.md tokens.application-global.appearance.navigation', plan: 'visualStyle.tokens' },
-        layout: 'preserve_business_navigation_type_independently_of_theme_appearance',
-        verification: ['native_data_management', 'custom_page', 'submission', 'record_detail', 'long_labels', 'collapsed_navigation'],
-      },
-      delivery: 'one_design_document_and_application_theme_css',
-      verification: 'read_back_app_settings_and_verify_rendered_navigation_form_custom_page_and_detail',
-    },
-    nativeFormLayout: {
-      model: 'component_based_native_form_layout',
-      regions: ['top', 'left', 'main', 'right', 'between_fields'],
-      components: ['tabs', 'button_groups', 'images', 'graphics', 'status_blocks', 'dividers', 'columns', 'fields'],
-      roles: ['navigation', 'action', 'visual_focus', 'feedback', 'hierarchy', 'rhythm', 'decoration', 'data_capture'],
-      rules: ['place_components_by_role', 'preserve_existing_component_tree', 'use_divider_for_business_groups'],
-      forbidden: ['generic_filler_copy', 'random_layout_rotation'],
-    },
-    creativeOption: { alwaysAvailable: true, themeId: 'free-creative', selectionRequired: false,
-      source: 'independent_business_reasoning_not_preset_matching',
-      authoringReference: 'yida-skills/skills/yida-design/references/application-style-library.md' },
-    comparison: { candidateCount: 3, baseline: 'first_instinct', alternatives: 2, distinctDimensions: 2,
-      dimensions: ['composition', 'typography', 'surface_hierarchy', 'color_relationships', 'navigation_shape_and_density'] },
-    selection: 'refine_and_choose_a_supported_alternative_within_business_constraints',
-    quality: ['task_efficiency', 'readability_and_contrast', 'consistent_spacing_and_alignment', 'coherent_visual_identity'],
-    execution: 'one_shared_three_direction_generation_pass_for_fast_and_plan',
-    handoff: ['visualSelection.visualDirection.description', 'visualSelection.colorStrategy.usage'],
-    presentation: 'fast_selects_internally; plan_asks_user_when_no_explicit_visual_direction',
-  };
-}
-
-module.exports = { getVisualDecisionPolicy };

package/lib/samples/openyida-scaffold/canvas-admin-entry.jsx

@@ -1,62 +0,0 @@
-import React from 'react';
-import { Button } from 'antd';
-
-// Page-scoped server context, not CLI credentials or a copied administrator list.
-// The platform's app-admin scope includes super/app managers, not only MAIN.
-function readCanvasAppAdmin(appType) {
-  try {
-    // Access pages may expose appType on pageConfig rather than g_config.
-    // Any explicit conflicting context remains unknown; never borrow parent roles.
-    const appContexts = [window.g_config?.appType, window.pageConfig?.appType]
-      .filter(value => value !== undefined && value !== null && value !== '');
-    const user = window.loginUser;
-    if (!/^APP_[A-Za-z0-9_-]+$/.test(appType || '') || !appContexts.length || appContexts.some(value => value !== appType)
-      || typeof user?.userId !== 'string' || !user.userId.trim()) return { appType, status: 'unknown' };
-    const flag = user.isAppAdmin;
-    const status = flag === 'y' || flag === true ? 'allowed' : flag === 'n' || flag === false ? 'denied' : 'unknown';
-    return { appType, status };
-  } catch (_error) { return { appType, status: 'unknown' }; }
-}
-
-function useCanvasAppAdmin(appType) {
-  const [access, setAccess] = React.useState({ appType, status: 'unknown' });
-  React.useEffect(() => {
-    const refresh = () => setAccess(readCanvasAppAdmin(appType));
-    refresh();
-    window.addEventListener('focus', refresh);
-    window.addEventListener('pageshow', refresh);
-    document.addEventListener('visibilitychange', refresh);
-    return () => {
-      window.removeEventListener('focus', refresh);
-      window.removeEventListener('pageshow', refresh);
-      document.removeEventListener('visibilitychange', refresh);
-    };
-  }, [appType]);
-  return access.appType === appType ? access.status : 'unknown';
-}
-
-function buildCanvasWorkbenchEntry({ appType, workbenchFormUuid, viewUuid, params = {}, useDefaultWorkbench = false }) {
-  if (!appType || (!workbenchFormUuid && !useDefaultWorkbench)) return null;
-  if (workbenchFormUuid && [window.g_config?.formUuid, window.pageConfig?.formUuid].includes(workbenchFormUuid)) return null;
-  const query = { ...params };
-  // Do not carry the visitor page's navigation hiding/embedding settings back.
-  for (const key of ['isRenderNav', 'iframe', 'hideLeftNav', 'navConfig.layout']) delete query[key];
-  if (viewUuid && workbenchFormUuid) query.viewUuid = viewUuid;
-  return { targetType: workbenchFormUuid ? 'page' : 'app', appType, formUuid: workbenchFormUuid, params: query };
-}
-
-/** Render under CanvasThemeProvider; extract canvas-admin-entry as one fragment. */
-function CanvasAdminWorkbenchButton({ appType, workbenchFormUuid, viewUuid, params, useDefaultWorkbench = false, label = '业务工作台' }) {
-  const status = useCanvasAppAdmin(appType);
-  if (status !== 'allowed') return null;
-  const entry = buildCanvasWorkbenchEntry({ appType, workbenchFormUuid, viewUuid, params, useDefaultWorkbench });
-  if (!entry) return null;
-  let href;
-  try { href = buildCanvasPageUrl(entry, { appType }); } catch (_error) { return null; }
-  return <Button href={href} style={{ color: 'var(--color-text1-4, inherit)' }} onClick={event => {
-    if (readCanvasAppAdmin(appType).status !== 'allowed') { event.preventDefault(); return; }
-    if (event.button !== 0 || event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;
-    event.preventDefault();
-    navigateCanvasPage(entry, { appType });
-  }}>{label}</Button>;
-}

package/lib/samples/openyida-scaffold/canvas-navigation.jsx

@@ -1,56 +0,0 @@
-// Merge this fragment into the Canvas page. Supply IDs from resource readback.
-// Local tabs use state/hash and do not call this cross-page helper.
-function buildCanvasPageUrl(entry, { appType, platformOrigin } = {}) {
-  const type = entry.targetType;
-  if (type === 'url') {
-    const external = new URL(entry.url);
-    if (!['https:', 'http:'].includes(external.protocol)) throw new Error('Expected an HTTP(S) URL');
-    return external.href;
-  }
-  const app = entry.appType || appType;
-  if (!/^APP_[A-Za-z0-9_-]+$/.test(app || '')) throw new Error('Missing verified appType');
-  const routes = { app: 'workbench', page: 'workbench', custom: 'custom', submission: 'submission', detail: 'formDetail' };
-  if (!Object.prototype.hasOwnProperty.call(routes, type)) throw new Error('Unknown page target type');
-  const id = type === 'page' ? entry.navUuid || entry.formUuid : entry.formUuid;
-  if (type !== 'app' && !/^[A-Za-z0-9_-]+$/.test(id || '')) throw new Error('Missing verified page ID');
-  // Normal pages use their own origin. Opaque or non-platform embeddings must
-  // supply the verified platform origin; never guess a tenant or read window.top.
-  const origin = new URL(platformOrigin || window.location.origin);
-  if (!['https:', 'http:'].includes(origin.protocol) || origin.username || origin.password) throw new Error('Invalid platform origin');
-  const url = new URL('/' + app + '/' + routes[type] + (type === 'app' ? '' : '/' + id), origin.origin);
-  Object.entries(entry.params || {}).forEach(([key, val]) => {
-    if (val !== undefined && val !== null && val !== '') url.searchParams.set(key, String(val));
-  });
-  if (type === 'submission' || type === 'detail') url.searchParams.set('isRenderNav', 'false');
-  if (type === 'detail') {
-    if (typeof entry.formInstId !== 'string' || !entry.formInstId.trim()) throw new Error('Missing formInstId');
-    url.searchParams.set('formInstId', entry.formInstId);
-    url.searchParams.set('navConfig.layout', '1180');
-  }
-  if (entry.hash) url.hash = entry.hash;
-  return url.href;
-}
-
-function navigateCanvasPage(entry, context = {}) {
-  if (entry.targetType === 'local') {
-    if (!entry.viewKey || typeof context.selectView !== 'function') throw new Error('Missing local view handler');
-    context.selectView(entry.viewKey);
-    return;
-  }
-  if (entry.targetType === 'submission' || entry.targetType === 'detail') {
-    // Validate before opening; the standard container owns PC/mobile behavior.
-    buildCanvasPageUrl(entry, context);
-    if (typeof context.openForm !== 'function') throw new Error('Connect useYidaFormOpen first');
-    context.openForm({ ...entry, type: entry.targetType, appType: entry.appType || context.appType });
-    return;
-  }
-  const href = buildCanvasPageUrl(entry, context);
-  const utils = context.utils || window.__OPENYIDA_UTILS__;
-  if (entry.openMode === 'new-tab' || entry.targetType === 'url') {
-    if (typeof utils?.openPage === 'function') return utils.openPage({ url: href });
-    window.open(href, '_blank', 'noopener,noreferrer');
-    return;
-  }
-  if (typeof utils?.router?.push === 'function') return utils.router.push(href, {}, false, true);
-  window.location.assign(href);
-}