@angadie/chittie-react-native 0.1.0

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@angadie/chittie-react-native",
+  "version": "0.1.0",
+  "description": "React Native (Nitro) backend for chittie: native non-Latin text rasterization (CoreText / android.graphics) implementing chittie's TextRasterizer. Dev-client / bare RN — not Expo Go.",
+  "license": "MIT",
+  "author": "angadie",
+  "homepage": "https://github.com/octalpixel/chittie#readme",
+  "repository": "https://github.com/octalpixel/chittie.git",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "nitrogen",
+    "nitro.json",
+    "android/build.gradle",
+    "android/CMakeLists.txt",
+    "android/gradle.properties",
+    "android/fix-prefab.gradle",
+    "android/src",
+    "ios/**/*.swift",
+    "app.plugin.js",
+    "*.podspec",
+    "README.md"
+  ],
+  "keywords": [
+    "react-native",
+    "nitro",
+    "nitro-module",
+    "thermal-printer",
+    "escpos",
+    "chittie"
+  ],
+  "peerDependencies": {
+    "@angadie/chittie-text": ">=0.8.0",
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "*"
+  },
+  "devDependencies": {
+    "@canvas/image-data": "^1.1.0",
+    "nitrogen": "0.35.1",
+    "react-native-builder-bob": "^0.40.18",
+    "react-native-nitro-modules": "0.35.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "@angadie/chittie-text": "0.8.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.json"
+        }
+      ]
+    ]
+  },
+  "scripts": {
+    "codegen": "nitrogen --logLevel=\"debug\"",
+    "build": "tsc --noEmit && bob build",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx spikes/adapter.spike.mts",
+    "clean": "rm -rf lib"
+  }
+}

package/src/adapter.ts

@@ -0,0 +1,25 @@
+import type { RasterOptions, TextRasterizer } from '@angadie/chittie-text';
+import type { ChittieRasterizer } from './specs/ChittieRasterizer.nitro.js';
+
+/**
+ * Adapt a native `ChittieRasterizer` HybridObject to chittie's `TextRasterizer`.
+ * The native side returns an RGBA bitmap (dims already padded to /8); we wrap it
+ * as the structural `ImageData` chittie's raster pipeline consumes. Pure and
+ * dependency-free at runtime (no Nitro import) — inject `native` so it's testable
+ * off-device.
+ */
+export function makeRasterizer(native: ChittieRasterizer): TextRasterizer {
+  return {
+    rasterize(text: string, options: RasterOptions = {}): ImageData {
+      const { fontSize = 24, maxWidth = 576, bold = false } = options;
+      const b = native.rasterize(text, fontSize, maxWidth, !!bold);
+      // RGBA, structural ImageData — chittie reads { data, width, height }.
+      return {
+        data: new Uint8ClampedArray(b.data),
+        width: b.width,
+        height: b.height,
+        colorSpace: 'srgb',
+      } as unknown as ImageData;
+    },
+  };
+}

package/src/index.ts

@@ -0,0 +1,27 @@
+import { NitroModules } from 'react-native-nitro-modules';
+import type { TextRasterizer } from '@angadie/chittie-text';
+import type { ChittieRasterizer } from './specs/ChittieRasterizer.nitro.js';
+import { makeRasterizer } from './adapter.js';
+
+export { makeRasterizer } from './adapter.js';
+export type { ChittieRasterizer, RasterBitmap } from './specs/ChittieRasterizer.nitro.js';
+
+let cached: TextRasterizer | undefined;
+
+/**
+ * The native chittie rasterizer (CoreText / android.graphics) as a chittie
+ * `TextRasterizer` — pass it to `render()` so Sinhala/Tamil/Arabic print on a
+ * device without Skia. Requires a dev client / bare RN (native module).
+ *
+ * ```ts
+ * import { createNativeRasterizer } from '@angadie/chittie-react-native';
+ * const bytes = render(<Receipt/>, { dotWidth: 384, rasterizer: createNativeRasterizer() });
+ * ```
+ */
+export function createNativeRasterizer(): TextRasterizer {
+  if (!cached) {
+    const native = NitroModules.createHybridObject<ChittieRasterizer>('ChittieRasterizer');
+    cached = makeRasterizer(native);
+  }
+  return cached;
+}

package/src/specs/ChittieRasterizer.nitro.ts

@@ -0,0 +1,21 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+
+/**
+ * An RGBA bitmap. `width`/`height` are padded to multiples of 8 on the native
+ * side so chittie's ESC/POS raster packer (`padTo8`) is a no-op.
+ */
+export interface RasterBitmap {
+  data: ArrayBuffer;
+  width: number;
+  height: number;
+}
+
+/**
+ * Native text rasterizer — shapes a line with the platform text engine
+ * (CoreText on iOS, android.graphics on Android), which handles complex-script
+ * shaping (Sinhala/Tamil joining) and bidi (Arabic/Hebrew) for free.
+ */
+export interface ChittieRasterizer extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  /** Render `text` to an RGBA bitmap (black on white), wrapped at `maxWidth` dots. */
+  rasterize(text: string, fontSize: number, maxWidth: number, bold: boolean): RasterBitmap;
+}