@gluhar/core 4.2.0 → 6.0.0-next.1

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 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.1](https://github.com/gluharco/gluhar/compare/v6.0.0-next.0...v6.0.0-next.1) (2026-10-20)
+
+
+### 🚀 Enhancements
+
+- **release:** Publish from GitHub Actions with npm trusted publishing ([8773cd9](https://github.com/gluharco/gluhar/commit/8773cd99c43cbe6a7dc415e50af8b13a7b8d4daf))
+
+
+
+
+
 # [4.2.0](https://github.com/gluharco/gluhar/compare/@gluhar/core@4.1.5...@gluhar/core@4.2.0) (2026-04-28)
 
 

package/README.md

@@ -20,39 +20,33 @@ My new Nuxt module for doing amazing things.
 <!-- - [🏀 Online playground](https://stackblitz.com/github/your-org/my-module?file=playground%2Fapp.vue) -->
 <!-- - [📖 &nbsp;Documentation](https://example.com) -->
 
-## Features
+Shared composables and utils, installed by `@gluhar/app`. Installs `@nuxtjs/device`.
 
-<!-- Highlight some of the features your module provide here -->
-- ⛰ &nbsp;Foo
-- 🚠 &nbsp;Bar
-- 🌲 &nbsp;Baz
+## `useResponsive()`
 
-## Quick Setup
+The one breakpoint composable for every gluhar project. It replaces the project-level `useMobile` copies.
 
-1. Add `my-module` dependency to your project
+**For behaviour only** — event handlers, GSAP/ScrollTrigger setup, measuring. Responsive layout is Tailwind variants in the template; never put a width flag in `v-if` / `:class`.
 
-```bash
-# Using pnpm
-pnpm add -D my-module
-
-# Using yarn
-yarn add --dev my-module
+```ts
+const { isMobileDevice, mounted, mobile, tablet, desktop, touch, up, down, between } =
+  useResponsive();
 
-# Using npm
-npm install --save-dev my-module
+const nav = up("nav"); // any --breakpoint-* the project declares
+onMounted(() => {
+  if (desktop.value) initParallax(); // already correct here
+});
 ```
 
-2. Add `my-module` to the `modules` section of `nuxt.config.ts`
-
-```js
-export default defineNuxtConfig({
-  modules: [
-    'my-module'
-  ]
-})
-```
+| | Source | On the server | Safe in markup |
+|---|---|---|---|
+| `isMobileDevice` | user agent | real value | yes — but it's a device guess, not a width |
+| `mobile` `tablet` `desktop` `wide` `touch` `tabletExact` `desktopExact` `up()` `down()` `between()` | viewport width | `false` | no |
 
-That's it! You can now use My Module in your Nuxt app ✨
+- Width flags stay `false` through the first hydration so server and client renders agree, then switch on in the composable's own `onMounted` — before any `onMounted` you register after calling it. Components created after hydration get live values immediately.
+- Breakpoints are the project's `--breakpoint-*` CSS values (read by `@gluhar/theme`), defaulting to `tablet` 768 / `desktop` 1200 / `wide` 2000.
+- `>=` comparisons, like CSS `min-width`: `tablet` and `tablet:` agree at every width, including exactly 768.
+- `mobile` = below `tablet`; `touch` = below `desktop` (a width, not touch capability).
 
 ## Development
 

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@gluhar/core",
-  "version": "4.2.0",
+  "version": "6.0.0-next.1",
   "description": "Gluhar Core packages.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gluharco/gluhar.git",
+    "directory": "packages/core"
+  },
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/types.d.ts",
-      "import": "./dist/module.mjs",
-      "require": "./dist/module.cjs"
+      "types": "./dist/types.d.mts",
+      "import": "./dist/module.mjs"
     },
     "./utils/*": {
       "types": "./dist/runtime/utils/*.d.ts",
@@ -17,8 +21,8 @@
       "types": "./dist/runtime/types/index.d.ts"
     }
   },
-  "main": "./dist/module.cjs",
-  "types": "./dist/types.d.ts",
+  "main": "./dist/module.mjs",
+  "types": "./dist/types.d.mts",
   "files": [
     "dist",
     "CHANGELOG.md"
@@ -26,6 +30,7 @@
   "scripts": {
     "gluhar": "npm run gluhar --prefix ../.. -- --cwd=$PWD",
     "build": "npm run gluhar build -- -t module",
+    "prepack": "npm run build",
     "dev": "nuxi dev playground",
     "dev:build": "nuxi build playground",
     "dev:prepare": "nuxt-module-build build && nuxt-module-build prepare && nuxi prepare playground",
@@ -34,23 +39,25 @@
     "test:watch": "vitest watch"
   },
   "dependencies": {
-    "@nuxt/kit": "^3.13.1",
+    "@nuxt/kit": "^4.5.0",
     "@nuxtjs/device": "^3.2.2",
-    "@vueuse/core": "^11.0.3",
+    "@vueuse/core": "^14.1.0",
     "mlly": "^1.7.1"
   },
   "devDependencies": {
     "@nuxt/devtools": "latest",
-    "@nuxt/eslint-config": "^0.5.6",
-    "@nuxt/module-builder": "^0.8.3",
-    "@nuxt/schema": "^3.13.1",
-    "@nuxt/test-utils": "^3.14.1",
+    "@nuxt/eslint-config": "^1.9.0",
+    "@nuxt/module-builder": "^1.0.3",
+    "@nuxt/schema": "^4.5.0",
+    "@nuxt/test-utils": "^3.19.2",
     "@types/node": "^22.5.4",
     "changelogen": "^0.5.5",
     "copyfiles": "^2.4.1",
     "eslint": "^9.10.0",
-    "nuxt": "^3.13.1",
-    "vitest": "^2.0.5"
+    "nuxt": "^4.5.0",
+    "vitest": "^3.2.4"
   },
-  "gitHead": "10ebf6500c71e1beeceece4de90467b26aa67a21"
+  "peerDependencies": {
+    "nuxt": "^4.5.0"
+  }
 }

package/dist/module.cjs

@@ -1,5 +0,0 @@
-module.exports = function(...args) {
-  return import('./module.mjs').then(m => m.default.call(this, ...args))
-}
-const _meta = module.exports.meta = require('./module.json')
-module.exports.getMeta = () => Promise.resolve(_meta)

package/dist/module.d.mts

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

package/dist/module.d.ts

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

package/dist/module.json

@@ -1,9 +0,0 @@
-{
-  "name": "@gluhar/core",
-  "configKey": "gluharCore",
-  "version": "4.2.0",
-  "builder": {
-    "@nuxt/module-builder": "0.8.3",
-    "unbuild": "2.0.0"
-  }
-}

package/dist/module.mjs

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

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

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

package/dist/runtime/composables/useClientOnly.js

@@ -1,8 +0,0 @@
-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

@@ -1,9 +0,0 @@
-export declare const useResponsive: () => {
-    mobile: import("vue").ComputedRef<boolean>;
-    tablet: import("vue").Ref<boolean, boolean>;
-    tabletExact: import("vue").ComputedRef<boolean>;
-    desktop: import("vue").Ref<boolean, boolean>;
-    desktopExact: import("vue").ComputedRef<boolean>;
-    wide: import("vue").Ref<boolean, boolean>;
-    touch: import("vue").ComputedRef<boolean>;
-};

package/dist/runtime/composables/useResponsive.js

@@ -1,26 +0,0 @@
-import { computed } from "#imports";
-import { useBreakpoints, breakpointsTailwind } from "@vueuse/core";
-import { useDevice } from "#imports";
-export const useResponsive = () => {
-  const breakpoints = useBreakpoints({
-    ...breakpointsTailwind,
-    tablet: 768,
-    desktop: 1200,
-    wide: 2e3
-  });
-  const { isMobile } = useDevice();
-  const mobile = computed(
-    () => breakpoints.smaller("tablet").value || isMobile
-  );
-  const tablet = breakpoints.greater("tablet");
-  const tabletExact = computed(
-    () => breakpoints.isInBetween("tablet", "desktop")
-  );
-  const desktop = breakpoints.greater("desktop");
-  const desktopExact = computed(
-    () => breakpoints.isInBetween("desktop", "wide")
-  );
-  const touch = computed(() => !desktop.value);
-  const wide = breakpoints.greater("wide");
-  return { mobile, tablet, tabletExact, desktop, desktopExact, wide, touch };
-};

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

@@ -1,3 +0,0 @@
-import { breakpointsTailwind } from "@vueuse/core";
-export type NonNegativeInteger<T extends number> = number extends T ? never : `${T}` extends `-${string}` | `${string}.${string}` ? never : T;
-export type Breakpoint = keyof typeof breakpointsTailwind;

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

@@ -1,10 +0,0 @@
-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

@@ -1,6 +0,0 @@
-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

@@ -1,4 +0,0 @@
-export declare const readModule: <T extends Record<string, any>>(path: string | undefined, options?: {
-    cwd?: boolean;
-    default?: boolean;
-}) => Promise<T>;

package/dist/runtime/utils/fs.js

@@ -1,13 +0,0 @@
-import { readFileSync } from "fs";
-import { join } from "path";
-import { evalModule } from "mlly";
-export const readModule = async (path, options = { cwd: true }) => {
-  if (!path) throw new Error("[@gluhar/core] readModule | No path provided.");
-  const p = options?.cwd ? join(process.cwd(), path) : 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;
-};

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

@@ -1,6 +0,0 @@
-import type { NonNegativeInteger } from "../types.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

@@ -1,5 +0,0 @@
-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

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

package/dist/runtime/utils/index.js

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

package/dist/types.d.mts

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

package/dist/types.d.ts

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