vite-plugin-gas-hoist 0.2.1 → 0.3.0
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.
- package/README.ja.md +24 -2
- package/README.md +24 -2
- package/index.js +60 -0
- package/lib/classify-variable.js +15 -0
- package/lib/collect-module-exports.js +75 -0
- package/lib/emit-wrapper.js +23 -0
- package/lib/hoist-exports.js +54 -0
- package/lib/resolve-export-kind.js +35 -0
- package/package.json +28 -8
- package/src/index.js +0 -189
package/README.ja.md
CHANGED
|
@@ -2,10 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/vite-plugin-gas-hoist)
|
|
4
4
|
[](https://registry.vite.dev)
|
|
5
|
+
[](https://registry.vite.dev)
|
|
6
|
+
[](https://registry.vite.dev)
|
|
5
7
|
|
|
6
8
|
[English](README.md)
|
|
7
9
|
|
|
8
|
-
エントリーポイントの `export` を、ESM の宣言種別(`function` / `const` / `let` / `var`)を保ったまま、Google Apps Script (GAS) のグローバルスコープに公開する Vite プラグインです。
|
|
10
|
+
エントリーポイントの `export` を、ESM の宣言種別(`function` / `const` / `let` / `var`)を保ったまま、Google Apps Script (GAS) のグローバルスコープに公開する Vite プラグインです。Rollup と Rolldown でも使えます。
|
|
9
11
|
|
|
10
12
|
## デモ
|
|
11
13
|
|
|
@@ -58,6 +60,25 @@ export default defineConfig({
|
|
|
58
60
|
|
|
59
61
|
`build.lib.name` に指定した変数名(上記例では `lib_`)を介して、エクスポートが GAS のグローバルスコープに公開されます。
|
|
60
62
|
|
|
63
|
+
### Rollup / Rolldown
|
|
64
|
+
|
|
65
|
+
```js
|
|
66
|
+
// rollup.config.js または rolldown.config.js
|
|
67
|
+
import { vitePluginGasHoist } from 'vite-plugin-gas-hoist';
|
|
68
|
+
|
|
69
|
+
export default {
|
|
70
|
+
input: 'src/main.js',
|
|
71
|
+
plugins: [vitePluginGasHoist()],
|
|
72
|
+
output: {
|
|
73
|
+
file: 'dist/main.js',
|
|
74
|
+
format: 'iife',
|
|
75
|
+
name: 'lib_',
|
|
76
|
+
},
|
|
77
|
+
};
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
変数名は `output.name` の指定が使われます。
|
|
81
|
+
|
|
61
82
|
## 対応パターン
|
|
62
83
|
|
|
63
84
|
GAS でグローバルに公開するときの目的は、大きく 2 つに分かれます。
|
|
@@ -82,7 +103,8 @@ ESM の宣言種別(`function` / `const` / `let` / `var`)と右辺の形を
|
|
|
82
103
|
|
|
83
104
|
## 動作条件
|
|
84
105
|
|
|
85
|
-
-
|
|
106
|
+
- Vite 6・7・8、Rollup 4、Rolldown 1 のいずれか
|
|
107
|
+
- `build.lib.formats` に `'iife'` を含むこと(Rollup / Rolldown では `output.format` が `'iife'` であること)
|
|
86
108
|
- エントリーポイントで何かを `export` していること
|
|
87
109
|
|
|
88
110
|
## 0.1.x からの移行
|
package/README.md
CHANGED
|
@@ -2,10 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/vite-plugin-gas-hoist)
|
|
4
4
|
[](https://registry.vite.dev)
|
|
5
|
+
[](https://registry.vite.dev)
|
|
6
|
+
[](https://registry.vite.dev)
|
|
5
7
|
|
|
6
8
|
[日本語](README.ja.md)
|
|
7
9
|
|
|
8
|
-
A Vite plugin that hoists entry point `export`s to the global scope for Google Apps Script (GAS), preserving the original ESM declaration kind (`function` / `const` / `let` / `var`).
|
|
10
|
+
A Vite plugin that hoists entry point `export`s to the global scope for Google Apps Script (GAS), preserving the original ESM declaration kind (`function` / `const` / `let` / `var`). It also works with Rollup and Rolldown.
|
|
9
11
|
|
|
10
12
|
## Try it
|
|
11
13
|
|
|
@@ -58,6 +60,25 @@ export default defineConfig({
|
|
|
58
60
|
|
|
59
61
|
Exports are hoisted to the global scope via the variable name specified in `build.lib.name` (e.g. `lib_`).
|
|
60
62
|
|
|
63
|
+
### Rollup / Rolldown
|
|
64
|
+
|
|
65
|
+
```js
|
|
66
|
+
// rollup.config.js or rolldown.config.js
|
|
67
|
+
import { vitePluginGasHoist } from 'vite-plugin-gas-hoist';
|
|
68
|
+
|
|
69
|
+
export default {
|
|
70
|
+
input: 'src/main.js',
|
|
71
|
+
plugins: [vitePluginGasHoist()],
|
|
72
|
+
output: {
|
|
73
|
+
file: 'dist/main.js',
|
|
74
|
+
format: 'iife',
|
|
75
|
+
name: 'lib_',
|
|
76
|
+
},
|
|
77
|
+
};
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
The variable name comes from `output.name`.
|
|
81
|
+
|
|
61
82
|
## What gets hoisted
|
|
62
83
|
|
|
63
84
|
Exposing something globally in GAS serves one of two purposes:
|
|
@@ -82,7 +103,8 @@ Specifier-form re-exports like `export { foo }` and `export { foo as bar }` inhe
|
|
|
82
103
|
|
|
83
104
|
## Requirements
|
|
84
105
|
|
|
85
|
-
-
|
|
106
|
+
- Vite 6, 7, or 8, Rollup 4, or Rolldown 1
|
|
107
|
+
- `build.lib.formats` must include `'iife'` (`output.format` must be `'iife'` for Rollup / Rolldown)
|
|
86
108
|
- Entry point must have at least one `export`
|
|
87
109
|
|
|
88
110
|
## Migration from 0.1.x
|
package/index.js
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { collectModuleExports } from './lib/collect-module-exports.js';
|
|
2
|
+
import { hoistExports } from './lib/hoist-exports.js';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Vite plugin for Google Apps Script.
|
|
6
|
+
* Hoists entry point exports to the GAS global scope.
|
|
7
|
+
*
|
|
8
|
+
* @example
|
|
9
|
+
* // vite.config.js
|
|
10
|
+
* import { vitePluginGasHoist } from 'vite-plugin-gas-hoist';
|
|
11
|
+
*
|
|
12
|
+
* export default defineConfig({
|
|
13
|
+
* plugins: [vitePluginGasHoist()],
|
|
14
|
+
* build: {
|
|
15
|
+
* lib: {
|
|
16
|
+
* entry: 'src/main.js',
|
|
17
|
+
* formats: ['iife'],
|
|
18
|
+
* name: 'lib_',
|
|
19
|
+
* },
|
|
20
|
+
* },
|
|
21
|
+
* });
|
|
22
|
+
*
|
|
23
|
+
* @returns {import('vite').Plugin}
|
|
24
|
+
*/
|
|
25
|
+
export const vitePluginGasHoist = () => {
|
|
26
|
+
/** @type {Map<string, ModuleRecord>} */
|
|
27
|
+
const modules = new Map();
|
|
28
|
+
|
|
29
|
+
return {
|
|
30
|
+
name: 'vite-plugin-gas-hoist',
|
|
31
|
+
apply: 'build',
|
|
32
|
+
|
|
33
|
+
buildStart() {
|
|
34
|
+
modules.clear();
|
|
35
|
+
},
|
|
36
|
+
|
|
37
|
+
/** @param {import('rollup').ModuleInfo} moduleInfo */
|
|
38
|
+
async moduleParsed({ id, code }) {
|
|
39
|
+
const moduleExports = collectModuleExports(this.parse(code));
|
|
40
|
+
const resolutions = await Promise.all(moduleExports.sources.map((source) => this.resolve(source, id)));
|
|
41
|
+
modules.set(id, { ...moduleExports, resolutions });
|
|
42
|
+
},
|
|
43
|
+
|
|
44
|
+
renderChunk: {
|
|
45
|
+
order: 'post',
|
|
46
|
+
/**
|
|
47
|
+
* @param {string} code
|
|
48
|
+
* @param {import('rollup').RenderedChunk} chunk
|
|
49
|
+
* @param {import('rollup').NormalizedOutputOptions} options
|
|
50
|
+
*/
|
|
51
|
+
handler(code, chunk, options) {
|
|
52
|
+
const { output, logs } = hoistExports(code, chunk, options, modules);
|
|
53
|
+
for (const { level, message } of logs) {
|
|
54
|
+
this[level](message);
|
|
55
|
+
}
|
|
56
|
+
return output;
|
|
57
|
+
},
|
|
58
|
+
},
|
|
59
|
+
};
|
|
60
|
+
};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/** @typedef {'function' | 'const' | 'let' | 'var'} ExportKind */
|
|
2
|
+
/** @typedef {{ kind: ExportKind, isFn: boolean, isArrow: boolean }} ExportInfo */
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Classifies a `VariableDeclaration` declarator as a value or function expression.
|
|
6
|
+
*
|
|
7
|
+
* @param {ExportKind} kind
|
|
8
|
+
* @param {import('estree').Expression | null | undefined} init
|
|
9
|
+
* @returns {ExportInfo}
|
|
10
|
+
*/
|
|
11
|
+
export const classifyVariable = (kind, init) => {
|
|
12
|
+
const isArrow = init?.type === 'ArrowFunctionExpression';
|
|
13
|
+
const isFn = isArrow || init?.type === 'FunctionExpression';
|
|
14
|
+
return { kind, isFn, isArrow };
|
|
15
|
+
};
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { classifyVariable } from './classify-variable.js';
|
|
2
|
+
|
|
3
|
+
/** @typedef {{ source: string, name: string }} ExportLink */
|
|
4
|
+
/** @typedef {{ bindings: Map<string, ExportInfo | ExportLink>, stars: string[], sources: string[] }} ModuleExports */
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Collects the top-level named exports of a module. Each export is bound to
|
|
8
|
+
* its declaration kind, or to a link naming the module it is re-exported from.
|
|
9
|
+
*
|
|
10
|
+
* @param {import('estree').Program} ast
|
|
11
|
+
* @returns {ModuleExports}
|
|
12
|
+
*/
|
|
13
|
+
export const collectModuleExports = (ast) => {
|
|
14
|
+
/** @type {Map<string, ExportInfo | ExportLink>} */
|
|
15
|
+
const locals = new Map();
|
|
16
|
+
for (const node of ast.body) {
|
|
17
|
+
if (node.type === 'FunctionDeclaration' && node.id) {
|
|
18
|
+
locals.set(node.id.name, { kind: 'function', isFn: true, isArrow: false });
|
|
19
|
+
} else if (node.type === 'VariableDeclaration') {
|
|
20
|
+
for (const decl of node.declarations) {
|
|
21
|
+
if (decl.id.type === 'Identifier') {
|
|
22
|
+
locals.set(decl.id.name, classifyVariable(node.kind, decl.init));
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
} else if (node.type === 'ImportDeclaration') {
|
|
26
|
+
for (const spec of node.specifiers) {
|
|
27
|
+
if (spec.type === 'ImportSpecifier') {
|
|
28
|
+
locals.set(spec.local.name, { source: node.source.value, name: spec.imported.name });
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** @type {Map<string, ExportInfo | ExportLink>} */
|
|
35
|
+
const bindings = new Map();
|
|
36
|
+
/** @type {string[]} */
|
|
37
|
+
const stars = [];
|
|
38
|
+
for (const node of ast.body) {
|
|
39
|
+
if (node.type === 'ExportAllDeclaration') {
|
|
40
|
+
if (!node.exported) {
|
|
41
|
+
stars.push(node.source.value);
|
|
42
|
+
}
|
|
43
|
+
continue;
|
|
44
|
+
}
|
|
45
|
+
if (node.type !== 'ExportNamedDeclaration') continue;
|
|
46
|
+
|
|
47
|
+
if (node.declaration?.type === 'VariableDeclaration') {
|
|
48
|
+
const kind = node.declaration.kind;
|
|
49
|
+
for (const decl of node.declaration.declarations) {
|
|
50
|
+
if (decl.id.type === 'Identifier') {
|
|
51
|
+
bindings.set(decl.id.name, classifyVariable(kind, decl.init));
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
} else if (node.declaration?.type === 'FunctionDeclaration') {
|
|
55
|
+
if (node.declaration.id?.type === 'Identifier') {
|
|
56
|
+
bindings.set(node.declaration.id.name, { kind: 'function', isFn: true, isArrow: false });
|
|
57
|
+
}
|
|
58
|
+
} else {
|
|
59
|
+
for (const spec of node.specifiers) {
|
|
60
|
+
if (spec.type !== 'ExportSpecifier') continue;
|
|
61
|
+
const binding = node.source
|
|
62
|
+
? { source: node.source.value, name: spec.local.name }
|
|
63
|
+
: locals.get(spec.local.name);
|
|
64
|
+
if (binding) {
|
|
65
|
+
bindings.set(spec.exported.name, binding);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
const linked = [...bindings.values()].flatMap((binding) => ('source' in binding ? [binding.source] : []));
|
|
72
|
+
const sources = [...new Set([...linked, ...stars])];
|
|
73
|
+
|
|
74
|
+
return { bindings, stars, sources };
|
|
75
|
+
};
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Renders the hoisted binding for a single export, preserving the original
|
|
3
|
+
* declaration kind and (for `const`/`let` function expressions) the function
|
|
4
|
+
* shape (arrow vs `function` expression) so callers see a callable wrapper
|
|
5
|
+
* that GAS recognizes as a function.
|
|
6
|
+
*
|
|
7
|
+
* @param {string} name
|
|
8
|
+
* @param {ExportInfo} info
|
|
9
|
+
* @param {string} varName
|
|
10
|
+
* @returns {string}
|
|
11
|
+
*/
|
|
12
|
+
export const emitWrapper = (name, info, varName) => {
|
|
13
|
+
if (info.kind === 'function') {
|
|
14
|
+
return `function ${name}(...args){return ${varName}.${name}(...args)}`;
|
|
15
|
+
}
|
|
16
|
+
if (info.isFn) {
|
|
17
|
+
if (info.isArrow) {
|
|
18
|
+
return `${info.kind} ${name} = (...args) => ${varName}.${name}(...args)`;
|
|
19
|
+
}
|
|
20
|
+
return `${info.kind} ${name} = function(...args){return ${varName}.${name}(...args)}`;
|
|
21
|
+
}
|
|
22
|
+
return `${info.kind} ${name} = ${varName}.${name}`;
|
|
23
|
+
};
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { emitWrapper } from './emit-wrapper.js';
|
|
2
|
+
import { resolveExportKind } from './resolve-export-kind.js';
|
|
3
|
+
|
|
4
|
+
/** @typedef {{ level: 'info' | 'warn', message: string }} HoistLog */
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Appends kind-appropriate global hoist bindings for each entry export,
|
|
8
|
+
* skipping unsupported patterns (e.g. `export default`, `export class`)
|
|
9
|
+
* whose declaration kind cannot be resolved.
|
|
10
|
+
*
|
|
11
|
+
* @param {string} code
|
|
12
|
+
* @param {import('rollup').RenderedChunk} chunk
|
|
13
|
+
* @param {import('rollup').NormalizedOutputOptions} options
|
|
14
|
+
* @param {Map<string, ModuleRecord>} modules
|
|
15
|
+
* @returns {{ output: string | null, logs: HoistLog[] }}
|
|
16
|
+
*/
|
|
17
|
+
export const hoistExports = (code, chunk, options, modules) => {
|
|
18
|
+
if (options.format !== 'iife' || !chunk.isEntry) return { output: null, logs: [] };
|
|
19
|
+
|
|
20
|
+
/** @type {Array<{ name: string, info: ExportInfo }>} */
|
|
21
|
+
const known = [];
|
|
22
|
+
/** @type {string[]} */
|
|
23
|
+
const skipped = [];
|
|
24
|
+
|
|
25
|
+
for (const name of chunk.exports) {
|
|
26
|
+
const info = resolveExportKind(modules, chunk.facadeModuleId, name);
|
|
27
|
+
if (info) {
|
|
28
|
+
known.push({ name, info });
|
|
29
|
+
} else {
|
|
30
|
+
skipped.push(name);
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** @type {HoistLog[]} */
|
|
35
|
+
const logs = [];
|
|
36
|
+
|
|
37
|
+
if (known.length > 0) {
|
|
38
|
+
const label = known.length === 1 ? 'export' : 'exports';
|
|
39
|
+
const list = known.map(({ name, info }) => ` - ${name} (${info.kind})`).join('\n');
|
|
40
|
+
logs.push({ level: 'info', message: `Hoisted ${known.length} ${label} to global scope:\n${list}` });
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
if (skipped.length > 0) {
|
|
44
|
+
const label = skipped.length === 1 ? 'export' : 'exports';
|
|
45
|
+
const list = skipped.map((name) => ` - ${name}`).join('\n');
|
|
46
|
+
logs.push({ level: 'warn', message: `Skipped ${skipped.length} ${label} (unsupported pattern):\n${list}` });
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
if (known.length === 0) return { output: null, logs };
|
|
50
|
+
|
|
51
|
+
const wrappers = known.map(({ name, info }) => emitWrapper(name, info, options.name)).join('\n');
|
|
52
|
+
|
|
53
|
+
return { output: `${code}\n${wrappers}\n`, logs };
|
|
54
|
+
};
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/** @typedef {ModuleExports & { resolutions: Array<{ id: string } | null> }} ModuleRecord */
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Resolves the declaration kind of a module's export, following re-exports
|
|
5
|
+
* to the module that declares it.
|
|
6
|
+
*
|
|
7
|
+
* @param {Map<string, ModuleRecord>} modules
|
|
8
|
+
* @param {string | null | undefined} id
|
|
9
|
+
* @param {string} name
|
|
10
|
+
* @param {Set<string>} [seen]
|
|
11
|
+
* @returns {ExportInfo | undefined}
|
|
12
|
+
*/
|
|
13
|
+
export const resolveExportKind = (modules, id, name, seen = new Set()) => {
|
|
14
|
+
const record = modules.get(id);
|
|
15
|
+
const key = `${id}\0${name}`;
|
|
16
|
+
if (!record || seen.has(key)) return undefined;
|
|
17
|
+
seen.add(key);
|
|
18
|
+
|
|
19
|
+
/** @param {string} source */
|
|
20
|
+
const idOf = (source) => record.resolutions[record.sources.indexOf(source)]?.id;
|
|
21
|
+
|
|
22
|
+
const binding = record.bindings.get(name);
|
|
23
|
+
if (binding) {
|
|
24
|
+
return 'source' in binding ? resolveExportKind(modules, idOf(binding.source), binding.name, seen) : binding;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
// `export *` never re-exports the default export.
|
|
28
|
+
if (name === 'default') return undefined;
|
|
29
|
+
|
|
30
|
+
for (const source of record.stars) {
|
|
31
|
+
const info = resolveExportKind(modules, idOf(source), name, seen);
|
|
32
|
+
if (info) return info;
|
|
33
|
+
}
|
|
34
|
+
return undefined;
|
|
35
|
+
};
|
package/package.json
CHANGED
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "vite-plugin-gas-hoist",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "A Vite plugin that hoists entry point exports to the global scope for Google Apps Script",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"vite-plugin",
|
|
7
|
+
"rollup-plugin",
|
|
8
|
+
"rolldown-plugin",
|
|
7
9
|
"vite",
|
|
8
10
|
"google-apps-script",
|
|
9
11
|
"gas",
|
|
@@ -16,12 +18,13 @@
|
|
|
16
18
|
"url": "git+https://github.com/hd140283/vite-plugin-gas-hoist.git"
|
|
17
19
|
},
|
|
18
20
|
"type": "module",
|
|
19
|
-
"main": "./
|
|
21
|
+
"main": "./index.js",
|
|
20
22
|
"exports": {
|
|
21
|
-
".": "./
|
|
23
|
+
".": "./index.js"
|
|
22
24
|
},
|
|
23
25
|
"files": [
|
|
24
|
-
"
|
|
26
|
+
"index.js",
|
|
27
|
+
"lib"
|
|
25
28
|
],
|
|
26
29
|
"engines": {
|
|
27
30
|
"node": ">=22"
|
|
@@ -40,18 +43,35 @@
|
|
|
40
43
|
},
|
|
41
44
|
"compatiblePackages": {
|
|
42
45
|
"schemaVersion": 1,
|
|
46
|
+
"vite": {
|
|
47
|
+
"type": "compatible",
|
|
48
|
+
"versions": "^6.0.0 || ^7.0.0 || ^8.0.0"
|
|
49
|
+
},
|
|
43
50
|
"rollup": {
|
|
44
|
-
"type": "
|
|
45
|
-
"
|
|
51
|
+
"type": "compatible",
|
|
52
|
+
"versions": "^4.0.0"
|
|
46
53
|
},
|
|
47
54
|
"rolldown": {
|
|
48
|
-
"type": "
|
|
49
|
-
"
|
|
55
|
+
"type": "compatible",
|
|
56
|
+
"versions": "^1.0.0"
|
|
50
57
|
}
|
|
51
58
|
},
|
|
52
59
|
"peerDependencies": {
|
|
60
|
+
"rolldown": "^1.0.0",
|
|
61
|
+
"rollup": "^4.0.0",
|
|
53
62
|
"vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
|
|
54
63
|
},
|
|
64
|
+
"peerDependenciesMeta": {
|
|
65
|
+
"rolldown": {
|
|
66
|
+
"optional": true
|
|
67
|
+
},
|
|
68
|
+
"rollup": {
|
|
69
|
+
"optional": true
|
|
70
|
+
},
|
|
71
|
+
"vite": {
|
|
72
|
+
"optional": true
|
|
73
|
+
}
|
|
74
|
+
},
|
|
55
75
|
"devDependencies": {
|
|
56
76
|
"@biomejs/biome": "^2.6.8",
|
|
57
77
|
"acorn": "^8.16.0",
|
package/src/index.js
DELETED
|
@@ -1,189 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Vite plugin for Google Apps Script.
|
|
3
|
-
* Hoists entry point exports to the GAS global scope.
|
|
4
|
-
*
|
|
5
|
-
* @example
|
|
6
|
-
* // vite.config.js
|
|
7
|
-
* import { vitePluginGasHoist } from 'vite-plugin-gas-hoist';
|
|
8
|
-
*
|
|
9
|
-
* export default defineConfig({
|
|
10
|
-
* plugins: [vitePluginGasHoist()],
|
|
11
|
-
* build: {
|
|
12
|
-
* lib: {
|
|
13
|
-
* entry: 'src/main.js',
|
|
14
|
-
* formats: ['iife'],
|
|
15
|
-
* name: 'lib_',
|
|
16
|
-
* },
|
|
17
|
-
* },
|
|
18
|
-
* });
|
|
19
|
-
*
|
|
20
|
-
* @returns {import('vite').Plugin}
|
|
21
|
-
*/
|
|
22
|
-
/** @typedef {'function' | 'const' | 'let' | 'var'} ExportKind */
|
|
23
|
-
/** @typedef {{ kind: ExportKind, isFn: boolean, isArrow: boolean }} ExportInfo */
|
|
24
|
-
export const vitePluginGasHoist = () => {
|
|
25
|
-
/** @type {string} IIFE variable name from build.lib.name */
|
|
26
|
-
let varName;
|
|
27
|
-
|
|
28
|
-
/** @type {Map<string, ExportInfo>} */
|
|
29
|
-
const exportKinds = new Map();
|
|
30
|
-
|
|
31
|
-
return {
|
|
32
|
-
name: 'vite-plugin-gas-hoist',
|
|
33
|
-
apply: 'build',
|
|
34
|
-
|
|
35
|
-
/** @param {import('vite').ResolvedConfig} config */
|
|
36
|
-
configResolved(config) {
|
|
37
|
-
varName = config.build.lib?.name;
|
|
38
|
-
},
|
|
39
|
-
|
|
40
|
-
buildStart() {
|
|
41
|
-
exportKinds.clear();
|
|
42
|
-
},
|
|
43
|
-
|
|
44
|
-
/**
|
|
45
|
-
* Records the declaration kind of each top-level named export so that
|
|
46
|
-
* renderChunk can emit a binding that preserves the original visibility.
|
|
47
|
-
*
|
|
48
|
-
* @param {string} code
|
|
49
|
-
* @param {string} _id
|
|
50
|
-
*/
|
|
51
|
-
transform(code, _id) {
|
|
52
|
-
// Cheap pre-filter: skip modules that obviously have no exports (node_modules, virtual modules, CSS-as-JS, etc.) before paying acorn's cost.
|
|
53
|
-
if (!code.includes('export')) return null;
|
|
54
|
-
|
|
55
|
-
let ast;
|
|
56
|
-
try {
|
|
57
|
-
ast = this.parse(code);
|
|
58
|
-
} catch {
|
|
59
|
-
// Parse errors are surfaced by Vite/Rollup elsewhere; staying silent here avoids double-reporting.
|
|
60
|
-
return null;
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
/** @type {Map<string, ExportInfo>} */
|
|
64
|
-
const localKinds = new Map();
|
|
65
|
-
for (const node of ast.body) {
|
|
66
|
-
if (node.type === 'FunctionDeclaration' && node.id) {
|
|
67
|
-
localKinds.set(node.id.name, { kind: 'function', isFn: true, isArrow: false });
|
|
68
|
-
} else if (node.type === 'VariableDeclaration') {
|
|
69
|
-
for (const decl of node.declarations) {
|
|
70
|
-
if (decl.id.type === 'Identifier') {
|
|
71
|
-
localKinds.set(decl.id.name, classifyVariable(node.kind, decl.init));
|
|
72
|
-
}
|
|
73
|
-
}
|
|
74
|
-
}
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
for (const node of ast.body) {
|
|
78
|
-
if (node.type !== 'ExportNamedDeclaration') continue;
|
|
79
|
-
|
|
80
|
-
if (node.declaration?.type === 'VariableDeclaration') {
|
|
81
|
-
const kind = node.declaration.kind;
|
|
82
|
-
for (const decl of node.declaration.declarations) {
|
|
83
|
-
if (decl.id.type === 'Identifier') {
|
|
84
|
-
exportKinds.set(decl.id.name, classifyVariable(kind, decl.init));
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
} else if (node.declaration?.type === 'FunctionDeclaration') {
|
|
88
|
-
if (node.declaration.id?.type === 'Identifier') {
|
|
89
|
-
exportKinds.set(node.declaration.id.name, { kind: 'function', isFn: true, isArrow: false });
|
|
90
|
-
}
|
|
91
|
-
} else if (node.specifiers.length > 0 && !node.source) {
|
|
92
|
-
for (const spec of node.specifiers) {
|
|
93
|
-
if (spec.type !== 'ExportSpecifier') continue;
|
|
94
|
-
const info = localKinds.get(spec.local.name);
|
|
95
|
-
if (info) {
|
|
96
|
-
exportKinds.set(spec.exported.name, info);
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
return null;
|
|
102
|
-
},
|
|
103
|
-
|
|
104
|
-
renderChunk: {
|
|
105
|
-
order: 'post',
|
|
106
|
-
/**
|
|
107
|
-
* Appends kind-appropriate global hoist bindings for each entry export,
|
|
108
|
-
* skipping unsupported patterns (e.g. `export default`, `export class`,
|
|
109
|
-
* re-exports) whose declaration kind was not recorded by `transform`.
|
|
110
|
-
*
|
|
111
|
-
* @param {string} code
|
|
112
|
-
* @param {import('rollup').RenderedChunk} chunk
|
|
113
|
-
* @param {import('rollup').NormalizedOutputOptions} options
|
|
114
|
-
*/
|
|
115
|
-
handler(code, chunk, options) {
|
|
116
|
-
if (options.format !== 'iife' || !chunk.isEntry) return null;
|
|
117
|
-
|
|
118
|
-
/** @type {Array<{ name: string, info: ExportInfo }>} */
|
|
119
|
-
const known = [];
|
|
120
|
-
/** @type {string[]} */
|
|
121
|
-
const skipped = [];
|
|
122
|
-
|
|
123
|
-
for (const name of chunk.exports) {
|
|
124
|
-
const info = exportKinds.get(name);
|
|
125
|
-
if (info) {
|
|
126
|
-
known.push({ name, info });
|
|
127
|
-
} else {
|
|
128
|
-
skipped.push(name);
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
if (known.length > 0) {
|
|
133
|
-
const label = known.length === 1 ? 'export' : 'exports';
|
|
134
|
-
const list = known.map(({ name, info }) => ` - ${name} (${info.kind})`).join('\n');
|
|
135
|
-
console.log(`[vite-plugin-gas-hoist] Hoisted ${known.length} ${label} to global scope:\n${list}`);
|
|
136
|
-
}
|
|
137
|
-
|
|
138
|
-
if (skipped.length > 0) {
|
|
139
|
-
const label = skipped.length === 1 ? 'export' : 'exports';
|
|
140
|
-
const list = skipped.map((name) => ` - ${name}`).join('\n');
|
|
141
|
-
this.warn(`Skipped ${skipped.length} ${label} (unsupported pattern):\n${list}`);
|
|
142
|
-
}
|
|
143
|
-
|
|
144
|
-
if (known.length === 0) return null;
|
|
145
|
-
|
|
146
|
-
const wrappers = known.map(({ name, info }) => emitWrapper(name, info, varName)).join('\n');
|
|
147
|
-
|
|
148
|
-
return `${code}\n${wrappers}\n`;
|
|
149
|
-
},
|
|
150
|
-
},
|
|
151
|
-
};
|
|
152
|
-
};
|
|
153
|
-
|
|
154
|
-
/**
|
|
155
|
-
* Classifies a `VariableDeclaration` declarator as a value or function expression.
|
|
156
|
-
*
|
|
157
|
-
* @param {ExportKind} kind
|
|
158
|
-
* @param {import('estree').Expression | null | undefined} init
|
|
159
|
-
* @returns {ExportInfo}
|
|
160
|
-
*/
|
|
161
|
-
const classifyVariable = (kind, init) => {
|
|
162
|
-
const isArrow = init?.type === 'ArrowFunctionExpression';
|
|
163
|
-
const isFn = isArrow || init?.type === 'FunctionExpression';
|
|
164
|
-
return { kind, isFn, isArrow };
|
|
165
|
-
};
|
|
166
|
-
|
|
167
|
-
/**
|
|
168
|
-
* Renders the hoisted binding for a single export, preserving the original
|
|
169
|
-
* declaration kind and (for `const`/`let` function expressions) the function
|
|
170
|
-
* shape (arrow vs `function` expression) so callers see a callable wrapper
|
|
171
|
-
* that GAS recognizes as a function.
|
|
172
|
-
*
|
|
173
|
-
* @param {string} name
|
|
174
|
-
* @param {ExportInfo} info
|
|
175
|
-
* @param {string} varName
|
|
176
|
-
* @returns {string}
|
|
177
|
-
*/
|
|
178
|
-
const emitWrapper = (name, info, varName) => {
|
|
179
|
-
if (info.kind === 'function') {
|
|
180
|
-
return `function ${name}(...args){return ${varName}.${name}(...args)}`;
|
|
181
|
-
}
|
|
182
|
-
if (info.isFn) {
|
|
183
|
-
if (info.isArrow) {
|
|
184
|
-
return `${info.kind} ${name} = (...args) => ${varName}.${name}(...args)`;
|
|
185
|
-
}
|
|
186
|
-
return `${info.kind} ${name} = function(...args){return ${varName}.${name}(...args)}`;
|
|
187
|
-
}
|
|
188
|
-
return `${info.kind} ${name} = ${varName}.${name}`;
|
|
189
|
-
};
|