gentleduck/libs

Philosophy

Every UI library needs utility functions, but they shouldn't be a dependency decision. gentleduck/libs provides the small, typed helpers (cn for class merging, formatters, assertion functions) that every component uses internally. They're extracted into a shared package so you can use them too, without pulling in lodash for three functions.

Installation

npm install @gentleduck/libs

npm install @gentleduck/libs

Available Utilities

• cn - Utility for conditional className merging.
• filtered-object - Create a new object by excluding specified keys.
• group-array - Split an array into sub-arrays by numeric group sizes.
• group-data-by-numbers - Group array elements into sub-arrays by specified chunk sizes.
• parse-date - Parse strings or values into valid Date objects.
• generateArabicSlug - Convert text to URL slugs preserving Arabic characters.
• getTodayDate - Return today's date as a YYYY-MM-DD string.
• index.ts - Barrel file that re-exports utilities.

Usage

import { cn } from '@gentleduck/libs'
 
function MyComponent({ active }: { active: boolean }) {
  return (
    <div className={cn('rounded-md border p-4', active && 'bg-primary text-primary-foreground')}>
      Hello
    </div>
  )
}

import { cn } from '@gentleduck/libs'
 
function MyComponent({ active }: { active: boolean }) {
  return (
    <div className={cn('rounded-md border p-4', active && 'bg-primary text-primary-foreground')}>
      Hello
    </div>
  )
}