@nice2dev/ui-tools 1.0.10

package/dist/hardware-integration.d.ts

@@ -0,0 +1,966 @@
+/**
+ * @file hardware-integration.ts
+ * @module @nice2dev/ui-tools
+ * @description PRO-22 — Hardware Integration
+ *
+ * Types for barcode/QR scanning, printing, payment terminals,
+ * and measurement devices.
+ */
+/** Device connection type */
+export type HardwareConnectionType = 'usb' | 'bluetooth' | 'bluetooth_le' | 'serial' | 'network' | 'hid' | 'wifi_direct';
+/** Device status */
+export type HardwareDeviceStatus = 'connected' | 'disconnected' | 'connecting' | 'error' | 'busy' | 'ready';
+/** Hardware device */
+export interface HardwareDevice {
+    id: string;
+    name: string;
+    type: HardwareDeviceType;
+    connection: HardwareConnectionType;
+    status: HardwareDeviceStatus;
+    address?: string;
+    vendor?: string;
+    model?: string;
+    serialNumber?: string;
+    firmwareVersion?: string;
+    lastSeen?: Date;
+    capabilities?: string[];
+}
+/** Hardware device type */
+export type HardwareDeviceType = 'scanner' | 'printer' | 'payment_terminal' | 'scale' | 'temperature_sensor' | 'dimensioner' | 'serial_device' | 'custom';
+/** Barcode scanner config */
+export interface BarcodeScannerConfig {
+    mode: ScannerMode;
+    source: ScannerSource;
+    symbologies?: BarcodeSymbology[];
+    decoding?: DecodingConfig;
+    camera?: CameraScanConfig;
+    hardware?: HardwareScanConfig;
+    feedback?: ScanFeedback;
+    history?: ScanHistoryConfig;
+}
+/** Scanner mode */
+export type ScannerMode = 'single' | 'continuous' | 'batch';
+/** Scanner source */
+export type ScannerSource = 'camera' | 'hardware' | 'auto';
+/** Barcode symbology */
+export type BarcodeSymbology = 'code128' | 'code39' | 'code93' | 'codabar' | 'ean8' | 'ean13' | 'upc_a' | 'upc_e' | 'itf' | 'itf14' | 'qr_code' | 'data_matrix' | 'aztec' | 'pdf417' | 'maxicode' | 'gs1_128' | 'gs1_databar';
+/** Decoding config */
+export interface DecodingConfig {
+    tryHarder?: boolean;
+    characterSet?: string;
+    pureBarcode?: boolean;
+    assumeGS1?: boolean;
+    allowedLengths?: number[];
+}
+/** Camera scan config */
+export interface CameraScanConfig {
+    facing?: 'front' | 'back';
+    resolution?: CameraResolution;
+    torch?: boolean;
+    autofocus?: boolean;
+    zoom?: number;
+    scanArea?: ScanArea;
+    overlay?: ScanOverlay;
+}
+/** Camera resolution */
+export interface CameraResolution {
+    width: number;
+    height: number;
+}
+/** Scan area */
+export interface ScanArea {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Scan overlay */
+export interface ScanOverlay {
+    type: 'rectangle' | 'square' | 'viewfinder' | 'custom';
+    color?: string;
+    strokeWidth?: number;
+    cornerRadius?: number;
+    showHint?: boolean;
+    hintText?: string;
+}
+/** Hardware scan config */
+export interface HardwareScanConfig {
+    deviceId?: string;
+    autoDetect?: boolean;
+    vendors?: ScannerVendor[];
+    triggerMode?: TriggerMode;
+    prefix?: string;
+    suffix?: string;
+    terminator?: string;
+}
+/** Scanner vendor */
+export type ScannerVendor = 'honeywell' | 'zebra' | 'datalogic' | 'symbol' | 'opticon' | 'socket' | 'generic';
+/** Trigger mode */
+export type TriggerMode = 'hardware' | 'software' | 'continuous';
+/** Scan feedback */
+export interface ScanFeedback {
+    sound?: boolean;
+    vibration?: boolean;
+    visual?: boolean;
+    successSound?: string;
+    errorSound?: string;
+}
+/** Scan history config */
+export interface ScanHistoryConfig {
+    enabled?: boolean;
+    maxItems?: number;
+    persist?: boolean;
+    deduplication?: boolean;
+    deduplicationWindow?: number;
+}
+/** Scan result */
+export interface ScanResult {
+    id: string;
+    data: string;
+    format: BarcodeSymbology;
+    timestamp: Date;
+    source: ScannerSource;
+    rawBytes?: Uint8Array;
+    metadata?: ScanMetadata;
+}
+/** Scan metadata */
+export interface ScanMetadata {
+    orientation?: number;
+    errorCorrectionLevel?: string;
+    structuredAppend?: StructuredAppend;
+    gs1Data?: GS1Data;
+}
+/** Structured append */
+export interface StructuredAppend {
+    index: number;
+    count: number;
+    parity?: number;
+}
+/** GS1 data */
+export interface GS1Data {
+    applicationIdentifiers: GS1AI[];
+    rawGTIN?: string;
+    productInfo?: GS1ProductInfo;
+}
+/** GS1 application identifier */
+export interface GS1AI {
+    ai: string;
+    value: string;
+    description?: string;
+}
+/** GS1 product info */
+export interface GS1ProductInfo {
+    gtin?: string;
+    serialNumber?: string;
+    batchNumber?: string;
+    expirationDate?: Date;
+    productionDate?: Date;
+    weight?: number;
+    count?: number;
+}
+/** Barcode generator config */
+export interface BarcodeGeneratorConfig {
+    format: BarcodeSymbology;
+    data: string;
+    width?: number;
+    height?: number;
+    margin?: number;
+    color?: string;
+    background?: string;
+    errorCorrection?: ErrorCorrectionLevel;
+    encoding?: BarcodeEncoding;
+    output?: BarcodeOutput;
+}
+/** Error correction level */
+export type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
+/** Barcode encoding */
+export interface BarcodeEncoding {
+    characterSet?: string;
+    fnc1Mode?: 'gs1' | 'aim';
+    eci?: number;
+}
+/** Barcode output */
+export interface BarcodeOutput {
+    format: 'svg' | 'png' | 'canvas' | 'dataurl';
+    scale?: number;
+    includeText?: boolean;
+    textFont?: string;
+    textSize?: number;
+    textPosition?: 'top' | 'bottom';
+}
+/** Generated barcode */
+export interface GeneratedBarcode {
+    data: string;
+    format: BarcodeSymbology;
+    output: string | ImageData | HTMLCanvasElement;
+    outputFormat: BarcodeOutput['format'];
+    width: number;
+    height: number;
+}
+/** Print config */
+export interface PrintConfig {
+    printerType: PrinterType;
+    printer?: PrinterSelection;
+    document?: DocumentPrintConfig;
+    label?: LabelPrintConfig;
+    receipt?: ReceiptPrintConfig;
+    queue?: PrintQueueConfig;
+}
+/** Printer type */
+export type PrinterType = 'document' | 'label' | 'receipt' | 'pos';
+/** Printer selection */
+export interface PrinterSelection {
+    id?: string;
+    name?: string;
+    autoSelect?: boolean;
+    preferredConnection?: HardwareConnectionType;
+}
+/** Document print config */
+export interface DocumentPrintConfig {
+    copies?: number;
+    collate?: boolean;
+    duplex?: DuplexMode;
+    orientation?: PageOrientation;
+    paperSize?: PaperSize;
+    margins?: PrintMargins;
+    colorMode?: ColorMode;
+    quality?: PrintQuality;
+    range?: PageRange;
+    scaling?: PrintScaling;
+}
+/** Duplex mode */
+export type DuplexMode = 'none' | 'long_edge' | 'short_edge';
+/** Page orientation */
+export type PageOrientation = 'portrait' | 'landscape' | 'auto';
+/** Paper size */
+export type PaperSize = 'letter' | 'legal' | 'a4' | 'a5' | 'a6' | 'custom';
+/** Print margins */
+export interface PrintMargins {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+    unit: 'mm' | 'in' | 'px';
+}
+/** Color mode */
+export type ColorMode = 'color' | 'grayscale' | 'monochrome';
+/** Print quality */
+export type PrintQuality = 'draft' | 'normal' | 'high' | 'photo';
+/** Page range */
+export interface PageRange {
+    from?: number;
+    to?: number;
+    pages?: number[];
+}
+/** Print scaling */
+export interface PrintScaling {
+    mode: 'none' | 'fit' | 'shrink' | 'custom';
+    factor?: number;
+}
+/** Label print config */
+export interface LabelPrintConfig {
+    labelSize: LabelSize;
+    mediaType?: LabelMediaType;
+    printSpeed?: number;
+    darkness?: number;
+    orientation?: LabelOrientation;
+    template?: LabelTemplate;
+    batch?: LabelBatch;
+}
+/** Label size */
+export interface LabelSize {
+    width: number;
+    height: number;
+    unit: 'mm' | 'in';
+    gap?: number;
+    offset?: LabelOffset;
+}
+/** Label offset */
+export interface LabelOffset {
+    x: number;
+    y: number;
+}
+/** Label media type */
+export type LabelMediaType = 'direct_thermal' | 'thermal_transfer' | 'continuous' | 'die_cut' | 'black_mark';
+/** Label orientation */
+export type LabelOrientation = 0 | 90 | 180 | 270;
+/** Label template */
+export interface LabelTemplate {
+    id: string;
+    name: string;
+    language: LabelLanguage;
+    content: string;
+    variables?: LabelVariable[];
+}
+/** Label language */
+export type LabelLanguage = 'zpl' | 'epl' | 'tspl' | 'escpos' | 'html';
+/** Label variable */
+export interface LabelVariable {
+    name: string;
+    type: 'text' | 'barcode' | 'qr' | 'image' | 'date' | 'counter';
+    default?: string;
+    format?: string;
+    position?: LabelPosition;
+}
+/** Label position */
+export interface LabelPosition {
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    rotation?: LabelOrientation;
+}
+/** Label batch */
+export interface LabelBatch {
+    data: LabelData[];
+    copies?: number;
+    separator?: boolean;
+}
+/** Label data */
+export interface LabelData {
+    variables: Record<string, string | number | boolean>;
+    copies?: number;
+}
+/** Receipt print config */
+export interface ReceiptPrintConfig {
+    paperWidth: ReceiptPaperWidth;
+    encoding?: ReceiptEncoding;
+    characterSet?: string;
+    lineSpacing?: number;
+    cutMode?: CutMode;
+    openDrawer?: boolean;
+    template?: ReceiptTemplate;
+}
+/** Receipt paper width */
+export type ReceiptPaperWidth = 58 | 80;
+/** Receipt encoding */
+export type ReceiptEncoding = 'utf8' | 'cp437' | 'cp850' | 'cp1252';
+/** Cut mode */
+export type CutMode = 'full' | 'partial' | 'none';
+/** Receipt template */
+export interface ReceiptTemplate {
+    header?: ReceiptSection;
+    body?: ReceiptContent[];
+    footer?: ReceiptSection;
+}
+/** Receipt section */
+export interface ReceiptSection {
+    logo?: ReceiptLogo;
+    lines?: ReceiptLine[];
+}
+/** Receipt logo */
+export interface ReceiptLogo {
+    data: string;
+    width?: number;
+    alignment?: TextAlignment;
+}
+/** Receipt line */
+export interface ReceiptLine {
+    type: 'text' | 'barcode' | 'qr' | 'divider' | 'space';
+    content?: string;
+    style?: ReceiptTextStyle;
+    barcode?: ReceiptBarcode;
+}
+/** Receipt text style */
+export interface ReceiptTextStyle {
+    bold?: boolean;
+    underline?: boolean;
+    inverse?: boolean;
+    doubleWidth?: boolean;
+    doubleHeight?: boolean;
+    alignment?: TextAlignment;
+    font?: 'A' | 'B' | 'C';
+}
+/** Text alignment */
+export type TextAlignment = 'left' | 'center' | 'right';
+/** Receipt barcode */
+export interface ReceiptBarcode {
+    symbology: BarcodeSymbology;
+    width?: number;
+    height?: number;
+    showText?: boolean;
+}
+/** Receipt content */
+export interface ReceiptContent {
+    type: 'item' | 'subtotal' | 'total' | 'payment' | 'text' | 'table';
+    item?: ReceiptItem;
+    subtotal?: ReceiptSubtotal;
+    total?: ReceiptTotal;
+    payment?: ReceiptPayment;
+    text?: ReceiptLine;
+    table?: ReceiptTable;
+}
+/** Receipt item */
+export interface ReceiptItem {
+    name: string;
+    quantity: number;
+    price: number;
+    total?: number;
+    discount?: number;
+    tax?: number;
+}
+/** Receipt subtotal */
+export interface ReceiptSubtotal {
+    label: string;
+    amount: number;
+}
+/** Receipt total */
+export interface ReceiptTotal {
+    label: string;
+    amount: number;
+    currency?: string;
+    taxDetails?: TaxDetail[];
+}
+/** Tax detail */
+export interface TaxDetail {
+    rate: number;
+    net: number;
+    tax: number;
+}
+/** Receipt payment */
+export interface ReceiptPayment {
+    method: string;
+    amount: number;
+    change?: number;
+}
+/** Receipt table */
+export interface ReceiptTable {
+    columns: ReceiptColumn[];
+    rows: string[][];
+}
+/** Receipt column */
+export interface ReceiptColumn {
+    width: number;
+    alignment?: TextAlignment;
+}
+/** Print queue config */
+export interface PrintQueueConfig {
+    enabled?: boolean;
+    maxJobs?: number;
+    retryCount?: number;
+    retryDelay?: number;
+    persistence?: QueuePersistence;
+}
+/** Queue persistence */
+export type QueuePersistence = 'memory' | 'localStorage' | 'indexeddb';
+/** Print job */
+export interface PrintJob {
+    id: string;
+    type: PrinterType;
+    status: PrintJobStatus;
+    printer?: string;
+    document?: string;
+    copies?: number;
+    pages?: number;
+    priority?: PrintPriority;
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    error?: string;
+    progress?: PrintProgress;
+}
+/** Print job status */
+export type PrintJobStatus = 'pending' | 'printing' | 'completed' | 'failed' | 'cancelled' | 'paused';
+/** Print priority */
+export type PrintPriority = 'low' | 'normal' | 'high' | 'urgent';
+/** Print progress */
+export interface PrintProgress {
+    currentPage: number;
+    totalPages: number;
+    percentage: number;
+}
+/** Payment terminal config */
+export interface PaymentTerminalConfig {
+    provider: PaymentProvider;
+    connection: TerminalConnection;
+    terminal?: TerminalSelection;
+    transactions?: TransactionConfig;
+    display?: TerminalDisplay;
+    callbacks?: TerminalCallbacks;
+}
+/** Payment provider */
+export type PaymentProvider = 'verifone' | 'ingenico' | 'pax' | 'sumup' | 'square' | 'stripe_terminal' | 'adyen' | 'worldpay' | 'clover' | 'generic';
+/** Terminal connection */
+export interface TerminalConnection {
+    type: HardwareConnectionType;
+    address?: string;
+    port?: number;
+    apiKey?: string;
+    locationId?: string;
+    timeout?: number;
+}
+/** Terminal selection */
+export interface TerminalSelection {
+    id?: string;
+    serialNumber?: string;
+    label?: string;
+    autoSelect?: boolean;
+}
+/** Transaction config */
+export interface TransactionConfig {
+    currency: string;
+    locale?: string;
+    tipEnabled?: boolean;
+    tipPresets?: TipPreset[];
+    cashbackEnabled?: boolean;
+    cashbackLimits?: CashbackLimits;
+    signatureRequired?: SignatureRequirement;
+    pinBypass?: boolean;
+    receiptMode?: ReceiptMode;
+}
+/** Tip preset */
+export interface TipPreset {
+    percentage?: number;
+    amount?: number;
+    label?: string;
+}
+/** Cashback limits */
+export interface CashbackLimits {
+    min: number;
+    max: number;
+    increments?: number[];
+}
+/** Signature requirement */
+export type SignatureRequirement = 'always' | 'threshold' | 'never';
+/** Receipt mode */
+export type ReceiptMode = 'print' | 'email' | 'sms' | 'none';
+/** Terminal display */
+export interface TerminalDisplay {
+    showAmount?: boolean;
+    showMerchantName?: boolean;
+    customText?: string;
+    idleScreen?: IdleScreen;
+}
+/** Idle screen */
+export interface IdleScreen {
+    type: 'logo' | 'text' | 'slideshow';
+    content?: string;
+    interval?: number;
+}
+/** Terminal callbacks */
+export interface TerminalCallbacks {
+    onStatusChange?: (status: TerminalStatus) => void;
+    onTransactionStart?: (transaction: PaymentTransaction) => void;
+    onTransactionComplete?: (transaction: PaymentTransaction) => void;
+    onTransactionError?: (error: PaymentError) => void;
+    onCardInserted?: () => void;
+    onCardRemoved?: () => void;
+    onPinEntry?: () => void;
+    onSignatureRequired?: (callback: SignatureCallback) => void;
+}
+/** Signature callback */
+export type SignatureCallback = (signature: string | null) => void;
+/** Terminal status */
+export interface TerminalStatus {
+    connected: boolean;
+    ready: boolean;
+    busy: boolean;
+    cardPresent: boolean;
+    batteryLevel?: number;
+    signalStrength?: number;
+    lastTransaction?: Date;
+}
+/** Payment transaction */
+export interface PaymentTransaction {
+    id: string;
+    type: PaymentTransactionType;
+    status: PaymentTransactionStatus;
+    amount: TransactionAmount;
+    card?: CardInfo;
+    terminal?: string;
+    merchantReference?: string;
+    createdAt: Date;
+    completedAt?: Date;
+    receipt?: TransactionReceipt;
+    response?: TransactionResponse;
+}
+/** Payment transaction type */
+export type PaymentTransactionType = 'sale' | 'refund' | 'void' | 'pre_auth' | 'capture' | 'adjustment';
+/** Payment transaction status */
+export type PaymentTransactionStatus = 'pending' | 'processing' | 'approved' | 'declined' | 'cancelled' | 'error' | 'timeout';
+/** Transaction amount */
+export interface TransactionAmount {
+    total: number;
+    currency: string;
+    subtotal?: number;
+    tax?: number;
+    tip?: number;
+    cashback?: number;
+    discount?: number;
+}
+/** Card info */
+export interface CardInfo {
+    type: CardType;
+    brand?: CardBrand;
+    lastFour?: string;
+    expiryMonth?: number;
+    expiryYear?: number;
+    entryMode?: CardEntryMode;
+    holderName?: string;
+    aid?: string;
+    applicationLabel?: string;
+}
+/** Card type */
+export type CardType = 'credit' | 'debit' | 'prepaid' | 'unknown';
+/** Card brand */
+export type CardBrand = 'visa' | 'mastercard' | 'amex' | 'discover' | 'diners' | 'jcb' | 'unionpay' | 'maestro' | 'unknown';
+/** Card entry mode */
+export type CardEntryMode = 'contact' | 'contactless' | 'swipe' | 'manual' | 'fallback';
+/** Transaction receipt */
+export interface TransactionReceipt {
+    merchantCopy?: string;
+    customerCopy?: string;
+    signatureLine?: boolean;
+}
+/** Transaction response */
+export interface TransactionResponse {
+    authCode?: string;
+    referenceNumber?: string;
+    responseCode?: string;
+    responseMessage?: string;
+    emvData?: Record<string, string>;
+}
+/** Payment error */
+export interface PaymentError {
+    code: string;
+    message: string;
+    details?: string;
+    recoverable?: boolean;
+}
+/** Measurement device config */
+export interface MeasurementDeviceConfig {
+    type: MeasurementDeviceType;
+    connection: MeasurementConnection;
+    polling?: PollingConfig;
+    calibration?: CalibrationConfig;
+    units?: UnitConfig;
+}
+/** Measurement device type */
+export type MeasurementDeviceType = 'scale' | 'temperature' | 'humidity' | 'pressure' | 'dimensioner' | 'flow_meter' | 'ph_meter' | 'custom';
+/** Measurement connection */
+export interface MeasurementConnection {
+    type: HardwareConnectionType;
+    address?: string;
+    port?: number;
+    baudRate?: number;
+    protocol?: MeasurementProtocol;
+}
+/** Measurement protocol */
+export type MeasurementProtocol = 'modbus_rtu' | 'modbus_tcp' | 'serial_ascii' | 'serial_binary' | 'hid' | 'custom';
+/** Polling config */
+export interface PollingConfig {
+    enabled?: boolean;
+    interval?: number;
+    timeout?: number;
+    retries?: number;
+}
+/** Calibration config */
+export interface CalibrationConfig {
+    enabled?: boolean;
+    points?: CalibrationPoint[];
+    lastCalibration?: Date;
+    nextCalibration?: Date;
+}
+/** Calibration point */
+export interface CalibrationPoint {
+    reference: number;
+    measured: number;
+    unit: string;
+}
+/** Unit config */
+export interface UnitConfig {
+    primary: string;
+    conversion?: UnitConversion[];
+    decimals?: number;
+}
+/** Unit conversion */
+export interface UnitConversion {
+    unit: string;
+    factor: number;
+    offset?: number;
+}
+/** Scale config */
+export interface ScaleConfig extends MeasurementDeviceConfig {
+    type: 'scale';
+    capacity?: ScaleCapacity;
+    tare?: TareConfig;
+    stability?: StabilityConfig;
+    zero?: ZeroConfig;
+}
+/** Scale capacity */
+export interface ScaleCapacity {
+    min: number;
+    max: number;
+    unit: WeightUnit;
+    division: number;
+}
+/** Weight unit */
+export type WeightUnit = 'kg' | 'g' | 'lb' | 'oz' | 't';
+/** Tare config */
+export interface TareConfig {
+    autoTare?: boolean;
+    maxTare?: number;
+    presetTares?: PresetTare[];
+}
+/** Preset tare */
+export interface PresetTare {
+    name: string;
+    weight: number;
+    unit: WeightUnit;
+}
+/** Stability config */
+export interface StabilityConfig {
+    required?: boolean;
+    timeout?: number;
+    tolerance?: number;
+}
+/** Zero config */
+export interface ZeroConfig {
+    autoZero?: boolean;
+    zeroRange?: number;
+    zeroTracking?: boolean;
+}
+/** Scale reading */
+export interface ScaleReading {
+    gross: number;
+    net: number;
+    tare: number;
+    unit: WeightUnit;
+    stable: boolean;
+    overload?: boolean;
+    underload?: boolean;
+    zero?: boolean;
+    timestamp: Date;
+}
+/** Temperature sensor config */
+export interface TemperatureSensorConfig extends MeasurementDeviceConfig {
+    type: 'temperature';
+    sensorType?: TemperatureSensorType;
+    range?: TemperatureRange;
+    alerts?: TemperatureAlert[];
+    logging?: TemperatureLogging;
+}
+/** Temperature sensor type */
+export type TemperatureSensorType = 'thermocouple' | 'rtd' | 'thermistor' | 'infrared' | 'digital';
+/** Temperature range */
+export interface TemperatureRange {
+    min: number;
+    max: number;
+    unit: TemperatureUnit;
+}
+/** Temperature unit */
+export type TemperatureUnit = 'C' | 'F' | 'K';
+/** Temperature alert */
+export interface TemperatureAlert {
+    id: string;
+    name: string;
+    type: 'high' | 'low' | 'range';
+    threshold?: number;
+    minThreshold?: number;
+    maxThreshold?: number;
+    hysteresis?: number;
+    delay?: number;
+    actions?: AlertAction[];
+}
+/** Alert action */
+export interface AlertAction {
+    type: 'email' | 'sms' | 'webhook' | 'sound' | 'visual';
+    target?: string;
+    message?: string;
+}
+/** Temperature logging */
+export interface TemperatureLogging {
+    enabled?: boolean;
+    interval?: number;
+    retention?: number;
+    format?: 'csv' | 'json';
+}
+/** Temperature reading */
+export interface TemperatureReading {
+    value: number;
+    unit: TemperatureUnit;
+    sensorId?: string;
+    ambient?: number;
+    humidity?: number;
+    timestamp: Date;
+    alerts?: string[];
+}
+/** Dimensioner config */
+export interface DimensionerConfig extends MeasurementDeviceConfig {
+    type: 'dimensioner';
+    measurementMode?: DimensionMeasurementMode;
+    units?: DimensionUnits;
+    integration?: DimensionerIntegration;
+}
+/** Dimension measurement mode */
+export type DimensionMeasurementMode = 'static' | 'dynamic' | 'certified';
+/** Dimension units */
+export interface DimensionUnits {
+    /** Primary unit (required by UnitConfig) */
+    primary: string;
+    length: LengthUnit;
+    volume?: VolumeUnit;
+    weight?: WeightUnit;
+    /** Optional conversion factors */
+    conversion?: Array<{
+        unit: string;
+        factor: number;
+        offset?: number;
+    }>;
+    /** Decimal places */
+    decimals?: number;
+}
+/** Length unit */
+export type LengthUnit = 'mm' | 'cm' | 'm' | 'in' | 'ft';
+/** Volume unit */
+export type VolumeUnit = 'cm3' | 'm3' | 'in3' | 'ft3' | 'L';
+/** Dimensioner integration */
+export interface DimensionerIntegration {
+    scale?: boolean;
+    scanner?: boolean;
+    camera?: boolean;
+}
+/** Dimension reading */
+export interface DimensionReading {
+    length: number;
+    width: number;
+    height: number;
+    unit: LengthUnit;
+    volume?: number;
+    volumeUnit?: VolumeUnit;
+    weight?: number;
+    weightUnit?: WeightUnit;
+    barcode?: string;
+    image?: string;
+    certified?: boolean;
+    timestamp: Date;
+}
+/** Serial device config */
+export interface SerialDeviceConfig {
+    port: string;
+    baudRate: SerialBaudRate;
+    dataBits?: SerialDataBits;
+    stopBits?: SerialStopBits;
+    parity?: SerialParity;
+    flowControl?: SerialFlowControl;
+    encoding?: string;
+    delimiter?: string | number[];
+    timeout?: number;
+}
+/** Serial baud rate */
+export type SerialBaudRate = 300 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400 | 57600 | 115200 | 230400 | 460800 | 921600;
+/** Serial data bits */
+export type SerialDataBits = 5 | 6 | 7 | 8;
+/** Serial stop bits */
+export type SerialStopBits = 1 | 1.5 | 2;
+/** Serial parity */
+export type SerialParity = 'none' | 'even' | 'odd' | 'mark' | 'space';
+/** Serial flow control */
+export type SerialFlowControl = 'none' | 'hardware' | 'software';
+/** Serial command */
+export interface SerialCommand {
+    command: string | number[];
+    expectedResponse?: string | RegExp;
+    timeout?: number;
+    retries?: number;
+}
+/** Serial response */
+export interface SerialResponse {
+    data: string | Uint8Array;
+    timestamp: Date;
+    duration: number;
+}
+/** BLE config */
+export interface BLEConfig {
+    services?: BLEServiceFilter[];
+    scanDuration?: number;
+    autoReconnect?: boolean;
+    reconnectInterval?: number;
+}
+/** BLE service filter */
+export interface BLEServiceFilter {
+    uuid: string;
+    name?: string;
+}
+/** BLE device */
+export interface BLEDevice {
+    id: string;
+    name?: string;
+    rssi?: number;
+    services: BLEService[];
+    connected: boolean;
+    bonded?: boolean;
+}
+/** BLE service */
+export interface BLEService {
+    uuid: string;
+    primary: boolean;
+    characteristics: BLECharacteristic[];
+}
+/** BLE characteristic */
+export interface BLECharacteristic {
+    uuid: string;
+    properties: BLEProperties;
+    descriptors?: BLEDescriptor[];
+}
+/** BLE properties */
+export interface BLEProperties {
+    read?: boolean;
+    write?: boolean;
+    writeWithoutResponse?: boolean;
+    notify?: boolean;
+    indicate?: boolean;
+}
+/** BLE descriptor */
+export interface BLEDescriptor {
+    uuid: string;
+    value?: Uint8Array;
+}
+/** Modbus config */
+export interface ModbusConfig {
+    mode: ModbusMode;
+    connection: ModbusConnection;
+    device: ModbusDevice;
+    registers?: ModbusRegisterMap[];
+}
+/** Modbus mode */
+export type ModbusMode = 'rtu' | 'tcp' | 'ascii';
+/** Modbus connection */
+export interface ModbusConnection {
+    port?: string;
+    baudRate?: number;
+    parity?: SerialParity;
+    host?: string;
+    tcpPort?: number;
+}
+/** Modbus device */
+export interface ModbusDevice {
+    unitId: number;
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+}
+/** Modbus register map */
+export interface ModbusRegisterMap {
+    name: string;
+    address: number;
+    type: ModbusRegisterType;
+    dataType: ModbusDataType;
+    count?: number;
+    scale?: number;
+    offset?: number;
+    unit?: string;
+    description?: string;
+}
+/** Modbus register type */
+export type ModbusRegisterType = 'coil' | 'discrete_input' | 'holding_register' | 'input_register';
+/** Modbus data type */
+export type ModbusDataType = 'bool' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'float32' | 'float64' | 'string';
+/** Modbus reading */
+export interface ModbusReading {
+    register: string;
+    value: number | boolean | string;
+    raw?: number[];
+    timestamp: Date;
+}
+//# sourceMappingURL=hardware-integration.d.ts.map