@drskillissue/ganko 0.1.22 → 0.1.24

package/dist/index.d.cts

@@ -2425,6 +2425,11 @@ declare class CSSGraph {
     buildUnusedIndexes(): void;
 }
 
+interface ReservoirSampler {
+    readonly buffer: number[];
+    count: number;
+    readonly capacity: number;
+}
 interface LayoutPerfStatsMutable {
     elementsScanned: number;
     selectorCandidatesChecked: number;
@@ -2445,7 +2450,7 @@ interface LayoutPerfStatsMutable {
     cohortUnimodalFalse: number;
     factorCoverageSum: number;
     factorCoverageCount: number;
-    posteriorWidths: number[];
+    posteriorWidths: ReservoirSampler;
     uncertaintyEscalations: number;
     signalSnapshotsBuilt: number;
     signalSnapshotCacheHits: number;
@@ -2464,7 +2469,11 @@ type LayoutAxisModel = "horizontal-tb" | "vertical-rl" | "vertical-lr";
 type InlineDirectionModel = "ltr" | "rtl";
 type AlignmentContextKind = "inline-formatting" | "table-cell" | "flex-cross-axis" | "grid-cross-axis" | "block-flow" | "positioned-offset";
 type LayoutContextContainerKind = "table" | "flex" | "grid" | "inline" | "block";
-type ContextCertainty = "resolved" | "conditional" | "unknown";
+declare const enum ContextCertainty {
+    Resolved = 0,
+    Conditional = 1,
+    Unknown = 2
+}
 /**
  * Whether the CSS formatting context consults baselines for vertical positioning.
  *
@@ -2506,35 +2515,44 @@ interface AlignmentContext {
     readonly parentAlignItems: string | null;
     readonly parentPlaceItems: string | null;
     readonly hasPositionedOffset: boolean;
+    /**
+     * Whether the layout container's cross axis aligns with the document's
+     * block axis. When `true`, vertical sibling offset differences represent
+     * genuine alignment issues. When `false`, the block axis is the container's
+     * main axis — vertical positioning is controlled by the layout algorithm
+     * (gap, justify-content), and offset evidence should be suppressed.
+     *
+     * For non-flex/grid contexts (block flow, inline formatting, table-cell),
+     * this is always `true`.
+     */
+    readonly crossAxisIsBlockAxis: boolean;
+    readonly crossAxisIsBlockAxisCertainty: ContextCertainty;
     readonly baselineRelevance: BaselineRelevance;
     readonly evidence: LayoutContextEvidence;
 }
 
-type LayoutGuardConditionKind = "media" | "supports" | "container";
-interface LayoutGuardConditionProvenance {
-    readonly kind: LayoutGuardConditionKind;
-    readonly query: string | null;
-    readonly key: string;
-}
-
-declare const layoutSignalNames: readonly ["line-height", "font-size", "width", "inline-size", "height", "block-size", "min-width", "min-block-size", "min-height", "aspect-ratio", "vertical-align", "display", "white-space", "object-fit", "overflow", "overflow-y", "overflow-anchor", "scrollbar-gutter", "scrollbar-width", "contain-intrinsic-size", "content-visibility", "align-items", "align-self", "justify-items", "place-items", "place-self", "appearance", "box-sizing", "padding-top", "padding-left", "padding-right", "padding-bottom", "border-top-width", "border-left-width", "border-right-width", "border-bottom-width", "position", "top", "bottom", "margin-top", "margin-bottom", "transform", "translate", "inset-block-start", "inset-block-end", "writing-mode", "direction"];
+declare const layoutSignalNames: readonly ["line-height", "font-size", "width", "inline-size", "height", "block-size", "min-width", "min-block-size", "min-height", "aspect-ratio", "vertical-align", "display", "white-space", "object-fit", "overflow", "overflow-y", "overflow-anchor", "scrollbar-gutter", "scrollbar-width", "contain-intrinsic-size", "content-visibility", "align-items", "align-self", "justify-items", "place-items", "place-self", "flex-direction", "grid-auto-flow", "appearance", "box-sizing", "padding-top", "padding-left", "padding-right", "padding-bottom", "border-top-width", "border-left-width", "border-right-width", "border-bottom-width", "position", "top", "bottom", "margin-top", "margin-bottom", "transform", "translate", "inset-block-start", "inset-block-end", "writing-mode", "direction"];
 type LayoutSignalName = (typeof layoutSignalNames)[number];
-type LayoutSignalSource = "selector" | "inline-style";
-type LayoutSignalGuard = "unconditional" | "conditional";
-interface LayoutGuardProvenance {
-    readonly kind: LayoutSignalGuard;
-    readonly conditions: readonly LayoutGuardConditionProvenance[];
-    readonly key: string;
+declare const enum LayoutSignalSource {
+    Selector = 0,
+    InlineStyle = 1
+}
+declare const enum LayoutSignalGuard {
+    Unconditional = 0,
+    Conditional = 1
+}
+declare const enum LayoutSignalUnit {
+    Px = 0,
+    Unitless = 1,
+    Keyword = 2,
+    Unknown = 3
 }
-type LayoutSignalUnit = "px" | "unitless" | "keyword" | "unknown";
 interface LayoutKnownSignalValue {
     readonly kind: "known";
     readonly name: LayoutSignalName;
-    readonly raw: string;
     readonly normalized: string;
     readonly source: LayoutSignalSource;
-    readonly guard: LayoutSignalGuard;
-    readonly guardProvenance: LayoutGuardProvenance;
+    readonly guard: LayoutRuleGuard;
     readonly unit: LayoutSignalUnit;
     readonly px: number | null;
     readonly quality: "exact" | "estimated";
@@ -2542,22 +2560,19 @@ interface LayoutKnownSignalValue {
 interface LayoutUnknownSignalValue {
     readonly kind: "unknown";
     readonly name: LayoutSignalName;
-    readonly raw: string | null;
     readonly source: LayoutSignalSource | null;
-    readonly guard: LayoutSignalGuard;
-    readonly guardProvenance: LayoutGuardProvenance;
+    readonly guard: LayoutRuleGuard;
     readonly reason: string;
 }
 type LayoutSignalValue = LayoutKnownSignalValue | LayoutUnknownSignalValue;
-type LayoutTextualContentState = "yes" | "no" | "unknown" | "dynamic-text";
+declare const enum LayoutTextualContentState {
+    Yes = 0,
+    No = 1,
+    Unknown = 2,
+    DynamicText = 3
+}
 interface LayoutSignalSnapshot {
-    readonly solidFile: string;
-    readonly elementId: number;
-    readonly elementKey: string;
-    readonly tag: string | null;
-    readonly textualContent: LayoutTextualContentState;
-    readonly isControl: boolean;
-    readonly isReplaced: boolean;
+    readonly node: LayoutElementNode;
     readonly signals: ReadonlyMap<LayoutSignalName, LayoutSignalValue>;
     readonly knownSignalCount: number;
     readonly unknownSignalCount: number;
@@ -2570,8 +2585,16 @@ interface AlignmentElementEvidence {
     readonly tag: string | null;
     readonly snapshot: LayoutSignalSnapshot;
 }
-type AlignmentTextContrast = "different" | "same" | "unknown";
-type SignalConflictValue = "conflict" | "aligned" | "unknown";
+declare const enum AlignmentTextContrast {
+    Different = 0,
+    Same = 1,
+    Unknown = 2
+}
+declare const enum SignalConflictValue {
+    Conflict = 0,
+    Aligned = 1,
+    Unknown = 2
+}
 interface SignalConflictEvidence {
     readonly value: SignalConflictValue;
     readonly kind: EvidenceValueKind;
@@ -2583,7 +2606,12 @@ interface AlignmentCohortSignals {
     readonly hasControlOrReplacedPeer: boolean;
     readonly textContrastWithPeers: AlignmentTextContrast;
 }
-type CohortSubjectMembership = "dominant" | "nondominant" | "ambiguous" | "insufficient";
+declare const enum CohortSubjectMembership {
+    Dominant = 0,
+    Nondominant = 1,
+    Ambiguous = 2,
+    Insufficient = 3
+}
 interface CohortIdentifiability {
     readonly dominantShare: number;
     readonly subjectExcludedDominantShare: number;
@@ -2623,6 +2651,8 @@ interface LayoutSnapshotHotSignals {
     readonly verticalAlign: HotNormalizedSignalEvidence;
     readonly alignSelf: HotNormalizedSignalEvidence;
     readonly placeSelf: HotNormalizedSignalEvidence;
+    readonly flexDirection: HotNormalizedSignalEvidence;
+    readonly gridAutoFlow: HotNormalizedSignalEvidence;
     readonly writingMode: HotNormalizedSignalEvidence;
     readonly direction: HotNormalizedSignalEvidence;
     readonly display: HotNormalizedSignalEvidence;
@@ -2659,7 +2689,14 @@ interface LayoutCohortStats {
     /** Element keys excluded from cohort analysis (e.g. visually-hidden accessible elements). */
     readonly excludedElementKeys: ReadonlySet<string>;
 }
-type ContentCompositionClassification = "text-only" | "replaced-only" | "mixed-unmitigated" | "mixed-mitigated" | "block-segmented" | "unknown";
+declare const enum ContentCompositionClassification {
+    TextOnly = 0,
+    ReplacedOnly = 1,
+    MixedUnmitigated = 2,
+    MixedMitigated = 3,
+    BlockSegmented = 4,
+    Unknown = 5
+}
 /**
  * Distinguishes intrinsically-replaced elements (img, svg, video, canvas) from
  * inline-block/inline-flex containers. Their baseline rules differ: an img uses
@@ -2679,7 +2716,12 @@ interface ContentCompositionFingerprint {
     readonly totalChildCount: number;
     readonly hasOnlyBlockChildren: boolean;
 }
-type EvidenceValueKind = "exact" | "interval" | "conditional" | "unknown";
+declare const enum EvidenceValueKind {
+    Exact = 0,
+    Interval = 1,
+    Conditional = 2,
+    Unknown = 3
+}
 interface EvidenceWitness<T> {
     readonly value: T | null;
     readonly kind: EvidenceValueKind;
@@ -2691,11 +2733,26 @@ interface EvidenceProvenance {
     readonly guards: readonly LayoutGuardConditionProvenance[];
 }
 
+type LayoutGuardConditionKind = "media" | "supports" | "container";
+interface LayoutGuardConditionProvenance {
+    readonly kind: LayoutGuardConditionKind;
+    readonly query: string | null;
+    readonly key: string;
+}
+type LayoutRuleGuard = {
+    readonly kind: LayoutSignalGuard.Unconditional;
+    readonly conditions: readonly LayoutGuardConditionProvenance[];
+    readonly key: "always";
+} | {
+    readonly kind: LayoutSignalGuard.Conditional;
+    readonly conditions: readonly LayoutGuardConditionProvenance[];
+    readonly key: string;
+};
+
 interface LayoutCascadedDeclaration {
     readonly value: string;
-    readonly source: "selector" | "inline-style";
-    readonly guard: LayoutSignalGuard;
-    readonly guardProvenance: LayoutGuardProvenance;
+    readonly source: LayoutSignalSource;
+    readonly guardProvenance: LayoutRuleGuard;
 }
 interface LayoutElementNode {
     readonly key: string;
@@ -2706,8 +2763,6 @@ interface LayoutElementNode {
     readonly classTokens: readonly string[];
     readonly classTokenSet: ReadonlySet<string>;
     readonly inlineStyleKeys: readonly string[];
-    readonly parentElementId: number | null;
-    readonly parentElementKey: string | null;
     readonly parentElementNode: LayoutElementNode | null;
     readonly previousSiblingNode: LayoutElementNode | null;
     readonly siblingIndex: number;
@@ -2717,7 +2772,7 @@ interface LayoutElementNode {
     readonly selectorDispatchKeys: readonly string[];
     readonly attributes: ReadonlyMap<string, string | null>;
     readonly inlineStyleValues: ReadonlyMap<string, string>;
-    readonly textualContent: "yes" | "no" | "unknown" | "dynamic-text";
+    readonly textualContent: LayoutTextualContentState;
     readonly isControl: boolean;
     readonly isReplaced: boolean;
 }
@@ -2727,9 +2782,6 @@ interface LayoutStyleRuleNode {
     readonly selectorId: number;
 }
 interface LayoutMatchEdge {
-    readonly solidFile: string;
-    readonly elementId: number;
-    readonly elementKey: string;
     readonly selectorId: number;
     readonly specificityScore: number;
     readonly sourceOrder: number;
@@ -2747,7 +2799,12 @@ interface LayoutReservedSpaceFact {
     readonly hasContainIntrinsicSize: boolean;
     readonly hasUsableAspectRatio: boolean;
 }
-type LayoutScrollAxis = "x" | "y" | "both" | "none";
+declare const enum LayoutScrollAxis {
+    None = 0,
+    X = 1,
+    Y = 2,
+    Both = 3
+}
 interface LayoutScrollContainerFact {
     readonly isScrollContainer: boolean;
     readonly axis: LayoutScrollAxis;
@@ -2810,20 +2867,20 @@ interface LayoutGraphCascade {
     readonly styleRules: readonly LayoutStyleRuleNode[];
     readonly applies: readonly LayoutMatchEdge[];
     readonly cssScopeBySolidFile: ReadonlyMap<string, readonly string[]>;
-    readonly appliesByElementKey: ReadonlyMap<string, readonly LayoutMatchEdge[]>;
-    readonly selectorCandidatesByElementKey: ReadonlyMap<string, readonly number[]>;
+    readonly appliesByNode: ReadonlyMap<LayoutElementNode, readonly LayoutMatchEdge[]>;
+    readonly selectorCandidatesByNode: ReadonlyMap<LayoutElementNode, readonly number[]>;
     readonly selectorsById: ReadonlyMap<number, SelectorEntity>;
     readonly cascadeByElementNode: WeakMap<LayoutElementNode, ReadonlyMap<string, LayoutCascadedDeclaration>>;
     readonly snapshotByElementNode: WeakMap<LayoutElementNode, LayoutSignalSnapshot>;
-    readonly snapshotHotSignalsByElementKey: ReadonlyMap<string, LayoutSnapshotHotSignals>;
+    readonly snapshotHotSignalsByNode: ReadonlyMap<LayoutElementNode, LayoutSnapshotHotSignals>;
 }
 interface LayoutGraphFacts {
-    readonly reservedSpaceFactsByElementKey: ReadonlyMap<string, LayoutReservedSpaceFact>;
-    readonly scrollContainerFactsByElementKey: ReadonlyMap<string, LayoutScrollContainerFact>;
-    readonly flowParticipationFactsByElementKey: ReadonlyMap<string, LayoutFlowParticipationFact>;
-    readonly containingBlockFactsByElementKey: ReadonlyMap<string, LayoutContainingBlockFact>;
-    readonly conditionalSignalDeltaFactsByElementKey: ReadonlyMap<string, ReadonlyMap<LayoutSignalName, LayoutConditionalSignalDeltaFact>>;
-    readonly baselineOffsetFactsByElementKey: ReadonlyMap<string, ReadonlyMap<LayoutSignalName, readonly number[]>>;
+    readonly reservedSpaceFactsByNode: ReadonlyMap<LayoutElementNode, LayoutReservedSpaceFact>;
+    readonly scrollContainerFactsByNode: ReadonlyMap<LayoutElementNode, LayoutScrollContainerFact>;
+    readonly flowParticipationFactsByNode: ReadonlyMap<LayoutElementNode, LayoutFlowParticipationFact>;
+    readonly containingBlockFactsByNode: ReadonlyMap<LayoutElementNode, LayoutContainingBlockFact>;
+    readonly conditionalSignalDeltaFactsByNode: ReadonlyMap<LayoutElementNode, ReadonlyMap<LayoutSignalName, LayoutConditionalSignalDeltaFact>>;
+    readonly baselineOffsetFactsByNode: ReadonlyMap<LayoutElementNode, ReadonlyMap<LayoutSignalName, readonly number[]>>;
 }
 interface LayoutGraphCohorts {
     readonly cohortStatsByParentNode: ReadonlyMap<LayoutElementNode, LayoutCohortStats>;

package/dist/index.d.ts

@@ -2425,6 +2425,11 @@ declare class CSSGraph {
     buildUnusedIndexes(): void;
 }
 
+interface ReservoirSampler {
+    readonly buffer: number[];
+    count: number;
+    readonly capacity: number;
+}
 interface LayoutPerfStatsMutable {
     elementsScanned: number;
     selectorCandidatesChecked: number;
@@ -2445,7 +2450,7 @@ interface LayoutPerfStatsMutable {
     cohortUnimodalFalse: number;
     factorCoverageSum: number;
     factorCoverageCount: number;
-    posteriorWidths: number[];
+    posteriorWidths: ReservoirSampler;
     uncertaintyEscalations: number;
     signalSnapshotsBuilt: number;
     signalSnapshotCacheHits: number;
@@ -2464,7 +2469,11 @@ type LayoutAxisModel = "horizontal-tb" | "vertical-rl" | "vertical-lr";
 type InlineDirectionModel = "ltr" | "rtl";
 type AlignmentContextKind = "inline-formatting" | "table-cell" | "flex-cross-axis" | "grid-cross-axis" | "block-flow" | "positioned-offset";
 type LayoutContextContainerKind = "table" | "flex" | "grid" | "inline" | "block";
-type ContextCertainty = "resolved" | "conditional" | "unknown";
+declare const enum ContextCertainty {
+    Resolved = 0,
+    Conditional = 1,
+    Unknown = 2
+}
 /**
  * Whether the CSS formatting context consults baselines for vertical positioning.
  *
@@ -2506,35 +2515,44 @@ interface AlignmentContext {
     readonly parentAlignItems: string | null;
     readonly parentPlaceItems: string | null;
     readonly hasPositionedOffset: boolean;
+    /**
+     * Whether the layout container's cross axis aligns with the document's
+     * block axis. When `true`, vertical sibling offset differences represent
+     * genuine alignment issues. When `false`, the block axis is the container's
+     * main axis — vertical positioning is controlled by the layout algorithm
+     * (gap, justify-content), and offset evidence should be suppressed.
+     *
+     * For non-flex/grid contexts (block flow, inline formatting, table-cell),
+     * this is always `true`.
+     */
+    readonly crossAxisIsBlockAxis: boolean;
+    readonly crossAxisIsBlockAxisCertainty: ContextCertainty;
     readonly baselineRelevance: BaselineRelevance;
     readonly evidence: LayoutContextEvidence;
 }
 
-type LayoutGuardConditionKind = "media" | "supports" | "container";
-interface LayoutGuardConditionProvenance {
-    readonly kind: LayoutGuardConditionKind;
-    readonly query: string | null;
-    readonly key: string;
-}
-
-declare const layoutSignalNames: readonly ["line-height", "font-size", "width", "inline-size", "height", "block-size", "min-width", "min-block-size", "min-height", "aspect-ratio", "vertical-align", "display", "white-space", "object-fit", "overflow", "overflow-y", "overflow-anchor", "scrollbar-gutter", "scrollbar-width", "contain-intrinsic-size", "content-visibility", "align-items", "align-self", "justify-items", "place-items", "place-self", "appearance", "box-sizing", "padding-top", "padding-left", "padding-right", "padding-bottom", "border-top-width", "border-left-width", "border-right-width", "border-bottom-width", "position", "top", "bottom", "margin-top", "margin-bottom", "transform", "translate", "inset-block-start", "inset-block-end", "writing-mode", "direction"];
+declare const layoutSignalNames: readonly ["line-height", "font-size", "width", "inline-size", "height", "block-size", "min-width", "min-block-size", "min-height", "aspect-ratio", "vertical-align", "display", "white-space", "object-fit", "overflow", "overflow-y", "overflow-anchor", "scrollbar-gutter", "scrollbar-width", "contain-intrinsic-size", "content-visibility", "align-items", "align-self", "justify-items", "place-items", "place-self", "flex-direction", "grid-auto-flow", "appearance", "box-sizing", "padding-top", "padding-left", "padding-right", "padding-bottom", "border-top-width", "border-left-width", "border-right-width", "border-bottom-width", "position", "top", "bottom", "margin-top", "margin-bottom", "transform", "translate", "inset-block-start", "inset-block-end", "writing-mode", "direction"];
 type LayoutSignalName = (typeof layoutSignalNames)[number];
-type LayoutSignalSource = "selector" | "inline-style";
-type LayoutSignalGuard = "unconditional" | "conditional";
-interface LayoutGuardProvenance {
-    readonly kind: LayoutSignalGuard;
-    readonly conditions: readonly LayoutGuardConditionProvenance[];
-    readonly key: string;
+declare const enum LayoutSignalSource {
+    Selector = 0,
+    InlineStyle = 1
+}
+declare const enum LayoutSignalGuard {
+    Unconditional = 0,
+    Conditional = 1
+}
+declare const enum LayoutSignalUnit {
+    Px = 0,
+    Unitless = 1,
+    Keyword = 2,
+    Unknown = 3
 }
-type LayoutSignalUnit = "px" | "unitless" | "keyword" | "unknown";
 interface LayoutKnownSignalValue {
     readonly kind: "known";
     readonly name: LayoutSignalName;
-    readonly raw: string;
     readonly normalized: string;
     readonly source: LayoutSignalSource;
-    readonly guard: LayoutSignalGuard;
-    readonly guardProvenance: LayoutGuardProvenance;
+    readonly guard: LayoutRuleGuard;
     readonly unit: LayoutSignalUnit;
     readonly px: number | null;
     readonly quality: "exact" | "estimated";
@@ -2542,22 +2560,19 @@ interface LayoutKnownSignalValue {
 interface LayoutUnknownSignalValue {
     readonly kind: "unknown";
     readonly name: LayoutSignalName;
-    readonly raw: string | null;
     readonly source: LayoutSignalSource | null;
-    readonly guard: LayoutSignalGuard;
-    readonly guardProvenance: LayoutGuardProvenance;
+    readonly guard: LayoutRuleGuard;
     readonly reason: string;
 }
 type LayoutSignalValue = LayoutKnownSignalValue | LayoutUnknownSignalValue;
-type LayoutTextualContentState = "yes" | "no" | "unknown" | "dynamic-text";
+declare const enum LayoutTextualContentState {
+    Yes = 0,
+    No = 1,
+    Unknown = 2,
+    DynamicText = 3
+}
 interface LayoutSignalSnapshot {
-    readonly solidFile: string;
-    readonly elementId: number;
-    readonly elementKey: string;
-    readonly tag: string | null;
-    readonly textualContent: LayoutTextualContentState;
-    readonly isControl: boolean;
-    readonly isReplaced: boolean;
+    readonly node: LayoutElementNode;
     readonly signals: ReadonlyMap<LayoutSignalName, LayoutSignalValue>;
     readonly knownSignalCount: number;
     readonly unknownSignalCount: number;
@@ -2570,8 +2585,16 @@ interface AlignmentElementEvidence {
     readonly tag: string | null;
     readonly snapshot: LayoutSignalSnapshot;
 }
-type AlignmentTextContrast = "different" | "same" | "unknown";
-type SignalConflictValue = "conflict" | "aligned" | "unknown";
+declare const enum AlignmentTextContrast {
+    Different = 0,
+    Same = 1,
+    Unknown = 2
+}
+declare const enum SignalConflictValue {
+    Conflict = 0,
+    Aligned = 1,
+    Unknown = 2
+}
 interface SignalConflictEvidence {
     readonly value: SignalConflictValue;
     readonly kind: EvidenceValueKind;
@@ -2583,7 +2606,12 @@ interface AlignmentCohortSignals {
     readonly hasControlOrReplacedPeer: boolean;
     readonly textContrastWithPeers: AlignmentTextContrast;
 }
-type CohortSubjectMembership = "dominant" | "nondominant" | "ambiguous" | "insufficient";
+declare const enum CohortSubjectMembership {
+    Dominant = 0,
+    Nondominant = 1,
+    Ambiguous = 2,
+    Insufficient = 3
+}
 interface CohortIdentifiability {
     readonly dominantShare: number;
     readonly subjectExcludedDominantShare: number;
@@ -2623,6 +2651,8 @@ interface LayoutSnapshotHotSignals {
     readonly verticalAlign: HotNormalizedSignalEvidence;
     readonly alignSelf: HotNormalizedSignalEvidence;
     readonly placeSelf: HotNormalizedSignalEvidence;
+    readonly flexDirection: HotNormalizedSignalEvidence;
+    readonly gridAutoFlow: HotNormalizedSignalEvidence;
     readonly writingMode: HotNormalizedSignalEvidence;
     readonly direction: HotNormalizedSignalEvidence;
     readonly display: HotNormalizedSignalEvidence;
@@ -2659,7 +2689,14 @@ interface LayoutCohortStats {
     /** Element keys excluded from cohort analysis (e.g. visually-hidden accessible elements). */
     readonly excludedElementKeys: ReadonlySet<string>;
 }
-type ContentCompositionClassification = "text-only" | "replaced-only" | "mixed-unmitigated" | "mixed-mitigated" | "block-segmented" | "unknown";
+declare const enum ContentCompositionClassification {
+    TextOnly = 0,
+    ReplacedOnly = 1,
+    MixedUnmitigated = 2,
+    MixedMitigated = 3,
+    BlockSegmented = 4,
+    Unknown = 5
+}
 /**
  * Distinguishes intrinsically-replaced elements (img, svg, video, canvas) from
  * inline-block/inline-flex containers. Their baseline rules differ: an img uses
@@ -2679,7 +2716,12 @@ interface ContentCompositionFingerprint {
     readonly totalChildCount: number;
     readonly hasOnlyBlockChildren: boolean;
 }
-type EvidenceValueKind = "exact" | "interval" | "conditional" | "unknown";
+declare const enum EvidenceValueKind {
+    Exact = 0,
+    Interval = 1,
+    Conditional = 2,
+    Unknown = 3
+}
 interface EvidenceWitness<T> {
     readonly value: T | null;
     readonly kind: EvidenceValueKind;
@@ -2691,11 +2733,26 @@ interface EvidenceProvenance {
     readonly guards: readonly LayoutGuardConditionProvenance[];
 }
 
+type LayoutGuardConditionKind = "media" | "supports" | "container";
+interface LayoutGuardConditionProvenance {
+    readonly kind: LayoutGuardConditionKind;
+    readonly query: string | null;
+    readonly key: string;
+}
+type LayoutRuleGuard = {
+    readonly kind: LayoutSignalGuard.Unconditional;
+    readonly conditions: readonly LayoutGuardConditionProvenance[];
+    readonly key: "always";
+} | {
+    readonly kind: LayoutSignalGuard.Conditional;
+    readonly conditions: readonly LayoutGuardConditionProvenance[];
+    readonly key: string;
+};
+
 interface LayoutCascadedDeclaration {
     readonly value: string;
-    readonly source: "selector" | "inline-style";
-    readonly guard: LayoutSignalGuard;
-    readonly guardProvenance: LayoutGuardProvenance;
+    readonly source: LayoutSignalSource;
+    readonly guardProvenance: LayoutRuleGuard;
 }
 interface LayoutElementNode {
     readonly key: string;
@@ -2706,8 +2763,6 @@ interface LayoutElementNode {
     readonly classTokens: readonly string[];
     readonly classTokenSet: ReadonlySet<string>;
     readonly inlineStyleKeys: readonly string[];
-    readonly parentElementId: number | null;
-    readonly parentElementKey: string | null;
     readonly parentElementNode: LayoutElementNode | null;
     readonly previousSiblingNode: LayoutElementNode | null;
     readonly siblingIndex: number;
@@ -2717,7 +2772,7 @@ interface LayoutElementNode {
     readonly selectorDispatchKeys: readonly string[];
     readonly attributes: ReadonlyMap<string, string | null>;
     readonly inlineStyleValues: ReadonlyMap<string, string>;
-    readonly textualContent: "yes" | "no" | "unknown" | "dynamic-text";
+    readonly textualContent: LayoutTextualContentState;
     readonly isControl: boolean;
     readonly isReplaced: boolean;
 }
@@ -2727,9 +2782,6 @@ interface LayoutStyleRuleNode {
     readonly selectorId: number;
 }
 interface LayoutMatchEdge {
-    readonly solidFile: string;
-    readonly elementId: number;
-    readonly elementKey: string;
     readonly selectorId: number;
     readonly specificityScore: number;
     readonly sourceOrder: number;
@@ -2747,7 +2799,12 @@ interface LayoutReservedSpaceFact {
     readonly hasContainIntrinsicSize: boolean;
     readonly hasUsableAspectRatio: boolean;
 }
-type LayoutScrollAxis = "x" | "y" | "both" | "none";
+declare const enum LayoutScrollAxis {
+    None = 0,
+    X = 1,
+    Y = 2,
+    Both = 3
+}
 interface LayoutScrollContainerFact {
     readonly isScrollContainer: boolean;
     readonly axis: LayoutScrollAxis;
@@ -2810,20 +2867,20 @@ interface LayoutGraphCascade {
     readonly styleRules: readonly LayoutStyleRuleNode[];
     readonly applies: readonly LayoutMatchEdge[];
     readonly cssScopeBySolidFile: ReadonlyMap<string, readonly string[]>;
-    readonly appliesByElementKey: ReadonlyMap<string, readonly LayoutMatchEdge[]>;
-    readonly selectorCandidatesByElementKey: ReadonlyMap<string, readonly number[]>;
+    readonly appliesByNode: ReadonlyMap<LayoutElementNode, readonly LayoutMatchEdge[]>;
+    readonly selectorCandidatesByNode: ReadonlyMap<LayoutElementNode, readonly number[]>;
     readonly selectorsById: ReadonlyMap<number, SelectorEntity>;
     readonly cascadeByElementNode: WeakMap<LayoutElementNode, ReadonlyMap<string, LayoutCascadedDeclaration>>;
     readonly snapshotByElementNode: WeakMap<LayoutElementNode, LayoutSignalSnapshot>;
-    readonly snapshotHotSignalsByElementKey: ReadonlyMap<string, LayoutSnapshotHotSignals>;
+    readonly snapshotHotSignalsByNode: ReadonlyMap<LayoutElementNode, LayoutSnapshotHotSignals>;
 }
 interface LayoutGraphFacts {
-    readonly reservedSpaceFactsByElementKey: ReadonlyMap<string, LayoutReservedSpaceFact>;
-    readonly scrollContainerFactsByElementKey: ReadonlyMap<string, LayoutScrollContainerFact>;
-    readonly flowParticipationFactsByElementKey: ReadonlyMap<string, LayoutFlowParticipationFact>;
-    readonly containingBlockFactsByElementKey: ReadonlyMap<string, LayoutContainingBlockFact>;
-    readonly conditionalSignalDeltaFactsByElementKey: ReadonlyMap<string, ReadonlyMap<LayoutSignalName, LayoutConditionalSignalDeltaFact>>;
-    readonly baselineOffsetFactsByElementKey: ReadonlyMap<string, ReadonlyMap<LayoutSignalName, readonly number[]>>;
+    readonly reservedSpaceFactsByNode: ReadonlyMap<LayoutElementNode, LayoutReservedSpaceFact>;
+    readonly scrollContainerFactsByNode: ReadonlyMap<LayoutElementNode, LayoutScrollContainerFact>;
+    readonly flowParticipationFactsByNode: ReadonlyMap<LayoutElementNode, LayoutFlowParticipationFact>;
+    readonly containingBlockFactsByNode: ReadonlyMap<LayoutElementNode, LayoutContainingBlockFact>;
+    readonly conditionalSignalDeltaFactsByNode: ReadonlyMap<LayoutElementNode, ReadonlyMap<LayoutSignalName, LayoutConditionalSignalDeltaFact>>;
+    readonly baselineOffsetFactsByNode: ReadonlyMap<LayoutElementNode, ReadonlyMap<LayoutSignalName, readonly number[]>>;
 }
 interface LayoutGraphCohorts {
     readonly cohortStatsByParentNode: ReadonlyMap<LayoutElementNode, LayoutCohortStats>;

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   RULES,
   RULES_BY_CATEGORY,
   getRule
-} from "./chunk-IF3V4IQF.js";
+} from "./chunk-KVZ56NZ5.js";
 import {
   CSSPlugin,
   SolidPlugin,
@@ -21,7 +21,7 @@ import {
   runSolidRules,
   scanDependencyCustomProperties,
   setActivePolicy
-} from "./chunk-5IOPY65Q.js";
+} from "./chunk-64TMAKYI.js";
 import "./chunk-EGRHWZRV.js";
 
 // src/runner.ts