@oh-my-pi/snapcompact 16.3.6 → 16.3.7

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [16.3.7] - 2026-07-05
+
+### Fixed
+
+- Fixed `resolveShapeForText(..., "auto")` to correctly select the `silver16-bw` shape for CJK-heavy transcript text while preserving explicit shape overrides.
+
 ## [16.2.8] - 2026-06-30
 
 ### Fixed

package/dist/types/index.d.ts

@@ -1 +1 @@
-export * from "./snapcompact";
+export * from "./snapcompact.js";

package/dist/types/snapcompact.d.ts

@@ -290,13 +290,12 @@ export interface ShapeTarget {
  */
 export declare function resolveShape(model?: ShapeTarget, variant?: ShapeVariantName | "auto"): Shape;
 /**
- * Pick the frame shape for `text` without changing the selected shape.
- *
- * Glyph-level Silver fallback happens during normalization/rendering, so this
- * helper exists for callers that need a text-aware API name while preserving
- * explicit and provider-selected shapes.
+ * Pick the frame shape for `text`. Explicit variants remain forced. Auto first
+ * resolves the model/provider default, then selects the Silver CJK grid when
+ * the default font cannot safely render the text or wide CJK glyphs dominate
+ * the transcript and Silver can render it safely.
  */
-export declare function resolveShapeForText(_text: string, model?: ShapeTarget, variant?: ShapeVariantName | "auto"): Shape;
+export declare function resolveShapeForText(text: string, model?: ShapeTarget, variant?: ShapeVariantName | "auto"): Shape;
 /** Legacy frame edge in pixels (the 5x8 shape's eval-validated size). New
  *  shapes carry their own `frameSize`. */
 export declare const FRAME_SIZE = 2576;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/snapcompact",
-	"version": "16.3.6",
+	"version": "16.3.7",
 	"description": "Bitmap-frame context compression for vision-capable LLMs",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -31,10 +31,10 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "16.3.6",
-		"@oh-my-pi/pi-natives": "16.3.6",
-		"@oh-my-pi/pi-utils": "16.3.6",
-		"@oh-my-pi/pi-wire": "16.3.6"
+		"@oh-my-pi/pi-ai": "16.3.7",
+		"@oh-my-pi/pi-natives": "16.3.7",
+		"@oh-my-pi/pi-utils": "16.3.7",
+		"@oh-my-pi/pi-wire": "16.3.7"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14"

package/src/snapcompact.ts

@@ -385,15 +385,39 @@ export function resolveShape(model?: ShapeTarget, variant?: ShapeVariantName | "
 	return priceShape(ideal?.frameSize ? { ...base, frameSize: ideal.frameSize } : base, family);
 }
 
+const CJK_HEAVY_MIN_WIDE_CHARS = 8;
+const CJK_HEAVY_WIDE_RATIO = 0.25;
+
+function isCjkHeavyText(text: string): boolean {
+	const chars = normalizedInputChars(text);
+	let graphicChars = 0;
+	let wideChars = 0;
+	for (const ch of chars) {
+		if (ch === " " || ch === DIM_ON || ch === DIM_OFF || ch === NEWLINE_GLYPH) continue;
+		const cp = ch.codePointAt(0);
+		if (cp === undefined || UNRENDERABLE.test(ch)) continue;
+		graphicChars++;
+		if (isWideCodePoint(cp)) wideChars++;
+	}
+	return wideChars >= CJK_HEAVY_MIN_WIDE_CHARS && wideChars / graphicChars >= CJK_HEAVY_WIDE_RATIO;
+}
+
 /**
- * Pick the frame shape for `text` without changing the selected shape.
- *
- * Glyph-level Silver fallback happens during normalization/rendering, so this
- * helper exists for callers that need a text-aware API name while preserving
- * explicit and provider-selected shapes.
+ * Pick the frame shape for `text`. Explicit variants remain forced. Auto first
+ * resolves the model/provider default, then selects the Silver CJK grid when
+ * the default font cannot safely render the text or wide CJK glyphs dominate
+ * the transcript and Silver can render it safely.
  */
-export function resolveShapeForText(_text: string, model?: ShapeTarget, variant?: ShapeVariantName | "auto"): Shape {
-	return resolveShape(model, variant);
+export function resolveShapeForText(text: string, model?: ShapeTarget, variant?: ShapeVariantName | "auto"): Shape {
+	const shape = resolveShape(model, variant);
+	if (variant && variant !== "auto") return shape;
+	const silver = resolveShape(model, "silver16-bw");
+	if (!scanRenderability(text, { shape }).isSafe) {
+		return scanRenderability(text, { shape: silver }).isSafe ? silver : shape;
+	}
+	return shape.font !== "silver" && isCjkHeavyText(text) && scanRenderability(text, { shape: silver }).isSafe
+		? silver
+		: shape;
 }
 
 // ============================================================================