sd-render 1.2.6 → 1.2.7

package/types/src/components/sdwidget/SdSmartCard.vue.d.ts

@@ -0,0 +1,268 @@
+import { PropType } from 'vue';
+/**
+ * SdSmartCard — headless Thai ID smart-card listener
+ *
+ * ทำตัวเหมือน background process: เปิด WebSocket ไปหา local agent (sd-card-agent /
+ * softmax-agent) ที่อ่านบัตรประชาชนไทยผ่าน PC/SC. agent เป็นฝั่ง push อย่างเดียว —
+ * พอเสียบบัตร/ถอดบัตร/เครื่องอ่านเปลี่ยนสถานะ จะ push event มาเอง widget แปลงเป็น
+ * $emit ออกไป ให้ host เขียน JS ว่าจะทำอะไรต่อ (เช่น map ค่าลงฟอร์ม)
+ *
+ * ไม่มี UI input — default ซ่อนทุกอย่าง (renderless). เปิด indicator='dot'/'badge'
+ * เพื่อโชว์สถานะเล็กๆ ที่มุมจอได้ (teleport to body)
+ *
+ * agent เป็น local process ที่อาจปิด/restart ระหว่างใช้งาน → default auto-reconnect
+ * แบบ exponential backoff. agent ส่ง state snapshot ให้ตอน client เพิ่ง connect
+ * (reader-connected / card-read ล่าสุด) → handle เหมือน event ปกติ
+ */
+/** ข้อมูลที่อ่านได้จากบัตร — ตรงกับ ThaiIDData ของ agent (field profile full เป็น optional) */
+export interface ThaiIDData {
+    cid: string;
+    titleTH: string;
+    firstNameTH: string;
+    lastNameTH: string;
+    birthDate: string;
+    firstNameEN?: string;
+    lastNameEN?: string;
+    gender?: string;
+    address?: string;
+    issueDate?: string;
+    expireDate?: string;
+    photo?: string;
+}
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /**
+     * URL ของ agent แบบเต็ม — ถ้าให้มา ใช้ตรงๆ (override host/port/token/secure)
+     * เช่น 'ws://localhost:8765/?token=change-me'
+     */
+    url: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** host ของ agent (ใช้เมื่อไม่ระบุ url) */
+    host: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** port ของ agent (ใช้เมื่อไม่ระบุ url) */
+    port: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** token auth (ตรงกับ config.token ของ agent — dev default = 'change-me') */
+    token: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** ใช้ wss (TLS) แทน ws — ใช้เมื่อไม่ระบุ url */
+    secure: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** ต่อ ws อัตโนมัติตอน mount */
+    autoConnect: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** ปิดการทำงานชั่วคราว (ปิด ws + ไม่ reconnect) */
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** auto-reconnect เมื่อ ws หลุด (exponential backoff) */
+    reconnect: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** ดีเลย์เริ่มต้นก่อน reconnect (ms) — จะคูณเพิ่มแบบ backoff ทุกครั้งที่ fail */
+    reconnectDelay: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** เพดานดีเลย์ reconnect (ms) */
+    reconnectMaxDelay: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * แสดงสถานะเล็กๆ ที่มุมจอ:
+     * - 'none'   (default) : ซ่อนทุกอย่าง (headless ล้วน)
+     * - 'dot'    : จุดเล็กๆ ล้วน บอกสถานะด้วยสี — ย่อสุด
+     * - 'status' : จุด + ข้อความสถานะ (ไม่โชว์ value) — แบบย่อ
+     * - 'badge'  : จุด + ข้อความสถานะ + cid ล่าสุด — เต็ม
+     */
+    indicator: {
+        type: PropType<"none" | "dot" | "status" | "badge">;
+        default: string;
+    };
+    /** ตำแหน่ง indicator */
+    indicatorPosition: {
+        type: PropType<"top-left" | "top-right" | "bottom-left" | "bottom-right">;
+        default: string;
+    };
+    /**
+     * auto-hide indicator (วินาที) — หลังมีสถานะแสดง ถ้าเงียบครบ N วิ จะ fade หายไป
+     * แล้วโผล่กลับเมื่อมี activity ใหม่. 0 = แสดงตลอด (ไม่หาย)
+     */
+    indicatorTimeout: {
+        type: NumberConstructor;
+        default: number;
+    };
+}>, {}, {
+    ws: WebSocket | null;
+    connState: "connecting" | "open" | "closed";
+    readerPresent: boolean;
+    cardPresent: boolean;
+    reading: boolean;
+    lastData: ThaiIDData | null;
+    lastCid: string;
+    lastError: string;
+    flash: boolean;
+    indicatorVisible: boolean;
+    attempts: number;
+    manualClose: boolean;
+    reconnectTimer: number | undefined;
+    flashTimer: number | undefined;
+    hideTimer: number | undefined;
+}, {
+    /** URL จริงที่ใช้ต่อ — prop url ชนะ, ไม่งั้นประกอบจาก host/port/token/secure */
+    wsUrl(): string;
+    /** สถานะรวมสำหรับ indicator */
+    statusState(): "disabled" | "offline" | "connecting" | "no-reader" | "reading" | "ready";
+    statusLabel(): string;
+    indicatorTitle(): string;
+    /** indicator ควรแสดงตอนนี้ไหม — timeout<=0 แสดงตลอด, >0 แสดงเฉพาะตอนมี activity ล่าสุด */
+    indicatorShown(): boolean;
+    /** signature ของ option ที่กระทบการต่อ — เปลี่ยนแล้ว reconnect */
+    connectKey(): string;
+}, {
+    /** เปิด ws ไป agent */
+    connect(): void;
+    openSocket(): void;
+    /** ปิด ws เอง (ไม่ reconnect) */
+    disconnect(): void;
+    /** ปิดแล้วต่อใหม่ทันที (reset backoff) */
+    reconnectNow(): void;
+    /** ปิด socket + ล้าง handler + ยกเลิก reconnect ที่ค้าง */
+    teardown(): void;
+    clearReconnect(): void;
+    /** ตั้งเวลา reconnect แบบ exponential backoff (มีเพดาน) */
+    scheduleReconnect(): void;
+    /** แปลง message จาก agent → state + $emit */
+    handleMessage(ev: MessageEvent): void;
+    /** flash indicator สั้นๆ เมื่ออ่านบัตรสำเร็จ */
+    doFlash(): void;
+    /** มี activity → แสดง indicator แล้วตั้งเวลา auto-hide (เฉพาะ indicatorTimeout > 0) */
+    pokeIndicator(): void;
+    /** ต่อ ws (ถ้ายังไม่ต่อ) */
+    open(): void;
+    /** ปิด ws เอง */
+    close(): void;
+    /** ต่อใหม่ทันที (reset backoff) */
+    reconnectSocket(): void;
+    isConnected(): boolean;
+    /** ข้อมูลบัตรที่อ่านได้ล่าสุด (null ถ้ายังไม่เคยอ่านสำเร็จ) */
+    getLastData(): ThaiIDData | null;
+}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("error" | "message" | "card-reading" | "card-read" | "card-removed" | "reader-connected" | "reader-disconnected" | "connected" | "disconnected")[], "error" | "message" | "card-reading" | "card-read" | "card-removed" | "reader-connected" | "reader-disconnected" | "connected" | "disconnected", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /**
+     * URL ของ agent แบบเต็ม — ถ้าให้มา ใช้ตรงๆ (override host/port/token/secure)
+     * เช่น 'ws://localhost:8765/?token=change-me'
+     */
+    url: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** host ของ agent (ใช้เมื่อไม่ระบุ url) */
+    host: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** port ของ agent (ใช้เมื่อไม่ระบุ url) */
+    port: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** token auth (ตรงกับ config.token ของ agent — dev default = 'change-me') */
+    token: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** ใช้ wss (TLS) แทน ws — ใช้เมื่อไม่ระบุ url */
+    secure: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** ต่อ ws อัตโนมัติตอน mount */
+    autoConnect: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** ปิดการทำงานชั่วคราว (ปิด ws + ไม่ reconnect) */
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** auto-reconnect เมื่อ ws หลุด (exponential backoff) */
+    reconnect: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** ดีเลย์เริ่มต้นก่อน reconnect (ms) — จะคูณเพิ่มแบบ backoff ทุกครั้งที่ fail */
+    reconnectDelay: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** เพดานดีเลย์ reconnect (ms) */
+    reconnectMaxDelay: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * แสดงสถานะเล็กๆ ที่มุมจอ:
+     * - 'none'   (default) : ซ่อนทุกอย่าง (headless ล้วน)
+     * - 'dot'    : จุดเล็กๆ ล้วน บอกสถานะด้วยสี — ย่อสุด
+     * - 'status' : จุด + ข้อความสถานะ (ไม่โชว์ value) — แบบย่อ
+     * - 'badge'  : จุด + ข้อความสถานะ + cid ล่าสุด — เต็ม
+     */
+    indicator: {
+        type: PropType<"none" | "dot" | "status" | "badge">;
+        default: string;
+    };
+    /** ตำแหน่ง indicator */
+    indicatorPosition: {
+        type: PropType<"top-left" | "top-right" | "bottom-left" | "bottom-right">;
+        default: string;
+    };
+    /**
+     * auto-hide indicator (วินาที) — หลังมีสถานะแสดง ถ้าเงียบครบ N วิ จะ fade หายไป
+     * แล้วโผล่กลับเมื่อมี activity ใหม่. 0 = แสดงตลอด (ไม่หาย)
+     */
+    indicatorTimeout: {
+        type: NumberConstructor;
+        default: number;
+    };
+}>> & Readonly<{
+    onError?: ((...args: any[]) => any) | undefined;
+    onMessage?: ((...args: any[]) => any) | undefined;
+    "onCard-reading"?: ((...args: any[]) => any) | undefined;
+    "onCard-read"?: ((...args: any[]) => any) | undefined;
+    "onCard-removed"?: ((...args: any[]) => any) | undefined;
+    "onReader-connected"?: ((...args: any[]) => any) | undefined;
+    "onReader-disconnected"?: ((...args: any[]) => any) | undefined;
+    onConnected?: ((...args: any[]) => any) | undefined;
+    onDisconnected?: ((...args: any[]) => any) | undefined;
+}>, {
+    disabled: boolean;
+    url: string;
+    host: string;
+    token: string;
+    autoConnect: boolean;
+    indicatorPosition: "bottom-left" | "bottom-right" | "top-left" | "top-right";
+    indicator: "none" | "status" | "dot" | "badge";
+    indicatorTimeout: number;
+    port: number;
+    secure: boolean;
+    reconnect: boolean;
+    reconnectDelay: number;
+    reconnectMaxDelay: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/types/src/components/sdwidget/SdUiMenu.vue.d.ts

@@ -367,6 +367,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     providerType: string;
     dataProvider: SdProvider;
     textColor: string;
+    labelField: string;
     parentId: string;
     iconField: string;
     limitRow: number;
@@ -375,7 +376,6 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     buildState: boolean;
     customValue: CustomValue[];
     borderColor: string;
-    labelField: string;
     pathField: string;
     roleField: string;
     subMenuField: string;