radiant-docs-validator 0.1.12 → 0.1.14

package/dist/index.d.ts

@@ -215,4 +215,8 @@ type IconValidationContext = {
 declare function validateRadiantComponentProps(componentName: string, props: Record<string, unknown>, options: RadiantComponentValidationOptions): void;
 declare function validateRadiantComponentNode(node: MdxJsxElementNode, options: RadiantComponentValidationOptions): void;
 
-export { type AssistantButtonConfig, type AssistantButtonSize, type AssistantConfig, type AssistantIcon, type AssistantNavbarButtonConfig, BASE_COLOR_OPTIONS, type BaseColorByMode, type BaseColorOption, type CardButtonTheme, type CardCoverTheme, type CardTheme, type CodeSyntaxThemeConfig, type CodeTheme, DEFAULT_THEME_COLOR_DARK, DEFAULT_THEME_COLOR_LIGHT, type DocsConfig, type DocsHrefResolution, type DocsTheme, type DocsValidatorOptions, type Footer, type FooterLink, type HiddenPageRoute, type IconValidationContext, type Logo, type LogoVariant, type NavGroup, type NavMenu, type NavMenuItem, type NavOpenApi, type NavOpenApiPage, type NavOpenApiPageRef, type NavPage, type NavTag, type NavbarItem, type NavigationItem, PUBLISHABLE_STATIC_ASSET_EXTENSIONS, type RadiantComponentValidationOptions, type SocialPlatform, type TagTheme, type ThemeColorByMode, configureDocsValidator, getConfig, isPublishableStaticAssetPath, loadOpenApiSpec, resolveDocsHref, resolveDocsPageHref, validateMdxContent, validateRadiantComponentNode, validateRadiantComponentProps };
+declare const HEX_COLOR_PATTERN: RegExp;
+declare function normalizeHexColorValue(value: string): string | null;
+declare function isValidHexColor(value: unknown): value is string;
+
+export { type AssistantButtonConfig, type AssistantButtonSize, type AssistantConfig, type AssistantIcon, type AssistantNavbarButtonConfig, BASE_COLOR_OPTIONS, type BaseColorByMode, type BaseColorOption, type CardButtonTheme, type CardCoverTheme, type CardTheme, type CodeSyntaxThemeConfig, type CodeTheme, DEFAULT_THEME_COLOR_DARK, DEFAULT_THEME_COLOR_LIGHT, type DocsConfig, type DocsHrefResolution, type DocsTheme, type DocsValidatorOptions, type Footer, type FooterLink, HEX_COLOR_PATTERN, type HiddenPageRoute, type IconValidationContext, type Logo, type LogoVariant, type NavGroup, type NavMenu, type NavMenuItem, type NavOpenApi, type NavOpenApiPage, type NavOpenApiPageRef, type NavPage, type NavTag, type NavbarItem, type NavigationItem, PUBLISHABLE_STATIC_ASSET_EXTENSIONS, type RadiantComponentValidationOptions, type SocialPlatform, type TagTheme, type ThemeColorByMode, configureDocsValidator, getConfig, isPublishableStaticAssetPath, isValidHexColor, loadOpenApiSpec, normalizeHexColorValue, resolveDocsHref, resolveDocsPageHref, validateMdxContent, validateRadiantComponentNode, validateRadiantComponentProps };

package/dist/index.js

@@ -17,6 +17,18 @@ import { oas } from "@stoplight/spectral-rulesets";
 import { compile } from "@mdx-js/mdx";
 import yaml from "yaml";
 
+// src/color-validation.ts
+var HEX_COLOR_PATTERN = /^#(?:[0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+function normalizeHexColorValue(value) {
+  const trimmedValue = value.trim();
+  if (trimmedValue.length === 0) return null;
+  const normalizedValue = trimmedValue.startsWith("#") ? trimmedValue : `#${trimmedValue}`;
+  return HEX_COLOR_PATTERN.test(normalizedValue) ? normalizedValue.toLowerCase() : null;
+}
+function isValidHexColor(value) {
+  return typeof value === "string" && normalizeHexColorValue(value) !== null;
+}
+
 // src/component-validation.ts
 import { compileSync } from "@mdx-js/mdx";
 function componentError(componentName, message, sourceFile) {
@@ -230,8 +242,7 @@ function assertHexColor(componentName, propName, value, sourceFile) {
       sourceFile
     );
   }
-  const normalized = value.trim().startsWith("#") ? value.trim() : `#${value.trim()}`;
-  if (!/^#(?:[A-Fa-f0-9]{3}|[A-Fa-f0-9]{4}|[A-Fa-f0-9]{6}|[A-Fa-f0-9]{8})$/.test(normalized)) {
+  if (normalizeHexColorValue(value) === null) {
     componentError(
       componentName,
       `Invalid prop "${propName}": expected a hex color like "#3b82f6"`,
@@ -813,20 +824,18 @@ function normalizeHexColor(value, currentPath, label) {
   if (typeof value !== "string") {
     throwConfigError(`${label} must be a string.`, currentPath);
   }
-  const trimmedValue = value.trim();
-  if (trimmedValue.length === 0) {
+  const stringValue = value;
+  const normalizedValue = normalizeHexColorValue(stringValue);
+  if (normalizedValue === null && stringValue.trim().length === 0) {
     throwConfigError(`${label} cannot be empty.`, currentPath);
   }
-  const normalizedValue = trimmedValue.startsWith("#") ? trimmedValue : `#${trimmedValue}`;
-  if (!/^#(?:[A-Fa-f0-9]{3}|[A-Fa-f0-9]{4}|[A-Fa-f0-9]{6}|[A-Fa-f0-9]{8})$/.test(
-    normalizedValue
-  )) {
-    throwConfigError(
-      `${label} must be a valid hex color (for example: #1d4ed8).`,
-      currentPath
-    );
+  if (normalizedValue !== null) {
+    return normalizedValue;
   }
-  return normalizedValue.toLowerCase();
+  return throwConfigError(
+    `${label} must be a valid hex color (for example: #1d4ed8).`,
+    currentPath
+  );
 }
 function normalizeThemeColorConfig(value, currentPath, label) {
   if (typeof value === "string") {
@@ -3049,6 +3058,7 @@ export {
   DEFAULT_SHIKI_LIGHT_THEME,
   DEFAULT_THEME_COLOR_DARK,
   DEFAULT_THEME_COLOR_LIGHT,
+  HEX_COLOR_PATTERN,
   PUBLISHABLE_STATIC_ASSET_EXTENSIONS,
   SHIKI_BUNDLED_THEME_NAMES,
   configureDocsValidator,
@@ -3056,7 +3066,9 @@ export {
   getConfig,
   isBundledShikiThemeName,
   isPublishableStaticAssetPath,
+  isValidHexColor,
   loadOpenApiSpec,
+  normalizeHexColorValue,
   resolveDocsHref,
   resolveDocsPageHref,
   validateMdxContent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "radiant-docs-validator",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Shared validation for Radiant documentation repositories",
   "type": "module",
   "scripts": {