9ebcc359ae
Implement JQHTML function cache ID system and fix bundle compilation Implement underscore prefix for system tables Fix JS syntax linter to support decorators and grant exception to Task system SPA: Update planning docs and wishlists with remaining features SPA: Document Navigation API abandonment and future enhancements Implement SPA browser integration with History API (Phase 1) Convert contacts view page to SPA action Convert clients pages to SPA actions and document conversion procedure SPA: Merge GET parameters and update documentation Implement SPA route URL generation in JavaScript and PHP Implement SPA bootstrap controller architecture Add SPA routing manual page (rsx:man spa) Add SPA routing documentation to CLAUDE.md Phase 4 Complete: Client-side SPA routing implementation Update get_routes() consumers for unified route structure Complete SPA Phase 3: PHP-side route type detection and is_spa flag Restore unified routes structure and Manifest_Query class Refactor route indexing and add SPA infrastructure Phase 3 Complete: SPA route registration in manifest Implement SPA Phase 2: Extract router code and test decorators Rename Jqhtml_Component to Component and complete SPA foundation setup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
506 lines
17 KiB
JavaScript
506 lines
17 KiB
JavaScript
/*
|
|
MIT License http://www.opensource.org/licenses/mit-license.php
|
|
Author Tobias Koppers @sokra
|
|
*/
|
|
|
|
"use strict";
|
|
|
|
const { SyncWaterfallHook } = require("tapable");
|
|
const Compilation = require("../Compilation");
|
|
const RuntimeGlobals = require("../RuntimeGlobals");
|
|
const RuntimeModule = require("../RuntimeModule");
|
|
const Template = require("../Template");
|
|
const compileBooleanMatcher = require("../util/compileBooleanMatcher");
|
|
const { chunkHasCss } = require("./CssModulesPlugin");
|
|
|
|
/** @typedef {import("../Chunk")} Chunk */
|
|
/** @typedef {import("../Chunk").ChunkId} ChunkId */
|
|
/** @typedef {import("../ChunkGraph")} ChunkGraph */
|
|
/** @typedef {import("../Module").ReadOnlyRuntimeRequirements} ReadOnlyRuntimeRequirements */
|
|
|
|
/**
|
|
* @typedef {object} CssLoadingRuntimeModulePluginHooks
|
|
* @property {SyncWaterfallHook<[string, Chunk]>} createStylesheet
|
|
* @property {SyncWaterfallHook<[string, Chunk]>} linkPreload
|
|
* @property {SyncWaterfallHook<[string, Chunk]>} linkPrefetch
|
|
*/
|
|
|
|
/** @type {WeakMap<Compilation, CssLoadingRuntimeModulePluginHooks>} */
|
|
const compilationHooksMap = new WeakMap();
|
|
|
|
class CssLoadingRuntimeModule extends RuntimeModule {
|
|
/**
|
|
* @param {Compilation} compilation the compilation
|
|
* @returns {CssLoadingRuntimeModulePluginHooks} hooks
|
|
*/
|
|
static getCompilationHooks(compilation) {
|
|
if (!(compilation instanceof Compilation)) {
|
|
throw new TypeError(
|
|
"The 'compilation' argument must be an instance of Compilation"
|
|
);
|
|
}
|
|
let hooks = compilationHooksMap.get(compilation);
|
|
if (hooks === undefined) {
|
|
hooks = {
|
|
createStylesheet: new SyncWaterfallHook(["source", "chunk"]),
|
|
linkPreload: new SyncWaterfallHook(["source", "chunk"]),
|
|
linkPrefetch: new SyncWaterfallHook(["source", "chunk"])
|
|
};
|
|
compilationHooksMap.set(compilation, hooks);
|
|
}
|
|
return hooks;
|
|
}
|
|
|
|
/**
|
|
* @param {ReadOnlyRuntimeRequirements} runtimeRequirements runtime requirements
|
|
*/
|
|
constructor(runtimeRequirements) {
|
|
super("css loading", 10);
|
|
|
|
this._runtimeRequirements = runtimeRequirements;
|
|
}
|
|
|
|
/**
|
|
* @returns {string | null} runtime code
|
|
*/
|
|
generate() {
|
|
const { _runtimeRequirements } = this;
|
|
const compilation = /** @type {Compilation} */ (this.compilation);
|
|
const chunk = /** @type {Chunk} */ (this.chunk);
|
|
const {
|
|
chunkGraph,
|
|
runtimeTemplate,
|
|
outputOptions: {
|
|
crossOriginLoading,
|
|
uniqueName,
|
|
chunkLoadTimeout: loadTimeout,
|
|
charset
|
|
}
|
|
} = compilation;
|
|
const fn = RuntimeGlobals.ensureChunkHandlers;
|
|
const conditionMap = chunkGraph.getChunkConditionMap(
|
|
chunk,
|
|
/**
|
|
* @param {Chunk} chunk the chunk
|
|
* @param {ChunkGraph} chunkGraph the chunk graph
|
|
* @returns {boolean} true, if the chunk has css
|
|
*/
|
|
(chunk, chunkGraph) =>
|
|
Boolean(chunkGraph.getChunkModulesIterableBySourceType(chunk, "css"))
|
|
);
|
|
const hasCssMatcher = compileBooleanMatcher(conditionMap);
|
|
|
|
const withLoading =
|
|
_runtimeRequirements.has(RuntimeGlobals.ensureChunkHandlers) &&
|
|
hasCssMatcher !== false;
|
|
/** @type {boolean} */
|
|
const withHmr = _runtimeRequirements.has(
|
|
RuntimeGlobals.hmrDownloadUpdateHandlers
|
|
);
|
|
/** @type {Set<ChunkId>} */
|
|
const initialChunkIds = new Set();
|
|
for (const c of chunk.getAllInitialChunks()) {
|
|
if (chunkHasCss(c, chunkGraph)) {
|
|
initialChunkIds.add(/** @type {ChunkId} */ (c.id));
|
|
}
|
|
}
|
|
|
|
if (!withLoading && !withHmr) {
|
|
return null;
|
|
}
|
|
|
|
const environment = compilation.outputOptions.environment;
|
|
const isNeutralPlatform = runtimeTemplate.isNeutralPlatform();
|
|
const withPrefetch =
|
|
this._runtimeRequirements.has(RuntimeGlobals.prefetchChunkHandlers) &&
|
|
(environment.document || isNeutralPlatform) &&
|
|
chunk.hasChildByOrder(chunkGraph, "prefetch", true, chunkHasCss);
|
|
const withPreload =
|
|
this._runtimeRequirements.has(RuntimeGlobals.preloadChunkHandlers) &&
|
|
(environment.document || isNeutralPlatform) &&
|
|
chunk.hasChildByOrder(chunkGraph, "preload", true, chunkHasCss);
|
|
|
|
const { linkPreload, linkPrefetch } =
|
|
CssLoadingRuntimeModule.getCompilationHooks(compilation);
|
|
|
|
const withFetchPriority = _runtimeRequirements.has(
|
|
RuntimeGlobals.hasFetchPriority
|
|
);
|
|
|
|
const { createStylesheet } =
|
|
CssLoadingRuntimeModule.getCompilationHooks(compilation);
|
|
|
|
const stateExpression = withHmr
|
|
? `${RuntimeGlobals.hmrRuntimeStatePrefix}_css`
|
|
: undefined;
|
|
|
|
const code = Template.asString([
|
|
"link = document.createElement('link');",
|
|
charset ? "link.charset = 'utf-8';" : "",
|
|
`if (${RuntimeGlobals.scriptNonce}) {`,
|
|
Template.indent(
|
|
`link.setAttribute("nonce", ${RuntimeGlobals.scriptNonce});`
|
|
),
|
|
"}",
|
|
uniqueName
|
|
? 'link.setAttribute("data-webpack", uniqueName + ":" + key);'
|
|
: "",
|
|
withFetchPriority
|
|
? Template.asString([
|
|
"if(fetchPriority) {",
|
|
Template.indent(
|
|
'link.setAttribute("fetchpriority", fetchPriority);'
|
|
),
|
|
"}"
|
|
])
|
|
: "",
|
|
"link.setAttribute(loadingAttribute, 1);",
|
|
'link.rel = "stylesheet";',
|
|
"link.href = url;",
|
|
crossOriginLoading
|
|
? crossOriginLoading === "use-credentials"
|
|
? 'link.crossOrigin = "use-credentials";'
|
|
: Template.asString([
|
|
"if (link.href.indexOf(window.location.origin + '/') !== 0) {",
|
|
Template.indent(
|
|
`link.crossOrigin = ${JSON.stringify(crossOriginLoading)};`
|
|
),
|
|
"}"
|
|
])
|
|
: ""
|
|
]);
|
|
|
|
return Template.asString([
|
|
"// object to store loaded and loading chunks",
|
|
"// undefined = chunk not loaded, null = chunk preloaded/prefetched",
|
|
"// [resolve, reject, Promise] = chunk loading, 0 = chunk loaded",
|
|
`var installedChunks = ${
|
|
stateExpression ? `${stateExpression} = ${stateExpression} || ` : ""
|
|
}{`,
|
|
Template.indent(
|
|
Array.from(initialChunkIds, (id) => `${JSON.stringify(id)}: 0`).join(
|
|
",\n"
|
|
)
|
|
),
|
|
"};",
|
|
"",
|
|
uniqueName
|
|
? `var uniqueName = ${JSON.stringify(
|
|
runtimeTemplate.outputOptions.uniqueName
|
|
)};`
|
|
: "// data-webpack is not used as build has no uniqueName",
|
|
withLoading || withHmr
|
|
? Template.asString([
|
|
'var loadingAttribute = "data-webpack-loading";',
|
|
`var loadStylesheet = ${runtimeTemplate.basicFunction(
|
|
`chunkId, url, done${
|
|
withFetchPriority ? ", fetchPriority" : ""
|
|
}${withHmr ? ", hmr" : ""}`,
|
|
[
|
|
'var link, needAttach, key = "chunk-" + chunkId;',
|
|
withHmr ? "if(!hmr) {" : "",
|
|
'var links = document.getElementsByTagName("link");',
|
|
"for(var i = 0; i < links.length; i++) {",
|
|
Template.indent([
|
|
"var l = links[i];",
|
|
`if(l.rel == "stylesheet" && (${
|
|
withHmr
|
|
? 'l.href.startsWith(url) || l.getAttribute("href").startsWith(url)'
|
|
: 'l.href == url || l.getAttribute("href") == url'
|
|
}${
|
|
uniqueName
|
|
? ' || l.getAttribute("data-webpack") == uniqueName + ":" + key'
|
|
: ""
|
|
})) { link = l; break; }`
|
|
]),
|
|
"}",
|
|
"if(!done) return link;",
|
|
withHmr ? "}" : "",
|
|
"if(!link) {",
|
|
Template.indent([
|
|
"needAttach = true;",
|
|
createStylesheet.call(code, /** @type {Chunk} */ (this.chunk))
|
|
]),
|
|
"}",
|
|
`var onLinkComplete = ${runtimeTemplate.basicFunction(
|
|
"prev, event",
|
|
Template.asString([
|
|
"link.onerror = link.onload = null;",
|
|
"link.removeAttribute(loadingAttribute);",
|
|
"clearTimeout(timeout);",
|
|
'if(event && event.type != "load") link.parentNode.removeChild(link)',
|
|
"done(event);",
|
|
"if(prev) return prev(event);"
|
|
])
|
|
)};`,
|
|
"if(link.getAttribute(loadingAttribute)) {",
|
|
Template.indent([
|
|
`var timeout = setTimeout(onLinkComplete.bind(null, undefined, { type: 'timeout', target: link }), ${loadTimeout});`,
|
|
"link.onerror = onLinkComplete.bind(null, link.onerror);",
|
|
"link.onload = onLinkComplete.bind(null, link.onload);"
|
|
]),
|
|
"} else onLinkComplete(undefined, { type: 'load', target: link });", // We assume any existing stylesheet is render blocking
|
|
withHmr && withFetchPriority
|
|
? 'if (hmr && hmr.getAttribute("fetchpriority")) link.setAttribute("fetchpriority", hmr.getAttribute("fetchpriority"));'
|
|
: "",
|
|
withHmr ? "hmr ? document.head.insertBefore(link, hmr) :" : "",
|
|
"needAttach && document.head.appendChild(link);",
|
|
"return link;"
|
|
]
|
|
)};`
|
|
])
|
|
: "",
|
|
withLoading
|
|
? Template.asString([
|
|
`${fn}.css = ${runtimeTemplate.basicFunction(
|
|
`chunkId, promises${withFetchPriority ? " , fetchPriority" : ""}`,
|
|
[
|
|
"// css chunk loading",
|
|
`var installedChunkData = ${RuntimeGlobals.hasOwnProperty}(installedChunks, chunkId) ? installedChunks[chunkId] : undefined;`,
|
|
'if(installedChunkData !== 0) { // 0 means "already installed".',
|
|
Template.indent([
|
|
"",
|
|
'// a Promise means "currently loading".',
|
|
"if(installedChunkData) {",
|
|
Template.indent(["promises.push(installedChunkData[2]);"]),
|
|
"} else {",
|
|
Template.indent([
|
|
hasCssMatcher === true
|
|
? "if(true) { // all chunks have CSS"
|
|
: `if(${hasCssMatcher("chunkId")}) {`,
|
|
Template.indent([
|
|
"// setup Promise in chunk cache",
|
|
`var promise = new Promise(${runtimeTemplate.expressionFunction(
|
|
"installedChunkData = installedChunks[chunkId] = [resolve, reject]",
|
|
"resolve, reject"
|
|
)});`,
|
|
"promises.push(installedChunkData[2] = promise);",
|
|
"",
|
|
"// start chunk loading",
|
|
`var url = ${RuntimeGlobals.publicPath} + ${RuntimeGlobals.getChunkCssFilename}(chunkId);`,
|
|
"// create error before stack unwound to get useful stacktrace later",
|
|
"var error = new Error();",
|
|
`var loadingEnded = ${runtimeTemplate.basicFunction(
|
|
"event",
|
|
[
|
|
`if(${RuntimeGlobals.hasOwnProperty}(installedChunks, chunkId)) {`,
|
|
Template.indent([
|
|
"installedChunkData = installedChunks[chunkId];",
|
|
"if(installedChunkData !== 0) installedChunks[chunkId] = undefined;",
|
|
"if(installedChunkData) {",
|
|
Template.indent([
|
|
'if(event.type !== "load") {',
|
|
Template.indent([
|
|
"var errorType = event && event.type;",
|
|
"var realHref = event && event.target && event.target.href;",
|
|
"error.message = 'Loading css chunk ' + chunkId + ' failed.\\n(' + errorType + ': ' + realHref + ')';",
|
|
"error.name = 'ChunkLoadError';",
|
|
"error.type = errorType;",
|
|
"error.request = realHref;",
|
|
"installedChunkData[1](error);"
|
|
]),
|
|
"} else {",
|
|
Template.indent([
|
|
"installedChunks[chunkId] = 0;",
|
|
"installedChunkData[0]();"
|
|
]),
|
|
"}"
|
|
]),
|
|
"}"
|
|
]),
|
|
"}"
|
|
]
|
|
)};`,
|
|
isNeutralPlatform
|
|
? "if (typeof document !== 'undefined') {"
|
|
: "",
|
|
Template.indent([
|
|
`loadStylesheet(chunkId, url, loadingEnded${
|
|
withFetchPriority ? ", fetchPriority" : ""
|
|
});`
|
|
]),
|
|
isNeutralPlatform
|
|
? "} else { loadingEnded({ type: 'load' }); }"
|
|
: ""
|
|
]),
|
|
"} else installedChunks[chunkId] = 0;"
|
|
]),
|
|
"}"
|
|
]),
|
|
"}"
|
|
]
|
|
)};`
|
|
])
|
|
: "// no chunk loading",
|
|
"",
|
|
withPrefetch && hasCssMatcher !== false
|
|
? `${
|
|
RuntimeGlobals.prefetchChunkHandlers
|
|
}.s = ${runtimeTemplate.basicFunction("chunkId", [
|
|
`if((!${
|
|
RuntimeGlobals.hasOwnProperty
|
|
}(installedChunks, chunkId) || installedChunks[chunkId] === undefined) && ${
|
|
hasCssMatcher === true ? "true" : hasCssMatcher("chunkId")
|
|
}) {`,
|
|
Template.indent([
|
|
"installedChunks[chunkId] = null;",
|
|
isNeutralPlatform
|
|
? "if (typeof document === 'undefined') return;"
|
|
: "",
|
|
linkPrefetch.call(
|
|
Template.asString([
|
|
"var link = document.createElement('link');",
|
|
charset ? "link.charset = 'utf-8';" : "",
|
|
crossOriginLoading
|
|
? `link.crossOrigin = ${JSON.stringify(
|
|
crossOriginLoading
|
|
)};`
|
|
: "",
|
|
`if (${RuntimeGlobals.scriptNonce}) {`,
|
|
Template.indent(
|
|
`link.setAttribute("nonce", ${RuntimeGlobals.scriptNonce});`
|
|
),
|
|
"}",
|
|
'link.rel = "prefetch";',
|
|
'link.as = "style";',
|
|
`link.href = ${RuntimeGlobals.publicPath} + ${RuntimeGlobals.getChunkCssFilename}(chunkId);`
|
|
]),
|
|
chunk
|
|
),
|
|
"document.head.appendChild(link);"
|
|
]),
|
|
"}"
|
|
])};`
|
|
: "// no prefetching",
|
|
"",
|
|
withPreload && hasCssMatcher !== false
|
|
? `${
|
|
RuntimeGlobals.preloadChunkHandlers
|
|
}.s = ${runtimeTemplate.basicFunction("chunkId", [
|
|
`if((!${
|
|
RuntimeGlobals.hasOwnProperty
|
|
}(installedChunks, chunkId) || installedChunks[chunkId] === undefined) && ${
|
|
hasCssMatcher === true ? "true" : hasCssMatcher("chunkId")
|
|
}) {`,
|
|
Template.indent([
|
|
"installedChunks[chunkId] = null;",
|
|
isNeutralPlatform
|
|
? "if (typeof document === 'undefined') return;"
|
|
: "",
|
|
linkPreload.call(
|
|
Template.asString([
|
|
"var link = document.createElement('link');",
|
|
charset ? "link.charset = 'utf-8';" : "",
|
|
`if (${RuntimeGlobals.scriptNonce}) {`,
|
|
Template.indent(
|
|
`link.setAttribute("nonce", ${RuntimeGlobals.scriptNonce});`
|
|
),
|
|
"}",
|
|
'link.rel = "preload";',
|
|
'link.as = "style";',
|
|
`link.href = ${RuntimeGlobals.publicPath} + ${RuntimeGlobals.getChunkCssFilename}(chunkId);`,
|
|
crossOriginLoading
|
|
? crossOriginLoading === "use-credentials"
|
|
? 'link.crossOrigin = "use-credentials";'
|
|
: Template.asString([
|
|
"if (link.href.indexOf(window.location.origin + '/') !== 0) {",
|
|
Template.indent(
|
|
`link.crossOrigin = ${JSON.stringify(
|
|
crossOriginLoading
|
|
)};`
|
|
),
|
|
"}"
|
|
])
|
|
: ""
|
|
]),
|
|
chunk
|
|
),
|
|
"document.head.appendChild(link);"
|
|
]),
|
|
"}"
|
|
])};`
|
|
: "// no preloaded",
|
|
withHmr
|
|
? Template.asString([
|
|
"var oldTags = [];",
|
|
"var newTags = [];",
|
|
`var applyHandler = ${runtimeTemplate.basicFunction("options", [
|
|
`return { dispose: ${runtimeTemplate.basicFunction("", [
|
|
"while(oldTags.length) {",
|
|
Template.indent([
|
|
"var oldTag = oldTags.pop();",
|
|
"if(oldTag.parentNode) oldTag.parentNode.removeChild(oldTag);"
|
|
]),
|
|
"}"
|
|
])}, apply: ${runtimeTemplate.basicFunction("", [
|
|
"while(newTags.length) {",
|
|
Template.indent([
|
|
"var newTag = newTags.pop();",
|
|
"newTag.sheet.disabled = false"
|
|
]),
|
|
"}"
|
|
])} };`
|
|
])}`,
|
|
`var cssTextKey = ${runtimeTemplate.returningFunction(
|
|
`Array.from(link.sheet.cssRules, ${runtimeTemplate.returningFunction(
|
|
"r.cssText",
|
|
"r"
|
|
)}).join()`,
|
|
"link"
|
|
)};`,
|
|
`${
|
|
RuntimeGlobals.hmrDownloadUpdateHandlers
|
|
}.css = ${runtimeTemplate.basicFunction(
|
|
"chunkIds, removedChunks, removedModules, promises, applyHandlers, updatedModulesList",
|
|
[
|
|
isNeutralPlatform
|
|
? "if (typeof document === 'undefined') return;"
|
|
: "",
|
|
"applyHandlers.push(applyHandler);",
|
|
`chunkIds.forEach(${runtimeTemplate.basicFunction("chunkId", [
|
|
`var filename = ${RuntimeGlobals.getChunkCssFilename}(chunkId);`,
|
|
`var url = ${RuntimeGlobals.publicPath} + filename;`,
|
|
"var oldTag = loadStylesheet(chunkId, url);",
|
|
"if(!oldTag) return;",
|
|
"// create error before stack unwound to get useful stacktrace later",
|
|
"var error = new Error();",
|
|
`promises.push(new Promise(${runtimeTemplate.basicFunction(
|
|
"resolve, reject",
|
|
[
|
|
`var link = loadStylesheet(chunkId, url + (url.indexOf("?") < 0 ? "?" : "&") + "hmr=" + Date.now(), ${runtimeTemplate.basicFunction(
|
|
"event",
|
|
[
|
|
'if(event.type !== "load") {',
|
|
Template.indent([
|
|
"var errorType = event && event.type;",
|
|
"var realHref = event && event.target && event.target.href;",
|
|
"error.message = 'Loading css hot update chunk ' + chunkId + ' failed.\\n(' + errorType + ': ' + realHref + ')';",
|
|
"error.name = 'ChunkLoadError';",
|
|
"error.type = errorType;",
|
|
"error.request = realHref;",
|
|
"reject(error);"
|
|
]),
|
|
"} else {",
|
|
Template.indent([
|
|
"try { if(cssTextKey(oldTag) == cssTextKey(link)) { if(link.parentNode) link.parentNode.removeChild(link); return resolve(); } } catch(e) {}",
|
|
"link.sheet.disabled = true;",
|
|
"oldTags.push(oldTag);",
|
|
"newTags.push(link);",
|
|
"resolve();"
|
|
]),
|
|
"}"
|
|
]
|
|
)}, ${withFetchPriority ? "undefined," : ""} oldTag);`
|
|
]
|
|
)}));`
|
|
])});`
|
|
]
|
|
)}`
|
|
])
|
|
: "// no hmr"
|
|
]);
|
|
}
|
|
}
|
|
|
|
module.exports = CssLoadingRuntimeModule;
|