feat(barcode-generator-web): add Data Matrix config model and validation

Adds DataMatrixTypeConfig to the BarcodeConfig union with a
format === "DataMatrix" branch in barcodeConfig(), plus a DataMatrix
value check and a loose GS1 Application Identifier syntax validator.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: samuelreichert

packages/pluggableWidgets/barcode-generator-web/src/config/Barcode.config.ts

@@ -55,7 +55,15 @@ export interface QRCodeTypeConfig extends CodeBaseTypeConfig {
     };
 }
 
-export type BarcodeConfig = BarcodeTypeConfig | QRCodeTypeConfig;
+/** Configuration for Data Matrix rendering */
+export interface DataMatrixTypeConfig extends CodeBaseTypeConfig {
+    type: "datamatrix";
+    size: number;
+    gs1Mode: boolean;
+    shape: "square" | "rectangle";
+}
+
+export type BarcodeConfig = BarcodeTypeConfig | QRCodeTypeConfig | DataMatrixTypeConfig;
 
 export function barcodeConfig(props: BarcodeGeneratorContainerProps): BarcodeConfig {
     const codeValue = props.codeValue?.value ?? "";
@@ -77,6 +85,16 @@ export function barcodeConfig(props: BarcodeGeneratorContainerProps): BarcodeCon
         downloadButton: downloadButtonConfig
     };
 
+    if (format === "DataMatrix") {
+        return {
+            type: "datamatrix",
+            ...baseConfig,
+            size: props.dmSize ?? 128,
+            gs1Mode: props.dmGs1Mode ?? false,
+            shape: props.dmShape ?? "square"
+        };
+    }
+
     if (format === "QRCode") {
         return {
             type: "qrcode",

packages/pluggableWidgets/barcode-generator-web/src/config/validation.ts

@@ -114,6 +114,15 @@ export function validateBarcodeValue(format: CustomCodeFormatEnum | CodeFormatEn
                 return { valid: false, message: "CODE93 should not contain control characters." };
             }
             return { valid: true };
+        case "DataMatrix":
+            // DataMatrix: encoder handles the heavy lifting; guard extremely long static values
+            if (value.length > 2000) {
+                return {
+                    valid: false,
+                    message: "The Data Matrix value is very long; consider a shorter value or a dynamic attribute."
+                };
+            }
+            return { valid: true };
         case "QRCode":
             // QRCode: accepts most characters, but warn for extremely long static values
             if (value.length > 1200) {
@@ -140,6 +149,33 @@ export function validateBarcodeValue(format: CustomCodeFormatEnum | CodeFormatEn
     }
 }
 
+/**
+ * Loosely validate GS1 Data Matrix Application Identifier syntax.
+ * Expects human-readable AI form, e.g. `(01)09501101020917(17)261231(10)ABC123`.
+ * bwip-js is the source of truth for encoding; this catches obvious structural errors early.
+ */
+export function validateGs1DataMatrixValue(value: string): ValidationResult {
+    if (!value) {
+        return { valid: true };
+    }
+
+    // Must start with an application identifier and contain only balanced (nn) groups with data.
+    if (!/^(\(\d{2,4}\)[^(]*)+$/.test(value)) {
+        return {
+            valid: false,
+            message:
+                "GS1 Data Matrix expects Application Identifier syntax, e.g. (01)09501101020917(17)261231(10)ABC123."
+        };
+    }
+
+    // Every AI group must carry at least one data character.
+    if (/\(\d{2,4}\)(?=\(|$)/.test(value)) {
+        return { valid: false, message: "Each GS1 Application Identifier must be followed by data." };
+    }
+
+    return { valid: true };
+}
+
 /** Validate addon (EAN-5 / EAN-2) values. */
 export function validateAddonValue(addonFormat: AddonFormatEnum | null | undefined, value: string): ValidationResult {
     if (!addonFormat || addonFormat === "None") {