feat(setup): printer-native font downloads replay as sent from the profile

Author: u8array

README.md

@@ -186,7 +186,7 @@ On desktop, **File → Settings… → App → MCP** starts a local MCP server,
 ## Coverage
 
 <!-- coverage:start (generated from the command catalog by scripts/gen-coverage.mjs; run `pnpm coverage:gen`) -->
-120 of the 225 ZPL II commands are modelled in the browser; desktop covers 2 more with a connected printer. 2 more are planned for both builds. 79 need a connected printer and are planned for desktop. The source editor checks parameters for 1 command. See per-command coverage: [docs/zpl-coverage.md](docs/zpl-coverage.md).
+125 of the 225 ZPL II commands are modelled in the browser; desktop covers 2 more with a connected printer. 2 more are planned for both builds. 74 need a connected printer and are planned for desktop. The source editor checks parameters for 1 command. See per-command coverage: [docs/zpl-coverage.md](docs/zpl-coverage.md).
 
 | Area | Modelled |
 |---|---|
@@ -200,7 +200,7 @@ On desktop, **File → Settings… → App → MCP** starts a local MCP server,
 | Identity & access | 2 / 2 |
 | Graphics | 10 / 14 |
 | Media & feed | 9 / 9 |
-| Text & fonts | 9 / 15 |
+| Text & fonts | 14 / 15 |
 | Print quality | 10 / 18 |
 | Configuration & persistence | 4 / 5 |
 | Hardware / Host comm / RFID / Network | 4 / 89 |

docs/zpl-coverage.md

@@ -80,11 +80,11 @@ never share. The row total is pinned in `packages/core/src/catalog/catalog.test.
 | `^CO` | font cache size | `[x]` | `[x]` | `[ ]` |
 | `^FL` | font linking | `[x]` | `[x]` | `[ ]` |
 | `^LF` | list font links | `[ ]` | `[~]` | `[ ]` |
-| `~DB` | download bitmap font | `[ ]` | `[~]` | `[ ]` |
-| `~DS` | download scalable font | `[ ]` | `[~]` | `[ ]` |
-| `~DT` | download TrueType font | `[ ]` | `[~]` | `[ ]` |
-| `~DU` | download unbounded TrueType | `[ ]` | `[~]` | `[ ]` |
-| `~DE` | download encoding | `[ ]` | `[~]` | `[ ]` |
+| `~DB` | download bitmap font | `[x]` | `[x]` | `[ ]` |
+| `~DS` | download scalable font | `[x]` | `[x]` | `[ ]` |
+| `~DT` | download TrueType font | `[x]` | `[x]` | `[ ]` |
+| `~DU` | download unbounded TrueType | `[x]` | `[x]` | `[ ]` |
+| `~DE` | download encoding | `[x]` | `[x]` | `[ ]` |
 
 ## Barcodes
 

packages/core/src/catalog/commands.json

@@ -663,8 +663,8 @@
       "title": "download bitmap font",
       "summary": "Downloads a bitmap font and its metrics into printer memory.",
       "support": {
-        "web": "no",
-        "desktop": "planned",
+        "web": "yes",
+        "desktop": "yes",
         "lint": "no"
       }
     },
@@ -677,8 +677,8 @@
       "title": "download scalable font",
       "summary": "Downloads an encoded scalable Intellifont into printer memory.",
       "support": {
-        "web": "no",
-        "desktop": "planned",
+        "web": "yes",
+        "desktop": "yes",
         "lint": "no"
       }
     },
@@ -691,8 +691,8 @@
       "title": "download TrueType font",
       "summary": "Downloads an encoded TrueType font with up to 256 characters into printer memory.",
       "support": {
-        "web": "no",
-        "desktop": "planned",
+        "web": "yes",
+        "desktop": "yes",
         "lint": "no"
       }
     },
@@ -705,8 +705,8 @@
       "title": "download unbounded TrueType",
       "summary": "Downloads an encoded TrueType font with more than 256 glyphs into printer memory.",
       "support": {
-        "web": "no",
-        "desktop": "planned",
+        "web": "yes",
+        "desktop": "yes",
         "lint": "no"
       }
     },
@@ -719,8 +719,8 @@
       "title": "download encoding",
       "summary": "Downloads an encoding table that maps field-data bytes to Unicode values for TrueType fonts.",
       "support": {
-        "web": "no",
-        "desktop": "planned",
+        "web": "yes",
+        "desktop": "yes",
         "lint": "no"
       }
     },

packages/core/src/catalog/schema.ts

@@ -6,7 +6,7 @@ const SUPPORT_LEVELS = ["yes", "planned", "no"] as const;
 export type SupportLevel = (typeof SUPPORT_LEVELS)[number];
 
 /** What a partial import drops; the app maps each cause to its report wording. */
-const IMPORT_LOSS_CAUSES = ["fontFace", "printerComms", "gfRawBinary", "qrFdMode", "storedGraphic", "shortPayload", "recallMagnification", "checksumMismatch", "oversizeUpload", "unshippableUpload", "bitmapFont", "scalableFont", "unshippableFontName", "unshippableGraphicName", "fontNameNotTrueType", "fontVersionReplaced", "fnPartialInsert", "recallFormat", "recallSlot", "recallSettings"] as const;
+const IMPORT_LOSS_CAUSES = ["fontFace", "printerComms", "gfRawBinary", "qrFdMode", "storedGraphic", "shortPayload", "recallMagnification", "checksumMismatch", "oversizeUpload", "oversizeFontUpload", "unreplayableUpload", "cachedFaceDropped", "unshippableUpload", "unshippableFontName", "unshippableGraphicName", "fontVersionReplaced", "fnPartialInsert", "recallFormat", "recallSlot", "recallSettings"] as const;
 export type ImportLossCause = (typeof IMPORT_LOSS_CAUSES)[number];
 
 /** Support per axis; docs/zpl-coverage.md defines the three. */

packages/core/src/lib/zplCanonicalPrefixes.ts

@@ -1,7 +1,7 @@
 import { applyPrefixRemap, PAYLOAD_CMDS, tokenize, type TokenizerChars } from "./zplParser/helpers";
 
 /** Image and font payloads carry any byte, hex or binary, so their lines stay as typed. */
-const BYTE_PAYLOAD_CMDS = new Set(["GF", "DY", "DG", "DT", "DU", "DS", "DB"]);
+const BYTE_PAYLOAD_CMDS = new Set(["GF", "DY", "DG", "DT", "DU", "DS", "DB", "DE"]);
 
 /** The same bytes with ^CC/^CT/^CD undone: every live prefix back to ^ or ~ and every
  *  parameter delimiter to a comma, data left alone, so texts compare across a remap.

packages/core/src/lib/zplImportService.ts

@@ -9,7 +9,7 @@ import { newId } from "./ids";
 import type { ImportLossCause } from "../catalog";
 import { renameTemplateMarkers } from "./fnTemplate";
 import { PER_FORMAT_ZPL_FIELDS, effectiveDpmm, type CustomFontMapping, type JmDensity, type LabelConfig } from "../types/LabelConfig";
-import { isSetupPath, type PrinterProfile, type SetupGraphic } from "../types/PrinterProfile";
+import { isSetupDownload, isSetupPath, SETUP_UPLOAD_MAX_CHARS, type PrinterProfile, type SetupGraphic } from "../types/PrinterProfile";
 import { exportableLeaves, type LabelObject, type Page, isGroup } from "../types/Group";
 import { nextFreeFnNumber, uniqueVariableName, type ColumnMapping, type Variable } from "../types/Variable";
 import type { DatasetInput } from "../types/DataSource";
@@ -46,11 +46,16 @@ export interface ZplImportResult {
 
 const FONT_LOSS = {
   versionReplaced: "fontVersionReplaced",
-  bitmapFont: "bitmapFont",
-  scalableFont: "scalableFont",
-  notTrueTypeName: "fontNameNotTrueType",
+  faceDropped: "cachedFaceDropped",
 } as const satisfies Record<FontLossReason, ImportLossCause>;
 
+function fontRefusal(f: { path: string; download?: string }): ImportLossCause | undefined {
+  if (!isSetupPath(f.path)) return "unshippableFontName";
+  if (f.download === undefined) return undefined;
+  if (f.download.length > SETUP_UPLOAD_MAX_CHARS) return "oversizeFontUpload";
+  return isSetupDownload(f.download) ? undefined : "unreplayableUpload";
+}
+
 /** Document findings have no page, so the parser's partials map cannot dedup them. */
 function noteDocumentLoss(findings: ImportFinding[], command: string, loss: ImportLossCause, span?: SourceSpan): void {
   if (findings.some((f) => f.pageIndex === DOCUMENT_FINDING && f.command === command && f.loss === loss)) return;
@@ -305,20 +310,18 @@ function assembleImport(r: ParsedZPL, dpmm: number): ZplImportResult {
         }
       : undefined;
 
-  const uploadedUnique = [...new Set(r.uploadedFontPaths)];
   const printerProfile: Partial<PrinterProfile> = { ...r.printerProfile };
   // A design font claims only the upload it ships. An upload it merely references stays provisioning.
-  const setupFontPaths = uploadedUnique.filter((p) => !r.embeddedFontPaths.has(p));
+  const setupFonts = r.uploadedFonts.filter((f) => !r.embeddedFontPaths.has(f.path));
   for (const f of r.fontLosses) noteDocumentLoss(findings, f.command, FONT_LOSS[f.reason], f.span);
   // Refused here with a finding, or the whole profile patch fails and every field it carried drops in silence.
-  const carriedFontPaths = setupFontPaths.filter((path) => {
-    if (isSetupPath(path)) return true;
-    noteDocumentLoss(findings, "~DY", "unshippableFontName");
-    return false;
+  const carriedFonts = setupFonts.flatMap(({ via, ...f }) => {
+    const refusal = fontRefusal(f);
+    if (refusal === undefined) return [f];
+    noteDocumentLoss(findings, via, refusal);
+    return [];
   });
-  if (carriedFontPaths.length > 0) {
-    printerProfile.setupFonts = carriedFontPaths.map((path) => ({ path }));
-  }
+  if (carriedFonts.length > 0) printerProfile.setupFonts = carriedFonts;
   const shipped = new Set(
     r.pages.flatMap((page) => exportableLeaves(page.objects)).flatMap((leaf) => {
       const props = leaf.props as ImageProps;

packages/core/src/lib/zplParser.ts

@@ -169,7 +169,7 @@ export const DEVICE_ACTION_IDS: ReadonlySet<string> = new Set([
  *  in-span they make single-field regen unsafe (the span replace drops the
  *  definition). ^BY absent: consumers self-flag via sawBareBarcode; ^JM is
  *  legal pre-^FS, so it can sit in a field span too. */
-const PERSISTENT_DEF_CODES = new Set(["CF", "FW", "CW", "SO", "LH", "LT", "JM", "DG", "DY", "DT", "DU", "DS", "DB"]);
+const PERSISTENT_DEF_CODES = new Set(["CF", "FW", "CW", "SO", "LH", "LT", "JM", "DG", "DY", "DT", "DU", "DS", "DB", "DE"]);
 
 /** Why this page cannot be regenerated byte for byte, or undefined when it can.
  *  The overlay flag and the user-facing wording read the same derivation, so a
@@ -918,8 +918,9 @@ export function parseZPL(
     labelConfig.heightMm = labelMeta.value.heightMm;
   }
 
-  const liveFontPaths = resolveLiveFonts(s);
-  const bound = bindFontEmbeds(labelConfig.customFonts, liveFontPaths);
+  const liveFonts = resolveLiveFonts(s);
+  // A job ships a face from the cache only, so a replayed download stays provisioning.
+  const bound = bindFontEmbeds(labelConfig.customFonts, liveFonts.flatMap((f) => (f.download === undefined ? [f.path] : [])));
   if (bound.fonts) labelConfig.customFonts = bound.fonts;
   const embeddedFontPaths = bound.embedded;
 
@@ -930,7 +931,7 @@ export function parseZPL(
     labelConfig,
     printerProfile,
     decodedImages: s.result.decodedImages,
-    uploadedFontPaths: liveFontPaths,
+    uploadedFonts: liveFonts,
     embeddedFontPaths,
     fontLosses: [...s.fonts.fontLosses],
     uploadedGraphics: [...s.fonts.downloadedGraphics].map(([path, g]) => ({ path, gfa: g.gfaCache, via: g.via })),

packages/core/src/lib/zplParser/context.ts

@@ -5,7 +5,8 @@ import type { ImportLossCause } from "../../catalog/schema";
 import type { LabelConfig } from "../../types/LabelConfig";
 import type { CachedImage } from "../imageCache";
 import type { DecodedGraphic } from "./types";
-import type { PrinterProfile } from "../../types/PrinterProfile";
+import type { PrinterProfile, SetupFont } from "../../types/PrinterProfile";
+import { isTrueTypeFileName } from "../customFonts";
 import type { Variable } from "../../types/Variable";
 import type { TextProps } from "../../registry/text";
 import type { SerialMode } from "../../registry/serialField";
@@ -206,9 +207,16 @@ export interface DownloadedFont {
   digest: string;
   status: DownloadedFontStatus;
   /** From the download command or the ~DY format code, the only places the stream states it. */
-  kind: "truetype" | "bitmap" | "scalable";
+  kind: "truetype" | "bitmap" | "scalable" | "encoding";
+  /** The download command, for the findings the profile boundary raises. */
+  via: string;
+  /** The download rebuilt from its parsed header and payload, kept when the cache holds no face the emitter could rebuild it from. */
+  download?: string;
 }
 
+/** The cache serves a TrueType face only, and only under a name ^A@ accepts, spec p.63. */
+export const cacheServes = (kind: DownloadedFont["kind"], path: string): boolean => kind === "truetype" && isTrueTypeFileName(path);
+
 /** ^CW aliases + ~DY uploads; span the whole parse across ^XA blocks. */
 export interface FontsState {
   aliases: Map<string, string>;
@@ -420,15 +428,14 @@ function finalFontRefs(s: ParserState): string[] {
 
 /** The uploads the finished design can still ship.
  *  A ^ID drops an upload unless the design named it before the delete and still names it now. */
-export function resolveLiveFonts(s: ParserState): string[] {
+export function resolveLiveFonts(s: ParserState): (SetupFont & { via: string })[] {
   const refs = finalFontRefs(s);
-  const live: string[] = [];
+  const live: (SetupFont & { via: string })[] = [];
   for (const [path, font] of s.fonts.downloadedFonts) {
     if (font.status === "deleted") continue;
     if (font.status === "deletedWhileNamed" && !refs.some((r) => storageRefMatchesPath(r, path))) continue;
-    // A printer-native font has no web face and no ~DY format this emitter can send.
-    if (font.kind !== "truetype") continue;
-    live.push(path);
+    if (font.download !== undefined) live.push({ path, via: font.via, download: font.download });
+    else if (cacheServes(font.kind, path)) live.push({ path, via: font.via });
   }
   return live;
 }