New package alfa-painting-order

.changeset/eight-experts-know.md

@@ -0,0 +1,5 @@
+---
+"@siteimprove/alfa-css": minor
+---
+
+**Added:** `List.some` is now available.

.changeset/five-rocks-join.md

@@ -0,0 +1,5 @@
+---
+"@siteimprove/alfa-style": minor
+---
+
+**Added:** A new predicate `isFlexOrGridChild` is available.

.changeset/friendly-pots-destroy.md

@@ -0,0 +1,5 @@
+---
+"@siteimprove/alfa-device": minor
+---
+
+**Added:** `Device.isDevice` is now available.

.changeset/proud-apples-promise.md

@@ -0,0 +1,5 @@
+---
+"@siteimprove/alfa-painting-order": minor
+---
+
+**Added:** A new package has been added for computing the painting order of HTML elements.

docs/review/api/alfa-css.api.md

@@ -1298,6 +1298,8 @@ export class List<V extends Value> extends Value<"list", Value.HasCalculation<[V
     // (undocumented)
     get size(): number;
     // (undocumented)
+    some(predicate: Predicate<V, [index: number]>): boolean;
+    // (undocumented)
     toJSON(): List.JSON<V>;
     // (undocumented)
     toString(): string;

docs/review/api/alfa-device.api.md

@@ -42,6 +42,8 @@ export namespace Device {
     // (undocumented)
     export function from(json: JSON): Device;
     // (undocumented)
+    export function isDevice(value: unknown): value is Device;
+    // (undocumented)
     export interface JSON {
         // (undocumented)
         [key: string]: json.JSON;

docs/review/api/alfa-painting-order.api.md

@@ -0,0 +1,47 @@
+## API Report File for "@siteimprove/alfa-painting-order"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+import { Array as Array_2 } from '@siteimprove/alfa-array';
+import type { Device } from '@siteimprove/alfa-device';
+import { Element } from '@siteimprove/alfa-dom';
+import type { Equatable } from '@siteimprove/alfa-equatable';
+import type { Hash } from '@siteimprove/alfa-hash';
+import type { Hashable } from '@siteimprove/alfa-hash';
+import { Iterable as Iterable_2 } from '@siteimprove/alfa-iterable';
+import * as json from '@siteimprove/alfa-json';
+import type { Serializable } from '@siteimprove/alfa-json';
+
+// @public (undocumented)
+export class PaintingOrder implements Equatable, Hashable, Serializable<PaintingOrder.JSON> {
+    protected constructor(elements: Array_2<Element>);
+    // (undocumented)
+    equals(value: this): boolean;
+    // (undocumented)
+    equals(value: unknown): value is this;
+    // (undocumented)
+    hash(hash: Hash): void;
+    // (undocumented)
+    static of(elements: Iterable_2<Element>): PaintingOrder;
+    // (undocumented)
+    toJSON(options?: Serializable.Options): PaintingOrder.JSON;
+}
+
+// @public (undocumented)
+export namespace PaintingOrder {
+    // (undocumented)
+    export function isPaintingOrder(value: unknown): value is PaintingOrder;
+    // (undocumented)
+    export type JSON = {
+        [key: string]: json.JSON;
+        type: "painting-order";
+        elements: Array_2<Element.JSON>;
+    };
+    const from: (this: unknown, root: Element<string>, device: Device) => PaintingOrder;
+}
+
+// (No @packageDocumentation comment for this package)
+
+```

docs/review/api/alfa-style.api.md

@@ -349,7 +349,7 @@ export namespace Shorthands {
         readonly border: Shorthand<"border-bottom-color" | "border-bottom-style" | "border-bottom-width" | "border-left-color" | "border-left-style" | "border-left-width" | "border-right-color" | "border-right-style" | "border-right-width" | "border-top-color" | "border-top-style" | "border-top-width">;
         readonly "border-width": Shorthand<"border-bottom-width" | "border-left-width" | "border-right-width" | "border-top-width">;
         readonly "flex-flow": Shorthand<"flex-direction" | "flex-wrap">;
-        readonly font: Shorthand<"font-family" | "font-size" | "font-stretch" | "font-style" | "font-variant-caps" | "font-variant-east-asian" | "font-variant-ligatures" | "font-variant-numeric" | "font-variant-position" | "font-weight" | "line-height">;
+        readonly font: Shorthand<"font-size" | "font-family" | "font-stretch" | "font-style" | "font-variant-caps" | "font-variant-east-asian" | "font-variant-ligatures" | "font-variant-numeric" | "font-variant-position" | "font-weight" | "line-height">;
         readonly "font-variant": Shorthand<"font-variant-caps" | "font-variant-east-asian" | "font-variant-ligatures" | "font-variant-numeric">;
         readonly "inset-block": Shorthand<"inset-block-end" | "inset-block-start">;
         readonly "inset-inline": Shorthand<"inset-inline-end" | "inset-inline-start">;
@@ -440,12 +440,14 @@ export namespace Style {
     hasBoxShadow: typeof element.hasBoxShadow, // (undocumented)
     hasCascadedStyle: typeof element.hasCascadedStyle, // (undocumented)
     hasComputedStyle: typeof element.hasComputedStyle, // (undocumented)
+    hasInitialComputedStyle: typeof element.hasInitialComputedStyle, // (undocumented)
     hasPositioningParent: typeof element.hasPositioningParent, // (undocumented)
     hasOutline: typeof element.hasOutline, // (undocumented)
     hasSpecifiedStyle: typeof element.hasSpecifiedStyle, // (undocumented)
     hasTextDecoration: typeof element.hasTextDecoration, // (undocumented)
     hasTransparentBackground: typeof element.hasTransparentBackground, // (undocumented)
     hasUsedStyle: typeof element.hasUsedStyle, // (undocumented)
+    isFlexOrGridChild: typeof element.isFlexOrGridChild, // (undocumented)
     isFocusable: typeof element.isFocusable, // (undocumented)
     isImportant: typeof element.isImportant, // (undocumented)
     isInert: typeof element.isInert, // (undocumented)

packages/alfa-css/src/value/collection/list.ts

@@ -1,8 +1,9 @@
 import type { Hash } from "@siteimprove/alfa-hash";
-import type { Iterable } from "@siteimprove/alfa-iterable";
+import { Iterable } from "@siteimprove/alfa-iterable";
 import type { Serializable } from "@siteimprove/alfa-json";
 import type { Mapper } from "@siteimprove/alfa-mapper";
 import { Parser } from "@siteimprove/alfa-parser";
+import type { Predicate } from "@siteimprove/alfa-predicate";
 
 import { type Parser as CSSParser, Token } from "../../syntax/index.js";
 
@@ -48,6 +49,10 @@ export class List<V extends Value>
     return this._values.length;
   }
 
+  public some(predicate: Predicate<V, [index: number]>) {
+    return Iterable.some(this._values, predicate);
+  }
+
   public resolve(
     resolver?: Resolvable.Resolver<V>,
   ): List<Resolvable.Resolved<V>> {

packages/alfa-device/src/device.ts

@@ -164,4 +164,8 @@ export namespace Device {
   export function standard(): Device {
     return Device.of(Type.Screen, Viewport.standard(), Display.standard());
   }
+
+  export function isDevice(value: unknown): value is Device {
+    return value instanceof Device;
+  }
 }

packages/alfa-painting-order/README.md

@@ -0,0 +1,3 @@
+# Alfa painting order
+
+Support for computing painting order of elements.

packages/alfa-painting-order/config/api-extractor.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+  "extends": "../../../config/api-extractor.json",
+  "mainEntryPointFilePath": "<projectFolder>/dist/index.d.ts"
+}

packages/alfa-painting-order/package.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json.schemastore.org/package",
+  "name": "@siteimprove/alfa-painting-order",
+  "homepage": "https://alfa.siteimprove.com",
+  "version": "0.97.0",
+  "license": "MIT",
+  "description": "Support for computing painting order of elements.",
+  "repository": {
+    "type": "git",
+    "url": "github:Siteimprove/alfa",
+    "directory": "packages/alfa-painting-order"
+  },
+  "bugs": "https://github.com/siteimprove/alfa/issues",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "dependencies": {
+    "@siteimprove/alfa-array": "workspace:^",
+    "@siteimprove/alfa-cache": "workspace:^",
+    "@siteimprove/alfa-comparable": "workspace:^",
+    "@siteimprove/alfa-css": "workspace:^",
+    "@siteimprove/alfa-device": "workspace:^",
+    "@siteimprove/alfa-dom": "workspace:^",
+    "@siteimprove/alfa-equatable": "workspace:^",
+    "@siteimprove/alfa-hash": "workspace:^",
+    "@siteimprove/alfa-iterable": "workspace:^",
+    "@siteimprove/alfa-json": "workspace:^",
+    "@siteimprove/alfa-predicate": "workspace:^",
+    "@siteimprove/alfa-refinement": "workspace:^",
+    "@siteimprove/alfa-sequence": "workspace:^",
+    "@siteimprove/alfa-style": "workspace:^"
+  },
+  "devDependencies": {
+    "@siteimprove/alfa-test": "workspace:^"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://npm.pkg.github.com/"
+  }
+}

packages/alfa-painting-order/src/index.ts

@@ -0,0 +1 @@
+export * from "./painting-order.js";