@cronn/element-snapshot 0.30.0 → 0.32.0

package/dist/browser-lib.iife.js

@@ -161,6 +161,7 @@
 		"tablist",
 		"tabpanel",
 		"term",
+		"toolbar",
 		"tree"
 	]);
 	//#endregion
@@ -450,7 +451,7 @@
 	function resolveLabelName(element) {
 		if (element.id !== null) {
 			const referencedElement = element.ownerDocument.querySelector(attributeSelector("for", element.id));
-			if (referencedElement !== null) return resolveAccessibleTextContent(referencedElement);
+			if (referencedElement !== null) return resolveAccessibleTextContent(referencedElement, [element]);
 		}
 		const closestLabel = element.closest("label");
 		if (closestLabel !== null) return resolveAccessibleTextContent(closestLabel, [element]);
@@ -514,6 +515,11 @@
 		};
 	}
 	//#endregion
+	//#region src/utils/array.ts
+	function unwrapSingleItem(items) {
+		return items.length === 1 ? items.at(0) : items;
+	}
+	//#endregion
 	//#region src/browser/description.ts
 	function discribableAttributes(element) {
 		return { description: resolveDescription(element) };
@@ -599,8 +605,7 @@
 		if (!(element instanceof HTMLSelectElement)) return resolveAccessibleTextContent(element);
 		const selectedLabels = Array.from(element.selectedOptions).map((option) => option.label);
 		if (selectedLabels.length === 0) return;
-		if (selectedLabels.length === 1) return selectedLabels.at(0);
-		return selectedLabels;
+		return unwrapSingleItem(selectedLabels);
 	}
 	function snapshotOptions(element) {
 		const optionsContainer = resolveOptionsContainer(element);

package/dist/index.d.mts

@@ -17,7 +17,7 @@ interface MarkdownTableSnapshotOptions {
 /**
  * Creates a Markdown table snapshot from a table or grid element
  */
-declare function markdownTableSnapshot(locator: Locator, options?: MarkdownTableSnapshotOptions): Promise<string>;
+export declare function markdownTableSnapshot(locator: Locator, options?: MarkdownTableSnapshotOptions): Promise<string>;
 //#endregion
 //#region src/types/attributes.d.ts
 interface DisableableAttributes {
@@ -54,7 +54,7 @@ type SetValues<TSet> = TSet extends Set<infer TValue> ? TValue : never;
 type PlaywrightTarget = Page | Locator;
 //#endregion
 //#region src/types/elements/container.d.ts
-declare const CONTAINER_ROLES: Set<"alert" | "article" | "banner" | "blockquote" | "code" | "complementary" | "contentinfo" | "definition" | "deletion" | "descriptionlist" | "emphasis" | "form" | "grid" | "insertion" | "label" | "list" | "listbox" | "listitem" | "log" | "main" | "mark" | "menu" | "navigation" | "note" | "paragraph" | "row" | "rowgroup" | "search" | "status" | "strong" | "subscript" | "superscript" | "table" | "tablist" | "tabpanel" | "term" | "tree">;
+declare const CONTAINER_ROLES: Set<"alert" | "article" | "banner" | "blockquote" | "code" | "complementary" | "contentinfo" | "definition" | "deletion" | "descriptionlist" | "emphasis" | "form" | "grid" | "insertion" | "label" | "list" | "listbox" | "listitem" | "log" | "main" | "mark" | "menu" | "navigation" | "note" | "paragraph" | "row" | "rowgroup" | "search" | "status" | "strong" | "subscript" | "superscript" | "table" | "tablist" | "tabpanel" | "term" | "toolbar" | "tree">;
 interface ContainerSnapshot extends GenericElementSnapshot<ContainerRole> {}
 type ContainerRole = SetValues<typeof CONTAINER_ROLES>;
 interface RegionSnapshot extends GenericElementSnapshot<"region"> {}
@@ -208,12 +208,12 @@ interface FilterBaseOptions {
 /**
  * Filters node snapshots based on the provided predicate function
  */
-declare function filter<TSnapshot extends NodeSnapshot = NodeSnapshot>(options: GuardedFilterOptions<TSnapshot>): Array<TSnapshot>;
-declare function filter(options: FilterOptions): Array<NodeSnapshot>;
+export declare function filter<TSnapshot extends NodeSnapshot = NodeSnapshot>(options: GuardedFilterOptions<TSnapshot>): Array<TSnapshot>;
+export declare function filter(options: FilterOptions): Array<NodeSnapshot>;
 /**
  * Filters node snapshots by a specific role
  */
-declare function filterByRole<TRole extends NodeRole>(role: TRole, snapshots: Array<NodeSnapshot>): Array<SnapshotByRole<TRole>>;
+export declare function filterByRole<TRole extends NodeRole>(role: TRole, snapshots: Array<NodeSnapshot>): Array<SnapshotByRole<TRole>>;
 //#endregion
 //#region src/playwright/snapshot.d.ts
 interface SemanticSnapshotOptions {
@@ -267,7 +267,7 @@ interface SemanticSnapshotOptions {
  * @param options - Optional configuration settings for controlling the snapshot behavior
  * @return A promise that resolves to the semantic snapshot
  */
-declare function semanticSnapshot(target: PlaywrightTarget, options?: SemanticSnapshotOptions): Promise<unknown>;
+export declare function semanticSnapshot(target: PlaywrightTarget, options?: SemanticSnapshotOptions): Promise<unknown>;
 /**
  * Captures a raw snapshot of the element matched by the provided locator.
  *
@@ -277,7 +277,7 @@ declare function semanticSnapshot(target: PlaywrightTarget, options?: SemanticSn
  * @param target - The Page or Locator instance used to identify the target element to snapshot
  * @return A promise that resolves to an array of NodeSnapshot objects representing the captured element
  */
-declare function rawSnapshot(target: PlaywrightTarget): Promise<Array<NodeSnapshot>>;
+export declare function rawSnapshot(target: PlaywrightTarget): Promise<Array<NodeSnapshot>>;
 //#endregion
 //#region src/types/matchers.d.ts
 interface ElementSnapshotMatchers {
@@ -294,7 +294,7 @@ interface MatchMarkdownTableSnapshotFileOptions extends Omit<PlaywrightMatchText
  * @param {PlaywrightValidationFileMatcherConfig} config - Configuration options for file matching behavior
  * @return {Expect<ElementSnapshotMatchers>} An extended expect instance that includes matcher methods for element snapshot validation.
  */
-declare function defineElementSnapshotMatchers(config?: PlaywrightValidationFileMatcherConfig): Expect<ElementSnapshotMatchers>;
+export declare function defineElementSnapshotMatchers(config?: PlaywrightValidationFileMatcherConfig): Expect<ElementSnapshotMatchers>;
 //#endregion
 //#region src/transformers/combobox-transformer.d.ts
 interface ComboboxTransformerOptions {
@@ -311,22 +311,22 @@ interface ComboboxTransformerOptions {
  *
  * Empty option lists are always omitted.
  */
-declare function comboboxTransformer(options?: ComboboxTransformerOptions): RoleBasedSnapshotTransformer<"combobox">;
+export declare function comboboxTransformer(options?: ComboboxTransformerOptions): RoleBasedSnapshotTransformer<"combobox">;
 //#endregion
 //#region src/utils/predicates.d.ts
 /**
  * Include only elements with the specified role
  */
-declare function includeRole<TRole extends NodeRole>(role: TRole | Array<TRole>): GuardedFilterPredicate<SnapshotByRole<TRole>>;
+export declare function includeRole<TRole extends NodeRole>(role: TRole | Array<TRole>): GuardedFilterPredicate<SnapshotByRole<TRole>>;
 /**
  * Exclude elements with the specified role
  */
-declare function excludeRole<TRole extends NodeRole>(role: TRole | Array<TRole>): GuardedFilterPredicate<SnapshotByRole<TRole>>;
+export declare function excludeRole<TRole extends NodeRole>(role: TRole | Array<TRole>): GuardedFilterPredicate<SnapshotByRole<TRole>>;
 //#endregion
 //#region src/utils/text.d.ts
 /**
  * Aggregates and normalizes the text content of all provided snapshots
  */
-declare function getTextContent(snapshots: Array<NodeSnapshot>): string;
+export declare function getTextContent(snapshots: Array<NodeSnapshot>): string;
 //#endregion
-export { type ButtonSnapshot, type CellSnapshot, type ColumnHeaderSnapshot, type ComboboxSnapshot, type ComboboxTransformerOptions, type ContainerSnapshot, type DefaultSnapshotTransformer, type DialogSnapshot, type ElementRole, type ElementSnapshot, type ElementSnapshotMatchers, type GroupSnapshot, type HeadingSnapshot, type ImageSnapshot, type InputSnapshot, type LinkSnapshot, type MarkdownTableSnapshotOptions, type MatchMarkdownTableSnapshotFileOptions, type MatchSemanticSnapshotFileOptions, type MenuItemSnapshot, type NodeRole, type NodeSnapshot, type OptionSnapshot, type ProgressbarSnapshot, type RadioGroupSnapshot, type RegionSnapshot, type RoleBasedSnapshotTransformer, type RoleBasedSnapshotTransformers, type SemanticSnapshotOptions, type SeparatorSnapshot, type SnapshotByRole, type SnapshotTransformer, type SnapshotTransformerContext, type TabSnapshot, type TextSnapshot, type TreeItemSnapshot, comboboxTransformer, defineElementSnapshotMatchers, excludeRole, filter, filterByRole, getTextContent, includeRole, markdownTableSnapshot, rawSnapshot, semanticSnapshot };
+export type { ButtonSnapshot, CellSnapshot, ColumnHeaderSnapshot, ComboboxSnapshot, ComboboxTransformerOptions, ContainerSnapshot, DefaultSnapshotTransformer, DialogSnapshot, ElementRole, ElementSnapshot, ElementSnapshotMatchers, GroupSnapshot, HeadingSnapshot, ImageSnapshot, InputSnapshot, LinkSnapshot, MarkdownTableSnapshotOptions, MatchMarkdownTableSnapshotFileOptions, MatchSemanticSnapshotFileOptions, MenuItemSnapshot, NodeRole, NodeSnapshot, OptionSnapshot, ProgressbarSnapshot, RadioGroupSnapshot, RegionSnapshot, RoleBasedSnapshotTransformer, RoleBasedSnapshotTransformers, SemanticSnapshotOptions, SeparatorSnapshot, SnapshotByRole, SnapshotTransformer, SnapshotTransformerContext, TabSnapshot, TextSnapshot, TreeItemSnapshot };

package/dist/index.mjs

@@ -96,6 +96,11 @@ var ElementSnapshotProxy = class ElementSnapshotProxy {
 	}
 };
 //#endregion
+//#region src/utils/array.ts
+function unwrapSingleItem(items) {
+	return items.length === 1 ? items.at(0) : items;
+}
+//#endregion
 //#region src/transformers/semantic-snapshot-transformer.ts
 function semanticSnapshotTransformer(snapshot, context) {
 	if (snapshot.role === "text") return snapshot.name;
@@ -113,12 +118,12 @@ function transformElementSnapshot(snapshot, transformRecursive) {
 	}
 	if (hasOnlyChildren(normalizedSnapshot)) {
 		const { role, children } = normalizedSnapshot;
-		return transformedSnapshot(role, children.length === 1 ? children.at(0) : children);
+		return transformedSnapshot(role, unwrapSingleItem(children));
 	}
 	const { role, name, attributes, children } = normalizedSnapshot;
 	return transformedSnapshot(role, name, {
 		...attributes,
-		children: children.length === 0 ? void 0 : children
+		children: isEmpty(children) ? void 0 : unwrapSingleItem(children)
 	});
 }
 function normalizeElementSnapshot(snapshot, transformRecursive) {
@@ -195,9 +200,7 @@ var SnapshotSerializer = class {
 		this.defaultTransformer = options.defaultTransformer ?? semanticSnapshotTransformer;
 	}
 	transform(snapshots) {
-		const transformedSnapshots = this.filterSnapshots(snapshots).map(this.transformSnapshotRecursive);
-		if (transformedSnapshots.length === 1) return transformedSnapshots.at(0);
-		return transformedSnapshots;
+		return unwrapSingleItem(this.filterSnapshots(snapshots).map(this.transformSnapshotRecursive));
 	}
 	filterSnapshots(snapshots) {
 		if (this.filter === void 0) return snapshots;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cronn/element-snapshot",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "Element snapshots for Playwright",
   "homepage": "https://cronn.github.io/file-snapshots/playwright/element-snapshots/",
   "bugs": {
@@ -33,22 +33,21 @@
     "@arethetypeswrong/core": "0.18.5",
     "@cronn/shared-configs": "0.0.0",
     "@cronn/test-utils": "0.0.0",
-    "@cronn/vitest-file-snapshots": "2.1.3",
-    "@playwright/test": "1.62.1",
-    "@types/node": "24.13.3",
+    "@cronn/vitest-file-snapshots": "3.0.0",
+    "@playwright/test": "1.63.0",
+    "@types/node": "24.13.4",
     "@typescript/native": "npm:typescript@^7.0.2",
-    "@vitest/coverage-v8": "4.1.11",
-    "eslint": "10.9.1",
+    "@vitest/coverage-v8": "5.0.0",
+    "eslint": "10.10.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-check-file": "3.3.2",
     "eslint-plugin-unused-imports": "4.4.1",
     "publint": "0.3.24",
     "rimraf": "6.1.3",
-    "tsdown": "0.22.14",
+    "tsdown": "0.23.0",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "typescript-eslint": "8.68.0",
-    "vitest": "4.1.11",
-    "node": "runtime:24.20.0"
+    "typescript-eslint": "8.70.0",
+    "vitest": "5.0.0"
   },
   "peerDependencies": {
     "@playwright/test": "^1.55"
@@ -56,12 +55,12 @@
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
-      "version": "11.25.0",
+      "version": "12.6.0",
       "onFail": "download"
     },
     "runtime": {
       "name": "node",
-      "version": "24.20.0",
+      "version": "24.21.0",
       "onFail": "download"
     }
   },