@plumeria/utils 19.2.15 → 19.2.16

package/dist/parser.js

@@ -102,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)) {
@@ -278,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;
                 }
@@ -684,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);
         }
     }
@@ -752,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;
@@ -826,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);
@@ -841,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);
@@ -861,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)) {
@@ -1686,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

@@ -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 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.2.16",
   "description": "Plumeria Utils",
   "author": "Refirst 11",
   "license": "MIT",