zyzz 0.0.18 → 0.0.19

package/dist/oxlint/rules/restrictedProperties.js

@@ -0,0 +1,82 @@
+import * as Bindings from '../internal/Bindings.js';
+import * as Declarations from '../internal/Declarations.js';
+/** Reports forbidden properties or literal values outside an explicit allowlist. */
+export const restrictedProperties = {
+    meta: {
+        messages: {
+            restricted: "Property '{{property}}' is restricted. {{reason}}",
+        },
+        schema: [
+            {
+                additionalProperties: {
+                    additionalProperties: false,
+                    properties: {
+                        reason: { type: 'string' },
+                        values: { items: { type: ['string', 'number'] }, type: 'array' },
+                    },
+                    type: 'object',
+                },
+                type: 'object',
+            },
+        ],
+        type: 'suggestion',
+    },
+    create(context) {
+        const bindings = Bindings.create(context);
+        const restrictions = context.options[0];
+        const reported = new Set();
+        return {
+            CallExpression(node) {
+                if (!restrictions ||
+                    typeof restrictions !== 'object' ||
+                    Array.isArray(restrictions))
+                    return;
+                const binding = bindings.resolve(node.callee);
+                if (binding?.kind !== 'style' && binding?.kind !== 'variants')
+                    return;
+                const input = node.arguments[0];
+                if (!input || input.type === 'SpreadElement')
+                    return;
+                Declarations.visit(input, {
+                    bindings,
+                    recipe: binding.kind === 'variants',
+                    visitors: {
+                        declaration(property, name) {
+                            if (!Object.hasOwn(restrictions, name) ||
+                                reported.has(property.start))
+                                return;
+                            const restriction = restrictions[name];
+                            if (!restriction ||
+                                typeof restriction !== 'object' ||
+                                Array.isArray(restriction))
+                                return;
+                            const allowed = restriction.values;
+                            if (Array.isArray(allowed)) {
+                                const literal = Declarations.literal(property.value, bindings);
+                                if (!literal)
+                                    return;
+                                const values = Array.isArray(literal.value)
+                                    ? literal.value
+                                    : [literal.value];
+                                if (values.every((value) => allowed.some((allowed) => allowed === value)))
+                                    return;
+                            }
+                            reported.add(property.start);
+                            context.report({
+                                data: {
+                                    property: name,
+                                    reason: typeof restriction.reason === 'string'
+                                        ? restriction.reason
+                                        : 'Use an approved property or value.',
+                                },
+                                messageId: 'restricted',
+                                node: property.key,
+                            });
+                        },
+                    },
+                });
+            },
+        };
+    },
+};
+//# sourceMappingURL=restrictedProperties.js.map

package/dist/oxlint/rules/restrictedProperties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restrictedProperties.js","sourceRoot":"","sources":["../../../src/oxlint/rules/restrictedProperties.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAA;AACnD,OAAO,KAAK,YAAY,MAAM,6BAA6B,CAAA;AAE3D,oFAAoF;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAS;IACxC,IAAI,EAAE;QACJ,QAAQ,EAAE;YACR,UAAU,EAAE,mDAAmD;SAChE;QACD,MAAM,EAAE;YACN;gBACE,oBAAoB,EAAE;oBACpB,oBAAoB,EAAE,KAAK;oBAC3B,UAAU,EAAE;wBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAC1B,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;qBACjE;oBACD,IAAI,EAAE,QAAQ;iBACf;gBACD,IAAI,EAAE,QAAQ;aACf;SACF;QACD,IAAI,EAAE,YAAY;KACnB;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;QAClC,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,IACE,CAAC,YAAY;oBACb,OAAO,YAAY,KAAK,QAAQ;oBAChC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;oBAE3B,OAAM;gBACR,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBAC7C,IAAI,OAAO,EAAE,IAAI,KAAK,OAAO,IAAI,OAAO,EAAE,IAAI,KAAK,UAAU;oBAAE,OAAM;gBACrE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;gBAC/B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;oBAAE,OAAM;gBACpD,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE;oBACxB,QAAQ;oBACR,MAAM,EAAE,OAAO,CAAC,IAAI,KAAK,UAAU;oBACnC,QAAQ,EAAE;wBACR,WAAW,CAAC,QAAQ,EAAE,IAAI;4BACxB,IACE,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC;gCAClC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;gCAE5B,OAAM;4BACR,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;4BACtC,IACE,CAAC,WAAW;gCACZ,OAAO,WAAW,KAAK,QAAQ;gCAC/B,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gCAE1B,OAAM;4BACR,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAA;4BAClC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gCAC3B,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;gCAC9D,IAAI,CAAC,OAAO;oCAAE,OAAM;gCACpB,MAAM,MAAM,GAAc,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;oCACpD,CAAC,CAAC,OAAO,CAAC,KAAK;oCACf,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gCACnB,IACE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CACrB,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC,CAC7C;oCAED,OAAM;4BACV,CAAC;4BACD,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;4BAC5B,OAAO,CAAC,MAAM,CAAC;gCACb,IAAI,EAAE;oCACJ,QAAQ,EAAE,IAAI;oCACd,MAAM,EACJ,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ;wCACpC,CAAC,CAAC,WAAW,CAAC,MAAM;wCACpB,CAAC,CAAC,oCAAoC;iCAC3C;gCACD,SAAS,EAAE,YAAY;gCACvB,IAAI,EAAE,QAAQ,CAAC,GAAG;6BACnB,CAAC,CAAA;wBACJ,CAAC;qBACF;iBACF,CAAC,CAAA;YACJ,CAAC;SACF,CAAA;IACH,CAAC;CACF,CAAA"}

package/dist/oxlint/rules/useLogicalProperties.d.ts

@@ -0,0 +1,5 @@
+/** Encourages logical CSS properties in web style declarations. @module */
+import type { Rule } from '@oxlint/plugins';
+/** Reports physical properties without changing direction-dependent behavior. */
+export declare const useLogicalProperties: Rule;
+//# sourceMappingURL=useLogicalProperties.d.ts.map

package/dist/oxlint/rules/useLogicalProperties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogicalProperties.d.ts","sourceRoot":"","sources":["../../../src/oxlint/rules/useLogicalProperties.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AA+B3C,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,EAAE,IA+ClC,CAAA"}

package/dist/oxlint/rules/useLogicalProperties.js

@@ -0,0 +1,76 @@
+import * as Bindings from '../internal/Bindings.js';
+import * as Declarations from '../internal/Declarations.js';
+const replacements = {
+    borderBottomLeftRadius: 'borderEndStartRadius',
+    borderBottomRightRadius: 'borderEndEndRadius',
+    borderLeft: 'borderInlineStart',
+    borderLeftColor: 'borderInlineStartColor',
+    borderLeftStyle: 'borderInlineStartStyle',
+    borderLeftWidth: 'borderInlineStartWidth',
+    borderRight: 'borderInlineEnd',
+    borderRightColor: 'borderInlineEndColor',
+    borderRightStyle: 'borderInlineEndStyle',
+    borderRightWidth: 'borderInlineEndWidth',
+    borderTopLeftRadius: 'borderStartStartRadius',
+    borderTopRightRadius: 'borderStartEndRadius',
+    insetLeft: 'insetInlineStart',
+    insetRight: 'insetInlineEnd',
+    left: 'insetInlineStart',
+    marginLeft: 'marginInlineStart',
+    marginRight: 'marginInlineEnd',
+    paddingLeft: 'paddingInlineStart',
+    paddingRight: 'paddingInlineEnd',
+    right: 'insetInlineEnd',
+    scrollMarginLeft: 'scrollMarginInlineStart',
+    scrollMarginRight: 'scrollMarginInlineEnd',
+    scrollPaddingLeft: 'scrollPaddingInlineStart',
+    scrollPaddingRight: 'scrollPaddingInlineEnd',
+};
+/** Reports physical properties without changing direction-dependent behavior. */
+export const useLogicalProperties = {
+    meta: {
+        messages: {
+            logical: "Use a CSS logical property instead of '{{property}}', such as '{{replacement}}' for horizontal LTR layouts.",
+        },
+        schema: [],
+        type: 'suggestion',
+    },
+    create(context) {
+        const bindings = Bindings.create(context);
+        const reported = new Set();
+        return {
+            CallExpression(node) {
+                const binding = bindings.resolve(node.callee);
+                if (binding?.kind !== 'style' && binding?.kind !== 'variants')
+                    return;
+                const input = node.arguments[0];
+                if (!input || input.type === 'SpreadElement')
+                    return;
+                Declarations.visit(input, {
+                    bindings,
+                    recipe: binding.kind === 'variants',
+                    visitors: {
+                        declaration(property, name) {
+                            const replacement = Object.hasOwn(replacements, name)
+                                ? replacements[name]
+                                : undefined;
+                            if (!replacement || reported.has(property.start))
+                                return;
+                            if (context.sourceCode
+                                .getCommentsBefore(property)
+                                .some((comment) => comment.value.includes('allow-physical-property')))
+                                return;
+                            reported.add(property.start);
+                            context.report({
+                                data: { property: name, replacement },
+                                messageId: 'logical',
+                                node: property.key,
+                            });
+                        },
+                    },
+                });
+            },
+        };
+    },
+};
+//# sourceMappingURL=useLogicalProperties.js.map

package/dist/oxlint/rules/useLogicalProperties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogicalProperties.js","sourceRoot":"","sources":["../../../src/oxlint/rules/useLogicalProperties.ts"],"names":[],"mappings":"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"}

package/dist/oxlint/rules/validStyles.d.ts

@@ -0,0 +1,5 @@
+/** Reports statically known declaration errors using Zyzz's authoring validation. @module */
+import type { Rule } from '@oxlint/plugins';
+/** Validates known structure and values while leaving unresolved bindings to the compiler. */
+export declare const validStyles: Rule;
+//# sourceMappingURL=validStyles.d.ts.map

package/dist/oxlint/rules/validStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validStyles.d.ts","sourceRoot":"","sources":["../../../src/oxlint/rules/validStyles.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,KAAK,EAAU,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAMnD,8FAA8F;AAC9F,eAAO,MAAM,WAAW,EAAE,IA+EzB,CAAA"}

package/dist/oxlint/rules/validStyles.js

@@ -0,0 +1,75 @@
+import * as Bindings from '../internal/Bindings.js';
+import * as Declarations from '../internal/Declarations.js';
+import * as Literal from '../../internal/Literal.js';
+import * as Style from '../../Style.js';
+/** Validates known structure and values while leaving unresolved bindings to the compiler. */
+export const validStyles = {
+    meta: { messages: { invalid: '{{message}}' }, schema: [], type: 'problem' },
+    create(context) {
+        const bindings = Bindings.create(context);
+        const reported = new Set();
+        function report(node, message) {
+            if (reported.has(node.start))
+                return;
+            reported.add(node.start);
+            context.report({ data: { message }, messageId: 'invalid', node });
+        }
+        return {
+            CallExpression(node) {
+                const binding = bindings.resolve(node.callee);
+                if (binding?.kind !== 'style' && binding?.kind !== 'variants')
+                    return;
+                const input = node.arguments[0];
+                if (!input || input.type === 'SpreadElement')
+                    return;
+                Declarations.visit(input, {
+                    bindings,
+                    recipe: binding.kind === 'variants',
+                    visitors: {
+                        declaration(property, name) {
+                            if (binding.themed && name === 'typography')
+                                return;
+                            if (!binding.themed &&
+                                !name.startsWith('--') &&
+                                !Object.hasOwn(Literal.rules, name)) {
+                                report(property.key, `Unknown CSS property '${name}'.`);
+                                return;
+                            }
+                            const value = bindings.expression(property.value);
+                            if (value.type === 'ObjectExpression') {
+                                report(value, 'CSS declarations require scalar values or fallback arrays.');
+                                return;
+                            }
+                            if (value.type === 'ArrayExpression' &&
+                                value.elements.some((element) => !element)) {
+                                report(value, 'Fallback arrays require dense data entries without holes.');
+                                return;
+                            }
+                            const literal = Declarations.literal(value, bindings);
+                            if (!literal)
+                                return;
+                            const values = Array.isArray(literal.value)
+                                ? literal.value
+                                : [literal.value];
+                            if (values.some((value) => typeof value !== 'string' && typeof value !== 'number')) {
+                                report(value, 'CSS declarations require string or number values.');
+                                return;
+                            }
+                            try {
+                                Style.define({ lint: { [name]: literal.value } });
+                            }
+                            catch (error) {
+                                if (!(error instanceof Style.InvalidError))
+                                    throw error;
+                                for (const diagnostic of error.diagnostics)
+                                    report(value, diagnostic.message);
+                            }
+                        },
+                        invalid: report,
+                    },
+                });
+            },
+        };
+    },
+};
+//# sourceMappingURL=validStyles.js.map

package/dist/oxlint/rules/validStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validStyles.js","sourceRoot":"","sources":["../../../src/oxlint/rules/validStyles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAA;AACnD,OAAO,KAAK,YAAY,MAAM,6BAA6B,CAAA;AAC3D,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAA;AACpD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAEvC,8FAA8F;AAC9F,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3E,MAAM,CAAC,OAAO;QACZ,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;QAClC,SAAS,MAAM,CAAC,IAAiB,EAAE,OAAe;YAChD,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAM;YACpC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACxB,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACnE,CAAC;QACD,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBAC7C,IAAI,OAAO,EAAE,IAAI,KAAK,OAAO,IAAI,OAAO,EAAE,IAAI,KAAK,UAAU;oBAAE,OAAM;gBACrE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;gBAC/B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;oBAAE,OAAM;gBACpD,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE;oBACxB,QAAQ;oBACR,MAAM,EAAE,OAAO,CAAC,IAAI,KAAK,UAAU;oBACnC,QAAQ,EAAE;wBACR,WAAW,CAAC,QAAQ,EAAE,IAAI;4BACxB,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,KAAK,YAAY;gCAAE,OAAM;4BACnD,IACE,CAAC,OAAO,CAAC,MAAM;gCACf,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gCACtB,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,EACnC,CAAC;gCACD,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,yBAAyB,IAAI,IAAI,CAAC,CAAA;gCACvD,OAAM;4BACR,CAAC;4BACD,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;4BACjD,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gCACtC,MAAM,CACJ,KAAK,EACL,4DAA4D,CAC7D,CAAA;gCACD,OAAM;4BACR,CAAC;4BACD,IACE,KAAK,CAAC,IAAI,KAAK,iBAAiB;gCAChC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAC1C,CAAC;gCACD,MAAM,CACJ,KAAK,EACL,2DAA2D,CAC5D,CAAA;gCACD,OAAM;4BACR,CAAC;4BACD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;4BACrD,IAAI,CAAC,OAAO;gCAAE,OAAM;4BACpB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;gCACzC,CAAC,CAAC,OAAO,CAAC,KAAK;gCACf,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;4BACnB,IACE,MAAM,CAAC,IAAI,CACT,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CACzD,EACD,CAAC;gCACD,MAAM,CACJ,KAAK,EACL,mDAAmD,CACpD,CAAA;gCACD,OAAM;4BACR,CAAC;4BACD,IAAI,CAAC;gCACH,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,EAAW,CAAC,CAAA;4BAC5D,CAAC;4BAAC,OAAO,KAAK,EAAE,CAAC;gCACf,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,YAAY,CAAC;oCAAE,MAAM,KAAK,CAAA;gCACvD,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW;oCACxC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;4BACrC,CAAC;wBACH,CAAC;wBACD,OAAO,EAAE,MAAM;qBAChB;iBACF,CAAC,CAAA;YACJ,CAAC;SACF,CAAA;IACH,CAAC;CACF,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zyzz",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "license": "MIT",
   "description": "Modern, universal, simple styling library for the Web and React Native",
   "repository": {
@@ -78,6 +78,11 @@
       "types": "./dist/node/index.d.ts",
       "default": "./dist/node/index.js"
     },
+    "./oxlint": {
+      "src": "./src/oxlint/index.ts",
+      "types": "./dist/oxlint/index.d.ts",
+      "default": "./dist/oxlint/index.js"
+    },
     "./react-native": {
       "src": "./src/react-native/index.ts",
       "types": "./dist/react-native/index.d.ts",
@@ -127,6 +132,7 @@
     "@jridgewell/gen-mapping": "^0.3.13",
     "@jridgewell/trace-mapping": "^0.3.31",
     "@oxc-project/types": "0.148.0",
+    "@oxlint/plugins": "1.68.0",
     "css-tree": "3.2.1",
     "incur": "^0.5.1",
     "lightningcss": "^1.33.0",

package/src/oxlint/index.ts

@@ -0,0 +1,21 @@
+/** Exposes opt-in Oxlint rules for Zyzz web authoring. @module */
+import type { Plugin } from '@oxlint/plugins'
+import { noConflictingProps } from './rules/noConflictingProps.js'
+import { noUnused } from './rules/noUnused.js'
+import { restrictedProperties } from './rules/restrictedProperties.js'
+import { useLogicalProperties } from './rules/useLogicalProperties.js'
+import { validStyles } from './rules/validStyles.js'
+
+/** Register through jsPlugins and enable individual zyzz/* rules in the lint configuration. */
+const plugin: Plugin = {
+  meta: { name: 'zyzz' },
+  rules: {
+    'no-conflicting-props': noConflictingProps,
+    'no-unused': noUnused,
+    'restricted-properties': restrictedProperties,
+    'use-logical-properties': useLogicalProperties,
+    'valid-styles': validStyles,
+  },
+}
+
+export default plugin

package/src/oxlint/internal/Bindings.ts

@@ -0,0 +1,270 @@
+/** Resolves immutable authoring bindings without loading or evaluating modules. @module */
+import type { Context, ESTree, Variable } from '@oxlint/plugins'
+
+/** A recognized helper or locally declared style. */
+export type Binding = {
+  readonly kind:
+    | 'config'
+    | 'configFactory'
+    | 'configNamespace'
+    | 'cx'
+    | 'definition'
+    | 'module'
+    | 'style'
+    | 'variants'
+  readonly themed: boolean
+}
+
+/** Resolves helpers using lexical scope, configuration filenames, and explicit import sources. */
+export function create(context: Context) {
+  const settings = context.settings.zyzz
+  const imports = new Set(['zyzz', 'zyzz/default'])
+  if (settings && typeof settings === 'object' && !Array.isArray(settings)) {
+    const sources = settings.imports
+    if (Array.isArray(sources))
+      for (const source of sources)
+        if (typeof source === 'string') imports.add(source)
+  }
+
+  function variable(
+    node: Extract<ESTree.Node, { type: 'Identifier' }>,
+  ): Variable | undefined {
+    let scope = context.sourceCode.getScope(node)
+    while (scope) {
+      const found = scope.set.get(node.name)
+      if (found) return found
+      if (!scope.upper) break
+      scope = scope.upper
+    }
+    return undefined
+  }
+
+  function initializer(
+    node: Extract<ESTree.Node, { type: 'Identifier' }>,
+  ): ESTree.Node | undefined {
+    const binding = variable(node)
+    if (!binding || binding.defs.length !== 1) return undefined
+    const definition = binding.defs[0]!
+    if (definition.node.type !== 'VariableDeclarator') return undefined
+    if (
+      definition.node.parent.type !== 'VariableDeclaration' ||
+      definition.node.parent.kind !== 'const'
+    )
+      return undefined
+    if (
+      binding.references.some(
+        (reference) => reference.isWrite() && !reference.init,
+      )
+    )
+      return undefined
+    if (definition.node.id.type !== 'Identifier') return undefined
+    const input = definition.node.init && unwrap(definition.node.init)
+    if (
+      input?.type === 'ArrayExpression' ||
+      input?.type === 'ObjectExpression'
+    ) {
+      const mutable = binding.references.some((reference) => {
+        let value: ESTree.Node = reference.identifier
+        while (
+          value.parent &&
+          ((value.parent.type === 'MemberExpression' &&
+            value.parent.object === value) ||
+            unwrap(value.parent) === value)
+        )
+          value = value.parent
+        const parent = value.parent
+        if (
+          parent?.type === 'ArrayExpression' ||
+          (parent?.type === 'Property' && parent.value === value)
+        )
+          return true
+        if (parent?.type === 'AssignmentExpression' && parent.left === value)
+          return true
+        if (
+          parent?.type === 'UpdateExpression' ||
+          (parent?.type === 'UnaryExpression' && parent.operator === 'delete')
+        )
+          return true
+        if (parent?.type === 'CallExpression') {
+          if (parent.callee === value) return true
+          const callee = resolve(parent.callee)
+          return callee?.kind !== 'style' && callee?.kind !== 'variants'
+        }
+        return parent?.type === 'VariableDeclarator' && parent.init === value
+      })
+      if (mutable) return undefined
+    }
+    return definition.node.init ?? undefined
+  }
+
+  function expression(
+    node: ESTree.Node,
+    seen = new Set<ESTree.Node>(),
+  ): ESTree.Node {
+    node = unwrap(node)
+    if (seen.has(node)) return node
+    seen.add(node)
+    if (node.type === 'Identifier') {
+      const init = initializer(node)
+      if (init) return expression(init, seen)
+    }
+    return node
+  }
+
+  function member(
+    binding: Binding | undefined,
+    name: string | undefined,
+  ): Binding | undefined {
+    if (!binding || !name) return undefined
+    if (binding.kind === 'module') {
+      if (!binding.themed && name === 'Config')
+        return { kind: 'configNamespace', themed: true }
+      if (
+        name === 'style' ||
+        name === 'variants' ||
+        (!binding.themed && name === 'cx')
+      )
+        return { kind: name, themed: binding.themed }
+    }
+    if (binding.kind === 'configNamespace' && name === 'create')
+      return { kind: 'configFactory', themed: true }
+    if (binding.kind === 'config' && (name === 'style' || name === 'variants'))
+      return { kind: name, themed: true }
+    return undefined
+  }
+
+  function resolve(
+    node: ESTree.Node,
+    seen = new Set<ESTree.Node>(),
+  ): Binding | undefined {
+    node = unwrap(node)
+    if (seen.has(node)) return undefined
+    seen.add(node)
+
+    if (node.type === 'Identifier') {
+      const binding = variable(node)
+      if (!binding || binding.defs.length !== 1) return undefined
+      const definition = binding.defs[0]!
+      const declaration = definition.node
+      if (definition.type === 'ImportBinding') {
+        const parent = declaration.parent
+        if (
+          parent?.type !== 'ImportDeclaration' ||
+          parent.importKind === 'type' ||
+          (!imports.has(parent.source.value) &&
+            !/(?:^|\/)zyzz\.config\.[^/]+$/.test(parent.source.value))
+        )
+          return undefined
+        const module: Binding = {
+          kind: 'module',
+          themed: parent.source.value !== 'zyzz',
+        }
+        if (declaration.type === 'ImportNamespaceSpecifier') return module
+        if (
+          declaration.type === 'ImportSpecifier' &&
+          declaration.importKind !== 'type'
+        )
+          return member(
+            module,
+            declaration.imported.type === 'Identifier'
+              ? declaration.imported.name
+              : declaration.imported.value,
+          )
+        return undefined
+      }
+      if (
+        declaration.type !== 'VariableDeclarator' ||
+        !declaration.init ||
+        declaration.parent.type !== 'VariableDeclaration' ||
+        declaration.parent.kind !== 'const'
+      )
+        return undefined
+      if (
+        binding.references.some(
+          (reference) => reference.isWrite() && !reference.init,
+        )
+      )
+        return undefined
+      if (declaration.id.type === 'Identifier')
+        return resolve(declaration.init, seen)
+      if (declaration.id.type === 'ObjectPattern') {
+        const property = declaration.id.properties.find(
+          (property) =>
+            property.type === 'Property' &&
+            property.value.type === 'Identifier' &&
+            property.value.name === node.name,
+        )
+        if (property?.type === 'Property')
+          return member(resolve(declaration.init, seen), key(property))
+      }
+    }
+
+    if (node.type === 'MemberExpression') {
+      const name = key(node)
+      const known = member(resolve(node.object, new Set(seen)), name)
+      if (known) return known
+      if (node.object.type !== 'Identifier' || !name) return undefined
+      const namespace = variable(node.object)
+      if (!namespace || namespace.defs.length !== 1) return undefined
+      const declaration = namespace.defs[0]!.node
+      if (
+        declaration.type !== 'TSModuleDeclaration' ||
+        declaration.body?.type !== 'TSModuleBlock'
+      )
+        return undefined
+      for (const statement of declaration.body.body) {
+        if (
+          statement.type !== 'ExportNamedDeclaration' ||
+          statement.declaration?.type !== 'VariableDeclaration' ||
+          statement.declaration.kind !== 'const'
+        )
+          continue
+        for (const entry of statement.declaration.declarations)
+          if (
+            entry.id.type === 'Identifier' &&
+            entry.id.name === name &&
+            entry.init
+          )
+            return resolve(entry.init, seen)
+      }
+    }
+
+    if (node.type === 'CallExpression') {
+      const callee = resolve(node.callee, seen)
+      if (callee?.kind === 'configFactory')
+        return { kind: 'config', themed: true }
+      if (callee?.kind === 'style' || callee?.kind === 'variants')
+        return { kind: 'definition', themed: callee.themed }
+    }
+    return undefined
+  }
+
+  return { expression, resolve, variable }
+}
+
+/** Resolves only literal property names, never computed identifiers. */
+export function key(
+  node:
+    | ESTree.ObjectProperty
+    | ESTree.BindingProperty
+    | ESTree.MemberExpression,
+): string | undefined {
+  const property = node.type === 'Property' ? node.key : node.property
+  if (!node.computed && property.type === 'Identifier') return property.name
+  if (property.type === 'Literal' && typeof property.value === 'string')
+    return property.value
+  return undefined
+}
+
+/** Removes type-only wrappers while retaining the original source node. */
+export function unwrap(node: ESTree.Node): ESTree.Node {
+  while (
+    node.type === 'TSAsExpression' ||
+    node.type === 'TSSatisfiesExpression' ||
+    node.type === 'TSNonNullExpression' ||
+    node.type === 'TSTypeAssertion' ||
+    node.type === 'ParenthesizedExpression'
+  )
+    node = node.expression
+  return node
+}