@orion-ds/react 4.2.1 → 4.2.4

package/dist/utils/validation.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Orion React Validation Utilities
+ *
+ * Runtime validation helpers that provide helpful console warnings
+ * during development to catch common AI-generated code mistakes.
+ *
+ * These warnings only appear in development mode (process.env.NODE_ENV !== 'production').
+ *
+ * @module validation
+ */
+/**
+ * Warn when an icon-only button is missing aria-label.
+ *
+ * @param component - Component name (e.g., 'Button')
+ * @param iconOnly - Whether the component is icon-only
+ * @param hasAriaLabel - Whether aria-label is provided
+ *
+ * @example
+ * ```tsx
+ * // In Button.tsx
+ * warnMissingAriaLabel('Button', iconOnly, !!rest['aria-label']);
+ * ```
+ */
+export declare function warnMissingAriaLabel(component: string, iconOnly: boolean, hasAriaLabel: boolean): void;
+/**
+ * Warn when a component receives a brand prop.
+ * Brand should be set globally via ThemeProvider, not on individual components.
+ *
+ * @param component - Component name (e.g., 'Button')
+ * @param hasBrandProp - Whether the component received a brand prop
+ *
+ * @example
+ * ```tsx
+ * // In Button.tsx
+ * warnBrandProp('Button', 'brand' in rest);
+ * ```
+ */
+export declare function warnBrandProp(component: string, hasBrandProp: boolean): void;
+/**
+ * Warn when a component receives a theme prop.
+ * Theme should be set globally via ThemeProvider, not on individual components.
+ *
+ * @param component - Component name (e.g., 'Card')
+ * @param hasThemeProp - Whether the component received a theme prop
+ *
+ * @example
+ * ```tsx
+ * // In Card.tsx
+ * warnThemeProp('Card', 'theme' in rest);
+ * ```
+ */
+export declare function warnThemeProp(component: string, hasThemeProp: boolean): void;
+/**
+ * Warn when glass variant is used outside Display mode.
+ * Glass effects only work properly in Display mode.
+ *
+ * @param component - Component name (e.g., 'Card', 'Navbar')
+ * @param variant - The variant being used
+ *
+ * @example
+ * ```tsx
+ * // In Card.tsx
+ * warnGlassVariant('Card', variant);
+ * ```
+ */
+export declare function warnGlassVariant(component: string, variant: string | undefined): void;
+/**
+ * Warn when hardcoded colors are detected in style prop.
+ *
+ * @param component - Component name
+ * @param style - The style object
+ *
+ * @example
+ * ```tsx
+ * warnHardcodedColors('Button', style);
+ * ```
+ */
+export declare function warnHardcodedColors(component: string, style: React.CSSProperties | undefined): void;
+/**
+ * Warn when Field component might be misused.
+ * Called when children are passed to Field (which doesn't support them).
+ *
+ * @param hasChildren - Whether children were passed
+ */
+export declare function warnFieldChildren(hasChildren: boolean): void;
+/**
+ * Warn when a section component is created instead of using pre-built sections.
+ * This is for documentation/guidance purposes.
+ *
+ * @param customComponentName - Name of the custom component being created
+ * @param suggestedSection - The pre-built section to use instead
+ */
+export declare function warnUsePrebuiltSection(customComponentName: string, suggestedSection: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,GACpB,IAAI,CAmBN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CA4B5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CA6B5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAsCN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,CAAC,aAAa,GAAG,SAAS,GACrC,IAAI,CAuCN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CA6B5D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,mBAAmB,EAAE,MAAM,EAC3B,gBAAgB,EAAE,MAAM,GACvB,IAAI,CA+BN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orion-ds/react",
-  "version": "4.2.1",
+  "version": "4.2.4",
   "type": "module",
   "description": "Orion Design System - React component library with 40+ AI-ready components and 9 templates",
   "author": "Orion Design System Team",
@@ -174,6 +174,7 @@
     "@types/react-dom": "^19.2.3",
     "@types/react-syntax-highlighter": "^15.5.13",
     "@vitejs/plugin-react": "^5.1.2",
+    "vite-plugin-dts": "^3.7.0",
     "@vitest/coverage-v8": "^4.0.18",
     "@vitest/ui": "^4.0.18",
     "jsdom": "^27.4.0",