@skalfa/skalfa-printer 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skalfa
+
+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.
+
+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,56 @@
+<p align="center">
+  <img src="https://skalfa.sejedigital.com/images/logo-skalfa.png" alt="Skalfa Logo" width="300" />
+</p>
+
+# @skalfa/skalfa-printer
+
+> Thermal printer bridge for Skalfa App.
+
+---
+
+## About this Package
+
+This package is part of the **Skalfa Framework**, a premium development ecosystem designed to build high-performance, modular web applications and APIs.
+
+### Usage Scope & Standalone Status
+> 🔒 **Skalfa Ecosystem Integration:** This package is designed to run **integrated within the Skalfa ecosystem** (such as Skalfa API or Skalfa App). It relies on the global service registry and core framework abstractions to operate.
+
+---
+
+## Documentation
+
+See the usage documentation at [Documentation](https://skalfa.sejedigital.com).
+
+---
+
+## Installation
+
+You can install this package using your preferred package manager:
+
+```bash
+# Using npm
+npm install @skalfa/skalfa-printer
+
+# Using bun
+bun add @skalfa/skalfa-printer
+```
+
+---
+
+## Pre-installed Dependencies
+
+The following key dependencies are packaged and managed within this project:
+
+| Dependency | Scope | Version |
+| :--- | :--- | :--- |
+| `@skalfa/skalfa-app-core` | runtime (peer) | `^1.0.0` |
+| `@tauri-apps/api` | runtime (peer) | `^2.0.0` |
+| `react` | runtime (peer) | `^19.0.0` |
+| `@types/react` | development | `^19.0.0` |
+| `typescript` | development | `^6.0.3` |
+
+---
+
+## License
+
+This package is licensed under the **MIT License**. For full license text, see the [LICENSE](LICENSE) file.

package/dist/PrinterSelect.component.d.ts

@@ -0,0 +1,7 @@
+export interface PrinterSelectProps {
+    name?: string;
+    placeholder?: string;
+    onChange?: (printerName: string) => void;
+    value?: string;
+}
+export declare function PrinterSelect({ name, placeholder, onChange, value: controlledValue, }: PrinterSelectProps): import("react").JSX.Element;

package/dist/PrinterSelect.component.js

@@ -0,0 +1,51 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrinterSelect = PrinterSelect;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const skalfa_app_core_1 = require("@skalfa/skalfa-app-core");
+const commands_js_1 = require("./commands.js");
+const STORAGE_KEY = "skalfa-printer-selected";
+const SelectComponent = (props) => {
+    const Comp = skalfa_app_core_1.registry.get("SelectComponent");
+    return Comp ? (0, jsx_runtime_1.jsx)(Comp, { ...props }) : null;
+};
+function PrinterSelect({ name = "printer", placeholder = "-- PILIH PRINTER --", onChange, value: controlledValue, }) {
+    const [printers, setPrinters] = (0, react_1.useState)([]);
+    const [internalValue, setInternalValue] = (0, react_1.useState)("");
+    const isControlled = controlledValue !== undefined;
+    const currentValue = isControlled ? controlledValue : internalValue;
+    (0, react_1.useEffect)(() => {
+        (async () => {
+            try {
+                const list = await (0, commands_js_1.listPrinters)();
+                setPrinters(list);
+                if (!isControlled) {
+                    const saved = localStorage.getItem(STORAGE_KEY);
+                    if (saved && list.some((p) => p.name === saved)) {
+                        setInternalValue(saved);
+                    }
+                }
+            }
+            catch {
+                setPrinters([]);
+            }
+        })();
+    }, [isControlled]);
+    const handleChange = (val) => {
+        const selected = Array.isArray(val) ? val[0] : val;
+        if (!selected)
+            return;
+        localStorage.setItem(STORAGE_KEY, selected);
+        if (!isControlled) {
+            setInternalValue(selected);
+        }
+        onChange?.(selected);
+    };
+    const options = printers.map((p) => ({
+        label: `${p.name}${p.is_default ? " ★" : ""} — ${p.status_text}`,
+        value: p.name,
+    }));
+    return ((0, jsx_runtime_1.jsx)(SelectComponent, { name: name, placeholder: placeholder, options: options, value: currentValue, onChange: handleChange }));
+}

package/dist/commands.d.ts

@@ -0,0 +1,11 @@
+export interface PrinterInfo {
+    name: string;
+    port: string;
+    driver: string;
+    is_default: boolean;
+    status: number;
+    status_text: string;
+}
+export declare function listPrinters(): Promise<PrinterInfo[]>;
+export declare function printRaw(printer: string, content: string): Promise<void>;
+export declare function getPrinterStatus(printer: string): Promise<PrinterInfo>;

package/dist/commands.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listPrinters = listPrinters;
+exports.printRaw = printRaw;
+exports.getPrinterStatus = getPrinterStatus;
+const core_1 = require("@tauri-apps/api/core");
+async function listPrinters() {
+    return (0, core_1.invoke)("plugin:skalfa-printer|list_printers");
+}
+async function printRaw(printer, content) {
+    return (0, core_1.invoke)("plugin:skalfa-printer|print_raw", { printer, content });
+}
+async function getPrinterStatus(printer) {
+    return (0, core_1.invoke)("plugin:skalfa-printer|get_printer_status", {
+        printer,
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./commands.js";
+export * from "./usePrinter.hook.js";
+export * from "./PrinterSelect.component.js";
+export * from "./utils.js";

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const skalfa_app_core_1 = require("@skalfa/skalfa-app-core");
+const PrinterSelect_component_js_1 = require("./PrinterSelect.component.js");
+__exportStar(require("./commands.js"), exports);
+__exportStar(require("./usePrinter.hook.js"), exports);
+__exportStar(require("./PrinterSelect.component.js"), exports);
+__exportStar(require("./utils.js"), exports);
+skalfa_app_core_1.registry.register("PrinterSelect", PrinterSelect_component_js_1.PrinterSelect);

package/dist/usePrinter.hook.d.ts

@@ -0,0 +1,13 @@
+import type { PrinterInfo } from "./commands.js";
+export interface UsePrinterReturn {
+    printers: PrinterInfo[];
+    selectedPrinter: string | null;
+    selectPrinter: (name: string) => void;
+    print: (content: string) => Promise<void>;
+    printTo: (printer: string, content: string) => Promise<void>;
+    status: PrinterInfo | null;
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+}
+export declare function usePrinter(): UsePrinterReturn;

package/dist/usePrinter.hook.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePrinter = usePrinter;
+const react_1 = require("react");
+const commands_js_1 = require("./commands.js");
+const STORAGE_KEY = "skalfa-printer-selected";
+function usePrinter() {
+    const [printers, setPrinters] = (0, react_1.useState)([]);
+    const [selectedPrinter, setSelectedPrinter] = (0, react_1.useState)(null);
+    const [status, setStatus] = (0, react_1.useState)(null);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        const saved = localStorage.getItem(STORAGE_KEY);
+        if (saved) {
+            setSelectedPrinter(saved);
+        }
+    }, []);
+    const fetchPrinters = (0, react_1.useCallback)(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const list = await (0, commands_js_1.listPrinters)();
+            setPrinters(list);
+            if (!selectedPrinter) {
+                const defaultPrinter = list.find((p) => p.is_default);
+                if (defaultPrinter) {
+                    setSelectedPrinter(defaultPrinter.name);
+                    localStorage.setItem(STORAGE_KEY, defaultPrinter.name);
+                }
+            }
+        }
+        catch (e) {
+            setError(typeof e === "string" ? e : String(e));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [selectedPrinter]);
+    (0, react_1.useEffect)(() => {
+        fetchPrinters();
+    }, []);
+    (0, react_1.useEffect)(() => {
+        if (!selectedPrinter) {
+            setStatus(null);
+            return;
+        }
+        let cancelled = false;
+        (0, commands_js_1.getPrinterStatus)(selectedPrinter)
+            .then((info) => {
+            if (!cancelled)
+                setStatus(info);
+        })
+            .catch(() => {
+            if (!cancelled)
+                setStatus(null);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [selectedPrinter]);
+    const selectPrinter = (0, react_1.useCallback)((name) => {
+        setSelectedPrinter(name);
+        localStorage.setItem(STORAGE_KEY, name);
+    }, []);
+    const print = (0, react_1.useCallback)(async (content) => {
+        if (!selectedPrinter) {
+            throw new Error("No printer selected. Call selectPrinter() first.");
+        }
+        setError(null);
+        try {
+            await (0, commands_js_1.printRaw)(selectedPrinter, content);
+        }
+        catch (e) {
+            const msg = typeof e === "string" ? e : String(e);
+            setError(msg);
+            throw new Error(msg);
+        }
+    }, [selectedPrinter]);
+    const printTo = (0, react_1.useCallback)(async (printer, content) => {
+        setError(null);
+        try {
+            await (0, commands_js_1.printRaw)(printer, content);
+        }
+        catch (e) {
+            const msg = typeof e === "string" ? e : String(e);
+            setError(msg);
+            throw new Error(msg);
+        }
+    }, []);
+    const refresh = (0, react_1.useCallback)(async () => {
+        await fetchPrinters();
+        if (selectedPrinter) {
+            try {
+                const info = await (0, commands_js_1.getPrinterStatus)(selectedPrinter);
+                setStatus(info);
+            }
+            catch {
+                setStatus(null);
+            }
+        }
+    }, [fetchPrinters, selectedPrinter]);
+    return {
+        printers,
+        selectedPrinter,
+        selectPrinter,
+        print,
+        printTo,
+        status,
+        isLoading,
+        error,
+        refresh,
+    };
+}

package/dist/utils.d.ts

@@ -0,0 +1,33 @@
+export declare const ESC = "\u001B";
+export declare const GS = "\u001D";
+export declare const RESET = "\u001B@";
+export declare const CUT_PARTIAL = "\u001DV\u0001";
+export declare const CUT_FULL = "\u001DV\0";
+export declare const FORM_FEED = "\f";
+export declare const BOLD_ON = "\u001BE\u0001";
+export declare const BOLD_OFF = "\u001BE\0";
+export declare const UNDERLINE_ON = "\u001B-\u0001";
+export declare const UNDERLINE_OFF = "\u001B-\0";
+export declare const DOUBLE_HEIGHT_ON = "\u001D!\u0001";
+export declare const DOUBLE_WIDTH_ON = "\u001D!\u0010";
+export declare const DOUBLE_SIZE_ON = "\u001D!\u0011";
+export declare const SIZE_NORMAL = "\u001D!\0";
+export declare const ALIGN_LEFT = "\u001Ba\0";
+export declare const ALIGN_CENTER = "\u001Ba\u0001";
+export declare const ALIGN_RIGHT = "\u001Ba\u0002";
+export declare function feedLines(n: number): string;
+export declare const LINE_SPACING_DEFAULT = "\u001B2";
+export declare function lineSpacing(n: number): string;
+export declare const PAPER_WIDTH: {
+    readonly "58mm": 32;
+    readonly "76mm": 42;
+    readonly "80mm": 48;
+    readonly LX310: 80;
+};
+export type PaperSize = keyof typeof PAPER_WIDTH;
+export declare function divider(width?: number, char?: string): string;
+export declare function centerText(text: string, width: number): string;
+export declare function rowLR(left: string, right: string, width?: number): string;
+export declare function row2Col(col1: string, col2: string, width?: number): string;
+export declare function wrapReceipt(content: string, feedCount?: number): string;
+export declare function wrapDotMatrix(content: string): string;

package/dist/utils.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAPER_WIDTH = exports.LINE_SPACING_DEFAULT = exports.ALIGN_RIGHT = exports.ALIGN_CENTER = exports.ALIGN_LEFT = exports.SIZE_NORMAL = exports.DOUBLE_SIZE_ON = exports.DOUBLE_WIDTH_ON = exports.DOUBLE_HEIGHT_ON = exports.UNDERLINE_OFF = exports.UNDERLINE_ON = exports.BOLD_OFF = exports.BOLD_ON = exports.FORM_FEED = exports.CUT_FULL = exports.CUT_PARTIAL = exports.RESET = exports.GS = exports.ESC = void 0;
+exports.feedLines = feedLines;
+exports.lineSpacing = lineSpacing;
+exports.divider = divider;
+exports.centerText = centerText;
+exports.rowLR = rowLR;
+exports.row2Col = row2Col;
+exports.wrapReceipt = wrapReceipt;
+exports.wrapDotMatrix = wrapDotMatrix;
+exports.ESC = "\x1B";
+exports.GS = "\x1D";
+exports.RESET = `${exports.ESC}@`;
+exports.CUT_PARTIAL = `${exports.GS}V\x01`;
+exports.CUT_FULL = `${exports.GS}V\x00`;
+exports.FORM_FEED = "\f";
+exports.BOLD_ON = `${exports.ESC}E\x01`;
+exports.BOLD_OFF = `${exports.ESC}E\x00`;
+exports.UNDERLINE_ON = `${exports.ESC}-\x01`;
+exports.UNDERLINE_OFF = `${exports.ESC}-\x00`;
+exports.DOUBLE_HEIGHT_ON = `${exports.GS}!\x01`;
+exports.DOUBLE_WIDTH_ON = `${exports.GS}!\x10`;
+exports.DOUBLE_SIZE_ON = `${exports.GS}!\x11`;
+exports.SIZE_NORMAL = `${exports.GS}!\x00`;
+exports.ALIGN_LEFT = `${exports.ESC}a\x00`;
+exports.ALIGN_CENTER = `${exports.ESC}a\x01`;
+exports.ALIGN_RIGHT = `${exports.ESC}a\x02`;
+function feedLines(n) {
+    return `${exports.ESC}d${String.fromCharCode(Math.min(255, Math.max(0, n)))}`;
+}
+exports.LINE_SPACING_DEFAULT = `${exports.ESC}2`;
+function lineSpacing(n) {
+    return `${exports.ESC}3${String.fromCharCode(Math.min(255, Math.max(0, n)))}`;
+}
+exports.PAPER_WIDTH = {
+    "58mm": 32,
+    "76mm": 42,
+    "80mm": 48,
+    LX310: 80,
+};
+function divider(width = 48, char = "-") {
+    return char.repeat(width);
+}
+function centerText(text, width) {
+    if (text.length >= width)
+        return text.slice(0, width);
+    const left = Math.floor((width - text.length) / 2);
+    return " ".repeat(left) + text;
+}
+function rowLR(left, right, width = 48) {
+    const space = width - left.length - right.length;
+    return left + " ".repeat(Math.max(1, space)) + right;
+}
+function row2Col(col1, col2, width = 48) {
+    const w = Math.floor(width / 2);
+    return col1.padEnd(w) + col2.padEnd(w);
+}
+function wrapReceipt(content, feedCount = 3) {
+    return exports.RESET + content + feedLines(feedCount) + exports.CUT_PARTIAL;
+}
+function wrapDotMatrix(content) {
+    return "\r\n" + content + "\r\n" + exports.FORM_FEED;
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@skalfa/skalfa-printer",
+  "version": "1.0.0",
+  "description": "Thermal printer bridge for Skalfa Framework.",
+  "license": "MIT",
+  "keywords": ["skalfa", "skalfa-app", "skalfa-printer", "next-framework", "next-printer-thermal"],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src-rust",
+    "!src-rust/target"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "peerDependencies": {
+    "@skalfa/skalfa-app-core": "*",
+    "@tauri-apps/api": "^2.0.0",
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "@skalfa/skalfa-app-core": "*",
+    "@tauri-apps/api": "^2.0.0",
+    "@types/react": "^19.0.0",
+    "react": "^19.2.1",
+    "typescript": "^6.0.3"
+  }
+}