@take-out/helpers 0.0.28

package/types/string/pluralize.native.d.ts.map

@@ -0,0 +1,13 @@
+{
+  "mappings": "AAAA,cAAc,mBAAmB,aAAa;AAE9C,OAAO,cAAMA,WAAW",
+  "names": [
+    "pluralize: PluralizeFn"
+  ],
+  "sources": [
+    "src/string/pluralize.native.ts"
+  ],
+  "sourcesContent": [
+    "import type { PluralizeFn } from './pluralize'\n\nexport const pluralize: PluralizeFn = (count, singular, plural) => {\n  console.info('pluralize.native.ts: TODO', count, singular, plural)\n  return plural\n}\n"
+  ],
+  "version": 3
+}

package/types/string/randomId.d.ts

@@ -0,0 +1,3 @@
+export declare const randomId: () => string;
+
+//# sourceMappingURL=randomId.d.ts.map

package/types/string/randomId.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,OAAO,cAAM",
+  "names": [],
+  "sources": [
+    "src/string/randomId.ts"
+  ],
+  "sourcesContent": [
+    "export const randomId = (): string => Math.random().toString(36).slice(2)\n"
+  ],
+  "version": 3
+}

package/types/string/slugify.d.ts

@@ -0,0 +1,3 @@
+export declare const slugify: (input: string) => string;
+
+//# sourceMappingURL=slugify.d.ts.map

package/types/string/slugify.d.ts.map

@@ -0,0 +1,13 @@
+{
+  "mappings": "AAAA,OAAO,cAAM,UAAWA",
+  "names": [
+    "input: string"
+  ],
+  "sources": [
+    "src/string/slugify.ts"
+  ],
+  "sourcesContent": [
+    "export const slugify = (input: string): string =>\n  input\n    .toLowerCase()\n    .replace(/[\\s_]+/g, '-') // convert spaces and underscores to dashes\n    .replace(/[^a-z0-9-]/g, '') // remove all non-alphanumeric except dashes\n    .replace(/-+/g, '-') // replace multiple dashes with single dash\n    .replace(/^-|-$/g, '') // remove leading/trailing dashes\n"
+  ],
+  "version": 3
+}

package/types/string/truncateList.d.ts

@@ -0,0 +1,17 @@
+/**
+* Truncates a list of strings to show only the first N items,
+* with a "+X" indicator for any remaining items.
+*
+* @param items - Array of strings to truncate
+* @param maxItems - Maximum number of items to show before truncating
+* @param separator - String to use between items (default: ', ')
+* @returns Formatted string with truncation indicator if needed
+*
+* @example
+* truncateList(['jon', 'sal', 'bob', 'ted'], 3) // "jon, sal, bob +1"
+* truncateList(['alice', 'bob'], 3) // "alice, bob"
+* truncateList(['a', 'b', 'c', 'd', 'e'], 2) // "a, b +3"
+*/
+export declare const truncateList: (items: string[], maxItems: number, separator?: string) => string;
+
+//# sourceMappingURL=truncateList.d.ts.map

package/types/string/truncateList.d.ts.map

@@ -0,0 +1,15 @@
+{
+  "mappings": ";;;;;;;;;;;;;;AAcA,OAAO,cAAM,eACXA,iBACAC,kBACAC",
+  "names": [
+    "items: string[]",
+    "maxItems: number",
+    "separator: string"
+  ],
+  "sources": [
+    "src/string/truncateList.ts"
+  ],
+  "sourcesContent": [
+    "/**\n * Truncates a list of strings to show only the first N items,\n * with a \"+X\" indicator for any remaining items.\n *\n * @param items - Array of strings to truncate\n * @param maxItems - Maximum number of items to show before truncating\n * @param separator - String to use between items (default: ', ')\n * @returns Formatted string with truncation indicator if needed\n *\n * @example\n * truncateList(['jon', 'sal', 'bob', 'ted'], 3) // \"jon, sal, bob +1\"\n * truncateList(['alice', 'bob'], 3) // \"alice, bob\"\n * truncateList(['a', 'b', 'c', 'd', 'e'], 2) // \"a, b +3\"\n */\nexport const truncateList = (\n  items: string[],\n  maxItems: number,\n  separator: string = ', '\n): string => {\n  if (items.length <= maxItems) {\n    return items.join(separator)\n  }\n\n  const visibleItems = items.slice(0, maxItems)\n  const remainingCount = items.length - maxItems\n\n  return `${visibleItems.join(separator)} +${remainingCount}`\n}\n"
+  ],
+  "version": 3
+}

package/types/time/formatDate.d.ts

@@ -0,0 +1,5 @@
+export declare function formatDate(date: Date, options?: {
+	daySuffix?: boolean;
+}): [string, string] | [string, string, string];
+
+//# sourceMappingURL=formatDate.d.ts.map

package/types/time/formatDate.d.ts.map

@@ -0,0 +1,14 @@
+{
+  "mappings": "AAEA,OAAO,iBAAS,WACdA,MAAM,MACNC,UAAU;CAAE;AAAqB",
+  "names": [
+    "date: Date",
+    "options?: { daySuffix?: boolean }"
+  ],
+  "sources": [
+    "src/time/formatDate.tsx"
+  ],
+  "sourcesContent": [
+    "const currentYear = new Date().getFullYear()\n\nexport function formatDate(\n  date: Date,\n  options?: { daySuffix?: boolean }\n): [string, string] | [string, string, string] {\n  const months = [\n    'January',\n    'February',\n    'March',\n    'April',\n    'May',\n    'June',\n    'July',\n    'August',\n    'September',\n    'October',\n    'November',\n    'December',\n  ]\n\n  const day = date.getDate()\n  const month = months[date.getMonth()]\n  const year = date.getFullYear()\n\n  const dayString = options?.daySuffix ? getOrdinalSuffix(day) : `${day}`\n\n  if (year === currentYear) {\n    return [`${month}`, dayString]\n  }\n\n  return [`${month}`, dayString, `${year}`]\n}\n\nconst getOrdinalSuffix = (n: number) => {\n  if (n >= 11 && n <= 13) return 'th'\n  switch (n % 10) {\n    case 1:\n      return 'st'\n    case 2:\n      return 'nd'\n    case 3:\n      return 'rd'\n    default:\n      return 'th'\n  }\n}\n"
+  ],
+  "version": 3
+}

package/types/time/formatDateRelative.d.ts

@@ -0,0 +1,3 @@
+export declare function formatDateRelative(date: Date | string | number): string;
+
+//# sourceMappingURL=formatDateRelative.d.ts.map

package/types/time/formatDateRelative.d.ts.map

@@ -0,0 +1,13 @@
+{
+  "mappings": "AAWA,OAAO,iBAAS,mBAAmBA,MAAM",
+  "names": [
+    "date: Date | string | number"
+  ],
+  "sources": [
+    "src/time/formatDateRelative.ts"
+  ],
+  "sourcesContent": [
+    "/**\n * Formats a date relative to the current time:\n * - If within the last month: just show time (e.g., \"5:50pm\")\n * - If this year but older than a month: show \"Jun 2, 5:50pm\"\n * - If before this year: show \"Jun 2, 2025, 5:50pm\"\n */\n\nfunction lowerCaseTime(formatted: string): string {\n  return formatted.replace(/\\s?(AM|PM)/g, (_, ampm) => ampm.toLowerCase())\n}\n\nexport function formatDateRelative(date: Date | string | number): string {\n  const messageDate = new Date(date)\n  const now = new Date()\n\n  // if it's today\n  const isToday =\n    messageDate.getFullYear() === now.getFullYear() &&\n    messageDate.getMonth() === now.getMonth() &&\n    messageDate.getDate() === now.getDate()\n\n  // check if it's within the last month\n  const oneMonthAgo = new Date(now)\n  oneMonthAgo.setMonth(oneMonthAgo.getMonth() - 1)\n  const isWithinLastMonth = messageDate >= oneMonthAgo\n\n  // if it's this year\n  const isThisYear = messageDate.getFullYear() === now.getFullYear()\n\n  if (isToday) {\n    // just time for today\n    return lowerCaseTime(\n      new Intl.DateTimeFormat('en', {\n        hour: 'numeric',\n        minute: 'numeric',\n      }).format(messageDate)\n    )\n  }\n\n  if (isWithinLastMonth) {\n    // just time for dates within the last month\n    return lowerCaseTime(\n      new Intl.DateTimeFormat('en', {\n        hour: 'numeric',\n        minute: 'numeric',\n      }).format(messageDate)\n    )\n  }\n\n  if (isThisYear) {\n    // Show \"Jun 2, 5:50pm\" for this year\n    return lowerCaseTime(\n      new Intl.DateTimeFormat('en', {\n        month: 'short',\n        day: 'numeric',\n        hour: 'numeric',\n        minute: 'numeric',\n      }).format(messageDate)\n    )\n  }\n\n  // Show \"Jun 2, 2025, 5:50pm\" for previous years\n  return lowerCaseTime(\n    new Intl.DateTimeFormat('en', {\n      month: 'short',\n      day: 'numeric',\n      year: 'numeric',\n      hour: 'numeric',\n      minute: 'numeric',\n    }).format(messageDate)\n  )\n}\n"
+  ],
+  "version": 3
+}

package/types/time/time.d.ts

@@ -0,0 +1,29 @@
+interface MsFunction {
+	(n: number): number;
+	seconds: (n: number) => number;
+	minutes: (n: number) => number;
+	hours: (n: number) => number;
+	days: (n: number) => number;
+	weeks: (n: number) => number;
+}
+interface SecondFunction {
+	(n: number): number;
+	minutes: (n: number) => number;
+	hours: (n: number) => number;
+	days: (n: number) => number;
+	weeks: (n: number) => number;
+}
+interface MinuteFunction {
+	(n: number): number;
+	hours: (n: number) => number;
+	days: (n: number) => number;
+	weeks: (n: number) => number;
+}
+export declare const time: {
+	ms: MsFunction;
+	second: SecondFunction;
+	minute: MinuteFunction;
+};
+export {};
+
+//# sourceMappingURL=time.d.ts.map

package/types/time/time.d.ts.map

@@ -0,0 +1,14 @@
+{
+  "mappings": "UAAU,WAAW;EAClBA;CACD,UAAUA;CACV,UAAUA;CACV,QAAQA;CACR,OAAOA;CACP,QAAQA;AACT;UAES,eAAe;EACtBA;CACD,UAAUA;CACV,QAAQA;CACR,OAAOA;CACP,QAAQA;AACT;UAES,eAAe;EACtBA;CACD,QAAQA;CACR,OAAOA;CACP,QAAQA;AACT;AAoBD,OAAO,cAAMC,MAAM;CACjB,IAAI;CACJ,QAAQ;CACR,QAAQ;AACT",
+  "names": [
+    "n: number",
+    "time: {\n  ms: MsFunction\n  second: SecondFunction\n  minute: MinuteFunction\n}"
+  ],
+  "sources": [
+    "src/time/time.ts"
+  ],
+  "sourcesContent": [
+    "interface MsFunction {\n  (n: number): number\n  seconds: (n: number) => number\n  minutes: (n: number) => number\n  hours: (n: number) => number\n  days: (n: number) => number\n  weeks: (n: number) => number\n}\n\ninterface SecondFunction {\n  (n: number): number\n  minutes: (n: number) => number\n  hours: (n: number) => number\n  days: (n: number) => number\n  weeks: (n: number) => number\n}\n\ninterface MinuteFunction {\n  (n: number): number\n  hours: (n: number) => number\n  days: (n: number) => number\n  weeks: (n: number) => number\n}\n\nconst ms = ((n: number) => n) as MsFunction\nms.seconds = (n: number) => n * 1000\nms.minutes = (n: number) => ms.seconds(n * 60)\nms.hours = (n: number) => ms.minutes(n * 60)\nms.days = (n: number) => ms.hours(n * 24)\nms.weeks = (n: number) => ms.days(n * 7)\n\nconst second = ((n: number) => n) as SecondFunction\nsecond.minutes = (n: number) => n * 60\nsecond.hours = (n: number) => second.minutes(n * 60)\nsecond.days = (n: number) => second.hours(n * 24)\nsecond.weeks = (n: number) => second.days(n * 7)\n\nconst minute = ((n: number) => n * 60) as MinuteFunction\nminute.hours = (n: number) => minute(n * 60)\nminute.days = (n: number) => minute.hours(n * 24)\nminute.weeks = (n: number) => minute.days(n * 7)\n\nexport const time: {\n  ms: MsFunction\n  second: SecondFunction\n  minute: MinuteFunction\n} = {\n  ms,\n  second,\n  minute,\n}\n"
+  ],
+  "version": 3
+}

package/types/types/NullToOptional.d.ts

@@ -0,0 +1,3 @@
+export type NullToOptional<T> = { [K in keyof T as null extends T[K] ? K : never]? : Exclude<T[K], null> | undefined | null } & { [K in keyof T as null extends T[K] ? never : K] : T[K] };
+
+//# sourceMappingURL=NullToOptional.d.ts.map

package/types/types/NullToOptional.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,YAAY,eAAe,QACxB,WAAW,kBAAkB,EAAE,KAAK,cAAa,QAAQ,EAAE,oCAE3D,WAAW,kBAAkB,EAAE,aAAa,KAAI,EAAE",
+  "names": [],
+  "sources": [
+    "src/types/NullToOptional.ts"
+  ],
+  "sourcesContent": [
+    "export type NullToOptional<T> = {\n  [K in keyof T as null extends T[K] ? K : never]?: Exclude<T[K], null> | undefined | null\n} & {\n  [K in keyof T as null extends T[K] ? never : K]: T[K]\n}\n"
+  ],
+  "version": 3
+}

package/types/types/object.d.ts

@@ -0,0 +1,18 @@
+// note - TS doesn't support higher kinded types, so this doesn't work well
+// --- utils ---
+export type Mutable<T> = { -readonly [K in keyof T] : T[K] };
+export type EntriesType = [PropertyKey, unknown][] | ReadonlyArray<readonly [PropertyKey, unknown]>;
+type DeepWritable<OBJ_T> = { -readonly [P in keyof OBJ_T] : DeepWritable<OBJ_T[P]> };
+type UnionToIntersection<UNION_T> = (UNION_T extends any ? (k: UNION_T) => void : never) extends (k: infer I) => void ? I : never;
+type UnionObjectFromArrayOfPairs<ARR_T extends EntriesType> = DeepWritable<ARR_T> extends (infer R)[] ? R extends [infer key, infer val] ? { [prop in key & PropertyKey] : val } : never : never;
+type MergeIntersectingObjects<ObjT> = { [key in keyof ObjT] : ObjT[key] };
+export type EntriesToObject<ARR_T extends EntriesType> = MergeIntersectingObjects<UnionToIntersection<UnionObjectFromArrayOfPairs<ARR_T>>>;
+export type ObjectType = Record<PropertyKey, unknown>;
+type PickByValue<
+	OBJ_T,
+	VALUE_T
+> = Pick<OBJ_T, { [K in keyof OBJ_T] : OBJ_T[K] extends VALUE_T ? K : never }[keyof OBJ_T]>;
+export type ObjectEntries<OBJ_T> = { [K in keyof OBJ_T] : [keyof PickByValue<OBJ_T, OBJ_T[K]>, OBJ_T[K]] }[keyof OBJ_T][];
+export {};
+
+//# sourceMappingURL=object.d.ts.map

package/types/types/object.d.ts.map

@@ -0,0 +1,14 @@
+{
+  "mappings": ";;AAIA,YAAY,QAAQ,kBACP,WAAW,KAAI,EAAE;AAG9B,YAAY,eACP,0BACD,wBAAwB;KAEvB,aAAa,sBAAsB,WAAW,SAAQ,aAAa,MAAM;KACzE,oBAAoB,YACtB,uBAAuBA,GAAG,mCAAmCC,SAAS,aACnE;KAGD,4BAA4B,cAAc,eAC7C,aAAa,sBAAsB,OAC/B,iBAAiB,WAAW,UACvB,QAAQ,MAAM,eAAc;KAIlC,yBAAyB,WAAW,aAAa,QAAO,KAAK;AAElE,YAAY,gBAAgB,cAAc,eAAe,yBACvD,oBAAoB,4BAA4B;AAGlD,YAAY,aAAa,OAAO;KAE3B;CAAY;CAAO;IACtB,KAAK,UAAU,WAAW,SAAQ,MAAM,WAAW,UAAU,kBAAkB;AAEjF,YAAY,cAAc,YACrB,WAAW,gBAAe,YAAY,OAAO,MAAM,KAAK,MAAM,YAAY",
+  "names": [
+    "k: UNION_T",
+    "k: infer I"
+  ],
+  "sources": [
+    "src/types/object.ts"
+  ],
+  "sourcesContent": [
+    "// note - TS doesn't support higher kinded types, so this doesn't work well\n\n// --- utils ---\n\nexport type Mutable<T> = {\n  -readonly [K in keyof T]: T[K] // the ‘-readonly’ mapped-type modifier\n}\n\nexport type EntriesType =\n  | [PropertyKey, unknown][]\n  | ReadonlyArray<readonly [PropertyKey, unknown]>\n\ntype DeepWritable<OBJ_T> = { -readonly [P in keyof OBJ_T]: DeepWritable<OBJ_T[P]> }\ntype UnionToIntersection<UNION_T> = // From https://stackoverflow.com/a/50375286\n  (UNION_T extends any ? (k: UNION_T) => void : never) extends (k: infer I) => void\n    ? I\n    : never\n\ntype UnionObjectFromArrayOfPairs<ARR_T extends EntriesType> =\n  DeepWritable<ARR_T> extends (infer R)[]\n    ? R extends [infer key, infer val]\n      ? { [prop in key & PropertyKey]: val }\n      : never\n    : never\n\ntype MergeIntersectingObjects<ObjT> = { [key in keyof ObjT]: ObjT[key] }\n\nexport type EntriesToObject<ARR_T extends EntriesType> = MergeIntersectingObjects<\n  UnionToIntersection<UnionObjectFromArrayOfPairs<ARR_T>>\n>\n\nexport type ObjectType = Record<PropertyKey, unknown>\n\ntype PickByValue<OBJ_T, VALUE_T> = // From https://stackoverflow.com/a/55153000\n  Pick<OBJ_T, { [K in keyof OBJ_T]: OBJ_T[K] extends VALUE_T ? K : never }[keyof OBJ_T]>\n\nexport type ObjectEntries<OBJ_T> = // From https://stackoverflow.com/a/60142095\n  { [K in keyof OBJ_T]: [keyof PickByValue<OBJ_T, OBJ_T[K]>, OBJ_T[K]] }[keyof OBJ_T][]\n"
+  ],
+  "version": 3
+}

package/types/types/react.d.ts

@@ -0,0 +1,3 @@
+export type RefProp<T> = React.RefObject<T> | React.RefCallback<T>;
+
+//# sourceMappingURL=react.d.ts.map

package/types/types/react.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,YAAY,QAAQ,KAAK,MAAM,UAAU,KAAK,MAAM,YAAY",
+  "names": [],
+  "sources": [
+    "src/types/react.ts"
+  ],
+  "sourcesContent": [
+    "export type RefProp<T> = React.RefObject<T> | React.RefCallback<T>\n"
+  ],
+  "version": 3
+}

package/types/types/timer.d.ts

@@ -0,0 +1,3 @@
+export type Timer = ReturnType<typeof setTimeout>;
+
+//# sourceMappingURL=timer.d.ts.map

package/types/types/timer.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,YAAY,QAAQ,kBAAkB",
+  "names": [],
+  "sources": [
+    "src/types/timer.ts"
+  ],
+  "sourcesContent": [
+    "export type Timer = ReturnType<typeof setTimeout>\n"
+  ],
+  "version": 3
+}

package/types/types/tuple.d.ts

@@ -0,0 +1,3 @@
+export type TupleToUnion<T extends any[]> = T[number];
+
+//# sourceMappingURL=tuple.d.ts.map

package/types/types/tuple.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,YAAY,aAAa,mBAAmB",
+  "names": [],
+  "sources": [
+    "src/types/tuple.ts"
+  ],
+  "sourcesContent": [
+    "export type TupleToUnion<T extends any[]> = T[number]\n"
+  ],
+  "version": 3
+}

package/types/url/urlSanitize.d.ts

@@ -0,0 +1,3 @@
+export declare function urlSanitize(url: string);
+
+//# sourceMappingURL=urlSanitize.d.ts.map

package/types/url/urlSanitize.d.ts.map

@@ -0,0 +1,13 @@
+{
+  "mappings": "AASA,OAAO,iBAAS,YAAYA",
+  "names": [
+    "url: string"
+  ],
+  "sources": [
+    "src/url/urlSanitize.ts"
+  ],
+  "sourcesContent": [
+    "/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\nconst protocols = new Set(['http:', 'https:', 'mailto:', 'tel:', 'sms:'])\n\nexport function urlSanitize(url: string) {\n  try {\n    const parsedUrl = new URL(url)\n    if (!protocols.has(parsedUrl.protocol)) {\n      return 'about:blank'\n    }\n  } catch {\n    return url\n  }\n  return url\n}\n"
+  ],
+  "version": 3
+}

package/types/url/urlValidate.d.ts

@@ -0,0 +1,3 @@
+export declare function urlValidate(url: string);
+
+//# sourceMappingURL=urlValidate.d.ts.map

package/types/url/urlValidate.d.ts.map

@@ -0,0 +1,13 @@
+{
+  "mappings": "AAMA,OAAO,iBAAS,YAAYA",
+  "names": [
+    "url: string"
+  ],
+  "sources": [
+    "src/url/urlValidate.ts"
+  ],
+  "sourcesContent": [
+    "// Source: https://stackoverflow.com/a/8234912/2013580\n\nconst urlRegExp = new RegExp(\n  /((([A-Za-z]{3,9}:(?:\\/\\/)?)(?:[-;:&=+$,\\w]+@)?[A-Za-z0-9.-]+|(?:www.|[-;:&=+$,\\w]+@)[A-Za-z0-9.-]+)((?:\\/[+~%/.\\w-_]*)?\\??(?:[-+=&;%@.\\w_]*)#?(?:[\\w]*))?)/\n)\n\nexport function urlValidate(url: string) {\n  // TODO Fix UI for link insertion; it should never default to an invalid URL such as https://.\n  // Maybe show a dialog where they user can type the URL before inserting it.\n  return url === 'https://' || urlRegExp.test(url)\n}\n"
+  ],
+  "version": 3
+}