| name | movk-core |
| description | Use @movk/core, a tree-shakable TypeScript utility library — type guards (validators), array/async/css/function/math/url utilities, string/object/tree/markdown transformers, object/path/file helpers, and Vue composables. Use when picking a utility, converting flat data to a tree, transforming naming cases, parsing or building URLs, clamping or remapping numbers, composing functions, keeping an id-keyed instance registry, deep cloning or merging objects, or calling @movk/core composables. |
movk-core
@movk/core is a tree-shakable TypeScript utility library. The entry src/index.ts re-exports every module: validators (type guards), utilities (array / async / css / function / math / url), transformers (string / object / tree / markdown), helpers (object / path / file), and Vue composables. Prefer an existing function over writing new code.
MCP Server
The @movk/core MCP server serves live function docs, source, and real examples. If not already configured, add it:
claude mcp add --transport http movk-core https://core.mhaibaraai.cn/mcp
Tools:
list-functions — list every function grouped by category and subcategory (no params).get-function — full docs and examples for one function by name (camelCase or kebab-case).search-functions — search by category, subcategory, or keyword.
Prompts:
find-function-for-usecase — guided selection of the best function for a use case.
Resources:
resource://movk-core/all-functions — the full function index.resource://movk-core/tree-operations — the tree operations reference (core feature).
Use the MCP to confirm what a function accepts. This skill teaches you which function to reach for and how to use it correctly.
Core rules (always apply)
- Import on demand — the build is tree-shakable, so import only what you use:
import { chunk, Tree } from '@movk/core'. Never deep-import internal paths.
- Treat utilities as pure — validators, transformers, and utilities are side-effect free and never mutate their inputs; use the returned value.
- Do not invent APIs — function names and signatures follow the actual exports in
src/; confirm via the MCP or src/<module>/<fnName>.ts when unsure.
- Tree operations take a
config — every Tree.* static method accepts { id, pid, children } field names (customizable), e.g. Tree.fromList(list, { id: 'id', pid: 'parentId', children: 'children' }).
- Keep three places in sync — when adding a capability, update
src/<module>/<fnName>.ts (+ its re-export), tests/<module>/<kebab-name>.test.ts (mirrored, kebab-case), and docs/content/docs/<n.module>/[subcategory/]<kebab-name>.md.
How to use this skill
Match the task to a module, then pick the function. Use the MCP get-function for the exact signature before writing code.
Module map
| Module | Directory | Representative functions / types |
|---|
| composables | src/composables | useAppStorage, useCopyCode, useInfiniteScrollBinding, useOverflowDetection |
| validators | src/validators | isArray, isObject, isPlainObject, isString, isNumber, isFunction, isEmpty, isValidContainer |
| utilities/array | src/utilities/array | chunk, flatten, unique |
| utilities/async | src/utilities/async | debounce, throttle, sleep, sleepWithCancel |
| utilities/css | src/utilities/css | lengthToPx |
| utilities/function | src/utilities/function | pipe |
| utilities/math | src/utilities/math | clamp, mapRange |
| utilities/url | src/utilities/url | parseUrl, buildUrl, joinUrl, normalizeUrl, parseQuery, stringifyQuery, getQueryParam(s), set/append/removeQueryParam, getDomain, getRootDomain, toAbsoluteUrl, getRelativePath |
| transformers/string | src/transformers/string | camelCase, pascalCase, kebabCase, snakeCase, , , , , |
Use case → function
| Need | Function |
|---|
| Dedupe / chunk / flatten arrays | unique, chunk, flatten |
| Throttle / debounce / delay | throttle, debounce, sleep, sleepWithCancel |
| Flat data ↔ tree / find / filter | Tree.fromList, Tree.toList, Tree.find*, Tree.filter |
| Naming-case conversion | camelCase, pascalCase, kebabCase, snakeCase, startCase |
| Deep clone / merge / pick keys | deepClone, deepMerge, pick, omit, separate |
| Whether two objects are the same item | equalsBy, createEqualsBy |
| Read/write nested paths | getPath, setPath, toPath, joinPath |
| URL parse / build / query params | parseUrl, buildUrl, joinUrl, parseQuery, *QueryParam(s) |
| Type guards | isArray, isObject, isPlainObject, isString, isEmpty |
| File size / download / SVG | formatFileSize, triggerDownload, convertSvgToPng |
| CSS length to pixels | lengthToPx |
| Constrain a number / map between ranges | clamp, mapRange |
| Compose functions left to right | pipe |
| Track instances by id across trees or routes |
