chore: import upstream snapshot with attribution

packages/plugins/materials-plugin/eslint.config.js

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+const { defineFlatConfig } = require('@flowgram.ai/eslint-config');
+
+module.exports = defineFlatConfig({
+  preset: 'web',
+  packageRoot: __dirname,
+});

packages/plugins/materials-plugin/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@flowgram.ai/materials-plugin",
+  "version": "0.1.8",
+  "homepage": "https://flowgram.ai/",
+  "repository": "https://github.com/bytedance/flowgram.ai",
+  "license": "MIT",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/esm/index.js",
+    "require": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run build:fast -- --dts-resolve",
+    "build:fast": "tsup src/index.ts --format cjs,esm --sourcemap --legacy-output",
+    "build:watch": "npm run build:fast -- --dts-resolve",
+    "clean": "rimraf dist",
+    "test": "exit 0",
+    "test:cov": "exit 0",
+    "ts-check": "tsc --noEmit",
+    "watch": "npm run build:fast -- --dts-resolve --watch --ignore-watch dist"
+  },
+  "dependencies": {
+    "@flowgram.ai/core": "workspace:*",
+    "@flowgram.ai/renderer": "workspace:*",
+    "inversify": "^6.0.1",
+    "reflect-metadata": "~0.2.2"
+  },
+  "devDependencies": {
+    "@flowgram.ai/eslint-config": "workspace:*",
+    "@flowgram.ai/ts-config": "workspace:*",
+    "@types/bezier-js": "4.1.3",
+    "@types/lodash-es": "^4.17.12",
+    "@types/react": "^18",
+    "@types/react-dom": "^18",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.0.0",
+    "react": "^18",
+    "react-dom": "^18",
+    "tsup": "^8.0.1",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "react": ">=16.8",
+    "react-dom": ">=16.8"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

packages/plugins/materials-plugin/src/create-materials-plugin.ts

@@ -0,0 +1,66 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import React from 'react';
+
+import { FlowRendererKey, FlowRendererRegistry } from '@flowgram.ai/renderer';
+import { definePluginCreator } from '@flowgram.ai/core';
+
+export type MaterialReactComponent<T = any> = (props: T) => React.ReactNode | null;
+
+export interface MaterialsPluginOptions {
+  /**
+   * 注册特定的 UI 组件
+   */
+  components?: Record<FlowRendererKey | string, MaterialReactComponent>;
+  /**
+   * 注册特定的节点渲染组件
+   */
+  renderNodes?: Record<string, MaterialReactComponent>;
+  /**
+   * 默认节点渲染
+   */
+  renderDefaultNode?: MaterialReactComponent;
+  /**
+   * 注册渲染的文字
+   */
+  renderTexts?: Record<string, string>;
+}
+
+export const createMaterialsPlugin = definePluginCreator<MaterialsPluginOptions>({
+  onInit(ctx, opts) {
+    const registry = ctx.get<FlowRendererRegistry>(FlowRendererRegistry);
+    /**
+     * 注册默认节点渲染
+     */
+    registry.registerReactComponent(
+      FlowRendererKey.NODE_RENDER,
+      opts.renderDefaultNode || (() => null)
+    );
+
+    /**
+     * 注册文案
+     */
+    if (opts.renderTexts) {
+      registry.registerText(opts.renderTexts);
+    }
+    /**
+     * 注册组件
+     */
+    if (opts.components) {
+      Object.keys(opts.components).forEach((key) =>
+        registry.registerReactComponent(key, opts.components![key])
+      );
+    }
+    /**
+     * 注册单节点渲染
+     */
+    if (opts.renderNodes) {
+      Object.keys(opts.renderNodes).forEach((key) =>
+        registry.registerReactComponent(key, opts.renderNodes![key])
+      );
+    }
+  },
+});

packages/plugins/materials-plugin/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+export * from './create-materials-plugin';

packages/plugins/materials-plugin/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "@flowgram.ai/ts-config/tsconfig.flow.path.json",
+  "compilerOptions": {
+  },
+  "include": ["./src"],
+  "exclude": ["node_modules"]
+}

packages/plugins/materials-plugin/vitest.config.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+const path = require('path');
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  build: {
+    commonjsOptions: {
+      transformMixedEsModules: true,
+    },
+  },
+  test: {
+    globals: true,
+    mockReset: false,
+    environment: 'jsdom',
+    setupFiles: [path.resolve(__dirname, './vitest.setup.ts')],
+    include: ['**/?(*.){test,spec}.?(c|m)[jt]s?(x)'],
+    exclude: [
+      '**/__mocks__**',
+      '**/node_modules/**',
+      '**/dist/**',
+      '**/lib/**', // lib 编译结果忽略掉
+      '**/cypress/**',
+      '**/.{idea,git,cache,output,temp}/**',
+      '**/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build}.config.*',
+    ],
+  },
+});

packages/plugins/materials-plugin/vitest.setup.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import 'reflect-metadata';