@plumeria/utils 19.2.14 → 19.2.16

package/dist/parser.d.ts

@@ -43,6 +43,7 @@ export declare function traverse(node: Module | JSXExpression, visitor: {
     }) => void;
 }): void;
 export declare function objectExpressionToObject(node: ObjectExpression, staticTable: StaticTable, keyframesHashTable: KeyframesHashTable, viewTransitionHashTable: ViewTransitionHashTable, createThemeHashTable: CreateThemeHashTable, createThemeObjectTable: CreateThemeObjectTable, createHashTable: CreateHashTable, createStaticHashTable: CreateStaticHashTable, createStaticObjectTable: CreateStaticObjectTable, resolveVariable?: (name: string) => any): CSSObject;
+export declare function collectLocalConstNodes(ast: Module): Map<string, any>;
 export declare function collectLocalConsts(ast: Module): Record<string, any>;
 export declare function resolveThemeSelector(node: Expression, staticTable: StaticTable, createStaticHashTable: CreateStaticHashTable, createStaticObjectTable: CreateStaticObjectTable): string;
 export declare function resolveFileError(actualPath: string, importedName: string): {

package/dist/parser.js

@@ -39,6 +39,7 @@ exports.resolveOriginError = resolveOriginError;
 exports.resolveComponentKey = resolveComponentKey;
 exports.traverse = traverse;
 exports.objectExpressionToObject = objectExpressionToObject;
+exports.collectLocalConstNodes = collectLocalConstNodes;
 exports.collectLocalConsts = collectLocalConsts;
 exports.resolveThemeSelector = resolveThemeSelector;
 exports.resolveFileError = resolveFileError;
@@ -101,6 +102,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)) {
@@ -277,7 +307,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;
                 }
@@ -343,8 +373,7 @@ function objectExpressionToObject(node, staticTable, keyframesHashTable, viewTra
     });
     return obj;
 }
-function collectLocalConsts(ast) {
-    const localConsts = {};
+function collectLocalConstNodes(ast) {
     const decls = new Map();
     for (const node of ast.body) {
         let declarations = [];
@@ -363,6 +392,11 @@ function collectLocalConsts(ast) {
             }
         }
     }
+    return decls;
+}
+function collectLocalConsts(ast) {
+    const localConsts = {};
+    const decls = collectLocalConstNodes(ast);
     const visiting = new Set();
     function resolveValue(name) {
         if (localConsts[name] !== undefined)
@@ -679,7 +713,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);
         }
     }
@@ -747,7 +781,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;
@@ -821,7 +855,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);
@@ -836,7 +870,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);
@@ -856,12 +890,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)) {
@@ -1681,7 +1715,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/transform.js

@@ -38,6 +38,42 @@ const core_1 = require("@swc/core");
 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, sourceOf) => {
+    const spread = (prop) => {
+        let values;
+        try {
+            values = (0, parser_1.objectExpressionToObject)({ properties: [prop] }, ...tables);
+        }
+        catch {
+            return null;
+        }
+        const argument = prop.arguments;
+        const declared = argument?.type === 'Identifier'
+            ? constNodes.get(argument.value)
+            : undefined;
+        const source = declared && parser_1.t.isObjectExpression(declared) ? declared : undefined;
+        return { values, source };
+    };
+    const resolvesValue = (value) => {
+        try {
+            const probe = (0, parser_1.objectExpressionToObject)({
+                properties: [
+                    {
+                        type: 'KeyValueProperty',
+                        key: { type: 'Identifier', value: '__probe' },
+                        value,
+                    },
+                ],
+            }, ...tables);
+            return '__probe' in probe;
+        }
+        catch {
+            return false;
+        }
+    };
+    return { spread, resolvesValue, sourceOf };
+};
 const create_1 = require("./create");
 const dynamicKey_1 = require("./dynamicKey");
 const escalation_1 = require("./escalation");
@@ -92,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;
@@ -160,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) {
@@ -196,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 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;
@@ -309,6 +350,7 @@ const transformSource = async (env) => {
         return records;
     };
     const localConsts = (0, parser_1.collectLocalConsts)(ast);
+    const localConstNodes = (0, parser_1.collectLocalConstNodes)(ast);
     const importMap = {};
     const keyframesImportMap = {};
     const viewTransitionImportMap = {};
@@ -568,20 +610,30 @@ 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);
             }
             if (propName === 'create' &&
                 parser_1.t.isObjectExpression(init.arguments[0].expression)) {
                 const obj = (0, parser_1.objectExpressionToObject)(init.arguments[0].expression, mergedStaticTable, mergedKeyframesTable, mergedViewTransitionTable, mergedCreateThemeHashTable, scannedTables.createThemeObjectTable, mergedCreateTable, mergedCreateStaticHashTable, scannedTables.createStaticObjectTable);
+                (0, unresolvableValue_1.assertNoDroppedValues)(init.arguments[0].expression, obj, spreadValues([
+                    mergedStaticTable,
+                    mergedKeyframesTable,
+                    mergedViewTransitionTable,
+                    mergedCreateThemeHashTable,
+                    scannedTables.createThemeObjectTable,
+                    mergedCreateTable,
+                    mergedCreateStaticHashTable,
+                    scannedTables.createStaticObjectTable,
+                ], localConstNodes, getSource));
                 if (obj) {
                     const hashMap = {};
                     Object.entries(obj).forEach(([key, style]) => {
@@ -625,13 +677,23 @@ 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([
+                    mergedStaticTable,
+                    mergedKeyframesTable,
+                    mergedViewTransitionTable,
+                    mergedCreateThemeHashTable,
+                    scannedTables.createThemeObjectTable,
+                    mergedCreateTable,
+                    mergedCreateStaticHashTable,
+                    scannedTables.createStaticObjectTable,
+                ], localConstNodes, getSource));
                 const hash = (0, createTheme_1.themeHashOf)(selector, obj);
                 if (parser_1.t.isIdentifier(node.id)) {
                     const uniqueKey = `${resourcePath}-${node.id.value}`;
@@ -670,6 +732,16 @@ const transformSource = async (env) => {
                     idSpans.add(node.id.span.start);
                 }
                 const obj = (0, parser_1.objectExpressionToObject)(init.arguments[0].expression, mergedStaticTable, mergedKeyframesTable, mergedViewTransitionTable, mergedCreateThemeHashTable, scannedTables.createThemeObjectTable, mergedCreateTable, mergedCreateStaticHashTable, scannedTables.createStaticObjectTable);
+                (0, unresolvableValue_1.assertNoDroppedValues)(init.arguments[0].expression, obj, spreadValues([
+                    mergedStaticTable,
+                    mergedKeyframesTable,
+                    mergedViewTransitionTable,
+                    mergedCreateThemeHashTable,
+                    scannedTables.createThemeObjectTable,
+                    mergedCreateTable,
+                    mergedCreateStaticHashTable,
+                    scannedTables.createStaticObjectTable,
+                ], 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}`;
@@ -775,13 +847,23 @@ 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) {
                     const expr = args[0].expression;
                     if (parser_1.t.isObjectExpression(expr)) {
                         const obj = (0, parser_1.objectExpressionToObject)(expr, mergedStaticTable, mergedKeyframesTable, mergedViewTransitionTable, mergedCreateThemeHashTable, scannedTables.createThemeObjectTable, mergedCreateTable, mergedCreateStaticHashTable, scannedTables.createStaticObjectTable);
+                        (0, unresolvableValue_1.assertNoDroppedValues)(expr, obj, spreadValues([
+                            mergedStaticTable,
+                            mergedKeyframesTable,
+                            mergedViewTransitionTable,
+                            mergedCreateThemeHashTable,
+                            scannedTables.createThemeObjectTable,
+                            mergedCreateTable,
+                            mergedCreateStaticHashTable,
+                            scannedTables.createStaticObjectTable,
+                        ], localConstNodes, getSource));
                         const hash = (0, zss_engine_1.genBase36Hash)(obj, 1, 8);
                         scannedTables.keyframesObjectTable[hash] = obj;
                         replacements.push({
@@ -795,6 +877,16 @@ const transformSource = async (env) => {
                     args.length > 0 &&
                     parser_1.t.isObjectExpression(args[0].expression)) {
                     const obj = (0, parser_1.objectExpressionToObject)(args[0].expression, mergedStaticTable, mergedKeyframesTable, mergedViewTransitionTable, mergedCreateThemeHashTable, scannedTables.createThemeObjectTable, mergedCreateTable, mergedCreateStaticHashTable, scannedTables.createStaticObjectTable);
+                    (0, unresolvableValue_1.assertNoDroppedValues)(args[0].expression, obj, spreadValues([
+                        mergedStaticTable,
+                        mergedKeyframesTable,
+                        mergedViewTransitionTable,
+                        mergedCreateThemeHashTable,
+                        scannedTables.createThemeObjectTable,
+                        mergedCreateTable,
+                        mergedCreateStaticHashTable,
+                        scannedTables.createStaticObjectTable,
+                    ], localConstNodes, getSource));
                     const hash = (0, zss_engine_1.genBase36Hash)(obj, 1, 8);
                     scannedTables.viewTransitionObjectTable[hash] = obj;
                     replacements.push({
@@ -809,13 +901,23 @@ 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([
+                        mergedStaticTable,
+                        mergedKeyframesTable,
+                        mergedViewTransitionTable,
+                        mergedCreateThemeHashTable,
+                        scannedTables.createThemeObjectTable,
+                        mergedCreateTable,
+                        mergedCreateStaticHashTable,
+                        scannedTables.createStaticObjectTable,
+                    ], localConstNodes, getSource));
                     const hash = (0, createTheme_1.themeHashOf)(selector, obj);
                     scannedTables.createThemeObjectTable[hash] = obj;
                     if (scannedTables.createThemeSelectorTable) {
@@ -826,6 +928,16 @@ const transformSource = async (env) => {
                     args.length > 0 &&
                     parser_1.t.isObjectExpression(args[0].expression)) {
                     const obj = (0, parser_1.objectExpressionToObject)(args[0].expression, mergedStaticTable, mergedKeyframesTable, mergedViewTransitionTable, mergedCreateThemeHashTable, scannedTables.createThemeObjectTable, mergedCreateTable, mergedCreateStaticHashTable, scannedTables.createStaticObjectTable);
+                    (0, unresolvableValue_1.assertNoDroppedValues)(args[0].expression, obj, spreadValues([
+                        mergedStaticTable,
+                        mergedKeyframesTable,
+                        mergedViewTransitionTable,
+                        mergedCreateThemeHashTable,
+                        scannedTables.createThemeObjectTable,
+                        mergedCreateTable,
+                        mergedCreateStaticHashTable,
+                        scannedTables.createStaticObjectTable,
+                    ], localConstNodes, getSource));
                     const hash = (0, zss_engine_1.genBase36Hash)(obj, 1, 8);
                     scannedTables.createStaticObjectTable[hash] = obj;
                 }
@@ -901,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);
@@ -1041,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) => {
@@ -1061,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) &&
@@ -1280,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({
@@ -1409,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(' && ')}) && ` : '';
@@ -2169,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,
@@ -2239,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);
@@ -2252,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);
             }
         },
     });
@@ -2262,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);
         }
@@ -2272,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 ` +
@@ -2303,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

@@ -0,0 +1,15 @@
+import type { ObjectExpression, SpreadElement } from '@swc/core';
+type SourceObject = ObjectExpression;
+type StaticValues = Record<string, unknown>;
+type SpreadInfo = {
+    values: StaticValues;
+    source?: SourceObject;
+};
+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

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNoDroppedValues = void 0;
+const keyValue = (key) => {
+    if (!key || typeof key !== 'object' || !('value' in key))
+        return;
+    const value = key.value;
+    return typeof value === 'string' || typeof value === 'number'
+        ? value
+        : undefined;
+};
+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) => {
+    for (let i = index + 1; i < properties.length; i++) {
+        const later = properties[i];
+        if (later.type === 'SpreadElement') {
+            const provided = context?.spread(later);
+            if (!provided)
+                return true;
+            if (String(key) in provided.values)
+                return true;
+            continue;
+        }
+        if (later.type === 'KeyValueProperty' && keyValue(later.key) === key)
+            return true;
+    }
+    return false;
+};
+const RUNTIME_ONLY = new Set([
+    'CallExpression',
+    'NewExpression',
+    'AwaitExpression',
+    'TaggedTemplateExpression',
+    'YieldExpression',
+]);
+const readsAnyOf = (node, names) => {
+    if (!node || typeof node !== 'object')
+        return false;
+    const value = node;
+    if (value.type === 'Identifier' && typeof value.value === 'string')
+        return names.has(value.value);
+    for (const key of Object.keys(value)) {
+        if (key === 'span')
+            continue;
+        const child = value[key];
+        if (Array.isArray(child)) {
+            for (const item of child)
+                if (readsAnyOf(item, names))
+                    return true;
+        }
+        else if (readsAnyOf(child, names))
+            return true;
+    }
+    return false;
+};
+const parameterNames = (func) => {
+    const names = new Set();
+    const add = (pattern) => {
+        if (!pattern || typeof pattern !== 'object')
+            return;
+        if (pattern.type === 'Identifier' && typeof pattern.value === 'string')
+            names.add(pattern.value);
+        for (const key of ['pat', 'left', 'argument', 'value', 'key'])
+            if (pattern[key])
+                add(pattern[key]);
+        for (const key of ['properties', 'elements'])
+            if (Array.isArray(pattern[key]))
+                pattern[key].forEach(add);
+    };
+    (func.params ?? []).forEach((param) => add(param?.pat ?? param));
+    return names;
+};
+const assertStyleFunction = (func, context) => {
+    const params = parameterNames(func);
+    const body = func.body;
+    const returned = body?.type === 'ObjectExpression'
+        ? body
+        : body?.type === 'ParenthesisExpression' &&
+            body.expression?.type === 'ObjectExpression'
+            ? body.expression
+            : null;
+    if (!returned)
+        return;
+    const walk = (object) => {
+        const properties = object.properties ?? [];
+        for (let index = 0; index < properties.length; index++) {
+            const prop = properties[index];
+            if (prop.type !== 'KeyValueProperty')
+                continue;
+            const key = keyValue(prop.key);
+            if ((typeof key === 'string' || typeof key === 'number') &&
+                overwrittenLater(properties, index, key, context))
+                continue;
+            const value = prop.value;
+            if (!value)
+                continue;
+            if (value.type === 'ObjectExpression') {
+                walk(value);
+                continue;
+            }
+            if (RUNTIME_ONLY.has(value.type) && !readsAnyOf(value, params))
+                throw unresolvableValue(key ?? '', value, context);
+            if ((value.type === 'Identifier' || value.type === 'MemberExpression') &&
+                context &&
+                !readsAnyOf(value, params) &&
+                !context.resolvesValue(value))
+                throw unresolvableValue(key ?? '', value, context);
+        }
+    };
+    walk(returned);
+};
+const keysSuppliedAfter = (properties, index, context) => {
+    const keys = new Set();
+    for (let i = index + 1; i < properties.length; i++) {
+        const later = properties[i];
+        if (later.type === 'SpreadElement') {
+            const provided = context?.spread(later);
+            if (!provided)
+                return null;
+            for (const name of Object.keys(provided.values))
+                keys.add(name);
+            continue;
+        }
+        if (later.type !== 'KeyValueProperty')
+            continue;
+        const key = keyValue(later.key);
+        if (typeof key !== 'string' && typeof key !== 'number')
+            return null;
+        keys.add(String(key));
+    }
+    return keys;
+};
+const assertNoDroppedValues = (node, resolved, context, ignore) => {
+    if (!resolved)
+        return;
+    for (let index = 0; index < node.properties.length; index++) {
+        const prop = node.properties[index];
+        if (prop.type === 'SpreadElement') {
+            const provided = context?.spread(prop);
+            if (!provided?.source)
+                continue;
+            const replaced = keysSuppliedAfter(node.properties, index, context);
+            if (replaced)
+                (0, exports.assertNoDroppedValues)(provided.source, provided.values, context, replaced);
+            continue;
+        }
+        if (prop.type !== 'KeyValueProperty')
+            continue;
+        const key = keyValue(prop.key);
+        if (typeof key !== 'string' && typeof key !== 'number')
+            continue;
+        if (ignore?.has(String(key)))
+            continue;
+        if (overwrittenLater(node.properties, index, key, context))
+            continue;
+        const value = prop.value;
+        if (!value)
+            continue;
+        if (value.type === 'ArrowFunctionExpression' ||
+            value.type === 'FunctionExpression') {
+            assertStyleFunction(value, context);
+            continue;
+        }
+        if (value.type === 'NullLiteral')
+            continue;
+        if (!(key in resolved))
+            throw unresolvableValue(key, value, context);
+        if (value.type === 'ObjectExpression') {
+            const nested = resolved[key];
+            if (nested && typeof nested === 'object')
+                (0, exports.assertNoDroppedValues)(value, nested, context);
+        }
+    }
+};
+exports.assertNoDroppedValues = assertNoDroppedValues;

package/package.json

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