pixi.js
Version:
<p align="center"> <a href="https://pixijs.com" target="_blank" rel="noopener noreferrer"> <img height="150" src="https://files.pixijs.download/branding/pixijs-logo-transparent-dark.svg?v=1" alt="PixiJS logo"> </a> </p> <br/> <p align="center">
602 lines (598 loc) • 17.4 kB
JavaScript
;
var adapter = require('../environment/adapter.js');
;
function assertPath(path2) {
if (typeof path2 !== "string") {
throw new TypeError(`Path must be a string. Received ${JSON.stringify(path2)}`);
}
}
function removeUrlParams(url) {
const re = url.split("?")[0];
return re.split("#")[0];
}
function escapeRegExp(string) {
return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
}
function replaceAll(str, find, replace) {
return str.replace(new RegExp(escapeRegExp(find), "g"), replace);
}
function normalizeStringPosix(path2, allowAboveRoot) {
let res = "";
let lastSegmentLength = 0;
let lastSlash = -1;
let dots = 0;
let code = -1;
for (let i = 0; i <= path2.length; ++i) {
if (i < path2.length) {
code = path2.charCodeAt(i);
} else if (code === 47) {
break;
} else {
code = 47;
}
if (code === 47) {
if (lastSlash === i - 1 || dots === 1) {
} else if (lastSlash !== i - 1 && dots === 2) {
if (res.length < 2 || lastSegmentLength !== 2 || res.charCodeAt(res.length - 1) !== 46 || res.charCodeAt(res.length - 2) !== 46) {
if (res.length > 2) {
const lastSlashIndex = res.lastIndexOf("/");
if (lastSlashIndex !== res.length - 1) {
if (lastSlashIndex === -1) {
res = "";
lastSegmentLength = 0;
} else {
res = res.slice(0, lastSlashIndex);
lastSegmentLength = res.length - 1 - res.lastIndexOf("/");
}
lastSlash = i;
dots = 0;
continue;
}
} else if (res.length === 2 || res.length === 1) {
res = "";
lastSegmentLength = 0;
lastSlash = i;
dots = 0;
continue;
}
}
if (allowAboveRoot) {
if (res.length > 0) {
res += "/..";
} else {
res = "..";
}
lastSegmentLength = 2;
}
} else {
if (res.length > 0) {
res += `/${path2.slice(lastSlash + 1, i)}`;
} else {
res = path2.slice(lastSlash + 1, i);
}
lastSegmentLength = i - lastSlash - 1;
}
lastSlash = i;
dots = 0;
} else if (code === 46 && dots !== -1) {
++dots;
} else {
dots = -1;
}
}
return res;
}
const path = {
/**
* Converts a path to posix format.
* @param path - The path to convert to posix
* @example
* ```ts
* // Convert a Windows path to POSIX format
* path.toPosix('C:\\Users\\User\\Documents\\file.txt');
* // -> 'C:/Users/User/Documents/file.txt'
* ```
*/
toPosix(path2) {
return replaceAll(path2, "\\", "/");
},
/**
* Checks if the path is a URL e.g. http://, https://
* @param path - The path to check
* @example
* ```ts
* // Check if a path is a URL
* path.isUrl('http://www.example.com');
* // -> true
* path.isUrl('C:/Users/User/Documents/file.txt');
* // -> false
* ```
*/
isUrl(path2) {
return /^https?:/.test(this.toPosix(path2));
},
/**
* Checks if the path is a data URL
* @param path - The path to check
* @example
* ```ts
* // Check if a path is a data URL
* path.isDataUrl('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...');
* // -> true
* ```
*/
isDataUrl(path2) {
return /^data:([a-z]+\/[a-z0-9-+.]+(;[a-z0-9-.!#$%*+.{}|~`]+=[a-z0-9-.!#$%*+.{}()_|~`]+)*)?(;base64)?,([a-z0-9!$&',()*+;=\-._~:@\/?%\s<>]*?)$/i.test(path2);
},
/**
* Checks if the path is a blob URL
* @param path - The path to check
* @example
* ```ts
* // Check if a path is a blob URL
* path.isBlobUrl('blob:http://www.example.com/12345678-1234-1234-1234-123456789012');
* // -> true
* ```
*/
isBlobUrl(path2) {
return path2.startsWith("blob:");
},
/**
* Checks if the path has a protocol e.g. http://, https://, file:///, data:, blob:, C:/
* This will return true for windows file paths
* @param path - The path to check
* @example
* ```ts
* // Check if a path has a protocol
* path.hasProtocol('http://www.example.com');
* // -> true
* path.hasProtocol('C:/Users/User/Documents/file.txt');
* // -> true
* ```
*/
hasProtocol(path2) {
return /^[^/:]+:/.test(this.toPosix(path2));
},
/**
* Returns the protocol of the path e.g. http://, https://, file:///, data:, blob:, C:/
* @param path - The path to get the protocol from
* @example
* ```ts
* // Get the protocol from a URL
* path.getProtocol('http://www.example.com/path/to/resource');
* // -> 'http://'
* // Get the protocol from a file path
* path.getProtocol('C:/Users/User/Documents/file.txt');
* // -> 'C:/'
* ```
*/
getProtocol(path2) {
assertPath(path2);
path2 = this.toPosix(path2);
const matchFile = /^file:\/\/\//.exec(path2);
if (matchFile) {
return matchFile[0];
}
const matchProtocol = /^[^/:]+:\/{0,2}/.exec(path2);
if (matchProtocol) {
return matchProtocol[0];
}
return "";
},
/**
* Converts URL to an absolute path.
* When loading from a Web Worker, we must use absolute paths.
* If the URL is already absolute we return it as is
* If it's not, we convert it
* @param url - The URL to test
* @param customBaseUrl - The base URL to use
* @param customRootUrl - The root URL to use
* @example
* ```ts
* // Convert a relative URL to an absolute path
* path.toAbsolute('images/texture.png', 'http://example.com/assets/');
* // -> 'http://example.com/assets/images/texture.png'
* ```
*/
toAbsolute(url, customBaseUrl, customRootUrl) {
assertPath(url);
if (this.isDataUrl(url) || this.isBlobUrl(url))
return url;
const baseUrl = removeUrlParams(this.toPosix(customBaseUrl ?? adapter.DOMAdapter.get().getBaseUrl()));
const rootUrl = removeUrlParams(this.toPosix(customRootUrl ?? this.rootname(baseUrl)));
url = this.toPosix(url);
if (url.startsWith("/")) {
return path.join(rootUrl, url.slice(1));
}
const absolutePath = this.isAbsolute(url) ? url : this.join(baseUrl, url);
return absolutePath;
},
/**
* Normalizes the given path, resolving '..' and '.' segments
* @param path - The path to normalize
* @example
* ```ts
* // Normalize a path with relative segments
* path.normalize('http://www.example.com/foo/bar/../baz');
* // -> 'http://www.example.com/foo/baz'
* // Normalize a file path with relative segments
* path.normalize('C:\\Users\\User\\Documents\\..\\file.txt');
* // -> 'C:/Users/User/file.txt'
* ```
*/
normalize(path2) {
assertPath(path2);
if (path2.length === 0)
return ".";
if (this.isDataUrl(path2) || this.isBlobUrl(path2))
return path2;
path2 = this.toPosix(path2);
let protocol = "";
const isAbsolute = path2.startsWith("/");
if (this.hasProtocol(path2)) {
protocol = this.rootname(path2);
path2 = path2.slice(protocol.length);
}
const trailingSeparator = path2.endsWith("/");
path2 = normalizeStringPosix(path2, false);
if (path2.length > 0 && trailingSeparator)
path2 += "/";
if (isAbsolute)
return `/${path2}`;
return protocol + path2;
},
/**
* Determines if path is an absolute path.
* Absolute paths can be urls, data urls, or paths on disk
* @param path - The path to test
* @example
* ```ts
* // Check if a path is absolute
* path.isAbsolute('http://www.example.com/foo/bar');
* // -> true
* path.isAbsolute('C:/Users/User/Documents/file.txt');
* // -> true
* ```
*/
isAbsolute(path2) {
assertPath(path2);
path2 = this.toPosix(path2);
if (this.hasProtocol(path2))
return true;
return path2.startsWith("/");
},
/**
* Joins all given path segments together using the platform-specific separator as a delimiter,
* then normalizes the resulting path
* @param segments - The segments of the path to join
* @example
* ```ts
* // Join multiple path segments
* path.join('assets', 'images', 'sprite.png');
* // -> 'assets/images/sprite.png'
* // Join with relative segments
* path.join('assets', 'images', '../textures', 'sprite.png');
* // -> 'assets/textures/sprite.png'
* ```
*/
join(...segments) {
if (segments.length === 0) {
return ".";
}
let joined;
for (let i = 0; i < segments.length; ++i) {
const arg = segments[i];
assertPath(arg);
if (arg.length > 0) {
if (joined === void 0)
joined = arg;
else {
const prevArg = segments[i - 1] ?? "";
if (this.joinExtensions.includes(this.extname(prevArg).toLowerCase())) {
joined += `/../${arg}`;
} else {
joined += `/${arg}`;
}
}
}
}
if (joined === void 0) {
return ".";
}
return this.normalize(joined);
},
/**
* Returns the directory name of a path
* @param path - The path to parse
* @example
* ```ts
* // Get the directory name of a path
* path.dirname('http://www.example.com/foo/bar/baz.png');
* // -> 'http://www.example.com/foo/bar'
* // Get the directory name of a file path
* path.dirname('C:/Users/User/Documents/file.txt');
* // -> 'C:/Users/User/Documents'
* ```
*/
dirname(path2) {
assertPath(path2);
if (path2.length === 0)
return ".";
path2 = this.toPosix(path2);
let code = path2.charCodeAt(0);
const hasRoot = code === 47;
let end = -1;
let matchedSlash = true;
const proto = this.getProtocol(path2);
const origpath = path2;
path2 = path2.slice(proto.length);
for (let i = path2.length - 1; i >= 1; --i) {
code = path2.charCodeAt(i);
if (code === 47) {
if (!matchedSlash) {
end = i;
break;
}
} else {
matchedSlash = false;
}
}
if (end === -1)
return hasRoot ? "/" : this.isUrl(origpath) ? proto + path2 : proto;
if (hasRoot && end === 1)
return "//";
return proto + path2.slice(0, end);
},
/**
* Returns the root of the path e.g. /, C:/, file:///, http://domain.com/
* @param path - The path to parse
* @example
* ```ts
* // Get the root of a URL
* path.rootname('http://www.example.com/foo/bar/baz.png');
* // -> 'http://www.example.com/'
* // Get the root of a file path
* path.rootname('C:/Users/User/Documents/file.txt');
* // -> 'C:/'
* ```
*/
rootname(path2) {
assertPath(path2);
path2 = this.toPosix(path2);
let root = "";
if (path2.startsWith("/"))
root = "/";
else {
root = this.getProtocol(path2);
}
if (this.isUrl(path2)) {
const index = path2.indexOf("/", root.length);
if (index !== -1) {
root = path2.slice(0, index);
} else
root = path2;
if (!root.endsWith("/"))
root += "/";
}
return root;
},
/**
* Returns the last portion of a path
* @param path - The path to test
* @param ext - Optional extension to remove
* @example
* ```ts
* // Get the basename of a URL
* path.basename('http://www.example.com/foo/bar/baz.png');
* // -> 'baz.png'
* // Get the basename of a file path
* path.basename('C:/Users/User/Documents/file.txt');
* // -> 'file.txt'
* ```
*/
basename(path2, ext) {
assertPath(path2);
if (ext)
assertPath(ext);
path2 = removeUrlParams(this.toPosix(path2));
let start = 0;
let end = -1;
let matchedSlash = true;
let i;
if (ext !== void 0 && ext.length > 0 && ext.length <= path2.length) {
if (ext.length === path2.length && ext === path2)
return "";
let extIdx = ext.length - 1;
let firstNonSlashEnd = -1;
for (i = path2.length - 1; i >= 0; --i) {
const code = path2.charCodeAt(i);
if (code === 47) {
if (!matchedSlash) {
start = i + 1;
break;
}
} else {
if (firstNonSlashEnd === -1) {
matchedSlash = false;
firstNonSlashEnd = i + 1;
}
if (extIdx >= 0) {
if (code === ext.charCodeAt(extIdx)) {
if (--extIdx === -1) {
end = i;
}
} else {
extIdx = -1;
end = firstNonSlashEnd;
}
}
}
}
if (start === end)
end = firstNonSlashEnd;
else if (end === -1)
end = path2.length;
return path2.slice(start, end);
}
for (i = path2.length - 1; i >= 0; --i) {
if (path2.charCodeAt(i) === 47) {
if (!matchedSlash) {
start = i + 1;
break;
}
} else if (end === -1) {
matchedSlash = false;
end = i + 1;
}
}
if (end === -1)
return "";
return path2.slice(start, end);
},
/**
* Returns the extension of the path, from the last occurrence of the . (period) character to end of string in the last
* portion of the path. If there is no . in the last portion of the path, or if there are no . characters other than
* the first character of the basename of path, an empty string is returned.
* @param path - The path to parse
* @example
* ```ts
* // Get the extension of a URL
* path.extname('http://www.example.com/foo/bar/baz.png');
* // -> '.png'
* // Get the extension of a file path
* path.extname('C:/Users/User/Documents/file.txt');
* // -> '.txt'
* ```
*/
extname(path2) {
assertPath(path2);
path2 = removeUrlParams(this.toPosix(path2));
let startDot = -1;
let startPart = 0;
let end = -1;
let matchedSlash = true;
let preDotState = 0;
for (let i = path2.length - 1; i >= 0; --i) {
const code = path2.charCodeAt(i);
if (code === 47) {
if (!matchedSlash) {
startPart = i + 1;
break;
}
continue;
}
if (end === -1) {
matchedSlash = false;
end = i + 1;
}
if (code === 46) {
if (startDot === -1)
startDot = i;
else if (preDotState !== 1)
preDotState = 1;
} else if (startDot !== -1) {
preDotState = -1;
}
}
if (startDot === -1 || end === -1 || preDotState === 0 || preDotState === 1 && startDot === end - 1 && startDot === startPart + 1) {
return "";
}
return path2.slice(startDot, end);
},
/**
* Parses a path into an object containing the 'root', `dir`, `base`, `ext`, and `name` properties.
* @param path - The path to parse
* @example
* ```ts
* // Parse a URL
* const parsed = path.parse('http://www.example.com/foo/bar/baz.png');
* // -> {
* // root: 'http://www.example.com/',
* // dir: 'http://www.example.com/foo/bar',
* // base: 'baz.png',
* // ext: '.png',
* // name: 'baz'
* // }
* // Parse a file path
* const parsedFile = path.parse('C:/Users/User/Documents/file.txt');
* // -> {
* // root: 'C:/',
* // dir: 'C:/Users/User/Documents',
* // base: 'file.txt',
* // ext: '.txt',
* // name: 'file'
* // }
* ```
*/
parse(path2) {
assertPath(path2);
const ret = { root: "", dir: "", base: "", ext: "", name: "" };
if (path2.length === 0)
return ret;
path2 = removeUrlParams(this.toPosix(path2));
let code = path2.charCodeAt(0);
const isAbsolute = this.isAbsolute(path2);
let start;
const protocol = "";
ret.root = this.rootname(path2);
if (isAbsolute || this.hasProtocol(path2)) {
start = 1;
} else {
start = 0;
}
let startDot = -1;
let startPart = 0;
let end = -1;
let matchedSlash = true;
let i = path2.length - 1;
let preDotState = 0;
for (; i >= start; --i) {
code = path2.charCodeAt(i);
if (code === 47) {
if (!matchedSlash) {
startPart = i + 1;
break;
}
continue;
}
if (end === -1) {
matchedSlash = false;
end = i + 1;
}
if (code === 46) {
if (startDot === -1)
startDot = i;
else if (preDotState !== 1)
preDotState = 1;
} else if (startDot !== -1) {
preDotState = -1;
}
}
if (startDot === -1 || end === -1 || preDotState === 0 || preDotState === 1 && startDot === end - 1 && startDot === startPart + 1) {
if (end !== -1) {
if (startPart === 0 && isAbsolute)
ret.base = ret.name = path2.slice(1, end);
else
ret.base = ret.name = path2.slice(startPart, end);
}
} else {
if (startPart === 0 && isAbsolute) {
ret.name = path2.slice(1, startDot);
ret.base = path2.slice(1, end);
} else {
ret.name = path2.slice(startPart, startDot);
ret.base = path2.slice(startPart, end);
}
ret.ext = path2.slice(startDot, end);
}
ret.dir = this.dirname(path2);
if (protocol)
ret.dir = protocol + ret.dir;
return ret;
},
sep: "/",
delimiter: ":",
joinExtensions: [".html"]
};
exports.path = path;
//# sourceMappingURL=path.js.map