openyida 2026.7.27 → 2026.7.29-beta.2

package/lib/app/canvas-compile.js

@@ -33,6 +33,7 @@ const {
   assertNoEmojiInArtifactName,
   assertNoEmojiInText,
 } = require('../core/no-emoji-guard');
+const { CliError, isCliError } = require('../core/cli-error');
 
 /**
  * 依赖 → window 别名白名单。
@@ -59,6 +60,10 @@ const MODULE_ALIAS_MAP = {
   'framer-motion': 'FramerMotion',
 };
 
+const LUCIDE_REACT_PACKAGE = 'lucide-react';
+const LUCIDE_DYNAMIC_ICON_ALIAS = 'DynamicIcon';
+const LUCIDE_MODULE_ALIAS = 'LucideReact';
+
 const IMPORT_PATTERN = /import\s+(?:[\w*\s{},]+\s+from\s+)?['"]([^'"]+)['"]/g;
 const IMPORT_SIDE_EFFECT_PATTERN = /import\s+['"]([^'"]+)['"]/g;
 const REQUIRE_PATTERN = /require\(\s*['"]([^'"]+)['"]\s*\)/g;
@@ -77,6 +82,11 @@ function packageTempName(pkg) {
   return String(pkg || 'module').replace(/[^A-Za-z0-9_$]+/g, '_') || 'module';
 }
 
+function packageBaseName(pkg) {
+  const segments = String(pkg || '').split('/');
+  return pkg.startsWith('@') ? segments.slice(0, 2).join('/') : segments[0];
+}
+
 function stripJsComments(code) {
   return String(code || '')
     .replace(/\/\*[\s\S]*?\*\//g, '')
@@ -116,11 +126,14 @@ function resolveWindowAlias(pkg) {
   if (MODULE_ALIAS_MAP[pkg]) {
     return MODULE_ALIAS_MAP[pkg];
   }
-  const segments = pkg.split('/');
-  const base = pkg.startsWith('@') ? segments.slice(0, 2).join('/') : segments[0];
+  const base = packageBaseName(pkg);
   return MODULE_ALIAS_MAP[base] || null;
 }
 
+function isLucideReactPackage(pkg) {
+  return packageBaseName(pkg) === LUCIDE_REACT_PACKAGE;
+}
+
 /**
  * Babel 插件：把 ESM import/export 改写成画布运行时约定。
  *   import X from 'react'            → var _r = window.React; var X = _r && _r.__esModule ? _r.default : _r;
@@ -141,6 +154,76 @@ function esmToWindowPlugin({ types: t }, options = {}) {
     return t.memberExpression(t.identifier('window'), t.stringLiteral(pkg), true);
   }
 
+  function buildLucideImportDeclarations(path, specifiers) {
+    const decls = [];
+    let dynamicIconTmp = null;
+    let lucideReactTmp = null;
+
+    function ensureDynamicIconTmp() {
+      if (!dynamicIconTmp) {
+        dynamicIconTmp = path.scope.generateUidIdentifier(LUCIDE_DYNAMIC_ICON_ALIAS);
+        decls.push(t.variableDeclarator(
+          t.cloneNode(dynamicIconTmp),
+          moduleExpr(LUCIDE_REACT_PACKAGE, LUCIDE_DYNAMIC_ICON_ALIAS)
+        ));
+      }
+      return dynamicIconTmp;
+    }
+
+    function ensureLucideReactTmp() {
+      if (!lucideReactTmp) {
+        lucideReactTmp = path.scope.generateUidIdentifier(LUCIDE_MODULE_ALIAS);
+        decls.push(t.variableDeclarator(
+          t.cloneNode(lucideReactTmp),
+          moduleExpr(LUCIDE_REACT_PACKAGE, LUCIDE_MODULE_ALIAS)
+        ));
+      }
+      return lucideReactTmp;
+    }
+
+    const namedIconProps = [];
+    for (const spec of specifiers) {
+      if (t.isImportDefaultSpecifier(spec)) {
+        decls.push(t.variableDeclarator(
+          t.identifier(spec.local.name),
+          t.cloneNode(ensureDynamicIconTmp())
+        ));
+      } else if (t.isImportNamespaceSpecifier(spec)) {
+        decls.push(t.variableDeclarator(
+          t.identifier(spec.local.name),
+          t.cloneNode(ensureLucideReactTmp())
+        ));
+      } else if (t.isImportSpecifier(spec)) {
+        const importedName = t.isIdentifier(spec.imported) ? spec.imported.name : spec.imported.value;
+        const localName = spec.local.name;
+        if (importedName === LUCIDE_DYNAMIC_ICON_ALIAS) {
+          decls.push(t.variableDeclarator(
+            t.identifier(localName),
+            t.cloneNode(ensureDynamicIconTmp())
+          ));
+        } else {
+          namedIconProps.push(
+            t.objectProperty(
+              t.identifier(importedName),
+              t.identifier(localName),
+              false,
+              importedName === localName
+            )
+          );
+        }
+      }
+    }
+
+    if (namedIconProps.length) {
+      decls.push(t.variableDeclarator(
+        t.objectPattern(namedIconProps),
+        t.cloneNode(ensureLucideReactTmp())
+      ));
+    }
+
+    return t.variableDeclaration('var', decls);
+  }
+
   function buildUnsupportedBareImportError(path, pkg) {
     return path.buildCodeFrameError(
       `Code Canvas 不支持从裸包 "${pkg}" 导入绑定。`
@@ -183,6 +266,11 @@ function esmToWindowPlugin({ types: t }, options = {}) {
           throw buildUnsupportedBareImportError(path, pkg);
         }
 
+        if (isLucideReactPackage(pkg)) {
+          path.replaceWith(buildLucideImportDeclarations(path, specifiers));
+          return;
+        }
+
         const decls = [];
         const tmp = path.scope.generateUidIdentifier(alias || packageTempName(pkg));
         decls.push(t.variableDeclarator(t.cloneNode(tmp), moduleExpr(pkg, alias)));
@@ -382,14 +470,44 @@ function compileCanvasLocal(source, options = {}) {
 function compileCanvas(source, options = {}) {
   return new Promise((resolve, reject) => {
     if (typeof source !== 'string' || source.trim() === '') {
-      reject(new Error('canvas 编译源码为空'));
+      reject(new CliError('canvas 编译源码为空', {
+        code: 'OPENYIDA_CANVAS_COMPILE_EMPTY_SOURCE',
+        details: {
+          stage: 'canvas_compile',
+          sourcePath: options.sourcePath,
+        },
+      }));
       return;
     }
     try {
       resolve(compileCanvasLocal(source, options));
     } catch (compileError) {
+      if (isCliError(compileError)) {
+        reject(compileError);
+        return;
+      }
       const detail = compileError && compileError.message ? compileError.message : String(compileError);
-      reject(new Error(`Code Canvas 本地编译失败: ${detail}`));
+      if (
+        compileError &&
+        /^OPENYIDA_/.test(String(compileError.code || '')) &&
+        compileError.details !== undefined
+      ) {
+        reject(new CliError(`Code Canvas 本地编译失败: ${detail}`, {
+          code: compileError.code,
+          details: compileError.details,
+        }));
+        return;
+      }
+      reject(new CliError(`Code Canvas 本地编译失败: ${detail}`, {
+        code: 'OPENYIDA_CANVAS_COMPILE_FAILED',
+        details: {
+          stage: 'canvas_compile',
+          sourcePath: options.sourcePath,
+          causeCode: compileError && compileError.code,
+          causeName: compileError && compileError.name,
+          loc: compileError && compileError.loc,
+        },
+      }));
     }
   });
 }

package/lib/app/publish.js

@@ -32,6 +32,7 @@ const { createAuthRef, isTokenAuthRef } = require('../core/yida-client');
 const { requireSchemaServerRevision } = require('../core/server-revision');
 const { t } = require('../core/i18n');
 const { banner, step, label, success, fail, warn, info, error, result, usage, hint } = require('../core/chalk');
+const { CliError } = require('../core/cli-error');
 const { compileSource } = require('./page-compiler');
 const { compileCanvas } = require('./canvas-compile');
 const { runLintCheck } = require('./page-linter');
@@ -97,7 +98,7 @@ function parseArgs(argv = process.argv.slice(2)) {
   const force = args.includes('--force');
   const canvas = args.includes('--canvas');
   const help = args.includes('--help') || args.includes('-h');
-  const filteredArgs = args.filter(arg => arg !== '--skip-lint' && arg !== '--health-check' && arg !== '--check' && arg !== '--compat' && arg !== '--modern' && arg !== '--force' && arg !== '--canvas' && arg !== '--help' && arg !== '-h');
+  const filteredArgs = args.filter(arg => arg !== '--skip-lint' && arg !== '--health-check' && arg !== '--check' && arg !== '--compat' && arg !== '--modern' && arg !== '--force' && arg !== '--canvas' && arg !== '--json' && arg !== '--help' && arg !== '-h');
 
   if (help) {
     usage(t('publish.usage'), t('publish.example'));
@@ -122,6 +123,40 @@ function parseArgs(argv = process.argv.slice(2)) {
   };
 }
 
+function buildCanvasCompileCliError(errorObject, sourcePath) {
+  const code = errorObject && errorObject.code
+    ? errorObject.code
+    : 'OPENYIDA_CANVAS_COMPILE_FAILED';
+  const detail = errorObject && errorObject.message ? errorObject.message : String(errorObject);
+  const baseDetails = errorObject && errorObject.details && typeof errorObject.details === 'object'
+    ? { ...errorObject.details }
+    : {};
+
+  return new CliError(`${t('publish.canvas_compile_failed', detail)}\nError Code: ${code}`, {
+    code,
+    details: {
+      ...baseDetails,
+      stage: 'canvas_compile',
+      sourcePath,
+    },
+  });
+}
+
+function enableQuietForJson(argv = []) {
+  if (!Array.isArray(argv) || !argv.includes('--json')) {
+    return () => {};
+  }
+  const previousQuiet = process.env.YIDA_QUIET;
+  process.env.YIDA_QUIET = '1';
+  return () => {
+    if (previousQuiet === undefined) {
+      delete process.env.YIDA_QUIET;
+    } else {
+      process.env.YIDA_QUIET = previousQuiet;
+    }
+  };
+}
+
 function normalizeSourcePathForHint(sourceFile) {
   return String(sourceFile || '')
     .replace(/\\/g, '/')
@@ -686,6 +721,16 @@ function sendHealthCheckRequest(pageUrl, cookies) {
 // ── 主流程 ────────────────────────────────────────────
 
 async function main(argv) {
+  const rawArgv = argv || process.argv.slice(2);
+  const restoreQuiet = enableQuietForJson(rawArgv);
+  try {
+    return await runMain(rawArgv);
+  } finally {
+    restoreQuiet();
+  }
+}
+
+async function runMain(argv) {
   const options = parseArgs(argv);
   if (options.help) {
     return options;
@@ -722,8 +767,7 @@ async function main(argv) {
     try {
       canvasResult = await compileCanvas(initialSourceCode, { sourcePath });
     } catch (canvasCompileError) {
-      fail(t('publish.canvas_compile_failed', canvasCompileError.message));
-      process.exit(1);
+      throw buildCanvasCompileCliError(canvasCompileError, sourcePath);
     }
     success(t('publish.canvas_compile_done'));
   } else {

package/lib/core/agent-capabilities.js

@@ -402,7 +402,7 @@ function buildAgentCapabilities() {
       ],
       retry_policy: 'Do not repeat the same failed command without changing login state, organization, parameters, files, or field IDs.',
       completion_contracts: {
-        full_app: 'Default fast_build is complete after creating the app, core forms, primary page, publishing it, and returning an access URL.',
+        full_app: 'Default fast_build is complete after creating the app, core forms, primary page, publishing it, and returning access URLs. If three or more resources/links are returned, present them in a Markdown table with type, purpose/name, URL, and status.',
       },
       fast_build_data_contract: 'Default fast_build page code must not call this.dataSourceMap.* unless the same run created and bound a designer data source; use this.utils.yida.* or an entry-only page by default.',
     },

package/lib/core/command-manifest.js

@@ -1302,8 +1302,10 @@ function summarizeLocalizedCommands(commands) {
         mode: 'fast_build',
         trigger_phrases: ['默认方案', '不要追问', '直接创建', '尽快搭建'],
         default_page_skill_id: 'yida-canvas-custom-page',
+        default_ui_guidance_skill_id: 'yida-page-uiux',
         ordinary_jsx_skill_id: 'yida-custom-page',
         page_skill_policy: 'Use Code Canvas by default for the primary custom page. Choose yida-custom-page when the user explicitly asks for the ordinary custom page JSX/Jsx component chain, or when the page strongly depends on this.$(fieldId), this.utils.yida.*, this.dataSourceMap, form submission, or deep field two-way binding.',
+        ui_guidance_policy: 'Default full-app primary page creation includes yida-page-uiux lightweight UI guidance to decide page type, template route, visualProfile, and sample-avoidance checks. This is not deep_design and must not pull yida-app-uiux, theme, navigation, demo data, screenshots, or long PRD work by default.',
         required_command_ids: [
           'agent-capabilities',
           'create-app',
@@ -1326,13 +1328,13 @@ function summarizeLocalizedCommands(commands) {
           'append-chart',
         ],
         do_not_default_skill_ids: [
-          'yida-page-uiux',
+          'yida-app-uiux',
           'yida-data-source-connectors',
           'yida-data-management',
           'yida-nav-group',
           'yida-dashboard',
         ],
-        completion_contract: 'Create app, core forms, primary page, publish it, and return an access URL.',
+        completion_contract: 'Create app, core forms, primary page, publish it, and return access URLs. If three or more resources/links are returned, present them in a Markdown table with type, purpose/name, URL, and status.',
       },
     },
   };

package/lib/core/sample.js

@@ -60,6 +60,9 @@ const SAMPLES = {
     'todo-mvc':                   'todo-mvc.canvas.jsx',
     'workbench-home':             'workbench-home.canvas.jsx',
   },
+  'yida-rechart': {
+    'trend-combo': 'trend-combo.canvas.jsx',
+  },
   'yida-create-app': {
     'ipd-app-template': 'ipd-app-template.js',
   },
@@ -69,6 +72,9 @@ const SAMPLES = {
   'yida-density': {
     'density-switch-page': 'density-switch-page.js',
   },
+  'yida-canvas-table-form': {
+    'table-form-batch-submit': 'table-form-batch-submit.canvas.jsx',
+  },
   'yida-table-form': {
     'table-form-batch-submit': 'table-form-batch-submit.js',
   },