@glassly/engine 0.1.0-dev.0

package/build/utils/display/profiles/nex.js

@@ -0,0 +1,150 @@
+/**
+ * Mentra Nex glyph widths
+ */
+const NEX_GLYPH_WIDTHS = {
+    // Punctuation & Symbols
+    " ": 5,
+    "!": 5,
+    '"': 8,
+    "#": 14,
+    "$": 12,
+    "%": 18,
+    "&": 14,
+    "'": 5,
+    "(": 7,
+    ")": 7,
+    "*": 8,
+    "+": 12,
+    ",": 5,
+    "-": 8,
+    ".": 5,
+    "/": 7,
+    // Numbers
+    "0": 12,
+    "1": 12,
+    "2": 12,
+    "3": 12,
+    "4": 12,
+    "5": 12,
+    "6": 12,
+    "7": 12,
+    "8": 12,
+    "9": 12,
+    // More punctuation
+    ":": 6,
+    ";": 6,
+    "<": 12,
+    "=": 12,
+    ">": 12,
+    "?": 9,
+    "@": 18,
+    // Uppercase
+    "A": 12,
+    "B": 13,
+    "C": 12,
+    "D": 13,
+    "E": 11,
+    "F": 11,
+    "G": 14,
+    "H": 14,
+    "I": 8,
+    "J": 10,
+    "K": 12,
+    "L": 10,
+    "M": 16,
+    "N": 14,
+    "O": 14,
+    "P": 12,
+    "Q": 14,
+    "R": 13,
+    "S": 11,
+    "T": 11,
+    "U": 13,
+    "V": 12,
+    "W": 18,
+    "X": 12,
+    "Y": 11,
+    "Z": 11,
+    // Brackets & special
+    "[": 6,
+    "\\": 7,
+    "]": 6,
+    "^": 12,
+    "_": 11,
+    "`": 12,
+    // Lowercase
+    "a": 11,
+    "b": 11,
+    "c": 10,
+    "d": 11,
+    "e": 11,
+    "f": 6,
+    "g": 11,
+    "h": 11,
+    "i": 5,
+    "j": 5,
+    "k": 10,
+    "l": 5,
+    "m": 17,
+    "n": 11,
+    "o": 11,
+    "p": 11,
+    "q": 11,
+    "r": 7,
+    "s": 10,
+    "t": 7,
+    "u": 11,
+    "v": 10,
+    "w": 15,
+    "x": 10,
+    "y": 10,
+    "z": 9,
+    // More special
+    "{": 7,
+    "|": 6,
+    "}": 7,
+    "~": 12,
+};
+/**
+ * Mentra Nex Smart Glasses Display Profile
+ *
+ * Also known as "Mentra Display" - a new Glassly glasses model with display capabilities.
+ */
+export const NEX_PROFILE = {
+    id: "mentra-nex",
+    name: "Mentra Nex",
+    // Display dimensions — 500x220 usable region centered in the 640x480 A6N
+    // panel (firmware mos_display_config.c: margins 70/130). Canvas coordinates
+    // are relative to this virtual screen; the physical panel is bigger, 500x220
+    // is the public drawable canvas.
+    displayWidthPx: 480,
+    displayHeightPx: 220,
+    maxLines: 8,
+    maxPayloadBytes: 450, // Matches firmware MAX_TEXT_LEN / DisplayText.text cap; delivered via fragmented BLE transport
+    bleChunkSize: 176,
+    // Font metrics
+    fontMetrics: {
+        glyphWidths: new Map(Object.entries(NEX_GLYPH_WIDTHS)),
+        defaultGlyphWidth: 16,
+        renderFormula: (glyphWidth) => glyphWidth,
+        uniformScripts: {
+            cjk: 20,
+            hiragana: 18,
+            katakana: 18,
+            korean: 24,
+            cyrillic: 18,
+        },
+        fallback: {
+            latinMaxWidth: 16,
+            unknownBehavior: "useLatinMax",
+        },
+    },
+    constraints: {
+        minCharsBeforeHyphen: 3,
+        noStartChars: [".", ",", "!", "?", ":", ";", ")", "]", "}", "。", "，", "！", "？", "：", "；", "）", "】", "」"],
+        noEndChars: ["(", "[", "{", "（", "【", "「"],
+    },
+};
+export const NEX_HYPHEN_WIDTH_PX = 8;
+export const NEX_SPACE_WIDTH_PX = 4;
+//# sourceMappingURL=nex.js.map

package/build/utils/display/profiles/nex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nex.js","sourceRoot":"","sources":["../../../../src/utils/display/profiles/nex.ts"],"names":[],"mappings":"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","sourcesContent":["import {DisplayProfile} from \"./types\"\n\n/**\n * Mentra Nex glyph widths\n */\nconst NEX_GLYPH_WIDTHS: Record<string, number> = {\n  // Punctuation & Symbols\n  \" \": 5,\n  \"!\": 5,\n  '\"': 8,\n  \"#\": 14,\n  \"$\": 12,\n  \"%\": 18,\n  \"&\": 14,\n  \"'\": 5,\n  \"(\": 7,\n  \")\": 7,\n  \"*\": 8,\n  \"+\": 12,\n  \",\": 5,\n  \"-\": 8,\n  \".\": 5,\n  \"/\": 7,\n\n  // Numbers\n  \"0\": 12,\n  \"1\": 12,\n  \"2\": 12,\n  \"3\": 12,\n  \"4\": 12,\n  \"5\": 12,\n  \"6\": 12,\n  \"7\": 12,\n  \"8\": 12,\n  \"9\": 12,\n\n  // More punctuation\n  \":\": 6,\n  \";\": 6,\n  \"<\": 12,\n  \"=\": 12,\n  \">\": 12,\n  \"?\": 9,\n  \"@\": 18,\n\n  // Uppercase\n  \"A\": 12,\n  \"B\": 13,\n  \"C\": 12,\n  \"D\": 13,\n  \"E\": 11,\n  \"F\": 11,\n  \"G\": 14,\n  \"H\": 14,\n  \"I\": 8,\n  \"J\": 10,\n  \"K\": 12,\n  \"L\": 10,\n  \"M\": 16,\n  \"N\": 14,\n  \"O\": 14,\n  \"P\": 12,\n  \"Q\": 14,\n  \"R\": 13,\n  \"S\": 11,\n  \"T\": 11,\n  \"U\": 13,\n  \"V\": 12,\n  \"W\": 18,\n  \"X\": 12,\n  \"Y\": 11,\n  \"Z\": 11,\n\n  // Brackets & special\n  \"[\": 6,\n  \"\\\\\": 7,\n  \"]\": 6,\n  \"^\": 12,\n  \"_\": 11,\n  \"`\": 12,\n\n  // Lowercase\n  \"a\": 11,\n  \"b\": 11,\n  \"c\": 10,\n  \"d\": 11,\n  \"e\": 11,\n  \"f\": 6,\n  \"g\": 11,\n  \"h\": 11,\n  \"i\": 5,\n  \"j\": 5,\n  \"k\": 10,\n  \"l\": 5,\n  \"m\": 17,\n  \"n\": 11,\n  \"o\": 11,\n  \"p\": 11,\n  \"q\": 11,\n  \"r\": 7,\n  \"s\": 10,\n  \"t\": 7,\n  \"u\": 11,\n  \"v\": 10,\n  \"w\": 15,\n  \"x\": 10,\n  \"y\": 10,\n  \"z\": 9,\n\n  // More special\n  \"{\": 7,\n  \"|\": 6,\n  \"}\": 7,\n  \"~\": 12,\n}\n\n/**\n * Mentra Nex Smart Glasses Display Profile\n *\n * Also known as \"Mentra Display\" - a new Glassly glasses model with display capabilities.\n */\nexport const NEX_PROFILE: DisplayProfile = {\n  id: \"mentra-nex\",\n  name: \"Mentra Nex\",\n\n  // Display dimensions — 500x220 usable region centered in the 640x480 A6N\n  // panel (firmware mos_display_config.c: margins 70/130). Canvas coordinates\n  // are relative to this virtual screen; the physical panel is bigger, 500x220\n  // is the public drawable canvas.\n  displayWidthPx: 480,\n  displayHeightPx: 220,\n  maxLines: 8,\n\n  maxPayloadBytes: 450, // Matches firmware MAX_TEXT_LEN / DisplayText.text cap; delivered via fragmented BLE transport\n  bleChunkSize: 176,\n\n  // Font metrics\n  fontMetrics: {\n    glyphWidths: new Map(Object.entries(NEX_GLYPH_WIDTHS)),\n    defaultGlyphWidth: 16,\n    renderFormula: (glyphWidth: number) => glyphWidth,\n\n    uniformScripts: {\n      cjk: 20,\n      hiragana: 18,\n      katakana: 18,\n      korean: 24,\n      cyrillic: 18,\n    },\n\n    fallback: {\n      latinMaxWidth: 16,\n      unknownBehavior: \"useLatinMax\",\n    },\n  },\n\n  constraints: {\n    minCharsBeforeHyphen: 3,\n    noStartChars: [\".\", \",\", \"!\", \"?\", \":\", \";\", \")\", \"]\", \"}\", \"。\", \"，\", \"！\", \"？\", \"：\", \"；\", \"）\", \"】\", \"」\"],\n    noEndChars: [\"(\", \"[\", \"{\", \"（\", \"【\", \"「\"],\n  },\n}\n\nexport const NEX_HYPHEN_WIDTH_PX = 8\n\nexport const NEX_SPACE_WIDTH_PX = 4\n"]}

package/build/utils/display/profiles/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Display profile for a specific glasses model.
+ * All text measurement and wrapping derives from this configuration.
+ */
+export interface DisplayProfile {
+    /** Unique identifier for this glasses model */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Display width in pixels */
+    displayWidthPx: number;
+    /** Display height in pixels (if applicable) */
+    displayHeightPx?: number;
+    /** Maximum number of lines that can be displayed */
+    maxLines: number;
+    /**
+     * CALIBRATED line height in px for box-height→line-count math (scene
+     * pipeline). When absent, host-side height clipping is skipped entirely and
+     * text wraps to the box width with the firmware clipping vertically in-box
+     * (legacy behavior) — it is deliberately NOT derived from canvas math, which
+     * proved wrong on hardware (see profileLineHeightPx in scene/process.ts).
+     */
+    lineHeightPx?: number;
+    /** Maximum safe payload size in bytes (for BLE transmission) */
+    maxPayloadBytes: number;
+    /** BLE chunk size for transmission */
+    bleChunkSize: number;
+    /** Font metrics for text measurement */
+    fontMetrics: FontMetrics;
+    /** Optional constraints */
+    constraints?: DisplayConstraints;
+}
+/**
+ * Font metrics for pixel-accurate text measurement.
+ */
+export interface FontMetrics {
+    /**
+     * Map of character to glyph width in pixels.
+     * Keys are single characters.
+     */
+    glyphWidths: Map<string, number>;
+    /** Default glyph width for unmapped characters */
+    defaultGlyphWidth: number;
+    /**
+     * Formula to convert glyph width to rendered pixel width.
+     * G1 example: (glyphWidth + 1) * 2
+     */
+    renderFormula: (glyphWidth: number) => number;
+    /**
+     * Uniform-width scripts - verified to render all characters at same width.
+     * These are NOT averages - they are the actual uniform width in RENDERED pixels.
+     */
+    uniformScripts: UniformScriptWidths;
+    /**
+     * Fallback configuration for unmapped characters.
+     */
+    fallback: FallbackConfig;
+}
+/**
+ * Uniform width scripts - these scripts render all characters at the same width.
+ * Values are in RENDERED pixels (after applying renderFormula if applicable).
+ * Verified through hardware testing.
+ */
+export interface UniformScriptWidths {
+    /** Chinese, Japanese Kanji - all chars same width */
+    cjk: number;
+    /** Japanese Hiragana - all chars same width */
+    hiragana: number;
+    /** Japanese Katakana - all chars same width */
+    katakana: number;
+    /** Korean Hangul - all chars same width */
+    korean: number;
+    /** Russian, etc. - all chars same width */
+    cyrillic: number;
+}
+/**
+ * Fallback strategy for unmapped characters.
+ */
+export interface FallbackConfig {
+    /**
+     * Max known Latin width for safe fallback (in rendered pixels).
+     * Using max ensures we never overflow (worst case: slight under-utilization).
+     */
+    latinMaxWidth: number;
+    /** What to do with completely unknown characters */
+    unknownBehavior: "useLatinMax" | "throw" | "filter";
+}
+/**
+ * Optional display constraints.
+ */
+export interface DisplayConstraints {
+    /** Minimum characters before allowing hyphen break */
+    minCharsBeforeHyphen?: number;
+    /** Characters that should not appear at start of line (kinsoku) */
+    noStartChars?: string[];
+    /** Characters that should not appear at end of line (kinsoku) */
+    noEndChars?: string[];
+}
+/**
+ * Script type for character classification.
+ */
+export type ScriptType = "latin" | "cjk" | "hiragana" | "katakana" | "korean" | "cyrillic" | "numbers" | "punctuation" | "unsupported";
+//# sourceMappingURL=types.d.ts.map

package/build/utils/display/profiles/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/profiles/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAA;IAEV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IAEZ,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAA;IAEtB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAA;IAEvB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAA;IAEpB,wCAAwC;IACxC,WAAW,EAAE,WAAW,CAAA;IAExB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,kBAAkB,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAA;IAEzB;;;OAGG;IACH,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;IAE7C;;;OAGG;IACH,cAAc,EAAE,mBAAmB,CAAA;IAEnC;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAA;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB,oDAAoD;IACpD,eAAe,EAAE,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAA;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAE7B,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IAEvB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,KAAK,GACL,UAAU,GACV,UAAU,GACV,QAAQ,GACR,UAAU,GACV,SAAS,GACT,aAAa,GACb,aAAa,CAAA"}

package/build/utils/display/profiles/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/utils/display/profiles/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/display/profiles/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Display profile for a specific glasses model.\n * All text measurement and wrapping derives from this configuration.\n */\nexport interface DisplayProfile {\n  /** Unique identifier for this glasses model */\n  id: string\n\n  /** Human-readable name */\n  name: string\n\n  /** Display width in pixels */\n  displayWidthPx: number\n\n  /** Display height in pixels (if applicable) */\n  displayHeightPx?: number\n\n  /** Maximum number of lines that can be displayed */\n  maxLines: number\n\n  /**\n   * CALIBRATED line height in px for box-height→line-count math (scene\n   * pipeline). When absent, host-side height clipping is skipped entirely and\n   * text wraps to the box width with the firmware clipping vertically in-box\n   * (legacy behavior) — it is deliberately NOT derived from canvas math, which\n   * proved wrong on hardware (see profileLineHeightPx in scene/process.ts).\n   */\n  lineHeightPx?: number\n\n  /** Maximum safe payload size in bytes (for BLE transmission) */\n  maxPayloadBytes: number\n\n  /** BLE chunk size for transmission */\n  bleChunkSize: number\n\n  /** Font metrics for text measurement */\n  fontMetrics: FontMetrics\n\n  /** Optional constraints */\n  constraints?: DisplayConstraints\n}\n\n/**\n * Font metrics for pixel-accurate text measurement.\n */\nexport interface FontMetrics {\n  /**\n   * Map of character to glyph width in pixels.\n   * Keys are single characters.\n   */\n  glyphWidths: Map<string, number>\n\n  /** Default glyph width for unmapped characters */\n  defaultGlyphWidth: number\n\n  /**\n   * Formula to convert glyph width to rendered pixel width.\n   * G1 example: (glyphWidth + 1) * 2\n   */\n  renderFormula: (glyphWidth: number) => number\n\n  /**\n   * Uniform-width scripts - verified to render all characters at same width.\n   * These are NOT averages - they are the actual uniform width in RENDERED pixels.\n   */\n  uniformScripts: UniformScriptWidths\n\n  /**\n   * Fallback configuration for unmapped characters.\n   */\n  fallback: FallbackConfig\n}\n\n/**\n * Uniform width scripts - these scripts render all characters at the same width.\n * Values are in RENDERED pixels (after applying renderFormula if applicable).\n * Verified through hardware testing.\n */\nexport interface UniformScriptWidths {\n  /** Chinese, Japanese Kanji - all chars same width */\n  cjk: number\n  /** Japanese Hiragana - all chars same width */\n  hiragana: number\n  /** Japanese Katakana - all chars same width */\n  katakana: number\n  /** Korean Hangul - all chars same width */\n  korean: number\n  /** Russian, etc. - all chars same width */\n  cyrillic: number\n}\n\n/**\n * Fallback strategy for unmapped characters.\n */\nexport interface FallbackConfig {\n  /**\n   * Max known Latin width for safe fallback (in rendered pixels).\n   * Using max ensures we never overflow (worst case: slight under-utilization).\n   */\n  latinMaxWidth: number\n\n  /** What to do with completely unknown characters */\n  unknownBehavior: \"useLatinMax\" | \"throw\" | \"filter\"\n}\n\n/**\n * Optional display constraints.\n */\nexport interface DisplayConstraints {\n  /** Minimum characters before allowing hyphen break */\n  minCharsBeforeHyphen?: number\n\n  /** Characters that should not appear at start of line (kinsoku) */\n  noStartChars?: string[]\n\n  /** Characters that should not appear at end of line (kinsoku) */\n  noEndChars?: string[]\n}\n\n/**\n * Script type for character classification.\n */\nexport type ScriptType =\n  | \"latin\"\n  | \"cjk\"\n  | \"hiragana\"\n  | \"katakana\"\n  | \"korean\"\n  | \"cyrillic\"\n  | \"numbers\"\n  | \"punctuation\"\n  | \"unsupported\"\n"]}

package/build/utils/display/profiles/z100.d.ts

@@ -0,0 +1,33 @@
+import { DisplayProfile } from "./types";
+/**
+ * Vuzix Z100 Smart Glasses Display Profile
+ *
+ * The Z100 has a green monochrome display with 640x480 resolution.
+ * It uses the Vuzix Ultralite SDK and Noto Sans font family.
+ *
+ * Display specs:
+ * - Resolution: 640x480
+ * - Usable text width: ~390px (empirically tested - SDK applies margins)
+ * - Color: Green monochrome
+ * - Max text lines: 7
+ * - Font: Noto Sans Regular at 21px
+ * - No bitmap support via text commands
+ * - Adjustable brightness
+ *
+ * NOTE: The Vuzix Ultralite SDK handles text rendering internally and applies
+ * its own margins/padding. The usable text width is significantly less than
+ * the physical 640px resolution. Empirical testing shows ~42 characters of
+ * mixed text (387px measured) fits on one line before the SDK wraps.
+ */
+export declare const Z100_PROFILE: DisplayProfile;
+/**
+ * Get the hyphen width for Z100 in pixels.
+ * Used for line breaking calculations.
+ */
+export declare const Z100_HYPHEN_WIDTH_PX = 7;
+/**
+ * Get the space width for Z100 in pixels.
+ * Used for column alignment calculations.
+ */
+export declare const Z100_SPACE_WIDTH_PX = 5;
+//# sourceMappingURL=z100.d.ts.map

package/build/utils/display/profiles/z100.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"z100.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/profiles/z100.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,SAAS,CAAA;AAyHtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,EAAE,cA4C1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAA"}

package/build/utils/display/profiles/z100.js

@@ -0,0 +1,182 @@
+/**
+ * Vuzix Z100 glyph widths - extracted from NotoSans-Regular.ttf at 21px
+ *
+ * These are pixel widths at the default font size used by the Z100 display.
+ * The Z100 uses Noto Sans as its system font.
+ *
+ * Extracted using: node scripts/extract-font-metrics.js NotoSans-Regular.ttf 21
+ */
+const Z100_GLYPH_WIDTHS = {
+    // Space and punctuation
+    " ": 5,
+    "!": 6,
+    '"': 9,
+    "#": 14,
+    "$": 12,
+    "%": 17,
+    "&": 15,
+    "'": 5,
+    "(": 6,
+    ")": 6,
+    "*": 12,
+    "+": 12,
+    ",": 6,
+    "-": 7, // Hyphen width - important for line breaking
+    ".": 6,
+    "/": 8,
+    // Numbers
+    "0": 12,
+    "1": 12,
+    "2": 12,
+    "3": 12,
+    "4": 12,
+    "5": 12,
+    "6": 12,
+    "7": 12,
+    "8": 12,
+    "9": 12,
+    // More punctuation
+    ":": 6,
+    ";": 6,
+    "<": 12,
+    "=": 12,
+    ">": 12,
+    "?": 9,
+    "@": 19,
+    // Uppercase
+    "A": 13,
+    "B": 14,
+    "C": 13,
+    "D": 15,
+    "E": 12,
+    "F": 11,
+    "G": 15,
+    "H": 16,
+    "I": 7,
+    "J": 6,
+    "K": 13,
+    "L": 11,
+    "M": 19,
+    "N": 16,
+    "O": 16,
+    "P": 13,
+    "Q": 16,
+    "R": 13,
+    "S": 12,
+    "T": 12,
+    "U": 15,
+    "V": 13,
+    "W": 20,
+    "X": 12,
+    "Y": 12,
+    "Z": 12,
+    // Brackets & special
+    "[": 7,
+    "\\": 8,
+    "]": 7,
+    "^": 12,
+    "_": 9,
+    "`": 6,
+    // Lowercase
+    "a": 12,
+    "b": 13,
+    "c": 10,
+    "d": 13,
+    "e": 12,
+    "f": 7,
+    "g": 13,
+    "h": 13,
+    "i": 5,
+    "j": 5,
+    "k": 11,
+    "l": 5,
+    "m": 20,
+    "n": 13,
+    "o": 13,
+    "p": 13,
+    "q": 13,
+    "r": 9,
+    "s": 10,
+    "t": 8,
+    "u": 13,
+    "v": 11,
+    "w": 17,
+    "x": 11,
+    "y": 11,
+    "z": 10,
+    // More special
+    "{": 8,
+    "|": 12,
+    "}": 8,
+    "~": 12,
+};
+/**
+ * Vuzix Z100 Smart Glasses Display Profile
+ *
+ * The Z100 has a green monochrome display with 640x480 resolution.
+ * It uses the Vuzix Ultralite SDK and Noto Sans font family.
+ *
+ * Display specs:
+ * - Resolution: 640x480
+ * - Usable text width: ~390px (empirically tested - SDK applies margins)
+ * - Color: Green monochrome
+ * - Max text lines: 7
+ * - Font: Noto Sans Regular at 21px
+ * - No bitmap support via text commands
+ * - Adjustable brightness
+ *
+ * NOTE: The Vuzix Ultralite SDK handles text rendering internally and applies
+ * its own margins/padding. The usable text width is significantly less than
+ * the physical 640px resolution. Empirical testing shows ~42 characters of
+ * mixed text (387px measured) fits on one line before the SDK wraps.
+ */
+export const Z100_PROFILE = {
+    id: "vuzix-z100",
+    name: "Vuzix Z100",
+    // Display dimensions
+    // Empirically tested: ~42 chars of mixed text (387px) fits before SDK wraps
+    // Using 390px to account for measurement variance
+    displayWidthPx: 390,
+    maxLines: 7,
+    // BLE constraints
+    // Z100 uses Vuzix Ultralite SDK which handles chunking internally
+    // These are conservative values for direct BLE if needed
+    maxPayloadBytes: 512,
+    bleChunkSize: 180,
+    // Font metrics - Noto Sans Regular at 21px
+    fontMetrics: {
+        glyphWidths: new Map(Object.entries(Z100_GLYPH_WIDTHS)),
+        defaultGlyphWidth: 12, // Average width from extracted metrics
+        // Z100 uses direct pixel widths, no render formula needed
+        renderFormula: (glyphWidth) => glyphWidth,
+        // Uniform-width scripts for CJK and other non-Latin
+        // Noto Sans CJK characters are typically wider
+        uniformScripts: {
+            cjk: 21, // Full-width CJK characters
+            hiragana: 21,
+            katakana: 21,
+            korean: 21,
+            cyrillic: 14, // Cyrillic is similar to Latin in Noto Sans
+        },
+        fallback: {
+            latinMaxWidth: 20, // 'W' and 'm' are the widest at 20px
+            unknownBehavior: "useLatinMax",
+        },
+    },
+    constraints: {
+        minCharsBeforeHyphen: 3,
+        noStartChars: [".", ",", "!", "?", ":", ";", ")", "]", "}", "。", "，", "！", "？", "：", "；", "）", "】", "」"],
+        noEndChars: ["(", "[", "{", "（", "【", "「"],
+    },
+};
+/**
+ * Get the hyphen width for Z100 in pixels.
+ * Used for line breaking calculations.
+ */
+export const Z100_HYPHEN_WIDTH_PX = 7;
+/**
+ * Get the space width for Z100 in pixels.
+ * Used for column alignment calculations.
+ */
+export const Z100_SPACE_WIDTH_PX = 5;
+//# sourceMappingURL=z100.js.map

package/build/utils/display/profiles/z100.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"z100.js","sourceRoot":"","sources":["../../../../src/utils/display/profiles/z100.ts"],"names":[],"mappings":"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","sourcesContent":["import {DisplayProfile} from \"./types\"\n\n/**\n * Vuzix Z100 glyph widths - extracted from NotoSans-Regular.ttf at 21px\n *\n * These are pixel widths at the default font size used by the Z100 display.\n * The Z100 uses Noto Sans as its system font.\n *\n * Extracted using: node scripts/extract-font-metrics.js NotoSans-Regular.ttf 21\n */\nconst Z100_GLYPH_WIDTHS: Record<string, number> = {\n  // Space and punctuation\n  \" \": 5,\n  \"!\": 6,\n  '\"': 9,\n  \"#\": 14,\n  \"$\": 12,\n  \"%\": 17,\n  \"&\": 15,\n  \"'\": 5,\n  \"(\": 6,\n  \")\": 6,\n  \"*\": 12,\n  \"+\": 12,\n  \",\": 6,\n  \"-\": 7, // Hyphen width - important for line breaking\n  \".\": 6,\n  \"/\": 8,\n\n  // Numbers\n  \"0\": 12,\n  \"1\": 12,\n  \"2\": 12,\n  \"3\": 12,\n  \"4\": 12,\n  \"5\": 12,\n  \"6\": 12,\n  \"7\": 12,\n  \"8\": 12,\n  \"9\": 12,\n\n  // More punctuation\n  \":\": 6,\n  \";\": 6,\n  \"<\": 12,\n  \"=\": 12,\n  \">\": 12,\n  \"?\": 9,\n  \"@\": 19,\n\n  // Uppercase\n  \"A\": 13,\n  \"B\": 14,\n  \"C\": 13,\n  \"D\": 15,\n  \"E\": 12,\n  \"F\": 11,\n  \"G\": 15,\n  \"H\": 16,\n  \"I\": 7,\n  \"J\": 6,\n  \"K\": 13,\n  \"L\": 11,\n  \"M\": 19,\n  \"N\": 16,\n  \"O\": 16,\n  \"P\": 13,\n  \"Q\": 16,\n  \"R\": 13,\n  \"S\": 12,\n  \"T\": 12,\n  \"U\": 15,\n  \"V\": 13,\n  \"W\": 20,\n  \"X\": 12,\n  \"Y\": 12,\n  \"Z\": 12,\n\n  // Brackets & special\n  \"[\": 7,\n  \"\\\\\": 8,\n  \"]\": 7,\n  \"^\": 12,\n  \"_\": 9,\n  \"`\": 6,\n\n  // Lowercase\n  \"a\": 12,\n  \"b\": 13,\n  \"c\": 10,\n  \"d\": 13,\n  \"e\": 12,\n  \"f\": 7,\n  \"g\": 13,\n  \"h\": 13,\n  \"i\": 5,\n  \"j\": 5,\n  \"k\": 11,\n  \"l\": 5,\n  \"m\": 20,\n  \"n\": 13,\n  \"o\": 13,\n  \"p\": 13,\n  \"q\": 13,\n  \"r\": 9,\n  \"s\": 10,\n  \"t\": 8,\n  \"u\": 13,\n  \"v\": 11,\n  \"w\": 17,\n  \"x\": 11,\n  \"y\": 11,\n  \"z\": 10,\n\n  // More special\n  \"{\": 8,\n  \"|\": 12,\n  \"}\": 8,\n  \"~\": 12,\n}\n\n/**\n * Vuzix Z100 Smart Glasses Display Profile\n *\n * The Z100 has a green monochrome display with 640x480 resolution.\n * It uses the Vuzix Ultralite SDK and Noto Sans font family.\n *\n * Display specs:\n * - Resolution: 640x480\n * - Usable text width: ~390px (empirically tested - SDK applies margins)\n * - Color: Green monochrome\n * - Max text lines: 7\n * - Font: Noto Sans Regular at 21px\n * - No bitmap support via text commands\n * - Adjustable brightness\n *\n * NOTE: The Vuzix Ultralite SDK handles text rendering internally and applies\n * its own margins/padding. The usable text width is significantly less than\n * the physical 640px resolution. Empirical testing shows ~42 characters of\n * mixed text (387px measured) fits on one line before the SDK wraps.\n */\nexport const Z100_PROFILE: DisplayProfile = {\n  id: \"vuzix-z100\",\n  name: \"Vuzix Z100\",\n\n  // Display dimensions\n  // Empirically tested: ~42 chars of mixed text (387px) fits before SDK wraps\n  // Using 390px to account for measurement variance\n  displayWidthPx: 390,\n  maxLines: 7,\n\n  // BLE constraints\n  // Z100 uses Vuzix Ultralite SDK which handles chunking internally\n  // These are conservative values for direct BLE if needed\n  maxPayloadBytes: 512,\n  bleChunkSize: 180,\n\n  // Font metrics - Noto Sans Regular at 21px\n  fontMetrics: {\n    glyphWidths: new Map(Object.entries(Z100_GLYPH_WIDTHS)),\n    defaultGlyphWidth: 12, // Average width from extracted metrics\n    // Z100 uses direct pixel widths, no render formula needed\n    renderFormula: (glyphWidth: number) => glyphWidth,\n\n    // Uniform-width scripts for CJK and other non-Latin\n    // Noto Sans CJK characters are typically wider\n    uniformScripts: {\n      cjk: 21, // Full-width CJK characters\n      hiragana: 21,\n      katakana: 21,\n      korean: 21,\n      cyrillic: 14, // Cyrillic is similar to Latin in Noto Sans\n    },\n\n    fallback: {\n      latinMaxWidth: 20, // 'W' and 'm' are the widest at 20px\n      unknownBehavior: \"useLatinMax\",\n    },\n  },\n\n  constraints: {\n    minCharsBeforeHyphen: 3,\n    noStartChars: [\".\", \",\", \"!\", \"?\", \":\", \";\", \")\", \"]\", \"}\", \"。\", \"，\", \"！\", \"？\", \"：\", \"；\", \"）\", \"】\", \"」\"],\n    noEndChars: [\"(\", \"[\", \"{\", \"（\", \"【\", \"「\"],\n  },\n}\n\n/**\n * Get the hyphen width for Z100 in pixels.\n * Used for line breaking calculations.\n */\nexport const Z100_HYPHEN_WIDTH_PX = 7\n\n/**\n * Get the space width for Z100 in pixels.\n * Used for column alignment calculations.\n */\nexport const Z100_SPACE_WIDTH_PX = 5\n"]}

package/build/utils/display/scene/anchor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Anchor resolution — turn corner-anchored boxes into plain top-left boxes
+ * against the device's real canvas. Runs in emitScene BEFORE the canPosition
+ * branch so both processScene (clamping) and degradeScene (reading order)
+ * only ever see concrete coordinates. Spec:
+ * notes/superpowers/specs/2026-08-10-anchored-render-boxes.md
+ */
+import type { SceneElementInput } from "./types";
+/**
+ * Resolve every anchored box in a scene to top-left coordinates on a W×H
+ * canvas. Unanchored elements pass through unchanged (same reference — no
+ * copy churn on the common path), as do malformed ones so processScene's
+ * validation still sees and reports them. Non-finite insets survive the
+ * subtraction as non-finite and are dropped by the same validation.
+ */
+export declare function resolveAnchors(input: readonly SceneElementInput[], width: number, height: number): SceneElementInput[];
+//# sourceMappingURL=anchor.d.ts.map

package/build/utils/display/scene/anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/scene/anchor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAA0B,iBAAiB,EAAC,MAAM,SAAS,CAAA;AAcvE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,iBAAiB,EAAE,CAKrB"}

package/build/utils/display/scene/anchor.js

@@ -0,0 +1,33 @@
+/**
+ * Anchor resolution — turn corner-anchored boxes into plain top-left boxes
+ * against the device's real canvas. Runs in emitScene BEFORE the canPosition
+ * branch so both processScene (clamping) and degradeScene (reading order)
+ * only ever see concrete coordinates. Spec:
+ * notes/superpowers/specs/2026-08-10-anchored-render-boxes.md
+ */
+function resolveBox(box, width, height) {
+    const { anchor, x, y, w, h } = box;
+    const right = anchor === "top-right" || anchor === "bottom-right";
+    const bottom = anchor === "bottom-left" || anchor === "bottom-right";
+    return {
+        x: right ? width - x - w : x,
+        y: bottom ? height - y - h : y,
+        w,
+        h,
+    };
+}
+/**
+ * Resolve every anchored box in a scene to top-left coordinates on a W×H
+ * canvas. Unanchored elements pass through unchanged (same reference — no
+ * copy churn on the common path), as do malformed ones so processScene's
+ * validation still sees and reports them. Non-finite insets survive the
+ * subtraction as non-finite and are dropped by the same validation.
+ */
+export function resolveAnchors(input, width, height) {
+    return input.map((el) => {
+        if (!el || typeof el !== "object" || !el.box || !el.box.anchor)
+            return el;
+        return { ...el, box: resolveBox(el.box, width, height) };
+    });
+}
+//# sourceMappingURL=anchor.js.map

package/build/utils/display/scene/anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.js","sourceRoot":"","sources":["../../../../src/utils/display/scene/anchor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,SAAS,UAAU,CAAC,GAAkB,EAAE,KAAa,EAAE,MAAc;IACnE,MAAM,EAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAC,GAAG,GAAG,CAAA;IAChC,MAAM,KAAK,GAAG,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,cAAc,CAAA;IACjE,MAAM,MAAM,GAAG,MAAM,KAAK,aAAa,IAAI,MAAM,KAAK,cAAc,CAAA;IACpE,OAAO;QACL,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QACD,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAmC,EACnC,KAAa,EACb,MAAc;IAEd,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO,EAAE,CAAA;QACzE,OAAO,EAAC,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,EAAC,CAAA;IACxD,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["/**\n * Anchor resolution — turn corner-anchored boxes into plain top-left boxes\n * against the device's real canvas. Runs in emitScene BEFORE the canPosition\n * branch so both processScene (clamping) and degradeScene (reading order)\n * only ever see concrete coordinates. Spec:\n * notes/superpowers/specs/2026-08-10-anchored-render-boxes.md\n */\n\nimport type {SceneBox, SceneBoxInput, SceneElementInput} from \"./types\"\n\nfunction resolveBox(box: SceneBoxInput, width: number, height: number): SceneBox {\n  const {anchor, x, y, w, h} = box\n  const right = anchor === \"top-right\" || anchor === \"bottom-right\"\n  const bottom = anchor === \"bottom-left\" || anchor === \"bottom-right\"\n  return {\n    x: right ? width - x - w : x,\n    y: bottom ? height - y - h : y,\n    w,\n    h,\n  }\n}\n\n/**\n * Resolve every anchored box in a scene to top-left coordinates on a W×H\n * canvas. Unanchored elements pass through unchanged (same reference — no\n * copy churn on the common path), as do malformed ones so processScene's\n * validation still sees and reports them. Non-finite insets survive the\n * subtraction as non-finite and are dropped by the same validation.\n */\nexport function resolveAnchors(\n  input: readonly SceneElementInput[],\n  width: number,\n  height: number,\n): SceneElementInput[] {\n  return input.map((el) => {\n    if (!el || typeof el !== \"object\" || !el.box || !el.box.anchor) return el\n    return {...el, box: resolveBox(el.box, width, height)}\n  })\n}\n"]}

package/build/utils/display/scene/degrade.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Degrade — compile a scene for devices that can't position elements
+ * (`canPosition: false`: G1, Z100). Output is a LEGACY layout that rides the
+ * existing display path — DisplayProcessor wraps it there, exactly as today,
+ * which is what keeps sugar byte-identical on old hardware (spec §2/§5:
+ * degrade output must be UNWRAPPED; wrapping twice breaks the goldens).
+ *
+ * Rules (design doc §3.4.8): content-preserving, never-erroring,
+ * honestly-reported. Text collapses in reading order (y, then x) joined by
+ * blank lines; EXACTLY two text elements sharing a y-range with disjoint
+ * x-ranges become a double_text_wall (ColumnComposer path downstream); rects
+ * drop silently (decoration); images drop + report.
+ */
+import type { SceneElementInput } from "./types";
+export interface DegradedScene {
+    /** Legacy layout for the existing display path, or null for an empty scene (caller clears). */
+    layout: {
+        layoutType: string;
+        [key: string]: unknown;
+    } | null;
+    degraded: boolean;
+    dropped: string[];
+}
+export declare function degradeScene(input: readonly SceneElementInput[]): DegradedScene;
+//# sourceMappingURL=degrade.d.ts.map

package/build/utils/display/scene/degrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"degrade.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/scene/degrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,SAAS,CAAA;AAE9C,MAAM,WAAW,aAAa;IAC5B,+FAA+F;IAC/F,MAAM,EAAE;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAC,GAAG,IAAI,CAAA;IAC3D,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAYD,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,aAAa,CA8C/E"}