@melt-js/libs-core 2026.11.15 → 2026.11.16-2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/README.md +73 -16
  2. package/dist/browser.d.mts +3 -0
  3. package/dist/browser.mjs +1 -50
  4. package/dist/browser.mjs.gz +0 -0
  5. package/dist/cdn/browser.umd.cjs +2 -0
  6. package/dist/cdn/browser.umd.cjs.gz +0 -0
  7. package/dist/cdn/demo-browser.umd.cjs +2 -0
  8. package/dist/cdn/demo-browser.umd.cjs.gz +0 -0
  9. package/dist/cdn/demo.umd.cjs +2 -0
  10. package/dist/cdn/demo.umd.cjs.gz +0 -0
  11. package/dist/cdn/example-esm.html +1 -0
  12. package/dist/cdn/example-umd.html +1 -0
  13. package/dist/cdn/index.umd.cjs +2 -0
  14. package/dist/cdn/index.umd.cjs.gz +0 -0
  15. package/dist/cdn/manifest.json +141 -0
  16. package/dist/cdn/vendor.umd.cjs +16 -0
  17. package/dist/cdn/vendor.umd.cjs.gz +0 -0
  18. package/dist/cdn.d.mts +3 -0
  19. package/dist/cdn.mjs +1 -0
  20. package/dist/demo/browser.d.mts +1 -0
  21. package/dist/demo/browser.mjs +1 -0
  22. package/dist/demo/browser.mjs.gz +0 -0
  23. package/dist/demo/clipboard.d.mts +6 -0
  24. package/dist/demo/clipboard.mjs +1 -0
  25. package/{src → dist}/demo/docs.d.mts +3 -0
  26. package/dist/demo/docs.mjs +1 -0
  27. package/dist/demo/docs.mjs.gz +0 -0
  28. package/{src → dist}/demo/download.d.mts +10 -2
  29. package/dist/demo/download.mjs +1 -0
  30. package/dist/demo/download.mjs.gz +0 -0
  31. package/dist/demo/fullscreen.mjs +1 -0
  32. package/dist/demo/highlight.d.mts +2 -0
  33. package/dist/demo/highlight.mjs +1 -0
  34. package/dist/demo/index.d.mts +10 -0
  35. package/dist/demo/index.mjs +1 -0
  36. package/dist/demo/model.mjs +1 -0
  37. package/dist/demo/remote-debug.d.mts +9 -0
  38. package/dist/demo/remote-debug.mjs +1 -0
  39. package/{src → dist}/demo/runtime.mjs +92 -104
  40. package/dist/demo/split-pane.d.mts +8 -0
  41. package/dist/demo/split-pane.mjs +1 -0
  42. package/dist/demo/standalone.d.mts +12 -0
  43. package/dist/demo/standalone.mjs +1 -0
  44. package/dist/demo/standalone.mjs.gz +0 -0
  45. package/dist/demo/tabs.d.mts +15 -0
  46. package/dist/demo/tabs.mjs +1 -0
  47. package/{src/index.ts → dist/index.d.ts} +1 -1
  48. package/dist/loading.mjs +1 -0
  49. package/dist/loading.mjs.gz +0 -0
  50. package/dist/remote-address.cjs +2 -0
  51. package/{src → dist}/remote.d.mts +20 -2
  52. package/dist/remote.mjs +1 -0
  53. package/dist/remote.mjs.gz +0 -0
  54. package/dist/vendor/hel-runtime.mjs +16 -0
  55. package/dist/vendor/hel-runtime.mjs.gz +0 -0
  56. package/package.json +41 -25
  57. package/scripts/browser-formats.mjs +357 -0
  58. package/scripts/build-browser.mjs +59 -13
  59. package/scripts/build-protected-esm.mjs +54 -0
  60. package/scripts/cdn-runtime.cjs +30 -0
  61. package/scripts/check-tdz.mjs +327 -324
  62. package/scripts/client-build-security.cjs +48 -0
  63. package/scripts/comps-bundle-obfuscation.cjs +269 -262
  64. package/scripts/comps-obfuscator-options.cjs +7 -1
  65. package/scripts/hel-build-paths.cjs +49 -48
  66. package/scripts/obfuscator-split-strings.cjs +22 -0
  67. package/scripts/package-artifacts.mjs +206 -0
  68. package/scripts/package-env.cjs +156 -193
  69. package/scripts/publish-stage.mjs +50 -42
  70. package/scripts/webpack-bundle-obfuscation.cjs +125 -121
  71. package/demo/index.js +0 -1
  72. package/dist/hel-deployment.json +0 -8
  73. package/src/browser.d.mts +0 -2
  74. package/src/browser.mjs +0 -3
  75. package/src/demo/docs.mjs +0 -75
  76. package/src/demo/download.mjs +0 -118
  77. package/src/demo/fullscreen.mjs +0 -80
  78. package/src/demo/index.d.mts +0 -4
  79. package/src/demo/index.mjs +0 -4
  80. package/src/demo/model.mjs +0 -203
  81. package/src/remote.mjs +0 -286
  82. package/tsconfig.json +0 -13
  83. /package/{src → dist}/demo/fullscreen.d.mts +0 -0
  84. /package/{src → dist}/demo/model.d.mts +0 -0
  85. /package/{src → scripts}/remote-address.cjs +0 -0
@@ -0,0 +1,357 @@
1
+ #!/usr/bin/env node
2
+ import fs from 'node:fs'
3
+ import path from 'node:path'
4
+ import { createRequire } from 'node:module'
5
+ import { fileURLToPath } from 'node:url'
6
+ import { gzipSync } from 'node:zlib'
7
+ import { build, buildSync, transform } from 'esbuild'
8
+ import { rollup } from 'rollup'
9
+ import { parse } from 'acorn'
10
+ import JavaScriptObfuscator from 'javascript-obfuscator'
11
+ import defaults from './comps-obfuscator-options.cjs'
12
+ import { splitStringsChunkLength } from './obfuscator-split-strings.cjs'
13
+
14
+ const slash = value => value.replaceAll('\\', '/')
15
+ const write = (file, content) => { fs.mkdirSync(path.dirname(file), { recursive: true }); fs.writeFileSync(file, content) }
16
+ const cdn = (pkg, file) => `https://unpkg.com/${pkg.name}@${pkg.version}/${slash(file)}`
17
+ const quote = value => JSON.stringify(value).replaceAll('<', '\\u003c')
18
+ const runtimeTarget = entry => typeof entry === 'string' ? entry : entry && runtimeTarget(entry.import || entry.default || entry.require)
19
+ const frameGlobals = { vue: 'Vue', react: 'React', 'react-dom': 'ReactDOM', 'react-is': 'ReactIs' }
20
+ const vendorFile = file => /(?:^|\/)(?:vendor(?:[-./]|$)|shared-runtime[-.]|rolldown-runtime[-.])/.test(slash(file))
21
+ const pkgName = id => id.startsWith('@') ? id.split('/').slice(0, 2).join('/') : id.split('/')[0]
22
+ const relativeUrl = (from, to) => { const value = slash(path.relative(from, to)); return value.startsWith('.') ? value : './' + value }
23
+ const isJs = file => /\.[cm]?js$/.test(file)
24
+
25
+ function exportedNames(file, seen = new Set()) {
26
+ if (seen.has(file)) return []
27
+ seen.add(file)
28
+ const ast = parse(fs.readFileSync(file, 'utf8'), { ecmaVersion: 'latest', sourceType: 'module' })
29
+ const names = new Set()
30
+ const binding = node => {
31
+ if (!node) return
32
+ if (node.type === 'Identifier') names.add(node.name)
33
+ else if (node.type === 'ObjectPattern') node.properties.forEach(p => binding(p.value || p.argument))
34
+ else if (node.type === 'ArrayPattern') node.elements.forEach(binding)
35
+ else if (node.type === 'AssignmentPattern') binding(node.left)
36
+ else if (node.type === 'RestElement') binding(node.argument)
37
+ }
38
+ for (const node of ast.body) {
39
+ if (node.type === 'ExportDefaultDeclaration') names.add('default')
40
+ if (node.type === 'ExportNamedDeclaration') {
41
+ node.specifiers.forEach(item => names.add(item.exported.name || item.exported.value))
42
+ if (node.declaration?.type === 'VariableDeclaration') node.declaration.declarations.forEach(item => binding(item.id))
43
+ else binding(node.declaration?.id)
44
+ }
45
+ if (node.type === 'ExportAllDeclaration' && node.exported) names.add(node.exported.name)
46
+ else if (node.type === 'ExportAllDeclaration' && node.source.value.startsWith('.')) {
47
+ for (const name of exportedNames(path.resolve(path.dirname(file), node.source.value), seen)) if (name !== 'default') names.add(name)
48
+ }
49
+ }
50
+ return [...names]
51
+ }
52
+
53
+ // Rollup owns all format wrappers. Project code only supplies dependency boundaries.
54
+ async function emitUmd(input, plugins, { name, globals, paths, intro, outputDirectory = path.dirname(input) }) {
55
+ const bundle = await rollup({ input, plugins: [...plugins, { name: 'cdn-asset-url',
56
+ resolveImportMeta(property, { moduleId }) {
57
+ if (property === 'env') return '({DEV:false,PROD:true,MODE:"production",SSR:false,BASE_URL:"./"})'
58
+ if (property !== 'url') throw new Error('Unsupported browser import.meta.' + property)
59
+ return `new URL(${quote(slash(path.relative(outputDirectory, moduleId)))},__helCdnScriptUrl).href`
60
+ },
61
+ }], onwarn(warning, warn) {
62
+ if (warning.code === 'INVALID_ANNOTATION') return
63
+ if (warning.code === 'UNRESOLVED_IMPORT') throw new Error(warning.message)
64
+ warn(warning)
65
+ } })
66
+ try {
67
+ const { output } = await bundle.generate({ format: 'umd', name, globals, paths,
68
+ inlineDynamicImports: true, exports: 'named', sourcemap: false, intro,
69
+
70
+ })
71
+ const chunk = output.find(item => item.type === 'chunk')
72
+ const { code } = await transform(chunk.code, { minify: true, target: 'es2020', legalComments: 'none' })
73
+ return { code, exports: chunk.exports }
74
+ } finally { await bundle.close() }
75
+ }
76
+
77
+ function emitJs(file, code, protect, chunkLength) {
78
+ if (protect && process.env.HEL_OBFUSCATE !== '0') {
79
+ code = JavaScriptObfuscator.obfuscate(code, { ...defaults, splitStringsChunkLength: chunkLength, seed: 1 }).getObfuscatedCode()
80
+ // Several CDN scripts share a page. Keep generated decoder names out of its global scope.
81
+ code = `(function(){${code}\n}).call(typeof globalThis!=='undefined'?globalThis:this);\n`
82
+ }
83
+ write(file, code)
84
+ if (process.env.HEL_GZIP !== '0' && (Buffer.byteLength(code) >= 10240 || fs.existsSync(file + '.gz'))) write(file + '.gz', gzipSync(code))
85
+ }
86
+
87
+ function readDependency(root, specifier) {
88
+ const require = createRequire(path.join(root, 'package.json'))
89
+ const file = require.resolve(pkgName(specifier) + '/cdn/manifest.json')
90
+ return JSON.parse(fs.readFileSync(file, 'utf8'))
91
+ }
92
+
93
+ function frameworkResources(root, pkg, imports) {
94
+ const require = createRequire(path.join(root, 'package.json'))
95
+ const scripts = []
96
+ for (const [name, global] of Object.entries(frameGlobals)) {
97
+ if (!imports.has(name) && !pkg.dependencies?.[name] && !pkg.peerDependencies?.[name]) continue
98
+ let manifest
99
+ try { manifest = require(name + '/package.json') } catch { throw new Error(`${pkg.name}: browser framework must be a direct installed dependency: ${name}`) }
100
+ const file = name === 'vue' ? (manifest.version.startsWith('2.') ? 'dist/vue.min.js' : 'dist/vue.global.prod.js') : name === 'react' ? 'umd/react.production.min.js' : name === 'react-dom' ? 'umd/react-dom.production.min.js' : 'umd/react-is.production.min.js'
101
+ if (name.startsWith('react') && !manifest.version.startsWith('18.')) throw new Error(`${pkg.name}: configure a browser global build for ${name}@${manifest.version}`)
102
+ scripts.push(cdn(manifest, file))
103
+ const keys = Object.keys(require(name)).filter(key => /^[A-Za-z_$][\w$]*$/.test(key) && key !== 'default' && key !== '__esModule')
104
+ const bridge = `const frame=window.${global};export default frame;` + keys.map((key, index) => `const value${index}=frame[${quote(key)}];export {value${index} as ${key}};`).join('')
105
+ imports.set(name, 'data:text/javascript,' + encodeURIComponent(bridge))
106
+ }
107
+ return scripts
108
+ }
109
+
110
+ function html(title, scripts, styles, code, imports) {
111
+ const escape = value => value.replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('<', '&lt;')
112
+ const earlyErrors = `<script>window.addEventListener('error',event=>{window.__helCdnError=event.message||(event.target&&event.target.src)||'CDN resource failed'},true)</script>`
113
+ code = `if(window.__helCdnError){fail(window.__helCdnError);throw Error(window.__helCdnError)};` + code
114
+ return `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escape(title)}</title><style>body{font:16px/1.6 system-ui;margin:32px}pre{padding:16px;background:#f3f4f6;white-space:pre-wrap;overflow-wrap:anywhere}</style>${earlyErrors}${styles.map(url => `<link rel="stylesheet" href="${escape(url)}">`).join('')}${scripts.map(url => `<script src="${escape(url)}"></script>`).join('')}${imports ? `<script type="importmap">${quote({ imports: Object.fromEntries(imports) })}</script>` : ''}</head><body><h1>${escape(title)}</h1><p>联网加载 CDN。业务实现已构建,框架与宿主共享。</p><pre id="result">正在加载…</pre><div id="app"></div><script${imports ? ' type="module"' : ''}>const result=document.getElementById('result');function fail(error){result.textContent='FAIL: '+String(error);console.error(error)};window.addEventListener('error',event=>fail(event.message));window.addEventListener('unhandledrejection',event=>fail(event.reason));${code}</script></body></html>`
115
+ }
116
+
117
+ export function refreshBrowserExamples(root = process.cwd()) {
118
+ root = path.resolve(root)
119
+ const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json')))
120
+ const output = path.join(root, pkg.browserFormats.outDir, 'cdn')
121
+ const manifest = JSON.parse(fs.readFileSync(path.join(output, 'manifest.json')))
122
+ const imports = new Map(Object.entries(manifest.imports))
123
+ const scripts = frameworkResources(root, pkg, imports)
124
+ const styles = manifest.styles.map(style => /^https?:/.test(style) ? style : relativeUrl(output, path.join(root, style)))
125
+ exampleFiles(root, pkg, output, manifest, imports, scripts, styles, pkg.browserFormats.remote)
126
+ }
127
+
128
+ function exampleFiles(root, pkg, output, manifest, imports, scripts, styles, remote) {
129
+ const first = Object.values(manifest.entries)[0]
130
+ const umdScripts = [...scripts]
131
+ const seen = new Set()
132
+ for (const dep of manifest.resources) if (!seen.has(dep.umd)) { seen.add(dep.umd); if (dep.vendor) umdScripts.push(dep.vendor); umdScripts.push(dep.umd) }
133
+ if (manifest.vendor) umdScripts.push('./vendor.umd.cjs')
134
+ const display = `result.textContent='PASS: '+${quote(pkg.name)}+'\\n'+Object.keys(lib).join(', ');window.libraryExample=lib;`
135
+ const loadScript = `function loadScript(url){return new Promise((resolve,reject)=>{const script=document.createElement('script');script.src=url;script.onload=resolve;script.onerror=()=>reject(Error('加载失败 '+url));document.head.appendChild(script)})}`
136
+ let umdCode, esmCode
137
+ if (remote) {
138
+ const core = manifest.resources.find(dep => dep.specifier === '@melt-js/libs-core')
139
+ imports.set('@melt-js/libs-core', core.esm)
140
+ imports.set('hel-lib-proxy', core.esm)
141
+ const bind = `if(window.Vue)core.bindVueRuntime({Vue:window.Vue});if(window.React)core.bindReactRuntime({React:window.React,ReactDOM:window.ReactDOM,ReactIs:window.ReactIs});`
142
+ const preload = `await core.preloadHelLibs({deps:[{name:${quote(pkg.appGroupName || pkg.name.split('/').at(-1))},host:new URL('../hel-meta.json',location.href).href}]});`
143
+ umdCode = `${loadScript};(async()=>{const core=window.MeltPackages['@melt-js/libs-core'];${bind}${preload}await loadScript('./index.umd.cjs');const lib=window[${quote(pkg.appGroupName)}];${display}})().catch(fail)`
144
+ esmCode = `import * as core from '@melt-js/libs-core';try{${bind}${preload}const lib=await import('./index.esm.mjs');${display}}catch(error){fail(error)}`
145
+ } else {
146
+ umdScripts.push('./' + path.basename(first.umd))
147
+ umdCode = `try{const lib=window.MeltPackages[${quote(first.specifier)}];${display}}catch(error){fail(error)}`
148
+ esmCode = `try{const lib=await import(${quote(relativeUrl(output, path.resolve(root, first.esm)))});${display}}catch(error){fail(error)}`
149
+ }
150
+ write(path.join(output, 'example-umd.html'), html(pkg.name + ' · UMD', umdScripts, styles, umdCode))
151
+ write(path.join(output, 'example-esm.html'), html(pkg.name + ' · ESM', scripts, styles, esmCode, imports))
152
+ }
153
+
154
+ export async function buildBrowserFormats(root = process.cwd()) {
155
+ root = path.resolve(root)
156
+ const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'))
157
+ const chunkLength = splitStringsChunkLength(root)
158
+ const config = pkg.browserFormats
159
+ if (!config) return
160
+ const outputRoot = path.resolve(root, config.outDir)
161
+ if (!outputRoot.startsWith(root + path.sep)) throw new Error('browser formats must remain in the package')
162
+ const output = path.join(outputRoot, 'cdn')
163
+ if (fs.existsSync(output)) {
164
+ const history = path.join(root, '.tmp/browser-format-history', Date.now() + '-' + process.pid)
165
+ fs.mkdirSync(history, { recursive: true })
166
+ for (const file of fs.readdirSync(output)) fs.renameSync(path.join(output, file), path.join(history, file))
167
+ }
168
+ const imports = new Map()
169
+ const resources = new Map()
170
+ const styles = new Set()
171
+ const manifest = { name: pkg.name, version: pkg.version, entries: {}, resources: [], imports: {}, styles: [] }
172
+ const addDependency = specifier => {
173
+ const dep = readDependency(root, specifier)
174
+ const entry = dep.entries[specifier]
175
+ if (!entry) throw new Error(`${pkg.name}: ${specifier} has no browser UMD entry`)
176
+ for (const resource of dep.resources) resources.set(resource.specifier, resource)
177
+ resources.set(specifier, { specifier, esm: cdn(dep, entry.esm), umd: cdn(dep, entry.umd), vendor: dep.vendor && cdn(dep, dep.vendor) })
178
+ for (const [id, url] of Object.entries(dep.imports)) imports.set(id, url)
179
+ imports.set(specifier, cdn(dep, entry.esm))
180
+ for (const style of dep.styles) styles.add(/^https?:/.test(style) ? style : cdn(dep, style))
181
+ return entry.exports || []
182
+ }
183
+ if (config.remote) {
184
+ addDependency('@melt-js/libs-core')
185
+ const umd = path.join(root, 'hel_proxy/entry.js')
186
+ const esm = path.join(root, 'hel_proxy_es/entry.js')
187
+ if (!fs.existsSync(umd) || !fs.existsSync(esm)) throw new Error(`${pkg.name}: build both HEL proxies first`)
188
+ const proxyAst = parse(fs.readFileSync(esm, 'utf8'), { ecmaVersion: 'latest', sourceType: 'module' })
189
+ for (const node of proxyAst.body) if (node.source && node.source.value !== 'hel-lib-proxy') {
190
+ throw new Error(`${pkg.name}: CDN HEL proxy must be a built module with only hel-lib-proxy external; rebuild the proxy before copying`)
191
+ }
192
+ write(path.join(output, 'index.umd.cjs'), fs.readFileSync(umd))
193
+ write(path.join(output, 'index.esm.mjs'), fs.readFileSync(esm))
194
+ manifest.entries[pkg.name] = { specifier: pkg.name, esm: slash(path.relative(root, path.join(output, 'index.esm.mjs'))), umd: slash(path.relative(root, path.join(output, 'index.umd.cjs'))), exports: exportedNames(esm) }
195
+ } else {
196
+ const exports = pkg.publishConfig?.exports || pkg.exports || { '.': pkg.module || pkg.main }
197
+ const entries = config.entries || Object.fromEntries(Object.entries(exports).filter(([key, entry]) => !key.includes('*') && key !== './package.json' && !key.startsWith('./cdn') && isJs(runtimeTarget(entry) || '') && !/resolver|cli|scripts\//.test(key)).map(([key, entry]) => [key, runtimeTarget(entry)]))
198
+ if (!Object.keys(entries).length) throw new Error(`${pkg.name}: configure browser runtime entries`)
199
+ const externals = new Map()
200
+ const ownFiles = new Map()
201
+ const required = new Map()
202
+ const requested = id => { if (!required.has(id)) required.set(id, new Set()); return required.get(id) }
203
+ const selfTarget = id => {
204
+ const key = id === pkg.name ? '.' : '.' + id.slice(pkg.name.length)
205
+ const target = entries[key] || runtimeTarget(exports[key])
206
+ if (!target || !isJs(target)) throw new Error(`${pkg.name}: missing compiled self entry ${id}`)
207
+ return path.resolve(root, target)
208
+ }
209
+ const resolveImport = (id, importer) => {
210
+ if (id === pkg.name || id.startsWith(pkg.name + '/')) return { own: selfTarget(id) }
211
+ if (id.startsWith('.') || path.isAbsolute(id)) {
212
+ const file = path.resolve(path.dirname(importer), id)
213
+ if (/\.css$/.test(file)) { styles.add(slash(path.relative(root, file))); return { style: file } }
214
+ if (vendorFile(file)) return { external: file }
215
+ return { own: file }
216
+ }
217
+ return { external: id }
218
+ }
219
+ const collect = file => {
220
+ if (ownFiles.has(file)) return
221
+ if (!file.startsWith(outputRoot + path.sep)) throw new Error('Browser entries must use compiled files inside the main output directory: ' + file)
222
+ if (/\.map$/.test(file)) throw new Error('Source maps cannot be browser input')
223
+ const text = fs.readFileSync(file, 'utf8')
224
+ if (/\.json$/.test(file)) { ownFiles.set(file, { text, edits: [] }); return }
225
+ const ast = parse(text, { ecmaVersion: 'latest', sourceType: 'module' })
226
+ const edits = []
227
+ ownFiles.set(file, { text, edits })
228
+ const visitImport = (source, node) => {
229
+ const target = resolveImport(source.value, file)
230
+ if (target.style) return
231
+ if (target.own) { collect(target.own); return }
232
+ const id = target.external
233
+ if (!externals.has(id)) externals.set(id, 'dep' + externals.size)
234
+ const names = requested(id)
235
+ for (const item of node.specifiers || []) {
236
+ if (item.type === 'ImportNamespaceSpecifier') edits.push([item.start, item.end, '{ __helCdnNamespace as ' + item.local.name + ' }'])
237
+ else names.add(item.type === 'ImportDefaultSpecifier' ? 'default' : (item.imported || item.local).name)
238
+ }
239
+ if (node.type === 'ExportAllDeclaration') {
240
+ const exported = id.startsWith('@melt-js/') ? addDependency(id) : path.isAbsolute(id) ? exportedNames(id) : Object.values(buildSync({ absWorkingDir: root, stdin: { contents: 'export * from ' + quote(id), resolveDir: root }, bundle: true, format: 'esm', platform: 'browser', write: false, metafile: true, logLevel: 'silent' }).metafile.outputs)[0].exports
241
+ if (!exported) throw new Error(`${pkg.name}: explicitly export third-party symbols for UMD: ${id}`)
242
+ exported.filter(name => name !== 'default').forEach(name => names.add(name))
243
+ if (!node.exported) edits.push([node.start, node.end, `export {${exported.filter(name => name !== 'default').join(',')}} from ${quote(source.value)};`])
244
+ }
245
+ }
246
+ const visit = node => {
247
+ if (!node || typeof node !== 'object') return
248
+ if (['ImportDeclaration', 'ExportNamedDeclaration', 'ExportAllDeclaration'].includes(node.type) && node.source) visitImport(node.source, node)
249
+ if (node.type === 'ImportExpression' && node.source.type === 'Literal') {
250
+ const target = resolveImport(node.source.value, file)
251
+ if (target.own) collect(target.own)
252
+ else if (target.external) {
253
+ if (!externals.has(target.external)) externals.set(target.external, 'dep' + externals.size)
254
+ edits.push([node.start, node.end, text.slice(node.start, node.end) + '.then(module=>module.__helCdnNamespace)'])
255
+ }
256
+ }
257
+ for (const value of Object.values(node)) {
258
+ if (Array.isArray(value)) value.forEach(child => { if (child?.type) visit(child) })
259
+ else if (value?.type) visit(value)
260
+ }
261
+ }
262
+ visit(ast)
263
+ }
264
+ for (const target of Object.values(entries)) collect(path.resolve(root, target))
265
+ const vendorImports = [...externals].filter(([id]) => !id.startsWith('@melt-js/'))
266
+ const related = [...externals.keys()].filter(id => id.startsWith('@melt-js/'))
267
+ related.forEach(addDependency)
268
+ const frames = new Set()
269
+ const framePlugin = { name: 'cdn-shared-frameworks', setup(builder) {
270
+ builder.onResolve({ filter: /^hel-framework:/ }, args => ({ path: args.path.slice(14), external: true }))
271
+ builder.onResolve({ filter: /^(vue|react|react-dom|react-is)$/ }, args => { frames.add(args.path); return { path: args.path, namespace: 'hel-framework' } })
272
+ builder.onResolve({ filter: /^@melt-js\// }, args => { throw new Error('Business dependency must stay outside vendor: ' + args.path) })
273
+ builder.onLoad({ filter: /.*/, namespace: 'hel-framework' }, args => ({ contents: 'import * as value from ' + quote('hel-framework:' + args.path) + ';module.exports=value.default||value;', loader: 'js' }))
274
+ } }
275
+ if (vendorImports.length) {
276
+ const result = await build({ absWorkingDir: root, stdin: { contents: vendorImports.map(([id, key]) => `import * as ${key} from ${quote(id)};export {${key}};`).join('\n'), resolveDir: root }, bundle: true, format: 'esm', platform: 'browser', target: 'es2020', minify: true, sourcemap: false, legalComments: 'none', write: false, plugins: [framePlugin] })
277
+ const vendorEntry = path.join(output, '.vendor-input.mjs')
278
+ const vendor = await emitUmd(vendorEntry, [{ name: 'vendor-esm-input', resolveId(id) { if (frames.has(id)) return { id, external: true }; if (id === vendorEntry) return id }, load(id) { if (id === vendorEntry) return result.outputFiles[0].text } }], {
279
+ name: 'MeltCdnVendors.' + pkg.name, globals: id => frameGlobals[id],
280
+ })
281
+ emitJs(path.join(output, 'vendor.umd.cjs'), vendor.code, false, chunkLength)
282
+ manifest.vendor = slash(path.relative(root, path.join(output, 'vendor.umd.cjs')))
283
+ }
284
+ const bridge = { name: 'cdn-business-boundary',
285
+ resolveId(id, importer) {
286
+ if (id === './vendor.umd.cjs' || (related.includes(id) && importer?.startsWith('\0cdn-external:'))) return { id, external: true }
287
+ if (id.startsWith('\0')) return id
288
+ if (!importer) return id
289
+ const target = resolveImport(id, importer)
290
+ if (target.style) return '\0empty-style:' + target.style
291
+ if (target.own) return target.own
292
+ return '\0cdn-external:' + target.external
293
+ },
294
+ load(id) {
295
+ if (id.startsWith('\0empty-style:')) return 'export {}'
296
+ if (id.startsWith('\0cdn-external:')) {
297
+ const dependency = id.slice(14)
298
+ const key = externals.get(dependency)
299
+ if (!key) throw new Error('Untracked CDN external: ' + dependency)
300
+ const source = dependency.startsWith('@melt-js/')
301
+ ? `import * as __helCdnNamespace from ${quote(dependency)};`
302
+ : `import {${key} as __helCdnNamespace} from './vendor.umd.cjs';`
303
+ const declarations = [...requested(dependency)].map(name => name === 'default' ? 'export default __helCdnNamespace.default;' : `export const ${name}=__helCdnNamespace[${quote(name)}];`).join('\n')
304
+ return `${source}export {__helCdnNamespace};${declarations}`
305
+ }
306
+ const source = ownFiles.get(id)
307
+ if (!source) throw new Error('Unexpected business input: ' + id)
308
+ if (id.endsWith('.json')) return 'export default ' + source.text
309
+ let text = source.text
310
+ for (const [start, end, replacement] of [...source.edits].sort((a, b) => b[0] - a[0])) text = text.slice(0, start) + replacement + text.slice(end)
311
+ return text
312
+ },
313
+ }
314
+ for (const [key, target] of Object.entries(entries)) {
315
+ const specifier = key === '.' ? pkg.name : pkg.name + key.slice(1)
316
+ const name = key === '.' ? 'index' : key.slice(2).replaceAll('/', '-')
317
+ const entryPath = path.resolve(root, target)
318
+ const result = await emitUmd(entryPath, [bridge], {
319
+ name: 'MeltPackages.' + specifier, outputDirectory: output,
320
+ globals: id => id === './vendor.umd.cjs' ? 'MeltCdnVendors.' + pkg.name : related.includes(id) ? 'MeltPackages.' + id : id,
321
+ paths: id => related.includes(id) ? pkgName(id) + '/cdn/' + path.basename(resources.get(id).umd) : id,
322
+ intro: `var __helCdnScriptUrl=typeof document!=='undefined'&&document.currentScript?document.currentScript.src:typeof __filename!=='undefined'?'file:///'+__filename.replaceAll('\\\\','/'):'file:///';`,
323
+ })
324
+ let code = result.code
325
+ if (pkg.name === '@melt-js/libs-core' && key === '.') code += ';if(typeof window!=="undefined"){window.MeltCore=window.MeltPackages[' + quote(pkg.name) + '];window.HelLibProxy=window.MeltCore;}\n'
326
+ emitJs(path.join(output, name + '.umd.cjs'), code, true, chunkLength)
327
+ manifest.entries[specifier] = { specifier, esm: slash(path.relative(root, entryPath)), umd: slash(path.relative(root, path.join(output, name + '.umd.cjs'))), exports: result.exports }
328
+ imports.set(specifier, cdn(pkg, slash(path.relative(root, path.resolve(root, target)))))
329
+ }
330
+ const require = createRequire(path.join(root, 'package.json'))
331
+ for (const [id] of vendorImports) {
332
+ if (path.isAbsolute(id)) continue
333
+ if (Object.hasOwn(frameGlobals, id)) { imports.set(id, ''); continue }
334
+ const name = pkgName(id)
335
+ let file
336
+ try { file = require.resolve(name + '/package.json') } catch {
337
+ file = require.resolve(id)
338
+ while (!fs.existsSync(path.join(file, 'package.json'))) { const parent = path.dirname(file); if (parent === file) throw new Error('No installed package metadata: ' + name); file = parent }
339
+ file = path.join(file, 'package.json')
340
+ }
341
+ const version = JSON.parse(fs.readFileSync(file, 'utf8')).version
342
+ imports.set(id, `https://esm.sh/${name}@${version}${id.slice(name.length)}?external=vue,react,react-dom,react-is`)
343
+ }
344
+ for (const frame of frames) imports.set(frame, '')
345
+ }
346
+ for (const file of fs.readdirSync(outputRoot).filter(file => file.endsWith('.css'))) styles.add(slash(path.relative(root, path.join(outputRoot, file))))
347
+ const scripts = frameworkResources(root, pkg, imports)
348
+ manifest.resources = [...resources.values()]
349
+ manifest.imports = Object.fromEntries(imports)
350
+ manifest.styles = [...styles]
351
+ write(path.join(output, 'manifest.json'), JSON.stringify(manifest, null, 2) + '\n')
352
+ exampleFiles(root, pkg, output, manifest, imports, scripts, [...styles].map(style => /^https?:/.test(style) ? style : relativeUrl(output, path.join(root, style))), config.remote)
353
+ console.log(`[browser-formats] ${pkg.name}: ESM + UMD HTML in ${slash(path.relative(root, output))}`)
354
+ return manifest
355
+ }
356
+
357
+ if (process.argv[1] && fs.realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)) await buildBrowserFormats()
@@ -1,13 +1,59 @@
1
- import { build } from 'esbuild'
2
- import { fileURLToPath } from 'node:url'
3
-
4
- await build({
5
- entryPoints: [fileURLToPath(new URL('../src/browser.mjs', import.meta.url))],
6
- outfile: fileURLToPath(new URL('../dist/browser.mjs', import.meta.url)),
7
- bundle: true,
8
- format: 'esm',
9
- platform: 'browser',
10
- target: 'es2020',
11
- minify: true,
12
- legalComments: 'eof',
13
- })
1
+ import { build } from 'esbuild'
2
+ import { fileURLToPath } from 'node:url'
3
+ import fs from 'node:fs'
4
+ import path from 'node:path'
5
+ import { gzipSync } from 'node:zlib'
6
+ import { buildProtectedEsm } from './build-protected-esm.mjs'
7
+
8
+ const src = fileURLToPath(new URL('../src/', import.meta.url))
9
+ const dist = fileURLToPath(new URL('../dist/', import.meta.url))
10
+ const root = fileURLToPath(new URL('../', import.meta.url))
11
+ const reports = []
12
+ // Keep the ESM module layout for declarations and legacy public subpaths.
13
+ for (const file of fs.readdirSync(src, { recursive: true })) {
14
+ const source = path.join(src, file)
15
+ if (!fs.statSync(source).isFile()) continue
16
+ const target = path.join(dist, file)
17
+ fs.mkdirSync(path.dirname(target), { recursive: true })
18
+ if (/\.mjs$/.test(file)) {
19
+ reports.push(...await buildProtectedEsm({ entryPoints: [source], outfile: target, format: 'esm', target: 'es2019', minify: true }, { root }))
20
+ } else if (/\.d\.(mts|ts)$|\.cjs$/.test(file)) {
21
+ fs.copyFileSync(source, target)
22
+ }
23
+ }
24
+ fs.writeFileSync(path.join(dist, 'index.d.ts'), "export * from './remote.mjs'\n")
25
+
26
+ // One shared HEL runtime for both the loader and native ESM npm proxies.
27
+ await build({
28
+ stdin: { contents: "export { default, bindReactRuntime, bindVueRuntime } from 'hel-micro'; export { exposeLib, getLib } from 'hel-lib-proxy'", resolveDir: root },
29
+ outfile: path.join(dist, 'vendor/hel-runtime.mjs'),
30
+ bundle: true, format: 'esm', platform: 'browser', target: 'es2020', minify: true, sourcemap: false,
31
+ legalComments: 'none',
32
+ })
33
+ const vendorFile = path.join(dist, 'vendor/hel-runtime.mjs')
34
+ if (process.env.HEL_GZIP !== '0') fs.writeFileSync(vendorFile + '.gz', gzipSync(fs.readFileSync(vendorFile)))
35
+ reports.push(...await buildProtectedEsm({
36
+ entryPoints: [fileURLToPath(new URL('../src/browser.mjs', import.meta.url))],
37
+ outfile: fileURLToPath(new URL('../dist/browser.mjs', import.meta.url)),
38
+ bundle: true,
39
+ format: 'esm',
40
+ platform: 'browser',
41
+ target: 'es2020',
42
+ minify: true,
43
+ legalComments: 'none',
44
+ plugins: [{ name: 'shared-hel-vendor', setup(builder) {
45
+ builder.onResolve({ filter: /^(?:hel-micro|hel-lib-proxy)$/ }, () => ({ path: './vendor/hel-runtime.mjs', external: true }))
46
+ } }],
47
+ }, { root }))
48
+ reports.push(...await buildProtectedEsm({
49
+ entryPoints: [path.join(src, 'demo/index.mjs')], outfile: path.join(dist, 'demo/browser.mjs'),
50
+ bundle: true, format: 'esm', platform: 'browser', target: 'es2020', minify: true,
51
+ plugins: [{ name: 'shared-hel-vendor', setup(builder) {
52
+ builder.onResolve({ filter: /^hel-micro$/ }, () => ({ path: '../vendor/hel-runtime.mjs', external: true }))
53
+ } }],
54
+ }, { root }))
55
+ const reportDir = path.join(root, '.tmp/browser-build')
56
+ fs.mkdirSync(reportDir, { recursive: true })
57
+ fs.writeFileSync(path.join(reportDir, 'obfuscation.json'), JSON.stringify(reports, null, 2) + '\n')
58
+
59
+ await (await import('./browser-formats.mjs')).buildBrowserFormats(root)
@@ -0,0 +1,54 @@
1
+ import fs from 'node:fs'
2
+ import path from 'node:path'
3
+ import { createHash } from 'node:crypto'
4
+ import { gzipSync } from 'node:zlib'
5
+ import { build } from 'esbuild'
6
+ import JavaScriptObfuscator from 'javascript-obfuscator'
7
+ import defaults from './comps-obfuscator-options.cjs'
8
+ import { splitStringsChunkLength } from './obfuscator-split-strings.cjs'
9
+ import contracts from './comps-source-obfuscation.cjs'
10
+ import boundaries from './comps-bundle-obfuscation.cjs'
11
+
12
+ // Final ESM output only. Dependencies must stay external or in a separate vendor build.
13
+ export async function buildProtectedEsm(options, { root, enabled = process.env.HEL_OBFUSCATE !== '0' } = {}) {
14
+ root = path.resolve(root || options.absWorkingDir || process.cwd())
15
+ const classify = boundaries.createModuleClassifier(root)
16
+ // 受保护 ESM 产物一律不保留注释(含 /*! */ 版权 banner)。
17
+ const result = await build({ ...options, absWorkingDir: root, sourcemap: false, metafile: true, write: false, legalComments: 'none' })
18
+ const reports = []
19
+ for (const output of result.outputFiles) {
20
+ let content = output.contents
21
+ if (/\.[cm]?js$/.test(output.path)) {
22
+ const relative = path.relative(root, output.path).replaceAll('\\', '/')
23
+ const metadata = result.metafile.outputs[relative]
24
+ if (!metadata) throw new Error('Missing ESM output metadata: ' + relative)
25
+ const inputs = Object.keys(metadata?.inputs || {})
26
+ const vendors = inputs.filter(input => classify(path.resolve(root, input)) === 'thirdParty')
27
+ if (vendors.length) throw new Error('Protected ESM must not contain third-party modules: ' + relative)
28
+ const beforeHash = createHash('sha256').update(content).digest('hex')
29
+ const code = output.text
30
+ // Type-only entrypoints may compile to an empty module.
31
+ if (enabled && code.trim() && !/^export\s*\{\s*\}\s*;?$/.test(code.trim())) {
32
+ content = Buffer.from(JavaScriptObfuscator.obfuscate(code, {
33
+ ...defaults, ...contracts.getSourceContractOptions(code),
34
+ splitStringsChunkLength: splitStringsChunkLength(root),
35
+ seed: 1, sourceMap: false, renameProperties: false,
36
+ }).getObfuscatedCode())
37
+ }
38
+ reports.push({ file: relative, inputs, beforeHash,
39
+ afterHash: createHash('sha256').update(content).digest('hex'),
40
+ identifiers: (content.toString().match(/\b_0x[\da-f]+\b/g) || []).length })
41
+ }
42
+ fs.mkdirSync(path.dirname(output.path), { recursive: true })
43
+ fs.writeFileSync(output.path, content)
44
+ const sidecar = output.path + '.gz'
45
+ if (process.env.HEL_GZIP !== '0' && /\.[cm]?js$/.test(output.path) && (content.length >= 10240 || fs.existsSync(sidecar))) {
46
+ fs.writeFileSync(output.path + '.gz', gzipSync(content))
47
+ } else if (fs.existsSync(sidecar)) {
48
+ const archived = path.join(root, '.tmp/gzip-history', Date.now() + '-' + process.pid, path.relative(root, sidecar))
49
+ fs.mkdirSync(path.dirname(archived), { recursive: true })
50
+ fs.renameSync(sidecar, archived)
51
+ }
52
+ }
53
+ return reports
54
+ }
@@ -0,0 +1,30 @@
1
+ const { createRequire } = require('node:module')
2
+ const path = require('node:path')
3
+
4
+ /** Preserve native package imports while sharing the host's CDN runtime in Vite dev/build. */
5
+ module.exports = function cdnRuntime({ root, modules }) {
6
+ const localRequire = createRequire(path.join(root, 'package.json'))
7
+ const prefix = '\0hel:cdn-runtime:'
8
+ const entries = new Map(Object.entries(modules).map(([name, global]) => {
9
+ const names = Object.keys(localRequire(name)).filter(name => name !== 'default' && /^[$A-Z_a-z][$\w]*$/.test(name))
10
+ const code = `const runtime = globalThis[${JSON.stringify(global)}];\n`
11
+ + `if (!runtime) throw new Error('Load CDN runtime before importing ${name}');\n`
12
+ + 'export default runtime;\n'
13
+ + names.map(name => `export const ${name} = runtime[${JSON.stringify(name)}];`).join('\n')
14
+ return [name, code]
15
+ }))
16
+ return {
17
+ name: 'hel:cdn-runtime', enforce: 'pre',
18
+ resolveId(id) { if (entries.has(id)) return prefix + id },
19
+ load(id) { if (id.startsWith(prefix)) return entries.get(id.slice(prefix.length)) },
20
+ config() {
21
+ return { optimizeDeps: { esbuildOptions: { plugins: [{
22
+ name: 'hel-cdn-runtime',
23
+ setup(build) {
24
+ build.onResolve({ filter: /.*/ }, args => entries.has(args.path) ? { path: args.path, namespace: 'hel-cdn' } : undefined)
25
+ build.onLoad({ filter: /.*/, namespace: 'hel-cdn' }, args => ({ contents: entries.get(args.path), loader: 'js' }))
26
+ },
27
+ }] } } }
28
+ },
29
+ }
30
+ }