Fix code quality violations and exclude Manifest from checks

Document application modes (development/debug/production)
Add global file drop handler, order column normalization, SPA hash fix
Serve CDN assets via /_vendor/ URLs instead of merging into bundles
Add production minification with license preservation
Improve JSON formatting for debugging and production optimization
Add CDN asset caching with CSS URL inlining for production builds
Add three-mode system (development, debug, production)
Update Manifest CLAUDE.md to reflect helper class architecture
Refactor Manifest.php into helper classes for better organization
Pre-manifest-refactor checkpoint: Add app_mode documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

node_modules/csso/lib/restructure/prepare/createDeclarationIndexer.js

@@ -1,26 +1,26 @@
-var generate = require('css-tree').generate;
+import { generate } from 'css-tree';
 
-function Index() {
-    this.seed = 0;
-    this.map = Object.create(null);
-}
-
-Index.prototype.resolve = function(str) {
-    var index = this.map[str];
-
-    if (!index) {
-        index = ++this.seed;
-        this.map[str] = index;
+class Index {
+    constructor() {
+        this.map = new Map();
     }
+    resolve(str) {
+        let index = this.map.get(str);
 
-    return index;
+        if (index === undefined) {
+            index = this.map.size + 1;
+            this.map.set(str, index);
+        }
+
+        return index;
+    }
 };
 
-module.exports = function createDeclarationIndexer() {
-    var ids = new Index();
+export default function createDeclarationIndexer() {
+    const ids = new Index();
 
     return function markDeclaration(node) {
-        var id = generate(node);
+        const id = generate(node);
 
         node.id = ids.resolve(id);
         node.length = id.length;

node_modules/csso/lib/restructure/prepare/index.js

@@ -1,23 +1,21 @@
-var resolveKeyword = require('css-tree').keyword;
-var walk = require('css-tree').walk;
-var generate = require('css-tree').generate;
-var createDeclarationIndexer = require('./createDeclarationIndexer');
-var processSelector = require('./processSelector');
+import { walk, generate, keyword as resolveKeyword } from 'css-tree';
+import createDeclarationIndexer from './createDeclarationIndexer.js';
+import processSelector from './processSelector.js';
 
-module.exports = function prepare(ast, options) {
-    var markDeclaration = createDeclarationIndexer();
+export default function prepare(ast, options) {
+    const markDeclaration = createDeclarationIndexer();
 
     walk(ast, {
         visit: 'Rule',
-        enter: function processRule(node) {
-            node.block.children.each(markDeclaration);
+        enter(node) {
+            node.block.children.forEach(markDeclaration);
             processSelector(node, options.usage);
         }
     });
 
     walk(ast, {
         visit: 'Atrule',
-        enter: function(node) {
+        enter(node) {
             if (node.prelude) {
                 node.prelude.id = null; // pre-init property to avoid multiple hidden class for generate
                 node.prelude.id = generate(node.prelude);
@@ -28,8 +26,8 @@ module.exports = function prepare(ast, options) {
             if (resolveKeyword(node.name).basename === 'keyframes') {
                 node.block.avoidRulesMerge = true;  /* probably we don't need to prevent those merges for @keyframes
                                                        TODO: need to be checked */
-                node.block.children.each(function(rule) {
-                    rule.prelude.children.each(function(simpleselector) {
+                node.block.children.forEach(function(rule) {
+                    rule.prelude.children.forEach(function(simpleselector) {
                         simpleselector.compareMarker = simpleselector.id;
                     });
                 });

node_modules/csso/lib/restructure/prepare/processSelector.js

@@ -1,36 +1,35 @@
-var generate = require('css-tree').generate;
-var specificity = require('./specificity');
+import { generate } from 'css-tree';
+import specificity from './specificity.js';
 
-var nonFreezePseudoElements = {
-    'first-letter': true,
-    'first-line': true,
-    'after': true,
-    'before': true
-};
-var nonFreezePseudoClasses = {
-    'link': true,
-    'visited': true,
-    'hover': true,
-    'active': true,
-    'first-letter': true,
-    'first-line': true,
-    'after': true,
-    'before': true
-};
+const nonFreezePseudoElements = new Set([
+    'first-letter',
+    'first-line',
+    'after',
+    'before'
+]);
+const nonFreezePseudoClasses = new Set([
+    'link',
+    'visited',
+    'hover',
+    'active',
+    'first-letter',
+    'first-line',
+    'after',
+    'before'
+]);
 
-module.exports = function freeze(node, usageData) {
-    var pseudos = Object.create(null);
-    var hasPseudo = false;
+export default function processSelector(node, usageData) {
+    const pseudos = new Set();
 
-    node.prelude.children.each(function(simpleSelector) {
-        var tagName = '*';
-        var scope = 0;
+    node.prelude.children.forEach(function(simpleSelector) {
+        let tagName = '*';
+        let scope = 0;
 
-        simpleSelector.children.each(function(node) {
+        simpleSelector.children.forEach(function(node) {
             switch (node.type) {
                 case 'ClassSelector':
                     if (usageData && usageData.scopes) {
-                        var classScope = usageData.scopes[node.name] || 0;
+                        const classScope = usageData.scopes[node.name] || 0;
 
                         if (scope !== 0 && classScope !== scope) {
                             throw new Error('Selector can\'t has classes from different scopes: ' + generate(simpleSelector));
@@ -38,25 +37,28 @@ module.exports = function freeze(node, usageData) {
 
                         scope = classScope;
                     }
+
                     break;
 
-                case 'PseudoClassSelector':
-                    var name = node.name.toLowerCase();
+                case 'PseudoClassSelector': {
+                    const name = node.name.toLowerCase();
 
-                    if (!nonFreezePseudoClasses.hasOwnProperty(name)) {
-                        pseudos[':' + name] = true;
-                        hasPseudo = true;
+                    if (!nonFreezePseudoClasses.has(name)) {
+                        pseudos.add(`:${name}`);
                     }
+
                     break;
+                }
 
-                case 'PseudoElementSelector':
-                    var name = node.name.toLowerCase();
+                case 'PseudoElementSelector': {
+                    const name = node.name.toLowerCase();
 
-                    if (!nonFreezePseudoElements.hasOwnProperty(name)) {
-                        pseudos['::' + name] = true;
-                        hasPseudo = true;
+                    if (!nonFreezePseudoElements.has(name)) {
+                        pseudos.add(`::${name}`);
                     }
+
                     break;
+                }
 
                 case 'TypeSelector':
                     tagName = node.name.toLowerCase();
@@ -64,12 +66,11 @@ module.exports = function freeze(node, usageData) {
 
                 case 'AttributeSelector':
                     if (node.flags) {
-                        pseudos['[' + node.flags.toLowerCase() + ']'] = true;
-                        hasPseudo = true;
+                        pseudos.add(`[${node.flags.toLowerCase()}]`);
                     }
+
                     break;
 
-                case 'WhiteSpace':
                 case 'Combinator':
                     tagName = '*';
                     break;
@@ -90,5 +91,7 @@ module.exports = function freeze(node, usageData) {
     });
 
     // add property to all rule nodes to avoid multiple hidden class
-    node.pseudoSignature = hasPseudo && Object.keys(pseudos).sort().join(',');
+    node.pseudoSignature = pseudos.size > 0
+        ? [...pseudos].sort().join(',')
+        : false;
 };

node_modules/csso/lib/restructure/prepare/specificity.js

@@ -1,30 +1,103 @@
-module.exports = function specificity(simpleSelector) {
-    var A = 0;
-    var B = 0;
-    var C = 0;
+import { parse } from 'css-tree';
 
-    simpleSelector.children.each(function walk(node) {
+function ensureSelectorList(node) {
+    if (node.type === 'Raw') {
+        return parse(node.value, { context: 'selectorList' });
+    }
+
+    return node;
+}
+
+function maxSpecificity(a, b) {
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i]) {
+            return a[i] > b[i] ? a : b;
+        }
+    }
+
+    return a;
+}
+
+function maxSelectorListSpecificity(selectorList) {
+    return ensureSelectorList(selectorList).children.reduce(
+        (result, node) => maxSpecificity(specificity(node), result),
+        [0, 0, 0]
+    );
+}
+
+// §16. Calculating a selector’s specificity
+// https://www.w3.org/TR/selectors-4/#specificity-rules
+function specificity(simpleSelector) {
+    let A = 0;
+    let B = 0;
+    let C = 0;
+
+    // A selector’s specificity is calculated for a given element as follows:
+    simpleSelector.children.forEach((node) => {
         switch (node.type) {
-            case 'SelectorList':
-            case 'Selector':
-                node.children.each(walk);
-                break;
-
+            // count the number of ID selectors in the selector (= A)
             case 'IdSelector':
                 A++;
                 break;
 
+            // count the number of class selectors, attributes selectors, ...
             case 'ClassSelector':
             case 'AttributeSelector':
                 B++;
                 break;
 
+            // ... and pseudo-classes in the selector (= B)
             case 'PseudoClassSelector':
                 switch (node.name.toLowerCase()) {
+                    // The specificity of an :is(), :not(), or :has() pseudo-class is replaced
+                    // by the specificity of the most specific complex selector in its selector list argument.
                     case 'not':
-                        node.children.each(walk);
+                    case 'has':
+                    case 'is':
+                    // :matches() is used before it was renamed to :is()
+                    // https://github.com/w3c/csswg-drafts/issues/3258
+                    case 'matches':
+                    // Older browsers support :is() functionality as prefixed pseudo-class :any()
+                    // https://developer.mozilla.org/en-US/docs/Web/CSS/:is
+                    case '-webkit-any':
+                    case '-moz-any': {
+                        const [a, b, c] = maxSelectorListSpecificity(node.children.first);
+
+                        A += a;
+                        B += b;
+                        C += c;
+
+                        break;
+                    }
+
+                    // Analogously, the specificity of an :nth-child() or :nth-last-child() selector
+                    // is the specificity of the pseudo class itself (counting as one pseudo-class selector)
+                    // plus the specificity of the most specific complex selector in its selector list argument (if any).
+                    case 'nth-child':
+                    case 'nth-last-child': {
+                        const arg = node.children.first;
+
+                        if (arg.type === 'Nth' && arg.selector) {
+                            const [a, b, c] = maxSelectorListSpecificity(arg.selector);
+
+                            A += a;
+                            B += b + 1;
+                            C += c;
+                        } else {
+                            B++;
+                        }
+
+                        break;
+                    }
+
+                    // The specificity of a :where() pseudo-class is replaced by zero.
+                    case 'where':
                         break;
 
+                    // The four Level 2 pseudo-elements (::before, ::after, ::first-line, and ::first-letter) may,
+                    // for legacy reasons, be represented using the <pseudo-class-selector> grammar,
+                    // with only a single ":" character at their start.
+                    // https://www.w3.org/TR/selectors-4/#single-colon-pseudos
                     case 'before':
                     case 'after':
                     case 'first-line':
@@ -32,25 +105,27 @@ module.exports = function specificity(simpleSelector) {
                         C++;
                         break;
 
-                    // TODO: support for :nth-*(.. of <SelectorList>), :matches(), :has()
                     default:
                         B++;
                 }
                 break;
 
-            case 'PseudoElementSelector':
-                C++;
-                break;
-
+            // count the number of type selectors ...
             case 'TypeSelector':
-                // ignore universal selector
-                if (node.name.charAt(node.name.length - 1) !== '*') {
+                // ignore the universal selector
+                if (!node.name.endsWith('*')) {
                     C++;
                 }
                 break;
 
+            // ... and pseudo-elements in the selector (= C)
+            case 'PseudoElementSelector':
+                C++;
+                break;
         }
     });
 
     return [A, B, C];
 };
+
+export default specificity;