inferred-types 0.55.14 → 0.55.16

package/modules/runtime/dist/index.d.ts

@@ -4553,7 +4553,7 @@ type InvalidNever = Throw<"invalid-never", `The value of T when calling IsWideTy
 type IsWideType<T, TNever = InvalidNever> = [IsNever<T>] extends [true] ? TNever : [T] extends [ErrorCondition] ? ProxyError<T, "IsWideType"> : IsWideScalar<T> extends true ? true : IsWideContainer<T> extends true ? true : IsWideUnion<T> extends true ? true : false;
 
 type Process$1k<T extends readonly unknown[]> = {
-    [K in keyof T]: IsWideType<T[K]>;
+    [K in keyof T]: IsWideType<T[K]> extends true ? true : Or<[IsUndefined<T[K]>, IsNull<T[K]>]> extends true ? true : false;
 };
 /**
  * **IsWideUnion**`<T>`
@@ -8129,6 +8129,160 @@ type FrequencyUom = {
  */
 type Frequency = `${number}${OptSpace}${FrequencyUom}`;
 
+/**
+ * **MetricCategory**
+ *
+ * A valid "category" for a `Metric` or `Uom`.
+ *
+ * **Related:** `Uom`, `Metric`
+ */
+type MetricCategory = "Acceleration" | "Area" | "Current" | "Distance" | "Frequency" | "Luminosity" | "Mass" | "Power" | "Pressure" | "Resistance" | "Speed" | "Temperature" | "Time" | "Voltage" | "Volume";
+type UnitsByCategory<T extends string, M extends readonly [string, string][], R extends string = never> = [] extends M ? R : UnitsByCategory<T, AfterFirst<M>, T extends First<M>[0] ? R | First<M>[1] : R>;
+/**
+ * **Uom**`<[T]>`
+ *
+ * A _unit of measure_ for a **metric**.
+ *
+ * - you may filter down to only units of a certain category(s) of `MetricCategory`
+ * by adjusting `T`.
+ *
+ * **Related:** `Metric`, `MetricCategory`, `AreaUom`, `SpeedUom`, ...
+ */
+type Uom<T extends MetricCategory = MetricCategory> = UnitsByCategory<T, [
+    [
+        "Acceleration",
+        AccelerationUom
+    ],
+    [
+        "Area",
+        AreaUom
+    ],
+    [
+        "Current",
+        CurrentUom
+    ],
+    [
+        "Distance",
+        DistanceUom
+    ],
+    [
+        "Frequency",
+        FrequencyUom
+    ],
+    [
+        "Luminosity",
+        LuminosityUom
+    ],
+    [
+        "Mass",
+        MassUom
+    ],
+    [
+        "Power",
+        PowerUom
+    ],
+    [
+        "Pressure",
+        PressureUom
+    ],
+    [
+        "Resistance",
+        ResistanceUom
+    ],
+    [
+        "Speed",
+        SpeedUom
+    ],
+    [
+        "Temperature",
+        TemperatureUom
+    ],
+    [
+        "Time",
+        TimeUom
+    ],
+    [
+        "Volume",
+        VoltageUom
+    ],
+    [
+        "Voltage",
+        VolumeUom
+    ]
+]>;
+/**
+ * **Metric**`<T>`
+ *
+ * A measurement which includes a numeric value plus the Unit of Measure (UOM).
+ *
+ * - you may filter down to only metrics of a certain category(s) of `MetricCategory`
+ * by adjusting `T`.
+ *
+ * **Related:** `Uom`, `MetricCategory`
+ */
+type Metric<T extends MetricCategory = MetricCategory> = UnitsByCategory<T, [
+    [
+        "Acceleration",
+        Acceleration
+    ],
+    [
+        "Area",
+        Area
+    ],
+    [
+        "Current",
+        Current
+    ],
+    [
+        "Distance",
+        Distance
+    ],
+    [
+        "Frequency",
+        Frequency
+    ],
+    [
+        "Luminosity",
+        Luminosity
+    ],
+    [
+        "Mass",
+        Mass
+    ],
+    [
+        "Power",
+        Power
+    ],
+    [
+        "Pressure",
+        Pressure
+    ],
+    [
+        "Resistance",
+        Resistance
+    ],
+    [
+        "Speed",
+        Speed
+    ],
+    [
+        "Temperature",
+        Temperature
+    ],
+    [
+        "TimeMetric",
+        TimeMetric
+    ],
+    [
+        "Voltage",
+        Voltage
+    ],
+    [
+        "Volume",
+        Volume
+    ]
+]>;
+
 type LuminosityMetricsLookup = typeof LUMINOSITY_METRICS_LOOKUP;
 /**
  * Unit of measure for metrics associated with **Luminosity**.
@@ -8297,22 +8451,6 @@ type VolumeUom = {
  */
 type Volume = `${number}${OptSpace}${VolumeUom}`;
 
-/**
- * A measurement which includes a numeric value plus the Unit of Measure (UOM).
- *
- * **Related:** `Uom`
- */
-type Metric = Acceleration | Area | Current | Distance | Frequency | Luminosity | Mass | Power | Pressure | Resistance | Speed | Temperature | TimeMetric | Voltage | Volume;
-type MetricCategory = "Acceleration" | "Area" | "Current" | "Distance" | "Frequency" | "Luminosity" | "Mass" | "Power" | "Pressure" | "Resistance" | "Speed" | "Temperature" | "Time" | "Voltage" | "Volume";
-/**
- * **Uom**
- *
- * A _unit of measure_ for a **metric**.
- *
- * **Related:** `Metric`, `AreaUom`, `SpeedUom`,`MassUom`, `DistanceUom`, ...
- */
-type Uom = AccelerationUom | AreaUom | CurrentUom | DistanceUom | FrequencyUom | LuminosityUom | MassUom | PowerUom | PressureUom | ResistanceUom | SpeedUom | TemperatureUom | TimeUom | VoltageUom | VolumeUom;
-
 /**
  * **TypeRequired**
  *
@@ -12115,7 +12253,7 @@ declare function getYesterday(): Iso8601Date<"explicit">;
  */
 declare function isLeapYear(val: NumberLike | Record<string, any> | Date | number): boolean;
 
-type Returns$5<T extends DefineObject, P extends readonly (keyof T & string)[]> = P["length"] extends 0 ? FromDefineObject<T> : MakeKeysOptional<T, P> extends DefineObject ? FromDefineObject<MakeKeysOptional<T, P>> : never;
+type Returns$6<T extends DefineObject, P extends readonly (keyof T & string)[]> = P["length"] extends 0 ? FromDefineObject<T> : MakeKeysOptional<T, P> extends DefineObject ? FromDefineObject<MakeKeysOptional<T, P>> : never;
 /**
  * Takes an object definition where the values are either
  * `SimpleToken` representations of a type or a `ShapeCallback`.
@@ -12123,7 +12261,7 @@ type Returns$5<T extends DefineObject, P extends readonly (keyof T & string)[]>
  * In both cases the runtime type is left unchanged but the
  * type is converted to represent the designed object shape.
  */
-declare function defineObject<T extends DefineObject, P extends readonly (keyof T & string)[]>(defn: T, ..._optProps: P): Returns$5<T, P>;
+declare function defineObject<T extends DefineObject, P extends readonly (keyof T & string)[]>(defn: T, ..._optProps: P): Returns$6<T, P>;
 
 /**
  * **entries**
@@ -12821,14 +12959,14 @@ type _Index<T extends readonly string[], IF, ELSE, Results extends readonly unkn
     ...Results,
     If<Extends<T, LowerAlphaChar>, IF, ELSE>
 ]>;
-type Returns$4<T extends string | readonly string[], IF, ELSE> = T extends string ? If<Extends<T, LowerAlphaChar>, IF, ELSE> : T extends readonly string[] ? _Index<T, IF, ELSE> : never;
+type Returns$5<T extends string | readonly string[], IF, ELSE> = T extends string ? If<Extends<T, LowerAlphaChar>, IF, ELSE> : T extends readonly string[] ? _Index<T, IF, ELSE> : never;
 /**
  * **ifLowercaseChar**(ch)
  *
  * Tests whether a passed in character is lowercase and then uses the appropriate callback to
  * mutate the value.
  */
-declare function ifLowercaseChar<T extends string, IF, ELSE>(ch: T, callbackForMatch: <V extends T>(v: V) => IF, callbackForNoMatch: <V extends T>(v: V) => ELSE): Returns$4<T, IF, ELSE>;
+declare function ifLowercaseChar<T extends string, IF, ELSE>(ch: T, callbackForMatch: <V extends T>(v: V) => IF, callbackForNoMatch: <V extends T>(v: V) => ELSE): Returns$5<T, IF, ELSE>;
 
 type Convert<T, IF, ELSE> = If<Extends<T, UpperAlphaChar>, IF, ELSE>;
 /**
@@ -12884,7 +13022,7 @@ interface GetInferenceProps<TPattern extends string> {
     typeWide: WiderTypeLiteral<TPattern>;
 }
 type GetInference<TPattern extends string> = (<T extends string>(test: T) => T extends TypeLiteral<TPattern> ? Shape<TPattern> : false | Shape<TPattern>) & GetInferenceProps<TPattern>;
-type Returns$3<T extends string> = IsDynamic<T> extends true ? GetInference<T> : never;
+type Returns$4<T extends string> = IsDynamic<T> extends true ? GetInference<T> : never;
 /**
  * **infer**`(pattern)`
  *
@@ -12904,7 +13042,7 @@ type Returns$3<T extends string> = IsDynamic<T> extends true ? GetInference<T> :
  * const {foo} = matcher("foo-bar");
  * ```
  */
-declare function infer<TTempl extends string>(inference: TTempl): Returns$3<TTempl>;
+declare function infer<TTempl extends string>(inference: TTempl): Returns$4<TTempl>;
 
 /**
  * Takes an object as input --which has an `id` property and returns it as the same
@@ -13144,14 +13282,14 @@ declare function stripBefore<TContent extends string, TBreak extends string>(con
  */
 declare function stripChars<TContent extends string, TRetain extends readonly string[]>(content: TContent, ...strip: TRetain): StripChars<TContent, TRetain[number]>;
 
-type Returns$2<T extends string | number | undefined, U extends readonly (string | number)[]> = T extends undefined ? undefined : T extends string | number ? StripLeading<T, TupleToUnion<U>> : never;
+type Returns$3<T extends string | number | undefined, U extends readonly (string | number)[]> = T extends undefined ? undefined : T extends string | number ? StripLeading<T, TupleToUnion<U>> : never;
 /**
  * **stripLeading**(content, ...strip)
  *
  * Runtime utility which strips of a leading substring from the
  * primary content if it exists and leaves content unchanged otherwise.
  */
-declare function stripLeading<T extends string | number | undefined, U extends readonly (string | number)[]>(content: T, ...strip: U): Returns$2<T, U>;
+declare function stripLeading<T extends string | number | undefined, U extends readonly (string | number)[]>(content: T, ...strip: U): Returns$3<T, U>;
 
 type StripSurroundConfigured<TStrip extends readonly (string | number)[]> = <TInput extends string | number>(input: TInput) => StripSurround<TInput, TStrip[number]>;
 /**
@@ -13171,14 +13309,14 @@ type StripSurroundConfigured<TStrip extends readonly (string | number)[]> = <TIn
  */
 declare function stripSurround<TChars extends readonly (number | string)[]>(...chars: TChars): StripSurroundConfigured<TChars>;
 
-type Returns$1<T extends string | number | undefined, U extends readonly (string | number)[]> = T extends undefined ? undefined : T extends string | number ? StripTrailing<T, TupleToUnion<U>> : never;
+type Returns$2<T extends string | number | undefined, U extends readonly (string | number)[]> = T extends undefined ? undefined : T extends string | number ? StripTrailing<T, TupleToUnion<U>> : never;
 /**
  * **stripTrailing**(content, strip)
  *
  * Runtime utility which ensures that last part of a string has substring
  * removed if it exists and that strong typing is preserved.
  */
-declare function stripTrailing<T extends string | number | undefined, U extends readonly (string | number)[]>(content: T, ...strip: U): Returns$1<T, U>;
+declare function stripTrailing<T extends string | number | undefined, U extends readonly (string | number)[]>(content: T, ...strip: U): Returns$2<T, U>;
 
 /**
  * **stripUntil**`(content, ...until)`
@@ -13947,7 +14085,7 @@ interface SortApi<O extends readonly string[]> {
     done: () => O;
 }
 type ToKeyValueSort<O extends readonly string[]> = <TCb extends SortApi<O>>(cb: TCb) => unknown;
-type Returns<T extends AnyObject, S extends ToKeyValueSort<SKeys<T>> | undefined> = S extends undefined ? ToKv<T> : S extends ToKeyValueSort<SKeys<T>> ? HandleDoneFn<ReturnType<S>> extends readonly (keyof T & string)[] ? ToKv<T, HandleDoneFn<ReturnType<S>>> : never : never;
+type Returns$1<T extends AnyObject, S extends ToKeyValueSort<SKeys<T>> | undefined> = S extends undefined ? ToKv<T> : S extends ToKeyValueSort<SKeys<T>> ? HandleDoneFn<ReturnType<S>> extends readonly (keyof T & string)[] ? ToKv<T, HandleDoneFn<ReturnType<S>>> : never : never;
 /**
  * **toKeyValue**`(obj)` -> tuple
  *
@@ -13971,7 +14109,7 @@ type Returns<T extends AnyObject, S extends ToKeyValueSort<SKeys<T>> | undefined
  */
 declare function toKeyValue<T extends {
     [key: string]: N;
-}, N extends Narrowable, S extends ToKeyValueSort<SKeys<T>> | undefined>(obj: T, sort?: S): Returns<T, S>;
+}, N extends Narrowable, S extends ToKeyValueSort<SKeys<T>> | undefined>(obj: T, sort?: S): Returns$1<T, S>;
 
 /**
  * **toNumber**(value)
@@ -14316,13 +14454,14 @@ declare function endsWith<T extends string>(endingIn: T): EndingWithTypeGuard<T>
 /**
  * A TypeGuard which was generated from `isEqual()` runtime util.
  */
-type EqualTo<T extends Narrowable> = TypeGuard<T>;
+type EqualTo<_A> = <TValue extends Narrowable>(value: TValue) => boolean;
+type Returns<TVal, TBase extends readonly Narrowable[]> = IsUnion<TVal> extends true ? TVal & TBase[number] : TVal extends TBase[number] ? TVal : IsUnion<TVal> extends true ? TVal : never;
 /**
  * **isEqual**(compareTo)(value)
  *
  * Higher order type guard to detect whether two values are equal
  */
-declare function isEqual<TBase extends Narrowable>(base: TBase): EqualTo<TBase>;
+declare function isEqual<TBase extends readonly N[], N extends Narrowable>(...base: TBase): <TVal extends Narrowable>(value: TVal) => value is Returns<TVal, TBase>;
 
 /**
  * **ifLength**(len) => (value) => boolean
@@ -14848,7 +14987,7 @@ declare function isVariable(val: unknown): val is Variable;
 
 declare function isAreaMetric(val: unknown): val is Area;
 declare function isLuminosityMetric(val: unknown): val is Luminosity;
-declare function isResistance(val: unknown): val is Resistance;
+declare function isResistanceMetric(val: unknown): val is Resistance;
 declare function isCurrentMetric(val: unknown): val is Current;
 declare function isVoltageMetric(val: unknown): val is Voltage;
 declare function isFrequencyMetric(val: unknown): val is Frequency;
@@ -14867,6 +15006,19 @@ declare function isDistanceMetric(val: unknown): val is Distance;
  * of measure).
  */
 declare function isMetric(val: unknown): val is Metric;
+type MetricTypeGuard<TCat extends readonly MetricCategory[]> = ((val: unknown) => boolean) & {
+    categories: TCat;
+    kind: "MetricTypeGuard";
+};
+/**
+ * **isMetricCategory**`(...categories) => (val) => val is Uom<T>`
+ *
+ * A higher order type guard which validates that a value is a metric
+ * with the specified category(s) UOM's.
+ *
+ * **Related:** `isMetric()`, `isAreaMetric()`, `isSpeedMetric()`, ...
+ */
+declare function isMetricCategory<TCat extends readonly [MetricCategory, ...MetricCategory[]]>(...categories: TCat): MetricTypeGuard<TCat>;
 
 declare function isAreaUom(val: unknown): val is AreaUom;
 declare function isLuminosityUom(val: unknown): val is LuminosityUom;
@@ -14887,8 +15039,25 @@ declare function isDistanceUom(val: unknown): val is DistanceUom;
 /**
  * Type guard which validates the passed in `val` is a `Uom` (unit
  * of measure).
+ *
+ * **Related:**
+ * - `isUomCategory(c)(v)`
+ * - `isSpeedUom(v)`, `isMassUom(v)`, ...
  */
 declare function isUom(val: unknown): val is Uom;
+type UomTypeGuard<TCat extends readonly MetricCategory[]> = ((val: unknown) => boolean) & {
+    categories: TCat;
+    kind: "UomTypeGuard";
+};
+/**
+ * **isUomCategory**`(...categories) => (val) => val is Uom<T>`
+ *
+ * A higher order type guard which validates that a value is of
+ * the specified metric category or categories.
+ *
+ * **Related:** `isUom()`, `isAreaUom()`, `isSpeedUom()`, ...
+ */
+declare function isUomCategory<TCat extends readonly [MetricCategory, ...MetricCategory[]]>(...categories: TCat): UomTypeGuard<TCat>;
 
 /**
  * **isIp4Address**`(val)`
@@ -15636,4 +15805,4 @@ declare function isVueRef(val: unknown): val is VueRef;
  */
 declare function asVueRef<T extends Narrowable>(value: T): VueRef<T>;
 
-export { type AsClassSelector, type AsList, type BoxValue, type BoxedFnParams, type ConfigRestApi, type CssFromDefnOption, type CssKeyframeCallback, type CssSelectorOptions, type CsvFormat, type DictionaryWithValueFilter, type DictionaryWithoutValueFilter, type DoesExtendTypeguard, type EndingWithTypeGuard, type EndpointGenerator, type EqualTo, type Finder, type FnParam, type FnParams, type GenParam, type GenParams, type GetEachOptions, type GetInference, type GetInferenceProps, type GetOptions, type Joiner, type KeyframeApi, type Mapper, type Rtn, ShapeApiImplementation, type SingletonClosure, type StartingWithTypeGuard, type StripSurroundConfigured, type SurroundWith, type ToKeyValueSort, type TokenContainerClosure, type TokenFunctionClosure, type TokenSetClosure, type TypeOfTypeGuard, type Unbox, type UndefinedArrayIsUnknown, type UnionClosure, type UrlMeta, type YouTubeMeta, addFnToProps, addPropsToFn, and, asApi, asArray, asChars, asDate, asEscapeFunction, asIsoDate, asOptionalParamFunction, asPhoneFormat, asRecord, asString, asStringLiteral, asType, asTypeToken, asVueRef, box, boxDictionaryValues, capitalize, cardType, choices, createConverter, createCssKeyframe, createCssSelector, createErrorCondition, createFifoQueue, createFixedLengthArray, createFnWithProps, createFnWithPropsExplicit, createLifoQueue, createMapper, createObjectMap, createTypeToken, cssColor, cssFromDefinition, csv, defineCss, defineObj, defineObject, defineObjectApi, defineTuple, doesExtend, endsWith, ensureLeading, ensureSurround, ensureTrailing, entries, errCondition, filter, filterEmpty, filterUndefined, find, fnMeta, fromDefineObject, fromKeyValue, get, getDaysBetween, getEach, getPhoneCountryCode, getTailwindModifiers, getToday, getTokenKind, getTomorrow, getTypeSubtype, getUrlBase, getUrlDefaultPort, getUrlDynamics, getUrlPath, getUrlPort, getUrlProtocol, getUrlQueryParams, getUrlSource, getWeekNumber, getYesterday, getYouTubePageType, handleDoneFn, hasCountryCode, hasDefaultValue, hasIndexOf, hasKeys, hasOverlappingKeys, hasProtocol, hasProtocolPrefix, hasUrlPort, hasUrlQueryParameter, hasWhiteSpace, idLiteral, idTypeGuard, identity, ifArray, ifArrayPartial, ifBoolean, ifChar, ifContainer, ifDefined, ifFalse, ifFunction, ifHasKey, ifLength, ifLowercaseChar, ifNotNull, ifNull, ifNumber, ifObject, ifSameType, ifScalar, ifString, ifTrue, ifUndefined, ifUppercaseChar, indexOf, infer, intersect, intersection, ip6GroupExpansion, ip6Prefix, isAccelerationMetric, isAccelerationUom, isAlpha, isAmazonUrl, isAmericanExpress, isApi, isApiSurface, isAppleUrl, isAreaMetric, isAreaUom, isArray, isArrayToken, isAtomicKind, isAtomicToken, isAustralianNewsUrl, isBelgiumNewsUrl, isBestBuyUrl, isBitbucketUrl, isBoolean, isBooleanLike, isBox, isCanadianNewsUrl, isChineseNewsUrl, isCodeCommitUrl, isConstant, isContainer, isContainerToken, isCostCoUrl, isCountryAbbrev, isCountryCode2, isCountryCode3, isCountryName, isCreditCard, isCssAspectRatio, isCsv, isCurrentMetric, isCurrentUom, isCvsUrl, isDanishNewsUrl, isDate, isDefineObject, isDefined, isDellUrl, isDistanceMetric, isDistanceUom, isDomainName, isDoneFn, isDutchNewsUrl, isEbayUrl, isEmail, isEmpty, isEnergyMetric, isEnergyUom, isEqual, isErrorCondition, isEscapeFunction, isEtsyUrl, isFalse, isFalsy, isFnBasedKind, isFnBasedToken, isFnWithParams, isFrenchNewsUrl, isFrequencyMetric, isFrequencyUom, isFunction, isGermanNewsUrl, isGithubIssueUrl, isGithubIssuesListUrl, isGithubOrgUrl, isGithubProjectUrl, isGithubProjectsListUrl, isGithubReleaseTagUrl, isGithubReleasesListUrl, isGithubRepoReleaseTagUrl, isGithubRepoReleasesUrl, isGithubRepoUrl, isGithubUrl, isHexadecimal, isHmUrl, isHomeDepotUrl, isHtmlElement, isIkeaUrl, isIndexable, isIndianNewsUrl, isInlineSvg, isIp4Address, isIp6Address, isIpAddress, isIso3166Alpha2, isIso3166Alpha3, isIso3166CountryCode, isIso3166CountryName, isIsoDate, isIsoDateTime, isIsoExplicitDate, isIsoExplicitTime, isIsoImplicitDate, isIsoImplicitTime, isIsoTime, isIsoYear, isItalianNewsUrl, isJapaneseNewsUrl, isKrogersUrl, isLeapYear, isLength, isLikeRegExp, isLowesUrl, isLuminosityMetric, isLuminosityUom, isLuxonDateTime, isMacysUrl, isMap, isMapToken, isMassMetric, isMassUom, isMastercard, isMetric, isMexicanNewsUrl, isMoment, isNarrowableObject, isNever, isNewsUrl, isNikeUrl, isNorwegianNewsUrl, isNotEmpty, isNotNull, isNothing, isNull, isNumber, isNumberLike, isNumericArray, isNumericString, isObject, isObjectToken, isOptionalParamFunction, isPhoneNumber, isPowerMetric, isPowerUom, isPressureMetric, isPressureUom, isProtocol, isProtocolPrefix, isReadonlyArray, isRecordToken, isRef, isRegExp, isRepoSource, isRepoUrl, isResistance, isResistanceUom, isRetailUrl, isSameTypeOf, isScalar, isSemanticVersion, isSet, isSetBasedKind, isSetBasedToken, isSetContainer, isSetToken, isShape, isShapeCallback, isSimpleContainerToken, isSimpleContainerTokenTuple, isSimpleScalarToken, isSimpleScalarTokenTuple, isSimpleToken, isSimpleTokenTuple, isSingletonKind, isSingletonToken, isSocialMediaProfileUrl, isSocialMediaUrl, isSouthKoreanNewsUrl, isSpanishNewsUrl, isSpecificConstant, isSpeedMetric, isSpeedUom, isString, isStringArray, isSwissNewsUrl, isSymbol, isTailwindColor, isTailwindColorClass, isTailwindColorName, isTailwindColorTarget, isTailwindColorWithLuminosity, isTailwindColorWithLuminosityAndOpacity, isTailwindModifier, isTargetUrl, isTemperatureMetric, isTemperatureUom, isThenable, isThisMonth, isThisWeek, isThisYear, isTimeMetric, isTimeUom, isToday, isTomorrow, isTrimable, isTrue, isTruthy, isTuple, isTupleToken, isTurkishNewsUrl, isTypeOf, isTypeSubtype, isTypeToken, isTypeTokenKind, isTypeTuple, isUkNewsUrl, isUndefined, isUnset, isUom, isUri, isUrl, isUrlPath, isUrlSource, isUsNewsUrl, isUsPhoneNumber, isUsStateAbbreviation, isUsStateName, isVariable, isVisa, isVisaMastercard, isVoltageMetric, isVoltageUom, isVolumeMetric, isVolumeUom, isVueRef, isWalgreensUrl, isWalmartUrl, isWayfairUrl, isWholeFoodsUrl, isYesterday, isYouTubeCreatorUrl, isYouTubeFeedHistoryUrl, isYouTubeFeedUrl, isYouTubePlaylistUrl, isYouTubePlaylistsUrl, isYouTubeShareUrl, isYouTubeSubscriptionsUrl, isYouTubeTrendingUrl, isYouTubeUrl, isYouTubeVideoUrl, isYouTubeVideosInPlaylist, isZaraUrl, isZipCode, isZipCode5, isZipPlus4, joinWith, jsonValue, jsonValues, keysOf, kindLiteral, last, list, literal, logicalReturns, lookupCountryAlpha2, lookupCountryAlpha3, lookupCountryCode, lookupCountryName, lowercase, maybePhoneNumber, mergeObjects, mergeScalars, mergeTuples, nameLiteral, narrow, narrowObjectTo, narrowObjectToType, never, objectToApi, objectValues, omit, optional, optionalOrNull, or, orNull, pathJoin, pluralize, removePhoneCountryCode, removeTailwindModifiers, removeUrlProtocol, result, retain, retainAfter, retainAfterInclusive, retainChars, retainUntil, retainUntilInclusive, retainWhile, reverse, rightWhitespace, shape, sharedKeys, shift, simpleContainerToken, simpleContainerTokenToTypeToken, simpleContainerType, simpleScalarToken, simpleScalarTokenToTypeToken, simpleScalarType, simpleToken, simpleType, simpleUnionTokenToTypeToken, slice, split, startsWith, stripAfter, stripBefore, stripChars, stripLeading, stripParenthesis, stripSurround, stripTrailing, stripUntil, stripWhile, surround, takeNumericCharacters, takeProp, toCamelCase, toKebabCase, toKeyValue, toNumber, toNumericArray, toPascalCase, toSnakeCase, toString, toUppercase, trim, trimEnd, trimLeft, trimRight, trimStart, truncate, tuple, twColor, unbox, uncapitalize, union, unionize, unique, uniqueKeys, unset, uppercase, urlMeta, valuesOf, widen, withDefaults, withKeys, withValue, withoutKeys, withoutValue, wrapFn, youtubeEmbed, youtubeMeta };
+export { type AsClassSelector, type AsList, type BoxValue, type BoxedFnParams, type ConfigRestApi, type CssFromDefnOption, type CssKeyframeCallback, type CssSelectorOptions, type CsvFormat, type DictionaryWithValueFilter, type DictionaryWithoutValueFilter, type DoesExtendTypeguard, type EndingWithTypeGuard, type EndpointGenerator, type EqualTo, type Finder, type FnParam, type FnParams, type GenParam, type GenParams, type GetEachOptions, type GetInference, type GetInferenceProps, type GetOptions, type Joiner, type KeyframeApi, type Mapper, type MetricTypeGuard, type Rtn, ShapeApiImplementation, type SingletonClosure, type StartingWithTypeGuard, type StripSurroundConfigured, type SurroundWith, type ToKeyValueSort, type TokenContainerClosure, type TokenFunctionClosure, type TokenSetClosure, type TypeOfTypeGuard, type Unbox, type UndefinedArrayIsUnknown, type UnionClosure, type UomTypeGuard, type UrlMeta, type YouTubeMeta, addFnToProps, addPropsToFn, and, asApi, asArray, asChars, asDate, asEscapeFunction, asIsoDate, asOptionalParamFunction, asPhoneFormat, asRecord, asString, asStringLiteral, asType, asTypeToken, asVueRef, box, boxDictionaryValues, capitalize, cardType, choices, createConverter, createCssKeyframe, createCssSelector, createErrorCondition, createFifoQueue, createFixedLengthArray, createFnWithProps, createFnWithPropsExplicit, createLifoQueue, createMapper, createObjectMap, createTypeToken, cssColor, cssFromDefinition, csv, defineCss, defineObj, defineObject, defineObjectApi, defineTuple, doesExtend, endsWith, ensureLeading, ensureSurround, ensureTrailing, entries, errCondition, filter, filterEmpty, filterUndefined, find, fnMeta, fromDefineObject, fromKeyValue, get, getDaysBetween, getEach, getPhoneCountryCode, getTailwindModifiers, getToday, getTokenKind, getTomorrow, getTypeSubtype, getUrlBase, getUrlDefaultPort, getUrlDynamics, getUrlPath, getUrlPort, getUrlProtocol, getUrlQueryParams, getUrlSource, getWeekNumber, getYesterday, getYouTubePageType, handleDoneFn, hasCountryCode, hasDefaultValue, hasIndexOf, hasKeys, hasOverlappingKeys, hasProtocol, hasProtocolPrefix, hasUrlPort, hasUrlQueryParameter, hasWhiteSpace, idLiteral, idTypeGuard, identity, ifArray, ifArrayPartial, ifBoolean, ifChar, ifContainer, ifDefined, ifFalse, ifFunction, ifHasKey, ifLength, ifLowercaseChar, ifNotNull, ifNull, ifNumber, ifObject, ifSameType, ifScalar, ifString, ifTrue, ifUndefined, ifUppercaseChar, indexOf, infer, intersect, intersection, ip6GroupExpansion, ip6Prefix, isAccelerationMetric, isAccelerationUom, isAlpha, isAmazonUrl, isAmericanExpress, isApi, isApiSurface, isAppleUrl, isAreaMetric, isAreaUom, isArray, isArrayToken, isAtomicKind, isAtomicToken, isAustralianNewsUrl, isBelgiumNewsUrl, isBestBuyUrl, isBitbucketUrl, isBoolean, isBooleanLike, isBox, isCanadianNewsUrl, isChineseNewsUrl, isCodeCommitUrl, isConstant, isContainer, isContainerToken, isCostCoUrl, isCountryAbbrev, isCountryCode2, isCountryCode3, isCountryName, isCreditCard, isCssAspectRatio, isCsv, isCurrentMetric, isCurrentUom, isCvsUrl, isDanishNewsUrl, isDate, isDefineObject, isDefined, isDellUrl, isDistanceMetric, isDistanceUom, isDomainName, isDoneFn, isDutchNewsUrl, isEbayUrl, isEmail, isEmpty, isEnergyMetric, isEnergyUom, isEqual, isErrorCondition, isEscapeFunction, isEtsyUrl, isFalse, isFalsy, isFnBasedKind, isFnBasedToken, isFnWithParams, isFrenchNewsUrl, isFrequencyMetric, isFrequencyUom, isFunction, isGermanNewsUrl, isGithubIssueUrl, isGithubIssuesListUrl, isGithubOrgUrl, isGithubProjectUrl, isGithubProjectsListUrl, isGithubReleaseTagUrl, isGithubReleasesListUrl, isGithubRepoReleaseTagUrl, isGithubRepoReleasesUrl, isGithubRepoUrl, isGithubUrl, isHexadecimal, isHmUrl, isHomeDepotUrl, isHtmlElement, isIkeaUrl, isIndexable, isIndianNewsUrl, isInlineSvg, isIp4Address, isIp6Address, isIpAddress, isIso3166Alpha2, isIso3166Alpha3, isIso3166CountryCode, isIso3166CountryName, isIsoDate, isIsoDateTime, isIsoExplicitDate, isIsoExplicitTime, isIsoImplicitDate, isIsoImplicitTime, isIsoTime, isIsoYear, isItalianNewsUrl, isJapaneseNewsUrl, isKrogersUrl, isLeapYear, isLength, isLikeRegExp, isLowesUrl, isLuminosityMetric, isLuminosityUom, isLuxonDateTime, isMacysUrl, isMap, isMapToken, isMassMetric, isMassUom, isMastercard, isMetric, isMetricCategory, isMexicanNewsUrl, isMoment, isNarrowableObject, isNever, isNewsUrl, isNikeUrl, isNorwegianNewsUrl, isNotEmpty, isNotNull, isNothing, isNull, isNumber, isNumberLike, isNumericArray, isNumericString, isObject, isObjectToken, isOptionalParamFunction, isPhoneNumber, isPowerMetric, isPowerUom, isPressureMetric, isPressureUom, isProtocol, isProtocolPrefix, isReadonlyArray, isRecordToken, isRef, isRegExp, isRepoSource, isRepoUrl, isResistanceMetric, isResistanceUom, isRetailUrl, isSameTypeOf, isScalar, isSemanticVersion, isSet, isSetBasedKind, isSetBasedToken, isSetContainer, isSetToken, isShape, isShapeCallback, isSimpleContainerToken, isSimpleContainerTokenTuple, isSimpleScalarToken, isSimpleScalarTokenTuple, isSimpleToken, isSimpleTokenTuple, isSingletonKind, isSingletonToken, isSocialMediaProfileUrl, isSocialMediaUrl, isSouthKoreanNewsUrl, isSpanishNewsUrl, isSpecificConstant, isSpeedMetric, isSpeedUom, isString, isStringArray, isSwissNewsUrl, isSymbol, isTailwindColor, isTailwindColorClass, isTailwindColorName, isTailwindColorTarget, isTailwindColorWithLuminosity, isTailwindColorWithLuminosityAndOpacity, isTailwindModifier, isTargetUrl, isTemperatureMetric, isTemperatureUom, isThenable, isThisMonth, isThisWeek, isThisYear, isTimeMetric, isTimeUom, isToday, isTomorrow, isTrimable, isTrue, isTruthy, isTuple, isTupleToken, isTurkishNewsUrl, isTypeOf, isTypeSubtype, isTypeToken, isTypeTokenKind, isTypeTuple, isUkNewsUrl, isUndefined, isUnset, isUom, isUomCategory, isUri, isUrl, isUrlPath, isUrlSource, isUsNewsUrl, isUsPhoneNumber, isUsStateAbbreviation, isUsStateName, isVariable, isVisa, isVisaMastercard, isVoltageMetric, isVoltageUom, isVolumeMetric, isVolumeUom, isVueRef, isWalgreensUrl, isWalmartUrl, isWayfairUrl, isWholeFoodsUrl, isYesterday, isYouTubeCreatorUrl, isYouTubeFeedHistoryUrl, isYouTubeFeedUrl, isYouTubePlaylistUrl, isYouTubePlaylistsUrl, isYouTubeShareUrl, isYouTubeSubscriptionsUrl, isYouTubeTrendingUrl, isYouTubeUrl, isYouTubeVideoUrl, isYouTubeVideosInPlaylist, isZaraUrl, isZipCode, isZipCode5, isZipPlus4, joinWith, jsonValue, jsonValues, keysOf, kindLiteral, last, list, literal, logicalReturns, lookupCountryAlpha2, lookupCountryAlpha3, lookupCountryCode, lookupCountryName, lowercase, maybePhoneNumber, mergeObjects, mergeScalars, mergeTuples, nameLiteral, narrow, narrowObjectTo, narrowObjectToType, never, objectToApi, objectValues, omit, optional, optionalOrNull, or, orNull, pathJoin, pluralize, removePhoneCountryCode, removeTailwindModifiers, removeUrlProtocol, result, retain, retainAfter, retainAfterInclusive, retainChars, retainUntil, retainUntilInclusive, retainWhile, reverse, rightWhitespace, shape, sharedKeys, shift, simpleContainerToken, simpleContainerTokenToTypeToken, simpleContainerType, simpleScalarToken, simpleScalarTokenToTypeToken, simpleScalarType, simpleToken, simpleType, simpleUnionTokenToTypeToken, slice, split, startsWith, stripAfter, stripBefore, stripChars, stripLeading, stripParenthesis, stripSurround, stripTrailing, stripUntil, stripWhile, surround, takeNumericCharacters, takeProp, toCamelCase, toKebabCase, toKeyValue, toNumber, toNumericArray, toPascalCase, toSnakeCase, toString, toUppercase, trim, trimEnd, trimLeft, trimRight, trimStart, truncate, tuple, twColor, unbox, uncapitalize, union, unionize, unique, uniqueKeys, unset, uppercase, urlMeta, valuesOf, widen, withDefaults, withKeys, withValue, withoutKeys, withoutValue, wrapFn, youtubeEmbed, youtubeMeta };

package/modules/runtime/dist/index.js

@@ -3334,8 +3334,13 @@ function endsWith(endingIn2) {
 }
 
 // src/type-guards/higher-order/isEqual.ts
-function isEqual(base) {
-  return (value) => isSameTypeOf(base)(value) ? value === base : false;
+function compare(base) {
+  return (value) => {
+    return base.includes(value);
+  };
+}
+function isEqual(...base) {
+  return compare(base);
 }
 
 // src/type-guards/higher-order/isLength.ts
@@ -3345,8 +3350,8 @@ function isLength(value, len) {
 
 // src/type-guards/higher-order/isSameTypeOf.ts
 function isSameTypeOf(base) {
-  return (compare) => {
-    return typeof base === typeof compare;
+  return (compare2) => {
+    return typeof base === typeof compare2;
   };
 }
 
@@ -3683,58 +3688,107 @@ function isVariable(val) {
 function separate(s) {
   return stripWhile(s.toLowerCase(), ...NUMERIC_CHAR).trim();
 }
+function startsWithNumber(val) {
+  return isString(val) && isNumberLike(val.slice(0, 1));
+}
 function isAreaMetric(val) {
-  return isString(val) && AREA_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && AREA_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isLuminosityMetric(val) {
-  return isString(val) && LUMINOSITY_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && LUMINOSITY_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
-function isResistance(val) {
-  return isString(val) && RESISTANCE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+function isResistanceMetric(val) {
+  return isString(val) && startsWithNumber(val) && RESISTANCE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isCurrentMetric(val) {
-  return isString(val) && CURRENT_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && CURRENT_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isVoltageMetric(val) {
-  return isString(val) && VOLTAGE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && VOLTAGE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isFrequencyMetric(val) {
-  return isString(val) && FREQUENCY_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && FREQUENCY_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isPowerMetric(val) {
-  return isString(val) && POWER_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && POWER_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isTimeMetric(val) {
-  return isString(val) && TIME_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && TIME_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isEnergyMetric(val) {
-  return isString(val) && ENERGY_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && ENERGY_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isPressureMetric(val) {
-  return isString(val) && PRESSURE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && PRESSURE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isTemperatureMetric(val) {
-  return isString(val) && TEMPERATURE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && TEMPERATURE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isVolumeMetric(val) {
-  return isString(val) && VOLUME_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && VOLUME_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isAccelerationMetric(val) {
-  return isString(val) && ACCELERATION_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && ACCELERATION_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isSpeedMetric(val) {
   const speed = SPEED_METRICS_LOOKUP.map((i) => i.abbrev);
-  return isString(val) && speed.includes(separate(val));
+  return isString(val) && startsWithNumber(val) && speed.includes(separate(val));
 }
 function isMassMetric(val) {
-  return isString(val) && MASS_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && MASS_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isDistanceMetric(val) {
-  return isString(val) && DISTANCE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
+  return isString(val) && startsWithNumber(val) && DISTANCE_METRICS_LOOKUP.map((i) => i.abbrev).includes(separate(val));
 }
 function isMetric(val) {
   return isDistanceMetric(val) || isMassMetric(val) || isSpeedMetric(val) || isAccelerationMetric(val) || isVoltageMetric(val) || isTemperatureMetric(val) || isPressureMetric(val) || isEnergyMetric(val) || isTimeMetric(val) || isPowerMetric(val) || isFrequencyMetric(val) || isVoltageMetric(val) || isCurrentMetric(val) || isLuminosityMetric(val) || isAreaMetric(val);
 }
+function getCategories(c) {
+  return c.map(
+    (i) => {
+      switch (i) {
+        case "Acceleration":
+          return isAccelerationMetric;
+        case "Area":
+          return isAreaMetric;
+        case "Current":
+          return isCurrentMetric;
+        case "Distance":
+          return isDistanceMetric;
+        case "Frequency":
+          return isFrequencyMetric;
+        case "Luminosity":
+          return isLuminosityMetric;
+        case "Mass":
+          return isMassMetric;
+        case "Power":
+          return isPowerMetric;
+        case "Pressure":
+          return isPressureMetric;
+        case "Resistance":
+          return isResistanceMetric;
+        case "Speed":
+          return isSpeedMetric;
+        case "Temperature":
+          return isTemperatureMetric;
+        case "Time":
+          return isTimeMetric;
+        case "Voltage":
+          return isVoltageMetric;
+        case "Volume":
+          return isVoltageMetric;
+      }
+    }
+  );
+}
+function isMetricCategory(...categories) {
+  const fn2 = (val) => {
+    const tests = getCategories(categories);
+    return tests.some((i) => i(val));
+  };
+  const props = { categories, kind: "MetricTypeGuard" };
+  return createFnWithProps(fn2, props);
+}
 
 // src/type-guards/metrics/isUom.ts
 function isAreaUom(val) {
@@ -3788,6 +3842,52 @@ function isDistanceUom(val) {
 function isUom(val) {
   return isDistanceUom(val) || isMassUom(val) || isSpeedUom(val) || isAccelerationUom(val) || isVoltageUom(val) || isTemperatureUom(val) || isPressureUom(val) || isEnergyUom(val) || isTimeUom(val) || isPowerUom(val) || isFrequencyUom(val) || isVoltageUom(val) || isCurrentUom(val) || isLuminosityUom(val) || isAreaUom(val);
 }
+function getCategories2(c) {
+  return c.map(
+    (i) => {
+      switch (i) {
+        case "Acceleration":
+          return isAccelerationUom;
+        case "Area":
+          return isAreaUom;
+        case "Current":
+          return isCurrentUom;
+        case "Distance":
+          return isDistanceUom;
+        case "Frequency":
+          return isFrequencyUom;
+        case "Luminosity":
+          return isLuminosityUom;
+        case "Mass":
+          return isMassUom;
+        case "Power":
+          return isPowerUom;
+        case "Pressure":
+          return isPressureUom;
+        case "Resistance":
+          return isResistanceUom;
+        case "Speed":
+          return isSpeedUom;
+        case "Temperature":
+          return isTemperatureUom;
+        case "Time":
+          return isTimeUom;
+        case "Voltage":
+          return isVoltageUom;
+        case "Volume":
+          return isVoltageUom;
+      }
+    }
+  );
+}
+function isUomCategory(...categories) {
+  const fn2 = (val) => {
+    const tests = getCategories2(categories);
+    return tests.some((i) => i(val));
+  };
+  const prop = { categories, kind: "UomTypeGuard" };
+  return createFnWithProps(fn2, prop);
+}
 
 // src/type-guards/network-tg.ts
 function isIp4Address(val) {
@@ -5896,6 +5996,7 @@ export {
   isMassUom,
   isMastercard,
   isMetric,
+  isMetricCategory,
   isMexicanNewsUrl,
   isMoment,
   isNarrowableObject,
@@ -5927,7 +6028,7 @@ export {
   isRegExp,
   isRepoSource,
   isRepoUrl,
-  isResistance,
+  isResistanceMetric,
   isResistanceUom,
   isRetailUrl,
   isSameTypeOf,
@@ -5992,6 +6093,7 @@ export {
   isUndefined,
   isUnset,
   isUom,
+  isUomCategory,
   isUri,
   isUrl,
   isUrlPath,