@tybys/wasm-util 0.5.2 → 0.6.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.
Files changed (40) hide show
  1. package/README.md +193 -193
  2. package/dist/tsdoc-metadata.json +1 -1
  3. package/dist/wasm-util.esm-bundler.js +2605 -2479
  4. package/dist/wasm-util.esm.js +2605 -2479
  5. package/dist/wasm-util.esm.min.js +1 -1
  6. package/dist/wasm-util.js +2605 -2479
  7. package/dist/wasm-util.min.js +1 -1
  8. package/lib/cjs/asyncify.js +157 -157
  9. package/lib/cjs/index.js +12 -12
  10. package/lib/cjs/jspi.js +45 -45
  11. package/lib/cjs/load.js +85 -82
  12. package/lib/cjs/memory.js +34 -34
  13. package/lib/cjs/wasi/error.js +102 -102
  14. package/lib/cjs/wasi/fd.js +267 -267
  15. package/lib/cjs/wasi/fs.js +2 -2
  16. package/lib/cjs/wasi/index.js +168 -168
  17. package/lib/cjs/wasi/path.js +173 -173
  18. package/lib/cjs/wasi/preview1.js +1478 -1369
  19. package/lib/cjs/wasi/rights.js +139 -139
  20. package/lib/cjs/wasi/types.js +219 -209
  21. package/lib/cjs/wasi/util.js +121 -67
  22. package/lib/cjs/webassembly.js +12 -12
  23. package/lib/mjs/asyncify.mjs +153 -153
  24. package/lib/mjs/index.mjs +9 -9
  25. package/lib/mjs/jspi.mjs +39 -39
  26. package/lib/mjs/load.mjs +78 -75
  27. package/lib/mjs/memory.mjs +28 -28
  28. package/lib/mjs/wasi/error.mjs +97 -97
  29. package/lib/mjs/wasi/fd.mjs +256 -256
  30. package/lib/mjs/wasi/fs.mjs +1 -1
  31. package/lib/mjs/wasi/index.mjs +164 -164
  32. package/lib/mjs/wasi/path.mjs +168 -168
  33. package/lib/mjs/wasi/preview1.mjs +1474 -1365
  34. package/lib/mjs/wasi/rights.mjs +134 -134
  35. package/lib/mjs/wasi/types.mjs +216 -206
  36. package/lib/mjs/wasi/util.mjs +108 -55
  37. package/lib/mjs/webassembly.mjs +9 -9
  38. package/package.json +58 -54
  39. package/lib/cjs/memfs.js +0 -2689
  40. package/lib/mjs/memfs.mjs +0 -2688
@@ -1,164 +1,164 @@
1
- import { WASI as _WASI } from "./preview1.mjs";
2
- import { validateObject, validateArray, validateBoolean, validateFunction, validateUndefined } from "./util.mjs";
3
- // eslint-disable-next-line spaced-comment
4
- const kEmptyObject = /*#__PURE__*/ Object.freeze(/*#__PURE__*/ Object.create(null));
5
- const kExitCode = Symbol('kExitCode');
6
- const kSetMemory = Symbol('kSetMemory');
7
- const kStarted = Symbol('kStarted');
8
- const kInstance = Symbol('kInstance');
9
- function setupInstance(self, instance) {
10
- validateObject(instance, 'instance');
11
- validateObject(instance.exports, 'instance.exports');
12
- self[kInstance] = instance;
13
- self[kSetMemory](instance.exports.memory);
14
- }
15
- // /** @public */
16
- // export type WasiSnapshotPreview1 = Omit<_WASI, '_setMemory'>
17
- function validateOptions(options) {
18
- var _a;
19
- validateObject(options, 'options');
20
- if (options.args !== undefined) {
21
- validateArray(options.args, 'options.args');
22
- }
23
- const args = ((_a = options.args) !== null && _a !== void 0 ? _a : []).map(String);
24
- const env = [];
25
- if (options.env !== undefined) {
26
- validateObject(options.env, 'options.env');
27
- Object.entries(options.env).forEach(({ 0: key, 1: value }) => {
28
- if (value !== undefined) {
29
- env.push(`${key}=${value}`);
30
- }
31
- });
32
- }
33
- const preopens = [];
34
- if (options.preopens !== undefined) {
35
- validateObject(options.preopens, 'options.preopens');
36
- Object.entries(options.preopens).forEach(({ 0: key, 1: value }) => preopens.push({ mappedPath: String(key), realPath: String(value) }));
37
- }
38
- if (preopens.length > 0) {
39
- if (options.fs === undefined) {
40
- throw new Error('filesystem is disabled, can not preopen directory');
41
- }
42
- try {
43
- validateObject(options.fs, 'options.fs');
44
- }
45
- catch (_) {
46
- throw new TypeError('Node.js fs like implementation is not provided');
47
- }
48
- }
49
- // if (options.filesystem !== undefined) {
50
- // validateObject(options.filesystem, 'options.filesystem')
51
- // validateString(options.filesystem.type, 'options.filesystem.type')
52
- // if (options.filesystem.type !== 'memfs' && options.filesystem.type !== 'file-system-access-api') {
53
- // throw new Error(`Filesystem type ${(options.filesystem as any).type as string} is not supported, only "memfs" and "file-system-access-api" is supported currently`)
54
- // }
55
- // try {
56
- // validateObject(options.filesystem.fs, 'options.filesystem.fs')
57
- // } catch (_) {
58
- // throw new Error('Node.js fs like implementation is not provided')
59
- // }
60
- // }
61
- if (options.print !== undefined)
62
- validateFunction(options.print, 'options.print');
63
- if (options.printErr !== undefined)
64
- validateFunction(options.printErr, 'options.printErr');
65
- if (options.returnOnExit !== undefined) {
66
- validateBoolean(options.returnOnExit, 'options.returnOnExit');
67
- }
68
- // const { stdin = 0, stdout = 1, stderr = 2 } = options
69
- // validateInt32(stdin, 'options.stdin', 0)
70
- // validateInt32(stdout, 'options.stdout', 0)
71
- // validateInt32(stderr, 'options.stderr', 0)
72
- // const stdio = [stdin, stdout, stderr] as const
73
- const stdio = [0, 1, 2];
74
- return {
75
- args,
76
- env,
77
- preopens,
78
- stdio
79
- };
80
- }
81
- /** @public */
82
- export class WASI {
83
- constructor(setMemory, wrap) {
84
- this[kSetMemory] = setMemory;
85
- this.wasiImport = wrap;
86
- this[kStarted] = false;
87
- this[kExitCode] = 0;
88
- this[kInstance] = undefined;
89
- }
90
- static createSync(options = kEmptyObject) {
91
- const { args, env, preopens, stdio } = validateOptions(options);
92
- const wrap = _WASI.createSync(args, env, preopens, stdio, options.fs, options.print, options.printErr);
93
- const setMemory = wrap._setMemory;
94
- delete wrap._setMemory;
95
- const _this = new WASI(setMemory, wrap);
96
- if (options.returnOnExit) {
97
- wrap.proc_exit = wasiReturnOnProcExit.bind(_this);
98
- }
99
- return _this;
100
- }
101
- static async createAsync(options = kEmptyObject) {
102
- const { args, env, preopens, stdio } = validateOptions(options);
103
- if (options.asyncify !== undefined) {
104
- validateObject(options.asyncify, 'options.asyncify');
105
- validateFunction(options.asyncify.wrapImportFunction, 'options.asyncify.wrapImportFunction');
106
- }
107
- const wrap = await _WASI.createAsync(args, env, preopens, stdio, options.fs, options.print, options.printErr, options.asyncify);
108
- const setMemory = wrap._setMemory;
109
- delete wrap._setMemory;
110
- const _this = new WASI(setMemory, wrap);
111
- if (options.returnOnExit) {
112
- wrap.proc_exit = wasiReturnOnProcExit.bind(_this);
113
- }
114
- return _this;
115
- }
116
- // Must not export _initialize, must export _start
117
- start(instance) {
118
- if (this[kStarted]) {
119
- throw new Error('WASI instance has already started');
120
- }
121
- this[kStarted] = true;
122
- setupInstance(this, instance);
123
- const { _start, _initialize } = this[kInstance].exports;
124
- validateFunction(_start, 'instance.exports._start');
125
- validateUndefined(_initialize, 'instance.exports._initialize');
126
- let ret;
127
- try {
128
- ret = _start();
129
- }
130
- catch (err) {
131
- if (err !== kExitCode) {
132
- throw err;
133
- }
134
- }
135
- if (ret instanceof Promise) {
136
- return ret.then(() => this[kExitCode], (err) => {
137
- if (err !== kExitCode) {
138
- throw err;
139
- }
140
- return this[kExitCode];
141
- });
142
- }
143
- return this[kExitCode];
144
- }
145
- // Must not export _start, may optionally export _initialize
146
- initialize(instance) {
147
- if (this[kStarted]) {
148
- throw new Error('WASI instance has already started');
149
- }
150
- this[kStarted] = true;
151
- setupInstance(this, instance);
152
- const { _start, _initialize } = this[kInstance].exports;
153
- validateUndefined(_start, 'instance.exports._start');
154
- if (_initialize !== undefined) {
155
- validateFunction(_initialize, 'instance.exports._initialize');
156
- return _initialize();
157
- }
158
- }
159
- }
160
- function wasiReturnOnProcExit(rval) {
161
- this[kExitCode] = rval;
162
- // eslint-disable-next-line @typescript-eslint/no-throw-literal
163
- throw kExitCode;
164
- }
1
+ import { WASI as _WASI } from "./preview1.mjs";
2
+ import { validateObject, validateArray, validateBoolean, validateFunction, validateUndefined } from "./util.mjs";
3
+ // eslint-disable-next-line spaced-comment
4
+ const kEmptyObject = /*#__PURE__*/ Object.freeze(/*#__PURE__*/ Object.create(null));
5
+ const kExitCode = Symbol('kExitCode');
6
+ const kSetMemory = Symbol('kSetMemory');
7
+ const kStarted = Symbol('kStarted');
8
+ const kInstance = Symbol('kInstance');
9
+ function setupInstance(self, instance) {
10
+ validateObject(instance, 'instance');
11
+ validateObject(instance.exports, 'instance.exports');
12
+ self[kInstance] = instance;
13
+ self[kSetMemory](instance.exports.memory);
14
+ }
15
+ // /** @public */
16
+ // export type WasiSnapshotPreview1 = Omit<_WASI, '_setMemory'>
17
+ function validateOptions(options) {
18
+ var _a;
19
+ validateObject(options, 'options');
20
+ if (options.args !== undefined) {
21
+ validateArray(options.args, 'options.args');
22
+ }
23
+ const args = ((_a = options.args) !== null && _a !== void 0 ? _a : []).map(String);
24
+ const env = [];
25
+ if (options.env !== undefined) {
26
+ validateObject(options.env, 'options.env');
27
+ Object.entries(options.env).forEach(({ 0: key, 1: value }) => {
28
+ if (value !== undefined) {
29
+ env.push(`${key}=${value}`);
30
+ }
31
+ });
32
+ }
33
+ const preopens = [];
34
+ if (options.preopens !== undefined) {
35
+ validateObject(options.preopens, 'options.preopens');
36
+ Object.entries(options.preopens).forEach(({ 0: key, 1: value }) => preopens.push({ mappedPath: String(key), realPath: String(value) }));
37
+ }
38
+ if (preopens.length > 0) {
39
+ if (options.fs === undefined) {
40
+ throw new Error('filesystem is disabled, can not preopen directory');
41
+ }
42
+ try {
43
+ validateObject(options.fs, 'options.fs');
44
+ }
45
+ catch (_) {
46
+ throw new TypeError('Node.js fs like implementation is not provided');
47
+ }
48
+ }
49
+ // if (options.filesystem !== undefined) {
50
+ // validateObject(options.filesystem, 'options.filesystem')
51
+ // validateString(options.filesystem.type, 'options.filesystem.type')
52
+ // if (options.filesystem.type !== 'memfs' && options.filesystem.type !== 'file-system-access-api') {
53
+ // throw new Error(`Filesystem type ${(options.filesystem as any).type as string} is not supported, only "memfs" and "file-system-access-api" is supported currently`)
54
+ // }
55
+ // try {
56
+ // validateObject(options.filesystem.fs, 'options.filesystem.fs')
57
+ // } catch (_) {
58
+ // throw new Error('Node.js fs like implementation is not provided')
59
+ // }
60
+ // }
61
+ if (options.print !== undefined)
62
+ validateFunction(options.print, 'options.print');
63
+ if (options.printErr !== undefined)
64
+ validateFunction(options.printErr, 'options.printErr');
65
+ if (options.returnOnExit !== undefined) {
66
+ validateBoolean(options.returnOnExit, 'options.returnOnExit');
67
+ }
68
+ // const { stdin = 0, stdout = 1, stderr = 2 } = options
69
+ // validateInt32(stdin, 'options.stdin', 0)
70
+ // validateInt32(stdout, 'options.stdout', 0)
71
+ // validateInt32(stderr, 'options.stderr', 0)
72
+ // const stdio = [stdin, stdout, stderr] as const
73
+ const stdio = [0, 1, 2];
74
+ return {
75
+ args,
76
+ env,
77
+ preopens,
78
+ stdio
79
+ };
80
+ }
81
+ /** @public */
82
+ export class WASI {
83
+ constructor(setMemory, wrap) {
84
+ this[kSetMemory] = setMemory;
85
+ this.wasiImport = wrap;
86
+ this[kStarted] = false;
87
+ this[kExitCode] = 0;
88
+ this[kInstance] = undefined;
89
+ }
90
+ static createSync(options = kEmptyObject) {
91
+ const { args, env, preopens, stdio } = validateOptions(options);
92
+ const wrap = _WASI.createSync(args, env, preopens, stdio, options.fs, options.print, options.printErr);
93
+ const setMemory = wrap._setMemory;
94
+ delete wrap._setMemory;
95
+ const _this = new WASI(setMemory, wrap);
96
+ if (options.returnOnExit) {
97
+ wrap.proc_exit = wasiReturnOnProcExit.bind(_this);
98
+ }
99
+ return _this;
100
+ }
101
+ static async createAsync(options = kEmptyObject) {
102
+ const { args, env, preopens, stdio } = validateOptions(options);
103
+ if (options.asyncify !== undefined) {
104
+ validateObject(options.asyncify, 'options.asyncify');
105
+ validateFunction(options.asyncify.wrapImportFunction, 'options.asyncify.wrapImportFunction');
106
+ }
107
+ const wrap = await _WASI.createAsync(args, env, preopens, stdio, options.fs, options.print, options.printErr, options.asyncify);
108
+ const setMemory = wrap._setMemory;
109
+ delete wrap._setMemory;
110
+ const _this = new WASI(setMemory, wrap);
111
+ if (options.returnOnExit) {
112
+ wrap.proc_exit = wasiReturnOnProcExit.bind(_this);
113
+ }
114
+ return _this;
115
+ }
116
+ // Must not export _initialize, must export _start
117
+ start(instance) {
118
+ if (this[kStarted]) {
119
+ throw new Error('WASI instance has already started');
120
+ }
121
+ this[kStarted] = true;
122
+ setupInstance(this, instance);
123
+ const { _start, _initialize } = this[kInstance].exports;
124
+ validateFunction(_start, 'instance.exports._start');
125
+ validateUndefined(_initialize, 'instance.exports._initialize');
126
+ let ret;
127
+ try {
128
+ ret = _start();
129
+ }
130
+ catch (err) {
131
+ if (err !== kExitCode) {
132
+ throw err;
133
+ }
134
+ }
135
+ if (ret instanceof Promise) {
136
+ return ret.then(() => this[kExitCode], (err) => {
137
+ if (err !== kExitCode) {
138
+ throw err;
139
+ }
140
+ return this[kExitCode];
141
+ });
142
+ }
143
+ return this[kExitCode];
144
+ }
145
+ // Must not export _start, may optionally export _initialize
146
+ initialize(instance) {
147
+ if (this[kStarted]) {
148
+ throw new Error('WASI instance has already started');
149
+ }
150
+ this[kStarted] = true;
151
+ setupInstance(this, instance);
152
+ const { _start, _initialize } = this[kInstance].exports;
153
+ validateUndefined(_start, 'instance.exports._start');
154
+ if (_initialize !== undefined) {
155
+ validateFunction(_initialize, 'instance.exports._initialize');
156
+ return _initialize();
157
+ }
158
+ }
159
+ }
160
+ function wasiReturnOnProcExit(rval) {
161
+ this[kExitCode] = rval;
162
+ // eslint-disable-next-line @typescript-eslint/no-throw-literal
163
+ throw kExitCode;
164
+ }
@@ -1,168 +1,168 @@
1
- import { validateString } from "./util.mjs";
2
- const CHAR_DOT = 46; /* . */
3
- const CHAR_FORWARD_SLASH = 47; /* / */
4
- function isPosixPathSeparator(code) {
5
- return code === CHAR_FORWARD_SLASH;
6
- }
7
- function normalizeString(path, allowAboveRoot, separator, isPathSeparator) {
8
- let res = '';
9
- let lastSegmentLength = 0;
10
- let lastSlash = -1;
11
- let dots = 0;
12
- let code = 0;
13
- for (let i = 0; i <= path.length; ++i) {
14
- if (i < path.length) {
15
- code = path.charCodeAt(i);
16
- }
17
- else if (isPathSeparator(code)) {
18
- break;
19
- }
20
- else {
21
- code = CHAR_FORWARD_SLASH;
22
- }
23
- if (isPathSeparator(code)) {
24
- if (lastSlash === i - 1 || dots === 1) {
25
- // NOOP
26
- }
27
- else if (dots === 2) {
28
- if (res.length < 2 || lastSegmentLength !== 2 ||
29
- res.charCodeAt(res.length - 1) !== CHAR_DOT ||
30
- res.charCodeAt(res.length - 2) !== CHAR_DOT) {
31
- if (res.length > 2) {
32
- const lastSlashIndex = res.indexOf(separator);
33
- if (lastSlashIndex === -1) {
34
- res = '';
35
- lastSegmentLength = 0;
36
- }
37
- else {
38
- res = res.slice(0, lastSlashIndex);
39
- lastSegmentLength =
40
- res.length - 1 - res.indexOf(separator);
41
- }
42
- lastSlash = i;
43
- dots = 0;
44
- continue;
45
- }
46
- else if (res.length !== 0) {
47
- res = '';
48
- lastSegmentLength = 0;
49
- lastSlash = i;
50
- dots = 0;
51
- continue;
52
- }
53
- }
54
- if (allowAboveRoot) {
55
- res += res.length > 0 ? `${separator}..` : '..';
56
- lastSegmentLength = 2;
57
- }
58
- }
59
- else {
60
- if (res.length > 0) {
61
- res += `${separator}${path.slice(lastSlash + 1, i)}`;
62
- }
63
- else {
64
- res = path.slice(lastSlash + 1, i);
65
- }
66
- lastSegmentLength = i - lastSlash - 1;
67
- }
68
- lastSlash = i;
69
- dots = 0;
70
- }
71
- else if (code === CHAR_DOT && dots !== -1) {
72
- ++dots;
73
- }
74
- else {
75
- dots = -1;
76
- }
77
- }
78
- return res;
79
- }
80
- export function resolve(...args) {
81
- let resolvedPath = '';
82
- let resolvedAbsolute = false;
83
- for (let i = args.length - 1; i >= -1 && !resolvedAbsolute; i--) {
84
- const path = i >= 0 ? args[i] : '/';
85
- validateString(path, 'path');
86
- // Skip empty entries
87
- if (path.length === 0) {
88
- continue;
89
- }
90
- resolvedPath = `${path}/${resolvedPath}`;
91
- resolvedAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
92
- }
93
- // At this point the path should be resolved to a full absolute path, but
94
- // handle relative paths to be safe (might happen when process.cwd() fails)
95
- // Normalize the path
96
- resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute, '/', isPosixPathSeparator);
97
- if (resolvedAbsolute) {
98
- return `/${resolvedPath}`;
99
- }
100
- return resolvedPath.length > 0 ? resolvedPath : '.';
101
- }
102
- export function relative(from, to) {
103
- validateString(from, 'from');
104
- validateString(to, 'to');
105
- if (from === to)
106
- return '';
107
- // Trim leading forward slashes.
108
- from = resolve(from);
109
- to = resolve(to);
110
- if (from === to)
111
- return '';
112
- const fromStart = 1;
113
- const fromEnd = from.length;
114
- const fromLen = fromEnd - fromStart;
115
- const toStart = 1;
116
- const toLen = to.length - toStart;
117
- // Compare paths to find the longest common path from root
118
- const length = (fromLen < toLen ? fromLen : toLen);
119
- let lastCommonSep = -1;
120
- let i = 0;
121
- for (; i < length; i++) {
122
- const fromCode = from.charCodeAt(fromStart + i);
123
- if (fromCode !== to.charCodeAt(toStart + i)) {
124
- break;
125
- }
126
- else if (fromCode === CHAR_FORWARD_SLASH) {
127
- lastCommonSep = i;
128
- }
129
- }
130
- if (i === length) {
131
- if (toLen > length) {
132
- if (to.charCodeAt(toStart + i) === CHAR_FORWARD_SLASH) {
133
- // We get here if `from` is the exact base path for `to`.
134
- // For example: from='/foo/bar'; to='/foo/bar/baz'
135
- return to.slice(toStart + i + 1);
136
- }
137
- if (i === 0) {
138
- // We get here if `from` is the root
139
- // For example: from='/'; to='/foo'
140
- return to.slice(toStart + i);
141
- }
142
- }
143
- else if (fromLen > length) {
144
- if (from.charCodeAt(fromStart + i) === CHAR_FORWARD_SLASH) {
145
- // We get here if `to` is the exact base path for `from`.
146
- // For example: from='/foo/bar/baz'; to='/foo/bar'
147
- lastCommonSep = i;
148
- }
149
- else if (i === 0) {
150
- // We get here if `to` is the root.
151
- // For example: from='/foo/bar'; to='/'
152
- lastCommonSep = 0;
153
- }
154
- }
155
- }
156
- let out = '';
157
- // Generate the relative path based on the path difference between `to`
158
- // and `from`.
159
- for (i = fromStart + lastCommonSep + 1; i <= fromEnd; ++i) {
160
- if (i === fromEnd ||
161
- from.charCodeAt(i) === CHAR_FORWARD_SLASH) {
162
- out += out.length === 0 ? '..' : '/..';
163
- }
164
- }
165
- // Lastly, append the rest of the destination (`to`) path that comes after
166
- // the common path parts.
167
- return `${out}${to.slice(toStart + lastCommonSep)}`;
168
- }
1
+ import { validateString } from "./util.mjs";
2
+ const CHAR_DOT = 46; /* . */
3
+ const CHAR_FORWARD_SLASH = 47; /* / */
4
+ function isPosixPathSeparator(code) {
5
+ return code === CHAR_FORWARD_SLASH;
6
+ }
7
+ function normalizeString(path, allowAboveRoot, separator, isPathSeparator) {
8
+ let res = '';
9
+ let lastSegmentLength = 0;
10
+ let lastSlash = -1;
11
+ let dots = 0;
12
+ let code = 0;
13
+ for (let i = 0; i <= path.length; ++i) {
14
+ if (i < path.length) {
15
+ code = path.charCodeAt(i);
16
+ }
17
+ else if (isPathSeparator(code)) {
18
+ break;
19
+ }
20
+ else {
21
+ code = CHAR_FORWARD_SLASH;
22
+ }
23
+ if (isPathSeparator(code)) {
24
+ if (lastSlash === i - 1 || dots === 1) {
25
+ // NOOP
26
+ }
27
+ else if (dots === 2) {
28
+ if (res.length < 2 || lastSegmentLength !== 2 ||
29
+ res.charCodeAt(res.length - 1) !== CHAR_DOT ||
30
+ res.charCodeAt(res.length - 2) !== CHAR_DOT) {
31
+ if (res.length > 2) {
32
+ const lastSlashIndex = res.indexOf(separator);
33
+ if (lastSlashIndex === -1) {
34
+ res = '';
35
+ lastSegmentLength = 0;
36
+ }
37
+ else {
38
+ res = res.slice(0, lastSlashIndex);
39
+ lastSegmentLength =
40
+ res.length - 1 - res.indexOf(separator);
41
+ }
42
+ lastSlash = i;
43
+ dots = 0;
44
+ continue;
45
+ }
46
+ else if (res.length !== 0) {
47
+ res = '';
48
+ lastSegmentLength = 0;
49
+ lastSlash = i;
50
+ dots = 0;
51
+ continue;
52
+ }
53
+ }
54
+ if (allowAboveRoot) {
55
+ res += res.length > 0 ? `${separator}..` : '..';
56
+ lastSegmentLength = 2;
57
+ }
58
+ }
59
+ else {
60
+ if (res.length > 0) {
61
+ res += `${separator}${path.slice(lastSlash + 1, i)}`;
62
+ }
63
+ else {
64
+ res = path.slice(lastSlash + 1, i);
65
+ }
66
+ lastSegmentLength = i - lastSlash - 1;
67
+ }
68
+ lastSlash = i;
69
+ dots = 0;
70
+ }
71
+ else if (code === CHAR_DOT && dots !== -1) {
72
+ ++dots;
73
+ }
74
+ else {
75
+ dots = -1;
76
+ }
77
+ }
78
+ return res;
79
+ }
80
+ export function resolve(...args) {
81
+ let resolvedPath = '';
82
+ let resolvedAbsolute = false;
83
+ for (let i = args.length - 1; i >= -1 && !resolvedAbsolute; i--) {
84
+ const path = i >= 0 ? args[i] : '/';
85
+ validateString(path, 'path');
86
+ // Skip empty entries
87
+ if (path.length === 0) {
88
+ continue;
89
+ }
90
+ resolvedPath = `${path}/${resolvedPath}`;
91
+ resolvedAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
92
+ }
93
+ // At this point the path should be resolved to a full absolute path, but
94
+ // handle relative paths to be safe (might happen when process.cwd() fails)
95
+ // Normalize the path
96
+ resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute, '/', isPosixPathSeparator);
97
+ if (resolvedAbsolute) {
98
+ return `/${resolvedPath}`;
99
+ }
100
+ return resolvedPath.length > 0 ? resolvedPath : '.';
101
+ }
102
+ export function relative(from, to) {
103
+ validateString(from, 'from');
104
+ validateString(to, 'to');
105
+ if (from === to)
106
+ return '';
107
+ // Trim leading forward slashes.
108
+ from = resolve(from);
109
+ to = resolve(to);
110
+ if (from === to)
111
+ return '';
112
+ const fromStart = 1;
113
+ const fromEnd = from.length;
114
+ const fromLen = fromEnd - fromStart;
115
+ const toStart = 1;
116
+ const toLen = to.length - toStart;
117
+ // Compare paths to find the longest common path from root
118
+ const length = (fromLen < toLen ? fromLen : toLen);
119
+ let lastCommonSep = -1;
120
+ let i = 0;
121
+ for (; i < length; i++) {
122
+ const fromCode = from.charCodeAt(fromStart + i);
123
+ if (fromCode !== to.charCodeAt(toStart + i)) {
124
+ break;
125
+ }
126
+ else if (fromCode === CHAR_FORWARD_SLASH) {
127
+ lastCommonSep = i;
128
+ }
129
+ }
130
+ if (i === length) {
131
+ if (toLen > length) {
132
+ if (to.charCodeAt(toStart + i) === CHAR_FORWARD_SLASH) {
133
+ // We get here if `from` is the exact base path for `to`.
134
+ // For example: from='/foo/bar'; to='/foo/bar/baz'
135
+ return to.slice(toStart + i + 1);
136
+ }
137
+ if (i === 0) {
138
+ // We get here if `from` is the root
139
+ // For example: from='/'; to='/foo'
140
+ return to.slice(toStart + i);
141
+ }
142
+ }
143
+ else if (fromLen > length) {
144
+ if (from.charCodeAt(fromStart + i) === CHAR_FORWARD_SLASH) {
145
+ // We get here if `to` is the exact base path for `from`.
146
+ // For example: from='/foo/bar/baz'; to='/foo/bar'
147
+ lastCommonSep = i;
148
+ }
149
+ else if (i === 0) {
150
+ // We get here if `to` is the root.
151
+ // For example: from='/foo/bar'; to='/'
152
+ lastCommonSep = 0;
153
+ }
154
+ }
155
+ }
156
+ let out = '';
157
+ // Generate the relative path based on the path difference between `to`
158
+ // and `from`.
159
+ for (i = fromStart + lastCommonSep + 1; i <= fromEnd; ++i) {
160
+ if (i === fromEnd ||
161
+ from.charCodeAt(i) === CHAR_FORWARD_SLASH) {
162
+ out += out.length === 0 ? '..' : '/..';
163
+ }
164
+ }
165
+ // Lastly, append the rest of the destination (`to`) path that comes after
166
+ // the common path parts.
167
+ return `${out}${to.slice(toStart + lastCommonSep)}`;
168
+ }