@wix/zero-config-implementation 1.105.0 → 1.107.0

package/dist/index.d.ts

@@ -435,6 +435,12 @@ export declare interface CSSParserAPI {
      * Returns null when the selector was not parsed.
      */
     getSelectorSpecificity: (selector: string) => [number, number, number] | null;
+    /**
+     * Classifies which appearance of its subject element a selector styles — regular, a single
+     * design state, or a state that cannot be attributed to the subject. Returns `regular` for
+     * selectors that were not parsed (e.g. keyframe selectors).
+     */
+    getSelectorStateScope: (selector: string) => SelectorStateScope;
     /**
      * Determines the CSS property type this one stylesheet can attribute to a custom property.
      * A `@property` registration is the top-priority source (declared type). Otherwise falls back
@@ -472,6 +478,13 @@ declare interface CSSProperty {
     valueAst?: CssNode;
     /** CSS variable names referenced via var() in this property's value */
     varRefs?: string[];
+    /**
+     * True when the declaration sits inside an at-rule block (e.g. `@media`, `@supports`, `@layer`),
+     * other than `@keyframes`. A top-level declaration wins over one in an at-rule when resolving a
+     * default value — conditional rules don't describe the default appearance, and unlayered rules
+     * beat layered ones in the cascade.
+     */
+    inAtRule?: boolean;
 }
 
 /**
@@ -2463,23 +2476,6 @@ declare interface RegisteredCustomProperty {
      * (`a | b | c`). Present only when `cssPropertyType` is `customEnum`.
      */
     enumOptions?: string[];
-    /**
-     * The numeric range for the control, as raw descriptor strings. Validated at
-     * conversion time. Meaningful only when `cssPropertyType` is `number`.
-     */
-    range?: RegisteredPropertyRange;
-}
-
-/**
- * `--min` / `--max` / `--step` descriptors an importer may emit inside an `@property`
- * block. The `--` prefix keeps them in the author namespace: browsers ignore descriptors
- * they don't know, so the CSS stays valid and CSS can't standardise these names out from
- * under us.
- */
-declare interface RegisteredPropertyRange {
-    min?: string;
-    max?: string;
-    step?: string;
 }
 
 /**
@@ -2622,6 +2618,22 @@ export declare interface RunExtractorsOptions {
     wrapper?: (component: ComponentType<unknown>) => ComponentType<unknown>;
 }
 
+/**
+ * Which appearance of its subject element a selector styles:
+ *   - `regular`       — the element's default appearance (no state condition on the subject).
+ *   - `state`         — exactly one design state on the subject (`.root:hover`, `.root:global(.x--hover)`).
+ *   - `unmappedState` — state-dependent, but not attributable to a single state of the subject
+ *                       (an ancestor's state, several states combined, a state inside `:is()`).
+ */
+declare type SelectorStateScope = {
+    kind: 'regular';
+} | {
+    kind: 'state';
+    stateName: string;
+} | {
+    kind: 'unmappedState';
+};
+
 /**
  * Like `LowObject & HighObject` except that if both keys are defined,
  * `HighObject` overrides `LowObject` instead of intersecting to it