@nice2dev/ui-printing 1.0.28

package/src/template-editor/index.ts

@@ -0,0 +1 @@
+export { NiceTemplateEditor } from './NiceTemplateEditor';

package/src/types/printingTypes.ts

@@ -0,0 +1,301 @@
+// ─── Primitives ───────────────────────────────────────────────────────────────
+export type TemplateId = string;
+export type PrintJobId = string;
+export type PrinterId = string;
+export type FieldId = string;
+
+// ─── Paper ───────────────────────────────────────────────────────────────────
+export type PaperSize = 'A3' | 'A4' | 'A5' | 'A6' | 'Letter' | 'Legal' | 'Tabloid' | 'custom';
+export type PaperOrientation = 'portrait' | 'landscape';
+
+export interface PaperMargins {
+  top: number; // mm
+  right: number;
+  bottom: number;
+  left: number;
+}
+
+export interface CustomPaperSize {
+  widthMm: number;
+  heightMm: number;
+}
+
+// ─── Fields ───────────────────────────────────────────────────────────────────
+export type PrintFieldType =
+  | 'text'
+  | 'number'
+  | 'currency'
+  | 'date'
+  | 'datetime'
+  | 'boolean'
+  | 'image'
+  | 'barcode'
+  | 'qr'
+  | 'signature'
+  | 'static_text'
+  | 'static_image'
+  | 'line'
+  | 'rect'
+  | 'page_number'
+  | 'total_pages'
+  | 'print_date';
+
+export type BarcodeType = 'ean13' | 'ean8' | 'code128' | 'code39' | 'upc' | 'itf14' | 'datamatrix';
+
+export interface FieldPosition {
+  x: number; // mm from left
+  y: number; // mm from top
+  width: number; // mm
+  height: number; // mm
+  zIndex?: number;
+}
+
+export interface FieldStyle {
+  fontFamily?: string;
+  fontSize?: number; // pt
+  fontWeight?: 'normal' | 'bold';
+  fontStyle?: 'normal' | 'italic';
+  color?: string;
+  backgroundColor?: string;
+  textAlign?: 'left' | 'center' | 'right' | 'justify';
+  verticalAlign?: 'top' | 'middle' | 'bottom';
+  borderWidth?: number;
+  borderColor?: string;
+  borderStyle?: 'solid' | 'dashed' | 'dotted';
+  borderRadius?: number;
+  padding?: number; // mm
+  lineHeight?: number;
+  letterSpacing?: number; // em
+  opacity?: number;
+  rotation?: number; // degrees
+}
+
+export interface PrintDataField {
+  id: FieldId;
+  name: string;
+  label: string;
+  type: PrintFieldType;
+  dataPath: string; // dot-notation e.g. "invoice.number"
+  format?: string; // e.g. "DD.MM.YYYY", "#,##0.00", "EUR"
+  fallback?: string; // shown when dataPath resolves to null
+  barcodeType?: BarcodeType;
+  position: FieldPosition;
+  style: FieldStyle;
+  conditional?: {
+    field: string;
+    operator: 'eq' | 'neq' | 'gt' | 'lt' | 'contains';
+    value: unknown;
+  };
+}
+
+// ─── Watermark ────────────────────────────────────────────────────────────────
+export type WatermarkType = 'text' | 'image';
+
+export interface PrintWatermark {
+  id: string;
+  type: WatermarkType;
+  text?: string;
+  imageUrl?: string;
+  opacity: number; // 0-1
+  angle: number; // degrees
+  fontSize?: number; // pt for text watermarks
+  color?: string;
+  repeat?: boolean; // tile watermark across page
+  position?: 'center' | 'diagonal' | 'tile' | { x: number; y: number };
+}
+
+// ─── Signature ────────────────────────────────────────────────────────────────
+export interface PrintSignature {
+  id: string;
+  label: string; // "Podpis zleceniodawcy"
+  position: FieldPosition;
+  signerName?: string; // pre-filled name
+  signerEmail?: string;
+  showDate?: boolean;
+  showLine?: boolean; // draw signature line
+  style?: FieldStyle;
+}
+
+// ─── Template sections ────────────────────────────────────────────────────────
+export type SectionType = 'header' | 'body' | 'footer' | 'background';
+
+export interface PrintSection {
+  id: string;
+  type: SectionType;
+  heightMm?: number; // fixed height; undefined = auto for body
+  fields: PrintDataField[];
+  repeatForEach?: string; // data path for repeated sections e.g. "invoice.items"
+  showOnFirstPage?: boolean;
+  showOnLastPage?: boolean;
+}
+
+// ─── Template ─────────────────────────────────────────────────────────────────
+export interface PrintTemplate {
+  id: TemplateId;
+  name: string;
+  description?: string;
+  category?: string;
+  tags?: string[];
+  paperSize: PaperSize;
+  customSize?: CustomPaperSize;
+  orientation: PaperOrientation;
+  margins: PaperMargins;
+  sections: PrintSection[];
+  watermarks?: PrintWatermark[];
+  signatures?: PrintSignature[];
+  dataSchema?: DataSourceSchema;
+  previewImageUrl?: string;
+  createdAt?: string;
+  updatedAt?: string;
+  version?: number;
+}
+
+// ─── Data source ──────────────────────────────────────────────────────────────
+export interface DataSourceField {
+  path: string; // e.g. "invoice.number"
+  label: string;
+  type: 'string' | 'number' | 'boolean' | 'date' | 'image' | 'array' | 'object';
+  description?: string;
+  example?: unknown;
+}
+
+export interface DataSourceSchema {
+  entityName: string;
+  entityLabel: string;
+  fields: DataSourceField[];
+}
+
+export interface TemplateSampleData {
+  entityName: string;
+  label?: string;
+  data: Record<string, unknown>;
+}
+
+// ─── Printer ──────────────────────────────────────────────────────────────────
+export interface PrinterCapabilities {
+  color: boolean;
+  duplex: boolean;
+  paperSizes: PaperSize[];
+  maxCopies?: number;
+  dpi?: number[];
+}
+
+export interface PrinterInfo {
+  id: PrinterId;
+  name: string;
+  isDefault: boolean;
+  isOnline: boolean;
+  status?: 'ready' | 'busy' | 'offline' | 'error';
+  location?: string;
+  capabilities: PrinterCapabilities;
+}
+
+// ─── Print job ────────────────────────────────────────────────────────────────
+export type PrintJobStatus = 'queued' | 'printing' | 'done' | 'error' | 'paused' | 'cancelled';
+
+export interface PrintJobOptions {
+  copies: number;
+  printerId: PrinterId;
+  paperSize?: PaperSize;
+  orientation?: PaperOrientation;
+  colorMode?: 'color' | 'grayscale' | 'black_white';
+  duplex?: boolean;
+  quality?: 'draft' | 'normal' | 'high';
+  pageRanges?: string; // e.g. "1-3,5"
+}
+
+export interface PrintJob {
+  id: PrintJobId;
+  templateId: TemplateId;
+  templateName: string;
+  entityData?: Record<string, unknown>;
+  entityLabel?: string; // human-readable e.g. "Faktura #2024/001"
+  options: PrintJobOptions;
+  status: PrintJobStatus;
+  progress?: number; // 0-100 for printing
+  errorMessage?: string;
+  pages?: number;
+  createdAt: string;
+  startedAt?: string;
+  completedAt?: string;
+  priority?: number; // lower = higher priority
+}
+
+// ─── Component props ──────────────────────────────────────────────────────────
+import type { CSSProperties } from 'react';
+
+export interface NiceTemplateEditorProps {
+  template?: PrintTemplate;
+  dataSchema?: DataSourceSchema;
+  sampleData?: TemplateSampleData[];
+  availableEntities?: TemplateSampleData[];
+  onChange?: (template: PrintTemplate) => void;
+  onSave?: (template: PrintTemplate) => void;
+  readOnly?: boolean;
+  className?: string;
+  style?: CSSProperties;
+  theme?: 'light' | 'dark';
+}
+
+export interface NiceTemplateBrowserProps {
+  templates: PrintTemplate[];
+  selectedId?: TemplateId;
+  onSelect?: (template: PrintTemplate) => void;
+  onImport?: (template: PrintTemplate) => void;
+  onExport?: (template: PrintTemplate) => void;
+  onDelete?: (templateId: TemplateId) => void;
+  onNew?: () => void;
+  className?: string;
+  style?: CSSProperties;
+  theme?: 'light' | 'dark';
+}
+
+export interface NicePrintPreviewProps {
+  template: PrintTemplate;
+  entities?: Record<string, unknown>[];
+  sampleData?: TemplateSampleData;
+  activePrinterId?: PrinterId;
+  onPrint?: (options: Partial<PrintJobOptions>) => void;
+  className?: string;
+  style?: CSSProperties;
+  theme?: 'light' | 'dark';
+  /**
+   * When true (default), preview renders inside a portaled overlay with a close button.
+   * When false, renders inline at the call site (legacy behavior — replaces current page area).
+   */
+  asPopup?: boolean;
+  /** Controls overlay visibility when asPopup is true (uncontrolled if omitted). */
+  open?: boolean;
+  /** Called when the user closes the popup. */
+  onClose?: () => void;
+}
+
+export interface NicePrintQueueProps {
+  jobs: PrintJob[];
+  printers?: PrinterInfo[];
+  onJobUpdate: (id: PrintJobId, patch: Partial<PrintJob>) => void;
+  onJobRemove: (id: PrintJobId) => void;
+  onJobReorder: (fromIndex: number, toIndex: number) => void;
+  onJobPrint: (id: PrintJobId) => void;
+  onBulkRemove?: (ids: PrintJobId[]) => void;
+  onBulkPrint?: (ids: PrintJobId[]) => void;
+  maxHeight?: number;
+  className?: string;
+  style?: CSSProperties;
+  theme?: 'light' | 'dark';
+}
+
+export interface NicePrintButtonProps {
+  onPrint: (options: PrintJobOptions) => void;
+  printers?: PrinterInfo[];
+  defaultPrinterId?: PrinterId;
+  defaultCopies?: number;
+  disabled?: boolean;
+  loading?: boolean;
+  label?: string;
+  variant?: 'primary' | 'secondary' | 'ghost';
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+  style?: CSSProperties;
+  theme?: 'light' | 'dark';
+}