title: "@stnd/utils" aliases: [] created: 2026-07-05 07:47 modified: 2026-07-07 10:42 last_audited: 2026-07-14 audit_interval_days: 90 next_audit: 2026-10-12 audit_priority: 3 maturity: tree mode: read publish: false status: active tags:

• package
• stnd theme: kernel type: package visibility: private

@stnd/utils

Pure utility functions for the Standard Ecosystem.

ELI5

The odds-and-ends drawer: slugify a title, count reading time, merge two config objects deeply, validate a filename. No framework, no side effects, zero dependencies — safe to import anywhere (Node, browser, Cloudflare Worker) without dragging anything else in.

import { slugify, formatDate } from "@stnd/utils";
slugify("Hello World!"); // "hello-world"
formatDate(new Date(), "dot"); // "24.03.14" — YY.MM.DD, two-digit year

Overview

@stnd/utils provides a collection of small, focused utility functions with zero dependencies. These functions are designed to be “pure” — they have no side effects and do not depend on any specific framework or environment (isomorphic).

Key Modules

String & Content (/utils.js)

• slugify(text): Robust generation of URL-friendly slugs.
• excerptWords(content, maxWords): Generates excerpts from Markdown.
• firstParagraph(content): Extracts the first paragraph of text.
• getReadingTime(text): Estimates reading time in minutes.
• numberOfWords(text): Accurate word count for various languages.

Filenames & IDs (/filename.js)

• isNanoId(str): Validates Nano ID format.
• generateShortId(length): Generates a cryptographically secure short ID.
• sanitizeFilename(name, fallback): Ensures a string is safe for use as a filename.
• makeUniqueFilename(base, usedSet): Appends suffixes to avoid filename collisions.

CSS Sanitization (/css.js)

• sanitizeCssColor(value): Validates and cleans CSS color strings.
• sanitizeCssFontFamily(value): Validates font family declarations.
• sanitizeCssNumber(value): Validates numeric values with units (px, rem, etc.).

Date & Time (/utils.js)

• formatDate(date, format): Flexible date formatting (ISO, HTML, locale).
• getYear(date): Extracts the year from various date formats.
• timeAgo(timestamp): Human-readable relative time (e.g., “5m ago”).

Data & Logic (/utils.js)

• deepMerge(target, …sources): Deeply merges multiple objects.
• validateEmail(email): Basic email format validation.
• filterData(arr, path, value): Filters an array of objects based on a nested property path.

Usage

import { slugify, formatDate } from "@stnd/utils";

const title = "Hello World!";
const slug = slugify(title); // "hello-world"

const today = formatDate(new Date(), "dot"); // "24.03.14" (YY.MM.DD)

Features

• Tree-Shakable: Import only what you need to keep your bundles small.
• Isomorphic: Works in Node.js, Browsers, and Edge Workers.
• Zero Dependencies: Maximum portability and security.

Notes / Observations

• The "dot" format is YY.MM.DD (two-digit year) — a prior version of this doc claimed "2024.03.14" (four-digit year), which doesn’t match formatDate‘s actual implementation in utils.js.

Todo

• [ ] Nothing tracked yet. [priority:: 3] [token_scale:: 3] [created:: 2026-07-14] [area:: framework]