@numerum-tech/yeriasdk 1.0.0

package/dist/core/message-view.d.ts

@@ -0,0 +1,53 @@
+import { BaseView } from './base-view';
+import { SubmitAction, HttpMethod } from '../types';
+export type MessageSeverity = 'info' | 'success' | 'warning' | 'error';
+export interface MessageContent {
+    title: string;
+    intro: string;
+    body: string;
+    severity: MessageSeverity;
+    confirm: SubmitAction;
+    cancel?: SubmitAction;
+    canDismiss: boolean;
+    meta?: Record<string, unknown>;
+}
+export declare class MessageView extends BaseView {
+    constructor(viewId: string, title: string, processId?: string);
+    /**
+     * Définit le texte d'introduction
+     */
+    setIntro(intro: string): this;
+    /**
+     * Définit le corps principal du message
+     */
+    setBody(body: string): this;
+    /**
+     * Définit la sévérité du message (info, success, warning, error)
+     */
+    setSeverity(severity: MessageSeverity): this;
+    /**
+     * Configure l'action principale (OK)
+     */
+    setPrimaryAction(text: string, method?: HttpMethod, confirmMessage?: string): this;
+    /**
+     * Alias de compatibilité avec l'ancienne API
+     */
+    submitButton(text: string, method?: HttpMethod, confirmMessage?: string): this;
+    /**
+     * Configure l'action secondaire (Cancel / Reject)
+     */
+    setSecondaryAction(text: string, method?: HttpMethod, confirmMessage?: string): this;
+    /**
+     * Supprime l'action secondaire si elle existe
+     */
+    clearSecondaryAction(): this;
+    /**
+     * Définit si le message peut être fermé sans action
+     */
+    setDismissible(dismissible?: boolean): this;
+    /**
+     * Ajoute des métadonnées spécifiques au message
+     */
+    setMetadata(metadata: Record<string, unknown>): this;
+}
+//# sourceMappingURL=message-view.d.ts.map

package/dist/core/message-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-view.d.ts","sourceRoot":"","sources":["../../src/core/message-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGpD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,WAAY,SAAQ,QAAQ;gBACzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAwB7D;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS3B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAK5C;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,UAAmB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAc1F;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,UAAmB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAItF;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,UAAmB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAc5F;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAK5B;;OAEG;IACH,cAAc,CAAC,WAAW,GAAE,OAAc,GAAG,IAAI;IAKjD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAKvD"}

package/dist/core/message-view.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageView = void 0;
+const base_view_1 = require("./base-view");
+const errors_1 = require("../errors");
+class MessageView extends base_view_1.BaseView {
+    constructor(viewId, title, processId) {
+        super({
+            id: viewId,
+            type: 'Message',
+            processId,
+            metadata: {
+                version: '1.0.0',
+                createdAt: new Date()
+            }
+        });
+        this.content = {
+            title,
+            intro: '',
+            body: '',
+            severity: 'info',
+            confirm: {
+                text: 'OK',
+                method: 'POST'
+            },
+            canDismiss: false
+        };
+    }
+    /**
+     * Définit le texte d'introduction
+     */
+    setIntro(intro) {
+        return this.setIntroText('intro', intro);
+    }
+    /**
+     * Définit le corps principal du message
+     */
+    setBody(body) {
+        if (!body || body.trim().length === 0) {
+            throw new errors_1.InvalidParameterError('body', body, 'Message body cannot be empty');
+        }
+        this.content.body = body.trim();
+        return this;
+    }
+    /**
+     * Définit la sévérité du message (info, success, warning, error)
+     */
+    setSeverity(severity) {
+        this.content.severity = severity;
+        return this;
+    }
+    /**
+     * Configure l'action principale (OK)
+     */
+    setPrimaryAction(text, method = 'POST', confirmMessage) {
+        if (!text || text.trim().length === 0) {
+            throw new errors_1.InvalidParameterError('text', text, 'Primary action text cannot be empty');
+        }
+        this.content.confirm = {
+            text: text.trim(),
+            method,
+            confirmMessage
+        };
+        return this;
+    }
+    /**
+     * Alias de compatibilité avec l'ancienne API
+     */
+    submitButton(text, method = 'POST', confirmMessage) {
+        return this.setPrimaryAction(text, method, confirmMessage);
+    }
+    /**
+     * Configure l'action secondaire (Cancel / Reject)
+     */
+    setSecondaryAction(text, method = 'POST', confirmMessage) {
+        if (!text || text.trim().length === 0) {
+            throw new errors_1.InvalidParameterError('text', text, 'Secondary action text cannot be empty');
+        }
+        this.content.cancel = {
+            text: text.trim(),
+            method,
+            confirmMessage
+        };
+        return this;
+    }
+    /**
+     * Supprime l'action secondaire si elle existe
+     */
+    clearSecondaryAction() {
+        this.content.cancel = undefined;
+        return this;
+    }
+    /**
+     * Définit si le message peut être fermé sans action
+     */
+    setDismissible(dismissible = true) {
+        this.content.canDismiss = dismissible;
+        return this;
+    }
+    /**
+     * Ajoute des métadonnées spécifiques au message
+     */
+    setMetadata(metadata) {
+        this.content.meta = { ...metadata };
+        return this;
+    }
+}
+exports.MessageView = MessageView;
+//# sourceMappingURL=message-view.js.map

package/dist/core/message-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-view.js","sourceRoot":"","sources":["../../src/core/message-view.ts"],"names":[],"mappings":"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"}

package/dist/core/notification.d.ts

@@ -0,0 +1,17 @@
+import { NotificationPayload } from '../types';
+export declare class Notification {
+    private userId;
+    private message;
+    constructor(userId: string, title: string, body: string, link?: string);
+    /**
+     * Sets the optional in-app navigation link
+     * @param link - Link URL (e.g., "/profile" or "app://view/123")
+     * @returns this for chaining
+     */
+    setLink(link: string): this;
+    /**
+     * Returns the notification payload as JSON
+     */
+    toJSON(): NotificationPayload;
+}
+//# sourceMappingURL=notification.d.ts.map

package/dist/core/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/core/notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpE,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAsB;gBAEzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAQtE;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,MAAM,IAAI,mBAAmB;CAMhC"}

package/dist/core/notification.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Notification = void 0;
+const errors_1 = require("../errors");
+class Notification {
+    constructor(userId, title, body, link) {
+        if (!userId || !title || !body) {
+            throw new errors_1.MissingRequiredParameterError('userId, title, and body');
+        }
+        this.userId = userId;
+        this.message = { title, body, link };
+    }
+    /**
+     * Sets the optional in-app navigation link
+     * @param link - Link URL (e.g., "/profile" or "app://view/123")
+     * @returns this for chaining
+     */
+    setLink(link) {
+        this.message.link = link;
+        return this;
+    }
+    /**
+     * Returns the notification payload as JSON
+     */
+    toJSON() {
+        return {
+            userId: this.userId,
+            message: this.message
+        };
+    }
+}
+exports.Notification = Notification;
+//# sourceMappingURL=notification.js.map

package/dist/core/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../src/core/notification.ts"],"names":[],"mappings":";;;AACA,sCAA0D;AAE1D,MAAa,YAAY;IAIrB,YAAY,MAAc,EAAE,KAAa,EAAE,IAAY,EAAE,IAAa;QAClE,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,sCAA6B,CAAC,yBAAyB,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAY;QAChB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM;QACF,OAAO;YACH,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB,CAAC;IACN,CAAC;CACJ;AA/BD,oCA+BC"}

package/dist/core/qr-display-view.d.ts

@@ -0,0 +1,32 @@
+import { BaseView } from './base-view';
+import { SubmitAction, QRConfig, HttpMethod } from '../types';
+export interface QRDisplayContent {
+    title: string;
+    intro: string;
+    submit?: SubmitAction;
+    qrImage: string;
+    qrTitle: string;
+    qrDescription: string;
+    qrConfig?: QRConfig;
+}
+export declare class QRDisplayView extends BaseView {
+    constructor(viewId: string, title: string, processId?: string);
+    /**
+     * Définit l'introduction
+     */
+    setIntro(intro: string): this;
+    /**
+     * Defines the submit button for QR display actions
+     * Convention: Mobile app POSTs action to {service.baseUrl}/{viewId}
+     * Common use cases: Share, Export, etc.
+     *
+     * @param text - Button text (e.g., "Share", "Export")
+     * @param method - HTTP method (default: POST)
+     */
+    submitButton(text: string, method?: HttpMethod): this;
+    /**
+     * Sets the QR code to display (replaces any existing QR code)
+     */
+    setQRCode(qrImage: string, title: string, description: string, config?: QRConfig): this;
+}
+//# sourceMappingURL=qr-display-view.d.ts.map

package/dist/core/qr-display-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-display-view.d.ts","sourceRoot":"","sources":["../../src/core/qr-display-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG9D,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC3B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAqB7D;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,UAAmB,GAAG,IAAI;IAS7D;;OAEG;IACH,SAAS,CACL,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,QAAQ,GAClB,IAAI;CAkBV"}

package/dist/core/qr-display-view.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QRDisplayView = void 0;
+const base_view_1 = require("./base-view");
+const errors_1 = require("../errors");
+class QRDisplayView extends base_view_1.BaseView {
+    constructor(viewId, title, processId) {
+        super({
+            id: viewId,
+            type: 'QRDisplay',
+            processId,
+            metadata: {
+                version: '1.0.0',
+                createdAt: new Date()
+            }
+        });
+        this.content = {
+            title,
+            intro: '',
+            submit: undefined,
+            qrImage: '',
+            qrTitle: '',
+            qrDescription: ''
+        };
+    }
+    /**
+     * Définit l'introduction
+     */
+    setIntro(intro) {
+        return this.setIntroText('intro', intro);
+    }
+    /**
+     * Defines the submit button for QR display actions
+     * Convention: Mobile app POSTs action to {service.baseUrl}/{viewId}
+     * Common use cases: Share, Export, etc.
+     *
+     * @param text - Button text (e.g., "Share", "Export")
+     * @param method - HTTP method (default: POST)
+     */
+    submitButton(text, method = 'POST') {
+        this.content.submit = {
+            text,
+            method
+        };
+        return this;
+    }
+    /**
+     * Sets the QR code to display (replaces any existing QR code)
+     */
+    setQRCode(qrImage, title, description, config) {
+        if (!qrImage || !title || !description) {
+            throw new errors_1.MissingRequiredParameterError('qrImage, title, and description');
+        }
+        // Validation de l'URL ou base64
+        if (!(qrImage.startsWith('http') || qrImage.startsWith('data:image/'))) {
+            throw new errors_1.InvalidParameterError('qrImage', qrImage, 'Invalid QR image. Provide a valid URL or base64 string.');
+        }
+        this.content.qrImage = qrImage;
+        this.content.qrTitle = title;
+        this.content.qrDescription = description;
+        this.content.qrConfig = config;
+        return this;
+    }
+}
+exports.QRDisplayView = QRDisplayView;
+//# sourceMappingURL=qr-display-view.js.map

package/dist/core/qr-display-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-display-view.js","sourceRoot":"","sources":["../../src/core/qr-display-view.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AAEvC,sCAAiF;AAYjF,MAAa,aAAc,SAAQ,oBAAQ;IACvC,YAAY,MAAc,EAAE,KAAa,EAAE,SAAkB;QACzD,KAAK,CAAC;YACF,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,WAAW;YACjB,SAAS;YACT,QAAQ,EAAE;gBACN,OAAO,EAAE,OAAO;gBAChB,SAAS,EAAE,IAAI,IAAI,EAAE;aACxB;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG;YACX,KAAK;YACL,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,EAAE;YACX,aAAa,EAAE,EAAE;SACA,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,IAAY,EAAE,SAAqB,MAAM;QACjD,IAAI,CAAC,OAA4B,CAAC,MAAM,GAAG;YACxC,IAAI;YACJ,MAAM;SACT,CAAC;QAEF,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,SAAS,CACL,OAAe,EACf,KAAa,EACb,WAAmB,EACnB,MAAiB;QAEjB,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,sCAA6B,CAAC,iCAAiC,CAAC,CAAC;QAC/E,CAAC;QAED,gCAAgC;QAChC,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,8BAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,yDAAyD,CAAC,CAAC;QACnH,CAAC;QAEA,IAAI,CAAC,OAA4B,CAAC,OAAO,GAAG,OAAO,CAAC;QACpD,IAAI,CAAC,OAA4B,CAAC,OAAO,GAAG,KAAK,CAAC;QAClD,IAAI,CAAC,OAA4B,CAAC,aAAa,GAAG,WAAW,CAAC;QAC9D,IAAI,CAAC,OAA4B,CAAC,QAAQ,GAAG,MAAM,CAAC;QAErD,OAAO,IAAI,CAAC;IAChB,CAAC;CAEJ;AAxED,sCAwEC"}

package/dist/core/qr-scan-view.d.ts

@@ -0,0 +1,148 @@
+import { BaseView } from './base-view';
+/**
+ * QRScanView - A view for scanning QR codes
+ *
+ * **Design Principles:**
+ * - Mobile app handles ALL scanner implementation (camera, torch, focus, formats, UI)
+ * - View only describes what to scan and where to submit
+ * - Convention: Field name is ALWAYS "qrData" (not configurable)
+ * - Auto-submit by default: scan → immediately POST { qrData: "ABC123" }
+ * - Submit button disables auto-submit for manual confirmation workflows
+ *
+ * **Submission Convention:**
+ * - Auto-submit: POST {service.baseUrl}/{viewId} with { qrData: "scanned-value" }
+ * - With button: User scans, previews, clicks button to submit
+ *
+ * @example
+ * // Simple: Auto-submit after scan
+ * const view = new QRScanView('scan-ticket', 'Scan Your Ticket')
+ *     .setIntro('Point camera at the QR code on your ticket');
+ * // → Scans, immediately POSTs { qrData: "ABC123" } to {baseUrl}/scan-ticket
+ *
+ * @example
+ * // Manual confirmation workflow
+ * const view = new QRScanView('verify-product', 'Verify Product')
+ *     .setIntro('Scan the product barcode')
+ *     .enablePreview(true, 'Product Code')
+ *     .submitButton('Verify Product');
+ * // → Scans, shows preview, user clicks "Verify Product" to submit
+ *
+ * @example
+ * // With validation
+ * const view = new QRScanView('scan-invoice', 'Scan Invoice')
+ *     .setIntro('Scan the invoice QR code')
+ *     .setValidation(/^INV-\d{6}$/, 'Invalid invoice format')
+ *     .submitButton('Process Invoice');
+ * // → Scans, validates pattern, shows preview, submits on button click
+ */
+export declare class QRScanView extends BaseView {
+    constructor(viewId: string, title: string, processId?: string);
+    /**
+     * Sets instructional text shown to the user
+     *
+     * @param intro - Instructions like "Point your camera at the QR code"
+     * @returns this for chaining
+     *
+     * @example
+     * view.setIntro('Scan the code on your membership card');
+     */
+    setIntro(intro: string): this;
+    /**
+     * Configures a submit button for manual confirmation
+     * **IMPORTANT**: Automatically disables auto-submit when button is added
+     * **Note**: QRScan submissions are always POST (convention-based security)
+     *
+     * @param text - Button text like "Confirm", "Process", "Submit"
+     * @param confirmMessage - Optional confirmation dialog
+     * @returns this for chaining
+     *
+     * @example
+     * view.submitButton('Verify Code');
+     * // User must click button after scanning
+     *
+     * @example
+     * view.submitButton('Process', 'Are you sure?');
+     */
+    submitButton(text: string, confirmMessage?: string): this;
+    /**
+     * Sets simple validation rules for scanned data
+     * **IMPORTANT**: Mobile app validates client-side for UX, but server MUST re-validate for security
+     *
+     * @param errorMessage - Error message shown on validation failure
+     * @param format - Data format: 'text' (any), 'number' (digits only), 'url' (http/https), 'email' (has @ and .)
+     * @param minLength - Minimum length (includes prefix if startsWith is set)
+     * @param maxLength - Maximum length (includes prefix if startsWith is set)
+     * @param startsWith - Required prefix (exempt from format validation)
+     * @returns this for chaining
+     *
+     * @example
+     * // Numeric code with exact length
+     * view.setValidation('Code must be 6 digits', 'number', 6, 6);
+     * // Accepts: "123456", "000001"
+     *
+     * @example
+     * // Prefix + format + length range
+     * view.setValidation('Invalid invoice', 'number', 10, 15, 'INV-');
+     * // Accepts: "INV-123456" (10-15 chars total, digits after INV-)
+     *
+     * @example
+     * // Email format
+     * view.setValidation('Invalid email format', 'email');
+     * // Accepts: "user@example.com" (simple check: has @ and .)
+     *
+     * @example
+     * // URL format
+     * view.setValidation('Invalid URL', 'url');
+     * // Accepts: "https://example.com" (starts with http:// or https://)
+     *
+     * @example
+     * // Just prefix, any content after
+     * view.setValidation('Must start with TICKET-', undefined, undefined, undefined, 'TICKET-');
+     * // Accepts: "TICKET-ABC123", "TICKET-XYZ"
+     *
+     * @example
+     * // Length range without format
+     * view.setValidation('Code must be 8-20 characters', undefined, 8, 20);
+     */
+    setValidation(errorMessage: string, format?: 'text' | 'number' | 'url' | 'email', minLength?: number, maxLength?: number, startsWith?: string): this;
+    /**
+     * Enables preview mode where scanned value is shown before submission
+     * **Note**: Requires submit button to be set
+     *
+     * @param editable - Allow user to manually edit the scanned value
+     * @param label - Field label in preview (default: "Scanned Code")
+     * @returns this for chaining
+     *
+     * @example
+     * view.enablePreview(true, 'Barcode')
+     *     .submitButton('Confirm');
+     */
+    enablePreview(editable?: boolean, label?: string): this;
+    /**
+     * Disables preview mode
+     * @returns this for chaining
+     */
+    disablePreview(): this;
+    /**
+     * Explicitly enables or disables auto-submit
+     * **Note**: Auto-submit is automatically disabled when submitButton() is called
+     *
+     * @param enabled - Enable auto-submit (default: true)
+     * @returns this for chaining
+     *
+     * @example
+     * // Explicit auto-submit
+     * view.setAutoSubmit(true);  // Scan → immediate POST
+     *
+     * @example
+     * // Disable auto-submit without button (rare case)
+     * view.setAutoSubmit(false);
+     */
+    setAutoSubmit(enabled?: boolean): this;
+    /**
+     * Validates the view configuration before serving
+     * @internal
+     */
+    validate(): import('../types').ValidationResult;
+}
+//# sourceMappingURL=qr-scan-view.d.ts.map

package/dist/core/qr-scan-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-scan-view.d.ts","sourceRoot":"","sources":["../../src/core/qr-scan-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,UAAW,SAAQ,QAAQ;gBACxB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAkB7D;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,aAAa,CACT,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,EAC5C,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GACpB,IAAI;IAkDP;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,QAAQ,GAAE,OAAe,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAU9D;;;OAGG;IACH,cAAc,IAAI,IAAI;IAKtB;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAS5C;;;OAGG;IACM,QAAQ,IAAI,OAAO,UAAU,EAAE,gBAAgB;CAyB3D"}