@nqlib/nqui 0.4.4 → 0.4.5

package/INSTALLATION.md

@@ -129,7 +129,21 @@ Add the nqui import to your **main CSS file**:
 
 **Option B:** Copy the **entire contents** of `nqui/nqui-setup.css` to the **very top** of your main CSS file.
 
-### 2c. Next.js + Tailwind v4
+### 2c. Vite + Tailwind v4
+
+With `@tailwindcss/vite`, Tailwind usually scans your app files automatically. If **components look unstyled**, **spacing or button classes from `@nqlib/nqui` are missing**, or utilities used only inside the installed package do not appear in CSS, add these **`@source` lines after** `@import "@nqlib/nqui/styles";` in your main stylesheet (paths are relative to that CSS file — adjust if your entry is not `src/index.css`):
+
+```css
+@import "@nqlib/nqui/styles";
+
+@source "./**/*.{js,ts,jsx,tsx,mdx}";
+@source "../components/**/*.{js,ts,jsx,tsx,mdx}";
+@source "../node_modules/@nqlib/nqui/dist/**/*.js";
+```
+
+Example layout: `src/index.css` → `../components` is `src/components`, `../node_modules` is the project root `node_modules`.
+
+### 2d. Next.js + Tailwind v4
 
 Include these in your main CSS:
 
@@ -139,7 +153,7 @@ Include these in your main CSS:
 @source "../node_modules/@nqlib/nqui/dist/**/*.js";
 ```
 
-### 2d. Custom path
+### 2e. Custom path
 
 ```bash
 npx @nqlib/nqui init-css app/styles/nqui.css
@@ -205,6 +219,11 @@ To switch between a **local** (linked) build and the **published** npm package d
 
 Your main CSS is missing the nqui import. Add `@import "@nqlib/nqui/styles";` or paste the contents of `nqui/nqui-setup.css` at the top of your main CSS.
 
+**Vite: broken layout, missing spacing, or button styles**
+
+1. Confirm `@import "@nqlib/nqui/styles";` is present and `@tailwindcss/vite` is in `vite.config.ts`.
+2. Add the **`@source` directives** from [§2c Vite + Tailwind v4](#2c-vite--tailwind-v4) so Tailwind scans your app and `node_modules/@nqlib/nqui/dist`.
+
 **Debug Panel not showing**
 
 - Ensure `NODE_ENV !== 'production'`.

package/README.md

@@ -139,9 +139,14 @@ See [Troubleshooting](#troubleshooting).
 @import "tailwindcss";
 @import "tw-animate-css";
 @import "@nqlib/nqui/styles";
+
+/* Add if styles from @nqlib/nqui look missing (see INSTALLATION.md §2c) */
+@source "./**/*.{js,ts,jsx,tsx,mdx}";
+@source "../components/**/*.{js,ts,jsx,tsx,mdx}";
+@source "../node_modules/@nqlib/nqui/dist/**/*.js";
 ```
 
-Vite with `@tailwindcss/vite` does not need the same `@source` directives as Next.js.
+Vite with `@tailwindcss/vite` often works without `@source`; add the block above when utilities from the package do not show up in CSS.
 
 2. **Components:**
 
@@ -268,7 +273,7 @@ Components are framework-agnostic for any React setup.
 ### `@source`: Next.js vs Vite
 
 - **Next.js** needs `@source` lines so Tailwind sees app and `node_modules/@nqlib/nqui` — see the Quick Start block above.
-- **Vite** typically does not need those `@source` lines when using `@tailwindcss/vite`.
+- **Vite** often works without extra `@source` lines; if components look unstyled, use the same three `@source` paths after `@import "@nqlib/nqui/styles";` ([INSTALLATION.md](./INSTALLATION.md) §2c).
 
 ### Module resolution (Next.js 16+, local packages)
 

package/dist/components/custom/enhanced-radio-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enhanced-radio-group.d.ts","sourceRoot":"","sources":["../../../src/components/custom/enhanced-radio-group.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAe5D,MAAM,WAAW,uBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC;IAC7D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,QAAA,MAAM,kBAAkB,6GAsOtB,CAAA;AAIF,MAAM,WAAW,2BACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC;IAC7D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,CAAA;CAChD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAA,MAAM,sBAAsB,oHAkJ1B,CAAA;AAIF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,IAAI,UAAU,EAAE,sBAAsB,EAAE,sBAAsB,IAAI,cAAc,EAAE,CAAA;AACjI,YAAY,EAAE,uBAAuB,IAAI,eAAe,EAAE,2BAA2B,IAAI,mBAAmB,EAAE,CAAA"}
+{"version":3,"file":"enhanced-radio-group.d.ts","sourceRoot":"","sources":["../../../src/components/custom/enhanced-radio-group.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAe5D,MAAM,WAAW,uBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC;IAC7D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,QAAA,MAAM,kBAAkB,6GAsOtB,CAAA;AAIF,MAAM,WAAW,2BACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC;IAC7D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,CAAA;CAChD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAA,MAAM,sBAAsB,oHAqJ1B,CAAA;AAIF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,IAAI,UAAU,EAAE,sBAAsB,EAAE,sBAAsB,IAAI,cAAc,EAAE,CAAA;AACjI,YAAY,EAAE,uBAAuB,IAAI,eAAe,EAAE,2BAA2B,IAAI,mBAAmB,EAAE,CAAA"}

package/dist/components/ui/frosted-glass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frosted-glass.d.ts","sourceRoot":"","sources":["../../../src/components/ui/frosted-glass.tsx"],"names":[],"mappings":"AAGA,UAAU,iBAAiB;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,iBAAS,YAAY,CAAC,EACpB,IAAS,EACT,YAAgB,EAChB,SAAS,GACV,EAAE,iBAAiB,2CAgEnB;AAED,OAAO,EAAE,YAAY,EAAE,CAAA;AACvB,YAAY,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"frosted-glass.d.ts","sourceRoot":"","sources":["../../../src/components/ui/frosted-glass.tsx"],"names":[],"mappings":"AAGA,UAAU,iBAAiB;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,iBAAS,YAAY,CAAC,EACpB,IAAS,EACT,YAAgB,EAChB,SAAS,GACV,EAAE,iBAAiB,2CA0DnB;AAED,OAAO,EAAE,YAAY,EAAE,CAAA;AACvB,YAAY,EAAE,iBAAiB,EAAE,CAAA"}