@nucleux/utils 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nucleux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var clsx = require('clsx');
+var tailwindMerge = require('tailwind-merge');
+
+// src/utils.ts
+function cn(...inputs) {
+  return tailwindMerge.twMerge(clsx.clsx(inputs));
+}
+
+exports.cn = cn;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts"],"names":["twMerge","clsx"],"mappings":";;;;;;AAOO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAOA,qBAAA,CAAQC,SAAA,CAAK,MAAM,CAAC,CAAA;AAC7B","file":"index.cjs","sourcesContent":["import { clsx, type ClassValue } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\n/**\n * Merge class names with Tailwind-aware conflict resolution.\n * Later conflicting utilities win (e.g. `cn(\"p-2\", \"p-4\")` -> `\"p-4\"`).\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,39 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * Merge class names with Tailwind-aware conflict resolution.
+ * Later conflicting utilities win (e.g. `cn("p-2", "p-4")` -> `"p-4"`).
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/** The author of a message in an agent conversation. */
+type MessageRole = "user" | "assistant" | "system" | "tool";
+/** Lifecycle state of a tool / function call made by an agent. */
+type ToolCallStatus = "pending" | "running" | "success" | "error";
+/** A single tool invocation surfaced by the agent. */
+interface ToolCallData {
+    /** Stable id for the invocation. */
+    id: string;
+    /** Name of the tool/function being called. */
+    name: string;
+    /** Arguments passed to the tool (any JSON-serializable value). */
+    args?: unknown;
+    /** Result returned by the tool once it resolves. */
+    result?: unknown;
+    /** Current lifecycle state. */
+    status: ToolCallStatus;
+}
+/** A message in an agent conversation. */
+interface ChatMessage {
+    id: string;
+    role: MessageRole;
+    content: string;
+    /** True while the assistant is still streaming this message's content. */
+    streaming?: boolean;
+    /** Tool calls associated with this message, if any. */
+    toolCalls?: ToolCallData[];
+    /** ISO timestamp or epoch millis for when the message was created. */
+    createdAt?: string | number;
+}
+
+export { type ChatMessage, type MessageRole, type ToolCallData, type ToolCallStatus, cn };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * Merge class names with Tailwind-aware conflict resolution.
+ * Later conflicting utilities win (e.g. `cn("p-2", "p-4")` -> `"p-4"`).
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/** The author of a message in an agent conversation. */
+type MessageRole = "user" | "assistant" | "system" | "tool";
+/** Lifecycle state of a tool / function call made by an agent. */
+type ToolCallStatus = "pending" | "running" | "success" | "error";
+/** A single tool invocation surfaced by the agent. */
+interface ToolCallData {
+    /** Stable id for the invocation. */
+    id: string;
+    /** Name of the tool/function being called. */
+    name: string;
+    /** Arguments passed to the tool (any JSON-serializable value). */
+    args?: unknown;
+    /** Result returned by the tool once it resolves. */
+    result?: unknown;
+    /** Current lifecycle state. */
+    status: ToolCallStatus;
+}
+/** A message in an agent conversation. */
+interface ChatMessage {
+    id: string;
+    role: MessageRole;
+    content: string;
+    /** True while the assistant is still streaming this message's content. */
+    streaming?: boolean;
+    /** Tool calls associated with this message, if any. */
+    toolCalls?: ToolCallData[];
+    /** ISO timestamp or epoch millis for when the message was created. */
+    createdAt?: string | number;
+}
+
+export { type ChatMessage, type MessageRole, type ToolCallData, type ToolCallStatus, cn };

package/dist/index.js

@@ -0,0 +1,11 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+// src/utils.ts
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+export { cn };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts"],"names":[],"mappings":";;;;AAOO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA;AAC7B","file":"index.js","sourcesContent":["import { clsx, type ClassValue } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\n/**\n * Merge class names with Tailwind-aware conflict resolution.\n * Later conflicting utilities win (e.g. `cn(\"p-2\", \"p-4\")` -> `\"p-4\"`).\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n"]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@nucleux/utils",
+  "version": "0.1.0",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/utils"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^2.6.0"
+  },
+  "scripts": {
+    "build": "tsup"
+  }
+}