@melt-js/libs-core 2026.11.15 → 2026.11.16

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