@ciwergrp/nuxid 1.5.14 → 1.6.2

package/dist/module.d.mts

@@ -1,6 +1,8 @@
 import * as _nuxt_schema from '@nuxt/schema';
 export * from '../dist/runtime/form.js';
 export { default as useHttp } from '../dist/runtime/form.js';
+export { useBreadcrumbs, useTitle } from '../dist/runtime/page/index.js';
+export { ActiveQueryFilter, QueryFilterDefinition, useQueryFilters, useRouteQuery } from '../dist/runtime/route/index.js';
 export * from '../dist/runtime/validator.js';
 export * from '../dist/runtime/helper/index.js';
 export * from '../dist/runtime/fetcher/index.js';
@@ -211,6 +213,15 @@ interface FetcherOptions {
 }
 type FetcherFeatureInput = boolean | Partial<FetcherOptions> | undefined;
 
+interface VersionUpdaterOptions {
+    /**
+     * Enable version updater composable auto-import
+     * @default true
+     */
+    enabled: boolean;
+}
+type VersionUpdaterFeatureInput = boolean | Partial<VersionUpdaterOptions> | undefined;
+
 interface ModuleOptions {
     lodash?: LodashFeatureInput;
     validator?: ValidatorFeatureInput;
@@ -221,6 +232,7 @@ interface ModuleOptions {
     pinia?: PiniaFeatureInput;
     vueuse?: VueUseFeatureInput;
     fetcher?: FetcherFeatureInput;
+    versionUpdater?: VersionUpdaterFeatureInput;
 }
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
 

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@ciwergrp/nuxid",
   "configKey": "nuxid",
-  "version": "1.5.14",
+  "version": "1.6.2",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -3,6 +3,8 @@ import * as lodash from 'lodash-es';
 import { fileURLToPath } from 'node:url';
 export * from '../dist/runtime/form.js';
 export { default as useHttp } from '../dist/runtime/form.js';
+export { useBreadcrumbs, useTitle } from '../dist/runtime/page/index.js';
+export { ActiveQueryFilter, QueryFilterDefinition, useQueryFilters, useRouteQuery } from '../dist/runtime/route/index.js';
 export * from '../dist/runtime/validator.js';
 export * from '../dist/runtime/helper/index.js';
 export * from '../dist/runtime/fetcher/index.js';
@@ -577,6 +579,27 @@ function registerFetcherFeature(options, { from }) {
   addImports({ name: "CursorFetchOptions", as: "CursorFetchOptions", from, type: true });
 }
 
+const versionUpdaterDefaults = {
+  enabled: true
+};
+function resolveVersionUpdaterOptions(input) {
+  if (input === false) {
+    return { ...versionUpdaterDefaults, enabled: false };
+  }
+  const overrides = typeof input === "boolean" || input === void 0 ? {} : input;
+  return {
+    ...versionUpdaterDefaults,
+    ...overrides,
+    enabled: overrides?.enabled ?? true
+  };
+}
+function registerVersionUpdaterFeature(options, { from }) {
+  if (!options.enabled) {
+    return;
+  }
+  addImports({ name: "useVersionUpdater", as: "useVersionUpdater", from });
+}
+
 const module$1 = defineNuxtModule({
   meta: {
     name: "@ciwergrp/nuxid",
@@ -585,13 +608,15 @@ const module$1 = defineNuxtModule({
   moduleDependencies() {
     const dependencies = {
       "@sentry/nuxt": {
-        version: "10.36.0"
+        version: "^10"
       }
     };
     return dependencies;
   },
   async setup(options, nuxt) {
     const resolver = createResolver(import.meta.url);
+    const pageRuntimeFrom = resolver.resolve("./runtime/page");
+    const routeRuntimeFrom = resolver.resolve("./runtime/route");
     const lodashOptions = resolveLodashOptions(options.lodash);
     const validatorOptions = resolveValidatorOptions(options.validator);
     const formOptions = resolveFormOptions(options.form);
@@ -601,6 +626,7 @@ const module$1 = defineNuxtModule({
     const piniaOptions = resolvePiniaOptions(options.pinia);
     const vueuseOptions = resolveVueUseOptions(options.vueuse);
     const fetcherOptions = resolveFetcherOptions(options.fetcher);
+    const versionUpdaterOptions = resolveVersionUpdaterOptions(options.versionUpdater);
     if (iconOptions.enabled) {
       await installModule("@nuxt/icon", iconOptions.config);
     }
@@ -630,6 +656,11 @@ const module$1 = defineNuxtModule({
         from: resolver.resolve("./runtime/fetcher")
       });
     }
+    if (versionUpdaterOptions.enabled) {
+      registerVersionUpdaterFeature(versionUpdaterOptions, {
+        from: resolver.resolve("./runtime/version-updater")
+      });
+    }
     if (piniaOptions.enabled) {
       const piniaRuntimeDir = fileURLToPath(new URL("./runtime/pinia", import.meta.url));
       registerPiniaFeature(piniaOptions, nuxt, {
@@ -647,6 +678,12 @@ const module$1 = defineNuxtModule({
       });
       registerVueUseFeature(vueuseOptions, nuxt);
     }
+    addImports({ name: "useTitle", as: "useTitle", from: pageRuntimeFrom });
+    addImports({ name: "useBreadcrumbs", as: "useBreadcrumbs", from: pageRuntimeFrom });
+    addImports({ name: "useRouteQuery", as: "useRouteQuery", from: routeRuntimeFrom });
+    addImports({ name: "useQueryFilters", as: "useQueryFilters", from: routeRuntimeFrom });
+    addImports({ name: "ActiveQueryFilter", as: "ActiveQueryFilter", from: routeRuntimeFrom, type: true });
+    addImports({ name: "QueryFilterDefinition", as: "QueryFilterDefinition", from: routeRuntimeFrom, type: true });
     addPlugin(resolver.resolve("./runtime/plugin"));
   }
 });

package/dist/runtime/page/breadcrumb.d.ts

@@ -0,0 +1,16 @@
+interface BreadcrumbItem {
+    name: string;
+    path: string;
+}
+export declare function useBreadcrumbs(): {
+    breadcrumbs: Readonly<import("vue").Ref<readonly {
+        readonly name: string;
+        readonly path: string;
+    }[], readonly {
+        readonly name: string;
+        readonly path: string;
+    }[]>>;
+    activeBreadcrumb: import("vue").ComputedRef<BreadcrumbItem | null>;
+    setBreadcrumbs: (value: BreadcrumbItem[]) => void;
+};
+export {};

package/dist/runtime/page/breadcrumb.js

@@ -0,0 +1,21 @@
+import { computed, readonly, ref } from "vue";
+const items = ref([]);
+export function useBreadcrumbs() {
+  const activeBreadcrumb = computed(() => {
+    if (!items.value.length) {
+      return null;
+    }
+    return items.value[items.value.length - 1] ?? null;
+  });
+  function setBreadcrumbs(value) {
+    items.value = value.map((item) => ({
+      name: item.name,
+      path: item.path
+    }));
+  }
+  return {
+    breadcrumbs: readonly(items),
+    activeBreadcrumb,
+    setBreadcrumbs
+  };
+}

package/dist/runtime/page/index.d.ts

@@ -0,0 +1,2 @@
+export * from './breadcrumb.js';
+export * from './title.js';

package/dist/runtime/page/index.js

@@ -0,0 +1,2 @@
+export * from "./breadcrumb.js";
+export * from "./title.js";

package/dist/runtime/page/title.d.ts

@@ -0,0 +1,5 @@
+export declare function useTitle(): {
+    title: Readonly<import("vue").Ref<string, string>>;
+    getTitle: () => string;
+    setTitle: (value: string) => void;
+};

package/dist/runtime/page/title.js

@@ -0,0 +1,19 @@
+import { useHead } from "@unhead/vue";
+import { ref, readonly } from "vue";
+const title = ref("");
+export function useTitle() {
+  const getTitle = () => {
+    return title.value;
+  };
+  const setTitle = (value) => {
+    title.value = value;
+    useHead({
+      title: title.value
+    });
+  };
+  return {
+    title: readonly(title),
+    getTitle,
+    setTitle
+  };
+}

package/dist/runtime/route/index.d.ts

@@ -0,0 +1,2 @@
+export * from './query-filters.js';
+export * from './route-query.js';

package/dist/runtime/route/index.js

@@ -0,0 +1,2 @@
+export * from "./query-filters.js";
+export * from "./route-query.js";

package/dist/runtime/route/query-filters.d.ts

@@ -0,0 +1,29 @@
+import type { LocationQuery, LocationQueryValue } from 'vue-router';
+export interface ActiveQueryFilter {
+    key: string;
+    label: string;
+    value: string;
+    displayValue: string;
+}
+export interface QueryFilterDefinition {
+    key: string;
+    label: string;
+    clearQueryKeys: string[];
+    resolve: (query: LocationQuery) => {
+        value: string;
+        displayValue: string;
+    } | null;
+}
+interface FilterChangePayload {
+    key: string;
+    active: boolean;
+}
+declare function normalizeQueryValue(value: LocationQueryValue | LocationQueryValue[] | undefined): LocationQueryValue | undefined;
+export declare function useQueryFilters(definitions: QueryFilterDefinition[]): {
+    activeFilters: import("vue").ComputedRef<ActiveQueryFilter[]>;
+    applyFilters: (query: Record<string, any>, callback?: () => void | Promise<void>) => Promise<void>;
+    resetFilters: (queryKeys: string[], callback?: () => void | Promise<void>) => Promise<void>;
+    handleFilterChange: (payload: FilterChangePayload, callback?: () => void | Promise<void>) => Promise<void>;
+    normalizeQueryValue: typeof normalizeQueryValue;
+};
+export {};

package/dist/runtime/route/query-filters.js

@@ -0,0 +1,61 @@
+import { useRoute } from "vue-router";
+import { computed } from "vue";
+import { useRouteQuery } from "./route-query.js";
+function normalizeQueryValue(value) {
+  if (Array.isArray(value)) {
+    return value[0];
+  }
+  return value;
+}
+export function useQueryFilters(definitions) {
+  const route = useRoute();
+  const { URLRouteQuery } = useRouteQuery();
+  const activeFilters = computed(() => {
+    return definitions.map((definition) => {
+      const resolved = definition.resolve(route.query);
+      if (!resolved) {
+        return null;
+      }
+      return {
+        key: definition.key,
+        label: definition.label,
+        value: resolved.value,
+        displayValue: resolved.displayValue
+      };
+    }).filter((filter) => filter !== null);
+  });
+  async function applyFilters(query, callback) {
+    await URLRouteQuery(query);
+    await callback?.();
+  }
+  async function resetFilters(queryKeys, callback) {
+    const query = {};
+    for (const key of queryKeys) {
+      query[key] = void 0;
+    }
+    await URLRouteQuery(query);
+    await callback?.();
+  }
+  async function handleFilterChange(payload, callback) {
+    if (payload.active) {
+      return;
+    }
+    const definition = definitions.find((filter) => filter.key === payload.key);
+    if (!definition) {
+      return;
+    }
+    const query = {};
+    for (const key of definition.clearQueryKeys) {
+      query[key] = void 0;
+    }
+    await URLRouteQuery(query);
+    await callback?.();
+  }
+  return {
+    activeFilters,
+    applyFilters,
+    resetFilters,
+    handleFilterChange,
+    normalizeQueryValue
+  };
+}

package/dist/runtime/route/route-query.d.ts

@@ -0,0 +1,3 @@
+export declare function useRouteQuery(): {
+    URLRouteQuery: (query: any, route?: string) => Promise<void | import("vue-router").NavigationFailure | undefined>;
+};

package/dist/runtime/route/route-query.js

@@ -0,0 +1,17 @@
+import { useRoute, useRouter } from "vue-router";
+export function useRouteQuery() {
+  const URLRouteQuery = (query, route) => {
+    const $route = useRoute();
+    const router = useRouter();
+    return router.push({
+      path: route,
+      query: {
+        ...$route.query,
+        ...query
+      }
+    });
+  };
+  return {
+    URLRouteQuery
+  };
+}

package/dist/runtime/version-updater/index.d.ts

@@ -0,0 +1,3 @@
+export declare function useVersionUpdater(): {
+    isNewVersionAvailable: Readonly<import("vue").Ref<boolean, boolean>>;
+};

package/dist/runtime/version-updater/index.js

@@ -0,0 +1,12 @@
+import { useNuxtApp } from "nuxt/app";
+import { ref, readonly } from "vue";
+export function useVersionUpdater() {
+  const isNewVersionAvailable = ref(false);
+  const nuxtApp = useNuxtApp();
+  nuxtApp.hooks.hookOnce("app:manifest:update", () => {
+    isNewVersionAvailable.value = true;
+  });
+  return {
+    isNewVersionAvailable: readonly(isNewVersionAvailable)
+  };
+}

package/dist/types.d.mts

@@ -1,5 +1,9 @@
 export { type useHttp } from '../dist/runtime/form.js'
 
+export { type useBreadcrumbs, type useTitle } from '../dist/runtime/page/index.js'
+
+export { type ActiveQueryFilter, type QueryFilterDefinition, type useQueryFilters, type useRouteQuery } from '../dist/runtime/route/index.js'
+
 export { default } from './module.mjs'
 
 export { type ModuleOptions } from './module.mjs'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciwergrp/nuxid",
-  "version": "1.5.14",
+  "version": "1.6.2",
   "description": "All-in-one essential modules for Nuxt",
   "repository": {
     "type": "git",
@@ -45,35 +45,38 @@
     "access": "public"
   },
   "dependencies": {
-    "@element-plus/nuxt": "1.1.4",
-    "@formatjs/intl": "4.1.1",
-    "@inquirer/prompts": "8.2.0",
+    "@element-plus/nuxt": "1.1.5",
+    "@formatjs/intl": "4.1.2",
+    "@inquirer/prompts": "8.3.0",
     "@nuxt/icon": "2.2.1",
-    "@nuxt/kit": "4.3.0",
-    "@sentry/nuxt": "10.36.0",
+    "@nuxt/kit": "4.3.1",
+    "@sentry/nuxt": "10.40.0",
     "@sindresorhus/slugify": "3.0.0",
     "@sindresorhus/transliterate": "2.3.1",
-    "@vueuse/nuxt": "14.1.0",
+    "@tailwindcss/vite": "^4.2.1",
+    "@vueuse/nuxt": "14.2.1",
     "date-fns": "4.1.0",
-    "element-plus": "2.13.1",
+    "element-plus": "2.13.2",
     "hls.js": "1.6.15",
     "lodash-es": "4.17.23",
     "pinia": "3.0.4",
-    "socket.io-client": "4.8.3"
+    "socket.io-client": "4.8.3",
+    "tailwindcss": "4.2.1",
+    "vite": "7.3.1"
   },
   "devDependencies": {
-    "@nuxt/devtools": "^3.1.1",
-    "@nuxt/eslint-config": "^1.12.1",
+    "@nuxt/devtools": "^3.2.2",
+    "@nuxt/eslint-config": "^1.15.2",
     "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.2.1",
-    "@nuxt/test-utils": "^3.23.0",
+    "@nuxt/schema": "^4.3.1",
+    "@nuxt/test-utils": "^4.0.0",
     "@types/lodash-es": "^4.17.12",
     "@types/node": "^22",
-    "eslint": "^9.39.2",
-    "nuxt": "^4.2.1",
+    "eslint": "^10.0.2",
+    "nuxt": "^4.3.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.17",
-    "vue-tsc": "^3.2.2"
+    "vitest": "^4.0.18",
+    "vue-tsc": "^3.2.5"
   },
   "scripts": {
     "dev": "npm run dev:prepare && nuxi dev playground",