@orion-ds/react 5.0.1 → 5.1.0

package/dist/utils/optionalDeps.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Optional Dependency Error Handling
+ *
+ * Provides helpful error messages when users try to use components
+ * that require optional peer dependencies (recharts, date-fns, etc.)
+ * without having them installed.
+ */
+/**
+ * Metadata for an optional dependency error
+ */
+export interface OptionalDepError {
+    available: boolean;
+    componentName: string;
+    depName: string | string[];
+    installCommand: string;
+    pnpmCommand: string;
+    docsUrl: string;
+}
+/**
+ * Get error information for a missing optional dependency
+ * @param componentName - Name of the Orion component
+ * @param depName - NPM package name or array of package names
+ * @param docsUrl - URL to component documentation
+ * @returns OptionalDepError with installation instructions
+ */
+export declare function getOptionalDepError(componentName: string, depName: string | string[], docsUrl: string): OptionalDepError;
+/**
+ * Registry of all optional-dependency components
+ * Used to validate component registrations
+ */
+export declare const OPTIONAL_DEP_COMPONENTS: {
+    readonly Chart: {
+        readonly depName: "recharts";
+        readonly docsUrl: "https://docs.orion-ds.dev/components/chart";
+    };
+    readonly Calendar: {
+        readonly depName: "date-fns";
+        readonly docsUrl: "https://docs.orion-ds.dev/components/calendar";
+    };
+    readonly DatePicker: {
+        readonly depName: "date-fns";
+        readonly docsUrl: "https://docs.orion-ds.dev/components/date-picker";
+    };
+    readonly CodeEditor: {
+        readonly depName: "react-syntax-highlighter";
+        readonly docsUrl: "https://docs.orion-ds.dev/components/code-editor";
+    };
+    readonly Chat: {
+        readonly depName: readonly ["react-markdown", "remark-gfm"];
+        readonly docsUrl: "https://docs.orion-ds.dev/components/chat";
+    };
+    readonly CollapsibleFolder: {
+        readonly depName: readonly ["@dnd-kit/core", "@dnd-kit/sortable", "@dnd-kit/utilities"];
+        readonly docsUrl: "https://docs.orion-ds.dev/components/collapsible-folder";
+    };
+};
+/**
+ * Type-safe way to get optional dependency info
+ * @param componentName - One of the optional-dependency component names
+ * @returns Error info if dependency is missing, undefined if available
+ */
+export declare function checkComponent(componentName: keyof typeof OPTIONAL_DEP_COMPONENTS): OptionalDepError | undefined;
+//# sourceMappingURL=optionalDeps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optionalDeps.d.ts","sourceRoot":"","sources":["../../src/utils/optionalDeps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAmBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,OAAO,EAAE,MAAM,GACd,gBAAgB,CAYlB;AAGD;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;CAyB1B,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,OAAO,uBAAuB,GAClD,gBAAgB,GAAG,SAAS,CAS9B"}

package/dist/utils/optionalDeps.mjs

@@ -0,0 +1,55 @@
+function d(e) {
+  return (Array.isArray(e) ? e : [e]).every((o) => {
+    try {
+      return require(o), !0;
+    } catch {
+      return !1;
+    }
+  });
+}
+function n(e, r, o) {
+  const s = (Array.isArray(r) ? r : [r]).join(" ");
+  return {
+    available: d(r),
+    componentName: e,
+    depName: r,
+    installCommand: `npm install ${s}`,
+    pnpmCommand: `pnpm add ${s}`,
+    docsUrl: o
+  };
+}
+const a = {
+  Chart: {
+    depName: "recharts",
+    docsUrl: "https://docs.orion-ds.dev/components/chart"
+  },
+  Calendar: {
+    depName: "date-fns",
+    docsUrl: "https://docs.orion-ds.dev/components/calendar"
+  },
+  DatePicker: {
+    depName: "date-fns",
+    docsUrl: "https://docs.orion-ds.dev/components/date-picker"
+  },
+  CodeEditor: {
+    depName: "react-syntax-highlighter",
+    docsUrl: "https://docs.orion-ds.dev/components/code-editor"
+  },
+  Chat: {
+    depName: ["react-markdown", "remark-gfm"],
+    docsUrl: "https://docs.orion-ds.dev/components/chat"
+  },
+  CollapsibleFolder: {
+    depName: ["@dnd-kit/core", "@dnd-kit/sortable", "@dnd-kit/utilities"],
+    docsUrl: "https://docs.orion-ds.dev/components/collapsible-folder"
+  }
+};
+function c(e) {
+  const r = a[e], o = Array.isArray(r.depName) ? [...r.depName] : r.depName, t = n(e, o, r.docsUrl);
+  return t.available ? void 0 : t;
+}
+export {
+  a as OPTIONAL_DEP_COMPONENTS,
+  c as checkComponent,
+  n as getOptionalDepError
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orion-ds/react",
-  "version": "5.0.1",
+  "version": "5.1.0",
   "type": "module",
   "description": "Orion Design System - React component library with 40+ AI-ready components and 9 templates",
   "author": "Orion Design System Team",