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>
456 lines
14 KiB
JavaScript
456 lines
14 KiB
JavaScript
/*
|
|
MIT License http://www.opensource.org/licenses/mit-license.php
|
|
Author Tobias Koppers @sokra
|
|
*/
|
|
|
|
"use strict";
|
|
|
|
const {
|
|
JAVASCRIPT_MODULE_TYPE_AUTO,
|
|
JAVASCRIPT_MODULE_TYPE_ESM
|
|
} = require("../ModuleTypeConstants");
|
|
const PureExpressionDependency = require("../dependencies/PureExpressionDependency");
|
|
const InnerGraph = require("./InnerGraph");
|
|
|
|
/** @typedef {import("estree").ClassDeclaration} ClassDeclaration */
|
|
/** @typedef {import("estree").ClassExpression} ClassExpression */
|
|
/** @typedef {import("estree").Expression} Expression */
|
|
/** @typedef {import("estree").MaybeNamedClassDeclaration} MaybeNamedClassDeclaration */
|
|
/** @typedef {import("estree").MaybeNamedFunctionDeclaration} MaybeNamedFunctionDeclaration */
|
|
/** @typedef {import("estree").Node} Node */
|
|
/** @typedef {import("estree").VariableDeclarator} VariableDeclarator */
|
|
/** @typedef {import("../../declarations/WebpackOptions").JavascriptParserOptions} JavascriptParserOptions */
|
|
/** @typedef {import("../Compiler")} Compiler */
|
|
/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
|
|
/** @typedef {import("../javascript/JavascriptParser")} JavascriptParser */
|
|
/** @typedef {import("../javascript/JavascriptParser").Range} Range */
|
|
/** @typedef {import("./InnerGraph").TopLevelSymbol} TopLevelSymbol */
|
|
|
|
const { topLevelSymbolTag } = InnerGraph;
|
|
|
|
const PLUGIN_NAME = "InnerGraphPlugin";
|
|
|
|
class InnerGraphPlugin {
|
|
/**
|
|
* Apply the plugin
|
|
* @param {Compiler} compiler the compiler instance
|
|
* @returns {void}
|
|
*/
|
|
apply(compiler) {
|
|
compiler.hooks.compilation.tap(
|
|
PLUGIN_NAME,
|
|
(compilation, { normalModuleFactory }) => {
|
|
const logger = compilation.getLogger("webpack.InnerGraphPlugin");
|
|
|
|
compilation.dependencyTemplates.set(
|
|
PureExpressionDependency,
|
|
new PureExpressionDependency.Template()
|
|
);
|
|
|
|
/**
|
|
* @param {JavascriptParser} parser the parser
|
|
* @param {JavascriptParserOptions} parserOptions options
|
|
* @returns {void}
|
|
*/
|
|
const handler = (parser, parserOptions) => {
|
|
/**
|
|
* @param {Expression} sup sup
|
|
*/
|
|
const onUsageSuper = (sup) => {
|
|
InnerGraph.onUsage(parser.state, (usedByExports) => {
|
|
switch (usedByExports) {
|
|
case undefined:
|
|
case true:
|
|
return;
|
|
default: {
|
|
const dep = new PureExpressionDependency(
|
|
/** @type {Range} */
|
|
(sup.range)
|
|
);
|
|
dep.loc = /** @type {DependencyLocation} */ (sup.loc);
|
|
dep.usedByExports = usedByExports;
|
|
parser.state.module.addDependency(dep);
|
|
break;
|
|
}
|
|
}
|
|
});
|
|
};
|
|
|
|
parser.hooks.program.tap(PLUGIN_NAME, () => {
|
|
InnerGraph.enable(parser.state);
|
|
});
|
|
|
|
parser.hooks.finish.tap(PLUGIN_NAME, () => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
|
|
logger.time("infer dependency usage");
|
|
InnerGraph.inferDependencyUsage(parser.state);
|
|
logger.timeAggregate("infer dependency usage");
|
|
});
|
|
|
|
// During prewalking the following datastructures are filled with
|
|
// nodes that have a TopLevelSymbol assigned and
|
|
// variables are tagged with the assigned TopLevelSymbol
|
|
|
|
// We differ 3 types of nodes:
|
|
// 1. full statements (export default, function declaration)
|
|
// 2. classes (class declaration, class expression)
|
|
// 3. variable declarators (const x = ...)
|
|
|
|
/** @type {WeakMap<Node | MaybeNamedFunctionDeclaration | MaybeNamedClassDeclaration, TopLevelSymbol>} */
|
|
const statementWithTopLevelSymbol = new WeakMap();
|
|
/** @type {WeakMap<Node | MaybeNamedFunctionDeclaration | MaybeNamedClassDeclaration, Node>} */
|
|
const statementPurePart = new WeakMap();
|
|
|
|
/** @type {WeakMap<ClassExpression | ClassDeclaration | MaybeNamedClassDeclaration, TopLevelSymbol>} */
|
|
const classWithTopLevelSymbol = new WeakMap();
|
|
|
|
/** @type {WeakMap<VariableDeclarator, TopLevelSymbol>} */
|
|
const declWithTopLevelSymbol = new WeakMap();
|
|
/** @type {WeakSet<VariableDeclarator>} */
|
|
const pureDeclarators = new WeakSet();
|
|
|
|
// The following hooks are used during prewalking:
|
|
|
|
parser.hooks.preStatement.tap(PLUGIN_NAME, (statement) => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
|
|
if (
|
|
parser.scope.topLevelScope === true &&
|
|
statement.type === "FunctionDeclaration"
|
|
) {
|
|
const name = statement.id ? statement.id.name : "*default*";
|
|
const fn =
|
|
/** @type {TopLevelSymbol} */
|
|
(InnerGraph.tagTopLevelSymbol(parser, name));
|
|
statementWithTopLevelSymbol.set(statement, fn);
|
|
return true;
|
|
}
|
|
});
|
|
|
|
parser.hooks.blockPreStatement.tap(PLUGIN_NAME, (statement) => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
|
|
if (parser.scope.topLevelScope === true) {
|
|
if (
|
|
statement.type === "ClassDeclaration" &&
|
|
parser.isPure(
|
|
statement,
|
|
/** @type {Range} */ (statement.range)[0]
|
|
)
|
|
) {
|
|
const name = statement.id ? statement.id.name : "*default*";
|
|
const fn = /** @type {TopLevelSymbol} */ (
|
|
InnerGraph.tagTopLevelSymbol(parser, name)
|
|
);
|
|
classWithTopLevelSymbol.set(statement, fn);
|
|
return true;
|
|
}
|
|
if (statement.type === "ExportDefaultDeclaration") {
|
|
const name = "*default*";
|
|
const fn =
|
|
/** @type {TopLevelSymbol} */
|
|
(InnerGraph.tagTopLevelSymbol(parser, name));
|
|
const decl = statement.declaration;
|
|
if (
|
|
(decl.type === "ClassExpression" ||
|
|
decl.type === "ClassDeclaration") &&
|
|
parser.isPure(
|
|
/** @type {ClassExpression | ClassDeclaration} */
|
|
(decl),
|
|
/** @type {Range} */
|
|
(decl.range)[0]
|
|
)
|
|
) {
|
|
classWithTopLevelSymbol.set(
|
|
/** @type {ClassExpression | ClassDeclaration} */
|
|
(decl),
|
|
fn
|
|
);
|
|
} else if (
|
|
parser.isPure(
|
|
/** @type {Expression} */
|
|
(decl),
|
|
/** @type {Range} */
|
|
(statement.range)[0]
|
|
)
|
|
) {
|
|
statementWithTopLevelSymbol.set(statement, fn);
|
|
if (
|
|
!decl.type.endsWith("FunctionExpression") &&
|
|
!decl.type.endsWith("Declaration") &&
|
|
decl.type !== "Literal"
|
|
) {
|
|
statementPurePart.set(
|
|
statement,
|
|
/** @type {Expression} */
|
|
(decl)
|
|
);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
});
|
|
|
|
parser.hooks.preDeclarator.tap(PLUGIN_NAME, (decl, _statement) => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
if (
|
|
parser.scope.topLevelScope === true &&
|
|
decl.init &&
|
|
decl.id.type === "Identifier"
|
|
) {
|
|
const name = decl.id.name;
|
|
if (
|
|
decl.init.type === "ClassExpression" &&
|
|
parser.isPure(
|
|
decl.init,
|
|
/** @type {Range} */ (decl.id.range)[1]
|
|
)
|
|
) {
|
|
const fn =
|
|
/** @type {TopLevelSymbol} */
|
|
(InnerGraph.tagTopLevelSymbol(parser, name));
|
|
classWithTopLevelSymbol.set(decl.init, fn);
|
|
} else if (
|
|
parser.isPure(
|
|
decl.init,
|
|
/** @type {Range} */ (decl.id.range)[1]
|
|
)
|
|
) {
|
|
const fn =
|
|
/** @type {TopLevelSymbol} */
|
|
(InnerGraph.tagTopLevelSymbol(parser, name));
|
|
declWithTopLevelSymbol.set(decl, fn);
|
|
if (
|
|
!decl.init.type.endsWith("FunctionExpression") &&
|
|
decl.init.type !== "Literal"
|
|
) {
|
|
pureDeclarators.add(decl);
|
|
}
|
|
}
|
|
}
|
|
});
|
|
|
|
// During real walking we set the TopLevelSymbol state to the assigned
|
|
// TopLevelSymbol by using the fill datastructures.
|
|
|
|
// In addition to tracking TopLevelSymbols, we sometimes need to
|
|
// add a PureExpressionDependency. This is needed to skip execution
|
|
// of pure expressions, even when they are not dropped due to
|
|
// minimizing. Otherwise symbols used there might not exist anymore
|
|
// as they are removed as unused by this optimization
|
|
|
|
// When we find a reference to a TopLevelSymbol, we register a
|
|
// TopLevelSymbol dependency from TopLevelSymbol in state to the
|
|
// referenced TopLevelSymbol. This way we get a graph of all
|
|
// TopLevelSymbols.
|
|
|
|
// The following hooks are called during walking:
|
|
|
|
parser.hooks.statement.tap(PLUGIN_NAME, (statement) => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
if (parser.scope.topLevelScope === true) {
|
|
InnerGraph.setTopLevelSymbol(parser.state, undefined);
|
|
|
|
const fn = statementWithTopLevelSymbol.get(statement);
|
|
if (fn) {
|
|
InnerGraph.setTopLevelSymbol(parser.state, fn);
|
|
const purePart = statementPurePart.get(statement);
|
|
if (purePart) {
|
|
InnerGraph.onUsage(parser.state, (usedByExports) => {
|
|
switch (usedByExports) {
|
|
case undefined:
|
|
case true:
|
|
return;
|
|
default: {
|
|
const dep = new PureExpressionDependency(
|
|
/** @type {Range} */ (purePart.range)
|
|
);
|
|
dep.loc =
|
|
/** @type {DependencyLocation} */
|
|
(statement.loc);
|
|
dep.usedByExports = usedByExports;
|
|
parser.state.module.addDependency(dep);
|
|
break;
|
|
}
|
|
}
|
|
});
|
|
}
|
|
}
|
|
}
|
|
});
|
|
|
|
parser.hooks.classExtendsExpression.tap(
|
|
PLUGIN_NAME,
|
|
(expr, statement) => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
if (parser.scope.topLevelScope === true) {
|
|
const fn = classWithTopLevelSymbol.get(statement);
|
|
if (
|
|
fn &&
|
|
parser.isPure(
|
|
expr,
|
|
statement.id
|
|
? /** @type {Range} */ (statement.id.range)[1]
|
|
: /** @type {Range} */ (statement.range)[0]
|
|
)
|
|
) {
|
|
InnerGraph.setTopLevelSymbol(parser.state, fn);
|
|
onUsageSuper(expr);
|
|
}
|
|
}
|
|
}
|
|
);
|
|
|
|
parser.hooks.classBodyElement.tap(
|
|
PLUGIN_NAME,
|
|
(element, classDefinition) => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
if (parser.scope.topLevelScope === true) {
|
|
const fn = classWithTopLevelSymbol.get(classDefinition);
|
|
if (fn) {
|
|
InnerGraph.setTopLevelSymbol(parser.state, undefined);
|
|
}
|
|
}
|
|
}
|
|
);
|
|
|
|
parser.hooks.classBodyValue.tap(
|
|
PLUGIN_NAME,
|
|
(expression, element, classDefinition) => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
if (parser.scope.topLevelScope === true) {
|
|
const fn = classWithTopLevelSymbol.get(classDefinition);
|
|
if (fn) {
|
|
if (
|
|
!element.static ||
|
|
parser.isPure(
|
|
expression,
|
|
element.key
|
|
? /** @type {Range} */ (element.key.range)[1]
|
|
: /** @type {Range} */ (element.range)[0]
|
|
)
|
|
) {
|
|
InnerGraph.setTopLevelSymbol(parser.state, fn);
|
|
if (element.type !== "MethodDefinition" && element.static) {
|
|
InnerGraph.onUsage(parser.state, (usedByExports) => {
|
|
switch (usedByExports) {
|
|
case undefined:
|
|
case true:
|
|
return;
|
|
default: {
|
|
const dep = new PureExpressionDependency(
|
|
/** @type {Range} */ (expression.range)
|
|
);
|
|
dep.loc =
|
|
/** @type {DependencyLocation} */
|
|
(expression.loc);
|
|
dep.usedByExports = usedByExports;
|
|
parser.state.module.addDependency(dep);
|
|
break;
|
|
}
|
|
}
|
|
});
|
|
}
|
|
} else {
|
|
InnerGraph.setTopLevelSymbol(parser.state, undefined);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
);
|
|
|
|
parser.hooks.declarator.tap(PLUGIN_NAME, (decl, _statement) => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
const fn = declWithTopLevelSymbol.get(decl);
|
|
|
|
if (fn) {
|
|
InnerGraph.setTopLevelSymbol(parser.state, fn);
|
|
if (pureDeclarators.has(decl)) {
|
|
if (
|
|
/** @type {ClassExpression} */
|
|
(decl.init).type === "ClassExpression"
|
|
) {
|
|
if (decl.init.superClass) {
|
|
onUsageSuper(decl.init.superClass);
|
|
}
|
|
} else {
|
|
InnerGraph.onUsage(parser.state, (usedByExports) => {
|
|
switch (usedByExports) {
|
|
case undefined:
|
|
case true:
|
|
return;
|
|
default: {
|
|
const dep = new PureExpressionDependency(
|
|
/** @type {Range} */ (
|
|
/** @type {ClassExpression} */
|
|
(decl.init).range
|
|
)
|
|
);
|
|
dep.loc = /** @type {DependencyLocation} */ (decl.loc);
|
|
dep.usedByExports = usedByExports;
|
|
parser.state.module.addDependency(dep);
|
|
break;
|
|
}
|
|
}
|
|
});
|
|
}
|
|
}
|
|
parser.walkExpression(
|
|
/** @type {NonNullable<VariableDeclarator["init"]>} */ (
|
|
decl.init
|
|
)
|
|
);
|
|
InnerGraph.setTopLevelSymbol(parser.state, undefined);
|
|
return true;
|
|
} else if (
|
|
decl.id.type === "Identifier" &&
|
|
decl.init &&
|
|
decl.init.type === "ClassExpression" &&
|
|
classWithTopLevelSymbol.has(decl.init)
|
|
) {
|
|
parser.walkExpression(decl.init);
|
|
InnerGraph.setTopLevelSymbol(parser.state, undefined);
|
|
return true;
|
|
}
|
|
});
|
|
|
|
parser.hooks.expression
|
|
.for(topLevelSymbolTag)
|
|
.tap(PLUGIN_NAME, () => {
|
|
const topLevelSymbol = /** @type {TopLevelSymbol} */ (
|
|
parser.currentTagData
|
|
);
|
|
const currentTopLevelSymbol = InnerGraph.getTopLevelSymbol(
|
|
parser.state
|
|
);
|
|
InnerGraph.addUsage(
|
|
parser.state,
|
|
topLevelSymbol,
|
|
currentTopLevelSymbol || true
|
|
);
|
|
});
|
|
parser.hooks.assign
|
|
.for(topLevelSymbolTag)
|
|
.tap(PLUGIN_NAME, (expr) => {
|
|
if (!InnerGraph.isEnabled(parser.state)) return;
|
|
if (expr.operator === "=") return true;
|
|
});
|
|
};
|
|
normalModuleFactory.hooks.parser
|
|
.for(JAVASCRIPT_MODULE_TYPE_AUTO)
|
|
.tap(PLUGIN_NAME, handler);
|
|
normalModuleFactory.hooks.parser
|
|
.for(JAVASCRIPT_MODULE_TYPE_ESM)
|
|
.tap(PLUGIN_NAME, handler);
|
|
|
|
compilation.hooks.finishModules.tap(PLUGIN_NAME, () => {
|
|
logger.timeAggregateEnd("infer dependency usage");
|
|
});
|
|
}
|
|
);
|
|
}
|
|
}
|
|
|
|
module.exports = InnerGraphPlugin;
|