@angadie/chittie 0.1.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Asyncdot Engineering
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+Portions of this software are vendored from MIT-licensed projects and retain
+their original copyright notices; see VENDOR.md.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @angadie/chittie
+
+The front door to **chittie** — write a receipt once, print it on web **and** React Native. Batteries-included: the ESC/POS builder engine (`chittie-core`) + the JSX authoring layer (`chittie-react`), from one import.
+
+> Not yet published. Installs are shown for the intended usage.
+
+## Install
+
+```bash
+pnpm add @angadie/chittie react
+# plus a transport for your platform:
+pnpm add @angadie/chittie-transport-web              # web (Web Serial / USB / Bluetooth)
+pnpm add @angadie/chittie-transport-react-native     # RN/Expo (bring your own BLE/Classic/TCP)
+```
+
+## Usage — JSX authoring
+
+```tsx
+import { Printer, Text, Row, Line, Cut, render } from '@angadie/chittie';
+import { print } from '@angadie/chittie-transport';
+import { createWebSerialTransport } from '@angadie/chittie-transport-web';
+
+const bytes = render(
+  <Printer width={48}>
+    <Text align="center" bold>Artisan Haus</Text>
+    <Line />
+    <Row left="Flat White" right="Rs. 850" />
+    <Row left="Croissant" right="Rs. 650" />
+    <Line />
+    <Row left="TOTAL" right="Rs. 1500" />
+    <Cut />
+  </Printer>
+);
+
+await print(createWebSerialTransport(), bytes); // connects, then writes
+```
+
+## Usage — builder authoring
+
+Same engine, no JSX:
+
+```ts
+import { ReceiptPrinterEncoder } from '@angadie/chittie';
+
+const bytes = new ReceiptPrinterEncoder({ columns: 48 })
+  .initialize()
+  .align('center').bold(true).line('Artisan Haus').bold(false)
+  .rule()
+  .table(
+    [{ width: 36, align: 'left' }, { width: 12, align: 'right' }],
+    [['Flat White', 'Rs. 850']]
+  )
+  .cut()
+  .encode();
+```
+
+## Sinhala / Tamil and other complex scripts
+
+Thermal printers have no code page for Indic scripts, so they must be printed as images. chittie does this automatically when you supply a rasterizer — see [`@angadie/chittie-text`](../chittie-text). Without one, chittie **throws a clear error** rather than silently printing `?`.
+
+```tsx
+render(receipt, { rasterizer: myCanvasRasterizer });
+```
+
+## What's exported
+
+- Everything from [`@angadie/chittie-react`](../chittie-react) — `Printer`, `Text`, `Row`, `Line`, `Br`, `Cut`, `Cashdraw`, `Barcode`, `QRCode`, `render`, and the prop/option types.
+- `ReceiptPrinterEncoder` — the builder engine from [`@angadie/chittie-core`](../chittie-core).
+
+## License
+
+MIT.

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+import ReceiptPrinterEncoder from "@angadie/chittie-core";
+export * from "@angadie/chittie-react";
+export { ReceiptPrinterEncoder };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import ReceiptPrinterEncoder from "@angadie/chittie-core";
+export * from "@angadie/chittie-react";
+export { ReceiptPrinterEncoder };

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@angadie/chittie",
+  "version": "0.1.0",
+  "description": "Batteries-included receipt printing: builder + JSX authoring → ESC/POS bytes. The front door that re-exports chittie-core + chittie-react.",
+  "license": "MIT",
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@angadie/chittie-core": "0.1.0",
+    "@angadie/chittie-react": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": "^18 || ^19"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx spikes/meta.spike.tsx"
+  }
+}