inferred-types 0.55.18 → 0.55.19

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

@@ -281,6 +281,15 @@ declare const US_STATE_LOOKUP: readonly [{
     readonly abbrev: "GU";
 }];
 
+/**
+ * An array of all valid HTML tags that have both opening and closing tags.
+ */
+declare const HTML_BLOCK_TAGS: readonly ["a", "abbr", "address", "article", "aside", "b", "bdi", "bdo", "blockquote", "body", "button", "canvas", "caption", "cite", "code", "colgroup", "data", "datalist", "dd", "del", "details", "dfn", "dialog", "div", "dl", "dt", "em", "fieldset", "figcaption", "figure", "footer", "form", "h1", "h2", "h3", "h4", "h5", "h6", "head", "header", "html", "i", "iframe", "ins", "kbd", "label", "legend", "li", "main", "map", "mark", "menu", "meter", "nav", "noscript", "object", "ol", "optgroup", "option", "output", "p", "picture", "pre", "progress", "q", "rp", "rt", "ruby", "s", "samp", "script", "section", "select", "small", "span", "strong", "style", "sub", "summary", "sup", "svg", "table", "tbody", "td", "template", "textarea", "tfoot", "th", "thead", "time", "title", "tr", "u", "ul", "var", "video"];
+/**
+ * An array of all valid HTML tags that are self-closing (do not have closing tags).
+ */
+declare const HTML_ATOMIC_TAGS: readonly ["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"];
+
 /**
  * All country codes (name, alpha-2, country-code)
  */
@@ -4503,6 +4512,15 @@ type _Validate<T extends object> = "value" extends keyof T ? true : false;
  */
 type IsVueRef<T> = T extends object ? If<IsEqual<_Len<T>, 0>, false, Retain<_Keys$6<T>, string>["length"] extends 1 ? _Validate<T> : false> : false;
 
+/**
+ * **IsWideString**`<T>`
+ *
+ * Boolean operator which returns `true` when a _wide_ string
+ * is passed in as `T`. It reports `false` on all other values
+ * including _literal strings_.
+ */
+type IsWideString<T> = IsEqual<T, string>;
+
 /**
  * **IsWideScalar**`<T>`
  *
@@ -6949,6 +6967,52 @@ type GenList<TContainer, IsRoot extends boolean = true, K extends keyof TContain
  */
 type DotPathFor<TContainer> = TContainer extends Container ? "" | GenList<TContainer, true> : "";
 
+/**
+ * a valid HTML "block tag" (aka, a tag which requires
+ * an openning and closing tag pair to be valid HTML)
+ */
+type Html__BlockTag = typeof HTML_BLOCK_TAGS[number];
+/**
+ * a valid HTML "atomic tag" (aka, a tag which does
+ * NOT have a closing tag)
+ */
+type Html__AtomicTag = typeof HTML_ATOMIC_TAGS[number];
+/**
+ * A union of valid _openning_ HTML Block Tags.
+ *
+ * - You can use the generic `T` to isolate down to a subset
+ */
+type HtmlTagOpen<T extends Html__BlockTag = Html__BlockTag> = `<${T}${string}>`;
+/**
+ * A union of valid _closing_ HTML Block Tags.
+ *
+ * - You can use the generic `T` to isolate down to a subset
+ */
+type HtmlTagClose<T extends Html__BlockTag = Html__BlockTag> = `</${T}>`;
+/**
+ * A union type of valid _atomic_ tags.
+ *
+ * - you can use the generic `T` to isolate down to a subset
+ * of Atomic Tags
+ */
+type HtmlTagAtomic<T extends Html__AtomicTag = Html__AtomicTag> = `<${T}${string}>`;
+/**
+ * Allows for any valid HTML tag: openning, closing and atomic.
+ */
+type HtmlTag = HtmlTagOpen | HtmlTagClose | HtmlTagAtomic;
+/**
+ * A narrowing utility which takes an input and ensures it's type
+ * is within the _scope_ of the tags provided in `TScope`.
+ */
+type AsHtmlTag<TInput, TScope extends Html__AtomicTag | Html__BlockTag> = TInput extends HtmlTagAtomic ? TInput : TInput extends HtmlTagOpen ? TInput : TInput extends HtmlTagClose ? TInput : TInput extends `</${string}>` ? HtmlTagClose<Exclude<TScope, Html__AtomicTag>> : TInput extends `<${string}` ? HtmlTagOpen<Exclude<TScope, Html__AtomicTag>> | HtmlTagAtomic extends TInput ? HtmlTagOpen<Exclude<TScope, Html__AtomicTag>> | HtmlTagAtomic : never : IsWideString<TInput> extends true ? HtmlTag : never;
+/**
+ * **AsHtmlComponentTag**`<T>`
+ *
+ * A type utility that narrows the input type to valid HTML component tags
+ * (`kebab-case` or `PascalCase`) and ensures valid attributes.
+ */
+type AsHtmlComponentTag<T> = T extends `<${infer Name} ${infer Attr}/>` ? T & (`<${PascalCase<Name>} ${Attr}/>` | `<${KebabCase<Name>} ${Attr}/>`) : T extends `<${infer Name} ${infer Attr}>` ? T & (`<${PascalCase<Name>} ${Attr}>` | `<${KebabCase<Name>} ${Attr}>`) : T extends `<${infer Name}/>` ? T & (`<${PascalCase<Name>}/>` | `<${KebabCase<Name>}/>`) : T extends `<${infer Name}>` ? T & (`<${PascalCase<Name>}` | `<${KebabCase<Name>}`) : T extends string ? IsWideString<T> extends true ? T & `<${PascalCase<StripSurround<T, "<" | ">">>}${string}>` : never : never;
+
 /**
  * **InlineSvg**`<[T]>`
  *
@@ -14530,6 +14594,16 @@ type StartingWithTypeGuard<TStartsWith extends string> = <TValue extends Narrowa
  */
 declare function startsWith<TStartsWith extends string>(startingWith: TStartsWith): StartingWithTypeGuard<TStartsWith>;
 
+/**
+ * **isHtmlComponentTag**`(...names)`
+ *
+ * A type guard that validates if a value matches a valid HTML component tag.
+ * Supports both `kebab-case` and `PascalCase` component names.
+ *
+ * Attributes are validated using `areAttributesValid()`.
+ */
+declare function isHtmlComponentTag<T extends readonly string[]>(...names: T): <V>(val: V) => val is V & AsHtmlComponentTag<T[number]>;
+
 /**
  * Tests whether the passed in `val` contains some HTML-like tags in it.
  *
@@ -14545,15 +14619,31 @@ declare function hasHtml(val: unknown): val is string;
 declare function hasValidHtml(val: unknown): val is string;
 
 /**
- * tests whether the `val` passed in is the name of a valid
+ * tests whether the `val` passed in is the **name** of a valid
  * HTML block tag (e.g., "div", "span", etc.)
+ *
+ * **Note:** this will _not_ match with leading or trailing whitespace
  */
 declare function isValidBlockTag(val: unknown): val is string;
 /**
- * test whetehr the `val` pass in is a the name of a valid HTML
+ * test whetehr the `val` pass in is a the **name** of a valid HTML
  * atomic tag (e.g., "br", "meta", etc.)
+ *
+ * **Note:** this will _not_ match with leading or trailing whitespace
  */
 declare function isValidAtomicTag(val: unknown): val is string;
+/**
+ * **isValidHtmlTag**`(...tags)(val)`
+ *
+ * A higher order type guard which tests that the `val` passed in
+ * is a valid HTML tag (block or atomic) or the types specified.
+ *
+ * - if it's an openning or atomic tag then the tag name is validated
+ * but so are the characters between the tag name and the close.
+ * - if it's a closing tag then NO characters are allowed beyond
+ * that of the tag and the brackets.
+ */
+declare function isValidHtmlTag<T extends readonly (Html__BlockTag | Html__AtomicTag)[]>(...tags: T): <V>(val: V) => val is V & AsHtmlTag<V, T[number]>;
 
 /**
  * **isHtml**`(val)`
@@ -14582,6 +14672,12 @@ declare function isValidHtml(val: unknown): val is string;
  */
 declare function isHtmlElement(val: unknown): val is HTMLElement;
 
+/**
+ * type guard which validates that `val` is a string which could represent
+ * the attributes in an HTML tag.
+ */
+declare function validHtmlAttributes(val: unknown): val is string;
+
 /**
  * **isAlpha**(value)
  *
@@ -15850,4 +15946,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 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, hasHtml, hasIndexOf, hasKeys, hasOverlappingKeys, hasProtocol, hasProtocolPrefix, hasUrlPort, hasUrlQueryParameter, hasValidHtml, 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, isHtml, 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, isValidAtomicTag, isValidBlockTag, isValidHtml, 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, hasHtml, hasIndexOf, hasKeys, hasOverlappingKeys, hasProtocol, hasProtocolPrefix, hasUrlPort, hasUrlQueryParameter, hasValidHtml, 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, isHtml, isHtmlComponentTag, 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, isValidAtomicTag, isValidBlockTag, isValidHtml, isValidHtmlTag, 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, validHtmlAttributes, valuesOf, widen, withDefaults, withKeys, withValue, withoutKeys, withoutValue, wrapFn, youtubeEmbed, youtubeMeta };

package/modules/runtime/dist/index.js

@@ -3491,6 +3491,36 @@ function startsWith(startingWith) {
   };
 }
 
+// src/type-guards/html/component-tags.ts
+function isHtmlComponentTag(...names) {
+  return (val) => {
+    if (typeof val !== "string")
+      return false;
+    const trimmedVal = val.trim();
+    const tagRegex = /^<\/?([\w-]+)(.*?)>$/;
+    const match = tagRegex.exec(trimmedVal);
+    if (!match) {
+      return false;
+    }
+    const [, tagName, attributes] = match;
+    const isClosingTag = trimmedVal.startsWith("</");
+    const isKebabCase = /^[a-z][a-z0-9-]*$/.test(tagName);
+    const isPascalCase = /^[A-Z][a-zA-Z0-9]*$/.test(tagName);
+    const normalizedKebabCase = toKebabCase(tagName);
+    const normalizedPascalCase = toPascalCase(tagName);
+    const isValidName = names.some(
+      (name) => isKebabCase && normalizedKebabCase === toKebabCase(name) || isPascalCase && normalizedPascalCase === toPascalCase(name)
+    );
+    if (!isValidName) {
+      return false;
+    }
+    if (isClosingTag) {
+      return attributes.trim() === "";
+    }
+    return validHtmlAttributes(attributes);
+  };
+}
+
 // src/type-guards/html/hasHtml.ts
 function hasHtml(val) {
   if (typeof val !== "string")
@@ -3537,6 +3567,39 @@ function isValidBlockTag(val) {
 function isValidAtomicTag(val) {
   return isString(val) && HTML_ATOMIC_TAGS.includes(val.toLowerCase());
 }
+function isValidHtmlTag(...tags) {
+  return (val) => {
+    if (typeof val !== "string")
+      return false;
+    const trimmedVal = val.trim();
+    const tagRegex = /^<\/?(\w+)(.*?)>$/;
+    const match = tagRegex.exec(trimmedVal);
+    if (!match) {
+      return false;
+    }
+    const [, tagName, attributes] = match;
+    const normalizedTagName = tagName.toLowerCase();
+    const isClosingTag = trimmedVal.startsWith("</");
+    const isAtomicTag = HTML_ATOMIC_TAGS.includes(normalizedTagName);
+    const isBlockTag = HTML_BLOCK_TAGS.includes(normalizedTagName);
+    if (
+      // Validate tag name is within the provided `tags` scope
+      !tags.map((t) => t.toLowerCase()).includes(normalizedTagName)
+    ) {
+      return false;
+    }
+    if (isClosingTag) {
+      return attributes.trim() === "" && !isAtomicTag;
+    }
+    if (isAtomicTag) {
+      return attributes.trim() === "" || validHtmlAttributes(attributes);
+    }
+    if (isBlockTag) {
+      return validHtmlAttributes(attributes);
+    }
+    return false;
+  };
+}
 
 // src/type-guards/html/isHtml.ts
 function isHtml(val) {
@@ -3584,6 +3647,16 @@ function isHtmlElement(val) {
   return isObject(val) && "attributes" in val && "firstElementChild" in val && "innerHTML" in val;
 }
 
+// src/type-guards/html/validHtmlAttributes.ts
+function validHtmlAttributes(val) {
+  if (typeof val !== "string")
+    return false;
+  const quoteRegex = /["']/g;
+  const unmatchedQuotes = (val.match(quoteRegex)?.length || 0) % 2 !== 0;
+  const invalidAssignment = /(\w+=)(?=\s|>|$)/.test(val);
+  return !val.includes(">") && !unmatchedQuotes && !invalidAssignment;
+}
+
 // src/type-guards/isAlpha.ts
 function isAlpha(value) {
   return isString(value) && split(value).every((v) => ALPHA_CHARS.includes(v));
@@ -6164,6 +6237,7 @@ export {
   isHmUrl,
   isHomeDepotUrl,
   isHtml,
+  isHtmlComponentTag,
   isHtmlElement,
   isIkeaUrl,
   isIndexable,
@@ -6310,6 +6384,7 @@ export {
   isValidAtomicTag,
   isValidBlockTag,
   isValidHtml,
+  isValidHtmlTag,
   isVariable,
   isVisa,
   isVisaMastercard,
@@ -6436,6 +6511,7 @@ export {
   unset,
   uppercase,
   urlMeta,
+  validHtmlAttributes,
   valuesOf,
   widen,
   withDefaults,