@ramathibodi/nuxt-commons 4.0.16 → 4.0.17

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^4.3.1"
   },
-  "version": "4.0.16",
+  "version": "4.0.17",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -36,7 +36,7 @@ const module$1 = defineNuxtModule({
       src: resolver.resolve("runtime/plugins/default"),
       mode: "client"
     });
-    const typeFiles = ["modules", "alert", "menu", "graphqlOperation", "formDialog", "dialogManager", "permission", "clientConfig", "bridge"];
+    const typeFiles = ["modules", "alert", "menu", "graphqlOperation", "api", "formDialog", "dialogManager", "permission", "clientConfig", "bridge"];
     for (const file of typeFiles) {
       addTypeTemplate({
         src: resolver.resolve(`runtime/types/${file}.d.ts`),

package/dist/runtime/components/device/IdCardButton.d.vue.ts

@@ -17,16 +17,16 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     reader: null;
     disableWhileLoading: boolean;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    loading: (loading: boolean) => any;
     error: (err: unknown) => any;
+    loading: (loading: boolean) => any;
     read: (payload: PatientRegisterPayload) => any;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
     withPhoto: boolean;
     reader: null;
     disableWhileLoading: boolean;
 }>>> & Readonly<{
-    onLoading?: ((loading: boolean) => any) | undefined;
     onError?: ((err: unknown) => any) | undefined;
+    onLoading?: ((loading: boolean) => any) | undefined;
     onRead?: ((payload: PatientRegisterPayload) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/runtime/components/device/IdCardButton.vue.d.ts

@@ -17,16 +17,16 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     reader: null;
     disableWhileLoading: boolean;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    loading: (loading: boolean) => any;
     error: (err: unknown) => any;
+    loading: (loading: boolean) => any;
     read: (payload: PatientRegisterPayload) => any;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
     withPhoto: boolean;
     reader: null;
     disableWhileLoading: boolean;
 }>>> & Readonly<{
-    onLoading?: ((loading: boolean) => any) | undefined;
     onError?: ((err: unknown) => any) | undefined;
+    onLoading?: ((loading: boolean) => any) | undefined;
     onRead?: ((payload: PatientRegisterPayload) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/runtime/components/dialog/Confirm.d.vue.ts

@@ -21,9 +21,9 @@ declare const __VLS_base: import("vue").DefineComponent<DialogProps, {}, {}, {},
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     "onUpdate:result"?: ((value: boolean) => any) | undefined;
 }>, {
-    title: string;
     message: string;
     width: string;
+    title: string;
     buttonTrueText: string;
     buttonFalseText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/runtime/components/dialog/Confirm.vue.d.ts

@@ -21,9 +21,9 @@ declare const __VLS_base: import("vue").DefineComponent<DialogProps, {}, {}, {},
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     "onUpdate:result"?: ((value: boolean) => any) | undefined;
 }>, {
-    title: string;
     message: string;
     width: string;
+    title: string;
     buttonTrueText: string;
     buttonFalseText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/runtime/components/dialog/default/Confirm.d.vue.ts

@@ -23,10 +23,10 @@ declare const __VLS_base: import("vue").DefineComponent<DialogProps, {}, {}, {},
     onResolve?: ((value: boolean) => any) | undefined;
     onReject?: ((value: any) => any) | undefined;
 }>, {
-    title: string;
-    type: "primary" | "success" | "warning" | "info" | "error";
     message: string;
     width: string;
+    title: string;
+    type: "primary" | "success" | "warning" | "info" | "error";
     buttonTrueText: string;
     buttonFalseText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/runtime/components/dialog/default/Confirm.vue.d.ts

@@ -23,10 +23,10 @@ declare const __VLS_base: import("vue").DefineComponent<DialogProps, {}, {}, {},
     onResolve?: ((value: boolean) => any) | undefined;
     onReject?: ((value: any) => any) | undefined;
 }>, {
-    title: string;
-    type: "primary" | "success" | "warning" | "info" | "error";
     message: string;
     width: string;
+    title: string;
+    type: "primary" | "success" | "warning" | "info" | "error";
     buttonTrueText: string;
     buttonFalseText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/runtime/components/dialog/default/Notify.d.vue.ts

@@ -13,11 +13,11 @@ declare const __VLS_export: import("vue").DefineComponent<DialogProps, {}, {}, {
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onResolve?: ((value: boolean) => any) | undefined;
 }>, {
-    title: string;
-    buttonText: string;
-    type: "primary" | "success" | "warning" | "info" | "error";
     message: string;
     width: string;
+    title: string;
+    type: "primary" | "success" | "warning" | "info" | "error";
+    buttonText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/dialog/default/Notify.vue.d.ts

@@ -13,11 +13,11 @@ declare const __VLS_export: import("vue").DefineComponent<DialogProps, {}, {}, {
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onResolve?: ((value: boolean) => any) | undefined;
 }>, {
-    title: string;
-    buttonText: string;
-    type: "primary" | "success" | "warning" | "info" | "error";
     message: string;
     width: string;
+    title: string;
+    type: "primary" | "success" | "warning" | "info" | "error";
+    buttonText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/dialog/default/VerifyUser.d.vue.ts

@@ -17,10 +17,10 @@ declare const __VLS_export: import("vue").DefineComponent<DialogProps, {}, {}, {
     onResolve?: ((value: string) => any) | undefined;
     onReject?: ((value: any) => any) | undefined;
 }>, {
-    title: string;
-    type: "primary" | "success" | "warning" | "info" | "error";
     message: string;
     width: string;
+    title: string;
+    type: "primary" | "success" | "warning" | "info" | "error";
     confirmButtonText: string;
     cancelButtonText: string;
     fixedUsername: boolean | string;

package/dist/runtime/components/dialog/default/VerifyUser.vue.d.ts

@@ -17,10 +17,10 @@ declare const __VLS_export: import("vue").DefineComponent<DialogProps, {}, {}, {
     onResolve?: ((value: string) => any) | undefined;
     onReject?: ((value: any) => any) | undefined;
 }>, {
-    title: string;
-    type: "primary" | "success" | "warning" | "info" | "error";
     message: string;
     width: string;
+    title: string;
+    type: "primary" | "success" | "warning" | "info" | "error";
     confirmButtonText: string;
     cancelButtonText: string;
     fixedUsername: boolean | string;

package/dist/runtime/components/form/CheckboxGroup.vue

@@ -71,7 +71,7 @@ watch(props.modelValue, () => {
             :value="item.value"
             density="compact"
             hide-details
-            :error="isValid === false"
+            :error="isValid.value === false"
             :="$attrs"
             :label="item.label"
             @update:model-value="onInteract"
@@ -81,7 +81,7 @@ watch(props.modelValue, () => {
           v-if="computedOther"
           v-model="valuesOther"
           hide-details
-          :error="isValid === false"
+          :error="isValid.value === false"
           :="$attrs"
           :label="computedOther.label"
           @update:model-value="onInteract"

package/dist/runtime/components/form/DateTime.d.vue.ts

@@ -22,9 +22,9 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {},
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
+    readonly: boolean;
     locale: "TH" | "EN";
     format: dateFormat | string;
-    readonly: boolean;
     dense: boolean;
     pickerOnly: boolean;
     defaultDate: boolean | string;

package/dist/runtime/components/form/DateTime.vue.d.ts

@@ -22,9 +22,9 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {},
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
+    readonly: boolean;
     locale: "TH" | "EN";
     format: dateFormat | string;
-    readonly: boolean;
     dense: boolean;
     pickerOnly: boolean;
     defaultDate: boolean | string;

package/dist/runtime/components/form/Login.d.vue.ts

@@ -15,8 +15,8 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, i
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-    title: string;
     loading: boolean;
+    title: string;
     errorMessages: string;
     hint: string;
     btnSubmit: string;

package/dist/runtime/components/form/Login.vue.d.ts

@@ -15,8 +15,8 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, i
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-    title: string;
     loading: boolean;
+    title: string;
     errorMessages: string;
     hint: string;
     btnSubmit: string;

package/dist/runtime/components/form/Pad.d.vue.ts

@@ -681,9 +681,9 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {
 }>, {
     disabled: boolean;
     readonly: boolean;
+    parentTemplates: string | string[];
     isolated: boolean;
     decoration: object;
-    parentTemplates: string | string[];
     dirtyClass: string;
     dirtyOnCreate: boolean;
     sanitizeDelay: number;

package/dist/runtime/components/form/Pad.vue

@@ -313,5 +313,5 @@ defineExpose({
 </template>
 
 <style>
-.form-data-dirty:not(.v-input--error) :not(.v-chip):not(.v-chip *):not(.v-toolbar):not(.v-toolbar *){color:color-mix(in srgb,currentColor 70%,rgb(var(--v-theme-primary)))!important;text-shadow:0 0 .02em currentColor}
+.form-data-dirty:not(.v-input--error) :not(.v-chip):not(.v-chip *):not(.v-toolbar):not(.v-toolbar *):not(.dp__main):not(.dp__main *){color:color-mix(in srgb,currentColor 70%,rgb(var(--v-theme-primary)))!important;text-shadow:0 0 .02em currentColor}
 </style>

package/dist/runtime/components/form/Pad.vue.d.ts

@@ -681,9 +681,9 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {
 }>, {
     disabled: boolean;
     readonly: boolean;
+    parentTemplates: string | string[];
     isolated: boolean;
     decoration: object;
-    parentTemplates: string | string[];
     dirtyClass: string;
     dirtyOnCreate: boolean;
     sanitizeDelay: number;

package/dist/runtime/components/form/images/Capture.d.vue.ts

@@ -78,10 +78,10 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
 }>, {
-    buttonText: string;
     disabled: boolean;
     maxWidth: string | number;
     readonly: boolean;
+    buttonText: string;
     imageFormat: ImageFormat;
     autoStart: boolean;
     fileOnly: boolean;

package/dist/runtime/components/form/images/Capture.vue.d.ts

@@ -78,10 +78,10 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
 }>, {
-    buttonText: string;
     disabled: boolean;
     maxWidth: string | number;
     readonly: boolean;
+    buttonText: string;
     imageFormat: ImageFormat;
     autoStart: boolean;
     fileOnly: boolean;

package/dist/runtime/components/label/Field.d.vue.ts

@@ -22,11 +22,11 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     value: string | null;
-    label: string;
     size: "large" | "medium";
+    label: string;
     horizontal: boolean;
-    truncate: boolean;
     notFoundText: string;
+    truncate: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/components/label/Field.vue.d.ts

@@ -22,11 +22,11 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     value: string | null;
-    label: string;
     size: "large" | "medium";
+    label: string;
     horizontal: boolean;
-    truncate: boolean;
     notFoundText: string;
+    truncate: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/labs/Calendar.d.vue.ts

@@ -18,18 +18,18 @@ interface CalendarProps {
     mode: 'dayGridMonth' | 'timeGridDay';
 }
 declare const __VLS_export: import("vue").DefineComponent<CalendarProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    select: (...args: any[]) => void;
     dialog: (...args: any[]) => void;
+    select: (...args: any[]) => void;
 }, string, import("vue").PublicProps, Readonly<CalendarProps> & Readonly<{
-    onSelect?: ((...args: any[]) => any) | undefined;
     onDialog?: ((...args: any[]) => any) | undefined;
+    onSelect?: ((...args: any[]) => any) | undefined;
 }>, {
+    height: string | number;
+    mode: "dayGridMonth" | "timeGridDay";
     locale: "th" | "en";
     toolBarLeft: string;
     toolBarCenter: string;
     toolBarRight: string;
-    height: string | number;
-    mode: "dayGridMonth" | "timeGridDay";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/labs/Calendar.vue.d.ts

@@ -18,18 +18,18 @@ interface CalendarProps {
     mode: 'dayGridMonth' | 'timeGridDay';
 }
 declare const __VLS_export: import("vue").DefineComponent<CalendarProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    select: (...args: any[]) => void;
     dialog: (...args: any[]) => void;
+    select: (...args: any[]) => void;
 }, string, import("vue").PublicProps, Readonly<CalendarProps> & Readonly<{
-    onSelect?: ((...args: any[]) => any) | undefined;
     onDialog?: ((...args: any[]) => any) | undefined;
+    onSelect?: ((...args: any[]) => any) | undefined;
 }>, {
+    height: string | number;
+    mode: "dayGridMonth" | "timeGridDay";
     locale: "th" | "en";
     toolBarLeft: string;
     toolBarCenter: string;
     toolBarRight: string;
-    height: string | number;
-    mode: "dayGridMonth" | "timeGridDay";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/types/api.d.ts

@@ -0,0 +1,36 @@
+// Self-contained type template surfaced through `#build/types/api` via
+// `addTypeTemplate` in src/module.ts (mirrors runtime/types/graphqlOperation.d.ts).
+//
+// Why a dedicated template instead of relying on `#imports`:
+// `ApiIdempotencyOption` / `ApiFetchOptions` are **type-only** exports of
+// src/runtime/composables/api.ts. In the playground `#imports` resolves them
+// because unimport scans the TypeScript source, but a consumer installing the
+// built package scans the compiled `.js` where interfaces are erased — so the
+// types never land in the consumer's `#imports` and the codegen-generated
+// `graphqlObject.ts` (`import type { ApiIdempotencyOption } from ...`) fails
+// vue-tsc with TS2305 (see issue #253).
+//
+// This file must stay **self-contained** (no relative imports of ../composables/*)
+// because type templates are copied verbatim into `.nuxt/types/`, where a relative
+// path back into `src/` would not resolve. Keep these declarations in sync with
+// src/runtime/composables/api.ts — that composable remains the runtime source of truth.
+import type { UseFetchOptions } from 'nuxt/app'
+
+/**
+ * Per-call options accepted by useApi alongside Nuxt's UseFetchOptions.
+ *
+ * `idempotent: false` skips Idempotency-Key header injection for this single call.
+ * Default is `true`. See the useApi() docblock for the full idempotency contract.
+ */
+export interface ApiIdempotencyOption {
+  idempotent?: boolean
+  /**
+   * Optional discriminator folded as a trailing component into the
+   * Idempotency-Key hash: SHA-256(`<second>|<username>|<body>|<salt>`).
+   * Lets legitimately-identical payloads (e.g. duplicate bulk-import rows)
+   * resolve to distinct keys without weakening dedup elsewhere.
+   */
+  idempotencySalt?: string | number
+}
+
+export type ApiFetchOptions = UseFetchOptions<unknown> & ApiIdempotencyOption

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramathibodi/nuxt-commons",
-  "version": "4.0.16",
+  "version": "4.0.17",
   "description": "Ramathibodi Nuxt modules for common components",
   "repository": {
     "type": "git",

package/templates/.codegen/plugin-schema-object.cjs

@@ -104,7 +104,7 @@ module.exports = {
     return `
         import * as graphQlClass from "~/types/graphql"
         import { useGraphQlOperation } from "#imports";
-        import type { ApiIdempotencyOption } from "#imports";
+        import type { ApiIdempotencyOption } from "#build/types/api";
         import type {
             graphqlInputObject,
             graphqlOperationObject,