@sabrenski/spire-ui-vue 0.2.1 → 0.2.3

package/README.md

@@ -22,15 +22,19 @@ npm install vue@^3.0.0
 
 ### 1. CSS Setup (Required)
 
-Spire UI uses Tailwind CSS v4's `@theme` directive for theming. Import the theme CSS **before** `tailwindcss` in your main CSS file:
+Spire UI uses Tailwind CSS v4's `@theme` directive for theming. Add these imports to your main CSS file:
 
 ```css
 /* app.css */
 @import "@sabrenski/spire-ui-vue/theme.css";
 @import "tailwindcss";
+
+/* Required: Tell Tailwind to scan component files for utility classes */
+@source "../node_modules/@sabrenski/spire-ui-vue/dist/**/*.js";
 ```
 
-This allows Tailwind to process the theme tokens and generate utility classes like `bg-primary`, `text-foreground`, etc.
+- **theme.css** - Must be imported **before** `tailwindcss` so Tailwind processes the theme tokens
+- **@source** - Required for Tailwind to discover which utility classes the components use
 
 ### 2. Vue Plugin Setup
 
@@ -357,12 +361,15 @@ Spire UI provides two CSS exports:
 | `@sabrenski/spire-ui-vue/theme.css` | Raw `@theme` tokens for Tailwind v4 to process |
 | `@sabrenski/spire-ui-vue/style.css` | Pre-built component styles (optional) |
 
-For Tailwind v4 projects, import `theme.css` **before** `tailwindcss`:
+For Tailwind v4 projects:
 
 ```css
 /* app.css */
 @import "@sabrenski/spire-ui-vue/theme.css";
 @import "tailwindcss";
+
+/* Required: Scan component files for utility classes */
+@source "../node_modules/@sabrenski/spire-ui-vue/dist/**/*.js";
 ```
 
 You can also import individual theme files:

package/dist/composables/useComponentAs.d.ts

@@ -0,0 +1,9 @@
+import { Component } from 'vue';
+type AsValue = 'a' | 'button' | 'router-link' | 'inertia-link' | Component;
+/**
+ * Composable that resolves string aliases like 'inertia-link' and 'router-link'
+ * to their actual Vue components. Falls back to the specified fallback element
+ * if the component cannot be loaded.
+ */
+export declare function useComponentAs(as: () => AsValue | undefined, fallback?: string): import('vue').ComputedRef<any>;
+export {};