openxiangda 1.0.264 → 2.0.0-alpha.2

package/templates/sy-lowcode-app-workspace/src/forms/.gitkeep

@@ -1 +0,0 @@
-

package/templates/sy-lowcode-app-workspace/src/forms/README.md

@@ -1,52 +0,0 @@
-# Forms
-
-Create form source under `src/forms/<formCode>/schema.ts`.
-
-Form-entry component priority is OpenXiangda platform fields first, `antd` / `antd-mobile` wrappers second, and custom business components only when neither fits. AI-authored workspace code must not replace platform fields with raw `<input>`, `<select>`, `<textarea>`, file inputs, hand-written pickers, or hand-written uploaders.
-
-Use `defineFormSchema` from `openxiangda` and default-export the schema:
-
-```ts
-import { defineFormSchema } from "openxiangda";
-
-export default defineFormSchema({
-  formMeta: {
-    formUuid: "",
-    appType: process.env.OPENXIANGDA_APP_TYPE || "APP_XXXX",
-    title: "客户信息",
-  },
-  fields: [
-    {
-      fieldId: "customer_name",
-      componentName: "TextField",
-      label: "客户名称",
-      required: true,
-      rules: [{ required: true, message: "请填写客户名称" }],
-    },
-  ],
-});
-```
-
-Important: top-level `schema.rules` is for dynamic effects with `when` and `then`, not validation. Put validation on field-level `rules`.
-
-Option components must always include an `options` array. For `SelectField`, `MultiSelectField`, `RadioField`, `CheckboxField`, and `CascadeSelectField`, use `options: []` when values will be wired later; omitting `options` can crash the runtime with `Cannot read properties of undefined (reading 'map')`.
-
-For generated apps with many forms, prefer the safe helper in `src/shared/form-schema.ts`:
-
-```ts
-import { createFormSchema } from "../../shared/form-schema";
-
-export default createFormSchema({
-  formMeta: {
-    formUuid: "",
-    appType: process.env.OPENXIANGDA_APP_TYPE || "APP_XXXX",
-    title: "客户信息",
-  },
-  fields: [{ fieldId: "customer_name", componentName: "TextField", label: "客户名称", required: true }],
-});
-```
-
-The helper adds field-level required validation and never emits top-level validation rules.
-It also normalizes option components without `options` to `options: []` as a runtime guard.
-
-If a real business need exposes a missing platform field capability, report it with `openxiangda feedback submit --yes` and then use an `antd` / `antd-mobile` wrapper as a temporary workaround.

package/templates/sy-lowcode-app-workspace/src/index.css

@@ -1,26 +0,0 @@
-@layer tailwind-base {
-  @tailwind base;
-}
-
-@tailwind components;
-@tailwind utilities;
-
-* {
-  box-sizing: border-box;
-}
-
-body {
-  margin: 0;
-  min-width: 320px;
-  background: #f8fafc;
-  color: #0f172a;
-  font-family:
-    -apple-system,
-    BlinkMacSystemFont,
-    "Segoe UI",
-    sans-serif;
-}
-
-#root {
-  min-height: 100dvh;
-}

package/templates/sy-lowcode-app-workspace/src/js-code-nodes/.gitkeep

@@ -1 +0,0 @@
-

package/templates/sy-lowcode-app-workspace/src/js-code-nodes/types.d.ts

@@ -1,3 +0,0 @@
-declare const platform: {
-  api: (path: string, options?: Record<string, unknown>) => Promise<unknown>;
-};

package/templates/sy-lowcode-app-workspace/src/main.tsx

@@ -1,29 +0,0 @@
-import { StrictMode } from "react";
-import { createRoot } from "react-dom/client";
-import { StyleProvider } from "@ant-design/cssinjs";
-import { App as AntdApp, ConfigProvider } from "antd";
-import zhCN from "antd/locale/zh_CN";
-import dayjs from "dayjs";
-import "dayjs/locale/zh-cn";
-import "antd-mobile/es/global";
-import { antdTheme } from "openxiangda/antd-theme";
-
-import App from "./dev/App";
-import "./index.css";
-
-dayjs.locale("zh-cn");
-
-createRoot(document.getElementById("root")!).render(
-  <StrictMode>
-    <StyleProvider hashPriority="high">
-      <ConfigProvider
-        locale={zhCN}
-        theme={antdTheme}
-      >
-        <AntdApp>
-          <App />
-        </AntdApp>
-      </ConfigProvider>
-    </StyleProvider>
-  </StrictMode>,
-);

package/templates/sy-lowcode-app-workspace/src/pages/.gitkeep

@@ -1 +0,0 @@
-

package/templates/sy-lowcode-app-workspace/src/runtime/builtin-overrides.tsx

@@ -1,8 +0,0 @@
-import type { BuiltinRouteOverrides } from "openxiangda/runtime";
-
-export const runtimeRouteOverrides: BuiltinRouteOverrides = {
-  "form-submit": {},
-  "form-detail": {},
-  "process-detail": {},
-  "data-manage-list": {},
-};

package/templates/sy-lowcode-app-workspace/src/shared/form-schema.ts

@@ -1,135 +0,0 @@
-import { defineFormSchema } from "openxiangda";
-
-export type FormComponentName =
-  | "TextField"
-  | "TextAreaField"
-  | "NumberField"
-  | "DateField"
-  | "CascadeDateField"
-  | "SelectField"
-  | "MultiSelectField"
-  | "RadioField"
-  | "CheckboxField"
-  | "UserSelectField"
-  | "DepartmentSelectField"
-  | "AttachmentField"
-  | "ImageField"
-  | "AddressField"
-  | "CascadeSelectField"
-  | "LocationField"
-  | "EditorField"
-  | "JSONField"
-  | "SubFormField";
-
-export type FormOption = {
-  label: string;
-  value: string;
-  color?: string;
-  disabled?: boolean;
-};
-
-export type FieldDefinition = {
-  fieldId: string;
-  componentName: FormComponentName;
-  label: string;
-  required?: boolean;
-  behavior?: "NORMAL" | "READONLY" | "DISABLED" | "HIDDEN";
-  rules?: Array<{
-    required?: boolean;
-    message?: string;
-    min?: number;
-    max?: number;
-    minLength?: number;
-    maxLength?: number;
-    preset?: "phone" | "idCard" | "email" | "url" | "bankCard";
-    pattern?: RegExp | string;
-  }>;
-  placeholder?: string;
-  tips?: string;
-  options?: FormOption[];
-  defaultValue?: unknown;
-  columns?: FieldDefinition[];
-  [key: string]: unknown;
-};
-
-export type OpenXiangdaFormSchemaInput = {
-  formMeta: {
-    formUuid: string;
-    appType: string;
-    title: string;
-    formType?: "receipt" | "process";
-  };
-  fields: FieldDefinition[];
-  template?: Record<string, unknown>;
-};
-
-export function option(value: string, label = value): FormOption {
-  return { label, value };
-}
-
-export function options(values: string[]): FormOption[] {
-  return values.map((value) => option(value));
-}
-
-export function createFormSchema(input: OpenXiangdaFormSchemaInput) {
-  return defineFormSchema({
-    formMeta: input.formMeta,
-    template: {
-      ...(input.template || {}),
-      ...(input.formMeta.formType === "process" ? { formType: "process" } : {}),
-    },
-    fields: input.fields.map(normalizeField),
-    layout: input.fields.map((field) => ({
-      id: `layout_${field.fieldId}`,
-      type: "field" as const,
-      fieldId: field.fieldId,
-    })),
-  });
-}
-
-function normalizeField(field: FieldDefinition): FieldDefinition {
-  return {
-    ...field,
-    options:
-      needsOptionsArray(field.componentName) && !Array.isArray(field.options)
-        ? []
-        : field.options,
-    columns: field.columns?.map(normalizeField),
-    rules:
-      field.rules ||
-      (field.required
-        ? [
-            {
-              required: true,
-              message: `${needsSelectVerb(field.componentName) ? "请选择" : "请填写"}${field.label}`,
-            },
-          ]
-        : undefined),
-  };
-}
-
-function needsOptionsArray(componentName: FormComponentName): boolean {
-  return [
-    "SelectField",
-    "MultiSelectField",
-    "RadioField",
-    "CheckboxField",
-    "CascadeSelectField",
-  ].includes(componentName);
-}
-
-function needsSelectVerb(componentName: FormComponentName): boolean {
-  return [
-    "SelectField",
-    "MultiSelectField",
-    "RadioField",
-    "CheckboxField",
-    "UserSelectField",
-    "DepartmentSelectField",
-    "DateField",
-    "CascadeDateField",
-    "CascadeSelectField",
-    "ImageField",
-    "AttachmentField",
-  ].includes(componentName);
-}

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

@@ -1,88 +0,0 @@
-export interface AppWorkspaceConfig {
-  deliveryVersion: 2;
-  appType: string;
-  appName: string;
-  runtimeMode?: "legacy" | "react-spa";
-  platformUrl: string;
-  servicePrefix: string;
-  appKey: string;
-  appSecret: string;
-  userId: string;
-  version: string;
-  buildId: string;
-  oss: {
-    region: string;
-    bucket: string;
-    accessKeyId: string;
-    accessKeySecret: string;
-    pathPrefix: string;
-  };
-  defaults: {
-    protocolVersion: string;
-    frameworkVersion: string;
-    cssIsolation: "namespace" | "shadow" | "none";
-    formMenuParentId: string;
-    formMenuIcon: string;
-    pageMenuParentId: string;
-    pageMenuIcon: string;
-  };
-  forms?: {
-    dir?: string;
-    publishLegacyBundle?: boolean;
-  };
-  compatibility?: {
-    apiContracts?: "strict" | "legacy";
-    legacyFallbacks?: boolean;
-    requestTrace?: boolean;
-  };
-  governance?: {
-    sdd?: {
-      enabled?: boolean;
-      strictHighRisk?: boolean;
-      strictDocumentation?: boolean;
-      documentationMode?: 'structured' | 'full';
-      path?: string;
-      schemaVersion?: "openxiangda-sdd-v2" | string;
-    };
-  };
-}
-
-export type CustomPageEntryMode = "app-shell" | "plain-page";
-
-export interface CustomPageEntryConfig {
-  mode?: CustomPageEntryMode | string;
-  hidePlatformNav?: boolean;
-  defaultRoute?: string;
-}
-
-export interface CustomPageConfig {
-  code: string;
-  name: string;
-  description?: string;
-  publish?: boolean;
-  route?: {
-    pathKey?: string;
-    allowQueryKeys?: string[];
-    allowHash?: boolean;
-    subRouteMode?: "hash" | "memory" | string;
-    defaultQuery?: Record<string, unknown>;
-  };
-  entry?: CustomPageEntryConfig;
-  props?: Record<string, unknown>;
-  dataSources?: Array<Record<string, unknown>>;
-  menu?: {
-    enabled?: boolean;
-    name?: string;
-    parentId?: string | null;
-    icon?: string | null;
-  };
-  cssIsolation?: "namespace" | "shadow" | "none";
-}
-
-export function defineAppWorkspaceConfig<T extends AppWorkspaceConfig>(config: T): T {
-  return config;
-}
-
-export function definePageConfig<T extends CustomPageConfig>(config: T): T {
-  return config;
-}

package/templates/sy-lowcode-app-workspace/tailwind.config.cjs

@@ -1,31 +0,0 @@
-const openxiangdaPath = require("node:path");
-const openxiangdaPresetModule = require("openxiangda/tailwind-preset");
-const openxiangdaPreset =
-  openxiangdaPresetModule.default ?? openxiangdaPresetModule;
-
-function resolveOpenXiangdaContent() {
-  try {
-    const packagePath = require.resolve("openxiangda");
-    const distDir = openxiangdaPath.dirname(packagePath);
-    return [openxiangdaPath.join(distDir, "..", "**/*.{js,mjs,cjs}")];
-  } catch {
-    return [];
-  }
-}
-
-const openxiangdaContent = resolveOpenXiangdaContent();
-
-/** @type {import('tailwindcss').Config} */
-module.exports = {
-  content: [
-    "./index.html",
-    "./src/**/*.{js,ts,jsx,tsx}",
-    ...openxiangdaContent,
-  ],
-  blocklist: ["[-:T]", "[-:TZ.]"],
-  presets: [openxiangdaPreset],
-  theme: {
-    extend: {},
-  },
-  plugins: [],
-};

package/templates/sy-lowcode-app-workspace/tsconfig.app.json

@@ -1,40 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "useDefineForClassFields": true,
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "allowJs": false,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "strict": true,
-    "forceConsistentCasingInFileNames": true,
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["src/*"],
-      "openxiangda": [
-        "../../packages/sdk/src/components/index.ts",
-        "node_modules/openxiangda"
-      ],
-      "openxiangda/runtime": [
-        "../../packages/sdk/src/runtime/index.ts",
-        "node_modules/openxiangda/runtime"
-      ],
-      "openxiangda/build": [
-        "../../packages/sdk/src/build/index.ts",
-        "node_modules/openxiangda/build"
-      ],
-      "openxiangda/antd-theme": [
-        "../../packages/sdk/src/styles/antd-theme.ts",
-        "node_modules/openxiangda/antd-theme"
-      ]
-    }
-  },
-  "include": ["src", "app-workspace.config.ts", "vite.config.ts"]
-}

package/templates/sy-lowcode-app-workspace/tsconfig.examples.json

@@ -1,24 +0,0 @@
-{
-  "extends": "./tsconfig.app.json",
-  "compilerOptions": {
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["examples/best-practices/src/*", "src/*"],
-      "openxiangda": [
-        "../../packages/sdk/src/components/index.ts",
-        "node_modules/openxiangda"
-      ],
-      "openxiangda/runtime": [
-        "../../packages/sdk/src/runtime/index.ts",
-        "node_modules/openxiangda/runtime"
-      ]
-    }
-  },
-  "include": [
-    "examples/best-practices/src/**/*.ts",
-    "examples/best-practices/src/**/*.tsx",
-    "examples/best-practices/**/*.json",
-    "src/types/**/*.ts",
-    "src/shared/form-schema.ts"
-  ]
-}

package/templates/sy-lowcode-app-workspace/tsconfig.js-code-nodes.json

@@ -1,19 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "strict": true,
-    "skipLibCheck": true,
-    "types": ["node"],
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["src/*"]
-    }
-  },
-  "include": [
-    "src/js-code-nodes/**/*.ts",
-    "src/automations/**/*.ts",
-    "src/functions/**/*.ts"
-  ]
-}

package/templates/sy-lowcode-app-workspace/tsconfig.json

@@ -1,7 +0,0 @@
-{
-  "files": [],
-  "references": [
-    { "path": "./tsconfig.app.json" },
-    { "path": "./tsconfig.node.json" }
-  ]
-}

package/templates/sy-lowcode-app-workspace/tsconfig.node.json

@@ -1,10 +0,0 @@
-{
-  "compilerOptions": {
-    "composite": true,
-    "skipLibCheck": true,
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "allowSyntheticDefaultImports": true
-  },
-  "include": ["vite.config.ts"]
-}

package/templates/sy-lowcode-app-workspace/vite.config.ts

@@ -1,85 +0,0 @@
-import react from "@vitejs/plugin-react";
-import { fileURLToPath } from "node:url";
-import { defineConfig, loadEnv } from "vite";
-
-const resolveProxyTarget = (value?: string) => {
-  const normalized = String(value || "").trim();
-  if (!normalized) return "";
-  try {
-    const url = new URL(normalized);
-    return url.origin;
-  } catch {
-    return "";
-  }
-};
-
-const toPort = (value?: string) => {
-  const port = Number(value || 5174);
-  return Number.isFinite(port) && port > 0 ? port : 5174;
-};
-
-export default defineConfig(({ mode }) => {
-  const env = loadEnv(mode, process.cwd(), "");
-  const serviceTarget = resolveProxyTarget(
-    env.OPENXIANGDA_BASE_URL || env.APP_PLATFORM_URL,
-  );
-  const servicePrefix = env.APP_SERVICE_PREFIX || "/service";
-
-  return {
-    define: {
-      "process.env.NODE_ENV": JSON.stringify(
-        process.env.NODE_ENV || "development",
-      ),
-      "process.env.OPENXIANGDA_APP_TYPE": JSON.stringify(
-        env.OPENXIANGDA_APP_TYPE || env.APP_TYPE || "",
-      ),
-      "process.env.APP_TYPE": JSON.stringify(
-        env.APP_TYPE || env.OPENXIANGDA_APP_TYPE || "",
-      ),
-      "process.env.OPENXIANGDA_BASE_URL": JSON.stringify(
-        env.OPENXIANGDA_BASE_URL || env.APP_PLATFORM_URL || "",
-      ),
-      "process.env.APP_PLATFORM_URL": JSON.stringify(
-        env.APP_PLATFORM_URL || env.OPENXIANGDA_BASE_URL || "",
-      ),
-      "process.env.APP_SERVICE_PREFIX": JSON.stringify(servicePrefix),
-    },
-    plugins: [react()],
-    resolve: {
-      alias: [
-        {
-          find: "@",
-          replacement: fileURLToPath(new URL("./src", import.meta.url)),
-        },
-      ],
-      dedupe: [
-        "react",
-        "react-dom",
-        "antd",
-        "@ant-design/cssinjs",
-        "@ant-design/icons",
-      ],
-    },
-    optimizeDeps: {
-      include: ["antd", "@ant-design/cssinjs", "@ant-design/icons", "antd-mobile"],
-    },
-    server: {
-      host: env.OPENXIANGDA_DEV_HOST || "127.0.0.1",
-      port: toPort(env.OPENXIANGDA_DEV_PORT),
-      proxy: serviceTarget
-        ? {
-            [servicePrefix]: {
-              target: serviceTarget,
-              changeOrigin: true,
-              secure: false,
-              cookieDomainRewrite: "",
-              cookiePathRewrite: "/",
-              headers: {
-                "x-openxiangda-dev-proxy": "1",
-              },
-            },
-          }
-        : undefined,
-    },
-  };
-});

package/v2/README.md

@@ -1,35 +0,0 @@
-# OpenXiangda 2.0 toolchain
-
-This directory is the isolated OpenXiangda 2.0 package workspace. It does not
-import or dispatch the 1.x CLI implementation in `lib/cli.js`.
-
-Current packages:
-
-- `@openxiangda/contracts`: versioned wire contracts and JSON Schemas.
-- `@openxiangda/compiler`: deterministic configuration, generated contracts and AppPackage sealing.
-- `@openxiangda/devkit-core`: framework-neutral workspace, package and control-plane use cases.
-- `@openxiangda/nest`: trusted Principal/RoleSession Guard, Data API client,
-  signed CloudEvents receiver and standard backend health endpoints.
-- `@openxiangda/admin`: React + Ant Design application shell, capability-aware
-  data pages and protocol-driven Workflow v2/1.x compatibility pages.
-- `@openxiangda/testing`: permission fixtures, allow/deny matrix assertions and
-  local event record/replay/simulation.
-- `create-openxiangda`: distributable standard application workspace creator.
-- `@openxiangda/cli`: thin Oclif application-level CLI.
-- `@openxiangda/mcp`: structured AI resources and tools over the same services.
-- `@openxiangda/skill-kit`: validation, packaging and installation for the 2.0 domain skills.
-
-`templates/application` is the build-verified React 19 + NestJS 11 golden
-workspace. None of these packages imports or dispatches the 1.x CLI, so this
-toolchain can evolve without increasing the stable 1.x launcher surface.
-
-```bash
-pnpm install
-pnpm check
-pnpm test
-pnpm template:build
-pnpm skills:check
-pnpm docs:build
-```
-
-The fixed Changesets group publishes the packages as one compatible version train. See `docs/getting-started.md` for application usage and `docs/migration.md` for the strict 1.x coexistence boundary.

package/v2/skills/manifest.json

@@ -1,45 +0,0 @@
-{
-  "schemaVersion": 1,
-  "skills": [
-    {
-      "name": "openxiangda-v1-maintenance",
-      "description": "Maintain an existing stable OpenXiangda 1.x application without migrating it. Use for scoped fixes to legacy pages, forms, resources, App Function code, automation, workflow, or 1.x release records.",
-      "sha256": "7f554b8092397a0994f6aba70be38d2ec7eaf7524a075d68fb99ecbc95303525"
-    },
-    {
-      "name": "openxiangda-v2",
-      "description": "Build, inspect, validate, and deliver a complete OpenXiangda 2.0 application workspace. Use when a task spans the React frontend, NestJS backend, Data API, authorization, workflow, events, or whole-application delivery.",
-      "sha256": "5645e5cb1c18731d5b5fb21c9ad0e59b9760600794705bb4adcad1d0e316010b"
-    },
-    {
-      "name": "openxiangda-v2-architecture",
-      "description": "Design OpenXiangda 2.0 application boundaries and typed contracts. Use when creating an app, decomposing frontend and backend responsibilities, or changing Data, AuthZ, workflow, event, or deployment declarations.",
-      "sha256": "02768b17e048c623a13b9a99e5cedc72c9081eaa71b346c3d9db3ca66c95bf5e"
-    },
-    {
-      "name": "openxiangda-v2-backend",
-      "description": "Build the standard OpenXiangda 2.0 NestJS application backend. Use when implementing App APIs, Data API transactions, identity-aware business services, event consumers, health checks, or external integration endpoints.",
-      "sha256": "04c3de82f4406eaeb378910fbd53e2721c13e1cb9afbeb39f1c63f352522dd39"
-    },
-    {
-      "name": "openxiangda-v2-data-authz",
-      "description": "Design OpenXiangda 2.0 Data API and contextual authorization contracts. Use for RBAC, active-role behavior, department or record attributes, application-admin bypass, field policies, and restricted transactions.",
-      "sha256": "595fe9b8edc1e9b33720de21ed8758d4c266143c84fcb9eccc25a6adb5cce061"
-    },
-    {
-      "name": "openxiangda-v2-delivery",
-      "description": "Validate, build, deploy, observe, promote, retry, and roll back an OpenXiangda 2.0 application. Use when preparing an immutable AppPackage or changing a platform-managed environment.",
-      "sha256": "0ee0ffef78ebe37f60319bbf5684522ce61f8d6d084c360f46dc7bb2a31d1906"
-    },
-    {
-      "name": "openxiangda-v2-frontend",
-      "description": "Build OpenXiangda 2.0 React and Ant Design admin experiences. Use when implementing menus, routes, CRUD pages, role switching, workflow task pages, or application-defined action components.",
-      "sha256": "26add1dadeaf9a0a25d41163fb65cb70c1c5c7d882d57922193c3bd11d9d3e05"
-    },
-    {
-      "name": "openxiangda-v2-workflow-events",
-      "description": "Implement OpenXiangda Workflow Kernel v2 and durable application events. Use for approval definitions, assignee providers, task actions, delegation, add-sign, previews, data-change events, workflow events, or timers.",
-      "sha256": "e32a5dc84e21d32a00fbfff62a349d848b04d44a569eb4f89b390901f54bb19e"
-    }
-  ]
-}