openxiangda 1.0.55 → 1.0.56

package/openxiangda-skills/skills/openxiangda-app/SKILL.md

@@ -65,6 +65,8 @@ openxiangda runtime deploy --profile <name>
 ```
 
 `runtime deploy` builds and activates the app-level SPA release for `/view/:appType/*`.
+Publish React SPA forms separately with `openxiangda workspace publish --form <formCode>`;
+with `runtimeMode: "react-spa"` this is schema-only and does not require OSS.
 
 Bind to an existing app only when the user explicitly provides `appType` or asks to reuse an existing platform app:
 
@@ -99,6 +101,7 @@ openxiangda workspace bind --profile <name> --app-type APP_XXX
 - Use logical local codes for forms, pages, workflows, automations, and menus.
 - Before scaffolding a new business app, read `../../references/best-practices.md` and pick an architecture from the initialized `examples/best-practices/` catalog. Do not generate a large single-file app page when a template pattern already covers the scenario.
 - For Phase 6 React SPA apps, use `--runtime react-spa`. The generated app owns routing/layouts/menus with React Router and Tailwind CSS; platform permissions still come from backend runtime bootstrap and route checks.
+- React SPA form publish is schema-only by default. Do not add OSS credentials or old embedded form bundles unless explicitly maintaining legacy compatibility with `--legacy-form-bundle`.
 - When publishing after app edits, prefer targeted commands (`workspace publish --changed --dry-run`, then `--changed`, `--page`, `--form`, or `--only`). Do not publish all forms/pages just because one page changed.
 - Use `openxiangda app snapshot <APP_XXX> --profile <name> --json` before changing an existing app.
 

package/openxiangda-skills/skills/openxiangda-core/SKILL.md

@@ -45,6 +45,20 @@ openxiangda runtime deploy --profile <name>
 
 `runtime deploy` builds the Vite app with a release-specific asset base, uploads `dist/` to the platform runtime release store, and activates the release unless `--no-activate` is passed.
 
+For React SPA forms, still use targeted form publish to create/bind the form and
+sync schema:
+
+```bash
+openxiangda workspace publish --profile <name> --form <formCode> --dry-run
+openxiangda workspace publish --profile <name> --form <formCode>
+```
+
+When `app-workspace.config.ts` has `runtimeMode: "react-spa"`, form publish is
+schema-only by default: it does not build or upload the legacy form page bundle
+to OSS. The React SPA renders form submit/detail/list routes through
+`openxiangda/runtime` default pages. Use `--legacy-form-bundle` only when a
+React SPA app intentionally needs the old embedded form page bundle.
+
 ## DO NOT
 
 - ❌ `pnpm publish:all` / `pnpm publish:oss` / `pnpm register` / `lowcode-workspace publish-*` directly. They are workspace internals and miss `OPENXIANGDA_PROFILE / BASE_URL / ACCESS_TOKEN / APP_TYPE` injection.
@@ -147,6 +161,8 @@ menus, and route permission checks. Do not publish React SPA pages through the
 old custom-page app-shell path unless explicitly maintaining a legacy app.
 Use `openxiangda resource publish` for roles/menus/page permission groups and
 `openxiangda runtime deploy` for the SPA frontend release.
+Use `openxiangda workspace publish --form <formCode>` only for schema/form shell
+sync; it is schema-only by default and does not require OSS credentials.
 
 Local workspace state is authoritative. If `.openxiangda/state.json` already contains an app binding for the target profile, use it. If there is no local binding, create a new app with `workspace init --app-name`; do not search platform apps for similar names.
 

package/openxiangda-skills/skills/openxiangda-form/SKILL.md

@@ -85,6 +85,14 @@ openxiangda workspace publish --profile <name> --form <formCode>
 
 The workspace publish script receives `OPENXIANGDA_BASE_URL`, `OPENXIANGDA_ACCESS_TOKEN`, and `OPENXIANGDA_APP_TYPE` from the CLI. It creates/binds the platform form shell only when needed, syncs form metadata, builds the React form page bundle, uploads assets, and registers the bundle.
 
+For Phase 6 React SPA workspaces, `app-workspace.config.ts` should declare
+`runtimeMode: "react-spa"`. In that mode, `workspace publish --form <code>` is
+schema-only by default: it creates/binds the form and syncs schema, but skips
+the legacy form page bundle, OSS upload, and bundle register. The app-level
+React runtime renders submit/detail/list pages. Pass `--legacy-form-bundle`
+only when intentionally maintaining compatibility with an old embedded form
+page bundle.
+
 ## Low-level Commands
 
 Use these only for diagnosis, binding existing resources, or repairing a broken publish state:
@@ -131,7 +139,7 @@ Read these references only when writing or reviewing schema:
 - Put validation on field-level `rules`; never generate old top-level validation arrays under `schema.rules`. Top-level `rules` is only for `FormEffect[]` with `when` and `then`.
 - Always provide `options` for option components. `SelectField`, `MultiSelectField`, `RadioField`, `CheckboxField`, and `CascadeSelectField` must not be emitted with `options` undefined. See `../../references/component-guide.md` for the full list and `../../references/platform-data-model.md` for the `{label, value}` storage contract.
 - Do not emit raw native form controls in app/workspace source. For basic entry use `TextField`, `TextAreaField`, `NumberField`, `DateField`, `SelectField`, `RadioField`, etc.; for platform-specific entry use `UserSelectField`, `DepartmentSelectField`, `AttachmentField`, `ImageField`, `EditorField`, `DigitalSignatureField`, and `LocationField`.
-- Workflow form pages use the same workspace form structure plus workflow v3 configuration; publish the form page bundle through workspace publish before treating it as complete.
+- Workflow form pages use the same workspace form structure plus workflow v3 configuration. In legacy workspaces, publish the form page bundle through workspace publish before treating it as complete. In React SPA workspaces, `workspace publish --form` syncs schema only, and the SPA default process pages render through `runtime deploy`.
 - After editing one form, use `workspace publish --form <formCode>` or preview `--changed --dry-run`; do not run full workspace publish by default.
 - Use `openxiangda form pull` or app snapshot before overwriting an existing form.
 - Before assuming a value shape (e.g. dates, attachments, member fields, option fields), verify against `../../references/platform-data-model.md` instead of guessing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.55",
+  "version": "1.0.56",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {

package/packages/sdk/dist/build/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/build/index.ts"],"sourcesContent":["export type CssIsolation = 'namespace' | 'shadow' | 'none';\n\nexport interface AppWorkspaceConfig {\n  appType?: string;\n  appName?: string;\n  platformUrl?: string;\n  servicePrefix?: string;\n  appKey?: string;\n  appSecret?: string;\n  userId?: string;\n  version?: string;\n  buildId?: string;\n  oss?: {\n    region?: string;\n    bucket?: string;\n    accessKeyId?: string;\n    accessKeySecret?: string;\n    pathPrefix?: string;\n    corsOrigins?: string[];\n    skipCors?: boolean;\n  };\n  defaults?: {\n    protocolVersion?: string;\n    frameworkVersion?: string;\n    cssIsolation?: CssIsolation;\n    formMenuParentId?: string;\n    formMenuIcon?: string;\n    pageMenuParentId?: string;\n    pageMenuIcon?: string;\n    formBuilderVersion?: string;\n  };\n  forms?: { dir?: string };\n  pages?: { dir?: string };\n}\n\nexport function defineAppWorkspaceConfig<T extends AppWorkspaceConfig>(config: T): T {\n  return config;\n}\n\nconst DEFAULT_NAMESPACE_PREFIX = '.sy-app-workspace';\n\nfunction splitCssSelectors(selector: string) {\n  const selectors: string[] = [];\n  let depth = 0;\n  let quote = '';\n  let current = '';\n  for (const char of selector) {\n    if (quote) {\n      current += char;\n      if (char === quote) quote = '';\n      continue;\n    }\n    if (char === '\"' || char === \"'\") {\n      quote = char;\n      current += char;\n      continue;\n    }\n    if (char === '(' || char === '[') depth += 1;\n    if (char === ')' || char === ']') depth -= 1;\n    if (char === ',' && depth === 0) {\n      selectors.push(current.trim());\n      current = '';\n      continue;\n    }\n    current += char;\n  }\n  if (current.trim()) selectors.push(current.trim());\n  return selectors;\n}\n\nfunction shouldSkipNamespace(selector: string, prefix: string) {\n  if (!selector || selector.includes(prefix)) return true;\n  if (/^(html|body|:root)(\\b|:|\\[|$)/.test(selector)) return true;\n  if (/^(@|from\\b|to\\b|\\d+%)/.test(selector)) return true;\n  if (/^\\.(ant|sy-ant|anticon|adm)-/.test(selector)) return true;\n  return false;\n}\n\nfunction createAntdSelectorAlias(selector: string) {\n  const aliased = selector\n    .replace(/(^|[^A-Za-z0-9_-])\\.ant-/g, '$1.sy-ant-')\n    .replace(/(^|[^A-Za-z0-9_-])\\.anticon-/g, '$1.sy-anticon-')\n    .replace(/(^|[^A-Za-z0-9_-])\\.anticon(?=$|[^A-Za-z0-9_-])/g, '$1.sy-anticon');\n  return aliased === selector ? null : aliased;\n}\n\nexport function createOpenXiangdaNamespaceCssPlugin(\n  prefix = DEFAULT_NAMESPACE_PREFIX,\n) {\n  return {\n    postcssPlugin: 'openxiangda-namespace-css',\n    Rule(rule: { selector?: string; parent?: any }) {\n      if (!rule.selector) return;\n      let parent = rule.parent;\n      while (parent) {\n        if (parent.type === 'atrule' && /keyframes$/i.test(parent.name)) {\n          return;\n        }\n        parent = parent.parent;\n      }\n      rule.selector = Array.from(\n        new Set(\n          splitCssSelectors(rule.selector).flatMap((selector) => {\n            const scopedSelector = shouldSkipNamespace(selector, prefix)\n              ? selector\n              : `${prefix} ${selector}`;\n            const antdAlias = createAntdSelectorAlias(scopedSelector);\n            return antdAlias ? [scopedSelector, antdAlias] : [scopedSelector];\n          }),\n        ),\n      ).join(', ');\n    },\n  };\n}\n\n(createOpenXiangdaNamespaceCssPlugin as any).postcss = true;\n\nexport const createNamespaceCssPlugin = createOpenXiangdaNamespaceCssPlugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmCO,SAAS,yBAAuD,QAAc;AACnF,SAAO;AACT;AAEA,IAAM,2BAA2B;AAEjC,SAAS,kBAAkB,UAAkB;AAC3C,QAAM,YAAsB,CAAC;AAC7B,MAAI,QAAQ;AACZ,MAAI,QAAQ;AACZ,MAAI,UAAU;AACd,aAAW,QAAQ,UAAU;AAC3B,QAAI,OAAO;AACT,iBAAW;AACX,UAAI,SAAS,MAAO,SAAQ;AAC5B;AAAA,IACF;AACA,QAAI,SAAS,OAAO,SAAS,KAAK;AAChC,cAAQ;AACR,iBAAW;AACX;AAAA,IACF;AACA,QAAI,SAAS,OAAO,SAAS,IAAK,UAAS;AAC3C,QAAI,SAAS,OAAO,SAAS,IAAK,UAAS;AAC3C,QAAI,SAAS,OAAO,UAAU,GAAG;AAC/B,gBAAU,KAAK,QAAQ,KAAK,CAAC;AAC7B,gBAAU;AACV;AAAA,IACF;AACA,eAAW;AAAA,EACb;AACA,MAAI,QAAQ,KAAK,EAAG,WAAU,KAAK,QAAQ,KAAK,CAAC;AACjD,SAAO;AACT;AAEA,SAAS,oBAAoB,UAAkB,QAAgB;AAC7D,MAAI,CAAC,YAAY,SAAS,SAAS,MAAM,EAAG,QAAO;AACnD,MAAI,gCAAgC,KAAK,QAAQ,EAAG,QAAO;AAC3D,MAAI,wBAAwB,KAAK,QAAQ,EAAG,QAAO;AACnD,MAAI,+BAA+B,KAAK,QAAQ,EAAG,QAAO;AAC1D,SAAO;AACT;AAEA,SAAS,wBAAwB,UAAkB;AACjD,QAAM,UAAU,SACb,QAAQ,6BAA6B,YAAY,EACjD,QAAQ,iCAAiC,gBAAgB,EACzD,QAAQ,oDAAoD,eAAe;AAC9E,SAAO,YAAY,WAAW,OAAO;AACvC;AAEO,SAAS,oCACd,SAAS,0BACT;AACA,SAAO;AAAA,IACL,eAAe;AAAA,IACf,KAAK,MAA2C;AAC9C,UAAI,CAAC,KAAK,SAAU;AACpB,UAAI,SAAS,KAAK;AAClB,aAAO,QAAQ;AACb,YAAI,OAAO,SAAS,YAAY,cAAc,KAAK,OAAO,IAAI,GAAG;AAC/D;AAAA,QACF;AACA,iBAAS,OAAO;AAAA,MAClB;AACA,WAAK,WAAW,MAAM;AAAA,QACpB,IAAI;AAAA,UACF,kBAAkB,KAAK,QAAQ,EAAE,QAAQ,CAAC,aAAa;AACrD,kBAAM,iBAAiB,oBAAoB,UAAU,MAAM,IACvD,WACA,GAAG,MAAM,IAAI,QAAQ;AACzB,kBAAM,YAAY,wBAAwB,cAAc;AACxD,mBAAO,YAAY,CAAC,gBAAgB,SAAS,IAAI,CAAC,cAAc;AAAA,UAClE,CAAC;AAAA,QACH;AAAA,MACF,EAAE,KAAK,IAAI;AAAA,IACb;AAAA,EACF;AACF;AAEC,oCAA4C,UAAU;AAEhD,IAAM,2BAA2B;","names":[]}
+{"version":3,"sources":["../../src/build/index.ts"],"sourcesContent":["export type CssIsolation = 'namespace' | 'shadow' | 'none';\nexport type WorkspaceRuntimeMode = 'legacy' | 'react-spa';\n\nexport interface AppWorkspaceConfig {\n  appType?: string;\n  appName?: string;\n  runtimeMode?: WorkspaceRuntimeMode;\n  platformUrl?: string;\n  servicePrefix?: string;\n  appKey?: string;\n  appSecret?: string;\n  userId?: string;\n  version?: string;\n  buildId?: string;\n  oss?: {\n    region?: string;\n    bucket?: string;\n    accessKeyId?: string;\n    accessKeySecret?: string;\n    pathPrefix?: string;\n    corsOrigins?: string[];\n    skipCors?: boolean;\n  };\n  defaults?: {\n    protocolVersion?: string;\n    frameworkVersion?: string;\n    cssIsolation?: CssIsolation;\n    formMenuParentId?: string;\n    formMenuIcon?: string;\n    pageMenuParentId?: string;\n    pageMenuIcon?: string;\n    formBuilderVersion?: string;\n  };\n  forms?: { dir?: string; publishLegacyBundle?: boolean };\n  pages?: { dir?: string };\n}\n\nexport function defineAppWorkspaceConfig<T extends AppWorkspaceConfig>(config: T): T {\n  return config;\n}\n\nconst DEFAULT_NAMESPACE_PREFIX = '.sy-app-workspace';\n\nfunction splitCssSelectors(selector: string) {\n  const selectors: string[] = [];\n  let depth = 0;\n  let quote = '';\n  let current = '';\n  for (const char of selector) {\n    if (quote) {\n      current += char;\n      if (char === quote) quote = '';\n      continue;\n    }\n    if (char === '\"' || char === \"'\") {\n      quote = char;\n      current += char;\n      continue;\n    }\n    if (char === '(' || char === '[') depth += 1;\n    if (char === ')' || char === ']') depth -= 1;\n    if (char === ',' && depth === 0) {\n      selectors.push(current.trim());\n      current = '';\n      continue;\n    }\n    current += char;\n  }\n  if (current.trim()) selectors.push(current.trim());\n  return selectors;\n}\n\nfunction shouldSkipNamespace(selector: string, prefix: string) {\n  if (!selector || selector.includes(prefix)) return true;\n  if (/^(html|body|:root)(\\b|:|\\[|$)/.test(selector)) return true;\n  if (/^(@|from\\b|to\\b|\\d+%)/.test(selector)) return true;\n  if (/^\\.(ant|sy-ant|anticon|adm)-/.test(selector)) return true;\n  return false;\n}\n\nfunction createAntdSelectorAlias(selector: string) {\n  const aliased = selector\n    .replace(/(^|[^A-Za-z0-9_-])\\.ant-/g, '$1.sy-ant-')\n    .replace(/(^|[^A-Za-z0-9_-])\\.anticon-/g, '$1.sy-anticon-')\n    .replace(/(^|[^A-Za-z0-9_-])\\.anticon(?=$|[^A-Za-z0-9_-])/g, '$1.sy-anticon');\n  return aliased === selector ? null : aliased;\n}\n\nexport function createOpenXiangdaNamespaceCssPlugin(\n  prefix = DEFAULT_NAMESPACE_PREFIX,\n) {\n  return {\n    postcssPlugin: 'openxiangda-namespace-css',\n    Rule(rule: { selector?: string; parent?: any }) {\n      if (!rule.selector) return;\n      let parent = rule.parent;\n      while (parent) {\n        if (parent.type === 'atrule' && /keyframes$/i.test(parent.name)) {\n          return;\n        }\n        parent = parent.parent;\n      }\n      rule.selector = Array.from(\n        new Set(\n          splitCssSelectors(rule.selector).flatMap((selector) => {\n            const scopedSelector = shouldSkipNamespace(selector, prefix)\n              ? selector\n              : `${prefix} ${selector}`;\n            const antdAlias = createAntdSelectorAlias(scopedSelector);\n            return antdAlias ? [scopedSelector, antdAlias] : [scopedSelector];\n          }),\n        ),\n      ).join(', ');\n    },\n  };\n}\n\n(createOpenXiangdaNamespaceCssPlugin as any).postcss = true;\n\nexport const createNamespaceCssPlugin = createOpenXiangdaNamespaceCssPlugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqCO,SAAS,yBAAuD,QAAc;AACnF,SAAO;AACT;AAEA,IAAM,2BAA2B;AAEjC,SAAS,kBAAkB,UAAkB;AAC3C,QAAM,YAAsB,CAAC;AAC7B,MAAI,QAAQ;AACZ,MAAI,QAAQ;AACZ,MAAI,UAAU;AACd,aAAW,QAAQ,UAAU;AAC3B,QAAI,OAAO;AACT,iBAAW;AACX,UAAI,SAAS,MAAO,SAAQ;AAC5B;AAAA,IACF;AACA,QAAI,SAAS,OAAO,SAAS,KAAK;AAChC,cAAQ;AACR,iBAAW;AACX;AAAA,IACF;AACA,QAAI,SAAS,OAAO,SAAS,IAAK,UAAS;AAC3C,QAAI,SAAS,OAAO,SAAS,IAAK,UAAS;AAC3C,QAAI,SAAS,OAAO,UAAU,GAAG;AAC/B,gBAAU,KAAK,QAAQ,KAAK,CAAC;AAC7B,gBAAU;AACV;AAAA,IACF;AACA,eAAW;AAAA,EACb;AACA,MAAI,QAAQ,KAAK,EAAG,WAAU,KAAK,QAAQ,KAAK,CAAC;AACjD,SAAO;AACT;AAEA,SAAS,oBAAoB,UAAkB,QAAgB;AAC7D,MAAI,CAAC,YAAY,SAAS,SAAS,MAAM,EAAG,QAAO;AACnD,MAAI,gCAAgC,KAAK,QAAQ,EAAG,QAAO;AAC3D,MAAI,wBAAwB,KAAK,QAAQ,EAAG,QAAO;AACnD,MAAI,+BAA+B,KAAK,QAAQ,EAAG,QAAO;AAC1D,SAAO;AACT;AAEA,SAAS,wBAAwB,UAAkB;AACjD,QAAM,UAAU,SACb,QAAQ,6BAA6B,YAAY,EACjD,QAAQ,iCAAiC,gBAAgB,EACzD,QAAQ,oDAAoD,eAAe;AAC9E,SAAO,YAAY,WAAW,OAAO;AACvC;AAEO,SAAS,oCACd,SAAS,0BACT;AACA,SAAO;AAAA,IACL,eAAe;AAAA,IACf,KAAK,MAA2C;AAC9C,UAAI,CAAC,KAAK,SAAU;AACpB,UAAI,SAAS,KAAK;AAClB,aAAO,QAAQ;AACb,YAAI,OAAO,SAAS,YAAY,cAAc,KAAK,OAAO,IAAI,GAAG;AAC/D;AAAA,QACF;AACA,iBAAS,OAAO;AAAA,MAClB;AACA,WAAK,WAAW,MAAM;AAAA,QACpB,IAAI;AAAA,UACF,kBAAkB,KAAK,QAAQ,EAAE,QAAQ,CAAC,aAAa;AACrD,kBAAM,iBAAiB,oBAAoB,UAAU,MAAM,IACvD,WACA,GAAG,MAAM,IAAI,QAAQ;AACzB,kBAAM,YAAY,wBAAwB,cAAc;AACxD,mBAAO,YAAY,CAAC,gBAAgB,SAAS,IAAI,CAAC,cAAc;AAAA,UAClE,CAAC;AAAA,QACH;AAAA,MACF,EAAE,KAAK,IAAI;AAAA,IACb;AAAA,EACF;AACF;AAEC,oCAA4C,UAAU;AAEhD,IAAM,2BAA2B;","names":[]}

package/packages/sdk/dist/build/index.d.mts

@@ -1,7 +1,9 @@
 type CssIsolation = 'namespace' | 'shadow' | 'none';
+type WorkspaceRuntimeMode = 'legacy' | 'react-spa';
 interface AppWorkspaceConfig {
     appType?: string;
     appName?: string;
+    runtimeMode?: WorkspaceRuntimeMode;
     platformUrl?: string;
     servicePrefix?: string;
     appKey?: string;
@@ -30,6 +32,7 @@ interface AppWorkspaceConfig {
     };
     forms?: {
         dir?: string;
+        publishLegacyBundle?: boolean;
     };
     pages?: {
         dir?: string;
@@ -45,4 +48,4 @@ declare function createOpenXiangdaNamespaceCssPlugin(prefix?: string): {
 };
 declare const createNamespaceCssPlugin: typeof createOpenXiangdaNamespaceCssPlugin;
 
-export { type AppWorkspaceConfig, type CssIsolation, createNamespaceCssPlugin, createOpenXiangdaNamespaceCssPlugin, defineAppWorkspaceConfig };
+export { type AppWorkspaceConfig, type CssIsolation, type WorkspaceRuntimeMode, createNamespaceCssPlugin, createOpenXiangdaNamespaceCssPlugin, defineAppWorkspaceConfig };

package/packages/sdk/dist/build/index.d.ts

@@ -1,7 +1,9 @@
 type CssIsolation = 'namespace' | 'shadow' | 'none';
+type WorkspaceRuntimeMode = 'legacy' | 'react-spa';
 interface AppWorkspaceConfig {
     appType?: string;
     appName?: string;
+    runtimeMode?: WorkspaceRuntimeMode;
     platformUrl?: string;
     servicePrefix?: string;
     appKey?: string;
@@ -30,6 +32,7 @@ interface AppWorkspaceConfig {
     };
     forms?: {
         dir?: string;
+        publishLegacyBundle?: boolean;
     };
     pages?: {
         dir?: string;
@@ -45,4 +48,4 @@ declare function createOpenXiangdaNamespaceCssPlugin(prefix?: string): {
 };
 declare const createNamespaceCssPlugin: typeof createOpenXiangdaNamespaceCssPlugin;
 
-export { type AppWorkspaceConfig, type CssIsolation, createNamespaceCssPlugin, createOpenXiangdaNamespaceCssPlugin, defineAppWorkspaceConfig };
+export { type AppWorkspaceConfig, type CssIsolation, type WorkspaceRuntimeMode, createNamespaceCssPlugin, createOpenXiangdaNamespaceCssPlugin, defineAppWorkspaceConfig };

package/packages/sdk/dist/build/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/build/index.ts"],"sourcesContent":["export type CssIsolation = 'namespace' | 'shadow' | 'none';\n\nexport interface AppWorkspaceConfig {\n  appType?: string;\n  appName?: string;\n  platformUrl?: string;\n  servicePrefix?: string;\n  appKey?: string;\n  appSecret?: string;\n  userId?: string;\n  version?: string;\n  buildId?: string;\n  oss?: {\n    region?: string;\n    bucket?: string;\n    accessKeyId?: string;\n    accessKeySecret?: string;\n    pathPrefix?: string;\n    corsOrigins?: string[];\n    skipCors?: boolean;\n  };\n  defaults?: {\n    protocolVersion?: string;\n    frameworkVersion?: string;\n    cssIsolation?: CssIsolation;\n    formMenuParentId?: string;\n    formMenuIcon?: string;\n    pageMenuParentId?: string;\n    pageMenuIcon?: string;\n    formBuilderVersion?: string;\n  };\n  forms?: { dir?: string };\n  pages?: { dir?: string };\n}\n\nexport function defineAppWorkspaceConfig<T extends AppWorkspaceConfig>(config: T): T {\n  return config;\n}\n\nconst DEFAULT_NAMESPACE_PREFIX = '.sy-app-workspace';\n\nfunction splitCssSelectors(selector: string) {\n  const selectors: string[] = [];\n  let depth = 0;\n  let quote = '';\n  let current = '';\n  for (const char of selector) {\n    if (quote) {\n      current += char;\n      if (char === quote) quote = '';\n      continue;\n    }\n    if (char === '\"' || char === \"'\") {\n      quote = char;\n      current += char;\n      continue;\n    }\n    if (char === '(' || char === '[') depth += 1;\n    if (char === ')' || char === ']') depth -= 1;\n    if (char === ',' && depth === 0) {\n      selectors.push(current.trim());\n      current = '';\n      continue;\n    }\n    current += char;\n  }\n  if (current.trim()) selectors.push(current.trim());\n  return selectors;\n}\n\nfunction shouldSkipNamespace(selector: string, prefix: string) {\n  if (!selector || selector.includes(prefix)) return true;\n  if (/^(html|body|:root)(\\b|:|\\[|$)/.test(selector)) return true;\n  if (/^(@|from\\b|to\\b|\\d+%)/.test(selector)) return true;\n  if (/^\\.(ant|sy-ant|anticon|adm)-/.test(selector)) return true;\n  return false;\n}\n\nfunction createAntdSelectorAlias(selector: string) {\n  const aliased = selector\n    .replace(/(^|[^A-Za-z0-9_-])\\.ant-/g, '$1.sy-ant-')\n    .replace(/(^|[^A-Za-z0-9_-])\\.anticon-/g, '$1.sy-anticon-')\n    .replace(/(^|[^A-Za-z0-9_-])\\.anticon(?=$|[^A-Za-z0-9_-])/g, '$1.sy-anticon');\n  return aliased === selector ? null : aliased;\n}\n\nexport function createOpenXiangdaNamespaceCssPlugin(\n  prefix = DEFAULT_NAMESPACE_PREFIX,\n) {\n  return {\n    postcssPlugin: 'openxiangda-namespace-css',\n    Rule(rule: { selector?: string; parent?: any }) {\n      if (!rule.selector) return;\n      let parent = rule.parent;\n      while (parent) {\n        if (parent.type === 'atrule' && /keyframes$/i.test(parent.name)) {\n          return;\n        }\n        parent = parent.parent;\n      }\n      rule.selector = Array.from(\n        new Set(\n          splitCssSelectors(rule.selector).flatMap((selector) => {\n            const scopedSelector = shouldSkipNamespace(selector, prefix)\n              ? selector\n              : `${prefix} ${selector}`;\n            const antdAlias = createAntdSelectorAlias(scopedSelector);\n            return antdAlias ? [scopedSelector, antdAlias] : [scopedSelector];\n          }),\n        ),\n      ).join(', ');\n    },\n  };\n}\n\n(createOpenXiangdaNamespaceCssPlugin as any).postcss = true;\n\nexport const createNamespaceCssPlugin = createOpenXiangdaNamespaceCssPlugin;\n"],"mappings":";AAmCO,SAAS,yBAAuD,QAAc;AACnF,SAAO;AACT;AAEA,IAAM,2BAA2B;AAEjC,SAAS,kBAAkB,UAAkB;AAC3C,QAAM,YAAsB,CAAC;AAC7B,MAAI,QAAQ;AACZ,MAAI,QAAQ;AACZ,MAAI,UAAU;AACd,aAAW,QAAQ,UAAU;AAC3B,QAAI,OAAO;AACT,iBAAW;AACX,UAAI,SAAS,MAAO,SAAQ;AAC5B;AAAA,IACF;AACA,QAAI,SAAS,OAAO,SAAS,KAAK;AAChC,cAAQ;AACR,iBAAW;AACX;AAAA,IACF;AACA,QAAI,SAAS,OAAO,SAAS,IAAK,UAAS;AAC3C,QAAI,SAAS,OAAO,SAAS,IAAK,UAAS;AAC3C,QAAI,SAAS,OAAO,UAAU,GAAG;AAC/B,gBAAU,KAAK,QAAQ,KAAK,CAAC;AAC7B,gBAAU;AACV;AAAA,IACF;AACA,eAAW;AAAA,EACb;AACA,MAAI,QAAQ,KAAK,EAAG,WAAU,KAAK,QAAQ,KAAK,CAAC;AACjD,SAAO;AACT;AAEA,SAAS,oBAAoB,UAAkB,QAAgB;AAC7D,MAAI,CAAC,YAAY,SAAS,SAAS,MAAM,EAAG,QAAO;AACnD,MAAI,gCAAgC,KAAK,QAAQ,EAAG,QAAO;AAC3D,MAAI,wBAAwB,KAAK,QAAQ,EAAG,QAAO;AACnD,MAAI,+BAA+B,KAAK,QAAQ,EAAG,QAAO;AAC1D,SAAO;AACT;AAEA,SAAS,wBAAwB,UAAkB;AACjD,QAAM,UAAU,SACb,QAAQ,6BAA6B,YAAY,EACjD,QAAQ,iCAAiC,gBAAgB,EACzD,QAAQ,oDAAoD,eAAe;AAC9E,SAAO,YAAY,WAAW,OAAO;AACvC;AAEO,SAAS,oCACd,SAAS,0BACT;AACA,SAAO;AAAA,IACL,eAAe;AAAA,IACf,KAAK,MAA2C;AAC9C,UAAI,CAAC,KAAK,SAAU;AACpB,UAAI,SAAS,KAAK;AAClB,aAAO,QAAQ;AACb,YAAI,OAAO,SAAS,YAAY,cAAc,KAAK,OAAO,IAAI,GAAG;AAC/D;AAAA,QACF;AACA,iBAAS,OAAO;AAAA,MAClB;AACA,WAAK,WAAW,MAAM;AAAA,QACpB,IAAI;AAAA,UACF,kBAAkB,KAAK,QAAQ,EAAE,QAAQ,CAAC,aAAa;AACrD,kBAAM,iBAAiB,oBAAoB,UAAU,MAAM,IACvD,WACA,GAAG,MAAM,IAAI,QAAQ;AACzB,kBAAM,YAAY,wBAAwB,cAAc;AACxD,mBAAO,YAAY,CAAC,gBAAgB,SAAS,IAAI,CAAC,cAAc;AAAA,UAClE,CAAC;AAAA,QACH;AAAA,MACF,EAAE,KAAK,IAAI;AAAA,IACb;AAAA,EACF;AACF;AAEC,oCAA4C,UAAU;AAEhD,IAAM,2BAA2B;","names":[]}
+{"version":3,"sources":["../../src/build/index.ts"],"sourcesContent":["export type CssIsolation = 'namespace' | 'shadow' | 'none';\nexport type WorkspaceRuntimeMode = 'legacy' | 'react-spa';\n\nexport interface AppWorkspaceConfig {\n  appType?: string;\n  appName?: string;\n  runtimeMode?: WorkspaceRuntimeMode;\n  platformUrl?: string;\n  servicePrefix?: string;\n  appKey?: string;\n  appSecret?: string;\n  userId?: string;\n  version?: string;\n  buildId?: string;\n  oss?: {\n    region?: string;\n    bucket?: string;\n    accessKeyId?: string;\n    accessKeySecret?: string;\n    pathPrefix?: string;\n    corsOrigins?: string[];\n    skipCors?: boolean;\n  };\n  defaults?: {\n    protocolVersion?: string;\n    frameworkVersion?: string;\n    cssIsolation?: CssIsolation;\n    formMenuParentId?: string;\n    formMenuIcon?: string;\n    pageMenuParentId?: string;\n    pageMenuIcon?: string;\n    formBuilderVersion?: string;\n  };\n  forms?: { dir?: string; publishLegacyBundle?: boolean };\n  pages?: { dir?: string };\n}\n\nexport function defineAppWorkspaceConfig<T extends AppWorkspaceConfig>(config: T): T {\n  return config;\n}\n\nconst DEFAULT_NAMESPACE_PREFIX = '.sy-app-workspace';\n\nfunction splitCssSelectors(selector: string) {\n  const selectors: string[] = [];\n  let depth = 0;\n  let quote = '';\n  let current = '';\n  for (const char of selector) {\n    if (quote) {\n      current += char;\n      if (char === quote) quote = '';\n      continue;\n    }\n    if (char === '\"' || char === \"'\") {\n      quote = char;\n      current += char;\n      continue;\n    }\n    if (char === '(' || char === '[') depth += 1;\n    if (char === ')' || char === ']') depth -= 1;\n    if (char === ',' && depth === 0) {\n      selectors.push(current.trim());\n      current = '';\n      continue;\n    }\n    current += char;\n  }\n  if (current.trim()) selectors.push(current.trim());\n  return selectors;\n}\n\nfunction shouldSkipNamespace(selector: string, prefix: string) {\n  if (!selector || selector.includes(prefix)) return true;\n  if (/^(html|body|:root)(\\b|:|\\[|$)/.test(selector)) return true;\n  if (/^(@|from\\b|to\\b|\\d+%)/.test(selector)) return true;\n  if (/^\\.(ant|sy-ant|anticon|adm)-/.test(selector)) return true;\n  return false;\n}\n\nfunction createAntdSelectorAlias(selector: string) {\n  const aliased = selector\n    .replace(/(^|[^A-Za-z0-9_-])\\.ant-/g, '$1.sy-ant-')\n    .replace(/(^|[^A-Za-z0-9_-])\\.anticon-/g, '$1.sy-anticon-')\n    .replace(/(^|[^A-Za-z0-9_-])\\.anticon(?=$|[^A-Za-z0-9_-])/g, '$1.sy-anticon');\n  return aliased === selector ? null : aliased;\n}\n\nexport function createOpenXiangdaNamespaceCssPlugin(\n  prefix = DEFAULT_NAMESPACE_PREFIX,\n) {\n  return {\n    postcssPlugin: 'openxiangda-namespace-css',\n    Rule(rule: { selector?: string; parent?: any }) {\n      if (!rule.selector) return;\n      let parent = rule.parent;\n      while (parent) {\n        if (parent.type === 'atrule' && /keyframes$/i.test(parent.name)) {\n          return;\n        }\n        parent = parent.parent;\n      }\n      rule.selector = Array.from(\n        new Set(\n          splitCssSelectors(rule.selector).flatMap((selector) => {\n            const scopedSelector = shouldSkipNamespace(selector, prefix)\n              ? selector\n              : `${prefix} ${selector}`;\n            const antdAlias = createAntdSelectorAlias(scopedSelector);\n            return antdAlias ? [scopedSelector, antdAlias] : [scopedSelector];\n          }),\n        ),\n      ).join(', ');\n    },\n  };\n}\n\n(createOpenXiangdaNamespaceCssPlugin as any).postcss = true;\n\nexport const createNamespaceCssPlugin = createOpenXiangdaNamespaceCssPlugin;\n"],"mappings":";AAqCO,SAAS,yBAAuD,QAAc;AACnF,SAAO;AACT;AAEA,IAAM,2BAA2B;AAEjC,SAAS,kBAAkB,UAAkB;AAC3C,QAAM,YAAsB,CAAC;AAC7B,MAAI,QAAQ;AACZ,MAAI,QAAQ;AACZ,MAAI,UAAU;AACd,aAAW,QAAQ,UAAU;AAC3B,QAAI,OAAO;AACT,iBAAW;AACX,UAAI,SAAS,MAAO,SAAQ;AAC5B;AAAA,IACF;AACA,QAAI,SAAS,OAAO,SAAS,KAAK;AAChC,cAAQ;AACR,iBAAW;AACX;AAAA,IACF;AACA,QAAI,SAAS,OAAO,SAAS,IAAK,UAAS;AAC3C,QAAI,SAAS,OAAO,SAAS,IAAK,UAAS;AAC3C,QAAI,SAAS,OAAO,UAAU,GAAG;AAC/B,gBAAU,KAAK,QAAQ,KAAK,CAAC;AAC7B,gBAAU;AACV;AAAA,IACF;AACA,eAAW;AAAA,EACb;AACA,MAAI,QAAQ,KAAK,EAAG,WAAU,KAAK,QAAQ,KAAK,CAAC;AACjD,SAAO;AACT;AAEA,SAAS,oBAAoB,UAAkB,QAAgB;AAC7D,MAAI,CAAC,YAAY,SAAS,SAAS,MAAM,EAAG,QAAO;AACnD,MAAI,gCAAgC,KAAK,QAAQ,EAAG,QAAO;AAC3D,MAAI,wBAAwB,KAAK,QAAQ,EAAG,QAAO;AACnD,MAAI,+BAA+B,KAAK,QAAQ,EAAG,QAAO;AAC1D,SAAO;AACT;AAEA,SAAS,wBAAwB,UAAkB;AACjD,QAAM,UAAU,SACb,QAAQ,6BAA6B,YAAY,EACjD,QAAQ,iCAAiC,gBAAgB,EACzD,QAAQ,oDAAoD,eAAe;AAC9E,SAAO,YAAY,WAAW,OAAO;AACvC;AAEO,SAAS,oCACd,SAAS,0BACT;AACA,SAAO;AAAA,IACL,eAAe;AAAA,IACf,KAAK,MAA2C;AAC9C,UAAI,CAAC,KAAK,SAAU;AACpB,UAAI,SAAS,KAAK;AAClB,aAAO,QAAQ;AACb,YAAI,OAAO,SAAS,YAAY,cAAc,KAAK,OAAO,IAAI,GAAG;AAC/D;AAAA,QACF;AACA,iBAAS,OAAO;AAAA,MAClB;AACA,WAAK,WAAW,MAAM;AAAA,QACpB,IAAI;AAAA,UACF,kBAAkB,KAAK,QAAQ,EAAE,QAAQ,CAAC,aAAa;AACrD,kBAAM,iBAAiB,oBAAoB,UAAU,MAAM,IACvD,WACA,GAAG,MAAM,IAAI,QAAQ;AACzB,kBAAM,YAAY,wBAAwB,cAAc;AACxD,mBAAO,YAAY,CAAC,gBAAgB,SAAS,IAAI,CAAC,cAAc;AAAA,UAClE,CAAC;AAAA,QACH;AAAA,MACF,EAAE,KAAK,IAAI;AAAA,IACb;AAAA,EACF;AACF;AAEC,oCAA4C,UAAU;AAEhD,IAAM,2BAA2B;","names":[]}

package/packages/sdk/src/build-source/scripts/publish-all.mjs

@@ -10,7 +10,7 @@ import { createRequire } from "node:module";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import minimist from "minimist";
-import { rootDir } from "./utils/load-config.mjs";
+import { loadConfig, rootDir } from "./utils/load-config.mjs";
 import {
   discoverWorkspaceModules,
   commitIncrementalPublish,
@@ -55,6 +55,7 @@ publish-all - 同步、构建、上传并注册应用工作区产物
   --changed        只发布 git 变更触达的 src/forms/* 和 src/pages/*
   --since <ref>    配合 --changed 使用，默认 HEAD
   --force          忽略增量缓存，强制发布
+  --legacy-form-bundle  React SPA 下仍发布旧表单 bundle 到 OSS
   --help, -h       显示帮助信息
 `);
   process.exit(0);
@@ -137,6 +138,11 @@ function run(script, scriptArgs = []) {
 
 const maybeDryRun = dryRun ? ["--dry-run"] : [];
 const maybeForce = force ? ["--force"] : [];
+const config = await loadConfig();
+const publishLegacyFormBundle =
+  config.runtimeMode !== "react-spa" ||
+  Boolean(args["legacy-form-bundle"]) ||
+  Boolean(config.forms?.publishLegacyBundle);
 
 const allModules = discoverWorkspaceModules();
 const plan = planIncrementalPublish(allModules, { force, only });
@@ -155,9 +161,18 @@ const publishedModules = [];
 for (const moduleItem of plan.changed) {
   if (moduleItem.kind === "forms") {
     await run("sync-schema.mjs", ["--form", moduleItem.name, ...maybeDryRun]);
-    await run("build-forms.mjs", ["--form", moduleItem.name, ...maybeForce]);
-    await run("publish-oss.mjs", ["--form", moduleItem.name, ...maybeDryRun]);
-    await run("register.mjs", ["--form", moduleItem.name, ...maybeDryRun]);
+    if (publishLegacyFormBundle) {
+      await run("build-forms.mjs", ["--form", moduleItem.name, ...maybeForce]);
+      await run("publish-oss.mjs", ["--form", moduleItem.name, ...maybeDryRun]);
+      await run("register.mjs", ["--form", moduleItem.name, ...maybeDryRun]);
+    } else {
+      console.log(
+        `[publish] React SPA 表单 ${moduleItem.name}: 已同步 schema，跳过旧表单 bundle/OSS/register。`,
+      );
+      console.log(
+        "[publish] 如需兼容旧表单页面 bundle，请传 --legacy-form-bundle 或配置 forms.publishLegacyBundle=true。",
+      );
+    }
     publishedModules.push(moduleItem);
   } else if (moduleItem.kind === "pages") {
     await run("build-pages.mjs", ["--page", moduleItem.name, ...maybeForce]);

package/packages/sdk/src/build-source/scripts/utils/load-config.mjs

@@ -121,6 +121,11 @@ function normalizeCssIsolation(value) {
   return "none";
 }
 
+function normalizeRuntimeMode(value) {
+  if (value === "react-spa" || value === "spa") return "react-spa";
+  return value === "legacy" ? "legacy" : "";
+}
+
 export function resolveOpenXiangdaEndpointConfig(baseUrl) {
   const raw = normalizeBaseUrl(baseUrl);
   if (!raw) {
@@ -174,6 +179,11 @@ export async function loadConfig() {
     ...source,
     appType: process.env.OPENXIANGDA_APP_TYPE || source.appType || process.env.APP_TYPE,
     appName: source.appName || process.env.APP_NAME || "低代码应用",
+    runtimeMode: normalizeRuntimeMode(
+      process.env.OPENXIANGDA_RUNTIME_MODE ||
+        process.env.APP_RUNTIME_MODE ||
+        source.runtimeMode,
+    ),
     platformUrl,
     servicePrefix:
       openXiangdaEndpoint?.servicePrefix ??

package/templates/openxiangda-react-spa/app-workspace.config.ts

@@ -3,6 +3,7 @@ import { defineAppWorkspaceConfig } from "openxiangda/build";
 export default defineAppWorkspaceConfig({
   appType: process.env.APP_TYPE || process.env.OPENXIANGDA_APP_TYPE || "APP_XXXXXXXXXXXXXXXX",
   appName: process.env.APP_NAME || "OpenXiangda React SPA",
+  runtimeMode: "react-spa",
   platformUrl:
     process.env.APP_PLATFORM_URL ||
     process.env.OPENXIANGDA_BASE_URL ||

package/templates/sy-lowcode-app-workspace/src/types/app-workspace.types.ts

@@ -1,6 +1,7 @@
 export interface AppWorkspaceConfig {
   appType: string;
   appName: string;
+  runtimeMode?: "legacy" | "react-spa";
   platformUrl: string;
   servicePrefix: string;
   appKey: string;
@@ -24,6 +25,10 @@ export interface AppWorkspaceConfig {
     pageMenuParentId: string;
     pageMenuIcon: string;
   };
+  forms?: {
+    dir?: string;
+    publishLegacyBundle?: boolean;
+  };
 }
 
 export type CustomPageEntryMode = "app-shell" | "plain-page";