@wix/zero-config-implementation 1.48.0 → 1.49.0

package/package.json

@@ -4,7 +4,7 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "1.48.0",
+  "version": "1.49.0",
   "description": "Core library for extracting component manifests from JS and CSS files",
   "type": "module",
   "main": "dist/index.js",
@@ -85,5 +85,5 @@
       ]
     }
   },
-  "falconPackageHash": "8fd0a1265e02ba71d5ed24fddbddbf66183b17ff76ac71ce067af6c6"
+  "falconPackageHash": "54ff02d476b1c16a5fa7e9f8dbb1eb74a6011ac62dcee23ecc6301be"
 }

package/src/converters/a11y-builder.ts

@@ -0,0 +1,25 @@
+import { DATA } from '@wix/react-component-schema'
+import type { TrackingStores } from '../information-extractors/react'
+
+/**
+ * Walks the known A11y attributes (from DATA.A11Y_ATTRIBUTES) in deterministic
+ * enum order and returns the subset whose `${propPath}.${attribute}` key was
+ * recorded in propUsages by the prop-tracker. When propUsages or propPath is
+ * unavailable, returns an empty array — per the schema, an empty list means
+ * "all possible A11Y values", which is a safe default.
+ */
+export function collectUsedA11yAttributes(
+  propUsages: TrackingStores['propUsages'] | undefined,
+  propPath: string | undefined,
+): (typeof DATA.A11Y_ATTRIBUTES)[keyof typeof DATA.A11Y_ATTRIBUTES][] {
+  if (!propUsages || !propPath) return []
+
+  const used: (typeof DATA.A11Y_ATTRIBUTES)[keyof typeof DATA.A11Y_ATTRIBUTES][] = []
+  for (const attribute of Object.values(DATA.A11Y_ATTRIBUTES)) {
+    if (attribute === DATA.A11Y_ATTRIBUTES.Unknown_AriaAttributes) continue
+    if (propUsages.has(`${propPath}.${attribute}`)) {
+      used.push(attribute)
+    }
+  }
+  return used
+}

package/src/converters/data-item-builder.ts

@@ -20,6 +20,7 @@ import { ParseError } from '../errors'
 import type { DOMBinding, TrackingStores } from '../information-extractors/react'
 import type { PropInfo, ResolvedType } from '../information-extractors/ts/types'
 import { WIX_TYPE_TO_DATA_TYPE } from '../wix-type-to-data-type'
+import { collectUsedA11yAttributes } from './a11y-builder'
 import { formatDisplayName } from './utils'
 
 const { DATA_TYPE } = DATA
@@ -120,7 +121,7 @@ function applyResolvedTypeToDataItem(
       return ok(undefined)
 
     case 'semantic':
-      handleSemanticType(dataItem, resolvedType)
+      handleSemanticType({ dataItem, resolvedType, propUsages, propPath })
       return ok(undefined)
 
     default:
@@ -343,7 +344,17 @@ function handleUnionType(
  * Handles semantic types from React and @wix/public-schemas packages.
  * Unknown semantic sources or types silently fall back to text.
  */
-function handleSemanticType(dataItem: DataItem, resolvedType: ResolvedType): void {
+function handleSemanticType({
+  dataItem,
+  resolvedType,
+  propUsages,
+  propPath,
+}: {
+  dataItem: DataItem
+  resolvedType: ResolvedType
+  propUsages?: TrackingStores['propUsages']
+  propPath?: string
+}): void {
   const semanticValue = resolvedType.value as string
   const source = resolvedType.source
 
@@ -363,7 +374,7 @@ function handleSemanticType(dataItem: DataItem, resolvedType: ResolvedType): voi
     const dataTypeKey = WIX_TYPE_TO_DATA_TYPE[semanticValue]
     if (dataTypeKey) {
       dataItem.dataType = DATA_TYPE[dataTypeKey]
-      applyDataToBuilderType(dataItem, dataTypeKey)
+      applyDataToBuilderType({ dataItem, builderType: dataTypeKey, propUsages, propPath })
     } else {
       // Unknown Wix semantic type — silently fall back to text
       dataItem.dataType = DATA_TYPE.text
@@ -414,8 +425,20 @@ function handleFunctionType(dataItem: DataItem, propInfo: PropInfo, bindings?: D
 
 /**
  * Applies special data to builder types if required (e.g., link types, image category).
+ * For `a11y`, the list of attributes is built from the prop-tracker's propUsages so
+ * only fields actually read in JSX are included.
  */
-function applyDataToBuilderType(dataItem: DataItem, builderType: keyof typeof DATA_TYPE): void {
+function applyDataToBuilderType({
+  dataItem,
+  builderType,
+  propUsages,
+  propPath,
+}: {
+  dataItem: DataItem
+  builderType: keyof typeof DATA_TYPE
+  propUsages?: TrackingStores['propUsages']
+  propPath?: string
+}): void {
   switch (builderType) {
     case 'link':
       dataItem.dataType = DATA_TYPE.link
@@ -442,5 +465,11 @@ function applyDataToBuilderType(dataItem: DataItem, builderType: keyof typeof DA
         category: MEDIA.IMAGE_CATEGORY.IMAGE,
       }
       break
+    case 'a11y':
+      dataItem.dataType = DATA_TYPE.a11y
+      dataItem.a11y = {
+        attributes: collectUsedA11yAttributes(propUsages, propPath),
+      }
+      break
   }
 }

package/src/information-extractors/react/utils/mock-generator.ts

@@ -91,7 +91,7 @@ function generateValueFromResolvedType(
 
   // Handle semantic types (from React or Wix packages) — returned as plain objects
   if (kind === 'semantic') {
-    return generateSemanticValue(resolvedType.value as string, propName)
+    return generateSemanticValue(resolvedType.value as string, propName, path, registrar)
   }
 
   // Handle structural types
@@ -129,7 +129,12 @@ function generateValueFromResolvedType(
 /**
  * Generate a mock value for semantic types (React or Wix types)
  */
-function generateSemanticValue(semanticType: string, propName: string): unknown {
+function generateSemanticValue(
+  semanticType: string,
+  propName: string,
+  path: string,
+  registrar?: PropSpyRegistrar,
+): unknown {
   switch (semanticType) {
     // Wix semantic types
     case 'Image':
@@ -141,7 +146,7 @@ function generateSemanticValue(semanticType: string, propName: string): unknown
     case 'Link':
       return generateMockLink()
     case 'A11y':
-      return generateMockA11y()
+      return generateMockA11y(path, registrar)
     case 'VectorArt':
       return generateMockVectorArt()
     case 'Audio':
@@ -378,12 +383,57 @@ function generateMockLink(): Record<string, unknown> {
   }
 }
 
-function generateMockA11y(): Record<string, unknown> {
-  return {
-    ariaLabel: `mock_ariaLabel_${faker.string.alphanumeric(6)}`,
-    role: faker.helpers.arrayElement(['button', 'link', 'img', 'region']),
-    tabIndex: faker.helpers.arrayElement([0, -1]),
+// String fields and string-literal-union fields of @wix/public-schemas A11y.
+// These are emitted as unique trackable strings — DOM/React will accept any
+// string for `aria-*` attributes regardless of the TS type union, so the spy
+// markers flow through unchanged and the prop-tracker can detect usage.
+const A11Y_STRING_FIELDS = [
+  'ariaExpanded',
+  'ariaDisabled',
+  'ariaAtomic',
+  'ariaHidden',
+  'ariaBusy',
+  'ariaAutocomplete',
+  'ariaPressed',
+  'ariaHaspopup',
+  'ariaRelevant',
+  'role',
+  'ariaLive',
+  'ariaCurrent',
+  'ariaLabel',
+  'ariaRoledescription',
+  'ariaDescribedby',
+  'ariaLabelledby',
+  'ariaErrormessage',
+  'ariaOwns',
+  'ariaControls',
+  'tag',
+  'ariaMultiline',
+  'ariaInvalid',
+] as const
+
+// Numeric fields of @wix/public-schemas A11y.
+const A11Y_NUMBER_FIELDS = ['tabIndex', 'ariaLevel'] as const
+
+// Pure-boolean A11y fields (e.g. `multiline`) are intentionally omitted: the
+// runtime spy tracker only registers strings, numbers and functions, so plain
+// booleans cannot be tied back to a specific prop field.
+function generateMockA11y(path: string, registrar?: PropSpyRegistrar): Record<string, unknown> {
+  const a11y: Record<string, unknown> = {}
+
+  for (const field of A11Y_STRING_FIELDS) {
+    const value = `mock_a11y_${field}_${faker.string.alphanumeric(6)}`
+    if (registrar) registrar.registerString(`${path}.${field}`, field, value)
+    a11y[field] = value
+  }
+
+  for (const field of A11Y_NUMBER_FIELDS) {
+    const value = nextTraceableNumber()
+    if (registrar) registrar.registerNumber(`${path}.${field}`, field, value)
+    a11y[field] = value
   }
+
+  return a11y
 }
 
 function generateMockVectorArt(): Record<string, unknown> {