@ramathibodi/nuxt-commons 4.0.15 → 4.0.17

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^4.3.1"
   },
-  "version": "4.0.15",
+  "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/form/Birthdate.vue

@@ -70,7 +70,6 @@ const dobFormat = computed(() => {
       :year-range="birthdateYearRange"
       :max-date="maxBirthdate"
       reverse-years
-      eager
   >
     <template #append="{ isReadonly, isDisabled, activatorProps, toggleMenuOpen }">
       <span

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/Date.d.vue.ts

@@ -14,7 +14,6 @@ interface Props extends /* @vue-ignore */ InstanceType<typeof VTextField['$props
     defaultDate?: boolean | string;
     yearRange?: [number, number];
     reverseYears?: boolean;
-    eager?: boolean;
 }
 declare function resetDatePicker(): void;
 declare function toggleMenuOpen(trigger: string): void;
@@ -46,7 +45,6 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     flow: () => never[];
     defaultDate: boolean;
     reverseYears: boolean;
-    eager: boolean;
 }>>, {
     reset: typeof resetDatePicker;
     validate: typeof validate;
@@ -61,7 +59,6 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     flow: () => never[];
     defaultDate: boolean;
     reverseYears: boolean;
-    eager: boolean;
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -19,8 +19,7 @@ const props = defineProps({
   rules: { type: null, required: false },
   defaultDate: { type: [Boolean, String], required: false, default: false },
   yearRange: { type: Array, required: false },
-  reverseYears: { type: Boolean, required: false, default: false },
-  eager: { type: Boolean, required: false, default: false }
+  reverseYears: { type: Boolean, required: false, default: false }
 });
 const emit = defineEmits(["update:modelValue"]);
 const computedRules = computed(() => {
@@ -170,10 +169,21 @@ defineExpose({
 </script>
 
 <template>
+  <!--
+    The picker mounts lazily (no `eager`) and the menu opens with no transition.
+    @vuepic/vue-datepicker measures the year/month overlay height and computes its
+    scroll-to-active position once, in onMounted. If the picker is pre-mounted in a
+    hidden menu (eager) or measured mid open-transition, that measurement reads a
+    zero-height grid, so the overlay falls back to the fixed `modeHeight` with the
+    cells unpainted and only corrects on a later tick — the #248 "year overlay shows
+    a few years then waits a while to finish rendering" symptom. Mounting lazily and
+    opening with the content already at full size lets the picker measure correctly
+    on first paint. (eager pre-mount was the original #248 fix and reintroduced the bug.)
+  -->
   <v-menu
       v-model="isMenuOpen"
       :open-on-click="false"
-      :eager="props.eager"
+      :transition="false"
   >
     <template #activator="{ props: activatorProps }">
       <v-text-field

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

@@ -14,7 +14,6 @@ interface Props extends /* @vue-ignore */ InstanceType<typeof VTextField['$props
     defaultDate?: boolean | string;
     yearRange?: [number, number];
     reverseYears?: boolean;
-    eager?: boolean;
 }
 declare function resetDatePicker(): void;
 declare function toggleMenuOpen(trigger: string): void;
@@ -46,7 +45,6 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     flow: () => never[];
     defaultDate: boolean;
     reverseYears: boolean;
-    eager: boolean;
 }>>, {
     reset: typeof resetDatePicker;
     validate: typeof validate;
@@ -61,7 +59,6 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     flow: () => never[];
     defaultDate: boolean;
     reverseYears: boolean;
-    eager: boolean;
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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/label/Field.d.vue.ts

@@ -25,8 +25,8 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, i
     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

@@ -25,8 +25,8 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, i
     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/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.15",
+  "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,