@likec4/core 1.48.0 → 1.50.0

package/dist/_chunks/index7.d.mts

@@ -1,268 +0,0 @@
-import { Dt as ReorderedArray, wt as NonEmptyArray, yt as IterableContainer } from "./_aux.mjs";
-import { s as Fqn } from "./scalar.mjs";
-import { SetNonNullable, SetRequired } from "type-fest";
-
-//#region src/utils/invariant.d.ts
-declare function nonNullable<T>(value: T, message?: string | (() => string)): NonNullable<T>;
-declare function invariant(condition: any, message?: string): asserts condition;
-declare function nonexhaustive(value: never): never;
-//#endregion
-//#region src/utils/common-head.d.ts
-/**
- * Common head of two arrays
- *
- * @param equals - Equality function, defaults to `Object.is`
- */
-declare function commonHead<T>(sources: ReadonlyArray<T>, targets: ReadonlyArray<T>, equals?: (a: T, b: T) => boolean): T[];
-//#endregion
-//#region src/utils/compare-natural.d.ts
-declare function compareNatural(a: string | undefined, b: string | undefined): -1 | 0 | 1;
-/**
- * Compares two strings lexicographically first, then hierarchically based on their depth.\
- * From parent nodes to leaves
- *
- * @example
- * const lines = [
- *   'b.c',
- *   'b',
- *   'a.b.c',
- * ]
- * lines.sort(compareNaturalHierarchically('.'))
- * // [
- * //   'a.b.c',
- * //   'b',
- * //   'b.c',
- * // ]
- */
-declare function compareNaturalHierarchically(separator?: string, deepestFirst?: boolean): (a: string | undefined, b: string | undefined) => number;
-//#endregion
-//#region src/utils/fqn.d.ts
-declare function parentFqn<E extends string>(fqn: E): E | null;
-declare function nameFromFqn<E extends string>(fqn: E): string;
-/**
- * Check if one element is an ancestor of another
- * Composable version
- * @signature
- *  isAncestor(another)(ancestor)
- */
-declare function isAncestor<A extends string | {
-  id: string;
-}>(another: NoInfer<A>): (ancestor: A) => boolean;
-/**
- * Check if one element is an ancestor of another
- * @signature
- *   isAncestor(ancestor, another)
- */
-declare function isAncestor<A extends string | {
-  id: string;
-}>(ancestor: A, another: A): boolean;
-declare function isSameHierarchy<T extends string>(one: NoInfer<T> | WithId<NoInfer<T>>): (another: T | WithId<T>) => boolean;
-declare function isSameHierarchy<T extends string>(one: T | WithId<T>, another: T | WithId<T>): boolean;
-type WithId<T = string> = {
-  id: T;
-};
-declare function isDescendantOf<T extends string>(ancestor: WithId<T>): (descedant: WithId<T>) => boolean;
-declare function isDescendantOf<T extends string>(descedant: WithId<T>, ancestor: WithId<T>): boolean;
-/**
- * How deep in the hierarchy the element is.
- * Root element has depth 1
- */
-declare function hierarchyLevel<E extends string | {
-  id: Fqn;
-}>(elementOfFqn: E): number;
-/**
- * Calculate the distance as number of steps from one element to another, i.e.
- * going up to the common ancestor, then going down to the other element.
- * Sibling distance is always 1
- *
- * Can be used for hierarchical clustering
- */
-declare function hierarchyDistance<E extends string | {
-  id: Fqn;
-}>(one: E, another: E): number;
-declare function commonAncestor<E extends string>(first: E, second: E): E | null;
-/**
- * Get all ancestor elements (i.e. parent, parent’s parent, etc.)
- * going up from parent to the root
- */
-declare function ancestorsFqn<Id extends string>(fqn: Id): Id[];
-/**
- * Compares two fully qualified names (fqns) hierarchically based on their depth.
- * From parent nodes to leaves
- *
- * @param {string} a - The first fqn to compare.
- * @param {string} b - The second fqn to compare.
- * @returns {number} - 0 if the fqns have the same depth.
- *                    - Positive number if a is deeper than b.
- *                    - Negative number if b is deeper than a.
- */
-declare function compareFqnHierarchically<T extends string = string>(a: T, b: T): -1 | 0 | 1;
-declare function compareByFqnHierarchically<T extends {
-  id: string;
-}>(a: T, b: T): -1 | 0 | 1;
-/**
- * Sorts an array of objects hierarchically based on their fully qualified names (FQN).
- * Objects are sorted by the number of segments in their FQN (defined by dot-separated ID).
- *
- * @typeParam T - Object type that contains an 'id' string property
- * @typeParam A - Type extending IterableContainer of T
- *
- * @param array - Array of objects to be sorted
- * @returns A new array with items sorted by their FQN hierarchy depth (number of segments)
- *
- * @example
- * ```ts
- * const items = [
- *   { id: "a.b.c" },
- *   { id: "a" },
- *   { id: "a.b" }
- * ];
- * sortByFqnHierarchically(items);
- * // Result: [
- * //   { id: "a" },
- * //   { id: "a.b" },
- * //   { id: "a.b.c" }
- * // ]
- * ```
- */
-declare function sortByFqnHierarchically<T extends {
-  id: string;
-}, A extends IterableContainer<T>>(array: A): ReorderedArray<A>;
-/**
- * Keeps initial order of the elements, but ensures that parents are before children
- */
-declare function sortParentsFirst<T extends {
-  id: string;
-}, A extends IterableContainer<T>>(array: A): ReorderedArray<A>;
-/**
- * Sorts an array of objects naturally by their fully qualified name (FQN) identifier.
- *
- * @template T - Type of objects containing an 'id' string property
- * @template A - Type extending IterableContainer of T
- *
- * @param first - Optional. Either the array to sort or the sort direction ('asc'|'desc')
- * @param sort - Optional. The sort direction ('asc'|'desc'). Defaults to 'asc' if not specified
- *
- * @example
- * // As a function that returns a sorting function
- * const sorted = sortNaturalByFqn('desc')(myArray);
- *
- * // Direct array sorting
- * const sorted = sortNaturalByFqn(myArray, 'desc');
- */
-declare function sortNaturalByFqn(sort?: 'asc' | 'desc'): <I extends WithId<string>, A extends IterableContainer<I>>(array: A) => ReorderedArray<A>;
-declare function sortNaturalByFqn<A extends IterableContainer<WithId>>(array: A, sort?: 'asc' | 'desc'): ReorderedArray<A>;
-//#endregion
-//#region src/utils/getOrCreate.d.ts
-declare function getOrCreate<K, V>(map: Map<K, V>, key: K, create: (key: K) => V): V;
-declare function getOrCreate<K extends WeakKey, V>(map: WeakMap<K, V>, key: K, create: (key: K) => V): V;
-//#endregion
-//#region src/utils/guards.d.ts
-declare function isString(value: unknown): value is string;
-declare function isNonEmptyArray<A>(arr: ArrayLike<A> | undefined): arr is NonEmptyArray<A>;
-declare function hasProp<T extends object, P extends keyof T & string>(value: T, path: P): value is SetRequired<SetNonNullable<T, P>, P>;
-type Guard<N = unknown> = (n: unknown) => n is N;
-type Guarded<G> = G extends Guard<infer N> ? N : never;
-/**
- * Creates a type guard that checks if a value matches any of the provided predicates.
- *
- * @template Predicates - A non-empty array of guard functions
- * @param predicates - The guard functions to test against
- * @returns A type guard function that returns true if the value matches any of the predicates
- *
- * @example
- * ```typescript
- * const isStringOrNumber = isAnyOf(isString, isNumber);
- *
- * if (isStringOrNumber(value)) {
- *   // value is now typed as string | number
- *   console.log(value);
- * }
- * ```
- */
-declare function isAnyOf<const Predicates extends NonEmptyArray<Guard>>(...predicates: Predicates): (value: unknown) => value is Guarded<Predicates[number]>;
-//#endregion
-//#region src/utils/memoize-prop.d.ts
-/**
- * Saves the value returned by fn() in a hidden property tag of obj object, so next time memoizeProp() is called,
- * that value will be returned, and fn won't be called.
- *
- * @example
- * ```ts
- * class Model {
- *   // using same Symbol
- *   get computed1() {
- *     return memoizeProp(this, Symbol.for('computed1'), () => doOnce())
- *   }
- *   // using string
- *   get computed2() {
- *     return memoizeProp(this, 'computed2', () => doOnce())
- *   }
- *
- * }
- * ```
- */
-declare function memoizeProp<Tag extends symbol | string, Res>(obj: object, tag: Tag, fn: () => Res): Res;
-//#endregion
-//#region src/utils/promises.d.ts
-declare function delay(): Promise<string>;
-declare function delay(ms: number): Promise<string>;
-declare function delay(randomFrom: number, randomTo: number): Promise<string>;
-declare function promiseNextTick(): Promise<void>;
-declare function onNextTick(fn: () => Promise<void> | void): void;
-//#endregion
-//#region src/utils/relations.d.ts
-type RelationshipLike = {
-  source: {
-    id: string;
-  };
-  target: {
-    id: string;
-  };
-};
-/**
- * Compares two relations hierarchically.
- * From the most general (implicit) to the most specific (deepest in the tree)
- */
-declare const compareRelations: <T extends RelationshipLike>(a: T, b: T) => number;
-//#endregion
-//#region src/utils/set.d.ts
-/**
- * Returns new set as a union of given sets
- * Keeps order of elements
- */
-declare function union<T>(...sets: ReadonlySet<T>[]): Set<T>;
-/**
- * Returns new set as an intersection of all sets
- * Keeps order from the first set
- */
-declare function intersection<T>(first: ReadonlySet<T>, ...sets: NonEmptyArray<ReadonlySet<NoInfer<T>>>): Set<T>;
-/**
- * Returns new set as a difference of two sets (A-B)
- * Keeps order from the first set
- */
-declare function difference<T>(a: ReadonlySet<T>, b: ReadonlySet<NoInfer<T>>): Set<T>;
-declare function equals<T>(a: ReadonlySet<T>, b: ReadonlySet<T>): boolean;
-declare function symmetricDifference<T>(a: ReadonlySet<T>, b: ReadonlySet<T>): Set<T>;
-//#endregion
-//#region src/utils/object-hash.d.ts
-declare function objectHash(value: any): string;
-//#endregion
-//#region src/utils/string-hash.d.ts
-/**
- * @see https://gist.github.com/victor-homyakov/bcb7d7911e4a388b1c810f8c3ce17bcf
- */
-declare function stringHash(str: string): string;
-//#endregion
-//#region src/utils/markdown/to-html.d.ts
-declare function markdownToHtml(markdown: string): string;
-//#endregion
-//#region src/utils/markdown/to-text.d.ts
-/**
- * Converts markdown to plain text, removing any markdown formatting.
- * @param markdown - The markdown to convert.
- * @returns The plain text.
- */
-declare function markdownToText(markdown: string): string;
-//#endregion
-export { parentFqn as A, compareFqnHierarchically as C, isDescendantOf as D, isAncestor as E, compareNaturalHierarchically as F, commonHead as I, invariant as L, sortNaturalByFqn as M, sortParentsFirst as N, isSameHierarchy as O, compareNatural as P, nonNullable as R, compareByFqnHierarchically as S, hierarchyLevel as T, isNonEmptyArray as _, difference as a, ancestorsFqn as b, symmetricDifference as c, delay as d, onNextTick as f, isAnyOf as g, hasProp as h, objectHash as i, sortByFqnHierarchically as j, nameFromFqn as k, union as l, memoizeProp as m, markdownToHtml as n, equals as o, promiseNextTick as p, stringHash as r, intersection as s, markdownToText as t, compareRelations as u, isString as v, hierarchyDistance as w, commonAncestor as x, getOrCreate as y, nonexhaustive as z };

package/dist/_chunks/index8.d.mts

@@ -1,144 +0,0 @@
-import { bt as IteratorLike } from "./_aux.mjs";
-
-//#region src/utils/iterable/_types.d.ts
-declare function isIterable<T, I extends Iterable<T>>(something: I | unknown): something is Iterable<T>;
-//#endregion
-//#region src/utils/iterable/filter.d.ts
-/**
- * Filters an iterable based on a predicate.
- * Composabel first version of `ifilter`.
- * @signature
- *    ifilter(predicate)(data)
- */
-declare function ifilter<T, S extends T>(predicate: (v: T) => v is S): (iterable: Iterable<T>) => IteratorLike<S>;
-declare function ifilter<T>(predicate: (v: T) => boolean): (iterable: Iterable<T>) => IteratorLike<T>;
-/**
- * Filters an iterable based on a predicate.
- * Data first version of `ifilter`.
- * @signature
- *    ifilter(data, predicate)
- * @example
- *    ifilter(new Set([1, 2, 3]), x => x % 2 === 1) // => Iterable<[1, 3]>
- */
-declare function ifilter<T, S extends T>(iterable: Iterable<T>, predicate: (v: T) => v is S): IteratorLike<S>;
-declare function ifilter<T>(iterable: Iterable<T>, predicate: (v: T) => boolean): IteratorLike<T>;
-//#endregion
-//#region src/utils/iterable/find.d.ts
-/**
- * Finds the first element in the iterable that satisfies the predicate.
- * Composable first version of `find`.
- * @signature
- *   ifind(predicate)(data)
- */
-declare function ifind<T, S extends T>(predicate: (item: T) => item is S): (iterable: Iterable<T>) => S | undefined;
-declare function ifind<T>(predicate: (item: T) => boolean): (iterable: Iterable<T>) => T | undefined;
-/**
- * Finds the first element in the iterable that satisfies the predicate.
- * Data first version of `find`.
- * @signature
- *  ifind(data, predicate)
- */
-declare function ifind<T, S extends T>(iterable: Iterable<T>, predicate: (item: T) => item is S): S | undefined;
-declare function ifind<T>(iterable: Iterable<T>, predicate: (item: T) => boolean): T | undefined;
-//#endregion
-//#region src/utils/iterable/first.d.ts
-/**
- * Takes the first N elements from an iterable.
- * Composable first version of `ifirst`.
- * @signature
- *   ifirst(count)(data)
- */
-declare function ifirst<T>(count: number): (iterable: Iterable<T>) => IteratorLike<T>;
-/**
- * Takes the first N elements from an iterable.
- * Data first version of `ifirst`.
- * @signature
- *   ifirst(data, count)
- * @example
- *   ifirst([1, 2, 3, 4, 5], 3) // => Iterable<[1, 2, 3]>
- */
-declare function ifirst<T>(iterable: Iterable<T>, count: number): IteratorLike<T>;
-//#endregion
-//#region src/utils/iterable/flat.d.ts
-declare function iflat(): <T>(iterable: Iterable<IteratorLike<T>>) => IteratorLike<T>;
-declare function iflat<T>(iterable: Iterable<IteratorLike<T>>): IteratorLike<T>;
-//#endregion
-//#region src/utils/iterable/flatMap.d.ts
-type FlatMapFunction<T, S> = (item: T) => Iterable<S>;
-/**
- * Maps an iterable using a mapper function and flattens the result by one level.
- * Composable first version of `iflatMap`.
- * @signature
- *   iflatMap(mapper)(data)
- */
-declare function iflatMap<T, S>(mapper: FlatMapFunction<T, S>): (iterable: Iterable<T>) => IteratorLike<S>;
-/**
- * Maps an iterable using a mapper function and flattens the result by one level.
- * Data first version of `iflatMap`.
- * @signature
- *   iflatMap(data, mapper)
- */
-declare function iflatMap<T, S>(iterable: Iterable<T>, mapper: FlatMapFunction<T, S>): IteratorLike<S>;
-//#endregion
-//#region src/utils/iterable/head.d.ts
-declare function ihead<T>(): (iterable: Iterable<T>) => T | undefined;
-/**
- * Finds the first element in the iterable that satisfies the predicate.
- * Data first version of `find`.
- * @signature
- *  ifind(data, predicate)
- */
-declare function ihead<T>(iterable: Iterable<T>): T | undefined;
-//#endregion
-//#region src/utils/iterable/map.d.ts
-type MapFunction<T, S> = (item: T) => S;
-/**
- * Maps an iterable using a mapper function.
- * Composable first version of `imap`.
- * @signature
- *   imap(mapper)(data)
- */
-declare function imap<T, S>(mapper: MapFunction<T, S>): (iterable: Iterable<T>) => IteratorLike<S>;
-/**
- * Maps an iterable using a mapper function.
- * Data first version of `imap`.
- * @signature
- *   imap(data, mapper)
- */
-declare function imap<T, S>(iterable: Iterable<T>, mapper: MapFunction<T, S>): IteratorLike<S>;
-//#endregion
-//#region src/utils/iterable/reduce.d.ts
-declare function ireduce<T, R>(reducer: (acc: R, item: T) => R, initialValue: R): (iterable: Iterable<T>) => R;
-declare function ireduce<T, R>(iterable: Iterable<T>, reducer: (acc: R, item: T) => R, initialValue: R): R;
-//#endregion
-//#region src/utils/iterable/some.d.ts
-/**
- * Checks if at least one element in the iterable satisfies the predicate.
- * Composable first version of `some`.
- * @signature
- *   isome(predicate)(data)
- */
-declare function isome<T>(predicate: (item: T) => boolean): (iterable: Iterable<T>) => boolean;
-/**
- * Checks if at least one element in the iterable satisfies the predicate.
- * Data first version of `some`.
- * @signature
- *  isome(data, predicate)
- */
-declare function isome<T>(iterable: Iterable<T>, predicate: (item: T) => boolean): boolean;
-//#endregion
-//#region src/utils/iterable/to.d.ts
-declare function toArray(): <T>(iterable: Iterable<T> | ArrayLike<T>) => T[];
-declare function toArray<T>(iterable: Iterable<T> | ArrayLike<T>): T[];
-declare function toSet(): <T>(iterable: Iterable<T>) => Set<T>;
-declare function toSet<T>(iterable: Iterable<T>): Set<T>;
-//#endregion
-//#region src/utils/iterable/unique.d.ts
-/**
- * Returns an iterable that yields only unique values.
- * It uses a Set to keep track of the values.
- */
-declare function iunique(): <T>(iterable: Iterable<T>) => IteratorLike<T>;
-declare function iunique<T>(iterable: Iterable<T>): IteratorLike<T>;
-//#endregion
-export { ireduce as a, iflatMap as c, ifind as d, ifilter as f, isome as i, iflat as l, toArray as n, imap as o, isIterable as p, toSet as r, ihead as s, iunique as t, ifirst as u };

package/dist/_chunks/invariant.mjs

@@ -1,18 +0,0 @@
-//#region src/utils/invariant.ts
-function nonNullable(value, message) {
-	if (typeof value === "undefined" || value == null) {
-		const msg = typeof message === "function" ? message() : message;
-		throw new Error(msg ?? `Expected defined value, but received ${value}`);
-	}
-	return value;
-}
-function invariant(condition, message) {
-	if (condition) return;
-	throw new Error(message ?? "Invariant failed");
-}
-function nonexhaustive(value) {
-	throw new Error(`NonExhaustive value: ${value}`);
-}
-
-//#endregion
-export { nonNullable as n, nonexhaustive as r, invariant as t };

package/dist/_chunks/iterable.mjs

@@ -1,146 +0,0 @@
-import { L as e$2, N as e, P as e$1 } from "./libs/remeda.mjs";
-import { t as invariant } from "./invariant.mjs";
-
-//#region src/utils/iterable/_types.ts
-function isIterable(something) {
-	return e(something) && typeof something === "object" && Symbol.iterator in something;
-}
-
-//#endregion
-//#region src/utils/iterable/filter.ts
-function ifilter(arg1, arg2) {
-	const pred = arg2 ?? arg1;
-	invariant(e$1(pred));
-	function* _filter(iter) {
-		for (const value of iter) if (pred(value)) yield value;
-	}
-	if (!arg2) return _filter;
-	return _filter(arg1);
-}
-
-//#endregion
-//#region src/utils/iterable/find.ts
-function ifind(arg1, arg2) {
-	const pred = arg2 ?? arg1;
-	invariant(e$1(pred));
-	function _find(iter) {
-		for (const value of iter) if (pred(value)) return value;
-	}
-	if (!arg2) return _find;
-	return _find(arg1);
-}
-
-//#endregion
-//#region src/utils/iterable/first.ts
-function ifirst(arg1, arg2) {
-	const count = arg2 ?? arg1;
-	invariant(typeof count === "number" && count >= 0, "Count must be a non-negative number");
-	function* _first(iter) {
-		let taken = 0;
-		for (const value of iter) {
-			if (taken >= count) break;
-			yield value;
-			taken++;
-		}
-	}
-	if (arg2 === void 0) return (iterable) => _first(iterable);
-	return _first(arg1);
-}
-
-//#endregion
-//#region src/utils/iterable/flat.ts
-function iflat(iterable) {
-	return iterable ? _iflat(iterable) : _iflat;
-}
-function* _iflat(iterable) {
-	for (const inner of iterable) yield* inner;
-}
-
-//#endregion
-//#region src/utils/iterable/flatMap.ts
-function iflatMap(arg1, arg2) {
-	const mapper = arg2 ?? arg1;
-	invariant(e$1(mapper));
-	function* _flatMap(iter) {
-		for (const value of iter) yield* mapper(value);
-	}
-	if (!arg2) return _flatMap;
-	return _flatMap(arg1);
-}
-
-//#endregion
-//#region src/utils/iterable/head.ts
-function ihead(iterable) {
-	if (!iterable) return _head;
-	return _head(iterable);
-}
-function _head(iter) {
-	const { value } = iter[Symbol.iterator]().next();
-	return value;
-}
-
-//#endregion
-//#region src/utils/iterable/map.ts
-function imap(arg1, arg2) {
-	const mapper = arg2 ?? arg1;
-	invariant(e$1(mapper));
-	function* _map(iter) {
-		for (const value of iter) yield mapper(value);
-	}
-	if (!arg2) return _map;
-	return _map(arg1);
-}
-
-//#endregion
-//#region src/utils/iterable/reduce.ts
-function ireduce(arg1, arg2, arg3) {
-	const reducer = e$2(arg3) ? arg2 : arg1;
-	const initialValue = arg3 ?? arg2;
-	invariant(e$1(reducer));
-	function _reduce(iter) {
-		let acc = initialValue;
-		for (const value of iter) acc = reducer(acc, value);
-		return acc;
-	}
-	return e$2(arg3) ? _reduce(arg1) : _reduce;
-}
-
-//#endregion
-//#region src/utils/iterable/some.ts
-function isome(arg1, arg2) {
-	const pred = arg2 ?? arg1;
-	invariant(e$1(pred));
-	function _some(iter) {
-		for (const value of iter) if (pred(value)) return true;
-		return false;
-	}
-	if (!arg2) return _some;
-	return _some(arg1);
-}
-
-//#endregion
-//#region src/utils/iterable/to.ts
-function toArray(iterable) {
-	if (iterable) return Array.from(iterable);
-	return (it) => Array.from(it);
-}
-function toSet(iterable) {
-	if (iterable) return new Set(iterable);
-	return (it) => new Set(it);
-}
-
-//#endregion
-//#region src/utils/iterable/unique.ts
-function iunique(iterable) {
-	return iterable ? _iunique(iterable) : _iunique;
-}
-function* _iunique(iterable) {
-	const seen = /* @__PURE__ */ new Set();
-	for (const item of iterable) if (!seen.has(item)) {
-		seen.add(item);
-		yield item;
-	}
-}
-
-//#endregion
-export { ireduce as a, iflatMap as c, ifind as d, ifilter as f, isome as i, iflat as l, toArray as n, imap as o, isIterable as p, toSet as r, ihead as s, iunique as t, ifirst as u };