@melt-js/libs-react-leva 0.0.0-stage → 2026.11.13

package/hel_dist/hel-meta.json

@@ -0,0 +1,70 @@
+{
+  "app": {
+    "name": "libs-react-leva",
+    "app_group_name": "libs-react-leva",
+    "git_repo_url": "",
+    "online_version": "2026.11.13",
+    "build_version": "2026.11.13",
+    "platform": "unpkg",
+    "create_at": "2026-11-13T07:51:56.018Z"
+  },
+  "version": {
+    "plugin_ver": "5.4.3",
+    "extract_mode": "build",
+    "sub_app_name": "libs-react-leva",
+    "sub_app_version": "libs-react-leva@2026.11.13",
+    "version_tag": "2026.11.13",
+    "src_map": {
+      "webDirPath": "https://unpkg.com/@melt-js/libs-react-leva@2026.11.13/hel_dist",
+      "htmlIndexSrc": "https://unpkg.com/@melt-js/libs-react-leva@2026.11.13/hel_dist/index.html",
+      "extractMode": "all",
+      "iframeSrc": "",
+      "chunkCssSrcList": [],
+      "chunkJsSrcList": [
+        "https://unpkg.com/@melt-js/libs-react-leva@2026.11.13/hel_dist/assets/index-DMdT4ab7.js"
+      ],
+      "staticCssSrcList": [],
+      "staticJsSrcList": [
+        "https://unpkg.com/react@18.3.1/umd/react.production.min.js",
+        "https://unpkg.com/react-dom@18.3.1/umd/react-dom.production.min.js"
+      ],
+      "relativeCssSrcList": [],
+      "relativeJsSrcList": [],
+      "headAssetList": [
+        {
+          "tag": "staticScript",
+          "append": false,
+          "attrs": {
+            "src": "https://unpkg.com/react@18.3.1/umd/react.production.min.js"
+          }
+        },
+        {
+          "tag": "staticScript",
+          "append": false,
+          "attrs": {
+            "src": "https://unpkg.com/react-dom@18.3.1/umd/react-dom.production.min.js"
+          }
+        },
+        {
+          "tag": "script",
+          "append": true,
+          "attrs": {
+            "src": "https://unpkg.com/@melt-js/libs-react-leva@2026.11.13/hel_dist/assets/index-DMdT4ab7.js",
+            "type": "module",
+            "crossorigin": ""
+          }
+        }
+      ],
+      "bodyAssetList": [],
+      "otherSrcList": [
+        "https://unpkg.com/@melt-js/libs-react-leva@2026.11.13/hel_dist/assets/index-DMdT4ab7.js.map",
+        "https://unpkg.com/@melt-js/libs-react-leva@2026.11.13/hel_dist/index.html"
+      ],
+      "srvModSrcList": [],
+      "srvModSrcIndex": ""
+    },
+    "html_content": "<!doctype html>\n<html lang=\"zh-CN\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>libs-react-leva</title>\n    <!--\n      react / react-dom 被 external 成全局，独立访问本页时由这里提供运行时。\n      data-helappend=\"0\"：宿主通过 hel 解析本页时跳过该脚本，改用宿主注入的那一份 react。\n    -->\n    <script\n      data-helappend=\"0\"\n      src=\"https://unpkg.com/react@18.3.1/umd/react.production.min.js\"\n    ></script>\n    <script\n      data-helappend=\"0\"\n      src=\"https://unpkg.com/react-dom@18.3.1/umd/react-dom.production.min.js\"\n    ></script>\n    <script type=\"module\" crossorigin src=\"https://unpkg.com/@melt-js/libs-react-leva@2026.11.13/hel_dist/assets/index-DMdT4ab7.js\"></script>\n  </head>\n  <body>\n    <div id=\"container\"></div>\n  </body>\n</html>\n",
+    "create_at": "2026-11-13T07:51:56.018Z",
+    "desc": "this version meta is created by hel-dev-utils@5.4.3"
+  }
+}

package/hel_dist/index.html

@@ -0,0 +1,24 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>libs-react-leva</title>
+    <!--
+      react / react-dom 被 external 成全局，独立访问本页时由这里提供运行时。
+      data-helappend="0"：宿主通过 hel 解析本页时跳过该脚本，改用宿主注入的那一份 react。
+    -->
+    <script
+      data-helappend="0"
+      src="https://unpkg.com/react@18.3.1/umd/react.production.min.js"
+    ></script>
+    <script
+      data-helappend="0"
+      src="https://unpkg.com/react-dom@18.3.1/umd/react-dom.production.min.js"
+    ></script>
+    <script type="module" crossorigin src="https://unpkg.com/@melt-js/libs-react-leva@2026.11.13/hel_dist/assets/index-DMdT4ab7.js"></script>
+  </head>
+  <body>
+    <div id="container"></div>
+  </body>
+</html>

package/hel_proxy/entry.js

@@ -0,0 +1,32 @@
+(function (global, factory) {
+	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('hel-lib-proxy')) :
+	typeof define === 'function' && define.amd ? define(['exports', 'hel-lib-proxy'], factory) :
+	(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["libs-react-leva"] = {}, global.HelLibProxy));
+})(this, (function (exports, helLibProxy) { 'use strict';
+
+	/*
+	|--------------------------------------------------------------------------
+	|
+	| 对应 package.json/appGroupName
+	|
+	|--------------------------------------------------------------------------
+	*/
+	const LIB_NAME = 'libs-react-leva';
+
+	/**
+	 * 组件类型导出文件，同时作为 rollup 打包入口：打包后是仅含 hel-lib-proxy 的空壳，
+	 * 真正的组件在运行时由 hel 通过 hel_dist 载入。
+	 */
+	const lib = helLibProxy.exposeLib(LIB_NAME);
+	const PropsPanel = lib.PropsPanel;
+	const PropsPlayground = lib.PropsPlayground;
+
+	exports.PropsPanel = PropsPanel;
+	exports.PropsPlayground = PropsPlayground;
+	exports.default = lib;
+	exports.lib = lib;
+
+	Object.defineProperty(exports, '__esModule', { value: true });
+
+}));
+//# sourceMappingURL=entry.js.map

package/hel_proxy/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sources":["../src/configs/file:/E:/work-microhel/libs-react-leva/src/configs/subApp.ts","../src/entrance/file:/E:/work-microhel/libs-react-leva/src/entrance/libTypes.ts"],"sourcesContent":[null,null],"names":["exposeLib"],"mappings":";;;;;;CAAA;;;;;;CAME;CACK,MAAM,QAAQ,GAAG,iBAAiB;;CCHzC;;;CAGG;OACU,GAAG,GAAGA,qBAAS,CAAgB,QAAQ;AAE7C,OAAM,UAAU,GAAG,GAAG,CAAC;AACvB,OAAM,eAAe,GAAG,GAAG,CAAC;;;;;;;;;"}

package/hel_proxy_es/entry.js

@@ -0,0 +1,21 @@
+import { exposeLib } from 'hel-lib-proxy';
+
+/*
+|--------------------------------------------------------------------------
+|
+| 对应 package.json/appGroupName
+|
+|--------------------------------------------------------------------------
+*/
+const LIB_NAME = 'libs-react-leva';
+
+/**
+ * 组件类型导出文件，同时作为 rollup 打包入口：打包后是仅含 hel-lib-proxy 的空壳，
+ * 真正的组件在运行时由 hel 通过 hel_dist 载入。
+ */
+const lib = exposeLib(LIB_NAME);
+const PropsPanel = lib.PropsPanel;
+const PropsPlayground = lib.PropsPlayground;
+
+export { PropsPanel, PropsPlayground, lib as default, lib };
+//# sourceMappingURL=entry.js.map

package/hel_proxy_es/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sources":["../src/configs/file:/E:/work-microhel/libs-react-leva/src/configs/subApp.ts","../src/entrance/file:/E:/work-microhel/libs-react-leva/src/entrance/libTypes.ts"],"sourcesContent":[null,null],"names":[],"mappings":";;AAAA;;;;;;AAME;AACK,MAAM,QAAQ,GAAG,iBAAiB;;ACHzC;;;AAGG;MACU,GAAG,GAAG,SAAS,CAAgB,QAAQ;AAE7C,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,eAAe,GAAG,GAAG,CAAC;;"}

package/package.json

@@ -1,6 +1,79 @@
 {
   "name": "@melt-js/libs-react-leva",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "appGroupName": "libs-react-leva",
+  "version": "2026.11.13",
+  "description": "React 属性面板（Leva）：PropsPanel / PropsPlayground 远程包 + react-docgen-typescript schema 生成 CLI",
+  "main": "hel_proxy/entry.js",
+  "module": "hel_proxy_es/entry.js",
+  "types": "src/entrance/libTypes.ts",
+  "unpkg": "hel_dist/index.html",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org",
+    "tag": "latest"
+  },
+  "files": [
+    "hel_dist",
+    "hel_proxy",
+    "hel_proxy_es",
+    "scripts",
+    "src",
+    "README.md"
+  ],
+  "bin": {
+    "react-leva-gen-schema": "./scripts/gen-schema.mjs"
+  },
+  "dependencies": {
+    "hel-iso": "4.4.0",
+    "hel-lib-proxy": "4.12.3",
+    "leva": "0.10.1",
+    "react-docgen-typescript": "2.4.0"
+  },
+  "peerDependencies": {
+    "hel-lib-proxy": "4.12.3",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-is": "18.3.1",
+    "typescript": ">=4.3.x"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "12.3.1",
+    "@types/node": "20.19.43",
+    "@types/react": "18.3.31",
+    "@types/react-dom": "18.3.7",
+    "@vitejs/plugin-react": "^4.3.4",
+    "cross-env": "7.0.3",
+    "hel-dev-utils": "5.4.3",
+    "rollup": "4.67.5",
+    "tslib": "2.9.1",
+    "typescript": "5.9.3",
+    "vite": "6.4.5",
+    "vitest": "5.1.0"
+  },
+  "engines": {
+    "node": ">=18.12.1"
+  },
+  "browserslist": [
+    "defaults",
+    "not dead",
+    "not IE 11",
+    "chrome 72"
+  ],
+  "scripts": {
+    "dev": "vite --host 127.0.0.1 --port 10050",
+    "start": "vite --host 127.0.0.1 --port 10050",
+    "build": "pnpm run check_name && pnpm run build_dist && pnpm run build_meta && pnpm run build_proxy",
+    "publish:stage": "pnpm run build && node ../scripts/publish-stage.mjs",
+    "build:local": "cross-env HEL_APP_HOME_PAGE=http://localhost:10050 pnpm run build",
+    "build_dist": "vite build",
+    "build_meta": "node scripts/meta.mjs",
+    "build_proxy": "pnpm run build_proxy_umd && pnpm run build_proxy_es",
+    "build_proxy_umd": "rollup -c",
+    "build_proxy_es": "cross-env BUILD_ENV=es rollup -c",
+    "check_name": "node scripts/check.mjs",
+    "preview": "vite preview --host 127.0.0.1 --port 10050",
+    "gen:schema": "react-leva-gen-schema",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }

package/scripts/check.mjs

@@ -0,0 +1,18 @@
+/*
+|--------------------------------------------------------------------------
+|
+| 此脚本在流水线上被触发，校验组名是否和应用里的组名保持一致
+|
+|--------------------------------------------------------------------------
+*/
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createRequire } from 'node:module'
+import helDevUtils from 'hel-dev-utils'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const require = createRequire(import.meta.url)
+const pkg = require('../package.json')
+
+const fileFullPath = path.join(__dirname, '../src/configs/subApp')
+helDevUtils.check(pkg, { fileFullPath, checkEnv: false })

package/scripts/gen-schema.mjs

@@ -0,0 +1,305 @@
+#!/usr/bin/env node
+/*
+|--------------------------------------------------------------------------
+|
+| 用 react-docgen-typescript 解析 React 组件的 TS props，生成和组件放在一起的
+| propsSchema.json（形状与 @melt-js/libs-vue3-leva 产出的 schema 同构）。
+|
+| 用法：
+|   react-leva-gen-schema                 读取当前目录的 playground.config.mjs
+|   react-leva-gen-schema --check         只校验，schema 与源码不一致时退出码 1
+|   react-leva-gen-schema --config a.mjs --root ../comps-react
+|
+| 约定：
+| - 组件 props 用 interface / type 声明，JSDoc 写在属性上方作为 description
+| - index.tsx 的 schema 写到同目录 propsSchema.json，单文件组件写 Foo.propsSchema.json
+| - 字符串字面量联合（'a' | 'b'）生成下拉 options；min / max / step 等走 hints 覆盖
+|
+|--------------------------------------------------------------------------
+*/
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { createRequire } from 'node:module'
+import { pathToFileURL } from 'node:url'
+
+const require = createRequire(import.meta.url)
+const docgen = require('react-docgen-typescript')
+
+const SCALAR_TYPES = ['boolean', 'number', 'string']
+const DEFAULT_CONFIG = 'playground.config.mjs'
+const COMPONENT_DIR = 'src/components'
+
+const HELP = `
+用法: react-leva-gen-schema [options]
+
+  --config <file>   配置文件，默认 playground.config.mjs
+  --root <dir>      组件源码根目录，默认当前目录
+  --check           只校验 schema 是否和源码一致（CI 用），不写文件
+  --silence        不打印每个组件的生成结果
+  -h, --help       显示帮助
+
+配置文件（ESM）示例：
+  export default {
+    components: [
+      { name: 'HelloButton', file: 'src/components/HelloButton.tsx' },
+    ],
+    hints: { HelloButton: { size: { min: 12, max: 48, step: 1 } } },
+  }
+`
+
+function parseArgv(argv) {
+  const options = { check: false, silence: false, config: DEFAULT_CONFIG, root: '' }
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    if (arg === '--check') options.check = true
+    else if (arg === '--silence') options.silence = true
+    else if (arg === '--config') options.config = argv[(i += 1)]
+    else if (arg === '--root') options.root = argv[(i += 1)]
+    else if (arg === '-h' || arg === '--help') options.help = true
+    else throw new Error(`[props-schema] 未知参数: ${arg}`)
+  }
+  return options
+}
+
+function toPosix(file) {
+  return file.split(path.sep).join('/')
+}
+
+/** 归一出可绑定的标量类型；拿不到标量返回空串 */
+function baseType(type) {
+  if (!type) return ''
+  const name = type.name || ''
+  const raw = type.raw || ''
+  if (SCALAR_TYPES.includes(name)) return name
+  if (name === 'union') {
+    const parts = (type.value || [])
+      .map((v) => String(v?.value ?? v?.name ?? '').trim())
+      .filter(Boolean)
+    // 字面量联合（'wheel' | 'fan'）当成 string，面板上用下拉
+    if (parts.length > 1 && parts.every((p) => /^(['"]).*\1$/.test(p))) return 'string'
+    const scalar = SCALAR_TYPES.find((s) => parts.includes(s))
+    return scalar || ''
+  }
+  if (name === 'enum') return 'string'
+  if (name === 'arrayOf' || /\[\]$/.test(raw)) return 'array'
+  if (/^object$/i.test(name) || /^record</i.test(raw)) return 'object'
+  return ''
+}
+
+// 把 'wheel' | 'fan' 拆成 Leva 的 options: { wheel: 'wheel', fan: 'fan' }
+// docgen 里字面量联合的 type.name 可能是 'union' 或 'enum'，两种都兼容
+function literalOptions(type) {
+  if (!type || (type.name !== 'union' && type.name !== 'enum')) return null
+  const parts = (type.value || [])
+    .map((v) => String(v?.value ?? v?.name ?? '').trim())
+    .filter(Boolean)
+  if (parts.length < 2 || !parts.every((p) => /^(['"]).*\1$/.test(p))) return null
+  return parts.reduce((options, part) => {
+    const value = part.slice(1, -1)
+    options[value] = value
+    return options
+  }, {})
+}
+
+// docgen 的 default 是源码表达式（字符串会带引号），这里转成面板初始值
+function parseString(raw) {
+  if (!raw) return ''
+  try {
+    return JSON.parse(raw)
+  } catch (error) {
+    const quoted =
+      raw.length > 1 && (raw[0] === '"' || raw[0] === "'") && raw[raw.length - 1] === raw[0]
+    return quoted ? raw.slice(1, -1) : raw
+  }
+}
+
+function defaultValue(type, raw) {
+  if (raw === undefined || raw === null || raw === '') return undefined
+  if (type === 'boolean') return raw === 'true'
+  if (type === 'number') {
+    const value = Number(raw)
+    return Number.isFinite(value) ? value : 0
+  }
+  if (type === 'string') return parseString(raw)
+  return undefined
+}
+
+// index.tsx 放同目录的 propsSchema.json；单文件组件放 Foo.propsSchema.json
+function schemaRelPath(file) {
+  if (/\/index\.(tsx|ts|jsx|js)$/.test(file)) return file.replace(/index\.(tsx|ts|jsx|js)$/, 'propsSchema.json')
+  return file.replace(/\.(tsx|ts|jsx|js)$/, '.propsSchema.json')
+}
+
+// 沿用已有文件的换行符（Windows 检出是 CRLF），避免只因为 EOL 产生 diff
+function eolOf(filePath) {
+  if (!fs.existsSync(filePath)) return os.EOL
+  const text = fs.readFileSync(filePath, 'utf8')
+  return text.includes('\r\n') ? '\r\n' : '\n'
+}
+
+function toSchemaProp(prop, hint) {
+  const type = baseType(prop.type)
+  const rawDefault = prop.defaultValue && !prop.defaultValue.computed ? prop.defaultValue.value : ''
+  const typeName = (prop.type && prop.type.name) || ''
+  // 事件回调：onXxx 命名，或类型是函数签名（docgen 会把箭头函数类型串进 name）
+  const isFunction = typeName === 'function' || /=>/.test(typeName)
+  const item = {
+    name: prop.name,
+    type: (prop.type && (prop.type.raw || prop.type.name)) || type,
+    description: prop.description || prop.name,
+    default: rawDefault || '',
+    required: Boolean(prop.required),
+    version: '',
+    isEvent: /^on[A-Z]/.test(prop.name) || isFunction,
+    bindable: SCALAR_TYPES.includes(type),
+  }
+  if (item.bindable) item.value = defaultValue(type, rawDefault)
+  if (hint) {
+    item.control = { ...hint }
+  } else if (item.bindable) {
+    // 字面量联合默认做成下拉，config 里的 hints 可以覆盖
+    const options = literalOptions(prop.type)
+    if (options) item.control = { options }
+  }
+  return item
+}
+
+/** 没配 components 时，按 src/components 的约定自动发现 */
+function discoverComponents(root) {
+  const dir = path.join(root, COMPONENT_DIR)
+  if (!fs.existsSync(dir)) return []
+  const components = []
+  fs.readdirSync(dir, { withFileTypes: true }).forEach((entry) => {
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      const indexFile = ['index.tsx', 'index.ts', 'index.jsx', 'index.js']
+        .map((name) => path.join(full, name))
+        .find((candidate) => fs.existsSync(candidate))
+      if (indexFile) {
+        components.push({ name: entry.name, file: toPosix(path.relative(root, indexFile)) })
+      }
+      return
+    }
+    if (entry.isFile() && /\.(tsx|ts|jsx|js)$/.test(entry.name) && entry.name !== 'App.tsx') {
+      components.push({
+        name: entry.name.replace(/\.(tsx|ts|jsx|js)$/, ''),
+        file: toPosix(path.relative(root, full)),
+      })
+    }
+  })
+  return components.sort((a, b) => a.name.localeCompare(b.name))
+}
+
+async function loadConfig(configPath) {
+  if (!fs.existsSync(configPath)) {
+    throw new Error(`[props-schema] 找不到配置文件: ${configPath}`)
+  }
+  const mod = await import(pathToFileURL(configPath).href)
+  return mod.default || {}
+}
+
+function parseComponentProps(fullPath, name) {
+  // 排除继承自 node_modules 原生 DOM 类型带入的属性，只保留组件自身声明的 props
+  const docs = docgen.parse(fullPath, {
+    savePropValueAsString: true,
+    shouldExtractLiteralValuesFromEnum: true,
+    propFilter: (prop) => {
+      const parent = prop.parent
+      if (parent && parent.fileName && /node_modules/.test(parent.fileName)) return false
+      return true
+    },
+  })
+  // props 是 { [propName]: PropItem } 映射，这里转成数组；优先按组件名匹配文档
+  const doc = docs.find((item) => item.displayName === name) || docs[0]
+  return doc ? Object.values(doc.props || {}) : []
+}
+
+function run(options) {
+  if (options.help) {
+    console.log(HELP.trim())
+    return 0
+  }
+
+  const cwd = process.cwd()
+  const root = options.root ? path.resolve(cwd, options.root) : cwd
+
+  return loadConfig(path.resolve(root, options.config)).then((config) => {
+    const components =
+      Array.isArray(config.components) && config.components.length
+        ? config.components
+        : discoverComponents(root)
+    const hints = config.hints || {}
+
+    if (!components.length) {
+      throw new Error(`[props-schema] 没有找到组件，检查 ${COMPONENT_DIR} 或配置里的 components`)
+    }
+
+    const stale = []
+
+    components.forEach(({ name, file }) => {
+      if (!name || !file) throw new Error('[props-schema] components 的每一项都需要 name 和 file')
+
+      const fullPath = path.join(root, file)
+      if (!fs.existsSync(fullPath)) {
+        throw new Error(`[props-schema] 组件文件不存在: ${file}`)
+      }
+
+      const props = parseComponentProps(fullPath, name).map((prop) =>
+        toSchemaProp(prop, hints[name] && hints[name][prop.name]),
+      )
+
+      if (!props.length) {
+        console.warn(
+          `[props-schema] ${name}: 没有解析到 props，检查 props interface / type 上方的 JSDoc`,
+        )
+      }
+      props.forEach((prop) => {
+        if (prop.bindable && !SCALAR_TYPES.includes(typeof prop.value)) {
+          throw new Error(`[props-schema] ${name}.${prop.name}: 默认值类型不对（${prop.type}）`)
+        }
+      })
+
+      const schemaFile = schemaRelPath(file)
+      const schemaFullPath = path.join(root, schemaFile)
+      const eol = eolOf(schemaFullPath)
+      const output = JSON.stringify(props, null, 2).split('\n').join(eol) + eol
+
+      if (options.check) {
+        const current = fs.existsSync(schemaFullPath)
+          ? fs.readFileSync(schemaFullPath, 'utf8')
+          : ''
+        if (current !== output) stale.push(schemaFile)
+        return
+      }
+
+      fs.writeFileSync(schemaFullPath, output)
+      if (!options.silence) {
+        console.log(`[props-schema] ${name}: ${props.length} props -> ${schemaFile}`)
+      }
+    })
+
+    if (options.check) {
+      if (stale.length) {
+        console.error(
+          `[props-schema] schema 不是最新的: ${stale.join(', ')}，请执行 react-leva-gen-schema`,
+        )
+        return 1
+      }
+      console.log(`[props-schema] check passed: ${components.length} components`)
+      return 0
+    }
+
+    if (!options.silence) console.log(`[props-schema] done: ${components.length} components`)
+    return 0
+  })
+}
+
+run(parseArgv(process.argv.slice(2)))
+  .then((code) => {
+    process.exitCode = code
+  })
+  .catch((error) => {
+    console.error(error.message || error)
+    process.exit(1)
+  })

package/scripts/meta.mjs

@@ -0,0 +1,46 @@
+/*
+|--------------------------------------------------------------------------
+|
+| 生成 hel-meta.json（写入 hel_dist）
+|
+|--------------------------------------------------------------------------
+*/
+import path from 'node:path'
+import fs from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { createRequire } from 'node:module'
+import helDevUtils from 'hel-dev-utils'
+import appInfo from '../appInfo.mjs'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const require = createRequire(import.meta.url)
+const pkg = require('../package.json')
+
+try {
+  await helDevUtils.extractHelMetaJson({
+    appInfo,
+    buildDirFullPath: path.join(__dirname, '../hel_dist'),
+    packageJson: pkg,
+  })
+  // hel-dev-utils 在 Windows 遍历产物时会把路径分隔符带入资源 URL。
+  const metaPath = path.join(__dirname, '../hel_dist/hel-meta.json')
+  const meta = JSON.parse(fs.readFileSync(metaPath, 'utf8'))
+  function normalizeAssetUrls(value) {
+    if (typeof value === 'string' && /^https?:\/\//i.test(value)) {
+      const url = new URL(value.replace(/\\/g, '/'))
+      url.pathname = url.pathname.replace(/\/{2,}/g, '/')
+      return url.toString()
+    }
+    if (Array.isArray(value)) return [...new Set(value.map(normalizeAssetUrls))]
+    if (value && typeof value === 'object') {
+      return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, normalizeAssetUrls(entry)]))
+    }
+    return value
+  }
+  meta.version.src_map = normalizeAssetUrls(meta.version.src_map)
+  fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2) + '\n')
+  console.log('[libs-react-leva] hel-meta.json 生成完成')
+} catch (err) {
+  console.error('[libs-react-leva] hel-meta.json 生成失败:', err)
+  process.exit(-1)
+}

package/scripts/prepublishOnly.mjs

@@ -0,0 +1,45 @@
+/*
+|--------------------------------------------------------------------------
+|
+| npm publish 前检查 package.json 版本号是否和 hel_dist/hel-meta.json 一致
+|
+|--------------------------------------------------------------------------
+*/
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createRequire } from 'node:module'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const require = createRequire(import.meta.url)
+const pkg = require('../package.json')
+const helDistPath = path.resolve(__dirname, '../hel_dist/hel-meta.json')
+
+// 检查是否执行过 pnpm run build 打包命令
+if (!fs.existsSync(helDistPath)) {
+  console.log("\x1b[31mRun the 'pnpm run build' command first.\n\x1b[0m")
+  process.exit(1)
+}
+
+const { app, version } = JSON.parse(fs.readFileSync(helDistPath, 'utf-8'))
+if (app?.build_version !== pkg.version) {
+  console.log(
+    '\x1b[31mThe package.json version number and the hel_dist/hel-meta.json version number must be the same.\n\x1b[0m',
+  )
+  process.exit(1)
+}
+
+const webDirPath = version?.src_map?.webDirPath || ''
+if (!webDirPath || /^https?:\/\/(localhost|127\.0\.0\.1|\[::1\])(:\d+)?(\/|$)/i.test(webDirPath)) {
+  console.error('HEL 资源地址为空或指向本地，请执行 pnpm run build 生成 unpkg 发布产物。')
+  process.exit(1)
+}
+
+for (const entry of [pkg.main, pkg.module, pkg.unpkg, pkg.types, ...Object.values(pkg.bin || {})]) {
+  if (!entry || !fs.existsSync(path.resolve(__dirname, '..', entry))) {
+    console.error(`缺少发布入口 ${entry}，请重新执行 pnpm run build。`)
+    process.exit(1)
+  }
+}
+
+console.log(`[prepublishOnly] ${pkg.name}@${pkg.version} HEL 发布校验通过。`)