@tenphi/eslint-plugin-tasty 1.0.5 → 1.1.0

package/dist/constants.js

@@ -1,4 +1,44 @@
 //#region src/constants.ts
+/** Logical edge modifiers, the `start`/`end` counterpart of {@link BOX_SIDES}. */
+const LOGICAL_EDGES = ["start", "end"];
+/** Enhanced logical sizes. `min`/`max` variants are read by the same handler. */
+const LOGICAL_SIZE_STYLES = ["blockSize", "inlineSize"];
+const LOGICAL_SIZE_CONSTRAINT_STYLES = [
+	"minBlockSize",
+	"maxBlockSize",
+	"minInlineSize",
+	"maxInlineSize"
+];
+/**
+* Enhanced logical spacing and inset axes — the categories that take a value
+* per logical edge, so they share the `start`/`end` modifier vocabulary and the
+* one-value-per-directional-group rule.
+*/
+const LOGICAL_SPACING_STYLES = [
+	"blockPadding",
+	"inlinePadding",
+	"blockMargin",
+	"inlineMargin",
+	"blockInset",
+	"inlineInset",
+	"blockScrollMargin",
+	"inlineScrollMargin",
+	"blockScrollPadding",
+	"inlineScrollPadding"
+];
+/**
+* Enhanced logical borders. Kept apart from {@link LOGICAL_SPACING_STYLES}
+* because a border group legitimately carries width + style + colour, exactly
+* as physical `border` does, so it is not subject to the single-value rule.
+*/
+const LOGICAL_BORDER_STYLES = ["blockBorder", "inlineBorder"];
+/** Every enhanced logical style, in the order tasty's own lists declare them. */
+const LOGICAL_STYLES = [
+	...LOGICAL_SIZE_STYLES,
+	...LOGICAL_SIZE_CONSTRAINT_STYLES,
+	...LOGICAL_SPACING_STYLES,
+	...LOGICAL_BORDER_STYLES
+];
 /**
 * Built-in tasty style properties that are always valid as style keys.
 */
@@ -22,8 +62,6 @@ const KNOWN_TASTY_PROPERTIES = new Set([
 	"inset",
 	"position",
 	"padding",
-	"paddingInline",
-	"paddingBlock",
 	"overflow",
 	"scrollbar",
 	"textAlign",
@@ -45,6 +83,7 @@ const KNOWN_TASTY_PROPERTIES = new Set([
 	"flexShrink",
 	"flex",
 	"flow",
+	"place",
 	"placeItems",
 	"placeContent",
 	"alignItems",
@@ -103,7 +142,10 @@ const KNOWN_TASTY_PROPERTIES = new Set([
 	"scrollSnapAlign",
 	"caretColor",
 	"accentColor",
-	"colorScheme"
+	"colorScheme",
+	"scrollMargin",
+	"scrollPadding",
+	...LOGICAL_STYLES
 ]);
 /**
 * Special top-level keys that are valid but not regular style properties.
@@ -1039,6 +1081,15 @@ const CSS_UNITS = new Set([
 ]);
 /**
 * Properties that accept `true` as a value (means "use default").
+*
+* `fill` is documented as accepting `true` but is deliberately absent: as of
+* tasty 3.8 the handler passes the boolean straight through, so `fill: true`
+* emits `background-color: true` — a declaration the browser drops, leaving no
+* background at all. Reporting it is the useful answer while that is what runs.
+* `constants.round-trip.test.ts` pins both halves of that: no property in this
+* set may swallow `true`, and `fill` still does — so whichever way tasty
+* resolves it (docs or implementation), a test says so rather than the plugin
+* quietly disagreeing with the runtime.
 */
 const BOOLEAN_TRUE_PROPERTIES = new Set([
 	"border",
@@ -1046,7 +1097,6 @@ const BOOLEAN_TRUE_PROPERTIES = new Set([
 	"padding",
 	"margin",
 	"gap",
-	"fill",
 	"color",
 	"shadow",
 	"outline",
@@ -1057,7 +1107,12 @@ const BOOLEAN_TRUE_PROPERTIES = new Set([
 	"hide",
 	"preset",
 	"font",
-	"scrollbar"
+	"scrollbar",
+	"scrollMargin",
+	"scrollPadding",
+	...LOGICAL_SIZE_STYLES,
+	...LOGICAL_SPACING_STYLES,
+	...LOGICAL_BORDER_STYLES
 ]);
 /**
 * Directional modifiers and which properties accept them.
@@ -1103,13 +1158,20 @@ const DIRECTIONAL_MODIFIERS = {
 		"bottom",
 		"left"
 	]),
+	scrollPadding: new Set([
+		"top",
+		"right",
+		"bottom",
+		"left"
+	]),
 	inset: new Set([
 		"top",
 		"right",
 		"bottom",
 		"left",
 		"dock"
-	])
+	]),
+	...Object.fromEntries([...LOGICAL_SPACING_STYLES, ...LOGICAL_BORDER_STYLES].map((style) => [style, new Set(LOGICAL_EDGES)]))
 };
 /**
 * Properties where a group naming directions carries exactly **one** value.
@@ -1129,7 +1191,9 @@ const SINGLE_VALUE_DIRECTIONAL_PROPERTIES = new Set([
 	"margin",
 	"inset",
 	"scrollMargin",
-	"fade"
+	"scrollPadding",
+	"fade",
+	...LOGICAL_SPACING_STYLES
 ]);
 /**
 * Position names a 4-value box maps onto, in source order.
@@ -1436,6 +1500,200 @@ const SHORTHAND_MAPPING = {
 	lineClamp: {
 		property: "textOverflow",
 		hint: "textOverflow: 'ellipsis / {lines}'"
+	},
+	paddingBlock: {
+		property: "blockPadding",
+		hint: "blockPadding: '...'",
+		safeFix: true
+	},
+	paddingBlockStart: {
+		property: "blockPadding",
+		hint: "blockPadding: '... start'"
+	},
+	paddingBlockEnd: {
+		property: "blockPadding",
+		hint: "blockPadding: '... end'"
+	},
+	paddingInline: {
+		property: "inlinePadding",
+		hint: "inlinePadding: '...'",
+		safeFix: true
+	},
+	paddingInlineStart: {
+		property: "inlinePadding",
+		hint: "inlinePadding: '... start'"
+	},
+	paddingInlineEnd: {
+		property: "inlinePadding",
+		hint: "inlinePadding: '... end'"
+	},
+	marginBlock: {
+		property: "blockMargin",
+		hint: "blockMargin: '...'",
+		safeFix: true
+	},
+	marginBlockStart: {
+		property: "blockMargin",
+		hint: "blockMargin: '... start'"
+	},
+	marginBlockEnd: {
+		property: "blockMargin",
+		hint: "blockMargin: '... end'"
+	},
+	marginInline: {
+		property: "inlineMargin",
+		hint: "inlineMargin: '...'",
+		safeFix: true
+	},
+	marginInlineStart: {
+		property: "inlineMargin",
+		hint: "inlineMargin: '... start'"
+	},
+	marginInlineEnd: {
+		property: "inlineMargin",
+		hint: "inlineMargin: '... end'"
+	},
+	insetBlock: {
+		property: "blockInset",
+		hint: "blockInset: '...'",
+		safeFix: true
+	},
+	insetBlockStart: {
+		property: "blockInset",
+		hint: "blockInset: '... start'"
+	},
+	insetBlockEnd: {
+		property: "blockInset",
+		hint: "blockInset: '... end'"
+	},
+	insetInline: {
+		property: "inlineInset",
+		hint: "inlineInset: '...'",
+		safeFix: true
+	},
+	insetInlineStart: {
+		property: "inlineInset",
+		hint: "inlineInset: '... start'"
+	},
+	insetInlineEnd: {
+		property: "inlineInset",
+		hint: "inlineInset: '... end'"
+	},
+	scrollMarginBlock: {
+		property: "blockScrollMargin",
+		hint: "blockScrollMargin: '...'",
+		safeFix: true
+	},
+	scrollMarginBlockStart: {
+		property: "blockScrollMargin",
+		hint: "blockScrollMargin: '... start'"
+	},
+	scrollMarginBlockEnd: {
+		property: "blockScrollMargin",
+		hint: "blockScrollMargin: '... end'"
+	},
+	scrollMarginInline: {
+		property: "inlineScrollMargin",
+		hint: "inlineScrollMargin: '...'",
+		safeFix: true
+	},
+	scrollMarginInlineStart: {
+		property: "inlineScrollMargin",
+		hint: "inlineScrollMargin: '... start'"
+	},
+	scrollMarginInlineEnd: {
+		property: "inlineScrollMargin",
+		hint: "inlineScrollMargin: '... end'"
+	},
+	scrollPaddingBlock: {
+		property: "blockScrollPadding",
+		hint: "blockScrollPadding: '...'",
+		safeFix: true
+	},
+	scrollPaddingBlockStart: {
+		property: "blockScrollPadding",
+		hint: "blockScrollPadding: '... start'"
+	},
+	scrollPaddingBlockEnd: {
+		property: "blockScrollPadding",
+		hint: "blockScrollPadding: '... end'"
+	},
+	scrollPaddingInline: {
+		property: "inlineScrollPadding",
+		hint: "inlineScrollPadding: '...'",
+		safeFix: true
+	},
+	scrollPaddingInlineStart: {
+		property: "inlineScrollPadding",
+		hint: "inlineScrollPadding: '... start'"
+	},
+	scrollPaddingInlineEnd: {
+		property: "inlineScrollPadding",
+		hint: "inlineScrollPadding: '... end'"
+	},
+	borderBlock: {
+		property: "blockBorder",
+		hint: "blockBorder: '...'"
+	},
+	borderBlockColor: {
+		property: "blockBorder",
+		hint: "blockBorder: '...'"
+	},
+	borderBlockWidth: {
+		property: "blockBorder",
+		hint: "blockBorder: '...'"
+	},
+	borderBlockStyle: {
+		property: "blockBorder",
+		hint: "blockBorder: '...'"
+	},
+	borderBlockStart: {
+		property: "blockBorder",
+		hint: "blockBorder: '... start'"
+	},
+	borderBlockEnd: {
+		property: "blockBorder",
+		hint: "blockBorder: '... end'"
+	},
+	borderInline: {
+		property: "inlineBorder",
+		hint: "inlineBorder: '...'"
+	},
+	borderInlineColor: {
+		property: "inlineBorder",
+		hint: "inlineBorder: '...'"
+	},
+	borderInlineWidth: {
+		property: "inlineBorder",
+		hint: "inlineBorder: '...'"
+	},
+	borderInlineStyle: {
+		property: "inlineBorder",
+		hint: "inlineBorder: '...'"
+	},
+	borderInlineStart: {
+		property: "inlineBorder",
+		hint: "inlineBorder: '... start'"
+	},
+	borderInlineEnd: {
+		property: "inlineBorder",
+		hint: "inlineBorder: '... end'"
+	},
+	minBlockSize: {
+		property: "blockSize",
+		hint: "blockSize: 'min ...'"
+	},
+	maxBlockSize: {
+		property: "blockSize",
+		hint: "blockSize: 'max ...'"
+	},
+	minInlineSize: {
+		property: "inlineSize",
+		hint: "inlineSize: 'min ...'"
+	},
+	maxInlineSize: {
+		property: "inlineSize",
+		hint: "inlineSize: 'max ...'"
 	}
 };
 /**
@@ -1746,6 +2004,8 @@ const COLOR_BEARING_PROPERTIES = new Set([
 	"accentColor",
 	"shadow",
 	"border",
+	"blockBorder",
+	"inlineBorder",
 	"outline",
 	"fade",
 	"background",
@@ -1755,6 +2015,12 @@ const COLOR_BEARING_PROPERTIES = new Set([
 	"borderRightColor",
 	"borderBottomColor",
 	"borderLeftColor",
+	"borderBlockColor",
+	"borderBlockStartColor",
+	"borderBlockEndColor",
+	"borderInlineColor",
+	"borderInlineStartColor",
+	"borderInlineEndColor",
 	"boxShadow",
 	"textShadow",
 	"textDecorationColor",
@@ -1769,41 +2035,30 @@ const COLOR_BEARING_PROPERTIES = new Set([
 /**
 * Properties where tasty does NOT expand a `$name` custom-property reference.
 *
-* These have their own style handlers that pass the value through verbatim, so
-* `fontFamily: '$font-sans'` emits a literal `font-family: $font-sans` — an
-* invalid declaration the browser drops. Rewriting `var(--font-sans)` to
-* `$font-sans` here silently deletes the style.
+* **Empty since tasty 3.0.2**, which taught the pass-through style handlers to
+* substitute `$name` refs too (tasty#264). Before that, `fontFamily:
+* '$font-sans'` emitted a literal `font-family: $font-sans` — an invalid
+* declaration the browser drops — so `prefer-custom-property-syntax` had to
+* suppress the rewrite for two dozen properties. It no longer does, which means
+* those rewrites are now offered where they were previously (and, since 3.0.2,
+* needlessly) held back.
 *
-* Note that the colour properties (`color`, `fill`, `backgroundColor`) are in
-* this list but NOT in {@link PROPERTIES_WITHOUT_COLOR_TOKEN_EXPANSION}: they
-* expand `#token` and not `$name`. The two sets are genuinely different.
+* The set is kept rather than deleted: it is the seam the round-trip guard
+* writes to, so a future handler that regains pass-through behaviour surfaces
+* as a failing test instead of a silently broken autofix.
+*
+* An empty list here would let `--fix` delete a declaration on 3.0.0/3.0.1,
+* which the `@tenphi/tasty` peer floor rules out — that floor is 3.8.0, set by
+* the logical renames in {@link SHORTHAND_MAPPING} rather than by this list.
+*
+* Note that {@link PROPERTIES_WITHOUT_COLOR_TOKEN_EXPANSION} is *not* empty:
+* `#token` expansion is still property-scoped (`fontSize: '#accent'` is
+* meaningless and passes through). The two sets are genuinely different.
 *
 * Derived from the runtime, not by hand — `constants.round-trip.test.ts` rebuilds
 * both sets against the installed `@tenphi/tasty` and fails if either drifts.
 */
-const PROPERTIES_WITHOUT_CUSTOM_PROPERTY_EXPANSION = new Set([
-	"align",
-	"alignContent",
-	"alignItems",
-	"backgroundAttachment",
-	"backgroundClip",
-	"backgroundColor",
-	"backgroundOrigin",
-	"backgroundRepeat",
-	"color",
-	"display",
-	"fill",
-	"font",
-	"fontFamily",
-	"justify",
-	"justifyContent",
-	"justifyItems",
-	"overflow",
-	"placeContent",
-	"placeItems",
-	"textTransform",
-	"whiteSpace"
-]);
+const PROPERTIES_WITHOUT_CUSTOM_PROPERTY_EXPANSION = /* @__PURE__ */ new Set([]);
 /**
 * Properties where tasty does NOT expand a `#name` colour token.
 *
@@ -1834,6 +2089,7 @@ const PROPERTIES_WITHOUT_COLOR_TOKEN_EXPANSION = new Set([
 	"lineHeight",
 	"outlineOffset",
 	"overflow",
+	"place",
 	"placeContent",
 	"placeItems",
 	"textTransform",
@@ -1841,5 +2097,5 @@ const PROPERTIES_WITHOUT_COLOR_TOKEN_EXPANSION = new Set([
 ]);
 
 //#endregion
-export { BOOLEAN_TRUE_PROPERTIES, BUILT_IN_STATE_PREFIXES, BUILT_IN_UNITS, COLOR_BEARING_PROPERTIES, CSS_UNITS, DEFAULT_IMPORT_SOURCES, DIRECTIONAL_BOX, DIRECTIONAL_MODIFIERS, DOCK_PROPERTIES, KNOWN_CSS_PROPERTIES, KNOWN_PSEUDO_CLASSES, KNOWN_TASTY_PROPERTIES, LONGHAND_MAPPING, NAMED_CSS_COLORS, PRESET_MODIFIERS, PROPERTIES_WITHOUT_COLOR_TOKEN_EXPANSION, PROPERTIES_WITHOUT_CUSTOM_PROPERTY_EXPANSION, RADIUS_SHAPES, RENAMED_SPECIAL_STYLE_KEYS, SEMANTIC_TRANSITIONS, SHORTHAND_MAPPING, SINGLE_VALUE_DIRECTIONAL_PROPERTIES, SPECIAL_STYLE_KEYS, TRANSITION_SEMANTIC_MAPPING };
+export { BOOLEAN_TRUE_PROPERTIES, BUILT_IN_STATE_PREFIXES, BUILT_IN_UNITS, COLOR_BEARING_PROPERTIES, CSS_UNITS, DEFAULT_IMPORT_SOURCES, DIRECTIONAL_BOX, DIRECTIONAL_MODIFIERS, DOCK_PROPERTIES, KNOWN_CSS_PROPERTIES, KNOWN_PSEUDO_CLASSES, KNOWN_TASTY_PROPERTIES, LOGICAL_BORDER_STYLES, LONGHAND_MAPPING, NAMED_CSS_COLORS, PRESET_MODIFIERS, PROPERTIES_WITHOUT_COLOR_TOKEN_EXPANSION, PROPERTIES_WITHOUT_CUSTOM_PROPERTY_EXPANSION, RADIUS_SHAPES, RENAMED_SPECIAL_STYLE_KEYS, SEMANTIC_TRANSITIONS, SHORTHAND_MAPPING, SINGLE_VALUE_DIRECTIONAL_PROPERTIES, SPECIAL_STYLE_KEYS, TRANSITION_SEMANTIC_MAPPING };
 //# sourceMappingURL=constants.js.map