@plumeria/utils 19.2.15 → 19.3.0

package/dist/index.d.ts

@@ -20,3 +20,4 @@ export type { PropertyPolicy, PropertyPolicyOptions } from './propertyPolicy';
 export { resolvePropertyPolicy, assertPropertyPolicy } from './propertyPolicy';
 export type { TransformEnv, TransformOutput } from './transform';
 export { transformSource } from './transform';
+export { needsCompile } from './stylePropFilter';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.transformSource = exports.assertPropertyPolicy = exports.resolvePropertyPolicy = exports.DEFAULT_STYLE_PROP = exports.timedAsync = exports.timed = exports.tally = exports.measure = exports.mark = exports.profiling = exports.collectReferenceIdentifiers = exports.getLeadingCommentLength = exports.optimizer = exports.resolveImportPath = exports.themeHashOf = exports.getStateWeights = exports.getPseudoElement = exports.getSpecificity = exports.resolveDynamicStyle = exports.applyVarFallback = exports.splitVarByUnit = exports.isUnitlessProp = exports.styleFunctionsOf = exports.getStyleRecords = exports.resolveThemeSelector = exports.resolveComponentKey = exports.resolveExport = exports.getFileDependencies = exports.resolveFileError = exports.fileTableKeys = exports.scanOverlay = exports.scanAll = exports.deepMerge = exports.appendSheet = exports.extractOndemandStyles = exports.unwrapExpression = exports.resolveOriginError = exports.getRootIdentifier = exports.t = exports.traverse = exports.collectLocalConsts = exports.objectExpressionToObject = void 0;
+exports.needsCompile = exports.transformSource = exports.assertPropertyPolicy = exports.resolvePropertyPolicy = exports.DEFAULT_STYLE_PROP = exports.timedAsync = exports.timed = exports.tally = exports.measure = exports.mark = exports.profiling = exports.collectReferenceIdentifiers = exports.getLeadingCommentLength = exports.optimizer = exports.resolveImportPath = exports.themeHashOf = exports.getStateWeights = exports.getPseudoElement = exports.getSpecificity = exports.resolveDynamicStyle = exports.applyVarFallback = exports.splitVarByUnit = exports.isUnitlessProp = exports.styleFunctionsOf = exports.getStyleRecords = exports.resolveThemeSelector = exports.resolveComponentKey = exports.resolveExport = exports.getFileDependencies = exports.resolveFileError = exports.fileTableKeys = exports.scanOverlay = exports.scanAll = exports.deepMerge = exports.appendSheet = exports.extractOndemandStyles = exports.unwrapExpression = exports.resolveOriginError = exports.getRootIdentifier = exports.t = exports.traverse = exports.collectLocalConsts = exports.objectExpressionToObject = void 0;
 var parser_1 = require("./parser");
 Object.defineProperty(exports, "objectExpressionToObject", { enumerable: true, get: function () { return parser_1.objectExpressionToObject; } });
 Object.defineProperty(exports, "collectLocalConsts", { enumerable: true, get: function () { return parser_1.collectLocalConsts; } });
@@ -57,3 +57,5 @@ Object.defineProperty(exports, "resolvePropertyPolicy", { enumerable: true, get:
 Object.defineProperty(exports, "assertPropertyPolicy", { enumerable: true, get: function () { return propertyPolicy_1.assertPropertyPolicy; } });
 var transform_1 = require("./transform");
 Object.defineProperty(exports, "transformSource", { enumerable: true, get: function () { return transform_1.transformSource; } });
+var stylePropFilter_1 = require("./stylePropFilter");
+Object.defineProperty(exports, "needsCompile", { enumerable: true, get: function () { return stylePropFilter_1.needsCompile; } });

package/dist/parser.d.ts

@@ -51,8 +51,8 @@ export declare function resolveFileError(actualPath: string, importedName: strin
     message: string;
 } | undefined;
 export declare function fileTableKeys(filePath: string, tableName: string): ReadonlySet<string> | undefined;
-export declare function scanOverlay(scanCwd?: string): Tables;
-export declare function scanAll(scanCwd?: string): Tables;
+export declare function scanOverlay(scanCwd?: string, styleProp?: string): Tables;
+export declare function scanAll(scanCwd?: string, styleProp?: string): Tables;
 export declare function getFileDependencies(filePath: string): string[];
 export declare function resolveExport(filePath: string, exportName: string, visited?: Set<string>): {
     filePath: string;

package/dist/parser.js

@@ -57,6 +57,8 @@ const fs = __importStar(require("fs"));
 const rs = __importStar(require("@rust-gear/glob"));
 const zss_engine_1 = require("zss-engine");
 const viewTransition_1 = require("./viewTransition");
+const constants_1 = require("./constants");
+const stylePropFilter_1 = require("./stylePropFilter");
 const create_1 = require("./create");
 const dynamicKey_1 = require("./dynamicKey");
 const resolver_1 = require("./resolver");
@@ -102,6 +104,35 @@ const getRootIdentifier = (node) => {
     return null;
 };
 exports.getRootIdentifier = getRootIdentifier;
+const EXPRESSION_KINDS = {
+    NullLiteral: 'null',
+    ObjectExpression: 'an object literal',
+    ArrayExpression: 'an array literal',
+    CallExpression: 'a function call',
+    NewExpression: 'a new expression',
+    ConditionalExpression: 'a conditional expression',
+    ArrowFunctionExpression: 'a function',
+    FunctionExpression: 'a function',
+    TaggedTemplateExpression: 'a tagged template',
+    AwaitExpression: 'an await expression',
+};
+const expressionLabel = (node) => {
+    node = unwrapExpression(node);
+    if (exports.t.isIdentifier(node))
+        return node.value;
+    if (exports.t.isStringLiteral(node))
+        return `'${node.value}'`;
+    if (exports.t.isNumericLiteral(node))
+        return String(node.value);
+    if (exports.t.isMemberExpression(node)) {
+        const property = node.property;
+        if (property.type === 'Identifier')
+            return `${expressionLabel(node.object)}.${property.value}`;
+        if (property.type === 'Computed')
+            return `${expressionLabel(node.object)}[${expressionLabel(property.expression)}]`;
+    }
+    return EXPRESSION_KINDS[node.type] ?? 'an expression';
+};
 const getNamespaceMember = (node, rootName) => {
     node = unwrapExpression(node);
     if (exports.t.isCallExpression(node)) {
@@ -278,7 +309,7 @@ function objectExpressionToObject(node, staticTable, keyframesHashTable, viewTra
                         [root]: resolved,
                     }));
                     if (member === undefined)
-                        throw new Error(`[plumeria] Unknown style member on ${root}.`);
+                        throw new Error(`[plumeria] Unknown style member: ${expressionLabel(val)} does not exist.`);
                     obj[key] = member;
                     return;
                 }
@@ -684,7 +715,7 @@ function evaluateTemplateLiteral(node, staticTable, keyframesHashTable, viewTran
             const expr = node.expressions[i];
             const evaluatedExpr = evaluateExpression(expr, staticTable, keyframesHashTable, viewTransitionHashTable, createThemeHashTable, createThemeObjectTable, createStaticHashTable, createStaticObjectTable);
             if (evaluatedExpr === null || typeof evaluatedExpr === 'object')
-                throw new Error('[plumeria] Template value cannot be resolved to a primitive.');
+                throw new Error(`[plumeria] Template value cannot be resolved to a primitive: ${expressionLabel(expr)} inside \${} must resolve to a string or number at build time.`);
             result += String(evaluatedExpr);
         }
     }
@@ -752,7 +783,7 @@ function evaluateBinaryExpression(node, staticTable, keyframesHashTable, viewTra
         const rightType = right === null ? 'null' : typeof right;
         throw new Error(`[plumeria] Binary operator ${node.operator} requires ${expected} operands; received ${leftType} and ${rightType}.`);
     }
-    throw new Error(`[plumeria] Unsupported binary operator: ${node.operator}`);
+    throw new Error(`[plumeria] Unsupported binary operator: ${node.operator}. Use arithmetic, bitwise, &&, ||, or ?? operators, which can be resolved at build time.`);
 }
 function evaluateCallExpression(node, staticTable) {
     const callee = node.callee;
@@ -826,7 +857,7 @@ function evaluateExpression(node, staticTable, keyframesHashTable, viewTransitio
                 return createStaticObjectTable[hash];
             }
         }
-        throw new Error(`[plumeria] Cannot resolve static value: ${node.value}`);
+        throw new Error(`[plumeria] Cannot resolve static value: ${node.value}. It must be a const holding a string or number, declared in this file or imported from a module plumeria can read.`);
     }
     if (exports.t.isMemberExpression(node)) {
         const resolved = resolveStaticTableMemberExpression(node, staticTable);
@@ -841,7 +872,7 @@ function evaluateExpression(node, staticTable, keyframesHashTable, viewTransitio
         if (resolvedStatic !== undefined) {
             return resolvedStatic;
         }
-        throw new Error('[plumeria] Cannot resolve static member expression.');
+        throw new Error(`[plumeria] Cannot resolve static member expression: ${expressionLabel(node)}. Its object must be a const or a value created by css.createStatic or css.createTheme.`);
     }
     if (exports.t.isBinaryExpression(node)) {
         return evaluateBinaryExpression(node, staticTable, keyframesHashTable, viewTransitionHashTable, createThemeHashTable, createThemeObjectTable, createStaticHashTable, createStaticObjectTable);
@@ -861,12 +892,12 @@ function evaluateExpression(node, staticTable, keyframesHashTable, viewTransitio
             if (node.operator === '~')
                 return ~value;
         }
-        throw new Error(`[plumeria] Unsupported unary operand for ${node.operator}`);
+        throw new Error(`[plumeria] Unsupported unary operand for ${node.operator}: ${expressionLabel(node.argument)} must resolve to a number at build time.`);
     }
     if (exports.t.isParenthesisExpression(node)) {
         return evaluateExpression(node.expression, staticTable, keyframesHashTable, viewTransitionHashTable, createThemeHashTable, createThemeObjectTable, createStaticHashTable, createStaticObjectTable);
     }
-    throw new Error(`[plumeria] Unsupported expression type: ${node.type}`);
+    throw new Error(`[plumeria] Unsupported expression type: ${expressionLabel(node)}. Style values must be literals, consts, or arithmetic and template expressions of them.`);
 }
 function resolveKeyframesTableMemberExpression(node, keyframesHashTable) {
     if (exports.t.isIdentifier(node)) {
@@ -1043,6 +1074,7 @@ const globalAgregatedTables = {
 let hasComputedOnce = false;
 let resolutionConfigStamp;
 let scannedCwd;
+let scannedStyleProp;
 const objectTableOwners = new Map();
 const fileObjectContributions = new Map();
 const fileKeyContributions = new Map();
@@ -1204,35 +1236,38 @@ function statFile(filePath) {
         throw e;
     }
 }
-function scanOverlay(scanCwd = process.cwd()) {
+function scanOverlay(scanCwd = process.cwd(), styleProp = constants_1.DEFAULT_STYLE_PROP) {
     overlayScan = true;
     try {
-        return scanAll(scanCwd);
+        return scanAll(scanCwd, styleProp);
     }
     finally {
         overlayScan = false;
     }
 }
-function scanAll(scanCwd = process.cwd()) {
+function scanAll(scanCwd = process.cwd(), styleProp = constants_1.DEFAULT_STYLE_PROP) {
     scanning = true;
     statMemo.clear();
     try {
-        return runScan(scanCwd);
+        return runScan(scanCwd, styleProp);
     }
     finally {
         scanning = false;
         statMemo.clear();
     }
 }
-function runScan(scanCwd = process.cwd()) {
+function runScan(scanCwd, styleProp) {
     const cwd = path.resolve(scanCwd);
     if (hasComputedOnce &&
         process.env.NODE_ENV === 'production' &&
-        scannedCwd === cwd) {
+        scannedCwd === cwd &&
+        scannedStyleProp === styleProp) {
         return snapshotTables();
     }
     const localTables = globalAgregatedTables;
     scannedCwd = cwd;
+    const stylePropChanged = scannedStyleProp !== undefined && scannedStyleProp !== styleProp;
+    scannedStyleProp = styleProp;
     const configPath = path.join(cwd, 'tsconfig.json');
     let configStamp = configPath;
     try {
@@ -1277,7 +1312,10 @@ function runScan(scanCwd = process.cwd()) {
         try {
             const stats = fs.statSync(filePath);
             const cached = fileCache[filePath];
-            if (resolutionChanged || !cached || cached.mtimeMs !== stats.mtimeMs) {
+            if (resolutionChanged ||
+                stylePropChanged ||
+                !cached ||
+                cached.mtimeMs !== stats.mtimeMs) {
                 invalidated.add(filePath);
                 queue.push(filePath);
             }
@@ -1360,7 +1398,7 @@ function runScan(scanCwd = process.cwd()) {
         try {
             const stats = fs.statSync(filePath);
             const source = fs.readFileSync(filePath, 'utf8');
-            if (!source.includes('@plumeria/core')) {
+            if (!(0, stylePropFilter_1.needsCompile)(source, styleProp, filePath)) {
                 updateDependencyEdges(filePath, fileCache[filePath]?.dependencies, undefined);
                 fileCache[filePath] = {
                     mtimeMs: stats.mtimeMs,
@@ -1686,7 +1724,7 @@ function runScan(scanCwd = process.cwd()) {
                                 else if (method === 'createTheme') {
                                     const selector = resolveThemeSelector(init.arguments[0].expression, scopedStaticTable, localCreateStaticHashTable, localCreateStaticObjectTable);
                                     if (!selector)
-                                        throw new Error('[plumeria] createTheme requires a statically resolvable non-empty selector.');
+                                        throw new Error('[plumeria] createTheme needs a non-empty selector it can read at build time. Pass a string literal such as ".dark", or a name this file declares as one.');
                                     const hash = (0, createTheme_1.themeHashOf)(selector, obj);
                                     localTables.createThemeObjectTable[hash] = obj;
                                     localCreateThemeObjectTable[hash] = obj;

package/dist/stylePropFilter.d.ts

@@ -0,0 +1,2 @@
+export declare const usesStyleProp: (source: string, styleProp: string, filePath: string) => boolean;
+export declare const needsCompile: (source: string, styleProp: string, filePath: string) => boolean;

package/dist/stylePropFilter.js

@@ -0,0 +1,287 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.needsCompile = exports.usesStyleProp = void 0;
+const CORE = '@plumeria/core';
+const isIdentifierStart = (c) => (c >= 65 && c <= 90) || (c >= 97 && c <= 122) || c === 95 || c === 36;
+const isNameChar = (c) => isIdentifierStart(c) || (c >= 48 && c <= 57) || c === 46 || c === 45;
+const isSpace = (c) => c === 32 || (c >= 9 && c <= 13);
+const EXPRESSION_BEFORE = new Set(Array.from('(,=:[!&|?{};+-*%<>~^', (c) => c.charCodeAt(0)));
+const EXPRESSION_WORDS = new Set([
+    'return',
+    'yield',
+    'default',
+    'else',
+    'case',
+    'await',
+    'do',
+    'typeof',
+    'void',
+    'in',
+    'of',
+    'new',
+    'delete',
+    'throw',
+]);
+const MODE_CODE = 0;
+const MODE_TAG = 1;
+const MODE_CHILDREN = 2;
+const skipTrivia = (source, start) => {
+    let i = start;
+    while (i < source.length) {
+        const c = source.charCodeAt(i);
+        if (isSpace(c)) {
+            i++;
+        }
+        else if (c === 47 && source.charCodeAt(i + 1) === 42) {
+            const end = source.indexOf('*/', i + 2);
+            if (end === -1)
+                return source.length;
+            i = end + 2;
+        }
+        else if (c === 47 && source.charCodeAt(i + 1) === 47) {
+            const end = source.indexOf('\n', i + 2);
+            if (end === -1)
+                return source.length;
+            i = end + 1;
+        }
+        else {
+            break;
+        }
+    }
+    return i;
+};
+const attributeAt = (source, index, name) => {
+    if (index > 0 && isNameChar(source.charCodeAt(index - 1)))
+        return false;
+    let i = skipTrivia(source, index + name.length);
+    if (source.charCodeAt(i) !== 61)
+        return false;
+    i = skipTrivia(source, i + 1);
+    return source.charCodeAt(i) === 123;
+};
+const hasAttributeCandidate = (source, name) => {
+    for (let i = source.indexOf(name); i !== -1; i = source.indexOf(name, i + 1)) {
+        if (attributeAt(source, i, name))
+            return true;
+    }
+    return false;
+};
+const wordBefore = (source, end) => {
+    let start = end;
+    while (start > 0 && isNameChar(source.charCodeAt(start - 1)))
+        start--;
+    return source.slice(start, end);
+};
+const closingQuote = (source, start, quote, multiline) => {
+    for (let i = start + 1; i < source.length; i++) {
+        const c = source.charCodeAt(i);
+        if (c === 92) {
+            i++;
+            continue;
+        }
+        if (c === quote)
+            return i;
+        if (c === 10 && !multiline)
+            return -1;
+    }
+    return -1;
+};
+const writesAttribute = (source, name) => {
+    const first = name.charCodeAt(0);
+    const stack = [];
+    let mode = MODE_CODE;
+    let previous = 0;
+    let previousEnd = 0;
+    const leaveElement = () => {
+        mode = stack[stack.length - 1] === 'element' ? MODE_CHILDREN : MODE_CODE;
+        previous = 41;
+    };
+    const templateEnd = (from) => {
+        for (let i = from; i < source.length; i++) {
+            const c = source.charCodeAt(i);
+            if (c === 92) {
+                i++;
+                continue;
+            }
+            if (c === 96)
+                return i;
+            if (c === 36 && source.charCodeAt(i + 1) === 123) {
+                stack.push('template');
+                return i + 1;
+            }
+        }
+        return -1;
+    };
+    for (let i = 0; i < source.length; i++) {
+        const c = source.charCodeAt(i);
+        if (c === first &&
+            source.startsWith(name, i) &&
+            attributeAt(source, i, name))
+            return true;
+        if (mode === MODE_TAG) {
+            if (c === 47 && source.charCodeAt(i + 1) === 42) {
+                const end = source.indexOf('*/', i + 2);
+                if (end === -1)
+                    return true;
+                i = end + 1;
+            }
+            else if (c === 47 && source.charCodeAt(i + 1) === 47) {
+                const end = source.indexOf('\n', i + 2);
+                if (end === -1)
+                    return true;
+                i = end;
+            }
+            else if (c === 47 && source.charCodeAt(i + 1) === 62) {
+                i++;
+                leaveElement();
+            }
+            else if (c === 62) {
+                stack.push('element');
+                mode = MODE_CHILDREN;
+            }
+            else if (c === 123) {
+                stack.push('attribute');
+                mode = MODE_CODE;
+                previous = 123;
+            }
+            else if (c === 34 || c === 39) {
+                const end = closingQuote(source, i, c, true);
+                if (end === -1)
+                    return true;
+                i = end;
+            }
+            continue;
+        }
+        if (mode === MODE_CHILDREN) {
+            if (c === 123) {
+                stack.push('child');
+                mode = MODE_CODE;
+                previous = 123;
+            }
+            else if (c === 60) {
+                if (source.charCodeAt(i + 1) === 47) {
+                    const end = source.indexOf('>', i);
+                    if (end === -1)
+                        return true;
+                    i = end;
+                    stack.pop();
+                    leaveElement();
+                }
+                else {
+                    mode = MODE_TAG;
+                }
+            }
+            continue;
+        }
+        if (isSpace(c))
+            continue;
+        if (c === 47 && source.charCodeAt(i + 1) === 47) {
+            const end = source.indexOf('\n', i);
+            if (end === -1)
+                return false;
+            i = end;
+            continue;
+        }
+        if (c === 47 && source.charCodeAt(i + 1) === 42) {
+            const end = source.indexOf('*/', i + 2);
+            if (end === -1)
+                return true;
+            i = end + 1;
+            continue;
+        }
+        if (c === 39 || c === 34) {
+            const end = closingQuote(source, i, c, false);
+            if (end === -1)
+                return true;
+            i = end;
+            previous = c;
+            continue;
+        }
+        if (c === 96) {
+            const end = templateEnd(i + 1);
+            if (end === -1)
+                return true;
+            i = end;
+            previous = 96;
+            continue;
+        }
+        if (c === 123) {
+            stack.push('brace');
+            previous = c;
+            continue;
+        }
+        if (c === 125) {
+            const kind = stack.pop();
+            if (kind === 'template') {
+                const end = templateEnd(i + 1);
+                if (end === -1)
+                    return true;
+                i = end;
+                previous = 96;
+                continue;
+            }
+            if (kind === 'attribute') {
+                mode = MODE_TAG;
+                continue;
+            }
+            if (kind === 'child') {
+                mode = MODE_CHILDREN;
+                continue;
+            }
+            if (kind !== 'brace')
+                return true;
+            previous = c;
+            continue;
+        }
+        const afterUpdate = (previous === 43 || previous === 45) &&
+            source.charCodeAt(previousEnd - 2) === previous;
+        const expressionStart = previous === 0 ||
+            (EXPRESSION_BEFORE.has(previous) && !afterUpdate) ||
+            (isNameChar(previous) &&
+                EXPRESSION_WORDS.has(wordBefore(source, previousEnd)));
+        if (c === 47 && expressionStart) {
+            let end = i + 1;
+            let inClass = false;
+            for (; end < source.length; end++) {
+                const d = source.charCodeAt(end);
+                if (d === 92) {
+                    end++;
+                    continue;
+                }
+                if (d === 10)
+                    break;
+                if (d === 91)
+                    inClass = true;
+                else if (d === 93)
+                    inClass = false;
+                else if (d === 47 && !inClass)
+                    break;
+            }
+            if (source.charCodeAt(end) === 47) {
+                i = end;
+                previous = 41;
+                continue;
+            }
+        }
+        if (c === 60 && expressionStart) {
+            const next = source.charCodeAt(i + 1);
+            if (isIdentifierStart(next) || next === 62) {
+                mode = MODE_TAG;
+                continue;
+            }
+        }
+        previous = c;
+        previousEnd = i + 1;
+    }
+    return false;
+};
+const usesStyleProp = (source, styleProp, filePath) => {
+    if (filePath.endsWith('.ts') || filePath.endsWith('.mts'))
+        return false;
+    if (!styleProp || !hasAttributeCandidate(source, styleProp))
+        return false;
+    return writesAttribute(source, styleProp);
+};
+exports.usesStyleProp = usesStyleProp;
+const needsCompile = (source, styleProp, filePath) => source.includes(CORE) || (0, exports.usesStyleProp)(source, styleProp, filePath);
+exports.needsCompile = needsCompile;

package/dist/transform.js

@@ -39,7 +39,7 @@ const path = __importStar(require("path"));
 const zss_engine_1 = require("zss-engine");
 const parser_1 = require("./parser");
 const unresolvableValue_1 = require("./unresolvableValue");
-const spreadValues = (tables, constNodes) => {
+const spreadValues = (tables, constNodes, sourceOf) => {
     const spread = (prop) => {
         let values;
         try {
@@ -72,7 +72,7 @@ const spreadValues = (tables, constNodes) => {
             return false;
         }
     };
-    return { spread, resolvesValue };
+    return { spread, resolvesValue, sourceOf };
 };
 const create_1 = require("./create");
 const dynamicKey_1 = require("./dynamicKey");
@@ -128,9 +128,9 @@ const destructuredPropAliases = (fn) => {
     }
     return aliases;
 };
-const propDefaultMessage = (source) => `Plumeria: A style prop default must be a defined style: "${source}". ` +
+const propDefaultMessage = (source) => `[plumeria] A style prop default must be a defined style: "${source}". ` +
     `Apply a conditional or dynamic style where the element is styled.`;
-const spreadStyleMessage = (source) => `Plumeria: Spread elements in a style array are not supported: "...${source}". ` +
+const spreadStyleMessage = (source) => `[plumeria] Spread elements in a style array are not supported: "...${source}". ` +
     `List each style explicitly.`;
 const resolveLocalStyleAlias = (aliases, expression) => {
     let current = expression;
@@ -196,6 +196,11 @@ const transformSource = async (env) => {
     const sourceBuffer = Buffer.from(source, 'utf-8');
     const leadingBytes = Buffer.byteLength(source.slice(0, leadingLen), 'utf-8');
     const baseByteOffset = ast.span.start - leadingBytes;
+    const getSource = (node) => {
+        const start = node.span.start - baseByteOffset;
+        const end = node.span.end - baseByteOffset;
+        return sourceBuffer.subarray(start, end).toString('utf-8');
+    };
     const throwCompilationError = (message, node) => {
         let suffix = '';
         if (node) {
@@ -232,16 +237,16 @@ const transformSource = async (env) => {
             if (!isPlumeriaStyle) {
                 const failure = (0, parser_1.resolveOriginError)(node, rootId, localImports);
                 if (failure) {
-                    throwCompilationError(`Plumeria: ${failure.message} (${path.basename(failure.filePath)})`);
+                    throwCompilationError(`[plumeria] ${failure.message} (${path.basename(failure.filePath)})`);
                 }
-                throwCompilationError(`Plumeria: Dynamic or unresolvable style object "${getSource(node)}" is not supported.`, node);
+                throwCompilationError(`[plumeria] Dynamic or unresolvable style object "${getSource(node)}" is not supported.`, node);
             }
         }
     };
-    const scannedTables = (0, parser_1.scanOverlay)();
+    const scannedTables = (0, parser_1.scanOverlay)(undefined, styleProp);
     const ownFailure = (0, parser_1.resolveFileError)(baseId, '');
     if (ownFailure)
-        throwCompilationError(`Plumeria: ${ownFailure.message}`);
+        throwCompilationError(`[plumeria] ${ownFailure.message}`);
     for (const node of ast.body) {
         if (node.type === 'ImportDeclaration') {
             const sourcePath = node.source.value;
@@ -605,14 +610,14 @@ const transformSource = async (env) => {
         if (propName && init && parser_1.t.isCallExpression(init)) {
             if (['create', 'createTheme', 'createStatic'].includes(propName) &&
                 !topLevelDeclarators.has(node)) {
-                throwCompilationError(`Plumeria: css.${propName} must be assigned to a top-level variable so its styles can be resolved across files. Move this declaration outside the function or block.`, node);
+                throwCompilationError(`[plumeria] css.${propName} must be assigned to a top-level variable so its styles can be resolved across files. Move this declaration outside the function or block.`, node);
             }
             if (['create', 'createTheme', 'createStatic'].includes(propName)) {
                 const argumentIndex = propName === 'createTheme' ? 1 : 0;
                 const argument = init.arguments[argumentIndex];
                 const object = argument && literalObjectArgument(argument.expression);
                 if (!object)
-                    throwCompilationError(`Plumeria: css.${propName} needs a style object it can read at build time. Pass an object literal or a top-level constant containing one.`, init);
+                    throwCompilationError(`[plumeria] css.${propName} needs a style object it can read at build time. Pass an object literal or a top-level constant containing one.`, init);
                 argument.expression = object;
                 registeredStyleCalls.add(init.span.start);
             }
@@ -628,7 +633,7 @@ const transformSource = async (env) => {
                     mergedCreateTable,
                     mergedCreateStaticHashTable,
                     scannedTables.createStaticObjectTable,
-                ], localConstNodes));
+                ], localConstNodes, getSource));
                 if (obj) {
                     const hashMap = {};
                     Object.entries(obj).forEach(([key, style]) => {
@@ -672,11 +677,11 @@ const transformSource = async (env) => {
                 const selectorExpr = init.arguments[0].expression;
                 const selector = (0, parser_1.resolveThemeSelector)(selectorExpr, mergedStaticTable, mergedCreateStaticHashTable, scannedTables.createStaticObjectTable);
                 if (!selector) {
-                    throwCompilationError(`Plumeria: createTheme needs a selector it can read at build time. ` +
+                    throwCompilationError(`[plumeria] createTheme needs a selector it can read at build time. ` +
                         `Pass a string literal such as ".dark", or a name this file declares as one.`, selectorExpr);
                 }
                 if (selector.startsWith('@') && !(0, zss_engine_1.isAtRule)(selector)) {
-                    throwCompilationError(`Plumeria: Unsupported at-rule: "${selector}". createTheme only supports nesting at-rules such as @media, @container, @supports, @layer, and @scope.`, selectorExpr);
+                    throwCompilationError(`[plumeria] Unsupported at-rule: "${selector}". createTheme only supports nesting at-rules such as @media, @container, @supports, @layer, and @scope.`, selectorExpr);
                 }
                 const obj = (0, parser_1.objectExpressionToObject)(init.arguments[1].expression, mergedStaticTable, mergedKeyframesTable, mergedViewTransitionTable, mergedCreateThemeHashTable, scannedTables.createThemeObjectTable, mergedCreateTable, mergedCreateStaticHashTable, scannedTables.createStaticObjectTable);
                 (0, unresolvableValue_1.assertNoDroppedValues)(init.arguments[1].expression, obj, spreadValues([
@@ -688,7 +693,7 @@ const transformSource = async (env) => {
                     mergedCreateTable,
                     mergedCreateStaticHashTable,
                     scannedTables.createStaticObjectTable,
-                ], localConstNodes));
+                ], localConstNodes, getSource));
                 const hash = (0, createTheme_1.themeHashOf)(selector, obj);
                 if (parser_1.t.isIdentifier(node.id)) {
                     const uniqueKey = `${resourcePath}-${node.id.value}`;
@@ -736,7 +741,7 @@ const transformSource = async (env) => {
                     mergedCreateTable,
                     mergedCreateStaticHashTable,
                     scannedTables.createStaticObjectTable,
-                ], localConstNodes));
+                ], localConstNodes, getSource));
                 const hash = (0, zss_engine_1.genBase36Hash)(obj, 1, 8);
                 if (parser_1.t.isIdentifier(node.id)) {
                     const uniqueKey = `${resourcePath}-${node.id.value}`;
@@ -842,7 +847,7 @@ const transformSource = async (env) => {
             if (propName) {
                 if (['create', 'createTheme', 'createStatic'].includes(propName) &&
                     !registeredStyleCalls.has(node.span.start)) {
-                    throwCompilationError(`Plumeria: css.${propName} must be assigned to a named top-level variable. Destructuring, assignment statements, and default-exported calls cannot be compiled.`, node);
+                    throwCompilationError(`[plumeria] css.${propName} must be assigned to a named top-level variable. Destructuring, assignment statements, and default-exported calls cannot be compiled.`, node);
                 }
                 const args = node.arguments;
                 if (propName === 'keyframes' && args.length > 0) {
@@ -858,7 +863,7 @@ const transformSource = async (env) => {
                             mergedCreateTable,
                             mergedCreateStaticHashTable,
                             scannedTables.createStaticObjectTable,
-                        ], localConstNodes));
+                        ], localConstNodes, getSource));
                         const hash = (0, zss_engine_1.genBase36Hash)(obj, 1, 8);
                         scannedTables.keyframesObjectTable[hash] = obj;
                         replacements.push({
@@ -881,7 +886,7 @@ const transformSource = async (env) => {
                         mergedCreateTable,
                         mergedCreateStaticHashTable,
                         scannedTables.createStaticObjectTable,
-                    ], localConstNodes));
+                    ], localConstNodes, getSource));
                     const hash = (0, zss_engine_1.genBase36Hash)(obj, 1, 8);
                     scannedTables.viewTransitionObjectTable[hash] = obj;
                     replacements.push({
@@ -896,11 +901,11 @@ const transformSource = async (env) => {
                     const selectorExpr = args[0].expression;
                     const selector = (0, parser_1.resolveThemeSelector)(selectorExpr, mergedStaticTable, mergedCreateStaticHashTable, scannedTables.createStaticObjectTable);
                     if (!selector) {
-                        throwCompilationError(`Plumeria: createTheme needs a selector it can read at build time. ` +
+                        throwCompilationError(`[plumeria] createTheme needs a selector it can read at build time. ` +
                             `Pass a string literal such as ".dark", or a name this file declares as one.`, selectorExpr);
                     }
                     if (selector.startsWith('@') && !(0, zss_engine_1.isAtRule)(selector)) {
-                        throwCompilationError(`Plumeria: Unsupported at-rule: "${selector}". createTheme only supports nesting at-rules such as @media, @container, @supports, @layer, and @scope.`, selectorExpr);
+                        throwCompilationError(`[plumeria] Unsupported at-rule: "${selector}". createTheme only supports nesting at-rules such as @media, @container, @supports, @layer, and @scope.`, selectorExpr);
                     }
                     const obj = (0, parser_1.objectExpressionToObject)(args[1].expression, mergedStaticTable, mergedKeyframesTable, mergedViewTransitionTable, mergedCreateThemeHashTable, scannedTables.createThemeObjectTable, mergedCreateTable, mergedCreateStaticHashTable, scannedTables.createStaticObjectTable);
                     (0, unresolvableValue_1.assertNoDroppedValues)(args[1].expression, obj, spreadValues([
@@ -912,7 +917,7 @@ const transformSource = async (env) => {
                         mergedCreateTable,
                         mergedCreateStaticHashTable,
                         scannedTables.createStaticObjectTable,
-                    ], localConstNodes));
+                    ], localConstNodes, getSource));
                     const hash = (0, createTheme_1.themeHashOf)(selector, obj);
                     scannedTables.createThemeObjectTable[hash] = obj;
                     if (scannedTables.createThemeSelectorTable) {
@@ -932,7 +937,7 @@ const transformSource = async (env) => {
                         mergedCreateTable,
                         mergedCreateStaticHashTable,
                         scannedTables.createStaticObjectTable,
-                    ], localConstNodes));
+                    ], localConstNodes, getSource));
                     const hash = (0, zss_engine_1.genBase36Hash)(obj, 1, 8);
                     scannedTables.createStaticObjectTable[hash] = obj;
                 }
@@ -1008,11 +1013,6 @@ const transformSource = async (env) => {
         }
         Object.values(n).forEach((val) => excludeSubtreeSpans(val));
     };
-    const getSource = (node) => {
-        const start = node.span.start - baseByteOffset;
-        const end = node.span.end - baseByteOffset;
-        return sourceBuffer.subarray(start, end).toString('utf-8');
-    };
     const isVisibleReference = (expr) => {
         if (parser_1.t.isIdentifier(expr))
             return referenceIdents.references.has(expr.span.start);
@@ -1148,7 +1148,7 @@ const transformSource = async (env) => {
             const argExpr = callArgs[0]?.expression;
             if (callArgs.length > 1 ||
                 (argExpr && argExpr.type !== 'ObjectExpression')) {
-                throwCompilationError(`Plumeria: ${getSource(expr)} takes one object argument, because ${callee.property.value} destructures its parameter.`, expr);
+                throwCompilationError(`[plumeria] ${getSource(expr)} takes one object argument, because ${callee.property.value} destructures its parameter.`, expr);
             }
             const given = new Map();
             (argExpr?.properties ?? []).forEach((prop) => {
@@ -1168,7 +1168,7 @@ const transformSource = async (env) => {
                 if (!source) {
                     if (func.defaults?.[local])
                         return;
-                    return throwCompilationError(`Plumeria: ${getSource(expr)} leaves "${key}" unset, and a dynamic style function has no value to fall back on.`, expr);
+                    return throwCompilationError(`[plumeria] ${getSource(expr)} leaves "${key}" unset, and a dynamic style function has no value to fall back on.`, expr);
                 }
                 if (!forceRuntime &&
                     isStaticArgValue(source) &&
@@ -1387,7 +1387,7 @@ const transformSource = async (env) => {
                 const dynamic = resolveDynamicCall(node);
                 if (dynamic) {
                     if (!isStyleProp) {
-                        throwCompilationError(`Plumeria: css.use(${getSource(node)}) does not support dynamic function keys.`, node);
+                        throwCompilationError(`[plumeria] css.use(${getSource(node)}) does not support dynamic function keys.`, node);
                     }
                     branchStyle = dynamic.style;
                     dynamic.vars.forEach((v) => dynamicVars.push({
@@ -1516,7 +1516,7 @@ const transformSource = async (env) => {
             }
             const carriesVars = possibilities.some((entry) => entry.hasVars);
             if (carriesVars && !isStyleProp) {
-                throwCompilationError(`Plumeria: "${varName}" carries a dynamic function key, and css.use() returns only a class name. ` +
+                throwCompilationError(`[plumeria] "${varName}" carries a dynamic function key, and css.use() returns only a class name. ` +
                     `Apply it to ${styleProp} on the element instead.`, expr);
             }
             const gate = gates.length ? `(${gates.join(' && ')}) && ` : '';
@@ -2276,7 +2276,7 @@ const transformSource = async (env) => {
             }
             const { classParts, isOptimizable, baseStyle, dynamicVars, propVarSpreads, } = buildClassParts(args, dynamicClassParts, existingClassExpr, true);
             if (!isOptimizable) {
-                throwCompilationError(`Plumeria: Dynamic or unresolvable style object "${getSource(expr)}" is not supported.`, expr);
+                throwCompilationError(`[plumeria] Dynamic or unresolvable style object "${getSource(expr)}" is not supported.`, expr);
             }
             const styleParts = [
                 ...existingStyleParts,
@@ -2346,7 +2346,7 @@ const transformSource = async (env) => {
                 const propKey = callee.property.value;
                 const styleInfo = localCreateStyles[varName];
                 if (styleInfo?.functions?.[propKey]) {
-                    throwCompilationError(`Plumeria: css.use(${getSource(expr)}) does not support dynamic function keys.`, expr);
+                    throwCompilationError(`[plumeria] css.use(${getSource(expr)}) does not support dynamic function keys.`, expr);
                 }
             }
             const { classParts, isOptimizable } = buildClassParts(args);
@@ -2359,7 +2359,7 @@ const transformSource = async (env) => {
                 });
             }
             else {
-                throwCompilationError(`Plumeria: Dynamic or unresolvable style object "${getSource(node)}" is not supported.`, node);
+                throwCompilationError(`[plumeria] Dynamic or unresolvable style object "${getSource(node)}" is not supported.`, node);
             }
         },
     });
@@ -2369,7 +2369,7 @@ const transformSource = async (env) => {
             if (appliedStyleProps.has(`${name}:${propName}`)) {
                 continue;
             }
-            throwCompilationError(`Plumeria: "${propName}" is a style received through a prop but is never applied ` +
+            throwCompilationError(`[plumeria] "${propName}" is a style received through a prop but is never applied ` +
                 `to ${styleProp} or css.use() here. Apply it on an element this component renders; ` +
                 `a style prop cannot be passed on to another component.`, node);
         }
@@ -2379,7 +2379,7 @@ const transformSource = async (env) => {
         if (!isDev || keys.length === 0) {
             return JSON.stringify('');
         }
-        const head = JSON.stringify(`Plumeria: "${info.name}.`);
+        const head = JSON.stringify(`[plumeria] "${info.name}.`);
         const tail = JSON.stringify(`" was read at runtime. The file that read it was not compiled ` +
             `because it does not reference "@plumeria/core" — add ` +
             `import '@plumeria/core'; to it (see the stack below). Defined in ` +
@@ -2410,7 +2410,7 @@ const transformSource = async (env) => {
         const end = call.span.end - baseByteOffset;
         const isResolved = replacements.some((r) => r.start <= start && r.end >= end);
         if (!isResolved) {
-            throwCompilationError(`Plumeria: ${getSource(call)} is only supported in the ${styleProp} prop. ` +
+            throwCompilationError(`[plumeria] ${getSource(call)} is only supported in the ${styleProp} prop. ` +
                 `A dynamic style function resolves to a class name and a CSS variable on the element itself, ` +
                 `so it cannot be passed through another prop or read as a value.`, call);
         }

package/dist/unresolvableValue.d.ts

@@ -9,6 +9,7 @@ type ResolveSpread = (prop: SpreadElement) => SpreadInfo | null;
 export type StyleContext = {
     spread: ResolveSpread;
     resolvesValue: (value: unknown) => boolean;
+    sourceOf?: (node: unknown) => string;
 };
 export declare const assertNoDroppedValues: (node: SourceObject, resolved: StaticValues | null | undefined, context?: StyleContext, ignore?: Set<string>) => void;
 export {};

package/dist/unresolvableValue.js

@@ -9,7 +9,7 @@ const keyValue = (key) => {
         ? value
         : undefined;
 };
-const unresolvableValue = (key, node) => new Error(`[plumeria] Cannot resolve the value of "${key}" at build time (${node.type}). ` +
+const unresolvableValue = (key, node, context) => new Error(`[plumeria] Cannot resolve the value of "${key}" at build time (${context?.sourceOf?.(node) ?? node.type}). ` +
     `Values in css.create must be statically known; pass a runtime value through the ` +
     `function form, css.create({ name: (value) => ({ ... }) }).`);
 const overwrittenLater = (properties, index, key, context) => {
@@ -101,12 +101,12 @@ const assertStyleFunction = (func, context) => {
                 continue;
             }
             if (RUNTIME_ONLY.has(value.type) && !readsAnyOf(value, params))
-                throw unresolvableValue(key ?? '', value);
+                throw unresolvableValue(key ?? '', value, context);
             if ((value.type === 'Identifier' || value.type === 'MemberExpression') &&
                 context &&
                 !readsAnyOf(value, params) &&
                 !context.resolvesValue(value))
-                throw unresolvableValue(key ?? '', value);
+                throw unresolvableValue(key ?? '', value, context);
         }
     };
     walk(returned);
@@ -166,7 +166,7 @@ const assertNoDroppedValues = (node, resolved, context, ignore) => {
         if (value.type === 'NullLiteral')
             continue;
         if (!(key in resolved))
-            throw unresolvableValue(key, value);
+            throw unresolvableValue(key, value, context);
         if (value.type === 'ObjectExpression') {
             const nested = resolved[key];
             if (nested && typeof nested === 'object')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumeria/utils",
-  "version": "19.2.15",
+  "version": "19.3.0",
   "description": "Plumeria Utils",
   "author": "Refirst 11",
   "license": "MIT",