From b8a1bf63999452e705976b0b672a80973a52d4ce Mon Sep 17 00:00:00 2001
From: u8array <alexanderleinich1@gmail.com>
Date: Tue, 5 May 2026 22:50:23 +0200
Subject: [PATCH 1/2] fix: hide HRI checkbox and rendering for symbologies
 without ZPL HRI support

---
 src/components/Canvas/BarcodeObject.tsx | 14 ++++++++------
 src/registry/barcode1d.tsx              | 25 +++++++++++++++----------
 src/registry/gs1databar.tsx             |  2 ++
 src/types/ObjectType.ts                 |  7 +++++++
 4 files changed, 32 insertions(+), 16 deletions(-)

diff --git a/src/components/Canvas/BarcodeObject.tsx b/src/components/Canvas/BarcodeObject.tsx
index 470ff060..4864c430 100644
--- a/src/components/Canvas/BarcodeObject.tsx
+++ b/src/components/Canvas/BarcodeObject.tsx
@@ -3,7 +3,7 @@ import bwipjs from "bwip-js/browser";
 import { Image as KImage, Group, Rect, Text } from "react-konva";
 import type Konva from "konva";
 import type { LabelObject } from "../../registry";
-import { BARCODE_1D_TYPES } from "../../registry";
+import { BARCODE_1D_TYPES, ObjectRegistry } from "../../registry";
 import type { ObjectChanges } from "../../store/labelStore";
 import { dotsToPx, pxToDots } from "../../lib/coordinates";
 import {
@@ -144,8 +144,12 @@ export function BarcodeObject({
   if (barcodeCanvas) {
     const w = displayW;
     const h = displayH;
-    const printInterp = !!(obj.props as { printInterpretation?: boolean })
-      .printInterpretation;
+    // Force-off when the symbology has no HRI in ZPL (e.g. GS1 Databar) — the
+    // canvas must match the print output even if a legacy saved object still
+    // carries printInterpretation: true.
+    const printInterp =
+      !ObjectRegistry[obj.type]?.interpretationLocked &&
+      !!(obj.props as { printInterpretation?: boolean }).printInterpretation;
     const moduleWidth =
       (obj.props as { moduleWidth?: number }).moduleWidth ?? 2;
     const textFontSize = Math.max(dotsToPx(moduleWidth * 10, scale, dpmm), 6);
@@ -435,9 +439,7 @@ export function BarcodeObject({
     }
 
     // ── Other 1D: separate Konva Text below bars ──────────────────────────
-    const showText =
-      BARCODE_1D_TYPES.has(obj.type) &&
-      (obj.props as { printInterpretation?: boolean }).printInterpretation;
+    const showText = BARCODE_1D_TYPES.has(obj.type) && printInterp;
 
     let displayText = rawContent;
     if (obj.type === "code39") {
diff --git a/src/registry/barcode1d.tsx b/src/registry/barcode1d.tsx
index 88fa809a..8a8f24a7 100644
--- a/src/registry/barcode1d.tsx
+++ b/src/registry/barcode1d.tsx
@@ -32,6 +32,8 @@ interface Barcode1DConfig {
   byRatio?: number;
   /** See {@link ObjectTypeDefinition.heightLocked}. */
   heightLocked?: boolean;
+  /** See {@link ObjectTypeDefinition.interpretationLocked}. */
+  interpretationLocked?: boolean;
 }
 
 interface BarcodeLocale {
@@ -52,11 +54,12 @@ export function createBarcode1D(config: Barcode1DConfig): ObjectTypeDefinition<B
       content: config.defaultContent,
       height: 100,
       moduleWidth: 2,
-      printInterpretation: true,
+      printInterpretation: !config.interpretationLocked,
       checkDigit: false,
     },
     defaultSize: { width: 300, height: 120 },
     heightLocked: config.heightLocked,
+    interpretationLocked: config.interpretationLocked,
 
     commitTransform: config.heightLocked ? undefined : commitHeightTransform,
 
@@ -115,15 +118,17 @@ export function createBarcode1D(config: Barcode1DConfig): ObjectTypeDefinition<B
             />
           </div>
 
-          <label className="flex items-center gap-2 cursor-pointer">
-            <input
-              type="checkbox"
-              className="accent-accent"
-              checked={p.printInterpretation}
-              onChange={(e) => onChange({ printInterpretation: e.target.checked })}
-            />
-            <span className={labelCls}>{loc.printInterpretation}</span>
-          </label>
+          {!config.interpretationLocked && (
+            <label className="flex items-center gap-2 cursor-pointer">
+              <input
+                type="checkbox"
+                className="accent-accent"
+                checked={p.printInterpretation}
+                onChange={(e) => onChange({ printInterpretation: e.target.checked })}
+              />
+              <span className={labelCls}>{loc.printInterpretation}</span>
+            </label>
+          )}
 
           {config.hasCheckDigit && (
             <label className="flex items-center gap-2 cursor-pointer">
diff --git a/src/registry/gs1databar.tsx b/src/registry/gs1databar.tsx
index 7f96553b..ac1727a1 100644
--- a/src/registry/gs1databar.tsx
+++ b/src/registry/gs1databar.tsx
@@ -12,6 +12,8 @@ export const gs1databar = createBarcode1D({
   // ignore the ^BR height parameter for this variant. Disabling resize and the
   // height input keeps the designer honest about what affects the print.
   heightLocked: true,
+  // ZPL ^BR has no HRI parameter — Labelary never prints text under the bars.
+  interpretationLocked: true,
   zplCommand: (p) => {
     // ^BR{orientation},{symbology},{magnification},{separator},{height},{segments}
     // symbology 1 = omnidirectional
diff --git a/src/types/ObjectType.ts b/src/types/ObjectType.ts
index ddbfb71b..6bbec1c3 100644
--- a/src/types/ObjectType.ts
+++ b/src/types/ObjectType.ts
@@ -64,6 +64,13 @@ export interface ObjectTypeDefinition<P extends object = object> {
    * read-only — both reflect that the value cannot influence the print output.
    */
   heightLocked?: boolean;
+  /**
+   * True if the symbology has no human-readable interpretation in ZPL output
+   * (e.g. GS1 Databar — `^BR` exposes no HRI parameter and Labelary never
+   * renders text). The properties panel hides the checkbox and the canvas
+   * renderer suppresses the text so the designer matches the print output.
+   */
+  interpretationLocked?: boolean;
   toZPL: (obj: LabelObjectBase & { props: P }) => string;
   /**
    * Optional hook to enforce type-specific invariants on incoming changes

From 36215c6cb47955bee5456d0e6ef5aee1289bfae9 Mon Sep 17 00:00:00 2001
From: u8array <alexanderleinich1@gmail.com>
Date: Tue, 5 May 2026 23:06:48 +0200
Subject: [PATCH 2/2] fix: enforce interpretationLocked in toZPL to neutralize
 legacy prop values

---
 src/registry/barcode1d.tsx | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/registry/barcode1d.tsx b/src/registry/barcode1d.tsx
index 8a8f24a7..6ee04215 100644
--- a/src/registry/barcode1d.tsx
+++ b/src/registry/barcode1d.tsx
@@ -64,7 +64,12 @@ export function createBarcode1D(config: Barcode1DConfig): ObjectTypeDefinition<B
     commitTransform: config.heightLocked ? undefined : commitHeightTransform,
 
     toZPL: (obj: LabelObjectBase & { props: Barcode1DProps }) => {
-      const p = obj.props;
+      // Normalize printInterpretation for symbologies that have no HRI in ZPL
+      // (e.g. ^BR). This protects against legacy saved objects that still carry
+      // printInterpretation: true from emitting an out-of-spec interpretation flag.
+      const p = config.interpretationLocked
+        ? { ...obj.props, printInterpretation: false }
+        : obj.props;
       const byCmd = config.byRatio !== undefined
         ? `^BY${p.moduleWidth},${config.byRatio}`
         : `^BY${p.moduleWidth}`;