@nucleux/direction 0.0.0-stage → 0.7.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/README.md

@@ -1,3 +1,44 @@
-# Temporary Holding Version
+# @nucleux/direction
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Text direction (LTR/RTL) provider and hook — Nucleux agentic UI for React.
+
+Part of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** — agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).
+
+
+## Exports
+
+- **`DirectionProvider`** — sets `dir` (`"ltr"` | `"rtl"`; `direction` is an alias) for components below it
+- **`useDirection(localDir?)`** — returns `localDir`, else the provider's value, else `"ltr"`
+- **`Direction`** — the `"ltr" | "rtl"` type
+
+## Install
+
+```bash
+pnpm add @nucleux/direction @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { DirectionProvider, useDirection } from "@nucleux/direction";
+
+<html dir="rtl">
+  <DirectionProvider dir="rtl">
+    <App />
+  </DirectionProvider>
+</html>
+
+function Arrow() {
+  const dir = useDirection();
+  return dir === "rtl" ? <ArrowLeft /> : <ArrowRight />;
+}
+```
+
+Requires the theme once in your app: `import "@nucleux/tokens/styles.css";`
+and the Tailwind preset from `@nucleux/tokens/preset`.
+
+## License
+
+MIT © Nucleux

package/dist/index.cjs

@@ -0,0 +1,42 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/index.tsx
+var DirectionContext = React__namespace.createContext(void 0);
+function DirectionProvider({ dir, direction, children }) {
+  const value = direction ?? dir;
+  return /* @__PURE__ */ jsxRuntime.jsx(DirectionContext.Provider, { value, children });
+}
+DirectionProvider.displayName = "DirectionProvider";
+function useDirection(localDir) {
+  const globalDir = React__namespace.useContext(DirectionContext);
+  return localDir || globalDir || "ltr";
+}
+
+exports.DirectionProvider = DirectionProvider;
+exports.useDirection = useDirection;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,IAAM,gBAAA,GAAyBA,+BAAqC,MAAS,CAAA;AAgBtE,SAAS,iBAAA,CAAkB,EAAE,GAAA,EAAK,SAAA,EAAW,UAAS,EAA2B;AACtF,EAAA,MAAM,QAAQ,SAAA,IAAa,GAAA;AAC3B,EAAA,uBAAOC,cAAA,CAAC,gBAAA,CAAiB,QAAA,EAAjB,EAA0B,OAAe,QAAA,EAAS,CAAA;AAC5D;AACA,iBAAA,CAAkB,WAAA,GAAc,mBAAA;AAOzB,SAAS,aAAa,QAAA,EAAiC;AAC5D,EAAA,MAAM,SAAA,GAAkBD,4BAAW,gBAAgB,CAAA;AACnD,EAAA,OAAO,YAAY,SAAA,IAAa,KAAA;AAClC","file":"index.cjs","sourcesContent":["import * as React from \"react\";\n\n/** Reading direction: left-to-right or right-to-left. */\nexport type Direction = \"ltr\" | \"rtl\";\n\nconst DirectionContext = React.createContext<Direction | undefined>(undefined);\n\nexport interface DirectionProviderProps {\n  /** Reading direction for everything below this provider. */\n  dir?: Direction;\n  /** Alias of `dir` (shadcn vocabulary); wins when both are given. */\n  direction?: Direction;\n  children?: React.ReactNode;\n}\n\n/**\n * Sets the reading direction (\"ltr\" or \"rtl\") for the components below it,\n * read with `useDirection()`. It renders no DOM of its own, so also set\n * `dir` on your `<html>` (or a wrapping element) for the browser's layout\n * and text flow to follow. Accepts `direction` as an alias of `dir`.\n */\nexport function DirectionProvider({ dir, direction, children }: DirectionProviderProps) {\n  const value = direction ?? dir;\n  return <DirectionContext.Provider value={value}>{children}</DirectionContext.Provider>;\n}\nDirectionProvider.displayName = \"DirectionProvider\";\n\n/**\n * Returns the effective reading direction: `localDir` when given (a\n * component's own `dir` prop), otherwise the nearest DirectionProvider's\n * value, otherwise \"ltr\".\n */\nexport function useDirection(localDir?: Direction): Direction {\n  const globalDir = React.useContext(DirectionContext);\n  return localDir || globalDir || \"ltr\";\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,29 @@
+import * as React from 'react';
+
+/** Reading direction: left-to-right or right-to-left. */
+type Direction = "ltr" | "rtl";
+interface DirectionProviderProps {
+    /** Reading direction for everything below this provider. */
+    dir?: Direction;
+    /** Alias of `dir` (shadcn vocabulary); wins when both are given. */
+    direction?: Direction;
+    children?: React.ReactNode;
+}
+/**
+ * Sets the reading direction ("ltr" or "rtl") for the components below it,
+ * read with `useDirection()`. It renders no DOM of its own, so also set
+ * `dir` on your `<html>` (or a wrapping element) for the browser's layout
+ * and text flow to follow. Accepts `direction` as an alias of `dir`.
+ */
+declare function DirectionProvider({ dir, direction, children }: DirectionProviderProps): React.JSX.Element;
+declare namespace DirectionProvider {
+    var displayName: string;
+}
+/**
+ * Returns the effective reading direction: `localDir` when given (a
+ * component's own `dir` prop), otherwise the nearest DirectionProvider's
+ * value, otherwise "ltr".
+ */
+declare function useDirection(localDir?: Direction): Direction;
+
+export { type Direction, DirectionProvider, type DirectionProviderProps, useDirection };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import * as React from 'react';
+
+/** Reading direction: left-to-right or right-to-left. */
+type Direction = "ltr" | "rtl";
+interface DirectionProviderProps {
+    /** Reading direction for everything below this provider. */
+    dir?: Direction;
+    /** Alias of `dir` (shadcn vocabulary); wins when both are given. */
+    direction?: Direction;
+    children?: React.ReactNode;
+}
+/**
+ * Sets the reading direction ("ltr" or "rtl") for the components below it,
+ * read with `useDirection()`. It renders no DOM of its own, so also set
+ * `dir` on your `<html>` (or a wrapping element) for the browser's layout
+ * and text flow to follow. Accepts `direction` as an alias of `dir`.
+ */
+declare function DirectionProvider({ dir, direction, children }: DirectionProviderProps): React.JSX.Element;
+declare namespace DirectionProvider {
+    var displayName: string;
+}
+/**
+ * Returns the effective reading direction: `localDir` when given (a
+ * component's own `dir` prop), otherwise the nearest DirectionProvider's
+ * value, otherwise "ltr".
+ */
+declare function useDirection(localDir?: Direction): Direction;
+
+export { type Direction, DirectionProvider, type DirectionProviderProps, useDirection };

package/dist/index.js

@@ -0,0 +1,19 @@
+"use client";
+import * as React from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var DirectionContext = React.createContext(void 0);
+function DirectionProvider({ dir, direction, children }) {
+  const value = direction ?? dir;
+  return /* @__PURE__ */ jsx(DirectionContext.Provider, { value, children });
+}
+DirectionProvider.displayName = "DirectionProvider";
+function useDirection(localDir) {
+  const globalDir = React.useContext(DirectionContext);
+  return localDir || globalDir || "ltr";
+}
+
+export { DirectionProvider, useDirection };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;AAKA,IAAM,gBAAA,GAAyB,oBAAqC,MAAS,CAAA;AAgBtE,SAAS,iBAAA,CAAkB,EAAE,GAAA,EAAK,SAAA,EAAW,UAAS,EAA2B;AACtF,EAAA,MAAM,QAAQ,SAAA,IAAa,GAAA;AAC3B,EAAA,uBAAO,GAAA,CAAC,gBAAA,CAAiB,QAAA,EAAjB,EAA0B,OAAe,QAAA,EAAS,CAAA;AAC5D;AACA,iBAAA,CAAkB,WAAA,GAAc,mBAAA;AAOzB,SAAS,aAAa,QAAA,EAAiC;AAC5D,EAAA,MAAM,SAAA,GAAkB,iBAAW,gBAAgB,CAAA;AACnD,EAAA,OAAO,YAAY,SAAA,IAAa,KAAA;AAClC","file":"index.js","sourcesContent":["import * as React from \"react\";\n\n/** Reading direction: left-to-right or right-to-left. */\nexport type Direction = \"ltr\" | \"rtl\";\n\nconst DirectionContext = React.createContext<Direction | undefined>(undefined);\n\nexport interface DirectionProviderProps {\n  /** Reading direction for everything below this provider. */\n  dir?: Direction;\n  /** Alias of `dir` (shadcn vocabulary); wins when both are given. */\n  direction?: Direction;\n  children?: React.ReactNode;\n}\n\n/**\n * Sets the reading direction (\"ltr\" or \"rtl\") for the components below it,\n * read with `useDirection()`. It renders no DOM of its own, so also set\n * `dir` on your `<html>` (or a wrapping element) for the browser's layout\n * and text flow to follow. Accepts `direction` as an alias of `dir`.\n */\nexport function DirectionProvider({ dir, direction, children }: DirectionProviderProps) {\n  const value = direction ?? dir;\n  return <DirectionContext.Provider value={value}>{children}</DirectionContext.Provider>;\n}\nDirectionProvider.displayName = \"DirectionProvider\";\n\n/**\n * Returns the effective reading direction: `localDir` when given (a\n * component's own `dir` prop), otherwise the nearest DirectionProvider's\n * value, otherwise \"ltr\".\n */\nexport function useDirection(localDir?: Direction): Direction {\n  const globalDir = React.useContext(DirectionContext);\n  return localDir || globalDir || \"ltr\";\n}\n"]}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@nucleux/direction",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.7.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",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@nucleux/utils": "0.7.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1",
+    "lucide-react": "^0.469.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/direction"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "description": "Text direction (LTR/RTL) provider and hook — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "direction"
+  ],
+  "scripts": {
+    "build": "tsup"
+  }
 }