@type32/nuxt-cs-utils 1.1.0

package/README.md

@@ -0,0 +1,84 @@
+<!--
+Get your module up and running quickly.
+
+Find and replace all on all files (CMD+SHIFT+F):
+- Name: My Module
+- Package name: my-module
+- Description: My new Nuxt module
+-->
+
+# My Module
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![License][license-src]][license-href]
+[![Nuxt][nuxt-src]][nuxt-href]
+
+My new Nuxt module for doing amazing things.
+
+- [✨ &nbsp;Release Notes](/CHANGELOG.md)
+<!-- - [🏀 Online playground](https://stackblitz.com/github/your-org/my-module?file=playground%2Fapp.vue) -->
+<!-- - [📖 &nbsp;Documentation](https://example.com) -->
+
+## Features
+
+<!-- Highlight some of the features your module provide here -->
+- ⛰ &nbsp;Foo
+- 🚠 &nbsp;Bar
+- 🌲 &nbsp;Baz
+
+## Quick Setup
+
+Install the module to your Nuxt application with one command:
+
+```bash
+bunx nuxt module add @type32/nuxt-cs-utils
+```
+
+That's it! You can now use My Module in your Nuxt app ✨
+
+
+## Contribution
+
+<details>
+  <summary>Local development</summary>
+  
+  ```bash
+  # Install dependencies
+  npm install
+  
+  # Generate type stubs
+  npm run dev:prepare
+  
+  # Develop with the playground
+  npm run dev
+  
+  # Build the playground
+  npm run dev:build
+  
+  # Run ESLint
+  npm run lint
+  
+  # Run Vitest
+  npm run test
+  npm run test:watch
+  
+  # Release new version
+  npm run release
+  ```
+
+</details>
+
+
+<!-- Badges -->
+[npm-version-src]: https://img.shields.io/npm/v/my-module/latest.svg?style=flat&colorA=020420&colorB=00DC82
+[npm-version-href]: https://npmjs.com/package/my-module
+
+[npm-downloads-src]: https://img.shields.io/npm/dm/my-module.svg?style=flat&colorA=020420&colorB=00DC82
+[npm-downloads-href]: https://npm.chart.dev/my-module
+
+[license-src]: https://img.shields.io/npm/l/my-module.svg?style=flat&colorA=020420&colorB=00DC82
+[license-href]: https://npmjs.com/package/my-module
+
+[nuxt-src]: https://img.shields.io/badge/Nuxt-020420?logo=nuxt
+[nuxt-href]: https://nuxt.com

package/dist/module.d.mts

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

package/dist/module.json

@@ -0,0 +1,9 @@
+{
+  "name": "@type32/nuxt-cs-utils",
+  "configKey": "csUtils",
+  "version": "1.1.0",
+  "builder": {
+    "@nuxt/module-builder": "1.0.2",
+    "unbuild": "unknown"
+  }
+}

package/dist/module.mjs

@@ -0,0 +1,16 @@
+import { defineNuxtModule, createResolver, addImportsDir } from '@nuxt/kit';
+
+const module$1 = defineNuxtModule({
+  meta: {
+    name: "@type32/nuxt-cs-utils",
+    configKey: "csUtils"
+  },
+  // Default configuration options of the Nuxt module
+  defaults: {},
+  setup(_options, _nuxt) {
+    const resolver = createResolver(import.meta.url);
+    addImportsDir(resolver.resolve("./runtime/shared/utils"));
+  }
+});
+
+export { module$1 as default };

package/dist/runtime/shared/utils/dates.d.ts

@@ -0,0 +1,5 @@
+import { CalendarDate, CalendarDateTime } from "@internationalized/date";
+export declare function convertJSDate(jsDate: Date): CalendarDate;
+export declare function convertJSDateTime(jsDate: Date): CalendarDateTime;
+export declare function getTodayDate(): CalendarDate;
+export declare function wrapDate(date?: Date | null): Date;

package/dist/runtime/shared/utils/dates.js

@@ -0,0 +1,22 @@
+import {
+  getLocalTimeZone,
+  today,
+  fromDate,
+  toCalendarDate,
+  toCalendarDateTime
+} from "@internationalized/date";
+export function convertJSDate(jsDate) {
+  return toCalendarDate(fromDate(new Date(jsDate), getLocalTimeZone()));
+}
+export function convertJSDateTime(jsDate) {
+  return toCalendarDateTime(fromDate(new Date(jsDate), getLocalTimeZone()));
+}
+export function getTodayDate() {
+  return today(getLocalTimeZone());
+}
+export function wrapDate(date) {
+  if (!date)
+    return /* @__PURE__ */ new Date();
+  else
+    return new Date(date);
+}

package/dist/runtime/shared/utils/parsing/paths.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Sanitizes a string to be a valid filename. It replaces illegal characters
+ * and handles Windows-specific reserved names and edge cases. This function
+ * is designed to be safe for multilingual input.
+ *
+ * @param name The string to sanitize.
+ * @param options An optional options object.
+ * @param options.replacement The character to use for replacing illegal characters. Defaults to an empty string (removal).
+ * @returns A safe filename string.
+ */
+export declare function sanitizeFilename(name: string, options?: {
+    replacement?: string;
+}): string;
+/**
+ * Checks if a given string is a valid and safe filename across platforms.
+ * It's stricter than sanitizeFilename; it checks if the string is *already* clean.
+ *
+ * @param name The string to validate.
+ * @returns `true` if the filename is valid, `false` otherwise.
+ */
+export declare function isValidFilename(name: string): boolean;
+export declare function getFileExtensionFromPath(path: string): string;

package/dist/runtime/shared/utils/parsing/paths.js

@@ -0,0 +1,30 @@
+const ILEGAL_CHARACTERS_REGEX = /[<>:"/\\|?*\x00-\x1f\x7f]/g;
+const RESERVED_FILENAMES_REGEX = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i;
+export function sanitizeFilename(name, options) {
+  const replacement = options?.replacement ?? "";
+  let sanitized = name.replace(ILEGAL_CHARACTERS_REGEX, replacement);
+  sanitized = sanitized.trim().replace(/[. ]+$/, "");
+  const baseName = sanitized.split(".")[0];
+  if (RESERVED_FILENAMES_REGEX.test(baseName || "")) {
+    sanitized = "_" + sanitized;
+  }
+  if (sanitized === "" || /^\.+$/.test(sanitized)) {
+    return "_";
+  }
+  return sanitized;
+}
+export function isValidFilename(name) {
+  if (name.length === 0) {
+    return false;
+  }
+  const sanitizedName = sanitizeFilename(name, { replacement: "X" });
+  if (name !== sanitizedName) {
+    return false;
+  }
+  const baseName = name.split(".")[0];
+  return !(!baseName || RESERVED_FILENAMES_REGEX.test(baseName));
+}
+export function getFileExtensionFromPath(path) {
+  const fn = path.split(".");
+  return fn[fn.length - 1] || "unknown";
+}

package/dist/runtime/shared/utils/parsing/query.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Safely converts a query value to a Date object.
+ * Handles ISO strings and numeric timestamps.
+ */
+export declare function queryToDate(val: any): Date | undefined;
+/**
+ * Safely converts a query value to a Boolean.
+ * Handles string 'true'/'false', '1'/'0', and H3 query arrays.
+ */
+export declare function queryToBoolean(val: any): boolean | undefined;
+/**
+ * Safely converts a query value to a Number.
+ * Returns undefined if NaN or empty.
+ */
+export declare function queryToNumber(val: any): number | undefined;
+/**
+ * Ensures a query value is an Array of a specific type.
+ * Useful for handling Enums like status arrays.
+ */
+export declare function queryToArray<T>(val: any): T[] | undefined;
+type FieldType = 'boolean' | 'number' | 'string' | 'array' | 'date';
+export type QueryMapConfig<T> = {
+    [K in keyof T]?: NonNullable<T[K]> extends Date ? FieldType : NonNullable<T[K]> extends any[] ? FieldType : NonNullable<T[K]> extends Record<string, any> ? QueryMapConfig<NonNullable<T[K]>> : FieldType;
+};
+export declare function parseQueryObject<T>(query: any, config: QueryMapConfig<T>): T;
+export {};

package/dist/runtime/shared/utils/parsing/query.js

@@ -0,0 +1,64 @@
+export function queryToDate(val) {
+  if (val instanceof Date) return Number.isNaN(val.getTime()) ? void 0 : val;
+  if (Array.isArray(val)) val = val[0];
+  const str = String(val ?? "").trim();
+  if (!str || str.toLowerCase() === "undefined" || str.toLowerCase() === "null") return void 0;
+  const isNumeric = /^\d+$/.test(str);
+  const parsedDate = new Date(isNumeric ? Number(str) : str);
+  return Number.isNaN(parsedDate.getTime()) ? void 0 : parsedDate;
+}
+export function queryToBoolean(val) {
+  if (typeof val === "boolean") return val;
+  if (Array.isArray(val)) val = val[0];
+  const str = String(val ?? "").toLowerCase().trim();
+  if (!str || str === "undefined" || str === "null") return void 0;
+  return str === "true" || str === "1";
+}
+export function queryToNumber(val) {
+  if (typeof val === "number") return val;
+  if (Array.isArray(val)) val = val[0];
+  const str = String(val ?? "").trim().toLowerCase();
+  if (!str || str === "undefined" || str === "null") return void 0;
+  const num = Number(str);
+  return Number.isNaN(num) ? void 0 : num;
+}
+export function queryToArray(val) {
+  if (val === void 0 || val === null || val === "") return void 0;
+  const str = String(val).toLowerCase();
+  if (str === "undefined" || str === "null") return void 0;
+  if (Array.isArray(val)) return val;
+  return [val];
+}
+export function parseQueryObject(query, config) {
+  if (!query || typeof query !== "object" || Array.isArray(query)) {
+    return query;
+  }
+  const result = { ...query };
+  for (const [key, typeOrConfig] of Object.entries(config)) {
+    const val = query[key];
+    if (val === void 0 || val === null) continue;
+    if (typeof typeOrConfig === "object") {
+      result[key] = parseQueryObject(val, typeOrConfig);
+    } else {
+      switch (typeOrConfig) {
+        case "boolean":
+          result[key] = queryToBoolean(val);
+          break;
+        case "number":
+          result[key] = queryToNumber(val);
+          break;
+        case "array":
+          result[key] = queryToArray(val);
+          break;
+        case "date":
+          result[key] = queryToDate(val);
+          break;
+        // <-- New Date Case
+        case "string":
+          result[key] = Array.isArray(val) ? String(val[0]) : String(val);
+          break;
+      }
+    }
+  }
+  return result;
+}

package/dist/types.d.mts

@@ -0,0 +1,3 @@
+export { default } from './module.mjs'
+
+export { type ModuleOptions } from './module.mjs'

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@type32/nuxt-cs-utils",
+  "version": "1.1.0",
+  "description": "My new Nuxt module",
+  "repository": "https://github.com/CTRL-Neo-Studios/client-server-utils",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/module.mjs"
+    }
+  },
+  "main": "./dist/module.mjs",
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types.d.mts"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "workspaces": [
+    "playground"
+  ],
+  "scripts": {
+    "prepack": "nuxt-module-build build",
+    "dev": "bun run dev:prepare && nuxt dev playground",
+    "dev:build": "nuxt build playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt prepare playground",
+    "release": "bun run prepack && changelogen --release && bun publish && git push --follow-tags",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit"
+  },
+  "dependencies": {
+    "@internationalized/date": "^3.11.0",
+    "@nuxt/kit": "^4.3.1"
+  },
+  "devDependencies": {
+    "@nuxt/devtools": "^3.2.1",
+    "@nuxt/module-builder": "^1.0.2",
+    "@nuxt/schema": "^4.3.1",
+    "@nuxt/test-utils": "^4.0.0",
+    "@types/node": "latest",
+    "changelogen": "^0.6.2",
+    "nuxt": "^4.3.1",
+    "typescript": "~5.9.3",
+    "vitest": "^4.0.18",
+    "vue-tsc": "^3.2.5"
+  }
+}