yummies 7.19.4 → 7.20.0

package/sound.cjs

@@ -1,21 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/sound.ts
-/**
-* ---header-docs-section---
-* # yummies/sound
-*
-* ## Description
-*
-* One-shot HTMLAudio playback for short UI sounds (clicks, success chimes) with volume control.
-* The helper creates a temporary `Audio` element, awaits `play()`, then drops references so callers
-* do not leak nodes. Autoplay policies may still block sound until a user gesture on some browsers.
-*
-* ## Usage
-*
-* ```ts
-* import { playSound } from "yummies/sound";
-* ```
-*/
+//#region src/sound/play-sound.ts
 /**
 * Plays a sound from a file.
 */

package/sound.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sound.cjs","names":[],"sources":["../src/sound.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/sound\n *\n * ## Description\n *\n * One-shot HTMLAudio playback for short UI sounds (clicks, success chimes) with volume control.\n * The helper creates a temporary `Audio` element, awaits `play()`, then drops references so callers\n * do not leak nodes. Autoplay policies may still block sound until a user gesture on some browsers.\n *\n * ## Usage\n *\n * ```ts\n * import { playSound } from \"yummies/sound\";\n * ```\n */\n\n/**\n * Plays a sound from a file.\n */\nexport const playSound = async (\n  file: string,\n  { volume = 1 }: { volume?: number } = {},\n) => {\n  let audio = new Audio(file);\n  audio.volume = volume;\n  audio.muted = !volume;\n  await audio.play();\n  audio.remove();\n  // @ts-expect-error\n  audio = null;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,IAAa,YAAY,OACvB,MACA,EAAE,SAAS,MAA2B,EAAE,KACrC;CACH,IAAI,QAAQ,IAAI,MAAM,KAAK;AAC3B,OAAM,SAAS;AACf,OAAM,QAAQ,CAAC;AACf,OAAM,MAAM,MAAM;AAClB,OAAM,QAAQ;AAEd,SAAQ"}
+{"version":3,"file":"sound.cjs","names":[],"sources":["../src/sound/play-sound.ts"],"sourcesContent":["/**\n * Plays a sound from a file.\n */\nexport const playSound = async (\n  file: string,\n  { volume = 1 }: { volume?: number } = {},\n) => {\n  let audio = new Audio(file);\n  audio.volume = volume;\n  audio.muted = !volume;\n  await audio.play();\n  audio.remove();\n  // @ts-expect-error\n  audio = null;\n};\n"],"mappings":";;;;;AAGA,IAAa,YAAY,OACvB,MACA,EAAE,SAAS,MAA2B,CAAC,MACpC;CACH,IAAI,QAAQ,IAAI,MAAM,IAAI;CAC1B,MAAM,SAAS;CACf,MAAM,QAAQ,CAAC;CACf,MAAM,MAAM,KAAK;CACjB,MAAM,OAAO;CAEb,QAAQ;AACV"}

package/sound.d.ts

@@ -1,19 +1,3 @@
-/**
- * ---header-docs-section---
- * # yummies/sound
- *
- * ## Description
- *
- * One-shot HTMLAudio playback for short UI sounds (clicks, success chimes) with volume control.
- * The helper creates a temporary `Audio` element, awaits `play()`, then drops references so callers
- * do not leak nodes. Autoplay policies may still block sound until a user gesture on some browsers.
- *
- * ## Usage
- *
- * ```ts
- * import { playSound } from "yummies/sound";
- * ```
- */
 /**
  * Plays a sound from a file.
  */

package/sound.js

@@ -1,20 +1,4 @@
-//#region src/sound.ts
-/**
-* ---header-docs-section---
-* # yummies/sound
-*
-* ## Description
-*
-* One-shot HTMLAudio playback for short UI sounds (clicks, success chimes) with volume control.
-* The helper creates a temporary `Audio` element, awaits `play()`, then drops references so callers
-* do not leak nodes. Autoplay policies may still block sound until a user gesture on some browsers.
-*
-* ## Usage
-*
-* ```ts
-* import { playSound } from "yummies/sound";
-* ```
-*/
+//#region src/sound/play-sound.ts
 /**
 * Plays a sound from a file.
 */

package/sound.js.map

@@ -1 +1 @@
-{"version":3,"file":"sound.js","names":[],"sources":["../src/sound.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/sound\n *\n * ## Description\n *\n * One-shot HTMLAudio playback for short UI sounds (clicks, success chimes) with volume control.\n * The helper creates a temporary `Audio` element, awaits `play()`, then drops references so callers\n * do not leak nodes. Autoplay policies may still block sound until a user gesture on some browsers.\n *\n * ## Usage\n *\n * ```ts\n * import { playSound } from \"yummies/sound\";\n * ```\n */\n\n/**\n * Plays a sound from a file.\n */\nexport const playSound = async (\n  file: string,\n  { volume = 1 }: { volume?: number } = {},\n) => {\n  let audio = new Audio(file);\n  audio.volume = volume;\n  audio.muted = !volume;\n  await audio.play();\n  audio.remove();\n  // @ts-expect-error\n  audio = null;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,IAAa,YAAY,OACvB,MACA,EAAE,SAAS,MAA2B,EAAE,KACrC;CACH,IAAI,QAAQ,IAAI,MAAM,KAAK;AAC3B,OAAM,SAAS;AACf,OAAM,QAAQ,CAAC;AACf,OAAM,MAAM,MAAM;AAClB,OAAM,QAAQ;AAEd,SAAQ"}
+{"version":3,"file":"sound.js","names":[],"sources":["../src/sound/play-sound.ts"],"sourcesContent":["/**\n * Plays a sound from a file.\n */\nexport const playSound = async (\n  file: string,\n  { volume = 1 }: { volume?: number } = {},\n) => {\n  let audio = new Audio(file);\n  audio.volume = volume;\n  audio.muted = !volume;\n  await audio.play();\n  audio.remove();\n  // @ts-expect-error\n  audio = null;\n};\n"],"mappings":";;;;AAGA,IAAa,YAAY,OACvB,MACA,EAAE,SAAS,MAA2B,CAAC,MACpC;CACH,IAAI,QAAQ,IAAI,MAAM,IAAI;CAC1B,MAAM,SAAS;CACf,MAAM,QAAQ,CAAC;CACf,MAAM,MAAM,KAAK;CACjB,MAAM,OAAO;CAEb,QAAQ;AACV"}

package/storage.cjs

@@ -1,9 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/storage.ts
-var storages = {
-	session: sessionStorage,
-	local: localStorage
-};
+//#region src/storage/create-key.ts
 /**
 * Builds a storage key from a prefix, optional namespace and key.
 *
@@ -13,6 +9,12 @@ var storages = {
 * ```
 */
 var createKey = (prefix, key, namespace) => `${prefix}${namespace ? `/${namespace}` : ""}/${key}`;
+//#endregion
+//#region src/storage/create-storage.ts
+var storages = {
+	session: sessionStorage,
+	local: localStorage
+};
 var parseStorageValue = (value) => {
 	if (typeof value !== "string") return value;
 	try {

package/storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage.cjs","names":[],"sources":["../src/storage.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/storage\n *\n * ## Description\n *\n * Typed helpers around **`sessionStorage`** and **`localStorage`**: key namespacing, JSON parse\n * safety, and small wrappers that avoid repeating `try/catch` around `getItem`/`setItem`. Use it when\n * you need durable client state with predictable serialization, not a full offline database.\n *\n * ## Usage\n *\n * ```ts\n * import { createKey } from \"yummies/storage\";\n * ```\n */\n\nexport type StorageType = 'session' | 'local';\n\nconst storages: Record<StorageType, Storage> = {\n  session: sessionStorage,\n  local: localStorage,\n};\n\n/**\n * Builds a storage key from a prefix, optional namespace and key.\n *\n * @example\n * ```ts\n * createKey('app', 'token', 'auth'); // 'app/auth/token'\n * ```\n */\nexport const createKey = (prefix: string, key: string, namespace?: string) =>\n  `${prefix}${namespace ? `/${namespace}` : ''}/${key}`;\n\nconst parseStorageValue = <V>(value: unknown): V | null => {\n  if (typeof value !== 'string') {\n    return value as V;\n  }\n\n  try {\n    const parsed = JSON.parse(value);\n    return parsed;\n  } catch {\n    return null;\n  }\n};\n\nconst formatValueToStorage = (value: unknown): string => {\n  return JSON.stringify(value);\n};\n\nexport interface SetToStorageConfig<V>\n  extends Omit<GetFromStorageConfig<V>, 'fallback'> {\n  value: V;\n}\n\nexport interface UnsetFromStorageConfig\n  extends Omit<GetFromStorageConfig<any>, 'fallback'> {}\n\nexport interface GetFromStorageConfig<V> {\n  /**\n   * Storage key used to retrieve the value.\n   * The full key is extended with the project namespace.\n   */\n  key: string;\n  /**\n   * Storage type.\n   */\n  type: StorageType;\n  /**\n   * Default value used when there is no value in storage.\n   */\n  fallback?: V;\n  /**\n   * Optional namespace segment used in the generated key.\n   */\n  namespace?: string;\n  /**\n   * Optional key prefix.\n   */\n  prefix?: string;\n}\n\nexport type SetToStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  SetToStorageConfig<V>,\n  Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      SetToStorageConfig<V>,\n      Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof SetToStorageConfig<V>>>;\n\nexport type UnsetFromStorageWrappedConfig<\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  UnsetFromStorageConfig,\n  Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      UnsetFromStorageConfig,\n      Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof UnsetFromStorageConfig>>;\n\nexport type GetFromStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  GetFromStorageConfig<V>,\n  Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      GetFromStorageConfig<V>,\n      Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof GetFromStorageConfig<V>>>;\n\nexport type StorageConfigBase = Partial<\n  Pick<GetFromStorageConfig<any>, 'prefix' | 'type'>\n>;\n\nexport interface StorageApi<BaseConfig extends StorageConfigBase> {\n  set<Value>(config: SetToStorageWrappedConfig<Value, BaseConfig>): void;\n  unset(config: UnsetFromStorageWrappedConfig<BaseConfig>): void;\n  get<Value>(\n    config: GetFromStorageWrappedConfig<Value, BaseConfig>,\n  ): Value | null;\n}\n\n/**\n * Creates an interface for working with storage (`localStorage`, `sessionStorage`).\n */\nexport function createStorage<BaseConfig extends StorageConfigBase>(\n  storageConfig: BaseConfig,\n): StorageApi<BaseConfig> {\n  return {\n    set: <Value>(cfg: SetToStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      storage.setItem(\n        createKey(storagePrefix, config.key, config.namespace),\n        formatValueToStorage(config.value),\n      );\n    },\n    unset: <Value>(cfg: UnsetFromStorageWrappedConfig<BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n      const storage = storages[storageType];\n\n      storage.removeItem(\n        createKey(storagePrefix, config.key, config.namespace),\n      );\n    },\n    get: <Value>(cfg: GetFromStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as GetFromStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      return (\n        parseStorageValue<Value>(\n          storage.getItem(\n            createKey(storagePrefix, config.key, config.namespace),\n          ),\n        ) ??\n        config.fallback ??\n        null\n      );\n    },\n  } as const;\n}\n"],"mappings":";;AAmBA,IAAM,WAAyC;CAC7C,SAAS;CACT,OAAO;CACR;;;;;;;;;AAUD,IAAa,aAAa,QAAgB,KAAa,cACrD,GAAG,SAAS,YAAY,IAAI,cAAc,GAAG,GAAG;AAElD,IAAM,qBAAwB,UAA6B;AACzD,KAAI,OAAO,UAAU,SACnB,QAAO;AAGT,KAAI;AAEF,SADe,KAAK,MAAM,MAAM;SAE1B;AACN,SAAO;;;AAIX,IAAM,wBAAwB,UAA2B;AACvD,QAAO,KAAK,UAAU,MAAM;;;;;AA8F9B,SAAgB,cACd,eACwB;AACxB,QAAO;EACL,MAAa,QAAsD;GACjE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;AAEtC,YAAS,aAEjB,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,EACtD,qBAAqB,OAAO,MAAM,CACnC;;EAEH,QAAe,QAAmD;GAChE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;AACtC,YAAS,aAEjB,WACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,CACvD;;EAEH,MAAa,QAAwD;GACnE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAEtD,MAAM,UAAU,SAAS;AAEzB,UACE,kBACE,QAAQ,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,CACvD,CACF,IACD,OAAO,YACP;;EAGL"}
+{"version":3,"file":"storage.cjs","names":[],"sources":["../src/storage/create-key.ts","../src/storage/create-storage.ts"],"sourcesContent":["/**\n * Builds a storage key from a prefix, optional namespace and key.\n *\n * @example\n * ```ts\n * createKey('app', 'token', 'auth'); // 'app/auth/token'\n * ```\n */\nexport const createKey = (prefix: string, key: string, namespace?: string) =>\n  `${prefix}${namespace ? `/${namespace}` : ''}/${key}`;\n","import { createKey } from './create-key.js';\nimport type { StorageType } from './storage-type.js';\n\nconst storages: Record<StorageType, Storage> = {\n  session: sessionStorage,\n  local: localStorage,\n};\n\nconst parseStorageValue = <V>(value: unknown): V | null => {\n  if (typeof value !== 'string') {\n    return value as V;\n  }\n\n  try {\n    const parsed = JSON.parse(value);\n    return parsed;\n  } catch {\n    return null;\n  }\n};\n\nconst formatValueToStorage = (value: unknown): string => {\n  return JSON.stringify(value);\n};\n\nexport interface SetToStorageConfig<V>\n  extends Omit<GetFromStorageConfig<V>, 'fallback'> {\n  value: V;\n}\n\nexport interface UnsetFromStorageConfig\n  extends Omit<GetFromStorageConfig<any>, 'fallback'> {}\n\nexport interface GetFromStorageConfig<V> {\n  /**\n   * Storage key used to retrieve the value.\n   * The full key is extended with the project namespace.\n   */\n  key: string;\n  /**\n   * Storage type.\n   */\n  type: StorageType;\n  /**\n   * Default value used when there is no value in storage.\n   */\n  fallback?: V;\n  /**\n   * Optional namespace segment used in the generated key.\n   */\n  namespace?: string;\n  /**\n   * Optional key prefix.\n   */\n  prefix?: string;\n}\n\nexport type SetToStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  SetToStorageConfig<V>,\n  Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      SetToStorageConfig<V>,\n      Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof SetToStorageConfig<V>>>;\n\nexport type UnsetFromStorageWrappedConfig<\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  UnsetFromStorageConfig,\n  Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      UnsetFromStorageConfig,\n      Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof UnsetFromStorageConfig>>;\n\nexport type GetFromStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  GetFromStorageConfig<V>,\n  Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      GetFromStorageConfig<V>,\n      Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof GetFromStorageConfig<V>>>;\n\nexport type StorageConfigBase = Partial<\n  Pick<GetFromStorageConfig<any>, 'prefix' | 'type'>\n>;\n\nexport interface StorageApi<BaseConfig extends StorageConfigBase> {\n  set<Value>(config: SetToStorageWrappedConfig<Value, BaseConfig>): void;\n  unset(config: UnsetFromStorageWrappedConfig<BaseConfig>): void;\n  get<Value>(\n    config: GetFromStorageWrappedConfig<Value, BaseConfig>,\n  ): Value | null;\n}\n\n/**\n * Creates an interface for working with storage (`localStorage`, `sessionStorage`).\n */\nexport function createStorage<BaseConfig extends StorageConfigBase>(\n  storageConfig: BaseConfig,\n): StorageApi<BaseConfig> {\n  return {\n    set: <Value>(cfg: SetToStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      storage.setItem(\n        createKey(storagePrefix, config.key, config.namespace),\n        formatValueToStorage(config.value),\n      );\n    },\n    unset: <Value>(cfg: UnsetFromStorageWrappedConfig<BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n      const storage = storages[storageType];\n\n      storage.removeItem(\n        createKey(storagePrefix, config.key, config.namespace),\n      );\n    },\n    get: <Value>(cfg: GetFromStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as GetFromStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      return (\n        parseStorageValue<Value>(\n          storage.getItem(\n            createKey(storagePrefix, config.key, config.namespace),\n          ),\n        ) ??\n        config.fallback ??\n        null\n      );\n    },\n  } as const;\n}\n"],"mappings":";;;;;;;;;;AAQA,IAAa,aAAa,QAAgB,KAAa,cACrD,GAAG,SAAS,YAAY,IAAI,cAAc,GAAG,GAAG;;;ACNlD,IAAM,WAAyC;CAC7C,SAAS;CACT,OAAO;AACT;AAEA,IAAM,qBAAwB,UAA6B;CACzD,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,IAAI;EAEF,OADe,KAAK,MAAM,KACnB;CACT,QAAQ;EACN,OAAO;CACT;AACF;AAEA,IAAM,wBAAwB,UAA2B;CACvD,OAAO,KAAK,UAAU,KAAK;AAC7B;;;;AA6FA,SAAgB,cACd,eACwB;CACxB,OAAO;EACL,MAAa,QAAsD;GACjE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAItD,SAFyB,aAEjB,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS,GACrD,qBAAqB,OAAO,KAAK,CACnC;EACF;EACA,QAAe,QAAmD;GAChE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAGtD,SAFyB,aAEjB,WACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS,CACvD;EACF;EACA,MAAa,QAAwD;GACnE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAEtD,MAAM,UAAU,SAAS;GAEzB,OACE,kBACE,QAAQ,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS,CACvD,CACF,KACA,OAAO,YACP;EAEJ;CACF;AACF"}

package/storage.d.ts

@@ -1,20 +1,3 @@
-/**
- * ---header-docs-section---
- * # yummies/storage
- *
- * ## Description
- *
- * Typed helpers around **`sessionStorage`** and **`localStorage`**: key namespacing, JSON parse
- * safety, and small wrappers that avoid repeating `try/catch` around `getItem`/`setItem`. Use it when
- * you need durable client state with predictable serialization, not a full offline database.
- *
- * ## Usage
- *
- * ```ts
- * import { createKey } from "yummies/storage";
- * ```
- */
-type StorageType = 'session' | 'local';
 /**
  * Builds a storage key from a prefix, optional namespace and key.
  *
@@ -24,6 +7,9 @@ type StorageType = 'session' | 'local';
  * ```
  */
 declare const createKey: (prefix: string, key: string, namespace?: string) => string;
+
+type StorageType = 'session' | 'local';
+
 interface SetToStorageConfig<V> extends Omit<GetFromStorageConfig<V>, 'fallback'> {
     value: V;
 }

package/storage.js

@@ -1,8 +1,4 @@
-//#region src/storage.ts
-var storages = {
-	session: sessionStorage,
-	local: localStorage
-};
+//#region src/storage/create-key.ts
 /**
 * Builds a storage key from a prefix, optional namespace and key.
 *
@@ -12,6 +8,12 @@ var storages = {
 * ```
 */
 var createKey = (prefix, key, namespace) => `${prefix}${namespace ? `/${namespace}` : ""}/${key}`;
+//#endregion
+//#region src/storage/create-storage.ts
+var storages = {
+	session: sessionStorage,
+	local: localStorage
+};
 var parseStorageValue = (value) => {
 	if (typeof value !== "string") return value;
 	try {

package/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","names":[],"sources":["../src/storage.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/storage\n *\n * ## Description\n *\n * Typed helpers around **`sessionStorage`** and **`localStorage`**: key namespacing, JSON parse\n * safety, and small wrappers that avoid repeating `try/catch` around `getItem`/`setItem`. Use it when\n * you need durable client state with predictable serialization, not a full offline database.\n *\n * ## Usage\n *\n * ```ts\n * import { createKey } from \"yummies/storage\";\n * ```\n */\n\nexport type StorageType = 'session' | 'local';\n\nconst storages: Record<StorageType, Storage> = {\n  session: sessionStorage,\n  local: localStorage,\n};\n\n/**\n * Builds a storage key from a prefix, optional namespace and key.\n *\n * @example\n * ```ts\n * createKey('app', 'token', 'auth'); // 'app/auth/token'\n * ```\n */\nexport const createKey = (prefix: string, key: string, namespace?: string) =>\n  `${prefix}${namespace ? `/${namespace}` : ''}/${key}`;\n\nconst parseStorageValue = <V>(value: unknown): V | null => {\n  if (typeof value !== 'string') {\n    return value as V;\n  }\n\n  try {\n    const parsed = JSON.parse(value);\n    return parsed;\n  } catch {\n    return null;\n  }\n};\n\nconst formatValueToStorage = (value: unknown): string => {\n  return JSON.stringify(value);\n};\n\nexport interface SetToStorageConfig<V>\n  extends Omit<GetFromStorageConfig<V>, 'fallback'> {\n  value: V;\n}\n\nexport interface UnsetFromStorageConfig\n  extends Omit<GetFromStorageConfig<any>, 'fallback'> {}\n\nexport interface GetFromStorageConfig<V> {\n  /**\n   * Storage key used to retrieve the value.\n   * The full key is extended with the project namespace.\n   */\n  key: string;\n  /**\n   * Storage type.\n   */\n  type: StorageType;\n  /**\n   * Default value used when there is no value in storage.\n   */\n  fallback?: V;\n  /**\n   * Optional namespace segment used in the generated key.\n   */\n  namespace?: string;\n  /**\n   * Optional key prefix.\n   */\n  prefix?: string;\n}\n\nexport type SetToStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  SetToStorageConfig<V>,\n  Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      SetToStorageConfig<V>,\n      Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof SetToStorageConfig<V>>>;\n\nexport type UnsetFromStorageWrappedConfig<\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  UnsetFromStorageConfig,\n  Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      UnsetFromStorageConfig,\n      Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof UnsetFromStorageConfig>>;\n\nexport type GetFromStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  GetFromStorageConfig<V>,\n  Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      GetFromStorageConfig<V>,\n      Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof GetFromStorageConfig<V>>>;\n\nexport type StorageConfigBase = Partial<\n  Pick<GetFromStorageConfig<any>, 'prefix' | 'type'>\n>;\n\nexport interface StorageApi<BaseConfig extends StorageConfigBase> {\n  set<Value>(config: SetToStorageWrappedConfig<Value, BaseConfig>): void;\n  unset(config: UnsetFromStorageWrappedConfig<BaseConfig>): void;\n  get<Value>(\n    config: GetFromStorageWrappedConfig<Value, BaseConfig>,\n  ): Value | null;\n}\n\n/**\n * Creates an interface for working with storage (`localStorage`, `sessionStorage`).\n */\nexport function createStorage<BaseConfig extends StorageConfigBase>(\n  storageConfig: BaseConfig,\n): StorageApi<BaseConfig> {\n  return {\n    set: <Value>(cfg: SetToStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      storage.setItem(\n        createKey(storagePrefix, config.key, config.namespace),\n        formatValueToStorage(config.value),\n      );\n    },\n    unset: <Value>(cfg: UnsetFromStorageWrappedConfig<BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n      const storage = storages[storageType];\n\n      storage.removeItem(\n        createKey(storagePrefix, config.key, config.namespace),\n      );\n    },\n    get: <Value>(cfg: GetFromStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as GetFromStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      return (\n        parseStorageValue<Value>(\n          storage.getItem(\n            createKey(storagePrefix, config.key, config.namespace),\n          ),\n        ) ??\n        config.fallback ??\n        null\n      );\n    },\n  } as const;\n}\n"],"mappings":";AAmBA,IAAM,WAAyC;CAC7C,SAAS;CACT,OAAO;CACR;;;;;;;;;AAUD,IAAa,aAAa,QAAgB,KAAa,cACrD,GAAG,SAAS,YAAY,IAAI,cAAc,GAAG,GAAG;AAElD,IAAM,qBAAwB,UAA6B;AACzD,KAAI,OAAO,UAAU,SACnB,QAAO;AAGT,KAAI;AAEF,SADe,KAAK,MAAM,MAAM;SAE1B;AACN,SAAO;;;AAIX,IAAM,wBAAwB,UAA2B;AACvD,QAAO,KAAK,UAAU,MAAM;;;;;AA8F9B,SAAgB,cACd,eACwB;AACxB,QAAO;EACL,MAAa,QAAsD;GACjE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;AAEtC,YAAS,aAEjB,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,EACtD,qBAAqB,OAAO,MAAM,CACnC;;EAEH,QAAe,QAAmD;GAChE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;AACtC,YAAS,aAEjB,WACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,CACvD;;EAEH,MAAa,QAAwD;GACnE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAEtD,MAAM,UAAU,SAAS;AAEzB,UACE,kBACE,QAAQ,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,UAAU,CACvD,CACF,IACD,OAAO,YACP;;EAGL"}
+{"version":3,"file":"storage.js","names":[],"sources":["../src/storage/create-key.ts","../src/storage/create-storage.ts"],"sourcesContent":["/**\n * Builds a storage key from a prefix, optional namespace and key.\n *\n * @example\n * ```ts\n * createKey('app', 'token', 'auth'); // 'app/auth/token'\n * ```\n */\nexport const createKey = (prefix: string, key: string, namespace?: string) =>\n  `${prefix}${namespace ? `/${namespace}` : ''}/${key}`;\n","import { createKey } from './create-key.js';\nimport type { StorageType } from './storage-type.js';\n\nconst storages: Record<StorageType, Storage> = {\n  session: sessionStorage,\n  local: localStorage,\n};\n\nconst parseStorageValue = <V>(value: unknown): V | null => {\n  if (typeof value !== 'string') {\n    return value as V;\n  }\n\n  try {\n    const parsed = JSON.parse(value);\n    return parsed;\n  } catch {\n    return null;\n  }\n};\n\nconst formatValueToStorage = (value: unknown): string => {\n  return JSON.stringify(value);\n};\n\nexport interface SetToStorageConfig<V>\n  extends Omit<GetFromStorageConfig<V>, 'fallback'> {\n  value: V;\n}\n\nexport interface UnsetFromStorageConfig\n  extends Omit<GetFromStorageConfig<any>, 'fallback'> {}\n\nexport interface GetFromStorageConfig<V> {\n  /**\n   * Storage key used to retrieve the value.\n   * The full key is extended with the project namespace.\n   */\n  key: string;\n  /**\n   * Storage type.\n   */\n  type: StorageType;\n  /**\n   * Default value used when there is no value in storage.\n   */\n  fallback?: V;\n  /**\n   * Optional namespace segment used in the generated key.\n   */\n  namespace?: string;\n  /**\n   * Optional key prefix.\n   */\n  prefix?: string;\n}\n\nexport type SetToStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  SetToStorageConfig<V>,\n  Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      SetToStorageConfig<V>,\n      Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof SetToStorageConfig<V>>>;\n\nexport type UnsetFromStorageWrappedConfig<\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  UnsetFromStorageConfig,\n  Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      UnsetFromStorageConfig,\n      Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof UnsetFromStorageConfig>>;\n\nexport type GetFromStorageWrappedConfig<\n  V,\n  BaseConfig extends StorageConfigBase,\n> = Omit<\n  GetFromStorageConfig<V>,\n  Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n> &\n  Partial<\n    Pick<\n      GetFromStorageConfig<V>,\n      Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>\n    >\n  > &\n  Pick<BaseConfig, Exclude<keyof BaseConfig, keyof GetFromStorageConfig<V>>>;\n\nexport type StorageConfigBase = Partial<\n  Pick<GetFromStorageConfig<any>, 'prefix' | 'type'>\n>;\n\nexport interface StorageApi<BaseConfig extends StorageConfigBase> {\n  set<Value>(config: SetToStorageWrappedConfig<Value, BaseConfig>): void;\n  unset(config: UnsetFromStorageWrappedConfig<BaseConfig>): void;\n  get<Value>(\n    config: GetFromStorageWrappedConfig<Value, BaseConfig>,\n  ): Value | null;\n}\n\n/**\n * Creates an interface for working with storage (`localStorage`, `sessionStorage`).\n */\nexport function createStorage<BaseConfig extends StorageConfigBase>(\n  storageConfig: BaseConfig,\n): StorageApi<BaseConfig> {\n  return {\n    set: <Value>(cfg: SetToStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      storage.setItem(\n        createKey(storagePrefix, config.key, config.namespace),\n        formatValueToStorage(config.value),\n      );\n    },\n    unset: <Value>(cfg: UnsetFromStorageWrappedConfig<BaseConfig>) => {\n      const config = cfg as unknown as SetToStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n      const storage = storages[storageType];\n\n      storage.removeItem(\n        createKey(storagePrefix, config.key, config.namespace),\n      );\n    },\n    get: <Value>(cfg: GetFromStorageWrappedConfig<Value, BaseConfig>) => {\n      const config = cfg as unknown as GetFromStorageConfig<Value>;\n      const storageType = (config.type ?? storageConfig.type!) as StorageType;\n      const storagePrefix = (config.prefix ?? storageConfig.prefix!) as string;\n\n      const storage = storages[storageType];\n\n      return (\n        parseStorageValue<Value>(\n          storage.getItem(\n            createKey(storagePrefix, config.key, config.namespace),\n          ),\n        ) ??\n        config.fallback ??\n        null\n      );\n    },\n  } as const;\n}\n"],"mappings":";;;;;;;;;AAQA,IAAa,aAAa,QAAgB,KAAa,cACrD,GAAG,SAAS,YAAY,IAAI,cAAc,GAAG,GAAG;;;ACNlD,IAAM,WAAyC;CAC7C,SAAS;CACT,OAAO;AACT;AAEA,IAAM,qBAAwB,UAA6B;CACzD,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,IAAI;EAEF,OADe,KAAK,MAAM,KACnB;CACT,QAAQ;EACN,OAAO;CACT;AACF;AAEA,IAAM,wBAAwB,UAA2B;CACvD,OAAO,KAAK,UAAU,KAAK;AAC7B;;;;AA6FA,SAAgB,cACd,eACwB;CACxB,OAAO;EACL,MAAa,QAAsD;GACjE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAItD,SAFyB,aAEjB,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS,GACrD,qBAAqB,OAAO,KAAK,CACnC;EACF;EACA,QAAe,QAAmD;GAChE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAGtD,SAFyB,aAEjB,WACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS,CACvD;EACF;EACA,MAAa,QAAwD;GACnE,MAAM,SAAS;GACf,MAAM,cAAe,OAAO,QAAQ,cAAc;GAClD,MAAM,gBAAiB,OAAO,UAAU,cAAc;GAEtD,MAAM,UAAU,SAAS;GAEzB,OACE,kBACE,QAAQ,QACN,UAAU,eAAe,OAAO,KAAK,OAAO,SAAS,CACvD,CACF,KACA,OAAO,YACP;EAEJ;CACF;AACF"}

package/text.cjs

@@ -1,21 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/text.ts
-/**
-* ---header-docs-section---
-* # yummies/text
-*
-* ## Description
-*
-* Russian-centric text helpers: **declension** by count (одно слово / два слова / пять слов) and
-* utilities for splitting long strings into wrapped lines. Pair with `yummies/date-time` for
-* natural language timestamps and labels in Slavic locales.
-*
-* ## Usage
-*
-* ```ts
-* import { declension } from "yummies/text";
-* ```
-*/
+//#region src/text/declension.ts
 /**
 * Returns the correct word form based on the provided count.
 * @example
@@ -33,6 +17,8 @@ var declension = (count, txt, cases = [
 	1,
 	2
 ]) => txt[count % 100 > 4 && count % 100 < 20 ? 2 : cases[Math.min(count % 10, 5)]];
+//#endregion
+//#region src/text/split-text-by-lines.ts
 /**
 * Splits text into lines with a maximum line length.
 */

package/text.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"text.cjs","names":[],"sources":["../src/text.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/text\n *\n * ## Description\n *\n * Russian-centric text helpers: **declension** by count (одно слово / два слова / пять слов) and\n * utilities for splitting long strings into wrapped lines. Pair with `yummies/date-time` for\n * natural language timestamps and labels in Slavic locales.\n *\n * ## Usage\n *\n * ```ts\n * import { declension } from \"yummies/text\";\n * ```\n */\n\n/**\n * Returns the correct word form based on the provided count.\n * @example\n * declension(1, ['slovo', 'slova', 'slov']) // 'slovo'\n * @example\n * declension(2, ['slovo', 'slova', 'slov']) // 'slova'\n * @example\n * declension(5, ['slovo', 'slova', 'slov']) // 'slov'\n */\nexport const declension = (\n  count: number,\n  txt: readonly [one: string, two: string, five: string],\n  cases = [2, 0, 1, 1, 1, 2],\n) =>\n  txt[count % 100 > 4 && count % 100 < 20 ? 2 : cases[Math.min(count % 10, 5)]];\n\n/**\n * Splits text into lines with a maximum line length.\n */\nexport const splitTextByLines = (\n  text: string,\n  lineLingth: number = 60,\n): string[] => {\n  const words = text.split(/\\s+/).filter((word) => word !== '');\n  const lines = [];\n  let currentLine = '';\n\n  for (const word of words) {\n    if (word.length > lineLingth) {\n      if (currentLine !== '') {\n        lines.push(currentLine);\n        currentLine = '';\n      }\n\n      let start = 0;\n      while (start < word.length) {\n        const chunk = word.slice(start, start + lineLingth);\n        lines.push(chunk);\n        start += lineLingth;\n      }\n      continue;\n    }\n\n    // Проверка возможности добавления слова в текущую строку\n    if (currentLine === '') {\n      currentLine = word;\n    } else if (currentLine.length + 1 + word.length <= lineLingth) {\n      currentLine += ` ${word}`;\n    } else {\n      lines.push(currentLine);\n      currentLine = word;\n    }\n  }\n\n  if (currentLine !== '' || lines.length === 0) {\n    lines.push(currentLine);\n  }\n\n  return lines;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAa,cACX,OACA,KACA,QAAQ;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE,KAE1B,IAAI,QAAQ,MAAM,KAAK,QAAQ,MAAM,KAAK,IAAI,MAAM,KAAK,IAAI,QAAQ,IAAI,EAAE;;;;AAK7E,IAAa,oBACX,MACA,aAAqB,OACR;CACb,MAAM,QAAQ,KAAK,MAAM,MAAM,CAAC,QAAQ,SAAS,SAAS,GAAG;CAC7D,MAAM,QAAQ,EAAE;CAChB,IAAI,cAAc;AAElB,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,KAAK,SAAS,YAAY;AAC5B,OAAI,gBAAgB,IAAI;AACtB,UAAM,KAAK,YAAY;AACvB,kBAAc;;GAGhB,IAAI,QAAQ;AACZ,UAAO,QAAQ,KAAK,QAAQ;IAC1B,MAAM,QAAQ,KAAK,MAAM,OAAO,QAAQ,WAAW;AACnD,UAAM,KAAK,MAAM;AACjB,aAAS;;AAEX;;AAIF,MAAI,gBAAgB,GAClB,eAAc;WACL,YAAY,SAAS,IAAI,KAAK,UAAU,WACjD,gBAAe,IAAI;OACd;AACL,SAAM,KAAK,YAAY;AACvB,iBAAc;;;AAIlB,KAAI,gBAAgB,MAAM,MAAM,WAAW,EACzC,OAAM,KAAK,YAAY;AAGzB,QAAO"}
+{"version":3,"file":"text.cjs","names":[],"sources":["../src/text/declension.ts","../src/text/split-text-by-lines.ts"],"sourcesContent":["/**\n * Returns the correct word form based on the provided count.\n * @example\n * declension(1, ['slovo', 'slova', 'slov']) // 'slovo'\n * @example\n * declension(2, ['slovo', 'slova', 'slov']) // 'slova'\n * @example\n * declension(5, ['slovo', 'slova', 'slov']) // 'slov'\n */\nexport const declension = (\n  count: number,\n  txt: readonly [one: string, two: string, five: string],\n  cases = [2, 0, 1, 1, 1, 2],\n) =>\n  txt[count % 100 > 4 && count % 100 < 20 ? 2 : cases[Math.min(count % 10, 5)]];\n","/**\n * Splits text into lines with a maximum line length.\n */\nexport const splitTextByLines = (\n  text: string,\n  lineLingth: number = 60,\n): string[] => {\n  const words = text.split(/\\s+/).filter((word) => word !== '');\n  const lines = [];\n  let currentLine = '';\n\n  for (const word of words) {\n    if (word.length > lineLingth) {\n      if (currentLine !== '') {\n        lines.push(currentLine);\n        currentLine = '';\n      }\n\n      let start = 0;\n      while (start < word.length) {\n        const chunk = word.slice(start, start + lineLingth);\n        lines.push(chunk);\n        start += lineLingth;\n      }\n      continue;\n    }\n\n    // Проверка возможности добавления слова в текущую строку\n    if (currentLine === '') {\n      currentLine = word;\n    } else if (currentLine.length + 1 + word.length <= lineLingth) {\n      currentLine += ` ${word}`;\n    } else {\n      lines.push(currentLine);\n      currentLine = word;\n    }\n  }\n\n  if (currentLine !== '' || lines.length === 0) {\n    lines.push(currentLine);\n  }\n\n  return lines;\n};\n"],"mappings":";;;;;;;;;;;AASA,IAAa,cACX,OACA,KACA,QAAQ;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC,MAEzB,IAAI,QAAQ,MAAM,KAAK,QAAQ,MAAM,KAAK,IAAI,MAAM,KAAK,IAAI,QAAQ,IAAI,CAAC;;;;;;ACX5E,IAAa,oBACX,MACA,aAAqB,OACR;CACb,MAAM,QAAQ,KAAK,MAAM,KAAK,EAAE,QAAQ,SAAS,SAAS,EAAE;CAC5D,MAAM,QAAQ,CAAC;CACf,IAAI,cAAc;CAElB,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,SAAS,YAAY;GAC5B,IAAI,gBAAgB,IAAI;IACtB,MAAM,KAAK,WAAW;IACtB,cAAc;GAChB;GAEA,IAAI,QAAQ;GACZ,OAAO,QAAQ,KAAK,QAAQ;IAC1B,MAAM,QAAQ,KAAK,MAAM,OAAO,QAAQ,UAAU;IAClD,MAAM,KAAK,KAAK;IAChB,SAAS;GACX;GACA;EACF;EAGA,IAAI,gBAAgB,IAClB,cAAc;OACT,IAAI,YAAY,SAAS,IAAI,KAAK,UAAU,YACjD,eAAe,IAAI;OACd;GACL,MAAM,KAAK,WAAW;GACtB,cAAc;EAChB;CACF;CAEA,IAAI,gBAAgB,MAAM,MAAM,WAAW,GACzC,MAAM,KAAK,WAAW;CAGxB,OAAO;AACT"}

package/text.d.ts

@@ -1,19 +1,3 @@
-/**
- * ---header-docs-section---
- * # yummies/text
- *
- * ## Description
- *
- * Russian-centric text helpers: **declension** by count (одно слово / два слова / пять слов) and
- * utilities for splitting long strings into wrapped lines. Pair with `yummies/date-time` for
- * natural language timestamps and labels in Slavic locales.
- *
- * ## Usage
- *
- * ```ts
- * import { declension } from "yummies/text";
- * ```
- */
 /**
  * Returns the correct word form based on the provided count.
  * @example
@@ -24,6 +8,7 @@
  * declension(5, ['slovo', 'slova', 'slov']) // 'slov'
  */
 declare const declension: (count: number, txt: readonly [one: string, two: string, five: string], cases?: number[]) => string;
+
 /**
  * Splits text into lines with a maximum line length.
  */

package/text.js

@@ -1,20 +1,4 @@
-//#region src/text.ts
-/**
-* ---header-docs-section---
-* # yummies/text
-*
-* ## Description
-*
-* Russian-centric text helpers: **declension** by count (одно слово / два слова / пять слов) and
-* utilities for splitting long strings into wrapped lines. Pair with `yummies/date-time` for
-* natural language timestamps and labels in Slavic locales.
-*
-* ## Usage
-*
-* ```ts
-* import { declension } from "yummies/text";
-* ```
-*/
+//#region src/text/declension.ts
 /**
 * Returns the correct word form based on the provided count.
 * @example
@@ -32,6 +16,8 @@ var declension = (count, txt, cases = [
 	1,
 	2
 ]) => txt[count % 100 > 4 && count % 100 < 20 ? 2 : cases[Math.min(count % 10, 5)]];
+//#endregion
+//#region src/text/split-text-by-lines.ts
 /**
 * Splits text into lines with a maximum line length.
 */

package/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","names":[],"sources":["../src/text.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/text\n *\n * ## Description\n *\n * Russian-centric text helpers: **declension** by count (одно слово / два слова / пять слов) and\n * utilities for splitting long strings into wrapped lines. Pair with `yummies/date-time` for\n * natural language timestamps and labels in Slavic locales.\n *\n * ## Usage\n *\n * ```ts\n * import { declension } from \"yummies/text\";\n * ```\n */\n\n/**\n * Returns the correct word form based on the provided count.\n * @example\n * declension(1, ['slovo', 'slova', 'slov']) // 'slovo'\n * @example\n * declension(2, ['slovo', 'slova', 'slov']) // 'slova'\n * @example\n * declension(5, ['slovo', 'slova', 'slov']) // 'slov'\n */\nexport const declension = (\n  count: number,\n  txt: readonly [one: string, two: string, five: string],\n  cases = [2, 0, 1, 1, 1, 2],\n) =>\n  txt[count % 100 > 4 && count % 100 < 20 ? 2 : cases[Math.min(count % 10, 5)]];\n\n/**\n * Splits text into lines with a maximum line length.\n */\nexport const splitTextByLines = (\n  text: string,\n  lineLingth: number = 60,\n): string[] => {\n  const words = text.split(/\\s+/).filter((word) => word !== '');\n  const lines = [];\n  let currentLine = '';\n\n  for (const word of words) {\n    if (word.length > lineLingth) {\n      if (currentLine !== '') {\n        lines.push(currentLine);\n        currentLine = '';\n      }\n\n      let start = 0;\n      while (start < word.length) {\n        const chunk = word.slice(start, start + lineLingth);\n        lines.push(chunk);\n        start += lineLingth;\n      }\n      continue;\n    }\n\n    // Проверка возможности добавления слова в текущую строку\n    if (currentLine === '') {\n      currentLine = word;\n    } else if (currentLine.length + 1 + word.length <= lineLingth) {\n      currentLine += ` ${word}`;\n    } else {\n      lines.push(currentLine);\n      currentLine = word;\n    }\n  }\n\n  if (currentLine !== '' || lines.length === 0) {\n    lines.push(currentLine);\n  }\n\n  return lines;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAa,cACX,OACA,KACA,QAAQ;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE,KAE1B,IAAI,QAAQ,MAAM,KAAK,QAAQ,MAAM,KAAK,IAAI,MAAM,KAAK,IAAI,QAAQ,IAAI,EAAE;;;;AAK7E,IAAa,oBACX,MACA,aAAqB,OACR;CACb,MAAM,QAAQ,KAAK,MAAM,MAAM,CAAC,QAAQ,SAAS,SAAS,GAAG;CAC7D,MAAM,QAAQ,EAAE;CAChB,IAAI,cAAc;AAElB,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,KAAK,SAAS,YAAY;AAC5B,OAAI,gBAAgB,IAAI;AACtB,UAAM,KAAK,YAAY;AACvB,kBAAc;;GAGhB,IAAI,QAAQ;AACZ,UAAO,QAAQ,KAAK,QAAQ;IAC1B,MAAM,QAAQ,KAAK,MAAM,OAAO,QAAQ,WAAW;AACnD,UAAM,KAAK,MAAM;AACjB,aAAS;;AAEX;;AAIF,MAAI,gBAAgB,GAClB,eAAc;WACL,YAAY,SAAS,IAAI,KAAK,UAAU,WACjD,gBAAe,IAAI;OACd;AACL,SAAM,KAAK,YAAY;AACvB,iBAAc;;;AAIlB,KAAI,gBAAgB,MAAM,MAAM,WAAW,EACzC,OAAM,KAAK,YAAY;AAGzB,QAAO"}
+{"version":3,"file":"text.js","names":[],"sources":["../src/text/declension.ts","../src/text/split-text-by-lines.ts"],"sourcesContent":["/**\n * Returns the correct word form based on the provided count.\n * @example\n * declension(1, ['slovo', 'slova', 'slov']) // 'slovo'\n * @example\n * declension(2, ['slovo', 'slova', 'slov']) // 'slova'\n * @example\n * declension(5, ['slovo', 'slova', 'slov']) // 'slov'\n */\nexport const declension = (\n  count: number,\n  txt: readonly [one: string, two: string, five: string],\n  cases = [2, 0, 1, 1, 1, 2],\n) =>\n  txt[count % 100 > 4 && count % 100 < 20 ? 2 : cases[Math.min(count % 10, 5)]];\n","/**\n * Splits text into lines with a maximum line length.\n */\nexport const splitTextByLines = (\n  text: string,\n  lineLingth: number = 60,\n): string[] => {\n  const words = text.split(/\\s+/).filter((word) => word !== '');\n  const lines = [];\n  let currentLine = '';\n\n  for (const word of words) {\n    if (word.length > lineLingth) {\n      if (currentLine !== '') {\n        lines.push(currentLine);\n        currentLine = '';\n      }\n\n      let start = 0;\n      while (start < word.length) {\n        const chunk = word.slice(start, start + lineLingth);\n        lines.push(chunk);\n        start += lineLingth;\n      }\n      continue;\n    }\n\n    // Проверка возможности добавления слова в текущую строку\n    if (currentLine === '') {\n      currentLine = word;\n    } else if (currentLine.length + 1 + word.length <= lineLingth) {\n      currentLine += ` ${word}`;\n    } else {\n      lines.push(currentLine);\n      currentLine = word;\n    }\n  }\n\n  if (currentLine !== '' || lines.length === 0) {\n    lines.push(currentLine);\n  }\n\n  return lines;\n};\n"],"mappings":";;;;;;;;;;AASA,IAAa,cACX,OACA,KACA,QAAQ;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC,MAEzB,IAAI,QAAQ,MAAM,KAAK,QAAQ,MAAM,KAAK,IAAI,MAAM,KAAK,IAAI,QAAQ,IAAI,CAAC;;;;;;ACX5E,IAAa,oBACX,MACA,aAAqB,OACR;CACb,MAAM,QAAQ,KAAK,MAAM,KAAK,EAAE,QAAQ,SAAS,SAAS,EAAE;CAC5D,MAAM,QAAQ,CAAC;CACf,IAAI,cAAc;CAElB,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,SAAS,YAAY;GAC5B,IAAI,gBAAgB,IAAI;IACtB,MAAM,KAAK,WAAW;IACtB,cAAc;GAChB;GAEA,IAAI,QAAQ;GACZ,OAAO,QAAQ,KAAK,QAAQ;IAC1B,MAAM,QAAQ,KAAK,MAAM,OAAO,QAAQ,UAAU;IAClD,MAAM,KAAK,KAAK;IAChB,SAAS;GACX;GACA;EACF;EAGA,IAAI,gBAAgB,IAClB,cAAc;OACT,IAAI,YAAY,SAAS,IAAI,KAAK,UAAU,YACjD,eAAe,IAAI;OACd;GACL,MAAM,KAAK,WAAW;GACtB,cAAc;EAChB;CACF;CAEA,IAAI,gBAAgB,MAAM,MAAM,WAAW,GACzC,MAAM,KAAK,WAAW;CAGxB,OAAO;AACT"}

package/type-guard.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/type-guard/_exports.ts
-var _exports_exports = /* @__PURE__ */ require("./chunk-CZWwpsFl.cjs").__exportAll({
+var _exports_exports = /* @__PURE__ */ require("./chunk-DakpK96I.cjs").__exportAll({
 	isArray: () => isArray,
 	isBoolean: () => isBoolean,
 	isDefined: () => isDefined,
@@ -12,6 +12,7 @@ var _exports_exports = /* @__PURE__ */ require("./chunk-CZWwpsFl.cjs").__exportA
 	isNull: () => isNull,
 	isNumber: () => isNumber,
 	isObject: () => isObject,
+	isObjectLike: () => isObjectLike,
 	isRegExp: () => isRegExp,
 	isString: () => isString,
 	isSymbol: () => isSymbol,
@@ -150,6 +151,42 @@ var isUndefined = createTypeGuard(TYPE.Undefined);
 */
 var isObject = createTypeGuard(TYPE.Object);
 /**
+* Checks whether a value is object-like: non-null and `typeof value === 'object'`.
+*
+* This includes plain objects, arrays, `Date`, `RegExp`, boxed primitives, and other built-ins
+* whose `typeof` is `"object"`. It is broader than `isObject`, which only matches plain objects.
+*
+* @template T Input value type.
+* @param value Value to test.
+* @returns `true` when the value is a non-null object.
+*
+* @example
+* ```ts
+* isObjectLike({ a: 1 }); // true
+* ```
+*
+* @example
+* ```ts
+* isObjectLike([]); // true
+* ```
+*
+* @example
+* ```ts
+* isObjectLike(new Date()); // true
+* ```
+*
+* @example
+* ```ts
+* isObjectLike(null); // false
+* ```
+*
+* @example
+* ```ts
+* isObjectLike(() => {}); // false
+* ```
+*/
+var isObjectLike = (value) => typeof value === "object" && !!value;
+/**
 * Checks whether a value is an array.
 *
 * @param value Value to test.

package/type-guard.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-guard.cjs","names":[],"sources":["../src/type-guard/_exports.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/type-guard\n *\n * ## Description\n *\n * Runtime **type guards** and narrowers for primitives, DOM nodes, `NaN`, and common app values.\n * Each helper is implemented once with consistent `typeof` / `Object.prototype.toString` logic so\n * `unknown` from JSON, events, or third-party scripts becomes safe typed branches without ad-hoc\n * checks scattered through the codebase.\n *\n * ## Usage\n *\n * ```ts\n * import { typeGuard } from \"yummies/type-guard\";\n * ```\n */\n\nimport type {\n  AnyFunction,\n  AnyObject,\n  FalsyValues,\n  ValueOf,\n} from 'yummies/types';\n\nconst TYPE = {\n  Null: 'null',\n  Undefined: 'undefined',\n  NaN: 'nan',\n  Object: '[object Object]',\n  Array: '[object Array]',\n  String: '[object String]',\n  Number: '[object Number]',\n  Boolean: '[object Boolean]',\n  Function: '[object Function]',\n  AsyncFunction: '[object AsyncFunction]',\n  RegExp: '[object RegExp]',\n  Symbol: '[object Symbol]',\n  Infinite: 'infinite',\n  Element: 'element',\n};\n\ntype Type = ValueOf<typeof TYPE>;\n\nfunction getType(value: unknown): Type {\n  if (value === undefined) {\n    return TYPE.Undefined;\n  }\n  if (value === null) {\n    return TYPE.Null;\n  }\n\n  // handle DOM elements\n  // @ts-expect-error\n  if (value && (value.nodeType === 1 || value.nodeType === 9)) {\n    return TYPE.Element;\n  }\n\n  const stringifiedValue = Object.prototype.toString.call(value);\n\n  // handle NaN and Infinity\n  if (stringifiedValue === TYPE.Number) {\n    if (Number.isNaN(value as number)) {\n      return TYPE.NaN;\n    }\n    if (!Number.isFinite(value as number)) {\n      return TYPE.Infinite;\n    }\n  }\n\n  return stringifiedValue as Type;\n}\n\nconst createTypeGuard =\n  <T>(...types: Type[]) =>\n  (value: unknown): value is T =>\n    types.includes(getType(value));\n\n/**\n * Checks that a value is neither `null` nor `undefined`.\n *\n * @template T Value type without nullish branches.\n * @param value Value to test.\n * @returns `true` when the value is defined.\n *\n * @example\n * ```ts\n * isDefined(0); // true\n * ```\n *\n * @example\n * ```ts\n * isDefined(null); // false\n * ```\n */\nexport const isDefined = <T>(value: T | undefined | null): value is T =>\n  value != null;\n\n/**\n * Checks whether a value is truthy (`!!value`).\n *\n * @param value Value to test.\n * @returns `true` when `!!value` is true.\n *\n * @example\n * ```ts\n * isTruthy(1); // true\n * ```\n *\n * @example\n * ```ts\n * isTruthy(0); // false\n * ```\n */\nexport const isTruthy = <T>(value: T): value is Exclude<T, FalsyValues> =>\n  !!value;\n\n/**\n * Checks whether a value is falsy (`!Boolean(value)`).\n *\n * @param value Value to test.\n * @returns `true` when `Boolean(value)` is false.\n *\n * @example\n * ```ts\n * isFalsy(null); // true\n * ```\n *\n * @example\n * ```ts\n * isFalsy(\"x\"); // false\n * ```\n */\nexport const isFalsy = <T>(value: T): value is Extract<T, FalsyValues> =>\n  !value;\n\n/**\n * Checks whether a value is exactly `null`.\n *\n * @param value Value to test.\n * @returns `true` when the value is `null`.\n *\n * @example\n * ```ts\n * isNull(null); // true\n * ```\n *\n * @example\n * ```ts\n * isNull(undefined); // false\n * ```\n */\nexport const isNull = createTypeGuard<null>(TYPE.Null);\n\n/**\n * Checks whether a value is exactly `undefined`.\n *\n * @param value Value to test.\n * @returns `true` when the value is `undefined`.\n *\n * @example\n * ```ts\n * isUndefined(undefined); // true\n * ```\n *\n * @example\n * ```ts\n * isUndefined('value'); // false\n * ```\n */\nexport const isUndefined = createTypeGuard<undefined>(TYPE.Undefined);\n\n/**\n * Checks whether a value is a plain object.\n *\n * @param value Value to test.\n * @returns `true` when the value matches `[object Object]`.\n *\n * @example\n * ```ts\n * isObject({ id: 1 }); // true\n * ```\n *\n * @example\n * ```ts\n * isObject([]); // false\n * ```\n */\nexport const isObject = createTypeGuard<AnyObject>(TYPE.Object);\n\n/**\n * Checks whether a value is an array.\n *\n * @param value Value to test.\n * @returns `true` when the value is an array.\n *\n * @example\n * ```ts\n * isArray([1, 2, 3]); // true\n * ```\n *\n * @example\n * ```ts\n * isArray({ length: 1 }); // false\n * ```\n */\nexport const isArray = createTypeGuard<unknown[]>(TYPE.Array);\n\n/**\n * Checks whether a value is a string object or primitive string.\n *\n * @param value Value to test.\n * @returns `true` when the value is a string.\n *\n * @example\n * ```ts\n * isString('hello'); // true\n * ```\n *\n * @example\n * ```ts\n * isString(123); // false\n * ```\n */\nexport const isString = createTypeGuard<string>(TYPE.String);\n\n/**\n * Checks whether a value is a finite number.\n *\n * Unlike `isNaN` and `isInfinite`, this guard only matches regular numeric values.\n *\n * @param value Value to test.\n * @returns `true` when the value is a non-NaN finite number.\n *\n * @example\n * ```ts\n * isNumber(123); // true\n * ```\n *\n * @example\n * ```ts\n * isNumber(Number.NaN); // false\n * ```\n */\nexport const isNumber = createTypeGuard<number>(TYPE.Number);\n\n/**\n * Checks whether a value is a boolean.\n *\n * @param value Value to test.\n * @returns `true` when the value is a boolean.\n *\n * @example\n * ```ts\n * isBoolean(true); // true\n * ```\n *\n * @example\n * ```ts\n * isBoolean('true'); // false\n * ```\n */\nexport const isBoolean = createTypeGuard<boolean>(TYPE.Boolean);\n\n/**\n * Checks whether a value is a synchronous or asynchronous function.\n *\n * @param value Value to test.\n * @returns `true` when the value is a function.\n *\n * @example\n * ```ts\n * isFunction(() => {}); // true\n * ```\n *\n * @example\n * ```ts\n * isFunction(async () => {}); // true\n * ```\n */\nexport const isFunction = createTypeGuard<AnyFunction>(\n  TYPE.Function,\n  TYPE.AsyncFunction,\n);\n\n/**\n * Checks whether a value is a regular expression.\n *\n * @param value Value to test.\n * @returns `true` when the value is a `RegExp`.\n *\n * @example\n * ```ts\n * isRegExp(/foo/); // true\n * ```\n *\n * @example\n * ```ts\n * isRegExp('foo'); // false\n * ```\n */\nexport const isRegExp = createTypeGuard<RegExp>(TYPE.RegExp);\n\n/**\n * Checks whether a value looks like a DOM element or document node.\n *\n * @param value Value to test.\n * @returns `true` when the value has an element-like node type.\n *\n * @example\n * ```ts\n * isElement(document.body); // true\n * ```\n *\n * @example\n * ```ts\n * isElement({ nodeType: 3 }); // false\n * ```\n */\nexport const isElement = createTypeGuard<HTMLElement>(TYPE.Element);\n\n/**\n * Checks whether a value is `NaN`.\n *\n * @param value Value to test.\n * @returns `true` when the value is `NaN`.\n *\n * @example\n * ```ts\n * isNaN(Number.NaN); // true\n * ```\n *\n * @example\n * ```ts\n * isNaN(5); // false\n * ```\n */\nexport const isNaN = createTypeGuard<number>(TYPE.NaN) as (\n  value: unknown,\n) => boolean;\n\n/**\n * Checks whether a value is positive or negative infinity.\n *\n * @param value Value to test.\n * @returns `true` when the value is not finite.\n *\n * @example\n * ```ts\n * isInfinite(Infinity); // true\n * ```\n *\n * @example\n * ```ts\n * isInfinite(10); // false\n * ```\n */\nexport const isInfinite = createTypeGuard<number>(TYPE.Infinite) as (\n  value: unknown,\n) => boolean;\n\n/**\n * Checks whether a value is a symbol.\n *\n * @param value Value to test.\n * @returns `true` when the value is a symbol.\n *\n * @example\n * ```ts\n * isSymbol(Symbol('id')); // true\n * ```\n *\n * @example\n * ```ts\n * isSymbol('id'); // false\n * ```\n */\nexport const isSymbol = createTypeGuard<symbol>(TYPE.Symbol);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAyBA,IAAM,OAAO;CACX,MAAM;CACN,WAAW;CACX,KAAK;CACL,QAAQ;CACR,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,UAAU;CACV,eAAe;CACf,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,SAAS;CACV;AAID,SAAS,QAAQ,OAAsB;AACrC,KAAI,UAAU,KAAA,EACZ,QAAO,KAAK;AAEd,KAAI,UAAU,KACZ,QAAO,KAAK;AAKd,KAAI,UAAU,MAAM,aAAa,KAAK,MAAM,aAAa,GACvD,QAAO,KAAK;CAGd,MAAM,mBAAmB,OAAO,UAAU,SAAS,KAAK,MAAM;AAG9D,KAAI,qBAAqB,KAAK,QAAQ;AACpC,MAAI,OAAO,MAAM,MAAgB,CAC/B,QAAO,KAAK;AAEd,MAAI,CAAC,OAAO,SAAS,MAAgB,CACnC,QAAO,KAAK;;AAIhB,QAAO;;AAGT,IAAM,mBACA,GAAG,WACN,UACC,MAAM,SAAS,QAAQ,MAAM,CAAC;;;;;;;;;;;;;;;;;;AAmBlC,IAAa,aAAgB,UAC3B,SAAS;;;;;;;;;;;;;;;;;AAkBX,IAAa,YAAe,UAC1B,CAAC,CAAC;;;;;;;;;;;;;;;;;AAkBJ,IAAa,WAAc,UACzB,CAAC;;;;;;;;;;;;;;;;;AAkBH,IAAa,SAAS,gBAAsB,KAAK,KAAK;;;;;;;;;;;;;;;;;AAkBtD,IAAa,cAAc,gBAA2B,KAAK,UAAU;;;;;;;;;;;;;;;;;AAkBrE,IAAa,WAAW,gBAA2B,KAAK,OAAO;;;;;;;;;;;;;;;;;AAkB/D,IAAa,UAAU,gBAA2B,KAAK,MAAM;;;;;;;;;;;;;;;;;AAkB7D,IAAa,WAAW,gBAAwB,KAAK,OAAO;;;;;;;;;;;;;;;;;;;AAoB5D,IAAa,WAAW,gBAAwB,KAAK,OAAO;;;;;;;;;;;;;;;;;AAkB5D,IAAa,YAAY,gBAAyB,KAAK,QAAQ;;;;;;;;;;;;;;;;;AAkB/D,IAAa,aAAa,gBACxB,KAAK,UACL,KAAK,cACN;;;;;;;;;;;;;;;;;AAkBD,IAAa,WAAW,gBAAwB,KAAK,OAAO;;;;;;;;;;;;;;;;;AAkB5D,IAAa,YAAY,gBAA6B,KAAK,QAAQ;;;;;;;;;;;;;;;;;AAkBnE,IAAa,QAAQ,gBAAwB,KAAK,IAAI;;;;;;;;;;;;;;;;;AAoBtD,IAAa,aAAa,gBAAwB,KAAK,SAAS;;;;;;;;;;;;;;;;;AAoBhE,IAAa,WAAW,gBAAwB,KAAK,OAAO"}
+{"version":3,"file":"type-guard.cjs","names":[],"sources":["../src/type-guard/_exports.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/type-guard\n *\n * ## Description\n *\n * Runtime **type guards** and narrowers for primitives, DOM nodes, `NaN`, and common app values.\n * Each helper is implemented once with consistent `typeof` / `Object.prototype.toString` logic so\n * `unknown` from JSON, events, or third-party scripts becomes safe typed branches without ad-hoc\n * checks scattered through the codebase.\n *\n * ## Usage\n *\n * ```ts\n * import { typeGuard } from \"yummies/type-guard\";\n * ```\n */\n\nimport type {\n  AnyFunction,\n  AnyObject,\n  FalsyValues,\n  ValueOf,\n} from 'yummies/types';\n\nconst TYPE = {\n  Null: 'null',\n  Undefined: 'undefined',\n  NaN: 'nan',\n  Object: '[object Object]',\n  Array: '[object Array]',\n  String: '[object String]',\n  Number: '[object Number]',\n  Boolean: '[object Boolean]',\n  Function: '[object Function]',\n  AsyncFunction: '[object AsyncFunction]',\n  RegExp: '[object RegExp]',\n  Symbol: '[object Symbol]',\n  Infinite: 'infinite',\n  Element: 'element',\n};\n\ntype Type = ValueOf<typeof TYPE>;\n\nfunction getType(value: unknown): Type {\n  if (value === undefined) {\n    return TYPE.Undefined;\n  }\n  if (value === null) {\n    return TYPE.Null;\n  }\n\n  // handle DOM elements\n  // @ts-expect-error\n  if (value && (value.nodeType === 1 || value.nodeType === 9)) {\n    return TYPE.Element;\n  }\n\n  const stringifiedValue = Object.prototype.toString.call(value);\n\n  // handle NaN and Infinity\n  if (stringifiedValue === TYPE.Number) {\n    if (Number.isNaN(value as number)) {\n      return TYPE.NaN;\n    }\n    if (!Number.isFinite(value as number)) {\n      return TYPE.Infinite;\n    }\n  }\n\n  return stringifiedValue as Type;\n}\n\nconst createTypeGuard =\n  <T>(...types: Type[]) =>\n  (value: unknown): value is T =>\n    types.includes(getType(value));\n\n/**\n * Checks that a value is neither `null` nor `undefined`.\n *\n * @template T Value type without nullish branches.\n * @param value Value to test.\n * @returns `true` when the value is defined.\n *\n * @example\n * ```ts\n * isDefined(0); // true\n * ```\n *\n * @example\n * ```ts\n * isDefined(null); // false\n * ```\n */\nexport const isDefined = <T>(value: T | undefined | null): value is T =>\n  value != null;\n\n/**\n * Checks whether a value is truthy (`!!value`).\n *\n * @param value Value to test.\n * @returns `true` when `!!value` is true.\n *\n * @example\n * ```ts\n * isTruthy(1); // true\n * ```\n *\n * @example\n * ```ts\n * isTruthy(0); // false\n * ```\n */\nexport const isTruthy = <T>(value: T): value is Exclude<T, FalsyValues> =>\n  !!value;\n\n/**\n * Checks whether a value is falsy (`!Boolean(value)`).\n *\n * @param value Value to test.\n * @returns `true` when `Boolean(value)` is false.\n *\n * @example\n * ```ts\n * isFalsy(null); // true\n * ```\n *\n * @example\n * ```ts\n * isFalsy(\"x\"); // false\n * ```\n */\nexport const isFalsy = <T>(value: T): value is Extract<T, FalsyValues> =>\n  !value;\n\n/**\n * Checks whether a value is exactly `null`.\n *\n * @param value Value to test.\n * @returns `true` when the value is `null`.\n *\n * @example\n * ```ts\n * isNull(null); // true\n * ```\n *\n * @example\n * ```ts\n * isNull(undefined); // false\n * ```\n */\nexport const isNull = createTypeGuard<null>(TYPE.Null);\n\n/**\n * Checks whether a value is exactly `undefined`.\n *\n * @param value Value to test.\n * @returns `true` when the value is `undefined`.\n *\n * @example\n * ```ts\n * isUndefined(undefined); // true\n * ```\n *\n * @example\n * ```ts\n * isUndefined('value'); // false\n * ```\n */\nexport const isUndefined = createTypeGuard<undefined>(TYPE.Undefined);\n\n/**\n * Checks whether a value is a plain object.\n *\n * @param value Value to test.\n * @returns `true` when the value matches `[object Object]`.\n *\n * @example\n * ```ts\n * isObject({ id: 1 }); // true\n * ```\n *\n * @example\n * ```ts\n * isObject([]); // false\n * ```\n */\nexport const isObject = createTypeGuard<AnyObject>(TYPE.Object);\n\n/**\n * Checks whether a value is object-like: non-null and `typeof value === 'object'`.\n *\n * This includes plain objects, arrays, `Date`, `RegExp`, boxed primitives, and other built-ins\n * whose `typeof` is `\"object\"`. It is broader than `isObject`, which only matches plain objects.\n *\n * @template T Input value type.\n * @param value Value to test.\n * @returns `true` when the value is a non-null object.\n *\n * @example\n * ```ts\n * isObjectLike({ a: 1 }); // true\n * ```\n *\n * @example\n * ```ts\n * isObjectLike([]); // true\n * ```\n *\n * @example\n * ```ts\n * isObjectLike(new Date()); // true\n * ```\n *\n * @example\n * ```ts\n * isObjectLike(null); // false\n * ```\n *\n * @example\n * ```ts\n * isObjectLike(() => {}); // false\n * ```\n */\nexport const isObjectLike = <T = never>(\n  value: unknown,\n): value is T extends never ? Extract<typeof value, object> : T =>\n  typeof value === 'object' && !!value;\n\n/**\n * Checks whether a value is an array.\n *\n * @param value Value to test.\n * @returns `true` when the value is an array.\n *\n * @example\n * ```ts\n * isArray([1, 2, 3]); // true\n * ```\n *\n * @example\n * ```ts\n * isArray({ length: 1 }); // false\n * ```\n */\nexport const isArray = createTypeGuard<unknown[]>(TYPE.Array);\n\n/**\n * Checks whether a value is a string object or primitive string.\n *\n * @param value Value to test.\n * @returns `true` when the value is a string.\n *\n * @example\n * ```ts\n * isString('hello'); // true\n * ```\n *\n * @example\n * ```ts\n * isString(123); // false\n * ```\n */\nexport const isString = createTypeGuard<string>(TYPE.String);\n\n/**\n * Checks whether a value is a finite number.\n *\n * Unlike `isNaN` and `isInfinite`, this guard only matches regular numeric values.\n *\n * @param value Value to test.\n * @returns `true` when the value is a non-NaN finite number.\n *\n * @example\n * ```ts\n * isNumber(123); // true\n * ```\n *\n * @example\n * ```ts\n * isNumber(Number.NaN); // false\n * ```\n */\nexport const isNumber = createTypeGuard<number>(TYPE.Number);\n\n/**\n * Checks whether a value is a boolean.\n *\n * @param value Value to test.\n * @returns `true` when the value is a boolean.\n *\n * @example\n * ```ts\n * isBoolean(true); // true\n * ```\n *\n * @example\n * ```ts\n * isBoolean('true'); // false\n * ```\n */\nexport const isBoolean = createTypeGuard<boolean>(TYPE.Boolean);\n\n/**\n * Checks whether a value is a synchronous or asynchronous function.\n *\n * @param value Value to test.\n * @returns `true` when the value is a function.\n *\n * @example\n * ```ts\n * isFunction(() => {}); // true\n * ```\n *\n * @example\n * ```ts\n * isFunction(async () => {}); // true\n * ```\n */\nexport const isFunction = createTypeGuard<AnyFunction>(\n  TYPE.Function,\n  TYPE.AsyncFunction,\n);\n\n/**\n * Checks whether a value is a regular expression.\n *\n * @param value Value to test.\n * @returns `true` when the value is a `RegExp`.\n *\n * @example\n * ```ts\n * isRegExp(/foo/); // true\n * ```\n *\n * @example\n * ```ts\n * isRegExp('foo'); // false\n * ```\n */\nexport const isRegExp = createTypeGuard<RegExp>(TYPE.RegExp);\n\n/**\n * Checks whether a value looks like a DOM element or document node.\n *\n * @param value Value to test.\n * @returns `true` when the value has an element-like node type.\n *\n * @example\n * ```ts\n * isElement(document.body); // true\n * ```\n *\n * @example\n * ```ts\n * isElement({ nodeType: 3 }); // false\n * ```\n */\nexport const isElement = createTypeGuard<HTMLElement>(TYPE.Element);\n\n/**\n * Checks whether a value is `NaN`.\n *\n * @param value Value to test.\n * @returns `true` when the value is `NaN`.\n *\n * @example\n * ```ts\n * isNaN(Number.NaN); // true\n * ```\n *\n * @example\n * ```ts\n * isNaN(5); // false\n * ```\n */\nexport const isNaN = createTypeGuard<number>(TYPE.NaN) as (\n  value: unknown,\n) => boolean;\n\n/**\n * Checks whether a value is positive or negative infinity.\n *\n * @param value Value to test.\n * @returns `true` when the value is not finite.\n *\n * @example\n * ```ts\n * isInfinite(Infinity); // true\n * ```\n *\n * @example\n * ```ts\n * isInfinite(10); // false\n * ```\n */\nexport const isInfinite = createTypeGuard<number>(TYPE.Infinite) as (\n  value: unknown,\n) => boolean;\n\n/**\n * Checks whether a value is a symbol.\n *\n * @param value Value to test.\n * @returns `true` when the value is a symbol.\n *\n * @example\n * ```ts\n * isSymbol(Symbol('id')); // true\n * ```\n *\n * @example\n * ```ts\n * isSymbol('id'); // false\n * ```\n */\nexport const isSymbol = createTypeGuard<symbol>(TYPE.Symbol);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAyBA,IAAM,OAAO;CACX,MAAM;CACN,WAAW;CACX,KAAK;CACL,QAAQ;CACR,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,UAAU;CACV,eAAe;CACf,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,SAAS;AACX;AAIA,SAAS,QAAQ,OAAsB;CACrC,IAAI,UAAU,KAAA,GACZ,OAAO,KAAK;CAEd,IAAI,UAAU,MACZ,OAAO,KAAK;CAKd,IAAI,UAAU,MAAM,aAAa,KAAK,MAAM,aAAa,IACvD,OAAO,KAAK;CAGd,MAAM,mBAAmB,OAAO,UAAU,SAAS,KAAK,KAAK;CAG7D,IAAI,qBAAqB,KAAK,QAAQ;EACpC,IAAI,OAAO,MAAM,KAAe,GAC9B,OAAO,KAAK;EAEd,IAAI,CAAC,OAAO,SAAS,KAAe,GAClC,OAAO,KAAK;CAEhB;CAEA,OAAO;AACT;AAEA,IAAM,mBACA,GAAG,WACN,UACC,MAAM,SAAS,QAAQ,KAAK,CAAC;;;;;;;;;;;;;;;;;;AAmBjC,IAAa,aAAgB,UAC3B,SAAS;;;;;;;;;;;;;;;;;AAkBX,IAAa,YAAe,UAC1B,CAAC,CAAC;;;;;;;;;;;;;;;;;AAkBJ,IAAa,WAAc,UACzB,CAAC;;;;;;;;;;;;;;;;;AAkBH,IAAa,SAAS,gBAAsB,KAAK,IAAI;;;;;;;;;;;;;;;;;AAkBrD,IAAa,cAAc,gBAA2B,KAAK,SAAS;;;;;;;;;;;;;;;;;AAkBpE,IAAa,WAAW,gBAA2B,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqC9D,IAAa,gBACX,UAEA,OAAO,UAAU,YAAY,CAAC,CAAC;;;;;;;;;;;;;;;;;AAkBjC,IAAa,UAAU,gBAA2B,KAAK,KAAK;;;;;;;;;;;;;;;;;AAkB5D,IAAa,WAAW,gBAAwB,KAAK,MAAM;;;;;;;;;;;;;;;;;;;AAoB3D,IAAa,WAAW,gBAAwB,KAAK,MAAM;;;;;;;;;;;;;;;;;AAkB3D,IAAa,YAAY,gBAAyB,KAAK,OAAO;;;;;;;;;;;;;;;;;AAkB9D,IAAa,aAAa,gBACxB,KAAK,UACL,KAAK,aACP;;;;;;;;;;;;;;;;;AAkBA,IAAa,WAAW,gBAAwB,KAAK,MAAM;;;;;;;;;;;;;;;;;AAkB3D,IAAa,YAAY,gBAA6B,KAAK,OAAO;;;;;;;;;;;;;;;;;AAkBlE,IAAa,QAAQ,gBAAwB,KAAK,GAAG;;;;;;;;;;;;;;;;;AAoBrD,IAAa,aAAa,gBAAwB,KAAK,QAAQ;;;;;;;;;;;;;;;;;AAoB/D,IAAa,WAAW,gBAAwB,KAAK,MAAM"}

package/type-guard.d.ts

@@ -121,6 +121,42 @@ declare const isUndefined: (value: unknown) => value is undefined;
  * ```
  */
 declare const isObject: (value: unknown) => value is AnyObject;
+/**
+ * Checks whether a value is object-like: non-null and `typeof value === 'object'`.
+ *
+ * This includes plain objects, arrays, `Date`, `RegExp`, boxed primitives, and other built-ins
+ * whose `typeof` is `"object"`. It is broader than `isObject`, which only matches plain objects.
+ *
+ * @template T Input value type.
+ * @param value Value to test.
+ * @returns `true` when the value is a non-null object.
+ *
+ * @example
+ * ```ts
+ * isObjectLike({ a: 1 }); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isObjectLike([]); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isObjectLike(new Date()); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isObjectLike(null); // false
+ * ```
+ *
+ * @example
+ * ```ts
+ * isObjectLike(() => {}); // false
+ * ```
+ */
+declare const isObjectLike: <T = never>(value: unknown) => value is T extends never ? Extract<typeof value, object> : T;
 /**
  * Checks whether a value is an array.
  *
@@ -305,6 +341,7 @@ declare const _exports_isNaN: typeof isNaN;
 declare const _exports_isNull: typeof isNull;
 declare const _exports_isNumber: typeof isNumber;
 declare const _exports_isObject: typeof isObject;
+declare const _exports_isObjectLike: typeof isObjectLike;
 declare const _exports_isRegExp: typeof isRegExp;
 declare const _exports_isString: typeof isString;
 declare const _exports_isSymbol: typeof isSymbol;
@@ -323,6 +360,7 @@ declare namespace _exports {
     _exports_isNull as isNull,
     _exports_isNumber as isNumber,
     _exports_isObject as isObject,
+    _exports_isObjectLike as isObjectLike,
     _exports_isRegExp as isRegExp,
     _exports_isString as isString,
     _exports_isSymbol as isSymbol,

package/type-guard.js

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./chunk-pbuEa-1d.js";
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
 //#region src/type-guard/_exports.ts
 var _exports_exports = /* @__PURE__ */ __exportAll({
 	isArray: () => isArray,
@@ -12,6 +12,7 @@ var _exports_exports = /* @__PURE__ */ __exportAll({
 	isNull: () => isNull,
 	isNumber: () => isNumber,
 	isObject: () => isObject,
+	isObjectLike: () => isObjectLike,
 	isRegExp: () => isRegExp,
 	isString: () => isString,
 	isSymbol: () => isSymbol,
@@ -150,6 +151,42 @@ var isUndefined = createTypeGuard(TYPE.Undefined);
 */
 var isObject = createTypeGuard(TYPE.Object);
 /**
+* Checks whether a value is object-like: non-null and `typeof value === 'object'`.
+*
+* This includes plain objects, arrays, `Date`, `RegExp`, boxed primitives, and other built-ins
+* whose `typeof` is `"object"`. It is broader than `isObject`, which only matches plain objects.
+*
+* @template T Input value type.
+* @param value Value to test.
+* @returns `true` when the value is a non-null object.
+*
+* @example
+* ```ts
+* isObjectLike({ a: 1 }); // true
+* ```
+*
+* @example
+* ```ts
+* isObjectLike([]); // true
+* ```
+*
+* @example
+* ```ts
+* isObjectLike(new Date()); // true
+* ```
+*
+* @example
+* ```ts
+* isObjectLike(null); // false
+* ```
+*
+* @example
+* ```ts
+* isObjectLike(() => {}); // false
+* ```
+*/
+var isObjectLike = (value) => typeof value === "object" && !!value;
+/**
 * Checks whether a value is an array.
 *
 * @param value Value to test.