@gluhar/core 6.0.0-next.1 → 6.0.0-next.4

package/CHANGELOG.md

@@ -3,6 +3,33 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [6.0.0-next.4](https://github.com/gluharco/gluhar/compare/v6.0.0-next.3...v6.0.0-next.4) (2026-10-21)
+
+**📝 Note:** Version bump only for package @gluhar/core
+
+
+
+
+
+# [6.0.0-next.3](https://github.com/gluharco/gluhar/compare/v6.0.0-next.2...v6.0.0-next.3) (2026-10-21)
+
+**📝 Note:** Version bump only for package @gluhar/core
+
+
+
+
+
+# [6.0.0-next.2](https://github.com/gluharco/gluhar/compare/v6.0.0-next.1...v6.0.0-next.2) (2026-10-21)
+
+
+### 🩹 Fixes
+
+- **build:** Publish real module builds from CI ([68adc79](https://github.com/gluharco/gluhar/commit/68adc794b3140a00eee6a30713ea2867505ed52c))
+
+
+
+
+
 # [6.0.0-next.1](https://github.com/gluharco/gluhar/compare/v6.0.0-next.0...v6.0.0-next.1) (2026-10-20)
 
 

package/dist/module.d.mts

@@ -0,0 +1,8 @@
+import * as _nuxt_schema from '@nuxt/schema';
+
+interface GluharCoreOptions {
+}
+declare const _default: _nuxt_schema.NuxtModule<GluharCoreOptions, GluharCoreOptions, false>;
+
+export { _default as default };
+export type { GluharCoreOptions };

package/dist/module.json

@@ -0,0 +1,9 @@
+{
+  "name": "@gluhar/core",
+  "configKey": "gluharCore",
+  "version": "6.0.0-next.4",
+  "builder": {
+    "@nuxt/module-builder": "1.0.3",
+    "unbuild": "3.6.1"
+  }
+}

package/dist/module.mjs

@@ -0,0 +1,18 @@
+import { defineNuxtModule, createResolver, installModule, addImportsDir } from '@nuxt/kit';
+
+const module$1 = defineNuxtModule({
+  meta: {
+    name: "@gluhar/core",
+    configKey: "gluharCore"
+  },
+  // Default configuration options of the Nuxt module
+  defaults: {},
+  async setup() {
+    const { resolve } = createResolver(import.meta.url);
+    await installModule("@nuxtjs/device");
+    addImportsDir(resolve("runtime/composables"));
+    addImportsDir(resolve("runtime/utils"));
+  }
+});
+
+export { module$1 as default };

package/dist/runtime/composables/useClientOnly.d.ts

@@ -0,0 +1,3 @@
+export declare const useClientOnly: () => {
+    isClient: import("vue").Ref<boolean, boolean>;
+};

package/dist/runtime/composables/useClientOnly.js

@@ -0,0 +1,8 @@
+import { onMounted, ref } from "vue";
+export const useClientOnly = () => {
+  const mounted = ref(false);
+  onMounted(() => {
+    mounted.value = true;
+  });
+  return { isClient: mounted };
+};

package/dist/runtime/composables/useResponsive.d.ts

@@ -0,0 +1,42 @@
+import { type ComputedRef } from "vue";
+import type { GluharBreakpoints } from "../types/index.js";
+/**
+ * Viewport state for BEHAVIOUR — event handlers, GSAP/ScrollTrigger setup,
+ * imperative measurement. Never for layout: responsive layout is Tailwind
+ * variants in the template (`tablet:`, `desktop:`), which the server renders
+ * for every width with no JS and no hydration risk.
+ *
+ * Two kinds of signal, kept apart on purpose:
+ *
+ * - `isMobileDevice` — user-agent based, identical on server and client. The
+ *   only one safe in `v-if` / `:class` / props. A device guess, not a width.
+ *
+ * - Width flags (`mobile`, `tablet`, `desktop`, `up("nav")`, …) — `false` on
+ *   the server and through the first hydration, so the server render and the
+ *   first client render agree by construction. They switch on in this
+ *   composable's own `onMounted`, which Vue runs before any `onMounted` you
+ *   register later in the same setup. Components created after hydration
+ *   (client-side navigation, SPA mode) get live values from the first render.
+ *
+ * Breakpoints come from the project's CSS (`--breakpoint-*` in the main
+ * stylesheet's `@theme`, read at build time by @gluhar/theme), so JS and CSS
+ * cannot drift. Comparisons are `>=`, matching CSS `min-width`: at exactly the
+ * breakpoint width, `tablet:` applies and `tablet` is true.
+ */
+export declare const useResponsive: () => {
+    isMobileDevice: boolean;
+    /** True once hydrated — for guarding client-only behaviour explicitly. */
+    mounted: import("vue").Ref<boolean, boolean>;
+    breakpoints: GluharBreakpoints;
+    up: (name: string) => ComputedRef<boolean>;
+    down: (name: string) => ComputedRef<boolean>;
+    between: (from: string, to: string) => ComputedRef<boolean>;
+    mobile: ComputedRef<boolean>;
+    tablet: ComputedRef<boolean>;
+    tabletExact: ComputedRef<boolean>;
+    desktop: ComputedRef<boolean>;
+    desktopExact: ComputedRef<boolean>;
+    wide: ComputedRef<boolean>;
+    /** Below desktop width. A width, not touch capability. */
+    touch: ComputedRef<boolean>;
+};

package/dist/runtime/composables/useResponsive.js

@@ -0,0 +1,36 @@
+import { computed, onMounted, ref } from "vue";
+import { useBreakpoints } from "@vueuse/core";
+import { useAppConfig, useDevice, useNuxtApp } from "#imports";
+const DEFAULT_BREAKPOINTS = { tablet: 768, desktop: 1200, wide: 2e3 };
+export const useResponsive = () => {
+  const nuxtApp = useNuxtApp();
+  const breakpoints = {
+    ...DEFAULT_BREAKPOINTS,
+    ...useAppConfig().gluhar?.breakpoints
+  };
+  const viewport = useBreakpoints(breakpoints);
+  const { isMobile: isMobileDevice } = useDevice();
+  const mounted = ref(import.meta.client && !nuxtApp.isHydrating);
+  if (!mounted.value) onMounted(() => mounted.value = true);
+  const gate = (source) => computed(() => mounted.value && source.value);
+  const up = (name) => gate(viewport.greaterOrEqual(name));
+  const down = (name) => gate(viewport.smaller(name));
+  const between = (from, to) => gate(viewport.between(from, to));
+  return {
+    isMobileDevice,
+    /** True once hydrated — for guarding client-only behaviour explicitly. */
+    mounted,
+    breakpoints,
+    up,
+    down,
+    between,
+    mobile: down("tablet"),
+    tablet: up("tablet"),
+    tabletExact: between("tablet", "desktop"),
+    desktop: up("desktop"),
+    desktopExact: between("desktop", "wide"),
+    wide: up("wide"),
+    /** Below desktop width. A width, not touch capability. */
+    touch: down("desktop")
+  };
+};

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

@@ -0,0 +1,18 @@
+import { breakpointsTailwind } from "@vueuse/core";
+export type NonNegativeInteger<T extends number> = number extends T ? never : `${T}` extends `-${string}` | `${string}.${string}` ? never : T;
+/** Tailwind's default screens (sm…2xl), still present in v4. */
+export type Breakpoint = keyof typeof breakpointsTailwind;
+/** Breakpoint name -> min-width in px, as declared in the project's CSS. */
+export type GluharBreakpoints = Record<string, number>;
+declare module "nuxt/schema" {
+    interface AppConfigInput {
+        gluhar?: {
+            breakpoints?: GluharBreakpoints;
+        };
+    }
+    interface AppConfig {
+        gluhar?: {
+            breakpoints?: GluharBreakpoints;
+        };
+    }
+}

package/dist/runtime/utils/common.d.ts

@@ -0,0 +1,10 @@
+export declare const capitalize: (s: string) => string;
+export declare const envMode: () => "dev" | "prod";
+/**
+ * Returns the base URL based on the environment mode.
+ *
+ * @param {string} baseUrl - The base URL to be used.
+ * @returns {string | undefined} - The base URL if the environment mode is "prod", otherwise undefined.
+ */
+export declare const useBaseUrl: (baseUrl: string) => string | undefined;
+export declare const asyncTimeout: (ms: number) => Promise<unknown>;

package/dist/runtime/utils/common.js

@@ -0,0 +1,6 @@
+export const capitalize = (s) => s && s[0].toUpperCase() + s.slice(1);
+export const envMode = () => process.env.NODE_ENV === "development" ? "dev" : "prod";
+export const useBaseUrl = (baseUrl) => {
+  return envMode() === "prod" ? baseUrl : void 0;
+};
+export const asyncTimeout = (ms) => new Promise((res) => setTimeout(res, ms));

package/dist/runtime/utils/fs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Evaluates a project config file (e.g. `config/i18n.config.ts`) at build time.
+ *
+ * Relative paths resolve against `rootDir` — pass `nuxt.options.rootDir`.
+ * `process.cwd()` is only the fallback: it is wrong whenever Nuxt is started
+ * from another directory (`nuxi dev playground`, monorepos, `--cwd`).
+ */
+export declare const readModule: <T extends Record<string, any>>(path: string | undefined, options?: {
+    rootDir?: string;
+    default?: boolean;
+}) => Promise<T>;
+/**
+ * True during a module package's own `nuxt-module-build prepare`: rootDir is the package
+ * (`src/module.ts`, no `nuxt.config`), not a project, so there is no `config/` or `lang/` to read.
+ * Setup that needs project files must be skipped then; registering imports and components is fine.
+ */
+export declare const isModulePrepare: (nuxt: {
+    options: {
+        _prepare?: boolean;
+        rootDir: string;
+    };
+}) => boolean;

package/dist/runtime/utils/fs.js

@@ -0,0 +1,17 @@
+import { existsSync, readFileSync } from "fs";
+import { isAbsolute, join } from "path";
+import { evalModule } from "mlly";
+export const readModule = async (path, options = {}) => {
+  if (!path) throw new Error("[@gluhar/core] readModule | No path provided.");
+  const p = isAbsolute(path) ? path : join(options.rootDir ?? process.cwd(), path);
+  const file = readFileSync(p)?.toString();
+  if (!file)
+    throw new Error("[@gluhar/core] readModule | File not found on path: " + p);
+  const sanitizedFile = file.replaceAll(" as const", "");
+  const module = await evalModule(sanitizedFile);
+  return options.default ? module.default : module;
+};
+export const isModulePrepare = (nuxt) => {
+  const { _prepare, rootDir } = nuxt.options;
+  return !!_prepare && existsSync(join(rootDir, "src/module.ts")) && !["ts", "js", "mjs"].some((ext) => existsSync(join(rootDir, `nuxt.config.${ext}`)));
+};

package/dist/runtime/utils/generators.d.ts

@@ -0,0 +1,6 @@
+import type { NonNegativeInteger } from "../types/index.js";
+export declare const getRandomInt: (max?: number) => number;
+export declare const getRandomBetween: (min: number, max: number) => number;
+export declare const getRandomDigits: <N extends number>(count: NonNegativeInteger<N>) => number;
+export declare const getRandomHex: <N extends number>(count?: NonNegativeInteger<N>) => string;
+export declare const getUuid: () => string;

package/dist/runtime/utils/generators.js

@@ -0,0 +1,5 @@
+export const getRandomInt = (max = 100) => Math.floor(Math.random() * max);
+export const getRandomBetween = (min, max) => getRandomInt(max - min + 1) + min;
+export const getRandomDigits = (count) => getRandomBetween(9 * 10 ** (count - 1), 10 ** (count - 1));
+export const getRandomHex = (count) => [...Array(count || 6)].map(() => getRandomBetween(0, 15).toString(16)).join("");
+export const getUuid = () => `huuid-${getRandomHex()}-${getRandomHex()}-${getRandomHex()}`;

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

@@ -0,0 +1,2 @@
+export * from "./generators.js";
+export * from "./common.js";

package/dist/runtime/utils/index.js

@@ -0,0 +1,2 @@
+export * from "./generators.js";
+export * from "./common.js";

package/dist/types.d.mts

@@ -0,0 +1,9 @@
+import type { NuxtModule } from '@nuxt/schema'
+
+import type { default as Module } from './module.mjs'
+
+export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
+
+export { default } from './module.mjs'
+
+export { type GluharCoreOptions } from './module.mjs'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gluhar/core",
-  "version": "6.0.0-next.1",
+  "version": "6.0.0-next.4",
   "description": "Gluhar Core packages.",
   "repository": {
     "type": "git",
@@ -39,25 +39,24 @@
     "test:watch": "vitest watch"
   },
   "dependencies": {
-    "@nuxt/kit": "^4.5.0",
-    "@nuxtjs/device": "^3.2.2",
-    "@vueuse/core": "^14.1.0",
+    "@nuxt/kit": "^4.6.2",
+    "@nuxtjs/device": "^4.0.0",
+    "@vueuse/core": "^15.0.0",
     "mlly": "^1.7.1"
   },
   "devDependencies": {
-    "@nuxt/devtools": "latest",
     "@nuxt/eslint-config": "^1.9.0",
     "@nuxt/module-builder": "^1.0.3",
-    "@nuxt/schema": "^4.5.0",
-    "@nuxt/test-utils": "^3.19.2",
+    "@nuxt/schema": "^4.6.2",
+    "@nuxt/test-utils": "^4.3.4",
     "@types/node": "^22.5.4",
     "changelogen": "^0.5.5",
     "copyfiles": "^2.4.1",
     "eslint": "^9.10.0",
-    "nuxt": "^4.5.0",
-    "vitest": "^3.2.4"
+    "nuxt": "^4.6.2",
+    "vitest": "^5.0.5"
   },
   "peerDependencies": {
-    "nuxt": "^4.5.0"
+    "nuxt": "^4.6.2"
   }
 }