openyida 2026.9.2-beta.0 → 2026.9.2

package/README.md

@@ -167,11 +167,13 @@ For a user-facing list of supported features and matching CLI commands, see [Ope
 
 ```bash
 openyida create-app "CRM"
-openyida create-app --name "CRM" --desc "Customer management" --theme deepBlue
+openyida create-app --name "CRM" --desc "Customer management" --theme-file ./app-theme.css --nav-theme light --logo-source appIcon --layout l_shape
 openyida app-list --size 20
 openyida corp-efficiency
 openyida create-form create APP_XXX "Customer" .cache/openyida/forms/customer-fields.json
 openyida create-form update APP_XXX FORM_XXX .cache/openyida/forms/customer-changes.json
+openyida sample openyida-scaffold form-fields --output .cache/openyida/forms/customer-fields.json
+openyida sample openyida-scaffold canvas-form-drawer --output project/pages/src/customer-entry.canvas.jsx --var APP_TYPE=APP_XXX --var FORM_UUID=FORM_XXX
 openyida get-schema APP_XXX FORM_XXX
 openyida get-schema APP_XXX FORM_XXX --compact --resolve-fields "Customer Name,Status"
 openyida get-schema APP_XXX --all --output-dir .cache/schemas
@@ -388,7 +390,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida app-list [--size N]` | List my Yida apps |
 | `openyida corp-efficiency [overview\|details\|detail\|groups\|notify] [options] [--open\|--no-open]` | Query enterprise efficiency overview and detail reports |
 | `openyida create-app "<name>"\|--name <name> [options] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a Yida app |
-| `openyida update-app <appType> [--name "..."] [--layout slide\|ver] [--theme deepBlue] [--hide-app-nav\|--show-app-nav]` | Update app info |
+| `openyida update-app <appType> [--name "..."] [--theme-file <css>] [--nav-theme light\|dark\|white\|gray] [--logo-source appIcon\|customImage] [--layout side\|top\|l_shape] [--hide-app-nav\|--show-app-nav]` | Update app info |
 | `openyida app-online <appType> [--to-ding-app-center] [--show-app-center]` | Enable a Yida app |
 | `openyida app-offline <appType> [--to-ding-app-center] [--show-app-center]` | Disable a Yida app |
 | `openyida nav-group <list\|create\|rename\|delete\|move\|order\|auto-order\|hide\|show> <appType> ...` | Manage app sidebar navigation groups |
@@ -422,9 +424,6 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida publish <src> <appType> <formUuid> [--health-check] [--force] [--canvas] [--auto-nav-order] [--open\|--no-open]` | Compile and publish custom page |
 | `openyida update-form-config <appType> ...` | Update form configuration |
 | `openyida get-form-config <appType> <formUuid> [--json]` | Query form configuration |
-| `openyida form-detail-style apply <appType> <formUuid> [--css file\|--preset clean-card] [--json]` | Manage form detail page style |
-| `openyida form-detail-style remove <appType> <formUuid> [--json]` | Manage form detail page style |
-| `openyida form-detail-style check <appType> <formUuid> [--json]` | Manage form detail page style |
 
 ### Data & Permissions
 

package/bin/yida.js

@@ -882,14 +882,8 @@ async function main() {
       break;
     }
 
-    case 'form-detail-style': {
-      const { run: runFormDetailStyle } = require('../lib/app/form-detail-style');
-      await runFormDetailStyle(args);
-      break;
-    }
-
     case 'update-app': {
-      if (args.length < 2) {
+      if (args.length < 2 && !hasHelpFlag(args)) {
         throwCliUsage(t('cli.update_app_usage'), t('cli.update_app_example'));
       }
       const { run: runUpdateApp } = require('../lib/app/update-app');

package/lib/app/canvas-compile.js

@@ -139,6 +139,13 @@ const BARE_DEPENDENCY_GLOBALS = Object.freeze({
 const CANVAS_RUNTIME_GLOBAL_IDENTIFIERS = new Set([
   ...Object.keys(globals.builtin),
   ...Object.keys(globals.browser),
+  // globals follows its package release cadence; keep modern standards that
+  // are already available in supported browsers explicit until that list catches up.
+  'URLPattern',
+  'navigation',
+  'cookieStore',
+  'scheduler',
+  'Temporal',
   'iframeWindow',
   'parentWindow',
 ]);

package/lib/app/create-app.js

@@ -2,6 +2,7 @@
  * create-app.js - 宜搭应用创建命令
  *
  * 用法：openyida create-app "<appName>" [description] [icon] [iconColor] [colour] [navTheme] [layoutDirection]
+ *       openyida create-app --name "<appName>" --theme-file ./app-theme.css [--nav-theme light] [--logo-source appIcon] [--layout l_shape]
  */
 
 'use strict';
@@ -20,13 +21,65 @@ const { parseOpenOption, withBrowserHandoff } = require('../core/browser-handoff
 const { throwCommandError } = require('../core/command-errors');
 const { assertPresetThemeKey } = require('./theme-presets');
 const { resolveBuilderAiSource } = require('./builder-ai-source');
+const { normalizeCssColorToHex, readThemeCssFile } = require('./custom-theme');
+const {
+  applyCustomThemeUpdate,
+  assertLogoSource,
+  assertNavTheme,
+  normalizeLayoutDirection,
+} = require('./update-app');
 
 const DEFAULT_APP_OPTIONS = {
-  icon: 'xian-yingyong',
   iconColor: '#0089FF',
   colour: 'podBlue',
 };
 
+// 与 yida-next/src/components/IconSelect/Icon.js 保持一致。
+const APP_ICON_NAMES = Object.freeze([
+  'xian-xinwen',
+  'xian-diqiu',
+  'xian-zhengfu',
+  'xian-qiche',
+  'xian-yingyong',
+  'xian-feiji',
+  'xian-xueshimao',
+  'xian-diannao',
+  'xian-qiye',
+  'xian-gongzuozheng',
+  'xian-danju',
+  'xian-gouwuche',
+  'xian-shichang',
+  'xian-xinyongka',
+  'xian-jingli',
+  'xian-huodong',
+  'xian-falv',
+  'xian-jiangbei',
+  'xian-baogao',
+  'xian-liucheng',
+  'huoche',
+  'chaxun',
+  'shenbao',
+  'daka',
+]);
+const DEFAULT_CREATE_LAYOUT_DIRECTION = 'l_shape';
+
+function selectRandomAppIcon(random = Math.random) {
+  const index = Math.min(APP_ICON_NAMES.length - 1, Math.floor(random() * APP_ICON_NAMES.length));
+  return APP_ICON_NAMES[Math.max(0, index)];
+}
+
+function applyThemeFileCreateDefaults(params, themeFileInfo) {
+  if (!params || !params.themeFile || !themeFileInfo) {return params;}
+  const iconColor = normalizeCssColorToHex(themeFileInfo.themeColor);
+  if (!iconColor) {
+    throw new Error(`--color-brand1-6 无法转换为应用图标色: ${themeFileInfo.themeColor}`);
+  }
+  return {
+    ...params,
+    iconColor,
+  };
+}
+
 const INDUSTRY_APP_DEFAULTS = [
   {
     name: 'legal',
@@ -147,7 +200,7 @@ function readOptionValue(args, index, optionName) {
   return value;
 }
 
-function parseCreateAppArgs(args) {
+function parseCreateAppArgs(args, random = Math.random) {
   const params = {
     appName: null,
     description: null,
@@ -155,7 +208,9 @@ function parseCreateAppArgs(args) {
     iconColor: null,
     colour: null,
     navTheme: null,
+    logoSource: null,
     layoutDirection: null,
+    themeFile: null,
     locale: null,
   };
   const positional = [];
@@ -194,6 +249,16 @@ function parseCreateAppArgs(args) {
         params.navTheme = readOptionValue(args, index, arg);
         index++;
         break;
+      case '--logo-source':
+      case '--logoSource':
+        params.logoSource = readOptionValue(args, index, arg);
+        index++;
+        break;
+      case '--theme-file':
+      case '--custom-theme-file':
+        params.themeFile = readOptionValue(args, index, arg);
+        index++;
+        break;
       case '--layout':
       case '--layout-direction':
       case '--layoutDirection':
@@ -224,13 +289,33 @@ function parseCreateAppArgs(args) {
   params.appName = params.appName || positional[0] || null;
   params.description = params.description || positional[1] || params.appName;
 
+  const explicitIcon = params.icon || positional[2] || null;
+  params.iconWasExplicit = !!explicitIcon;
   const inferredDefaults = inferAppDefaults(params.appName, params.description);
-  params.icon = params.icon || positional[2] || inferredDefaults.icon;
+  params.icon = explicitIcon || (
+    inferredDefaults.industry === 'default'
+      ? selectRandomAppIcon(random)
+      : inferredDefaults.icon
+  );
   params.iconColor = params.iconColor || positional[3] || inferredDefaults.iconColor;
   params.colour = params.colour || positional[4] || inferredDefaults.colour;
   assertPresetThemeKey(params.colour);
   params.navTheme = params.navTheme || positional[5] || null;
-  params.layoutDirection = params.layoutDirection || positional[6] || null;
+  params.layoutDirection = normalizeLayoutDirection(
+    params.layoutDirection || positional[6] || DEFAULT_CREATE_LAYOUT_DIRECTION
+  );
+  assertNavTheme(params.navTheme);
+  assertLogoSource(params.logoSource);
+  if (params.logoSource && !params.themeFile) {
+    throw new Error('--logo-source must be used with --theme-file so the navigation theme is saved atomically');
+  }
+  if (params.themeFile) {
+    params.navTheme = params.navTheme || 'light';
+    params.logoSource = params.logoSource || 'appIcon';
+    if (params.logoSource !== 'appIcon') {
+      throw new Error('create-app only supports --logo-source appIcon because a new app has no homepageLogo image yet');
+    }
+  }
   params.industry = inferredDefaults.industry;
 
   return params;
@@ -269,10 +354,10 @@ function buildCreateAppPayload(params, auth, contentLocale, openExclusive, openP
     openPhysicColumn,
     openIsolationDatabase: 'n',
     openExclusiveUnit: 'n',
-    createWithModernTheme: 'y',
     group: 'ALL',
     fromBuilderAi: 'y',
     builderAiSource: resolveBuilderAiSource(),
+    createWithModernTheme: 'y',
   };
   if (navTheme) {
     payload.navTheme = navTheme;
@@ -305,7 +390,13 @@ async function run(args) {
     chalkError(t('create_app.usage'), { hint: t('create_app.example') });
   }
 
-  const { appName, description, icon, iconColor, colour, navTheme, layoutDirection } = params;
+  // 在远端创建应用前先完成本地主题校验，避免 CSS 缺失或 token 非法时留下半成品应用。
+  if (params.themeFile) {
+    const themeFileInfo = readThemeCssFile(params.themeFile);
+    Object.assign(params, applyThemeFileCreateDefaults(params, themeFileInfo));
+  }
+
+  const { appName, description, icon, iconColor, colour, navTheme, logoSource, layoutDirection, themeFile } = params;
 
   const { c, banner, step, label, success: chalkSuccess, result: chalkResult } = require('../core/chalk');
 
@@ -313,7 +404,7 @@ async function run(args) {
   label('Name', appName);
   label('Desc', description);
   label('Icon', `${icon} ${c.dim}(${iconColor})${c.reset}`);
-  label('Theme', `${colour} / ${navTheme || 'default'} / ${layoutDirection || 'default'}`);
+  label('Theme', `${themeFile || colour} / ${navTheme || 'default'} / ${logoSource || 'default'} / ${layoutDirection || 'default'}`);
 
   // Step 1: 读取登录态
   step(1, t('common.step_login', 1));
@@ -356,6 +447,29 @@ async function run(args) {
     const appUrl = `${authRef.baseUrl}/${appType}/workbench`;
     const corpId = authRef.corpId || (authRef.authData && authRef.authData.corp_id) || '';
 
+    if (themeFile) {
+      step(3, t('update_app.step_update'));
+      const themeResponse = await applyCustomThemeUpdate(appType, {
+        themeFile,
+        navTheme,
+        logoSource,
+        layoutDirection,
+      }, authRef);
+      if (!themeResponse || !themeResponse.success) {
+        const errorMsg = themeResponse
+          ? themeResponse.errorMsg || t('common.unknown_error')
+          : t('common.request_failed');
+        console.log(JSON.stringify({
+          success: false,
+          appCreated: true,
+          appType,
+          themeApplied: false,
+          error: errorMsg,
+        }));
+        throwCommandError(t('create_app.failed', errorMsg));
+      }
+    }
+
     chalkResult(true, t('create_app.success'), [
       ['appType', appType],
       ['Corp ID', corpId || t('common.unknown_error')],
@@ -366,7 +480,17 @@ async function run(args) {
     if (prdFile) {updatePrdCorpId(prdFile, corpId, appType, authRef.baseUrl);}
 
     console.log(JSON.stringify(withBrowserHandoff(
-      { success: true, appType, appName, corpId, url: appUrl },
+      {
+        success: true,
+        appType,
+        appName,
+        corpId,
+        url: appUrl,
+        themeFile: themeFile || undefined,
+        navTheme: themeFile ? navTheme : undefined,
+        logoSource: themeFile ? logoSource : undefined,
+        layoutDirection,
+      },
       appUrl,
       { stage: 'create_app_success', title: appName },
       openOption.mode
@@ -379,4 +503,13 @@ async function run(args) {
   }
 }
 
-module.exports = { run, parseCreateAppArgs, inferAppDefaults, buildCreateAppPayload };
+module.exports = {
+  APP_ICON_NAMES,
+  DEFAULT_CREATE_LAYOUT_DIRECTION,
+  run,
+  parseCreateAppArgs,
+  inferAppDefaults,
+  selectRandomAppIcon,
+  applyThemeFileCreateDefaults,
+  buildCreateAppPayload,
+};

package/lib/app/create-form.js

@@ -83,7 +83,6 @@ const { createDefinitionReaders } = require('./create-form/definition-reader');
 const { dispatchCreateFormCommand } = require('./create-form/commands');
 const { buildApiPath } = require('./create-form/api-path');
 const { deepMerge, splitJsonPointer } = require('./create-form/schema-patch');
-const { ensureYidaGlobalThemeAction } = require('./form-theme-action');
 const {
   actionRefName,
   buildDesignerEventBinding,
@@ -94,10 +93,6 @@ const {
 const { FORM_RULES_BLOCK_END, FORM_RULES_BLOCK_START } = require('./create-form/rule-builder');
 const { SMART_VALIDATION_BLOCK_END, SMART_VALIDATION_BLOCK_START } = require('./create-form/validation-builder');
 const { createFieldNormalizers } = require('./create-form/field-normalizers');
-const {
-  readCss: readFormDetailCss,
-  upsertFormDetailCss,
-} = require('./form-detail-style');
 const {
   validateFormFieldDefinitions: collectFormFieldValidationDiagnostics,
 } = require('./form-field-validator');
@@ -110,7 +105,6 @@ function parseOpenOption(inputArgs) {
 // ── 选项类字段类型 ───────────────────────────────────
 const OPTION_FIELD_TYPES = ['RadioField', 'SelectField', 'CheckboxField', 'MultiSelectField'];
 const FIELD_RESOLUTION_CANDIDATE_LIMIT = 8;
-const DEFAULT_FORM_DETAIL_STYLE_PRESET = 'clean-card';
 
 function throwCreateFormError(message, code, details) {
   throw createCreateFormError(message, code, details);
@@ -1323,16 +1317,11 @@ function buildComponentsMap(componentNames) {
   return componentNames.map(function (name) {
     return {
       package: '@ali/vc-deep-yida',
-      version: '1.5.169',
       componentName: name,
     };
   });
 }
 
-function applyDefaultFormDetailStyle(schema) {
-  return upsertFormDetailCss(schema, readFormDetailCss({ preset: DEFAULT_FORM_DETAIL_STYLE_PRESET }));
-}
-
 function buildComponentAliasItems(components) {
   const items = [];
   const usedAliases = Object.create(null);
@@ -1888,7 +1877,6 @@ function buildFormSchema(formTitle, fields, formUuid, corpId, appType, layout, t
       connectComponent: [],
     },
   };
-  applyDefaultFormDetailStyle(schema);
   return schema;
 }
 
@@ -2007,12 +1995,12 @@ function buildEmptyFormSchema() {
         },
       ],
       componentsMap: [
-        { package: '@ali/vc-deep-yida', version: '1.5.169', componentName: 'RootHeader' },
-        { package: '@ali/vc-deep-yida', version: '1.5.169', componentName: 'FormContainer' },
-        { package: '@ali/vc-deep-yida', version: '1.5.169', componentName: 'RootContent' },
-        { package: '@ali/vc-deep-yida', version: '1.5.169', componentName: 'FooterYida' },
-        { package: '@ali/vc-deep-yida', version: '1.5.169', componentName: 'RootFooter' },
-        { package: '@ali/vc-deep-yida', version: '1.5.169', componentName: 'Page' },
+        { package: '@ali/vc-deep-yida', componentName: 'RootHeader' },
+        { package: '@ali/vc-deep-yida', componentName: 'FormContainer' },
+        { package: '@ali/vc-deep-yida', componentName: 'RootContent' },
+        { package: '@ali/vc-deep-yida', componentName: 'FooterYida' },
+        { package: '@ali/vc-deep-yida', componentName: 'RootFooter' },
+        { package: '@ali/vc-deep-yida', componentName: 'Page' },
       ],
     },
     ],
@@ -4468,7 +4456,6 @@ function ensureComponentsMap(schema, componentName) {
   if (existingNames.indexOf(componentName) === -1) {
     pageSchema.componentsMap.push({
       package: '@ali/vc-deep-yida',
-      version: '1.5.169',
       componentName: componentName,
     });
   }
@@ -4797,7 +4784,6 @@ async function saveFormSchema(authRef, appType, formUuid, schema, version, stepO
   if (fixedRefs > 0) {
     info(t('create_form.formula_prefix_fixed', fixedRefs));
   }
-  applyDefaultFormDetailStyle(schema);
   assertNoEmojiInValue(schema, {
     artifact: 'Yida form schema ' + formUuid,
     code: 'OPENYIDA_FORM_SCHEMA_EMOJI_FORBIDDEN',
@@ -6072,8 +6058,6 @@ module.exports = {
     normalizeFormDefinitionType,
     validateFormFieldDefinitions,
     collectFormFieldValidationDiagnostics,
-    ensureYidaGlobalThemeAction,
-    applyDefaultFormDetailStyle,
     applyChangesToSchema,
     applyFormRules,
     applySchemaPatchOperations,