@yamada-ui/utils 2.1.2-dev-20260323012739 → 2.1.2-dev-20260323160112

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/dist/cjs/index.cjs +1 -0
  2. package/dist/cjs/string.cjs +9 -0
  3. package/dist/cjs/string.cjs.map +1 -1
  4. package/dist/esm/index.js +2 -2
  5. package/dist/esm/string.js +9 -1
  6. package/dist/esm/string.js.map +1 -1
  7. package/dist/types/index.d.ts +2 -2
  8. package/dist/types/string.d.ts +2 -1
  9. package/package.json +1 -1
package/dist/cjs/index.cjs CHANGED
@@ -115,6 +115,7 @@ exports.isVisibleElement = require_dom.isVisibleElement;
115
115
  exports.isVisualViewport = require_dom.isVisualViewport;
116
116
  exports.isWebKit = require_dom.isWebKit;
117
117
  exports.isWindow = require_dom.isWindow;
118
+ exports.match = require_string.match;
118
119
  exports.memoizeObject = require_object.memoizeObject;
119
120
  exports.merge = require_object.merge;
120
121
  exports.noop = require_function.noop;
package/dist/cjs/string.cjs CHANGED
@@ -81,6 +81,14 @@ function bem(block, element, modifier) {
81
81
  if (modifier) className += `--${modifier}`;
82
82
  return className;
83
83
  }
84
+ function match(value, query, strategy = "contains") {
85
+ switch (strategy) {
86
+ case "contains": return value.toLowerCase().includes(query.toLowerCase());
87
+ case "endsWith": return value.toLowerCase().endsWith(query.toLowerCase());
88
+ case "equals": return value.toLowerCase() === query.toLowerCase();
89
+ case "startsWith": return value.toLowerCase().startsWith(query.toLowerCase());
90
+ }
91
+ }
84
92
 
85
93
  //#endregion
86
94
  exports.antonym = antonym;
@@ -88,6 +96,7 @@ exports.bem = bem;
88
96
  exports.cx = cx;
89
97
  exports.escape = escape;
90
98
  exports.isSize = isSize;
99
+ exports.match = match;
91
100
  exports.toCamelCase = toCamelCase;
92
101
  exports.toKebabCase = toKebabCase;
93
102
  exports.toPascalCase = toPascalCase;
package/dist/cjs/string.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"string.cjs","names":["sizeMap: AnyString[]","isString"],"sources":["../../src/string.ts"],"sourcesContent":["import type { AnyString } from \"./index.types\"\nimport { isString } from \"./assertion\"\n\nexport function cx(\n ...classNames: (null | string | undefined)[]\n): string | undefined {\n const result = classNames.filter((className) => !!className)\n\n if (!result.length) return undefined\n\n return result.map((className) => className!.trim()).join(\" \")\n}\n\nexport function escape(value: string, replaceValue = \"\"): string {\n return value.replace(/\\s+/g, replaceValue)\n}\n\nexport function antonym(value: string): string {\n switch (value) {\n case \"top\":\n return \"bottom\"\n\n case \"bottom\":\n return \"top\"\n\n case \"left\":\n return \"right\"\n\n case \"right\":\n return \"left\"\n\n case \"start\":\n return \"end\"\n\n case \"end\":\n return \"start\"\n\n case \"x\":\n return \"y\"\n\n case \"y\":\n return \"x\"\n\n case \"enter\":\n return \"exit\"\n\n case \"exit\":\n return \"enter\"\n\n case \"vertical\":\n return \"horizontal\"\n\n case \"horizontal\":\n return \"vertical\"\n\n case \"up\":\n return \"down\"\n\n case \"down\":\n return \"up\"\n\n case \"block\":\n return \"inline\"\n\n case \"inline\":\n return \"block\"\n\n default:\n return value\n }\n}\n\nconst sizeMap: AnyString[] = [\n \"9xs\",\n \"8xs\",\n \"7xs\",\n \"6xs\",\n \"5xs\",\n \"4xs\",\n \"3xs\",\n \"2xs\",\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\",\n \"xl\",\n \"2xl\",\n \"3xl\",\n \"4xl\",\n \"5xl\",\n \"6xl\",\n \"7xl\",\n \"8xl\",\n \"9xl\",\n]\n\nexport function isSize(value: any): boolean {\n return isString(value) && sizeMap.includes(value)\n}\n\nexport function transformSize<Y = string>(\n token: string | undefined,\n value: number,\n omitTokens: null | string[] = null,\n): undefined | Y {\n if (!token) return undefined\n\n let resolvedSizeMap = sizeMap\n\n if (omitTokens)\n resolvedSizeMap = sizeMap.filter((size) => !omitTokens.includes(size))\n\n const index = resolvedSizeMap.indexOf(token)\n const size = resolvedSizeMap[index + value]\n\n return (size ?? token) as Y\n}\n\nexport function toCamelCase(value: AnyString): string {\n return value\n .replace(/[_-](.)/g, (_, val) => val.toUpperCase())\n .replace(/^(.)/, (_, val) => val.toLowerCase())\n}\n\nexport function toPascalCase(value: AnyString): string {\n return value\n .replace(/[_-](.)/g, (_, val) => val.toUpperCase())\n .replace(/^(.)/, (_, val) => val.toUpperCase())\n}\n\nexport function toKebabCase(value: AnyString): string {\n return value\n .replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, \"$1-$2\")\n .toLowerCase()\n .replace(/^-/, \"\")\n}\n\nexport function toTitleCase(value: AnyString): string {\n return value\n .replace(/([A-Z])/g, \" $1\")\n .replace(/[_-](.)/g, (_, val) => ` ${val.toUpperCase()}`)\n .replace(/^./, (str) => str.toUpperCase())\n .trim()\n}\n\nexport function bem(block: string, element?: string, modifier?: string) {\n let className = block\n\n if (element) className += `__${element}`\n if (modifier) className += `--${modifier}`\n\n return className\n}\n"],"mappings":";;;AAGA,SAAgB,GACd,GAAG,YACiB;CACpB,MAAM,SAAS,WAAW,QAAQ,cAAc,CAAC,CAAC,UAAU;AAE5D,KAAI,CAAC,OAAO,OAAQ,QAAO;AAE3B,QAAO,OAAO,KAAK,cAAc,UAAW,MAAM,CAAC,CAAC,KAAK,IAAI;;AAG/D,SAAgB,OAAO,OAAe,eAAe,IAAY;AAC/D,QAAO,MAAM,QAAQ,QAAQ,aAAa;;AAG5C,SAAgB,QAAQ,OAAuB;AAC7C,SAAQ,OAAR;EACE,KAAK,MACH,QAAO;EAET,KAAK,SACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,MACH,QAAO;EAET,KAAK,IACH,QAAO;EAET,KAAK,IACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,WACH,QAAO;EAET,KAAK,aACH,QAAO;EAET,KAAK,KACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,SACH,QAAO;EAET,QACE,QAAO;;;AAIb,MAAMA,UAAuB;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAgB,OAAO,OAAqB;AAC1C,QAAOC,2BAAS,MAAM,IAAI,QAAQ,SAAS,MAAM;;AAGnD,SAAgB,cACd,OACA,OACA,aAA8B,MACf;AACf,KAAI,CAAC,MAAO,QAAO;CAEnB,IAAI,kBAAkB;AAEtB,KAAI,WACF,mBAAkB,QAAQ,QAAQ,SAAS,CAAC,WAAW,SAAS,KAAK,CAAC;CAExE,MAAM,QAAQ,gBAAgB,QAAQ,MAAM;AAG5C,QAFa,gBAAgB,QAAQ,UAErB;;AAGlB,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,aAAa,GAAG,QAAQ,IAAI,aAAa,CAAC,CAClD,QAAQ,SAAS,GAAG,QAAQ,IAAI,aAAa,CAAC;;AAGnD,SAAgB,aAAa,OAA0B;AACrD,QAAO,MACJ,QAAQ,aAAa,GAAG,QAAQ,IAAI,aAAa,CAAC,CAClD,QAAQ,SAAS,GAAG,QAAQ,IAAI,aAAa,CAAC;;AAGnD,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,gCAAgC,QAAQ,CAChD,aAAa,CACb,QAAQ,MAAM,GAAG;;AAGtB,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,YAAY,MAAM,CAC1B,QAAQ,aAAa,GAAG,QAAQ,IAAI,IAAI,aAAa,GAAG,CACxD,QAAQ,OAAO,QAAQ,IAAI,aAAa,CAAC,CACzC,MAAM;;AAGX,SAAgB,IAAI,OAAe,SAAkB,UAAmB;CACtE,IAAI,YAAY;AAEhB,KAAI,QAAS,cAAa,KAAK;AAC/B,KAAI,SAAU,cAAa,KAAK;AAEhC,QAAO"}
1
+ {"version":3,"file":"string.cjs","names":["sizeMap: AnyString[]","isString"],"sources":["../../src/string.ts"],"sourcesContent":["import type { AnyString } from \"./index.types\"\nimport { isString } from \"./assertion\"\n\nexport function cx(\n ...classNames: (null | string | undefined)[]\n): string | undefined {\n const result = classNames.filter((className) => !!className)\n\n if (!result.length) return undefined\n\n return result.map((className) => className!.trim()).join(\" \")\n}\n\nexport function escape(value: string, replaceValue = \"\"): string {\n return value.replace(/\\s+/g, replaceValue)\n}\n\nexport function antonym(value: string): string {\n switch (value) {\n case \"top\":\n return \"bottom\"\n\n case \"bottom\":\n return \"top\"\n\n case \"left\":\n return \"right\"\n\n case \"right\":\n return \"left\"\n\n case \"start\":\n return \"end\"\n\n case \"end\":\n return \"start\"\n\n case \"x\":\n return \"y\"\n\n case \"y\":\n return \"x\"\n\n case \"enter\":\n return \"exit\"\n\n case \"exit\":\n return \"enter\"\n\n case \"vertical\":\n return \"horizontal\"\n\n case \"horizontal\":\n return \"vertical\"\n\n case \"up\":\n return \"down\"\n\n case \"down\":\n return \"up\"\n\n case \"block\":\n return \"inline\"\n\n case \"inline\":\n return \"block\"\n\n default:\n return value\n }\n}\n\nconst sizeMap: AnyString[] = [\n \"9xs\",\n \"8xs\",\n \"7xs\",\n \"6xs\",\n \"5xs\",\n \"4xs\",\n \"3xs\",\n \"2xs\",\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\",\n \"xl\",\n \"2xl\",\n \"3xl\",\n \"4xl\",\n \"5xl\",\n \"6xl\",\n \"7xl\",\n \"8xl\",\n \"9xl\",\n]\n\nexport function isSize(value: any): boolean {\n return isString(value) && sizeMap.includes(value)\n}\n\nexport function transformSize<Y = string>(\n token: string | undefined,\n value: number,\n omitTokens: null | string[] = null,\n): undefined | Y {\n if (!token) return undefined\n\n let resolvedSizeMap = sizeMap\n\n if (omitTokens)\n resolvedSizeMap = sizeMap.filter((size) => !omitTokens.includes(size))\n\n const index = resolvedSizeMap.indexOf(token)\n const size = resolvedSizeMap[index + value]\n\n return (size ?? token) as Y\n}\n\nexport function toCamelCase(value: AnyString): string {\n return value\n .replace(/[_-](.)/g, (_, val) => val.toUpperCase())\n .replace(/^(.)/, (_, val) => val.toLowerCase())\n}\n\nexport function toPascalCase(value: AnyString): string {\n return value\n .replace(/[_-](.)/g, (_, val) => val.toUpperCase())\n .replace(/^(.)/, (_, val) => val.toUpperCase())\n}\n\nexport function toKebabCase(value: AnyString): string {\n return value\n .replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, \"$1-$2\")\n .toLowerCase()\n .replace(/^-/, \"\")\n}\n\nexport function toTitleCase(value: AnyString): string {\n return value\n .replace(/([A-Z])/g, \" $1\")\n .replace(/[_-](.)/g, (_, val) => ` ${val.toUpperCase()}`)\n .replace(/^./, (str) => str.toUpperCase())\n .trim()\n}\n\nexport function bem(block: string, element?: string, modifier?: string) {\n let className = block\n\n if (element) className += `__${element}`\n if (modifier) className += `--${modifier}`\n\n return className\n}\n\nexport function match(\n value: string,\n query: string,\n strategy: \"contains\" | \"endsWith\" | \"equals\" | \"startsWith\" = \"contains\",\n) {\n switch (strategy) {\n case \"contains\":\n return value.toLowerCase().includes(query.toLowerCase())\n case \"endsWith\":\n return value.toLowerCase().endsWith(query.toLowerCase())\n case \"equals\":\n return value.toLowerCase() === query.toLowerCase()\n case \"startsWith\":\n return value.toLowerCase().startsWith(query.toLowerCase())\n }\n}\n"],"mappings":";;;AAGA,SAAgB,GACd,GAAG,YACiB;CACpB,MAAM,SAAS,WAAW,QAAQ,cAAc,CAAC,CAAC,UAAU;AAE5D,KAAI,CAAC,OAAO,OAAQ,QAAO;AAE3B,QAAO,OAAO,KAAK,cAAc,UAAW,MAAM,CAAC,CAAC,KAAK,IAAI;;AAG/D,SAAgB,OAAO,OAAe,eAAe,IAAY;AAC/D,QAAO,MAAM,QAAQ,QAAQ,aAAa;;AAG5C,SAAgB,QAAQ,OAAuB;AAC7C,SAAQ,OAAR;EACE,KAAK,MACH,QAAO;EAET,KAAK,SACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,MACH,QAAO;EAET,KAAK,IACH,QAAO;EAET,KAAK,IACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,WACH,QAAO;EAET,KAAK,aACH,QAAO;EAET,KAAK,KACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,SACH,QAAO;EAET,QACE,QAAO;;;AAIb,MAAMA,UAAuB;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAgB,OAAO,OAAqB;AAC1C,QAAOC,2BAAS,MAAM,IAAI,QAAQ,SAAS,MAAM;;AAGnD,SAAgB,cACd,OACA,OACA,aAA8B,MACf;AACf,KAAI,CAAC,MAAO,QAAO;CAEnB,IAAI,kBAAkB;AAEtB,KAAI,WACF,mBAAkB,QAAQ,QAAQ,SAAS,CAAC,WAAW,SAAS,KAAK,CAAC;CAExE,MAAM,QAAQ,gBAAgB,QAAQ,MAAM;AAG5C,QAFa,gBAAgB,QAAQ,UAErB;;AAGlB,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,aAAa,GAAG,QAAQ,IAAI,aAAa,CAAC,CAClD,QAAQ,SAAS,GAAG,QAAQ,IAAI,aAAa,CAAC;;AAGnD,SAAgB,aAAa,OAA0B;AACrD,QAAO,MACJ,QAAQ,aAAa,GAAG,QAAQ,IAAI,aAAa,CAAC,CAClD,QAAQ,SAAS,GAAG,QAAQ,IAAI,aAAa,CAAC;;AAGnD,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,gCAAgC,QAAQ,CAChD,aAAa,CACb,QAAQ,MAAM,GAAG;;AAGtB,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,YAAY,MAAM,CAC1B,QAAQ,aAAa,GAAG,QAAQ,IAAI,IAAI,aAAa,GAAG,CACxD,QAAQ,OAAO,QAAQ,IAAI,aAAa,CAAC,CACzC,MAAM;;AAGX,SAAgB,IAAI,OAAe,SAAkB,UAAmB;CACtE,IAAI,YAAY;AAEhB,KAAI,QAAS,cAAa,KAAK;AAC/B,KAAI,SAAU,cAAa,KAAK;AAEhC,QAAO;;AAGT,SAAgB,MACd,OACA,OACA,WAA8D,YAC9D;AACA,SAAQ,UAAR;EACE,KAAK,WACH,QAAO,MAAM,aAAa,CAAC,SAAS,MAAM,aAAa,CAAC;EAC1D,KAAK,WACH,QAAO,MAAM,aAAa,CAAC,SAAS,MAAM,aAAa,CAAC;EAC1D,KAAK,SACH,QAAO,MAAM,aAAa,KAAK,MAAM,aAAa;EACpD,KAAK,aACH,QAAO,MAAM,aAAa,CAAC,WAAW,MAAM,aAAa,CAAC"}
package/dist/esm/index.js CHANGED
@@ -3,7 +3,7 @@ import { filterEmpty, toArray } from "./array.js";
3
3
  import { calc } from "./calc.js";
4
4
  import { COLOR_SCHEMES, DEFAULT_COLOR_SCHEMES, SEMANTIC_COLOR_SCHEMES, TONES, alphaToHex, calcFormat, convertColor, getAlpha, hslaTo, hsvTo, parseToHsla, parseToHsv, parseToRgba, rgbaTo, sameColor } from "./color.js";
5
5
  import { fnAll, handlerAll, noop, runIfFn, wait } from "./function.js";
6
- import { antonym, bem, cx, escape, isSize, toCamelCase, toKebabCase, toPascalCase, toTitleCase, transformSize } from "./string.js";
6
+ import { antonym, bem, cx, escape, isSize, match, toCamelCase, toKebabCase, toPascalCase, toTitleCase, transformSize } from "./string.js";
7
7
  import { ariaAttr, contains, createdDom, dataAttr, getActiveElement, getDocument, getDocumentElement, getFirstFocusableElement, getFirstTabbableElement, getFocusableElements, getLastTabbableElement, getNextTabbableElement, getNodeName, getParentNode, getPlatform, getPx, getTabIndex, getTabbableElementEdges, getTabbableElements, getUserAgent, getWindow, isActiveElement, isAndroid, isApple, isChrome, isDisabledElement, isDocument, isEditableElement, isFirefox, isFocusableElement, isFrame, isHTMLElement, isHiddenElement, isIPad, isIPhone, isInputElement, isIos, isMac, isNode, isSafari, isShadowRoot, isTabbableElement, isTouchDevice, isTruthyDataAttr, isVisibleElement, isVisualViewport, isWebKit, isWindow, platform, scrollLock, setAttribute, setStyle, userAgent, uuid, vendor } from "./dom.js";
8
8
  import { addDomEvent, focusTransfer, focusTrap, getEventPoint, getEventWindow, isMouseEvent, isMultiTouchEvent, isTouchEvent, pointFromMouse, pointFromTouch } from "./event.js";
9
9
  import { isRtl } from "./i18n.js";
@@ -11,4 +11,4 @@ import { interopDefault } from "./module.js";
11
11
  import { clampNumber, countDecimal, percentToValue, roundNumberToStep, toNumber, toPrecision, valueToPercent } from "./number.js";
12
12
  import { extractFlatObject, extractObject, filterObject, filterUndefined, flattenObject, getMemoizedObject, getObject, memoizeObject, merge, objectKeys, omitObject, pickObject, replaceObject, splitObject, wrapWithKey } from "./object.js";
13
13
 
14
- export { COLOR_SCHEMES, DEFAULT_COLOR_SCHEMES, SEMANTIC_COLOR_SCHEMES, TONES, addDomEvent, alphaToHex, antonym, ariaAttr, bem, calc, calcFormat, cast, clampNumber, contains, convertColor, countDecimal, createdDom, cx, dataAttr, escape, extractFlatObject, extractObject, filterEmpty, filterObject, filterUndefined, flattenObject, fnAll, focusTransfer, focusTrap, getActiveElement, getAlpha, getDocument, getDocumentElement, getEventPoint, getEventWindow, getFirstFocusableElement, getFirstTabbableElement, getFocusableElements, getLastTabbableElement, getMemoizedObject, getNextTabbableElement, getNodeName, getObject, getParentNode, getPlatform, getPx, getTabIndex, getTabbableElementEdges, getTabbableElements, getUserAgent, getWindow, handlerAll, hslaTo, hsvTo, interopDefault, is, isActiveElement, isAndroid, isApple, isArray, isBoolean, isBooleanish, isChrome, isDate, isDisabledElement, isDocument, isEditableElement, isEmpty, isEmptyObject, isFirefox, isFocusableElement, isFrame, isFunction, isHTMLElement, isHiddenElement, isIPad, isIPhone, isInputElement, isIos, isMac, isMouseEvent, isMultiTouchEvent, isNode, isNotNumber, isNull, isNumber, isNumeric, isObject, isRegExp, isRtl, isSafari, isShadowRoot, isSize, isString, isTabbableElement, isTouchDevice, isTouchEvent, isTruthyDataAttr, isUndefined, isUnit, isVisibleElement, isVisualViewport, isWebKit, isWindow, memoizeObject, merge, noop, objectKeys, omitObject, parseToHsla, parseToHsv, parseToRgba, percentToValue, pickObject, platform, pointFromMouse, pointFromTouch, replaceObject, rgbaTo, roundNumberToStep, runIfFn, sameColor, scrollLock, setAttribute, setStyle, splitObject, toArray, toCamelCase, toKebabCase, toNumber, toPascalCase, toPrecision, toTitleCase, transformSize, userAgent, uuid, valueToPercent, vendor, wait, wrapWithKey };
14
+ export { COLOR_SCHEMES, DEFAULT_COLOR_SCHEMES, SEMANTIC_COLOR_SCHEMES, TONES, addDomEvent, alphaToHex, antonym, ariaAttr, bem, calc, calcFormat, cast, clampNumber, contains, convertColor, countDecimal, createdDom, cx, dataAttr, escape, extractFlatObject, extractObject, filterEmpty, filterObject, filterUndefined, flattenObject, fnAll, focusTransfer, focusTrap, getActiveElement, getAlpha, getDocument, getDocumentElement, getEventPoint, getEventWindow, getFirstFocusableElement, getFirstTabbableElement, getFocusableElements, getLastTabbableElement, getMemoizedObject, getNextTabbableElement, getNodeName, getObject, getParentNode, getPlatform, getPx, getTabIndex, getTabbableElementEdges, getTabbableElements, getUserAgent, getWindow, handlerAll, hslaTo, hsvTo, interopDefault, is, isActiveElement, isAndroid, isApple, isArray, isBoolean, isBooleanish, isChrome, isDate, isDisabledElement, isDocument, isEditableElement, isEmpty, isEmptyObject, isFirefox, isFocusableElement, isFrame, isFunction, isHTMLElement, isHiddenElement, isIPad, isIPhone, isInputElement, isIos, isMac, isMouseEvent, isMultiTouchEvent, isNode, isNotNumber, isNull, isNumber, isNumeric, isObject, isRegExp, isRtl, isSafari, isShadowRoot, isSize, isString, isTabbableElement, isTouchDevice, isTouchEvent, isTruthyDataAttr, isUndefined, isUnit, isVisibleElement, isVisualViewport, isWebKit, isWindow, match, memoizeObject, merge, noop, objectKeys, omitObject, parseToHsla, parseToHsv, parseToRgba, percentToValue, pickObject, platform, pointFromMouse, pointFromTouch, replaceObject, rgbaTo, roundNumberToStep, runIfFn, sameColor, scrollLock, setAttribute, setStyle, splitObject, toArray, toCamelCase, toKebabCase, toNumber, toPascalCase, toPrecision, toTitleCase, transformSize, userAgent, uuid, valueToPercent, vendor, wait, wrapWithKey };
package/dist/esm/string.js CHANGED
@@ -81,7 +81,15 @@ function bem(block, element, modifier) {
81
81
  if (modifier) className += `--${modifier}`;
82
82
  return className;
83
83
  }
84
+ function match(value, query, strategy = "contains") {
85
+ switch (strategy) {
86
+ case "contains": return value.toLowerCase().includes(query.toLowerCase());
87
+ case "endsWith": return value.toLowerCase().endsWith(query.toLowerCase());
88
+ case "equals": return value.toLowerCase() === query.toLowerCase();
89
+ case "startsWith": return value.toLowerCase().startsWith(query.toLowerCase());
90
+ }
91
+ }
84
92
 
85
93
  //#endregion
86
- export { antonym, bem, cx, escape, isSize, toCamelCase, toKebabCase, toPascalCase, toTitleCase, transformSize };
94
+ export { antonym, bem, cx, escape, isSize, match, toCamelCase, toKebabCase, toPascalCase, toTitleCase, transformSize };
87
95
  //# sourceMappingURL=string.js.map
package/dist/esm/string.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"string.js","names":["sizeMap: AnyString[]"],"sources":["../../src/string.ts"],"sourcesContent":["import type { AnyString } from \"./index.types\"\nimport { isString } from \"./assertion\"\n\nexport function cx(\n ...classNames: (null | string | undefined)[]\n): string | undefined {\n const result = classNames.filter((className) => !!className)\n\n if (!result.length) return undefined\n\n return result.map((className) => className!.trim()).join(\" \")\n}\n\nexport function escape(value: string, replaceValue = \"\"): string {\n return value.replace(/\\s+/g, replaceValue)\n}\n\nexport function antonym(value: string): string {\n switch (value) {\n case \"top\":\n return \"bottom\"\n\n case \"bottom\":\n return \"top\"\n\n case \"left\":\n return \"right\"\n\n case \"right\":\n return \"left\"\n\n case \"start\":\n return \"end\"\n\n case \"end\":\n return \"start\"\n\n case \"x\":\n return \"y\"\n\n case \"y\":\n return \"x\"\n\n case \"enter\":\n return \"exit\"\n\n case \"exit\":\n return \"enter\"\n\n case \"vertical\":\n return \"horizontal\"\n\n case \"horizontal\":\n return \"vertical\"\n\n case \"up\":\n return \"down\"\n\n case \"down\":\n return \"up\"\n\n case \"block\":\n return \"inline\"\n\n case \"inline\":\n return \"block\"\n\n default:\n return value\n }\n}\n\nconst sizeMap: AnyString[] = [\n \"9xs\",\n \"8xs\",\n \"7xs\",\n \"6xs\",\n \"5xs\",\n \"4xs\",\n \"3xs\",\n \"2xs\",\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\",\n \"xl\",\n \"2xl\",\n \"3xl\",\n \"4xl\",\n \"5xl\",\n \"6xl\",\n \"7xl\",\n \"8xl\",\n \"9xl\",\n]\n\nexport function isSize(value: any): boolean {\n return isString(value) && sizeMap.includes(value)\n}\n\nexport function transformSize<Y = string>(\n token: string | undefined,\n value: number,\n omitTokens: null | string[] = null,\n): undefined | Y {\n if (!token) return undefined\n\n let resolvedSizeMap = sizeMap\n\n if (omitTokens)\n resolvedSizeMap = sizeMap.filter((size) => !omitTokens.includes(size))\n\n const index = resolvedSizeMap.indexOf(token)\n const size = resolvedSizeMap[index + value]\n\n return (size ?? token) as Y\n}\n\nexport function toCamelCase(value: AnyString): string {\n return value\n .replace(/[_-](.)/g, (_, val) => val.toUpperCase())\n .replace(/^(.)/, (_, val) => val.toLowerCase())\n}\n\nexport function toPascalCase(value: AnyString): string {\n return value\n .replace(/[_-](.)/g, (_, val) => val.toUpperCase())\n .replace(/^(.)/, (_, val) => val.toUpperCase())\n}\n\nexport function toKebabCase(value: AnyString): string {\n return value\n .replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, \"$1-$2\")\n .toLowerCase()\n .replace(/^-/, \"\")\n}\n\nexport function toTitleCase(value: AnyString): string {\n return value\n .replace(/([A-Z])/g, \" $1\")\n .replace(/[_-](.)/g, (_, val) => ` ${val.toUpperCase()}`)\n .replace(/^./, (str) => str.toUpperCase())\n .trim()\n}\n\nexport function bem(block: string, element?: string, modifier?: string) {\n let className = block\n\n if (element) className += `__${element}`\n if (modifier) className += `--${modifier}`\n\n return className\n}\n"],"mappings":";;;AAGA,SAAgB,GACd,GAAG,YACiB;CACpB,MAAM,SAAS,WAAW,QAAQ,cAAc,CAAC,CAAC,UAAU;AAE5D,KAAI,CAAC,OAAO,OAAQ,QAAO;AAE3B,QAAO,OAAO,KAAK,cAAc,UAAW,MAAM,CAAC,CAAC,KAAK,IAAI;;AAG/D,SAAgB,OAAO,OAAe,eAAe,IAAY;AAC/D,QAAO,MAAM,QAAQ,QAAQ,aAAa;;AAG5C,SAAgB,QAAQ,OAAuB;AAC7C,SAAQ,OAAR;EACE,KAAK,MACH,QAAO;EAET,KAAK,SACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,MACH,QAAO;EAET,KAAK,IACH,QAAO;EAET,KAAK,IACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,WACH,QAAO;EAET,KAAK,aACH,QAAO;EAET,KAAK,KACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,SACH,QAAO;EAET,QACE,QAAO;;;AAIb,MAAMA,UAAuB;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAgB,OAAO,OAAqB;AAC1C,QAAO,SAAS,MAAM,IAAI,QAAQ,SAAS,MAAM;;AAGnD,SAAgB,cACd,OACA,OACA,aAA8B,MACf;AACf,KAAI,CAAC,MAAO,QAAO;CAEnB,IAAI,kBAAkB;AAEtB,KAAI,WACF,mBAAkB,QAAQ,QAAQ,SAAS,CAAC,WAAW,SAAS,KAAK,CAAC;CAExE,MAAM,QAAQ,gBAAgB,QAAQ,MAAM;AAG5C,QAFa,gBAAgB,QAAQ,UAErB;;AAGlB,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,aAAa,GAAG,QAAQ,IAAI,aAAa,CAAC,CAClD,QAAQ,SAAS,GAAG,QAAQ,IAAI,aAAa,CAAC;;AAGnD,SAAgB,aAAa,OAA0B;AACrD,QAAO,MACJ,QAAQ,aAAa,GAAG,QAAQ,IAAI,aAAa,CAAC,CAClD,QAAQ,SAAS,GAAG,QAAQ,IAAI,aAAa,CAAC;;AAGnD,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,gCAAgC,QAAQ,CAChD,aAAa,CACb,QAAQ,MAAM,GAAG;;AAGtB,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,YAAY,MAAM,CAC1B,QAAQ,aAAa,GAAG,QAAQ,IAAI,IAAI,aAAa,GAAG,CACxD,QAAQ,OAAO,QAAQ,IAAI,aAAa,CAAC,CACzC,MAAM;;AAGX,SAAgB,IAAI,OAAe,SAAkB,UAAmB;CACtE,IAAI,YAAY;AAEhB,KAAI,QAAS,cAAa,KAAK;AAC/B,KAAI,SAAU,cAAa,KAAK;AAEhC,QAAO"}
1
+ {"version":3,"file":"string.js","names":["sizeMap: AnyString[]"],"sources":["../../src/string.ts"],"sourcesContent":["import type { AnyString } from \"./index.types\"\nimport { isString } from \"./assertion\"\n\nexport function cx(\n ...classNames: (null | string | undefined)[]\n): string | undefined {\n const result = classNames.filter((className) => !!className)\n\n if (!result.length) return undefined\n\n return result.map((className) => className!.trim()).join(\" \")\n}\n\nexport function escape(value: string, replaceValue = \"\"): string {\n return value.replace(/\\s+/g, replaceValue)\n}\n\nexport function antonym(value: string): string {\n switch (value) {\n case \"top\":\n return \"bottom\"\n\n case \"bottom\":\n return \"top\"\n\n case \"left\":\n return \"right\"\n\n case \"right\":\n return \"left\"\n\n case \"start\":\n return \"end\"\n\n case \"end\":\n return \"start\"\n\n case \"x\":\n return \"y\"\n\n case \"y\":\n return \"x\"\n\n case \"enter\":\n return \"exit\"\n\n case \"exit\":\n return \"enter\"\n\n case \"vertical\":\n return \"horizontal\"\n\n case \"horizontal\":\n return \"vertical\"\n\n case \"up\":\n return \"down\"\n\n case \"down\":\n return \"up\"\n\n case \"block\":\n return \"inline\"\n\n case \"inline\":\n return \"block\"\n\n default:\n return value\n }\n}\n\nconst sizeMap: AnyString[] = [\n \"9xs\",\n \"8xs\",\n \"7xs\",\n \"6xs\",\n \"5xs\",\n \"4xs\",\n \"3xs\",\n \"2xs\",\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\",\n \"xl\",\n \"2xl\",\n \"3xl\",\n \"4xl\",\n \"5xl\",\n \"6xl\",\n \"7xl\",\n \"8xl\",\n \"9xl\",\n]\n\nexport function isSize(value: any): boolean {\n return isString(value) && sizeMap.includes(value)\n}\n\nexport function transformSize<Y = string>(\n token: string | undefined,\n value: number,\n omitTokens: null | string[] = null,\n): undefined | Y {\n if (!token) return undefined\n\n let resolvedSizeMap = sizeMap\n\n if (omitTokens)\n resolvedSizeMap = sizeMap.filter((size) => !omitTokens.includes(size))\n\n const index = resolvedSizeMap.indexOf(token)\n const size = resolvedSizeMap[index + value]\n\n return (size ?? token) as Y\n}\n\nexport function toCamelCase(value: AnyString): string {\n return value\n .replace(/[_-](.)/g, (_, val) => val.toUpperCase())\n .replace(/^(.)/, (_, val) => val.toLowerCase())\n}\n\nexport function toPascalCase(value: AnyString): string {\n return value\n .replace(/[_-](.)/g, (_, val) => val.toUpperCase())\n .replace(/^(.)/, (_, val) => val.toUpperCase())\n}\n\nexport function toKebabCase(value: AnyString): string {\n return value\n .replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, \"$1-$2\")\n .toLowerCase()\n .replace(/^-/, \"\")\n}\n\nexport function toTitleCase(value: AnyString): string {\n return value\n .replace(/([A-Z])/g, \" $1\")\n .replace(/[_-](.)/g, (_, val) => ` ${val.toUpperCase()}`)\n .replace(/^./, (str) => str.toUpperCase())\n .trim()\n}\n\nexport function bem(block: string, element?: string, modifier?: string) {\n let className = block\n\n if (element) className += `__${element}`\n if (modifier) className += `--${modifier}`\n\n return className\n}\n\nexport function match(\n value: string,\n query: string,\n strategy: \"contains\" | \"endsWith\" | \"equals\" | \"startsWith\" = \"contains\",\n) {\n switch (strategy) {\n case \"contains\":\n return value.toLowerCase().includes(query.toLowerCase())\n case \"endsWith\":\n return value.toLowerCase().endsWith(query.toLowerCase())\n case \"equals\":\n return value.toLowerCase() === query.toLowerCase()\n case \"startsWith\":\n return value.toLowerCase().startsWith(query.toLowerCase())\n }\n}\n"],"mappings":";;;AAGA,SAAgB,GACd,GAAG,YACiB;CACpB,MAAM,SAAS,WAAW,QAAQ,cAAc,CAAC,CAAC,UAAU;AAE5D,KAAI,CAAC,OAAO,OAAQ,QAAO;AAE3B,QAAO,OAAO,KAAK,cAAc,UAAW,MAAM,CAAC,CAAC,KAAK,IAAI;;AAG/D,SAAgB,OAAO,OAAe,eAAe,IAAY;AAC/D,QAAO,MAAM,QAAQ,QAAQ,aAAa;;AAG5C,SAAgB,QAAQ,OAAuB;AAC7C,SAAQ,OAAR;EACE,KAAK,MACH,QAAO;EAET,KAAK,SACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,MACH,QAAO;EAET,KAAK,IACH,QAAO;EAET,KAAK,IACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,WACH,QAAO;EAET,KAAK,aACH,QAAO;EAET,KAAK,KACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,QACH,QAAO;EAET,KAAK,SACH,QAAO;EAET,QACE,QAAO;;;AAIb,MAAMA,UAAuB;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAgB,OAAO,OAAqB;AAC1C,QAAO,SAAS,MAAM,IAAI,QAAQ,SAAS,MAAM;;AAGnD,SAAgB,cACd,OACA,OACA,aAA8B,MACf;AACf,KAAI,CAAC,MAAO,QAAO;CAEnB,IAAI,kBAAkB;AAEtB,KAAI,WACF,mBAAkB,QAAQ,QAAQ,SAAS,CAAC,WAAW,SAAS,KAAK,CAAC;CAExE,MAAM,QAAQ,gBAAgB,QAAQ,MAAM;AAG5C,QAFa,gBAAgB,QAAQ,UAErB;;AAGlB,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,aAAa,GAAG,QAAQ,IAAI,aAAa,CAAC,CAClD,QAAQ,SAAS,GAAG,QAAQ,IAAI,aAAa,CAAC;;AAGnD,SAAgB,aAAa,OAA0B;AACrD,QAAO,MACJ,QAAQ,aAAa,GAAG,QAAQ,IAAI,aAAa,CAAC,CAClD,QAAQ,SAAS,GAAG,QAAQ,IAAI,aAAa,CAAC;;AAGnD,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,gCAAgC,QAAQ,CAChD,aAAa,CACb,QAAQ,MAAM,GAAG;;AAGtB,SAAgB,YAAY,OAA0B;AACpD,QAAO,MACJ,QAAQ,YAAY,MAAM,CAC1B,QAAQ,aAAa,GAAG,QAAQ,IAAI,IAAI,aAAa,GAAG,CACxD,QAAQ,OAAO,QAAQ,IAAI,aAAa,CAAC,CACzC,MAAM;;AAGX,SAAgB,IAAI,OAAe,SAAkB,UAAmB;CACtE,IAAI,YAAY;AAEhB,KAAI,QAAS,cAAa,KAAK;AAC/B,KAAI,SAAU,cAAa,KAAK;AAEhC,QAAO;;AAGT,SAAgB,MACd,OACA,OACA,WAA8D,YAC9D;AACA,SAAQ,UAAR;EACE,KAAK,WACH,QAAO,MAAM,aAAa,CAAC,SAAS,MAAM,aAAa,CAAC;EAC1D,KAAK,WACH,QAAO,MAAM,aAAa,CAAC,SAAS,MAAM,aAAa,CAAC;EAC1D,KAAK,SACH,QAAO,MAAM,aAAa,KAAK,MAAM,aAAa;EACpD,KAAK,aACH,QAAO,MAAM,aAAa,CAAC,WAAW,MAAM,aAAa,CAAC"}
package/dist/types/index.d.ts CHANGED
@@ -10,5 +10,5 @@ import { isRtl } from "./i18n.js";
10
10
  import { interopDefault } from "./module.js";
11
11
  import { clampNumber, countDecimal, percentToValue, roundNumberToStep, toNumber, toPrecision, valueToPercent } from "./number.js";
12
12
  import { FlattenObjectOptions, MergeOptions, extractFlatObject, extractObject, filterObject, filterUndefined, flattenObject, getMemoizedObject, getObject, memoizeObject, merge, objectKeys, omitObject, pickObject, replaceObject, splitObject, wrapWithKey } from "./object.js";
13
- import { antonym, bem, cx, escape, isSize, toCamelCase, toKebabCase, toPascalCase, toTitleCase, transformSize } from "./string.js";
14
- export { AnyPointerEvent, AnyString, Booleanish, COLOR_SCHEMES, ColorFormat, DEFAULT_COLOR_SCHEMES, DeepMerge, DeepPartial, Dict, EventMap, EventType, FlattenObjectOptions, FunctionOrValue, Length, Merge, MergeOptions, Path, Point, Prettify, Primitive, SEMANTIC_COLOR_SCHEMES, TONES, Value, addDomEvent, alphaToHex, antonym, ariaAttr, bem, calc, calcFormat, cast, clampNumber, contains, convertColor, countDecimal, createdDom, cx, dataAttr, escape, extractFlatObject, extractObject, filterEmpty, filterObject, filterUndefined, flattenObject, fnAll, focusTransfer, focusTrap, getActiveElement, getAlpha, getDocument, getDocumentElement, getEventPoint, getEventWindow, getFirstFocusableElement, getFirstTabbableElement, getFocusableElements, getLastTabbableElement, getMemoizedObject, getNextTabbableElement, getNodeName, getObject, getParentNode, getPlatform, getPx, getTabIndex, getTabbableElementEdges, getTabbableElements, getUserAgent, getWindow, handlerAll, hslaTo, hsvTo, interopDefault, is, isActiveElement, isAndroid, isApple, isArray, isBoolean, isBooleanish, isChrome, isDate, isDisabledElement, isDocument, isEditableElement, isEmpty, isEmptyObject, isFirefox, isFocusableElement, isFrame, isFunction, isHTMLElement, isHiddenElement, isIPad, isIPhone, isInputElement, isIos, isMac, isMouseEvent, isMultiTouchEvent, isNode, isNotNumber, isNull, isNumber, isNumeric, isObject, isRegExp, isRtl, isSafari, isShadowRoot, isSize, isString, isTabbableElement, isTouchDevice, isTouchEvent, isTruthyDataAttr, isUndefined, isUnit, isVisibleElement, isVisualViewport, isWebKit, isWindow, memoizeObject, merge, noop, objectKeys, omitObject, parseToHsla, parseToHsv, parseToRgba, percentToValue, pickObject, platform, pointFromMouse, pointFromTouch, replaceObject, rgbaTo, roundNumberToStep, runIfFn, sameColor, scrollLock, setAttribute, setStyle, splitObject, toArray, toCamelCase, toKebabCase, toNumber, toPascalCase, toPrecision, toTitleCase, transformSize, userAgent, uuid, valueToPercent, vendor, wait, wrapWithKey };
13
+ import { antonym, bem, cx, escape, isSize, match, toCamelCase, toKebabCase, toPascalCase, toTitleCase, transformSize } from "./string.js";
14
+ export { AnyPointerEvent, AnyString, Booleanish, COLOR_SCHEMES, ColorFormat, DEFAULT_COLOR_SCHEMES, DeepMerge, DeepPartial, Dict, EventMap, EventType, FlattenObjectOptions, FunctionOrValue, Length, Merge, MergeOptions, Path, Point, Prettify, Primitive, SEMANTIC_COLOR_SCHEMES, TONES, Value, addDomEvent, alphaToHex, antonym, ariaAttr, bem, calc, calcFormat, cast, clampNumber, contains, convertColor, countDecimal, createdDom, cx, dataAttr, escape, extractFlatObject, extractObject, filterEmpty, filterObject, filterUndefined, flattenObject, fnAll, focusTransfer, focusTrap, getActiveElement, getAlpha, getDocument, getDocumentElement, getEventPoint, getEventWindow, getFirstFocusableElement, getFirstTabbableElement, getFocusableElements, getLastTabbableElement, getMemoizedObject, getNextTabbableElement, getNodeName, getObject, getParentNode, getPlatform, getPx, getTabIndex, getTabbableElementEdges, getTabbableElements, getUserAgent, getWindow, handlerAll, hslaTo, hsvTo, interopDefault, is, isActiveElement, isAndroid, isApple, isArray, isBoolean, isBooleanish, isChrome, isDate, isDisabledElement, isDocument, isEditableElement, isEmpty, isEmptyObject, isFirefox, isFocusableElement, isFrame, isFunction, isHTMLElement, isHiddenElement, isIPad, isIPhone, isInputElement, isIos, isMac, isMouseEvent, isMultiTouchEvent, isNode, isNotNumber, isNull, isNumber, isNumeric, isObject, isRegExp, isRtl, isSafari, isShadowRoot, isSize, isString, isTabbableElement, isTouchDevice, isTouchEvent, isTruthyDataAttr, isUndefined, isUnit, isVisibleElement, isVisualViewport, isWebKit, isWindow, match, memoizeObject, merge, noop, objectKeys, omitObject, parseToHsla, parseToHsv, parseToRgba, percentToValue, pickObject, platform, pointFromMouse, pointFromTouch, replaceObject, rgbaTo, roundNumberToStep, runIfFn, sameColor, scrollLock, setAttribute, setStyle, splitObject, toArray, toCamelCase, toKebabCase, toNumber, toPascalCase, toPrecision, toTitleCase, transformSize, userAgent, uuid, valueToPercent, vendor, wait, wrapWithKey };
package/dist/types/string.d.ts CHANGED
@@ -11,6 +11,7 @@ declare function toPascalCase(value: AnyString): string;
11
11
  declare function toKebabCase(value: AnyString): string;
12
12
  declare function toTitleCase(value: AnyString): string;
13
13
  declare function bem(block: string, element?: string, modifier?: string): string;
14
+ declare function match(value: string, query: string, strategy?: "contains" | "endsWith" | "equals" | "startsWith"): boolean;
14
15
  //#endregion
15
- export { antonym, bem, cx, escape, isSize, toCamelCase, toKebabCase, toPascalCase, toTitleCase, transformSize };
16
+ export { antonym, bem, cx, escape, isSize, match, toCamelCase, toKebabCase, toPascalCase, toTitleCase, transformSize };
16
17
  //# sourceMappingURL=string.d.ts.map
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@yamada-ui/utils",
3
3
  "type": "module",
4
- "version": "2.1.2-dev-20260323012739",
4
+ "version": "2.1.2-dev-20260323160112",
5
5
  "description": "The utilities for Yamada UI projects",
6
6
  "keywords": [
7
7
  "utils",