@ciwergrp/nuxid 1.16.2 → 1.16.5

package/README.md

@@ -31,7 +31,7 @@ export default defineNuxtConfig({
   - `alias` (`Array<[from, to]>`)
 - **Validator helpers** (enabled by default): Element Plus friendly `createValidationRules` plus `ValidationRule` and `ValidationOptions` types. Auto-imported when enabled.
 - **Form composable** (enabled by default): `useHttp` wraps `$fetch`, handles `processing`, `errors`, `response`, and builds `FormData` automatically (or always when `alwaysFormData: true`). Auto-imported when enabled.
-- **Helper utilities** (enabled by default): array/object/number/string/date helpers with configurable factory (`number().abbreviate()`) or prefixed (`NumberAbbreviate()`) styles, locale lookups, currency defaults, and timezone source configuration (`query`/`cookie`/`localStorage`/`static`).
+- **Helper utilities** (enabled by default): array/object/number/string/date helpers with configurable factory (`number().abbreviate()`, `string().normalizeValue()`) or prefixed (`NumberAbbreviate()`) styles, locale lookups, currency defaults, and timezone source configuration (`query`/`cookie`/`localStorage`/`static`).
 - **Cursor fetch composable** (enabled by default): `useCursorFetch` wraps `$fetch`, supports cursor pagination, polling, reactive params, custom fetchers, and configurable cursor/meta keys. Auto-imported when enabled.
 - **Pinia integration** (enabled by default): injects Pinia, auto-imports core helpers (`defineStore`, `storeToRefs`, etc.), and auto-imports stores from `stores` by default.
 - **Icon defaults** (disabled by default): installs `@nuxt/icon` with default component name `KIcon`, size `1.25em`, base class `align-middle inline-block text-current`, mode `svg`. Configure via `nuxid.icon.config`.
@@ -74,6 +74,7 @@ if (form.errors) {
 ```ts
 const price = number().currency(4200)
 const slug = string().slug('Hello World')
+const label = string().normalizeValue('')
 ```
 
 **Cursor fetch example**

package/dist/module.d.mts

@@ -55,8 +55,13 @@ interface ValidatorOptions {
 type ValidatorFeatureInput = boolean | Partial<ValidatorOptions> | undefined;
 
 interface IconOptionClientBundle {
-    scan?: boolean;
+    scan?: boolean | {
+        globInclude?: string[];
+        globExclude?: string[];
+    };
     icons?: string[];
+    includeCustomCollections?: boolean;
+    sizeLimitKb?: number;
 }
 interface IconOptionConfig {
     /**

package/dist/module.json

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

package/dist/module.mjs

@@ -311,6 +311,7 @@ function registerHelperFeature(options, { from, plugin }) {
     "lcfirst",
     "length",
     "lower",
+    "normalizeValue",
     "padBoth",
     "padLeft",
     "padRight",

package/dist/runtime/helper/string/index.d.ts

@@ -3,6 +3,7 @@ import { length, ltrim, rtrim, start, finish } from './basic.js';
 import { camel, kebab, lcfirst, lower, snake, studly, title, ucfirst, upper } from './case.js';
 import { contains, containsAll, endsWith, startsWith } from './match.js';
 import { defaultLocale, useLocale, withLocale } from './locale.js';
+import { normalizeValue } from './normalizeValue.js';
 import { padBoth, padLeft, padRight } from './pad.js';
 import { remove, replace, replaceFirst, replaceLast } from './replace.js';
 import { slug } from './slug.js';
@@ -27,6 +28,7 @@ export interface StringHelper {
     length: typeof length;
     lower: typeof lower;
     ltrim: typeof ltrim;
+    normalizeValue: typeof normalizeValue;
     padBoth: typeof padBoth;
     padLeft: typeof padLeft;
     padRight: typeof padRight;
@@ -50,4 +52,4 @@ export interface StringHelper {
     withLocale: typeof withLocale;
 }
 export declare function string(): StringHelper;
-export { after, afterLast, ascii, before, beforeLast, between, betweenFirst, defaultLocale, camel, contains, containsAll, endsWith, finish, kebab, lcfirst, length, lower, padBoth, padLeft, padRight, remove, replace, replaceFirst, replaceLast, rtrim, slug, snake, start, startsWith, studly, title, transliterate, ucfirst, upper, wordCount, words, useLocale, withLocale, };
+export { after, afterLast, ascii, before, beforeLast, between, betweenFirst, defaultLocale, camel, contains, containsAll, endsWith, finish, kebab, lcfirst, length, lower, normalizeValue, padBoth, padLeft, padRight, remove, replace, replaceFirst, replaceLast, rtrim, slug, snake, start, startsWith, studly, title, transliterate, ucfirst, upper, wordCount, words, useLocale, withLocale, };

package/dist/runtime/helper/string/index.js

@@ -3,6 +3,7 @@ import { length, ltrim, rtrim, start, finish } from "./basic.js";
 import { camel, kebab, lcfirst, lower, snake, studly, title, ucfirst, upper } from "./case.js";
 import { contains, containsAll, endsWith, startsWith } from "./match.js";
 import { defaultLocale, useLocale, withLocale } from "./locale.js";
+import { normalizeValue } from "./normalizeValue.js";
 import { padBoth, padLeft, padRight } from "./pad.js";
 import { remove, replace, replaceFirst, replaceLast } from "./replace.js";
 import { slug } from "./slug.js";
@@ -28,6 +29,7 @@ export function string() {
     length,
     lower,
     ltrim,
+    normalizeValue,
     padBoth,
     padLeft,
     padRight,
@@ -69,6 +71,7 @@ export {
   lcfirst,
   length,
   lower,
+  normalizeValue,
   padBoth,
   padLeft,
   padRight,

package/dist/runtime/helper/string/normalizeValue.d.ts

@@ -0,0 +1,2 @@
+export type EmptyValue = null | undefined | string | readonly unknown[] | Map<unknown, unknown> | Set<unknown> | Record<PropertyKey, unknown>;
+export declare function normalizeValue(value: unknown, newValue?: unknown): unknown;

package/dist/runtime/helper/string/normalizeValue.js

@@ -0,0 +1,39 @@
+function isEmpty(value) {
+  if (value == null)
+    return true;
+  if (typeof value.length === "number") {
+    return value.length === 0;
+  }
+  const tag = Object.prototype.toString.call(value);
+  if (tag === "[object Map]" || tag === "[object Set]") {
+    return value.size === 0;
+  }
+  const type = typeof value;
+  if (type !== "object" && type !== "function") {
+    return true;
+  }
+  const proto = Object.getPrototypeOf(value);
+  const isPlainish = proto === null || proto === Object.prototype || Object.getPrototypeOf(proto) === null;
+  if (!isPlainish && tag !== "[object Object]") {
+    return true;
+  }
+  return Object.keys(value).length === 0;
+}
+export function normalizeValue(value, newValue) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "number") {
+    return value.toLocaleString();
+  }
+  if (newValue) {
+    return newValue;
+  }
+  if (!isEmpty(value)) {
+    return value;
+  }
+  if (typeof value === "string" && value === "") {
+    return "-";
+  }
+  return "-";
+}

package/docs/.docs/helpers/string.md

@@ -5,7 +5,7 @@ outline: [2, 3]
 
 # String Helpers
 
-String helpers cover casing, trimming, matching, and slug formatting.
+String helpers cover casing, trimming, matching, slug formatting, and value normalization.
 
 Factory style:
 
@@ -140,6 +140,13 @@ Parameters: `value` (string).
 - Simple usage: `string().lower('Hello')` = `'hello'`
 - Advanced usage: `string().lower('HELLO WORLD')` = `'hello world'`
 
+### normalizeValue
+Summary: Normalizes empty values to `-`, preserves booleans, and formats numbers with locale separators.
+Parameters: `value` (unknown), `newValue` (unknown, optional).
+- Returns: `unknown`.
+- Simple usage: `string().normalizeValue('')` = `'-'`
+- Advanced usage: `string().normalizeValue(12000)` = `'12,000'`
+
 ### ltrim
 Summary: Trims left side using `trimStart` or a mask regex.
 Parameters: `value` (string), `mask` (string, optional).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciwergrp/nuxid",
-  "version": "1.16.2",
+  "version": "1.16.5",
   "description": "All-in-one essential modules for Nuxt",
   "repository": {
     "type": "git",