opsfuse-ui 0.1.10 → 0.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/skills/opsfuse-color-theme/SKILL.md +1 -1
- package/.claude/skills/opsfuse-components/SKILL.md +1 -1
- package/.claude/skills/opsfuse-setup/SKILL.md +94 -419
- package/.claude/skills/opsfuse-ui-consistency/SKILL.md +1 -1
- package/dist/{chunk-BdsCSvBP.js → chunk-Dqa2HsxW.js} +1 -1
- package/dist/components/logo/LogoMaker.d.ts +1 -1
- package/dist/components/logo/LogoMaker.d.ts.map +1 -1
- package/dist/components/logo/RecruitSmartly.d.ts +1 -1
- package/dist/components/logo/RecruitSmartly.d.ts.map +1 -1
- package/dist/components/logo/SkillReady.d.ts +1 -1
- package/dist/components/logo/SkillReady.d.ts.map +1 -1
- package/dist/components/logo/TalentScan.d.ts +1 -1
- package/dist/components/logo/TalentScan.d.ts.map +1 -1
- package/dist/components/logo/Verity.d.ts +1 -1
- package/dist/components/logo/Verity.d.ts.map +1 -1
- package/dist/components/logo/WorkLog.d.ts +1 -1
- package/dist/components/logo/WorkLog.d.ts.map +1 -1
- package/dist/components/opsfuse-root.d.ts +1 -1
- package/dist/components/opsfuse-root.d.ts.map +1 -1
- package/dist/components/opsfuse-theme-provider.d.ts +1 -1
- package/dist/components/opsfuse-theme-provider.d.ts.map +1 -1
- package/dist/components/ui/Header.d.ts +1 -1
- package/dist/components/ui/Header.d.ts.map +1 -1
- package/dist/components/ui/accordion.d.ts +1 -1
- package/dist/components/ui/accordion.d.ts.map +1 -1
- package/dist/components/ui/alert-dialog.d.ts +1 -1
- package/dist/components/ui/alert-dialog.d.ts.map +1 -1
- package/dist/components/ui/alert.d.ts +5 -5
- package/dist/components/ui/alert.d.ts.map +1 -1
- package/dist/components/ui/aspect-ratio.d.ts +1 -1
- package/dist/components/ui/aspect-ratio.d.ts.map +1 -1
- package/dist/components/ui/autocomplete.d.ts +1 -1
- package/dist/components/ui/autocomplete.d.ts.map +1 -1
- package/dist/components/ui/avatar.d.ts +1 -1
- package/dist/components/ui/avatar.d.ts.map +1 -1
- package/dist/components/ui/badge.d.ts +1 -1
- package/dist/components/ui/badge.d.ts.map +1 -1
- package/dist/components/ui/breadcrumb.d.ts +7 -7
- package/dist/components/ui/breadcrumb.d.ts.map +1 -1
- package/dist/components/ui/button-group.d.ts +3 -3
- package/dist/components/ui/button-group.d.ts.map +1 -1
- package/dist/components/ui/button.d.ts +1 -1
- package/dist/components/ui/button.d.ts.map +1 -1
- package/dist/components/ui/calendar.d.ts +2 -2
- package/dist/components/ui/calendar.d.ts.map +1 -1
- package/dist/components/ui/card.d.ts +7 -7
- package/dist/components/ui/card.d.ts.map +1 -1
- package/dist/components/ui/carousel.d.ts +5 -5
- package/dist/components/ui/carousel.d.ts.map +1 -1
- package/dist/components/ui/chart.d.ts +4 -4
- package/dist/components/ui/chart.d.ts.map +1 -1
- package/dist/components/ui/checkbox.d.ts +1 -1
- package/dist/components/ui/checkbox.d.ts.map +1 -1
- package/dist/components/ui/collapsible.d.ts +3 -3
- package/dist/components/ui/collapsible.d.ts.map +1 -1
- package/dist/components/ui/combobox.d.ts +1 -1
- package/dist/components/ui/combobox.d.ts.map +1 -1
- package/dist/components/ui/command.d.ts +9 -9
- package/dist/components/ui/command.d.ts.map +1 -1
- package/dist/components/ui/context-menu.d.ts +15 -15
- package/dist/components/ui/context-menu.d.ts.map +1 -1
- package/dist/components/ui/dialog.d.ts +11 -11
- package/dist/components/ui/dialog.d.ts.map +1 -1
- package/dist/components/ui/direction.d.ts +1 -1
- package/dist/components/ui/direction.d.ts.map +1 -1
- package/dist/components/ui/drawer.d.ts +10 -10
- package/dist/components/ui/drawer.d.ts.map +1 -1
- package/dist/components/ui/dropdown-menu.d.ts +1 -1
- package/dist/components/ui/dropdown-menu.d.ts.map +1 -1
- package/dist/components/ui/empty.d.ts +1 -1
- package/dist/components/ui/empty.d.ts.map +1 -1
- package/dist/components/ui/field.d.ts +10 -10
- package/dist/components/ui/field.d.ts.map +1 -1
- package/dist/components/ui/form.d.ts +5 -5
- package/dist/components/ui/form.d.ts.map +1 -1
- package/dist/components/ui/hover-card.d.ts +3 -3
- package/dist/components/ui/hover-card.d.ts.map +1 -1
- package/dist/components/ui/input-group.d.ts +6 -6
- package/dist/components/ui/input-group.d.ts.map +1 -1
- package/dist/components/ui/input-otp.d.ts +4 -4
- package/dist/components/ui/input-otp.d.ts.map +1 -1
- package/dist/components/ui/input.d.ts +1 -1
- package/dist/components/ui/input.d.ts.map +1 -1
- package/dist/components/ui/item.d.ts +10 -10
- package/dist/components/ui/item.d.ts.map +1 -1
- package/dist/components/ui/kbd.d.ts +2 -2
- package/dist/components/ui/kbd.d.ts.map +1 -1
- package/dist/components/ui/label.d.ts +1 -1
- package/dist/components/ui/label.d.ts.map +1 -1
- package/dist/components/ui/menubar.d.ts +16 -16
- package/dist/components/ui/menubar.d.ts.map +1 -1
- package/dist/components/ui/navigation-menu.d.ts +8 -8
- package/dist/components/ui/navigation-menu.d.ts.map +1 -1
- package/dist/components/ui/pagination.d.ts +1 -1
- package/dist/components/ui/pagination.d.ts.map +1 -1
- package/dist/components/ui/popover.d.ts +7 -7
- package/dist/components/ui/popover.d.ts.map +1 -1
- package/dist/components/ui/progress.d.ts +1 -1
- package/dist/components/ui/progress.d.ts.map +1 -1
- package/dist/components/ui/radio-group.d.ts +2 -2
- package/dist/components/ui/radio-group.d.ts.map +1 -1
- package/dist/components/ui/resizable.d.ts +3 -3
- package/dist/components/ui/resizable.d.ts.map +1 -1
- package/dist/components/ui/scroll-area.d.ts +2 -2
- package/dist/components/ui/scroll-area.d.ts.map +1 -1
- package/dist/components/ui/select.d.ts +1 -1
- package/dist/components/ui/select.d.ts.map +1 -1
- package/dist/components/ui/separator.d.ts +1 -1
- package/dist/components/ui/separator.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-accordion.d.ts +4 -4
- package/dist/components/ui/shadcn/shadcn-accordion.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-alert-dialog.d.ts +12 -12
- package/dist/components/ui/shadcn/shadcn-alert-dialog.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-avatar.d.ts +6 -6
- package/dist/components/ui/shadcn/shadcn-avatar.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-combobox.d.ts +15 -15
- package/dist/components/ui/shadcn/shadcn-combobox.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-dropdown-menu.d.ts +15 -15
- package/dist/components/ui/shadcn/shadcn-dropdown-menu.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-empty.d.ts +6 -6
- package/dist/components/ui/shadcn/shadcn-empty.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-pagination.d.ts +7 -7
- package/dist/components/ui/shadcn/shadcn-pagination.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-select.d.ts +11 -11
- package/dist/components/ui/shadcn/shadcn-select.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-tabs.d.ts +4 -4
- package/dist/components/ui/shadcn/shadcn-tabs.d.ts.map +1 -1
- package/dist/components/ui/shadcn/shadcn-tooltip.d.ts +4 -4
- package/dist/components/ui/shadcn/shadcn-tooltip.d.ts.map +1 -1
- package/dist/components/ui/sheet.d.ts +9 -9
- package/dist/components/ui/sheet.d.ts.map +1 -1
- package/dist/components/ui/sidebar.d.ts +23 -23
- package/dist/components/ui/sidebar.d.ts.map +1 -1
- package/dist/components/ui/skeleton.d.ts +1 -1
- package/dist/components/ui/skeleton.d.ts.map +1 -1
- package/dist/components/ui/slider.d.ts +2 -2
- package/dist/components/ui/slider.d.ts.map +1 -1
- package/dist/components/ui/sonner.d.ts +1 -1
- package/dist/components/ui/sonner.d.ts.map +1 -1
- package/dist/components/ui/spinner.d.ts +1 -1
- package/dist/components/ui/spinner.d.ts.map +1 -1
- package/dist/components/ui/switch.d.ts +1 -1
- package/dist/components/ui/switch.d.ts.map +1 -1
- package/dist/components/ui/table.d.ts +8 -8
- package/dist/components/ui/table.d.ts.map +1 -1
- package/dist/components/ui/tabs.d.ts +1 -1
- package/dist/components/ui/tabs.d.ts.map +1 -1
- package/dist/components/ui/textarea.d.ts +1 -1
- package/dist/components/ui/textarea.d.ts.map +1 -1
- package/dist/components/ui/toggle-group.d.ts +2 -2
- package/dist/components/ui/toggle-group.d.ts.map +1 -1
- package/dist/components/ui/toggle.d.ts +1 -1
- package/dist/components/ui/toggle.d.ts.map +1 -1
- package/dist/components/ui/tooltip.d.ts +1 -1
- package/dist/components/ui/tooltip.d.ts.map +1 -1
- package/dist/core.js +2 -2
- package/dist/{date-fns-BNhPf8zY.js → date-fns-DTKqTajJ.js} +2 -2
- package/dist/date-fns-locale.js +49 -50
- package/dist/date-fns.js +2 -2
- package/dist/{es6-DckNYvTU.js → es6-CLjPx7Zx.js} +6647 -6696
- package/dist/extended.js +2 -2
- package/dist/icons.js +2 -2
- package/dist/index.js +1178 -490
- package/dist/{input-group-Cw_lNmMp.js → input-group-Cs_7xSjN.js} +1460 -1258
- package/dist/{input-otp-oZKFMiS3.js → input-otp-CGTrl2aj.js} +3707 -3622
- package/dist/lib/opsfuse-portal-theme.d.ts +2 -2
- package/dist/lib/opsfuse-portal-theme.d.ts.map +1 -1
- package/dist/{lucide-react-BST2iBrS.js → lucide-react-Dil0H3iN.js} +11864 -11499
- package/dist/recharts.js +1 -1
- package/dist/style.css +232 -3
- package/dist/{toggle-group-DVYOAykn.js → toggle-group-BBYrK3NA.js} +3941 -3102
- package/package.json +1 -2
- package/theme.css +82 -21
- package/dist/style.layered.css +0 -3
- /package/dist/{clsx-BD2qMUU1.js → clsx-BWCAbrjV.js} +0 -0
- /package/dist/{isSameWeek-BUR9Q_Qt.js → isSameWeek-B6PEe-M_.js} +0 -0
|
@@ -176,7 +176,7 @@ Defined in `index.css` `@layer components`. Use these instead of manual font/siz
|
|
|
176
176
|
| `.caption` | 0.75rem | `--muted-foreground` | 1.5 | Timestamps, meta, helper text |
|
|
177
177
|
| `.label-sm` | 0.7rem | `--muted-foreground` | 1 | Uppercase section labels (uppercase + tracked) |
|
|
178
178
|
|
|
179
|
-
**Heading elements** (`h1`–`h4`) are styled
|
|
179
|
+
**Heading elements** (`h1`–`h4`) are styled globally via element selectors — no extra class needed. They all use `--foreground`.
|
|
180
180
|
|
|
181
181
|
---
|
|
182
182
|
|
|
@@ -23,7 +23,7 @@ import { Button } from "@/components/ui/button";
|
|
|
23
23
|
|
|
24
24
|
Never install `lucide-react`, `recharts`, or `date-fns` directly in host apps.
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
Design tokens are global (on `:root`), so components render with the default brand anywhere. Still wrap the app once in `OpsfuseThemeProvider` — it applies the brand (`brand-*`) class, syncs dark mode, themes portals, and mounts the imperative/tooltip providers.
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
@@ -1,468 +1,147 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: opsfuse-setup
|
|
3
3
|
description: >
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
(replacing existing UI with opsfuse equivalents), and applying consistent design tokens
|
|
7
|
-
across the entire app. Use when starting opsfuse integration or migrating an existing app.
|
|
4
|
+
Integrate opsfuse-ui into a React + Tailwind v4 app: install, CSS, fonts, brand theme,
|
|
5
|
+
OpsfuseThemeProvider, and migration. Use when starting integration or migrating an existing app.
|
|
8
6
|
---
|
|
9
7
|
|
|
10
|
-
# OpsFuse UI — Integration
|
|
8
|
+
# OpsFuse UI — Integration Guide
|
|
11
9
|
|
|
12
|
-
|
|
10
|
+
Follow phases in order. For tokens use `/color-theme`; for component APIs use `/components`; for code patterns use `/ui-consistency`.
|
|
13
11
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
## PHASE 0 — Discovery
|
|
17
|
-
|
|
18
|
-
Before touching anything, understand what you're working with:
|
|
12
|
+
## 0 — Discovery
|
|
19
13
|
|
|
20
|
-
|
|
21
|
-
2. **Detect the package manager** — `package.json` + lockfile (`package-lock.json` → npm, `yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm, `bun.lockb` → bun).
|
|
22
|
-
3. **Detect existing UI** — scan for shadcn, MUI, Chakra, Ant Design, Radix primitives, Tailwind utility classes. Note which components are used.
|
|
23
|
-
4. **Detect existing global CSS** — find the entry stylesheet imported in the app root.
|
|
24
|
-
5. **Find the app entry point** — `main.tsx`, `_app.tsx`, `app/layout.tsx`, `src/index.tsx`, etc.
|
|
14
|
+
Before changing anything:
|
|
25
15
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
16
|
+
1. Framework (Next App/Pages, Vite, Remix, etc.) and package manager (lockfile).
|
|
17
|
+
2. Existing UI (shadcn, MUI, Chakra, etc.) and which components are used.
|
|
18
|
+
3. Global CSS entry and app root (`layout.tsx`, `main.tsx`, etc.).
|
|
29
19
|
|
|
30
|
-
|
|
20
|
+
## 1 — Install
|
|
31
21
|
|
|
32
22
|
```bash
|
|
33
23
|
npm install opsfuse-ui
|
|
34
24
|
```
|
|
35
25
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
### 1b. TypeScript config
|
|
39
|
-
|
|
40
|
-
If the project has `tsconfig.json`, ensure `moduleResolution` is set to `"bundler"`, `"node16"`, or `"nodenext"` so `package.json` `exports` resolve correctly:
|
|
41
|
-
|
|
42
|
-
```json
|
|
43
|
-
{
|
|
44
|
-
"compilerOptions": {
|
|
45
|
-
"moduleResolution": "bundler"
|
|
46
|
-
}
|
|
47
|
-
}
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
---
|
|
51
|
-
|
|
52
|
-
## PHASE 2 — CSS & Font Setup
|
|
53
|
-
|
|
54
|
-
### 2a. Import opsfuse styles
|
|
55
|
-
|
|
56
|
-
Find the app's entry file (e.g. `main.tsx`, `_app.tsx`, `app/layout.tsx`) and add the single CSS import **before the host app's own Tailwind / global stylesheet**:
|
|
57
|
-
|
|
58
|
-
```ts
|
|
59
|
-
import "opsfuse-ui/styles.css"; // FIRST — before your Tailwind / global CSS
|
|
60
|
-
|
|
61
|
-
import "./index.css"; // your app's `@import "tailwindcss"` etc. — comes AFTER
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
For **Next.js App Router** add it first in `app/layout.tsx`; for **Pages Router** add it first in `pages/_app.tsx` — in both cases before `globals.css`.
|
|
65
|
-
|
|
66
|
-
**One bundle, every Tailwind version.** `styles.css` is a single precompiled, self-contained bundle that works on Tailwind v3, v4, and future hosts — there is nothing to choose. (`styles.layered.css` still exists as an identical backward-compat alias; prefer `styles.css`.) You do not run Tailwind over it.
|
|
67
|
-
|
|
68
|
-
**Import it _before_ your own CSS — this is the one rule that matters.** The bundle is fully **flat** (no cascade layers) and entirely **scoped to `.opsfuse-ui`**: its component utilities are single classes that out-specify your host's bare-element preflight (`*{…}`), so library components render with their intended borders, rings, sidebar states, etc. on **both** v3 and v4 — they can't be wiped by your host's reset. Library base resets use `:where(.opsfuse-ui)` (zero specificity), so your own utility classes still win. Importing first means equal-specificity ties resolve in your favor.
|
|
69
|
-
|
|
70
|
-
> The bundle ships **no global preflight** and no global `:root` palette — it never restyles your `html`, `body`, headings, form controls, or your Tailwind theme. A scoped equivalent applies only inside `.opsfuse-ui`, so component normalization is intact with zero document-level side effects.
|
|
71
|
-
|
|
72
|
-
> **Overrides:** because library utilities are un-layered, a host can't override a component purely through cascade layers. Override per-component via `className` instead — the library merges it with `cn()` / tailwind-merge, which drops the conflicting class so your value wins cleanly. (This requires components to live inside `<OpsfuseThemeProvider>`, which applies the `.opsfuse-ui` scope the tokens depend on.)
|
|
26
|
+
Peers: `react`, `react-dom` (same major). If `tsconfig.json` exists, prefer `"moduleResolution": "bundler"` (or `node16` / `nodenext`) so `exports` resolve.
|
|
73
27
|
|
|
74
|
-
|
|
28
|
+
## 2 — CSS & fonts
|
|
75
29
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
**Next.js (recommended):**
|
|
79
|
-
|
|
80
|
-
```tsx
|
|
81
|
-
// app/layout.tsx
|
|
82
|
-
import { Geist, Geist_Mono } from "next/font/google";
|
|
83
|
-
|
|
84
|
-
const geistSans = Geist({ subsets: ["latin"], variable: "--font-sans" });
|
|
85
|
-
const geistMono = Geist_Mono({ subsets: ["latin"], variable: "--font-mono" });
|
|
86
|
-
|
|
87
|
-
export default function RootLayout({
|
|
88
|
-
children,
|
|
89
|
-
}: {
|
|
90
|
-
children: React.ReactNode;
|
|
91
|
-
}) {
|
|
92
|
-
return (
|
|
93
|
-
<html lang="en" className={`${geistSans.variable} ${geistMono.variable}`}>
|
|
94
|
-
<body>{children}</body>
|
|
95
|
-
</html>
|
|
96
|
-
);
|
|
97
|
-
}
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
**Vite / CRA** — add to the global CSS file:
|
|
30
|
+
**Tailwind v4 required.** One import in the host global stylesheet (not from JS):
|
|
101
31
|
|
|
102
32
|
```css
|
|
103
|
-
|
|
104
|
-
@import
|
|
105
|
-
|
|
106
|
-
:root {
|
|
107
|
-
--font-sans: "Inter", system-ui, sans-serif;
|
|
108
|
-
--font-mono: "Geist Mono", "Fira Code", monospace;
|
|
109
|
-
}
|
|
33
|
+
@import "tailwindcss";
|
|
34
|
+
@import "opsfuse-ui/styles.css";
|
|
35
|
+
/* your @theme / @source below this */
|
|
110
36
|
```
|
|
111
37
|
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
### 2c. Tailwind v4 (if used)
|
|
115
|
-
|
|
116
|
-
If the host app uses Tailwind v4, point content at the built bundle so utility classes from the library resolve:
|
|
117
|
-
|
|
118
|
-
```js
|
|
119
|
-
// tailwind.config.js or @source in your CSS
|
|
120
|
-
content: [
|
|
121
|
-
"./src/**/*.{js,ts,jsx,tsx}",
|
|
122
|
-
"./node_modules/opsfuse-ui/dist/index.js",
|
|
123
|
-
],
|
|
38
|
+
```ts
|
|
39
|
+
import "./globals.css"; // layout / main — not opsfuse-ui/styles.css here
|
|
124
40
|
```
|
|
125
41
|
|
|
126
|
-
|
|
42
|
+
**Do**
|
|
127
43
|
|
|
128
|
-
|
|
44
|
+
- Import opsfuse **after** `tailwindcss`; put your `@theme` overrides **below** opsfuse.
|
|
45
|
+
- Scan **your** app source only — do **not** `@source` `node_modules/opsfuse-ui/dist/**/*.js` (breaks sidebar/tabs active states).
|
|
129
46
|
|
|
130
|
-
**
|
|
47
|
+
**Don't**
|
|
131
48
|
|
|
132
|
-
|
|
133
|
-
>
|
|
134
|
-
> 1. **RecruitSmartly** _(default)_ — Warm Minimal · Deep · Intelligent — Indigo primary
|
|
135
|
-
> 2. **SkillReady** — Warm · Confident · Growth-Oriented — Burnt Orange primary
|
|
136
|
-
> 3. **Verity** — Productive · Organized · Reliable — Emerald primary
|
|
137
|
-
> 4. **WorkLog** — Trustworthy · Precise · Authoritative — Cobalt primary
|
|
49
|
+
- Import `theme.css` separately or add `layer(opsfuse)` (obsolete).
|
|
138
50
|
|
|
139
|
-
|
|
51
|
+
**Fonts** — map host fonts to `--font-sans` / `--font-mono` (Next: `next/font` with `variable`; Vite: `:root` or existing font stack).
|
|
140
52
|
|
|
141
|
-
|
|
142
|
-
| -------------- | ------------------ | -------------------------------------------- |
|
|
143
|
-
| RecruitSmartly | `"recruitsmartly"` | `brand-recruitsmartly` (uses indigo default) |
|
|
144
|
-
| SkillReady | `"skillready"` | `brand-skillready` |
|
|
145
|
-
| Verity | `"verity"` | `brand-verity` |
|
|
146
|
-
| WorkLog | `"worklog"` | `brand-worklog` |
|
|
53
|
+
### Troubleshooting
|
|
147
54
|
|
|
148
|
-
|
|
55
|
+
| Symptom | Fix |
|
|
56
|
+
|--------|-----|
|
|
57
|
+
| All sidebar items look active / tabs never highlight | Remove host `@source` on opsfuse dist; use only the two imports above. |
|
|
58
|
+
| Tabs stay rounded in `line` variant | Tailwind v4 + package ≥ 0.1.10; confirm `data-[variant=line]:rounded-none` in built CSS. |
|
|
59
|
+
| Alert dialog header stays centered on `sm+` | Rebuild/reinstall; bundle should ship unlayered `alert-dialog-*` `text-align: left` at `sm`. |
|
|
149
60
|
|
|
150
|
-
|
|
61
|
+
## 3 — Brand theme
|
|
151
62
|
|
|
152
|
-
|
|
63
|
+
Ask the user to pick one:
|
|
153
64
|
|
|
154
|
-
|
|
65
|
+
| Brand | `theme` prop |
|
|
66
|
+
|-------|----------------|
|
|
67
|
+
| RecruitSmartly (default) | `"recruitsmartly"` |
|
|
68
|
+
| SkillReady | `"skillready"` |
|
|
69
|
+
| Verity | `"verity"` |
|
|
70
|
+
| WorkLog | `"worklog"` |
|
|
155
71
|
|
|
156
|
-
|
|
72
|
+
## 4 — Provider
|
|
157
73
|
|
|
158
|
-
**
|
|
74
|
+
Wrap the **entire app** once with `OpsfuseThemeProvider` (brand class, dark sync, portals, imperative APIs, tooltips, toaster). Do **not** nest `ConfirmationDialogProvider`, `TooltipProvider`, `AlertProvider`, `DialogProvider`, `SheetProvider`, `SliderDialogProvider`, or `Toaster` again in the entry file.
|
|
159
75
|
|
|
160
76
|
```tsx
|
|
161
77
|
import { OpsfuseThemeProvider } from "opsfuse-ui";
|
|
162
78
|
|
|
163
|
-
|
|
164
|
-
children
|
|
165
|
-
|
|
166
|
-
children: React.ReactNode;
|
|
167
|
-
}) {
|
|
168
|
-
return (
|
|
169
|
-
<html lang="en" className={`${geistSans.variable} ${geistMono.variable}`}>
|
|
170
|
-
<body>
|
|
171
|
-
<OpsfuseThemeProvider theme="skillready" className="min-h-svh">
|
|
172
|
-
{children}
|
|
173
|
-
</OpsfuseThemeProvider>
|
|
174
|
-
</body>
|
|
175
|
-
</html>
|
|
176
|
-
);
|
|
177
|
-
}
|
|
178
|
-
```
|
|
179
|
-
|
|
180
|
-
**Vite / CRA** — wrap in `main.tsx` or `App.tsx`:
|
|
181
|
-
|
|
182
|
-
```tsx
|
|
183
|
-
import { OpsfuseThemeProvider } from "opsfuse-ui";
|
|
184
|
-
|
|
185
|
-
createRoot(document.getElementById("root")!).render(
|
|
186
|
-
<StrictMode>
|
|
187
|
-
<OpsfuseThemeProvider theme="skillready" className="min-h-svh">
|
|
188
|
-
<App />
|
|
189
|
-
</OpsfuseThemeProvider>
|
|
190
|
-
</StrictMode>,
|
|
191
|
-
);
|
|
79
|
+
<OpsfuseThemeProvider theme="skillready" className="min-h-svh">
|
|
80
|
+
{children}
|
|
81
|
+
</OpsfuseThemeProvider>
|
|
192
82
|
```
|
|
193
83
|
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
`OpsfuseThemeProvider` (and `OpsfuseRoot`) already mount `ConfirmationDialogProvider`, `TooltipProvider`, `AlertProvider`, `DialogProvider`, `SheetProvider`, `SliderDialogProvider`, and `Toaster`. Wrap the app once — you do not manually nest those providers in `main.tsx`.
|
|
197
|
-
|
|
198
|
-
**Imperative API reference:**
|
|
199
|
-
| What you call | Where it is provided |
|
|
200
|
-
|---------------|---------------------|
|
|
201
|
-
| `toast.success/error()` from "sonner" | `<Toaster />` inside `<OpsfuseThemeProvider />` |
|
|
202
|
-
| `showAlert({ title, description, variant })` | `<AlertProvider />` inside theme |
|
|
203
|
-
| `openDialog({ title, children })` | `<DialogProvider />` inside theme |
|
|
204
|
-
| `openSheet({ title, children, side })` | `<SheetProvider />` inside theme |
|
|
205
|
-
| `confirm({ title, description?, onConfirm?, ... })` | `<ConfirmationDialogProvider />` inside theme |
|
|
206
|
-
| `openSlider({ title, value, min, max, ... })` | `<SliderDialogProvider />` inside theme |
|
|
207
|
-
| Any `<Tooltip>` anywhere | `<TooltipProvider />` inside theme |
|
|
208
|
-
|
|
209
|
-
---
|
|
210
|
-
|
|
211
|
-
## PHASE 5 — Component Migration
|
|
212
|
-
|
|
213
|
-
Scan the codebase for existing UI and replace with opsfuse equivalents. Work file by file. Do **not** batch-replace blindly — read each file first, understand context, then migrate.
|
|
214
|
-
|
|
215
|
-
### 5a. Component Replacement Map
|
|
216
|
-
|
|
217
|
-
| Existing pattern | opsfuse-ui replacement | Import |
|
|
218
|
-
| ----------------------------------------------- | ------------------------------------------------------------------- | ------------ |
|
|
219
|
-
| `<button>` / MUI `<Button>` / Chakra `<Button>` | `<Button variant="default">` | `opsfuse-ui` |
|
|
220
|
-
| `<input type="text">` / MUI `<TextField>` | `<Input label="..." />` | `opsfuse-ui` |
|
|
221
|
-
| `<select>` / MUI `<Select>` | `<Select>` + `<SelectTrigger>` + `<SelectContent>` + `<SelectItem>` | `opsfuse-ui` |
|
|
222
|
-
| `<textarea>` | `<Textarea />` | `opsfuse-ui` |
|
|
223
|
-
| `<label>` | `<Label htmlFor="...">` | `opsfuse-ui` |
|
|
224
|
-
| `<input type="checkbox">` | `<Checkbox />` | `opsfuse-ui` |
|
|
225
|
-
| `<input type="radio">` | `<RadioGroup>` + `<RadioGroupItem>` | `opsfuse-ui` |
|
|
226
|
-
| Toggle switch | `<Switch />` | `opsfuse-ui` |
|
|
227
|
-
| Card / Paper / Box | `<Card>` + `<CardHeader>` + `<CardContent>` | `opsfuse-ui` |
|
|
228
|
-
| Modal / Dialog | `<Dialog>` compound | `opsfuse-ui` |
|
|
229
|
-
| Destructive confirm | `confirm()` + `<ConfirmationDialogProvider />` (inside `OpsfuseThemeProvider`) | `opsfuse-ui` |
|
|
230
|
-
| Side panel / Drawer right | `<Sheet>` | `opsfuse-ui` |
|
|
231
|
-
| Bottom sheet / mobile drawer | `<Drawer>` | `opsfuse-ui` |
|
|
232
|
-
| Tabs | `<Tabs>` + `<TabsList>` + `<TabsTrigger>` + `<TabsContent>` | `opsfuse-ui` |
|
|
233
|
-
| Accordion / Collapse | `<Accordion>` compound | `opsfuse-ui` |
|
|
234
|
-
| Tooltip | `<Tooltip>` + `<TooltipTrigger>` + `<TooltipContent>` | `opsfuse-ui` |
|
|
235
|
-
| Popover / Floating panel | `<Popover>` compound | `opsfuse-ui` |
|
|
236
|
-
| Dropdown / Action menu | `<DropdownMenu>` compound | `opsfuse-ui` |
|
|
237
|
-
| Badge / Chip / Tag | `<Badge variant="default">` | `opsfuse-ui` |
|
|
238
|
-
| Alert / Banner | `<Alert>` + `<AlertTitle>` + `<AlertDescription>` | `opsfuse-ui` |
|
|
239
|
-
| Avatar / User icon | `<Avatar src={...} alt="..." fallback="AB" size="default" />` | `opsfuse-ui` |
|
|
240
|
-
| Skeleton / Loading placeholder | `<Skeleton />` | `opsfuse-ui` |
|
|
241
|
-
| Spinner / CircularProgress | `<Spinner />` | `opsfuse-ui` |
|
|
242
|
-
| Progress bar / LinearProgress | `<Progress value={n} />` | `opsfuse-ui` |
|
|
243
|
-
| Divider / `<hr>` | `<Separator />` | `opsfuse-ui` |
|
|
244
|
-
| ScrollArea | `<ScrollArea>` | `opsfuse-ui` |
|
|
245
|
-
| Data table / `<table>` | `<Table>` compound | `opsfuse-ui` |
|
|
246
|
-
| Breadcrumb nav | `<Breadcrumb>` compound | `opsfuse-ui` |
|
|
247
|
-
| Page title + breadcrumb + actions | `<PageHeader>` + optional `<Breadcrumb>` | `opsfuse-ui` |
|
|
248
|
-
| Pagination | `<Pagination>` compound | `opsfuse-ui` |
|
|
249
|
-
| Toast notification | `toast()` from `"sonner"` | `sonner` |
|
|
250
|
-
| Searchable dropdown | `<Combobox />` | `opsfuse-ui` |
|
|
251
|
-
| Command palette / ⌘K | `<Command>` compound | `opsfuse-ui` |
|
|
252
|
-
| Date picker | `<Calendar>` + `<Popover>` | `opsfuse-ui` |
|
|
253
|
-
| Sidebar layout | `<SidebarProvider>` + `<Sidebar>` compound | `opsfuse-ui` |
|
|
254
|
-
| Resizable panels | `<ResizablePanelGroup>` + `<ResizablePanel>` | `opsfuse-ui` |
|
|
255
|
-
| Recharts chart | `<ChartContainer>` + Recharts components | `opsfuse-ui` |
|
|
256
|
-
| Segmented button group | `<ButtonGroup>` | `opsfuse-ui` |
|
|
257
|
-
| Toggle / icon toggle | `<Toggle>` or `<ToggleGroup>` | `opsfuse-ui` |
|
|
258
|
-
| Form field with label+error | `<Field>` compound | `opsfuse-ui` |
|
|
259
|
-
| Input with prefix/suffix | `<InputGroup>` | `opsfuse-ui` |
|
|
260
|
-
| OTP input | `<InputOTP>` compound | `opsfuse-ui` |
|
|
261
|
-
| Keyboard shortcut | `<Kbd>` | `opsfuse-ui` |
|
|
262
|
-
| Empty state | `<Empty description="…" title="…" icon={…} actionLabel="…" onAction={…} />` (default import) | `opsfuse-ui` |
|
|
263
|
-
|
|
264
|
-
### 5b. Button variant mapping
|
|
265
|
-
|
|
266
|
-
| Existing style | opsfuse-ui variant |
|
|
267
|
-
| ---------------------- | ----------------------- |
|
|
268
|
-
| Primary / filled / CTA | `variant="default"` |
|
|
269
|
-
| Secondary / outlined | `variant="outline"` |
|
|
270
|
-
| Tertiary / neutral | `variant="secondary"` |
|
|
271
|
-
| Ghost / icon button | `variant="ghost"` |
|
|
272
|
-
| Danger / delete | `variant="destructive"` |
|
|
273
|
-
| Text link button | `variant="link"` |
|
|
274
|
-
|
|
275
|
-
Button sizes: `size="default"` (36px) · `size="sm"` (32px) · `size="xs"` (28px) · `size="lg"` (40px) · `size="icon"` · `size="icon-sm"` · `size="icon-xs"`
|
|
276
|
-
|
|
277
|
-
### 5c. Migration rules
|
|
278
|
-
|
|
279
|
-
1. **Read before replacing** — always read the file before editing.
|
|
280
|
-
2. **Preserve logic** — only change UI markup. Do not alter state, event handlers, data fetching, or business logic.
|
|
281
|
-
3. **Map props faithfully** — `onClick`, `disabled`, `className` carry over. `variant`, `color`, `size` map per the tables above.
|
|
282
|
-
4. **Icon-only buttons** — always add `aria-label`: `<Button size="icon" aria-label="Close"><XIcon /></Button>`
|
|
283
|
-
5. **Form fields** — use `<Input label="Name" />` instead of separate `<Label>` + `<input>` unless you need finer control.
|
|
284
|
-
6. **Destructive actions** — replace `window.confirm()` or simple confirm dialogs with `confirm({ title, description, onConfirm })` and the provider stack above; use `Button variant="destructive"` for the trigger where appropriate.
|
|
285
|
-
7. **Remove old UI library imports** — after migrating a file, remove MUI/Chakra/shadcn imports that are no longer needed.
|
|
286
|
-
|
|
287
|
-
### 5d. Lighter entrypoints (performance-sensitive apps)
|
|
288
|
-
|
|
289
|
-
For apps that don't use heavy components (charts, calendar, carousel, etc.), prefer the core entrypoint:
|
|
290
|
-
|
|
291
|
-
```ts
|
|
292
|
-
import { Button, Badge, Input, Card, OpsfuseRoot } from "opsfuse-ui/core";
|
|
293
|
-
// Only import extended components where actually needed:
|
|
294
|
-
import { ChartContainer, Calendar } from "opsfuse-ui/extended";
|
|
295
|
-
```
|
|
296
|
-
|
|
297
|
-
---
|
|
298
|
-
|
|
299
|
-
## PHASE 6 — Color & Token Migration
|
|
300
|
-
|
|
301
|
-
Replace all hardcoded colors, arbitrary Tailwind palette classes, and old theme variables with opsfuse design tokens.
|
|
302
|
-
|
|
303
|
-
### 6a. Surface tokens (shadcn-aligned)
|
|
304
|
-
|
|
305
|
-
| Old pattern | opsfuse token |
|
|
306
|
-
| ------------------------------ | ----------------------------------- |
|
|
307
|
-
| `bg-white`, `bg-gray-50` | `bg-(--background)` (page canvas) |
|
|
308
|
-
| `bg-white` on cards | `bg-(--card)` |
|
|
309
|
-
| `bg-gray-100`, `bg-gray-200` | `bg-(--muted)` |
|
|
310
|
-
| `bg-gray-50` on hover rows | `bg-(--accent)` |
|
|
311
|
-
| `bg-white` on dropdowns/modals | `bg-(--popover)` |
|
|
312
|
-
|
|
313
|
-
### 6b. Text tokens
|
|
314
|
-
|
|
315
|
-
| Old pattern | opsfuse token |
|
|
316
|
-
| -------------------------------- | ------------------------- |
|
|
317
|
-
| `text-gray-900`, `text-black` | `text-(--foreground)` |
|
|
318
|
-
| `text-gray-600`, `text-gray-700` | `text-(--subtle-foreground)` |
|
|
319
|
-
| `text-gray-400`, `text-gray-500` | `text-(--muted-foreground)` |
|
|
320
|
-
| `text-gray-300`, disabled text | `text-(--disabled-foreground)` |
|
|
321
|
-
|
|
322
|
-
### 6c. Border tokens
|
|
323
|
-
|
|
324
|
-
| Old pattern | opsfuse token |
|
|
325
|
-
| ------------------------------------ | --------------------------- |
|
|
326
|
-
| `border-gray-100` | `border-(--border-subtle)` |
|
|
327
|
-
| `border-gray-200`, `border-gray-300` | `border-(--border)` |
|
|
328
|
-
| `border-gray-400` (active/hover) | `border-(--border-strong)` |
|
|
329
|
-
|
|
330
|
-
### 6d. Primary / brand color tokens
|
|
331
|
-
|
|
332
|
-
| Old pattern | opsfuse token |
|
|
333
|
-
| ------------------------------ | --------------------------- |
|
|
334
|
-
| `bg-blue-600`, `bg-indigo-600` | `bg-(--primary)` |
|
|
335
|
-
| `text-white` on primary bg | `text-(--primary-foreground)` |
|
|
336
|
-
| `bg-blue-50` selected item bg | `bg-(--primary-muted)` |
|
|
337
|
-
| `border-blue-200` | `border-(--primary-border)` |
|
|
338
|
-
| `text-blue-700` on tinted bg | `text-(--primary-muted-foreground)` |
|
|
339
|
-
|
|
340
|
-
### 6e. Semantic state tokens
|
|
341
|
-
|
|
342
|
-
| Old pattern | opsfuse token |
|
|
343
|
-
| -------------------------------- | ------------------------ |
|
|
344
|
-
| `text-green-600` / success icon | `text-(--success)` |
|
|
345
|
-
| `bg-green-50` success bg | `bg-(--success-muted)` |
|
|
346
|
-
| `text-yellow-600` / warning icon | `text-(--warning)` |
|
|
347
|
-
| `bg-yellow-50` warning bg | `bg-(--warning-muted)` |
|
|
348
|
-
| `text-red-600` / error icon | `text-(--destructive)` |
|
|
349
|
-
| `bg-red-50` error bg | `bg-(--destructive-muted)` |
|
|
350
|
-
| `text-blue-600` / info icon | `text-(--info)` |
|
|
351
|
-
| `bg-blue-50` info bg | `bg-(--info-muted)` |
|
|
352
|
-
|
|
353
|
-
### 6f. Typography classes
|
|
354
|
-
|
|
355
|
-
Replace manual `text-xs text-gray-400` combos with semantic classes:
|
|
356
|
-
|
|
357
|
-
| Old pattern | opsfuse class |
|
|
358
|
-
| ----------------------------------------------- | ------------- |
|
|
359
|
-
| `text-sm text-gray-700 leading-relaxed` body | `.prose-ui` |
|
|
360
|
-
| `text-base text-gray-600 leading-loose` article | `.prose-body` |
|
|
361
|
-
| `text-xs text-gray-400` meta / timestamp | `.caption` |
|
|
362
|
-
| `text-xs uppercase tracking-wide` label | `.label-sm` |
|
|
363
|
-
| AI response text | `.prose-ai` |
|
|
364
|
-
| `font-mono text-sm` code/stats | `.prose-mono` |
|
|
365
|
-
|
|
366
|
-
### 6g. Transition classes
|
|
367
|
-
|
|
368
|
-
| Old pattern | opsfuse class |
|
|
369
|
-
| ------------------------------------------ | -------------------- |
|
|
370
|
-
| `transition duration-150` on buttons/chips | `.transition-micro` |
|
|
371
|
-
| `transition duration-200` on inputs/panels | `.transition-smooth` |
|
|
372
|
-
| `transition duration-500` on bars/graphs | `.transition-data` |
|
|
373
|
-
|
|
374
|
-
---
|
|
375
|
-
|
|
376
|
-
## PHASE 7 — Dark Mode
|
|
377
|
-
|
|
378
|
-
If the app supports dark mode:
|
|
84
|
+
**Imperative APIs** (all provided by the theme provider):
|
|
379
85
|
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
86
|
+
| API | Use |
|
|
87
|
+
|-----|-----|
|
|
88
|
+
| `toast.*` from `sonner` | Notifications |
|
|
89
|
+
| `showAlert({ … })` | Alert dialog |
|
|
90
|
+
| `openDialog` / `openSheet` / `openSlider` | Overlays |
|
|
91
|
+
| `confirm({ … })` | Destructive confirm |
|
|
92
|
+
| `<Tooltip>` | Tooltips |
|
|
384
93
|
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
## PHASE 8 — Verification Checklist
|
|
94
|
+
## 5 — Component migration
|
|
388
95
|
|
|
389
|
-
|
|
96
|
+
Work file by file: read context, replace UI only, keep logic. Remove dead imports from the old library.
|
|
390
97
|
|
|
391
|
-
|
|
392
|
-
- [ ] `--font-sans` CSS variable is set (fonts load)
|
|
393
|
-
- [ ] `<OpsfuseThemeProvider theme="...">` wraps the entire app
|
|
394
|
-
- [ ] Chosen brand theme appears on `OpsfuseThemeProvider` and visually matches
|
|
395
|
-
- [ ] Tooltip and toast APIs work if you use them (`TooltipProvider` and `<Toaster />` are inside `OpsfuseThemeProvider`)
|
|
396
|
-
- [ ] No hardcoded hex colors remain in migrated files
|
|
397
|
-
- [ ] No `text-gray-*` or `bg-gray-*` Tailwind palette classes in migrated files
|
|
398
|
-
- [ ] Icon-only buttons all have `aria-label`
|
|
399
|
-
- [ ] Form fields pair inputs with labels
|
|
400
|
-
- [ ] Destructive actions use `confirm()` (works with `<OpsfuseThemeProvider />` / `<OpsfuseRoot />` — no duplicate confirmation provider)
|
|
401
|
-
- [ ] App renders correctly in both light and dark mode (if dark mode is supported)
|
|
402
|
-
- [ ] TypeScript compiles with no errors (`tsc --noEmit`)
|
|
98
|
+
Use `/components` for the full replacement map, variants, and composition. Quick mappings:
|
|
403
99
|
|
|
404
|
-
|
|
100
|
+
| Was | Use |
|
|
101
|
+
|-----|-----|
|
|
102
|
+
| Button | `<Button variant="…">` |
|
|
103
|
+
| Text field | `<Input label="…" />` or `<Field>` |
|
|
104
|
+
| Select | `<Select>` compound |
|
|
105
|
+
| Modal | `<Dialog>` or `openDialog` |
|
|
106
|
+
| Drawer | `<Sheet>` / `<Drawer>` |
|
|
107
|
+
| Confirm | `confirm()` not `window.confirm()` |
|
|
108
|
+
| Toast | `toast()` from `sonner` |
|
|
405
109
|
|
|
406
|
-
|
|
110
|
+
**Rules:** preserve handlers/state; icon-only buttons need `aria-label`; destructive flows use `confirm()` + `variant="destructive"` where appropriate.
|
|
407
111
|
|
|
408
|
-
|
|
112
|
+
**Bundle size:** prefer `opsfuse-ui/core` for light apps; `opsfuse-ui/extended` only where needed (charts, calendar, etc.).
|
|
409
113
|
|
|
410
|
-
|
|
411
|
-
<OpsfuseThemeProvider theme="recruitsmartly">
|
|
412
|
-
```
|
|
114
|
+
## 6 — Tokens & dark mode
|
|
413
115
|
|
|
414
|
-
|
|
415
|
-
- Primary: Indigo `oklch(0.56 0.19 278)`
|
|
416
|
-
- Surfaces: Cool indigo-tinted whites
|
|
417
|
-
- Best for: AI-powered recruitment, talent intelligence platforms
|
|
116
|
+
Replace hardcoded colors and `gray-*` / palette utilities with opsfuse tokens — see `/color-theme`.
|
|
418
117
|
|
|
419
|
-
|
|
118
|
+
Dark mode: add `dark` on `<html>`; tokens switch automatically. Use `dark:` with token classes, not hardcoded hex overrides.
|
|
420
119
|
|
|
421
|
-
|
|
422
|
-
<OpsfuseThemeProvider theme="skillready">
|
|
423
|
-
```
|
|
120
|
+
## 7 — Verify
|
|
424
121
|
|
|
425
|
-
-
|
|
426
|
-
-
|
|
427
|
-
-
|
|
428
|
-
-
|
|
122
|
+
- [ ] `@import "opsfuse-ui/styles.css"` after `tailwindcss` in global CSS only
|
|
123
|
+
- [ ] No `@source` on opsfuse `dist/`
|
|
124
|
+
- [ ] `--font-sans` set; fonts render
|
|
125
|
+
- [ ] Single `OpsfuseThemeProvider` with chosen `theme`
|
|
126
|
+
- [ ] Tooltips / toasts / `confirm()` work if used
|
|
127
|
+
- [ ] Migrated files use tokens, not `text-gray-*` / hex
|
|
128
|
+
- [ ] `tsc --noEmit` clean
|
|
129
|
+
- [ ] Light + dark checked if the app supports dark mode
|
|
429
130
|
|
|
430
|
-
|
|
131
|
+
## Minimal Next.js snippet
|
|
431
132
|
|
|
432
|
-
```
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
- Personality: Productive · Organized · Reliable
|
|
437
|
-
- Primary: Emerald `oklch(0.57 0.15 165)`
|
|
438
|
-
- Surfaces: Cool sage-green tinted
|
|
439
|
-
- Best for: Work management, activity logging, productivity tools
|
|
440
|
-
|
|
441
|
-
### 4. WorkLog
|
|
442
|
-
|
|
443
|
-
```tsx
|
|
444
|
-
<OpsfuseThemeProvider theme="worklog">
|
|
133
|
+
```css
|
|
134
|
+
/* app/globals.css */
|
|
135
|
+
@import "tailwindcss";
|
|
136
|
+
@import "opsfuse-ui/styles.css";
|
|
445
137
|
```
|
|
446
138
|
|
|
447
|
-
- Personality: Trustworthy · Precise · Authoritative
|
|
448
|
-
- Primary: Cobalt `oklch(0.54 0.2 265)`
|
|
449
|
-
- Surfaces: Cool slate-blue tinted
|
|
450
|
-
- Best for: Compliance tools, verification platforms, precision dashboards
|
|
451
|
-
|
|
452
|
-
---
|
|
453
|
-
|
|
454
|
-
## Minimal Setup Snippet (copy-paste start)
|
|
455
|
-
|
|
456
139
|
```tsx
|
|
457
|
-
//
|
|
458
|
-
import "
|
|
140
|
+
// app/layout.tsx
|
|
141
|
+
import "./globals.css";
|
|
459
142
|
import { OpsfuseThemeProvider } from "opsfuse-ui";
|
|
460
143
|
|
|
461
|
-
export default function RootLayout({
|
|
462
|
-
children,
|
|
463
|
-
}: {
|
|
464
|
-
children: React.ReactNode;
|
|
465
|
-
}) {
|
|
144
|
+
export default function RootLayout({ children }: { children: React.ReactNode }) {
|
|
466
145
|
return (
|
|
467
146
|
<html lang="en">
|
|
468
147
|
<body>
|
|
@@ -475,19 +154,15 @@ export default function RootLayout({
|
|
|
475
154
|
}
|
|
476
155
|
```
|
|
477
156
|
|
|
478
|
-
|
|
157
|
+
Vite/CRA: same CSS imports; wrap `<App />` in `main.tsx`.
|
|
479
158
|
|
|
480
159
|
## Do / Don't
|
|
481
160
|
|
|
482
|
-
|
|
|
483
|
-
|
|
484
|
-
|
|
|
485
|
-
|
|
|
486
|
-
|
|
|
487
|
-
|
|
|
488
|
-
|
|
|
489
|
-
|
|
|
490
|
-
| Import icons from `opsfuse-ui/icons` | Import from `lucide-react` or other icon libraries |
|
|
491
|
-
| Import dates from `opsfuse-ui/date-fns` | Install or import `date-fns` directly |
|
|
492
|
-
| Use `<Field>` for form layout | Raw `div` + `label` + `input` |
|
|
493
|
-
| Test light AND dark mode after migration | Only check light mode |
|
|
161
|
+
| Do | Don't |
|
|
162
|
+
|----|-------|
|
|
163
|
+
| One global CSS import after Tailwind | Import styles from JS or `@source` opsfuse dist |
|
|
164
|
+
| One root `OpsfuseThemeProvider` | Per-component theme wrappers or duplicate providers |
|
|
165
|
+
| `cn()` from `opsfuse-ui` | Concatenate class strings |
|
|
166
|
+
| Tokens + `/color-theme` | `text-gray-600`, arbitrary hex |
|
|
167
|
+
| Icons from `opsfuse-ui/icons` | `lucide-react` in consuming apps |
|
|
168
|
+
| `confirm()` for destructive actions | `window.confirm()` |
|
|
@@ -107,7 +107,7 @@ Imperative APIs and where they are satisfied:
|
|
|
107
107
|
|
|
108
108
|
## 3. DARK MODE
|
|
109
109
|
|
|
110
|
-
All tokens have dark values in `brands.css` under `
|
|
110
|
+
All tokens have dark values in `brands.css` under `.dark` (default brand) and `.brand-*.dark` selectors; `OpsfuseThemeProvider` toggles `dark` on the scope element by watching the host's dark convention.
|
|
111
111
|
When adding custom dark styles: use the `dark:` Tailwind prefix.
|
|
112
112
|
Never hardcode hex colors — tokens handle light/dark automatically.
|
|
113
113
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
//#region \0rolldown/runtime.js
|
|
2
|
-
var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, r = Object.getOwnPropertyNames, i = Object.getPrototypeOf, a = Object.prototype.hasOwnProperty, o = (e, t) => () => (t || e((t = { exports: {} }).exports, t), t.exports), s = (e, n) => {
|
|
2
|
+
var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, r = Object.getOwnPropertyNames, i = Object.getPrototypeOf, a = Object.prototype.hasOwnProperty, o = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), s = (e, n) => {
|
|
3
3
|
let r = {};
|
|
4
4
|
for (var i in e) t(r, i, {
|
|
5
5
|
get: e[i],
|
|
@@ -38,6 +38,6 @@ type LogoMakerProps = BaseLogoProps & {
|
|
|
38
38
|
productY?: number;
|
|
39
39
|
onlyIcon?: boolean;
|
|
40
40
|
};
|
|
41
|
-
declare const LogoMaker: ({ size, fit, showLogo, brandFontSize, productFontSize, viewBoxX, viewBoxY, viewBoxWidth, viewBoxHeight, primary, primaryDeep, gradient, reverseGradient, textStartX, mark, markTransform, productLabel, brandY, dividerY, productY, style, className, width: widthProp, height: heightProp, onlyIcon, ...props }: LogoMakerProps) => import("react
|
|
41
|
+
declare const LogoMaker: ({ size, fit, showLogo, brandFontSize, productFontSize, viewBoxX, viewBoxY, viewBoxWidth, viewBoxHeight, primary, primaryDeep, gradient, reverseGradient, textStartX, mark, markTransform, productLabel, brandY, dividerY, productY, style, className, width: widthProp, height: heightProp, onlyIcon, ...props }: LogoMakerProps) => import("react").JSX.Element;
|
|
42
42
|
export default LogoMaker;
|
|
43
43
|
//# sourceMappingURL=LogoMaker.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"LogoMaker.d.ts","sourceRoot":"","sources":["../../../src/components/logo/LogoMaker.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,OAAO,CAAC;AAIf,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG;IACpD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,KAAK,cAAc,GAAG,aAAa,GAAG;IACpC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,SAAS,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,QAAA,MAAM,SAAS,GAAI,kTA2BhB,cAAc,
|
|
1
|
+
{"version":3,"file":"LogoMaker.d.ts","sourceRoot":"","sources":["../../../src/components/logo/LogoMaker.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,OAAO,CAAC;AAIf,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG;IACpD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,KAAK,cAAc,GAAG,aAAa,GAAG;IACpC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,SAAS,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,QAAA,MAAM,SAAS,GAAI,kTA2BhB,cAAc,gCAiIhB,CAAC;AAEF,eAAe,SAAS,CAAC"}
|