@haruhimemoe/ui 0.1.0

package/dist/theme.css

@@ -0,0 +1,54 @@
+/*
+ * @file src/theme.css
+ * @desc The haruhime.moe theme for Tailwind 4: the hue-driven HSL palette the sites share
+ *       (b = backgrounds, c = content, h = highlight), Nunito as the sans font, a visible focus
+ *       ring, and an @source line so Tailwind generates the classes these components use.
+ *
+ *       Use it from the app's global stylesheet, after Tailwind:
+ *
+ *         @import "tailwindcss";
+ *         @import "@haruhimemoe/ui/theme.css";
+ *
+ *       Set --hue on :root to recolor everything (default 333, pink). Some hues need --h2-l
+ *       (h2 lightness, default 45%) or --h1-l (h1 lightness, default 70%) moved to keep text at
+ *       4.5:1; the README lists values. Load Nunito with next/font as the --font-nunito variable;
+ *       without it the sans stack falls back to the system font.
+ * @author David @dvhsh (https://dvh.sh)
+ * @created Wed Sep 23, 2026
+ * @modified Wed Sep 23, 2026
+ */
+
+/* This file ships as dist/theme.css, so './' is the package's compiled components. */
+@source "./";
+
+:root {
+  --hue: 333;
+  color-scheme: dark;
+}
+
+@theme inline {
+  --color-b1: hsl(var(--hue) 10% 40%);
+  --color-b2: hsl(var(--hue) 10% 30%);
+  --color-b3: hsl(var(--hue) 10% 25%);
+  --color-b4: hsl(var(--hue) 10% 20%);
+  --color-b5: hsl(var(--hue) 10% 15%);
+  --color-b6: hsl(var(--hue) 10% 10%);
+
+  --color-c1: hsl(var(--hue) 40% 100%);
+  --color-c2: hsl(var(--hue) 40% 90%);
+  --color-c3: hsl(var(--hue) 40% 80%);
+  --color-c4: hsl(var(--hue) 40% 70%);
+
+  --color-h1: hsl(var(--hue) 100% var(--h1-l, 70%));
+  --color-h2: hsl(var(--hue) 50% var(--h2-l, 45%));
+
+  --font-sans: var(--font-nunito), ui-sans-serif, system-ui, sans-serif;
+}
+
+@layer base {
+  :focus-visible {
+    outline: 2px solid var(--color-h1);
+    outline-offset: 2px;
+    border-radius: 4px;
+  }
+}

package/dist/utils/cx.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file src/utils/cx.ts
+ * @desc Class-name merger: drops falsy values and resolves Tailwind conflicts with tailwind-merge,
+ *       so a later class (the caller's) replaces an earlier one that sets the same property. Same
+ *       behavior as the sites' `cn` helper.
+ * @author David @dvhsh (https://dvh.sh)
+ * @created Wed Sep 23, 2026
+ * @modified Wed Sep 23, 2026
+ */
+/** A class name, or a falsy value to skip (handy for `cond && "class"`). */
+export type ClassValue = string | false | null | undefined | 0;
+/**
+ * @function cx
+ * @param classes {ClassValue[]} class strings; falsy values are skipped
+ * @returns {string} the classes in order, space-separated, with Tailwind conflicts resolved in
+ *          favor of the later class (`cx("w-full", "w-auto")` is `"w-auto"`)
+ */
+export declare const cx: (...classes: ClassValue[]) => string;

package/dist/utils/cx.js

@@ -0,0 +1,17 @@
+/**
+ * @file src/utils/cx.ts
+ * @desc Class-name merger: drops falsy values and resolves Tailwind conflicts with tailwind-merge,
+ *       so a later class (the caller's) replaces an earlier one that sets the same property. Same
+ *       behavior as the sites' `cn` helper.
+ * @author David @dvhsh (https://dvh.sh)
+ * @created Wed Sep 23, 2026
+ * @modified Wed Sep 23, 2026
+ */
+import { twMerge } from "tailwind-merge";
+/**
+ * @function cx
+ * @param classes {ClassValue[]} class strings; falsy values are skipped
+ * @returns {string} the classes in order, space-separated, with Tailwind conflicts resolved in
+ *          favor of the later class (`cx("w-full", "w-auto")` is `"w-auto"`)
+ */
+export const cx = (...classes) => twMerge(...classes);

package/dist/utils/href.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file src/utils/href.ts
+ * @desc Tells hrefs that leave the app (a URL scheme or a protocol-relative //host) from paths
+ *       inside it, so links can pick a plain <a> or next/link.
+ * @author David @dvhsh (https://dvh.sh)
+ * @created Wed Sep 23, 2026
+ * @modified Wed Sep 23, 2026
+ */
+/**
+ * @function isExternalHref
+ * @param href {string} a link target
+ * @returns {boolean} true when the href has a scheme or starts with `//`, so it leaves the app
+ *          and should be a plain `<a>` instead of `next/link`
+ */
+export declare const isExternalHref: (href: string) => boolean;

package/dist/utils/href.js

@@ -0,0 +1,17 @@
+/**
+ * @file src/utils/href.ts
+ * @desc Tells hrefs that leave the app (a URL scheme or a protocol-relative //host) from paths
+ *       inside it, so links can pick a plain <a> or next/link.
+ * @author David @dvhsh (https://dvh.sh)
+ * @created Wed Sep 23, 2026
+ * @modified Wed Sep 23, 2026
+ */
+// A URL scheme ("https:", "mailto:") or a protocol-relative "//host".
+const EXTERNAL = /^(?:[a-z][a-z\d+.-]*:|\/\/)/i;
+/**
+ * @function isExternalHref
+ * @param href {string} a link target
+ * @returns {boolean} true when the href has a scheme or starts with `//`, so it leaves the app
+ *          and should be a plain `<a>` instead of `next/link`
+ */
+export const isExternalHref = (href) => EXTERNAL.test(href);

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@haruhimemoe/ui",
+  "version": "0.1.0",
+  "description": "React components for the haruhime.moe osu! tools on Next.js: the osu!-web-style palette as a Tailwind theme, buttons, cards, form fields, filter controls and the site header and footer.",
+  "keywords": [
+    "osu",
+    "osu!",
+    "react",
+    "nextjs",
+    "tailwindcss",
+    "components",
+    "ui",
+    "haruhime"
+  ],
+  "homepage": "https://github.com/haruhimemoe/ui#readme",
+  "bugs": "https://github.com/haruhimemoe/ui/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/haruhimemoe/ui.git"
+  },
+  "license": "MIT",
+  "author": "David (https://dvh.sh)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./theme.css": "./dist/theme.css",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "engines": {
+    "node": ">=22.12"
+  },
+  "packageManager": "bun@1.4.2",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "bun run clean && tsc -p tsconfig.build.json && node -e \"require('node:fs').copyFileSync('src/theme.css','dist/theme.css')\"",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "check:consumer": "node scripts/check-consumer.mjs",
+    "prepublishOnly": "bun run check && bun run typecheck && bun run test && bun run build"
+  },
+  "dependencies": {
+    "tailwind-merge": "3.7.0"
+  },
+  "peerDependencies": {
+    "next": ">=16.0.0 <17",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0",
+    "tailwindcss": ">=4.1.0 <5"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.14",
+    "@tailwindcss/postcss": "4.3.3",
+    "@testing-library/dom": "10.4.2",
+    "@testing-library/jest-dom": "7.0.1",
+    "@testing-library/react": "16.3.3",
+    "@testing-library/user-event": "14.6.7",
+    "@types/node": "26.6.2",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "@vitejs/plugin-react": "6.1.1",
+    "@vitest/coverage-v8": "5.0.1",
+    "axe-core": "4.13.0",
+    "jsdom": "30.1.1",
+    "next": "16.3.6",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "tailwindcss": "4.3.3",
+    "typescript": "7.0.2",
+    "vitest": "5.0.1"
+  }
+}