@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/lint-utils.js

@@ -0,0 +1,358 @@
+/**
+ * Shared utility functions and constants for component linter rules.
+ *
+ * All commonly-used patterns are consolidated here to avoid duplication
+ * across rule files. Rules should import from this module rather than
+ * reimplementing these helpers.
+ */
+import _traverse from '@babel/traverse';
+import * as t from '@babel/types';
+import * as parser from '@babel/parser';
+export const traverse = ((_traverse.default) ?? _traverse);
+// ═══════════════════════════════════════════════════════════════════════════
+// Violation Helpers
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Creates a violation object with consistent structure.
+ */
+export function createViolation(rule, severity, node, message, code, suggestion) {
+    return {
+        rule,
+        severity,
+        line: node?.loc?.start.line || 0,
+        column: node?.loc?.start.column || 0,
+        message,
+        code,
+        suggestion,
+    };
+}
+/**
+ * Truncates code to a maximum length for display in violations.
+ */
+export function truncateCode(code, maxLength = 100) {
+    if (code.length <= maxLength)
+        return code;
+    return code.substring(0, maxLength) + '...';
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// String Similarity
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Levenshtein distance between two strings (case-insensitive).
+ */
+export function levenshteinDistance(a, b) {
+    const al = a.toLowerCase();
+    const bl = b.toLowerCase();
+    const m = al.length;
+    const n = bl.length;
+    const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            const cost = al[i - 1] === bl[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[m][n];
+}
+/**
+ * Find the closest matching string from a list of candidates using Levenshtein distance.
+ * Returns null if no match is within the maximum allowed distance.
+ */
+export function findClosestMatch(target, candidates, maxDistance) {
+    let bestMatch = null;
+    let bestDistance = Infinity;
+    const max = maxDistance ?? Math.max(3, Math.floor(target.length * 0.5));
+    for (const candidate of candidates) {
+        const dist = levenshteinDistance(target, candidate);
+        if (dist < bestDistance && dist > 0 && dist <= max) {
+            bestDistance = dist;
+            bestMatch = candidate;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Find a case-insensitive match that differs only in casing.
+ */
+export function findCaseMismatch(target, candidates) {
+    for (const candidate of candidates) {
+        if (candidate.toLowerCase() === target.toLowerCase() && candidate !== target) {
+            return candidate;
+        }
+    }
+    return null;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// AST Type Checking Helpers
+// ═══════════════════════════════════════════════════════════════════════════
+/** Checks if a node is null or undefined literal */
+export function isNullOrUndefined(node) {
+    return t.isNullLiteral(node) || (t.isIdentifier(node) && node.name === 'undefined');
+}
+/** Checks if a node is likely a string value (literal, template, identifier, call, etc.) */
+export function isStringLike(node, depth = 0) {
+    if (depth > 3)
+        return false;
+    if (t.isConditionalExpression(node)) {
+        const consequentOk = isStringLike(node.consequent, depth + 1) || isNullOrUndefined(node.consequent);
+        const alternateOk = isStringLike(node.alternate, depth + 1) || isNullOrUndefined(node.alternate);
+        return consequentOk && alternateOk;
+    }
+    if (t.isObjectExpression(node) || t.isArrayExpression(node))
+        return false;
+    return (t.isStringLiteral(node) ||
+        t.isTemplateLiteral(node) ||
+        t.isBinaryExpression(node) ||
+        t.isIdentifier(node) ||
+        t.isCallExpression(node) ||
+        t.isMemberExpression(node));
+}
+/** Checks if a node is likely a number value */
+export function isNumberLike(node) {
+    return (t.isNumericLiteral(node) ||
+        t.isBinaryExpression(node) ||
+        t.isUnaryExpression(node) ||
+        t.isConditionalExpression(node) ||
+        t.isIdentifier(node) ||
+        t.isCallExpression(node) ||
+        t.isMemberExpression(node));
+}
+/** Checks if a node is likely an array value */
+export function isArrayLike(node) {
+    return (t.isArrayExpression(node) ||
+        t.isIdentifier(node) ||
+        t.isCallExpression(node) ||
+        t.isMemberExpression(node) ||
+        t.isConditionalExpression(node));
+}
+/** Checks if a node is likely an object value (not array) */
+export function isObjectLike(node) {
+    if (t.isArrayExpression(node))
+        return false;
+    return (t.isObjectExpression(node) ||
+        t.isIdentifier(node) ||
+        t.isCallExpression(node) ||
+        t.isMemberExpression(node) ||
+        t.isConditionalExpression(node) ||
+        t.isSpreadElement(node));
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Object Property Extraction
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Extract a string literal value from an ObjectExpression property by key name.
+ * Returns null if the property doesn't exist or its value isn't a string literal.
+ *
+ * @example
+ * ```typescript
+ * // For: { QueryName: 'My Query', MaxRows: 100 }
+ * getStringProperty(objectExpr, 'QueryName') // → 'My Query'
+ * getStringProperty(objectExpr, 'MaxRows')   // → null (not a string)
+ * ```
+ */
+export function getStringProperty(objectExpr, propName) {
+    for (const prop of objectExpr.properties) {
+        if (t.isObjectProperty(prop) && t.isIdentifier(prop.key) &&
+            prop.key.name === propName && t.isStringLiteral(prop.value)) {
+            return prop.value.value;
+        }
+    }
+    return null;
+}
+/**
+ * Get the AST node for a specific property value in an ObjectExpression.
+ * Returns the ObjectProperty if found, null otherwise.
+ */
+export function getObjectProperty(objectExpr, propName) {
+    for (const prop of objectExpr.properties) {
+        if (t.isObjectProperty(prop) && t.isIdentifier(prop.key) && prop.key.name === propName) {
+            return prop;
+        }
+    }
+    return null;
+}
+/**
+ * Get all property names from an ObjectExpression.
+ */
+export function getPropertyNames(objectExpr) {
+    return objectExpr.properties
+        .filter((prop) => t.isObjectProperty(prop) && t.isIdentifier(prop.key))
+        .map((prop) => prop.key.name);
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Utility Method Call Detection
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Check if a CallExpression callee matches the pattern `utilities.<service>.<method>`.
+ * Returns the service and method names if matched, null otherwise.
+ *
+ * @example
+ * ```typescript
+ * // For: utilities.rv.RunView(...)
+ * getUtilitiesCallInfo(callee) // → { service: 'rv', method: 'RunView' }
+ *
+ * // For: utilities.rq.RunQuery(...)
+ * getUtilitiesCallInfo(callee) // → { service: 'rq', method: 'RunQuery' }
+ *
+ * // For: utilities.search?.Search(...)
+ * getUtilitiesCallInfo(callee) // → { service: 'search', method: 'Search' }
+ * ```
+ */
+export function getUtilitiesCallInfo(callee) {
+    // Standard: utilities.rv.RunView(...)
+    if (t.isMemberExpression(callee) &&
+        t.isMemberExpression(callee.object) &&
+        t.isIdentifier(callee.object.object) &&
+        callee.object.object.name === 'utilities' &&
+        t.isIdentifier(callee.object.property) &&
+        t.isIdentifier(callee.property)) {
+        return { service: callee.object.property.name, method: callee.property.name };
+    }
+    // Optional chaining: utilities.search?.Search(...)
+    if (t.isMemberExpression(callee) &&
+        t.isOptionalMemberExpression(callee.object) &&
+        t.isIdentifier(callee.object.object) &&
+        callee.object.object.name === 'utilities' &&
+        t.isIdentifier(callee.object.property) &&
+        t.isIdentifier(callee.property)) {
+        return {
+            service: callee.object.property.name,
+            method: callee.property.name,
+        };
+    }
+    return null;
+}
+/** Check if a CallExpression callee is `utilities.rv.RunView` or `utilities.rv.RunViews` */
+export function isRunViewCall(callee) {
+    const info = getUtilitiesCallInfo(callee);
+    return info !== null && info.service === 'rv' && (info.method === 'RunView' || info.method === 'RunViews');
+}
+/** Check if a CallExpression callee is `utilities.rq.RunQuery` */
+export function isRunQueryCall(callee) {
+    const info = getUtilitiesCallInfo(callee);
+    return info !== null && info.service === 'rq' && info.method === 'RunQuery';
+}
+/** Check if a CallExpression callee is `utilities.search.Search` or `PreviewSearch` */
+export function isSearchCall(callee) {
+    const info = getUtilitiesCallInfo(callee);
+    return info !== null && info.service === 'search' && (info.method === 'Search' || info.method === 'PreviewSearch');
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Child Component Code Analysis
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Parse component code and extract QueryName values from RunQuery calls.
+ * Uses full AST analysis to avoid false positives from comments or string literals.
+ */
+export function extractRunQueryNamesFromCode(code) {
+    const queryNames = new Set();
+    try {
+        const ast = parser.parse(code, {
+            sourceType: 'module',
+            plugins: ['jsx', 'typescript'],
+            errorRecovery: true,
+        });
+        traverse(ast, {
+            CallExpression(path) {
+                if (isRunQueryCall(path.node.callee)) {
+                    const arg = path.node.arguments[0];
+                    if (t.isObjectExpression(arg)) {
+                        const queryName = getStringProperty(arg, 'QueryName');
+                        if (queryName)
+                            queryNames.add(queryName);
+                    }
+                }
+            },
+        });
+    }
+    catch {
+        // If parsing fails, return empty set
+    }
+    return queryNames;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Shared Constants
+// ═══════════════════════════════════════════════════════════════════════════
+/** Standard array iteration method names */
+export const ARRAY_METHODS = new Set([
+    'map', 'filter', 'forEach', 'reduce', 'find', 'some', 'every',
+    'sort', 'concat', 'flatMap', 'flat', 'slice', 'reverse',
+]);
+/** Functions that expect array arguments */
+export const ARRAY_EXPECTING_FUNCS = new Set([
+    'map', 'filter', 'forEach', 'reduce', 'sort', 'concat',
+    'processChartData', 'processData', 'transformData',
+    'setData', 'setItems', 'setResults', 'setRows',
+]);
+/** Functions that coerce values to numbers */
+export const NUMERIC_COERCION_FUNCTIONS = new Set(['parseInt', 'parseFloat', 'Number']);
+/**
+ * Common DOM/React/JS properties that should never be validated as entity fields.
+ * Used to prevent false positives when scope resolution picks up a variable name
+ * collision (e.g., `e` used as both a .map() callback param and an onChange event param).
+ */
+export const NON_ENTITY_PROPERTIES = new Set([
+    // DOM event properties
+    'target', 'currentTarget', 'preventDefault', 'stopPropagation', 'nativeEvent',
+    'type', 'bubbles', 'cancelable', 'defaultPrevented', 'eventPhase', 'isTrusted',
+    // DOM element properties
+    'value', 'checked', 'selectedIndex', 'innerHTML', 'textContent', 'className',
+    'style', 'classList', 'dataset', 'children', 'parentNode', 'parentElement',
+    'offsetWidth', 'offsetHeight', 'scrollTop', 'scrollLeft', 'clientWidth', 'clientHeight',
+    // React/JS common
+    'current', 'then', 'catch', 'finally', 'prototype', 'constructor', 'length',
+    'map', 'filter', 'reduce', 'forEach', 'find', 'some', 'every', 'includes',
+    'push', 'pop', 'shift', 'unshift', 'splice', 'slice', 'concat', 'join',
+    'keys', 'values', 'entries', 'toString', 'valueOf', 'hasOwnProperty',
+]);
+// ═══════════════════════════════════════════════════════════════════════════
+// JSX Helpers
+// ═══════════════════════════════════════════════════════════════════════════
+/** Extracts the name of a JSX element (handles member expressions like Antd.Button) */
+export function getJSXElementName(node) {
+    if (t.isJSXIdentifier(node.name)) {
+        return node.name.name;
+    }
+    else if (t.isJSXMemberExpression(node.name)) {
+        const parts = [];
+        let current = node.name;
+        while (t.isJSXMemberExpression(current)) {
+            if (t.isJSXIdentifier(current.property))
+                parts.unshift(current.property.name);
+            current = current.object;
+        }
+        if (t.isJSXIdentifier(current))
+            parts.unshift(current.name);
+        return parts.join('.');
+    }
+    return null;
+}
+/** Checks if a JSX element has a specific attribute */
+export function hasJSXAttribute(element, attributeName) {
+    return element.attributes.some((attr) => t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === attributeName);
+}
+/** Gets a JSX attribute by name */
+export function getJSXAttribute(element, attributeName) {
+    const attr = element.attributes.find((a) => t.isJSXAttribute(a) && t.isJSXIdentifier(a.name) && a.name.name === attributeName);
+    return t.isJSXAttribute(attr) ? attr : null;
+}
+/** Checks if a function parameter is destructuring props */
+export function isPropsDestructuring(param) {
+    return t.isObjectPattern(param);
+}
+/** Extracts property names from an object pattern (destructuring) */
+export function extractDestructuredProps(pattern) {
+    return pattern.properties
+        .filter((prop) => t.isObjectProperty(prop))
+        .filter((prop) => t.isIdentifier(prop.key))
+        .map((prop) => prop.key.name);
+}
+/** Checks if a node is at the top level of the program */
+export function isTopLevel(path) {
+    return path.getFunctionParent() === null || path.scope.path.type === 'Program';
+}
+//# sourceMappingURL=lint-utils.js.map

package/dist/lint-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-utils.js","sourceRoot":"","sources":["../src/lint-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,SAAuB,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAkBxC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAE,SAA4B,CAAC,OAAO,CAAC,IAAI,SAAS,CAAqB,CAAC;AAKnG,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,QAAgD,EAChD,IAA+B,EAC/B,OAAe,EACf,IAAa,EACb,UAA+C;IAE/C,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;QAChC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;QACpC,OAAO;QACP,IAAI;QACJ,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,YAAoB,GAAG;IAChE,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAS,EAAE,CAAS;IACtD,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IACpB,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IACpB,MAAM,EAAE,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,UAAkC,EAAE,WAAoB;IACvG,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,YAAY,GAAG,QAAQ,CAAC;IAC5B,MAAM,GAAG,GAAG,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;IAExE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,IAAI,GAAG,YAAY,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;YACnD,YAAY,GAAG,IAAI,CAAC;YACpB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,UAAkC;IACjF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YAC7E,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,oDAAoD;AACpD,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;AACtF,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB,CAAC;IAC1D,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpG,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjG,OAAO,YAAY,IAAI,WAAW,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,OAAO,CACL,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC;QACvB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACzB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAC1B,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;QACpB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACxB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,CACL,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACxB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAC1B,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACzB,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC/B,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;QACpB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACxB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CACL,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACzB,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;QACpB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACxB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAC1B,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,CACL,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAC1B,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;QACpB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACxB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAC1B,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC;QAC/B,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CACxB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAE,QAAgB;IAChF,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QACzC,IAAI,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAE,QAAgB;IAChF,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QACzC,IAAI,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA8B;IAC7D,OAAO,UAAU,CAAC,UAAU;SACzB,MAAM,CAAC,CAAC,IAAI,EAA4B,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAChG,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAE,IAAI,CAAC,GAAoB,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,sCAAsC;IACtC,IAAI,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC;QAC5B,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC;QACnC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW;QACzC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChF,CAAC;IAED,mDAAmD;IACnD,IAAI,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC;QAC5B,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3C,CAAC,CAAC,YAAY,CAAE,MAAM,CAAC,MAAqC,CAAC,MAAM,CAAC;QAClE,MAAM,CAAC,MAAqC,CAAC,MAAuB,CAAC,IAAI,KAAK,WAAW;QAC3F,CAAC,CAAC,YAAY,CAAE,MAAM,CAAC,MAAqC,CAAC,QAAQ,CAAC;QACtE,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,OAAO,EAAI,MAAM,CAAC,MAAqC,CAAC,QAAyB,CAAC,IAAI;YACtF,MAAM,EAAG,MAAM,CAAC,QAAyB,CAAC,IAAI;SAC/C,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;AAC7G,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC;AAC9E,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,eAAe,CAAC,CAAC;AACrH,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;YAC7B,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;YAC9B,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QACH,QAAQ,CAAC,GAAG,EAAE;YACZ,cAAc,CAAC,IAAgC;gBAC7C,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;oBACnC,IAAI,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC9B,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;wBACtD,IAAI,SAAS;4BAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC3C,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IACnC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IAC7D,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS;CACxD,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IAC3C,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ;IACtD,kBAAkB,EAAE,aAAa,EAAE,eAAe;IAClD,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS;CAC/C,CAAC,CAAC;AAEH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AAExF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IAC3C,uBAAuB;IACvB,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa;IAC7E,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW;IAC9E,yBAAyB;IACzB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW;IAC5E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe;IAC1E,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc;IACvF,kBAAkB;IAClB,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ;IAC3E,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU;IACzE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM;IACtE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB;CACrE,CAAC,CAAC;AAEH,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,IAAyB;IACzD,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;SAAM,IAAI,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,OAAO,GAA4C,IAAI,CAAC,IAAI,CAAC;QACjE,OAAO,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC9E,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5D,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,eAAe,CAAC,OAA4B,EAAE,aAAqB;IACjF,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CACrG,CAAC;AACJ,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,eAAe,CAAC,OAA4B,EAAE,aAAqB;IACjF,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CACzF,CAAC;IACF,OAAO,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,wBAAwB,CAAC,OAAwB;IAC/D,OAAO,OAAO,CAAC,UAAU;SACtB,MAAM,CAAC,CAAC,IAAI,EAA4B,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;SACpE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAE,IAAI,CAAC,GAAoB,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,IAA6E;IACtG,OAAO,IAAI,CAAC,iBAAiB,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;AACjF,CAAC"}

package/dist/linter-options.d.ts

@@ -0,0 +1,51 @@
+import type { UserInfo } from '@memberjunction/core';
+import type { ComponentSpec, ComponentUtilities, SimpleEntityInfo } from '@memberjunction/interactive-component-types';
+/**
+ * Options accepted by the linter and individual lint rules at runtime.
+ *
+ * This is a strict subset of the fields the linter actually reads — the
+ * companion `@memberjunction/react-test-harness` package extends this
+ * interface with browser-execution-specific fields (Playwright timeouts,
+ * onPageReady callbacks, etc.) that are irrelevant to static analysis.
+ *
+ * Keeping the linter's surface narrow avoids dragging Playwright-shaped
+ * options into server-side action callers that only want static checks.
+ */
+export interface LinterOptions {
+    /** Component spec being analyzed (linter walks `code`, `dataRequirements`, etc.). */
+    componentSpec?: ComponentSpec;
+    /** Auth/context — required by rules that resolve entity metadata. */
+    contextUser?: UserInfo;
+    /**
+     * Optional array of entity metadata providing complete field lists per entity.
+     * Used by the linter to validate field usage with two-tier severity:
+     * - Medium: Field exists in entity but not declared in dataRequirements
+     * - Critical: Field does not exist in entity at all
+     *
+     * If not provided, linter only checks against dataRequirements.fieldMetadata
+     * which may cause false-positive critical errors for valid but undeclared fields.
+     */
+    entityMetadata?: SimpleEntityInfo[];
+    /**
+     * Runtime utility hub forwarded to rules that need live metadata access
+     * (e.g. utilities.md.Entities). Optional — rules guard against absence.
+     */
+    utilities?: ComponentUtilities;
+    /**
+     * Optional resolver for dependency components referenced by name (+ optional
+     * namespace + registry). Lint rules call this when a dep is `location:
+     * 'registry'` and the parent spec didn't denormalize the dep's props/events
+     * inline — most commonly to verify props passed to a child component match
+     * the child's declared property contract.
+     *
+     * The linter never does I/O itself; it asks this resolver. Callers wire it
+     * however suits their side of the wire:
+     *   - server-side: close over `ComponentMetadataEngineServer.Instance.FindComponent(...)?.spec`
+     *   - client-side: close over a pre-loaded array or a GQL cache
+     *
+     * If absent, rules that rely on registry lookup degrade gracefully
+     * (they simply skip the cross-component check).
+     */
+    componentResolver?: (name: string, namespace?: string, registry?: string) => ComponentSpec | undefined;
+}
+//# sourceMappingURL=linter-options.d.ts.map

package/dist/linter-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter-options.d.ts","sourceRoot":"","sources":["../src/linter-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,6CAA6C,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,qEAAqE;IACrE,WAAW,CAAC,EAAE,QAAQ,CAAC;IAEvB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEpC;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAE/B;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,EAAE,CAClB,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,KACd,aAAa,GAAG,SAAS,CAAC;CAChC"}

package/dist/linter-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=linter-options.js.map

package/dist/linter-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter-options.js","sourceRoot":"","sources":["../src/linter-options.ts"],"names":[],"mappings":""}

package/dist/prop-value-extractor.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Prop Value Extractor Utility
+ *
+ * Extracts static values from JSX attribute AST nodes for validation purposes.
+ * This utility is foundational for semantic validation - it converts AST nodes
+ * into analyzable values that semantic validators can work with.
+ *
+ * Supported Extractions:
+ * - Literal values: strings, numbers, booleans, null
+ * - Arrays of literals
+ * - Object literals (nested)
+ * - Identifies dynamic values (identifiers/expressions) that can't be extracted
+ *
+ * Usage:
+ * ```typescript
+ * const value = PropValueExtractor.extract(jsxAttribute);
+ * if (value._type === 'identifier') {
+ *   // Can't validate statically - skip with warning
+ * } else {
+ *   // Can validate - proceed with constraint checking
+ * }
+ * ```
+ */
+import * as t from '@babel/types';
+/**
+ * Represents a value that couldn't be extracted statically
+ */
+export interface DynamicValue {
+    _type: 'identifier' | 'expression';
+    name?: string;
+    description?: string;
+}
+/**
+ * Union type for extracted values
+ */
+export type ExtractedValue = string | number | boolean | null | undefined | ExtractedValue[] | {
+    [key: string]: ExtractedValue;
+} | DynamicValue;
+/**
+ * Utility class for extracting static values from JSX attribute AST nodes
+ */
+export declare class PropValueExtractor {
+    /**
+     * Extract a value from a JSX attribute
+     *
+     * @param attr - The JSX attribute node
+     * @returns The extracted value, or a DynamicValue object if it can't be extracted statically
+     *
+     * @example
+     * ```typescript
+     * // Boolean shorthand: <Component show />
+     * PropValueExtractor.extract(attr) // => true
+     *
+     * // String literal: <Component name="test" />
+     * PropValueExtractor.extract(attr) // => "test"
+     *
+     * // Expression: <Component count={42} />
+     * PropValueExtractor.extract(attr) // => 42
+     *
+     * // Array: <Component items={['a', 'b']} />
+     * PropValueExtractor.extract(attr) // => ['a', 'b']
+     *
+     * // Dynamic: <Component name={userName} />
+     * PropValueExtractor.extract(attr) // => { _type: 'identifier', name: 'userName' }
+     * ```
+     */
+    static extract(attr: t.JSXAttribute): ExtractedValue;
+    /**
+     * Extract a value from an expression node
+     *
+     * @param expr - The expression node
+     * @returns The extracted value
+     */
+    private static extractExpression;
+    /**
+     * Extract template literal if it's static
+     *
+     * @param node - Template literal node
+     * @returns Concatenated string if all expressions are literals, otherwise DynamicValue
+     */
+    private static extractTemplateLiteral;
+    /**
+     * Extract array expression
+     *
+     * @param node - Array expression node
+     * @returns Array of extracted values
+     */
+    private static extractArray;
+    /**
+     * Extract object literal
+     *
+     * @param node - Object expression node
+     * @returns Object with extracted property values
+     */
+    private static extractObjectLiteral;
+    /**
+     * Get property key as string
+     *
+     * @param key - Property key node
+     * @param computed - Whether the property is computed
+     * @returns String key or null if can't be extracted
+     */
+    private static getPropertyKey;
+    /**
+     * Extract unary expression if operand is static
+     *
+     * @param node - Unary expression node
+     * @returns Computed value or DynamicValue
+     */
+    private static extractUnaryExpression;
+    /**
+     * Extract binary expression if both operands are static
+     *
+     * @param node - Binary expression node
+     * @returns Computed value or DynamicValue
+     */
+    private static extractBinaryExpression;
+    /**
+     * Extract conditional expression (ternary) if all parts are static
+     *
+     * @param node - Conditional expression node
+     * @returns Value of the taken branch or DynamicValue
+     */
+    private static extractConditionalExpression;
+    /**
+     * Check if a value is a DynamicValue (can't be validated statically)
+     *
+     * @param value - The extracted value
+     * @returns True if the value is dynamic
+     */
+    static isDynamicValue(value: ExtractedValue): value is DynamicValue;
+    /**
+     * Check if an array contains any dynamic values
+     *
+     * @param arr - The array to check
+     * @returns True if any element is dynamic
+     */
+    static hasAnyDynamicValue(arr: ExtractedValue[]): boolean;
+    /**
+     * Get a human-readable description of the value
+     *
+     * @param value - The extracted value
+     * @returns Description string
+     */
+    static describe(value: ExtractedValue): string;
+}
+//# sourceMappingURL=prop-value-extractor.d.ts.map

package/dist/prop-value-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prop-value-extractor.d.ts","sourceRoot":"","sources":["../src/prop-value-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,GAAG,YAAY,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,cAAc,EAAE,GAChB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;CAAE,GACjC,YAAY,CAAC;AAEjB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,YAAY,GAAG,cAAc;IAkCpD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA4EhC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAkCrC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAyB3B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAsCnC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA2B7B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA6BrC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA6EtC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAkB3C;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,IAAI,YAAY;IASnE;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,OAAO;IAWzD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;CA0B/C"}