@enigmax/primitives 0.10.0 → 0.11.0

package/dist/react-router/index.d.ts

@@ -0,0 +1,9 @@
+import * as react from 'react';
+import { ButtonProps } from '../react/index.js';
+export { BreachChecker, BreachState, BreachStatus, FieldAction, Input, InputProps, PasswordStrength, PasswordStrengthProps, UseButtonResult, UseInputResult, UseMarqueeResult, UseSearchResult, getLinkComponent, setLinkComponent, useButton, useInput, useMarquee, useSearch } from '../react/index.js';
+export { ButtonOptions, ButtonState, EstimateOptions, GeneratePasswordOptions, InputAction, InputIcon, InputOptions, MarqueeHover, MarqueeInstance, MarqueeOptions, PasswordScore, PasswordStrengthReport, estimatePasswordStrength, generatePassword } from '../index.js';
+export { F as FuseConstructor, b as SearchMatch, c as SearchOptions } from '../search-CsO3L1Lw.js';
+
+declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLElement>>;
+
+export { Button, ButtonProps };

package/dist/react-router/index.js

@@ -0,0 +1,16 @@
+"use client";
+import { Button } from '../chunk-L4KA342C.js';
+export { Input, PasswordStrength, getLinkComponent, setLinkComponent, useButton, useInput, useMarquee, useSearch } from '../chunk-L4KA342C.js';
+export { estimatePasswordStrength, generatePassword } from '../chunk-42Y7OOJM.js';
+import '../chunk-UZFEEFMF.js';
+import { Link } from 'react-router';
+import { forwardRef, createElement } from 'react';
+
+var RouterLink = forwardRef(function RouterLink2({ href = "", ...props }, ref) {
+  return createElement(Link, { ...props, to: href, ref });
+});
+var Button2 = forwardRef(function Button3(props, ref) {
+  return createElement(Button, { ...props, as: props.as ?? (props.href ? RouterLink : void 0), ref });
+});
+
+export { Button2 as Button };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enigmax/primitives",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Headless interaction primitives: the behaviour, the timing and the accessibility of components like a draggable infinite marquee, with no styles of their own. Framework-agnostic core plus thin adapters.",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,13 +22,17 @@
     "./next": {
       "types": "./dist/next/index.d.ts",
       "import": "./dist/next/index.js"
+    },
+    "./react-router": {
+      "types": "./dist/react-router/index.d.ts",
+      "import": "./dist/react-router/index.js"
     }
   },
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "test": "npm run test:fixtures && playwright test",
-    "test:fixtures": "esbuild test/fixture/react.tsx --bundle --format=esm --jsx=automatic --outfile=test/fixture/build/react.js --tsconfig=tsconfig.json --alias:next/link=./test/fixture/next-link-stub.tsx",
+    "test:fixtures": "esbuild test/fixture/react.tsx --bundle --format=esm --jsx=automatic --outfile=test/fixture/build/react.js --tsconfig=tsconfig.json --alias:next/link=./test/fixture/next-link-stub.tsx --alias:react-router=./test/fixture/react-router-stub.tsx",
     "test:install": "playwright install chromium",
     "prepublishOnly": "npm run typecheck && npm run build"
   },
@@ -42,8 +46,9 @@
   ],
   "peerDependencies": {
     "fuse.js": ">=6",
+    "next": ">=13",
     "react": ">=18",
-    "next": ">=13"
+    "react-router": ">=7"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -54,6 +59,9 @@
     },
     "next": {
       "optional": true
+    },
+    "react-router": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -64,6 +72,7 @@
     "next": "^15.5.23",
     "react": "^19.2.0",
     "react-dom": "^19.2.8",
+    "react-router": "^7.18.2",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   },

package/src/react-router/index.tsx

@@ -0,0 +1,40 @@
+"use client";
+
+import { Link } from "react-router";
+import { forwardRef, createElement } from "react";
+import { Button as BaseButton, type ButtonProps } from "@/react/button";
+
+/**
+ * The React Router entry. Same components, wired to its `Link`.
+ *
+ * ```tsx
+ * import { Button } from "@enigmax/primitives/react-router";
+ *
+ * <Button href="/settings">Settings</Button>   // client navigation
+ * ```
+ *
+ * Same deal as the Next entry: the import path is the configuration, and a subpath is only
+ * ever resolved by a project that HAS the router - which is what lets a framework-agnostic
+ * package reference one at all.
+ *
+ * React Router names its target `to`, not `href`, so the prop is translated below. That
+ * translation is the whole reason this is a file rather than a line in the docs.
+ *
+ * React Aria solves the same problem the other way, with a `RouterProvider` taking the
+ * router's `navigate` (react-spectrum.adobe.com/react-aria/routing.html). One mechanism
+ * covers every router and it always renders a real anchor, but it is still a line of setup
+ * in the app. `setLinkComponent` is this package's version of that, for a router with no
+ * entry of its own here.
+ */
+
+/** Bridges the two names, so a call site writes `href` whatever the router underneath is. */
+const RouterLink = forwardRef<HTMLAnchorElement, { href?: string; }>(function RouterLink({ href = "", ...props }, ref) {
+    return createElement(Link, { ...props, to: href, ref });
+});
+
+export const Button = forwardRef<HTMLElement, ButtonProps>(function Button(props, ref) {
+    // Only an href makes it a link; a plain button must not be handed a router component.
+    return createElement(BaseButton, { ...props, as: props.as ?? (props.href ? RouterLink : undefined), ref });
+});
+
+export * from "@/react/index";