@titan-design/react-ui 0.2.5 → 0.2.7

package/dist/theme/index.d.mts

@@ -1299,6 +1299,62 @@ declare const neumorphicShadows: {
     };
 };
 
+/**
+ * TypeScript mirror of css-property-manifest.schema.json.
+ *
+ * A manifest records, per component, which visual CSS properties are tracked,
+ * which design token each one resolves from, the expected computed style
+ * value, and any per-variant overrides. Manifests are the fixtures consumed
+ * by Playwright computed-style assertions (see packages/ui/tests/visual).
+ */
+/** Variant axis name/value pairs, e.g. { variant: 'solid', color: 'primary', size: 'md' }. */
+type VariantAxes = Record<string, string>;
+/** A resolvedValue/token override that applies when the given variant axes match. */
+interface VariantOverride {
+    /** Partial variant axis values that trigger this override, merged onto baseVariant. */
+    variant: VariantAxes;
+    /** Semantic token key for this override, or null for a literal (non-tokenized) value. */
+    token?: string | null;
+    /** CSS custom property backing the token for this override, if any. */
+    cssVariable?: string | null;
+    /** Expected getComputedStyle value when the variant axes match. */
+    resolvedValue: string;
+}
+/** A single tracked CSS property for a component. */
+interface CssPropertyEntry {
+    /** CSS property name in camelCase, as returned by window.getComputedStyle (e.g. "backgroundColor"). */
+    property: string;
+    /** Semantic token key this property is sourced from, or null if not backed by a token. */
+    token: string | null;
+    /** CSS custom property backing the token (e.g. "--color-brand-primary"), if any. */
+    cssVariable?: string | null;
+    /** Expected computed style value for baseVariant. */
+    resolvedValue: string;
+    /** Overrides of token/resolvedValue for specific variant axis combinations. */
+    variantOverrides?: VariantOverride[];
+}
+/** The full per-component CSS property manifest. */
+interface CssPropertyManifest {
+    /** Component identifier matching its src/components/ui/{component} directory and Storybook id. */
+    component: string;
+    /** Optional human-readable note about what this manifest covers. */
+    description?: string;
+    /** Variant axis values each property's top-level resolvedValue was captured against. */
+    baseVariant?: VariantAxes;
+    /** Tracked CSS properties for this component. */
+    properties: CssPropertyEntry[];
+}
+
+/** Result of validating a candidate manifest: valid iff errors is empty. */
+interface ManifestValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/** Structurally validates a candidate value against the CssPropertyManifest shape. */
+declare function validateCssPropertyManifest(candidate: unknown): ManifestValidationResult;
+/** Type guard variant of validateCssPropertyManifest for use in narrowing contexts. */
+declare function isCssPropertyManifest(candidate: unknown): candidate is CssPropertyManifest;
+
 interface ThemePresetColors {
     'brand-primary'?: string;
     'brand-primary-light'?: string;
@@ -1384,4 +1440,4 @@ declare const defaultPreset: ThemePreset;
  */
 declare const audiobookPreset: ThemePreset;
 
-export { type ComponentType, type ElevationConfig, type ElevationLevel, type GlowIntensity, type ShadowIntensity, type ShadowSurface, type ThemeConfig, type ThemeMode, type ThemePreset, type ThemePresetColors, type ThemePresetFonts, type ThemePresetRadii, type ThemePresetShadows, applyThemePreset, audiobookPreset, buttonSizes, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, elevationSystem, getBaseSurfaceColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isDark, lightThemeCSSVars, lighten, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, shadowColors };
+export { type ComponentType, type CssPropertyEntry, type CssPropertyManifest, type ElevationConfig, type ElevationLevel, type GlowIntensity, type ManifestValidationResult, type ShadowIntensity, type ShadowSurface, type ThemeConfig, type ThemeMode, type ThemePreset, type ThemePresetColors, type ThemePresetFonts, type ThemePresetRadii, type ThemePresetShadows, type VariantAxes, type VariantOverride, applyThemePreset, audiobookPreset, buttonSizes, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, elevationSystem, getBaseSurfaceColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, shadowColors, validateCssPropertyManifest };

package/dist/theme/index.d.ts

@@ -1299,6 +1299,62 @@ declare const neumorphicShadows: {
     };
 };
 
+/**
+ * TypeScript mirror of css-property-manifest.schema.json.
+ *
+ * A manifest records, per component, which visual CSS properties are tracked,
+ * which design token each one resolves from, the expected computed style
+ * value, and any per-variant overrides. Manifests are the fixtures consumed
+ * by Playwright computed-style assertions (see packages/ui/tests/visual).
+ */
+/** Variant axis name/value pairs, e.g. { variant: 'solid', color: 'primary', size: 'md' }. */
+type VariantAxes = Record<string, string>;
+/** A resolvedValue/token override that applies when the given variant axes match. */
+interface VariantOverride {
+    /** Partial variant axis values that trigger this override, merged onto baseVariant. */
+    variant: VariantAxes;
+    /** Semantic token key for this override, or null for a literal (non-tokenized) value. */
+    token?: string | null;
+    /** CSS custom property backing the token for this override, if any. */
+    cssVariable?: string | null;
+    /** Expected getComputedStyle value when the variant axes match. */
+    resolvedValue: string;
+}
+/** A single tracked CSS property for a component. */
+interface CssPropertyEntry {
+    /** CSS property name in camelCase, as returned by window.getComputedStyle (e.g. "backgroundColor"). */
+    property: string;
+    /** Semantic token key this property is sourced from, or null if not backed by a token. */
+    token: string | null;
+    /** CSS custom property backing the token (e.g. "--color-brand-primary"), if any. */
+    cssVariable?: string | null;
+    /** Expected computed style value for baseVariant. */
+    resolvedValue: string;
+    /** Overrides of token/resolvedValue for specific variant axis combinations. */
+    variantOverrides?: VariantOverride[];
+}
+/** The full per-component CSS property manifest. */
+interface CssPropertyManifest {
+    /** Component identifier matching its src/components/ui/{component} directory and Storybook id. */
+    component: string;
+    /** Optional human-readable note about what this manifest covers. */
+    description?: string;
+    /** Variant axis values each property's top-level resolvedValue was captured against. */
+    baseVariant?: VariantAxes;
+    /** Tracked CSS properties for this component. */
+    properties: CssPropertyEntry[];
+}
+
+/** Result of validating a candidate manifest: valid iff errors is empty. */
+interface ManifestValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/** Structurally validates a candidate value against the CssPropertyManifest shape. */
+declare function validateCssPropertyManifest(candidate: unknown): ManifestValidationResult;
+/** Type guard variant of validateCssPropertyManifest for use in narrowing contexts. */
+declare function isCssPropertyManifest(candidate: unknown): candidate is CssPropertyManifest;
+
 interface ThemePresetColors {
     'brand-primary'?: string;
     'brand-primary-light'?: string;
@@ -1384,4 +1440,4 @@ declare const defaultPreset: ThemePreset;
  */
 declare const audiobookPreset: ThemePreset;
 
-export { type ComponentType, type ElevationConfig, type ElevationLevel, type GlowIntensity, type ShadowIntensity, type ShadowSurface, type ThemeConfig, type ThemeMode, type ThemePreset, type ThemePresetColors, type ThemePresetFonts, type ThemePresetRadii, type ThemePresetShadows, applyThemePreset, audiobookPreset, buttonSizes, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, elevationSystem, getBaseSurfaceColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isDark, lightThemeCSSVars, lighten, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, shadowColors };
+export { type ComponentType, type CssPropertyEntry, type CssPropertyManifest, type ElevationConfig, type ElevationLevel, type GlowIntensity, type ManifestValidationResult, type ShadowIntensity, type ShadowSurface, type ThemeConfig, type ThemeMode, type ThemePreset, type ThemePresetColors, type ThemePresetFonts, type ThemePresetRadii, type ThemePresetShadows, type VariantAxes, type VariantOverride, applyThemePreset, audiobookPreset, buttonSizes, componentElevationRanges, createFlatShadow, createPressedHoverShadow, createPressedShadow, createRaisedHoverShadow, createRaisedShadow, darkThemeCSSVars, darken, defaultPreset, discreteRainbow, elevationSystem, getBaseSurfaceColor, getDiscreteRainbowColor, getElevationConfig, getElevationShadow, getElevationSurface, getGlowShadow, getHoverColors, getSemanticColors, getThemeCSSVars, getValidatedElevation, gluestackConfig, hexToRgb, hsvToRgb, isCssPropertyManifest, isDark, lightThemeCSSVars, lighten, neumorphicShadows, primitiveBorderRadius, primitiveBreakpoints, primitiveColors, primitiveShadows, primitiveSpacing, primitiveTypography, primitiveZIndex, rgbToHex, rgbToHsv, semanticColorsDark, semanticColorsLight, semanticTypography, shadowColors, validateCssPropertyManifest };

package/dist/theme/index.js

@@ -1500,6 +1500,67 @@ function getGlowShadow(color, intensity = "medium") {
   });
 }
 
+// src/theme/manifest/css-property-manifest.validate.ts
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isVariantAxes = (value) => isPlainObject(value) && Object.keys(value).length > 0 && Object.values(value).every((axisValue) => typeof axisValue === "string");
+function collectVariantOverrideErrors(override, path) {
+  if (!isPlainObject(override)) return [`${path} must be an object`];
+  const errors = [];
+  if (!isVariantAxes(override.variant))
+    errors.push(`${path}.variant must be a non-empty string-keyed object`);
+  if (override.token !== void 0 && override.token !== null && typeof override.token !== "string") {
+    errors.push(`${path}.token must be a string or null`);
+  }
+  if (typeof override.resolvedValue !== "string" || override.resolvedValue.length === 0) {
+    errors.push(`${path}.resolvedValue must be a non-empty string`);
+  }
+  return errors;
+}
+function collectPropertyErrors(entry, path) {
+  if (!isPlainObject(entry)) return [`${path} must be an object`];
+  const errors = [];
+  if (typeof entry.property !== "string" || entry.property.length === 0) {
+    errors.push(`${path}.property must be a non-empty string`);
+  }
+  if (entry.token !== null && typeof entry.token !== "string") {
+    errors.push(`${path}.token must be a string or null`);
+  }
+  if (typeof entry.resolvedValue !== "string" || entry.resolvedValue.length === 0) {
+    errors.push(`${path}.resolvedValue must be a non-empty string`);
+  }
+  if (entry.variantOverrides !== void 0) {
+    if (!Array.isArray(entry.variantOverrides)) {
+      errors.push(`${path}.variantOverrides must be an array`);
+    } else {
+      entry.variantOverrides.forEach(
+        (override, i) => errors.push(...collectVariantOverrideErrors(override, `${path}.variantOverrides[${i}]`))
+      );
+    }
+  }
+  return errors;
+}
+function validateCssPropertyManifest(candidate) {
+  if (!isPlainObject(candidate)) return { valid: false, errors: ["manifest must be an object"] };
+  const errors = [];
+  if (typeof candidate.component !== "string" || candidate.component.length === 0) {
+    errors.push("component must be a non-empty string");
+  }
+  if (candidate.baseVariant !== void 0 && !isVariantAxes(candidate.baseVariant)) {
+    errors.push("baseVariant must be a non-empty string-keyed object");
+  }
+  if (!Array.isArray(candidate.properties) || candidate.properties.length === 0) {
+    errors.push("properties must be a non-empty array");
+  } else {
+    candidate.properties.forEach(
+      (entry, i) => errors.push(...collectPropertyErrors(entry, `properties[${i}]`))
+    );
+  }
+  return { valid: errors.length === 0, errors };
+}
+function isCssPropertyManifest(candidate) {
+  return validateCssPropertyManifest(candidate).valid;
+}
+
 // src/theme/presets/apply.ts
 function colorKeyToVar(key) {
   return `--color-${key}`;
@@ -1690,6 +1751,7 @@ exports.getValidatedElevation = getValidatedElevation;
 exports.gluestackConfig = gluestackConfig;
 exports.hexToRgb = hexToRgb;
 exports.hsvToRgb = hsvToRgb;
+exports.isCssPropertyManifest = isCssPropertyManifest;
 exports.isDark = isDark;
 exports.lightThemeCSSVars = lightThemeCSSVars;
 exports.lighten = lighten;
@@ -1707,5 +1769,6 @@ exports.semanticColorsDark = semanticColorsDark;
 exports.semanticColorsLight = semanticColorsLight;
 exports.semanticTypography = semanticTypography;
 exports.shadowColors = shadowColors;
+exports.validateCssPropertyManifest = validateCssPropertyManifest;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map