@donotdev/cli 0.0.18 → 0.0.20

package/templates/root-consumer/guides/dndev/USE_ROUTING.md.example

@@ -13,7 +13,7 @@ import { Link, useNavigate, useParams } from 'react-router-dom'; // ❌ BREAKS F
 
 **✅ CORRECT:**
 ```tsx
-import { Link, useNavigate, useParams } from '@donotdev/ui/routing'; // ✅ Framework routing
+import { Link, useNavigate, useParams } from '@donotdev/ui'; // ✅ Framework routing
 ```
 
 **Why?** The framework's routing components:
@@ -30,7 +30,7 @@ import { Link, useNavigate, useParams } from '@donotdev/ui/routing'; // ✅ Fram
 ### Components
 
 ```tsx
-import { Link, DnDevNavigationMenu } from '@donotdev/ui/routing';
+import { Link, DnDevNavigationMenu } from '@donotdev/ui';
 ```
 
 **Link Component:**
@@ -55,7 +55,7 @@ import {
   useRouteParam,
   useSearchParams,
   useNavigationItems,
-} from '@donotdev/ui/routing';
+} from '@donotdev/ui';
 ```
 
 ---
@@ -66,7 +66,7 @@ import {
 
 **✅ Use framework Link:**
 ```tsx
-import { Link } from '@donotdev/ui/routing';
+import { Link } from '@donotdev/ui';
 
 function ProductCard({ product }) {
   return (
@@ -77,7 +77,7 @@ function ProductCard({ product }) {
 
 **✅ Use framework useNavigate:**
 ```tsx
-import { useNavigate } from '@donotdev/ui/routing';
+import { useNavigate } from '@donotdev/ui';
 
 function ProductForm() {
   const navigate = useNavigate();
@@ -107,7 +107,7 @@ function ProductForm() {
 
 **✅ Use framework useRouteParam:**
 ```tsx
-import { useRouteParam } from '@donotdev/ui/routing';
+import { useRouteParam } from '@donotdev/ui';
 
 function ProductPage() {
   const id = useRouteParam('id'); // ✅ Returns string | undefined
@@ -117,7 +117,7 @@ function ProductPage() {
 
 **✅ Or use framework useParams:**
 ```tsx
-import { useParams } from '@donotdev/ui/routing';
+import { useParams } from '@donotdev/ui';
 
 function ProductPage() {
   const params = useParams();
@@ -136,7 +136,7 @@ import { useParams } from 'react-router-dom'; // ❌ Type issues, breaks framewo
 
 **✅ Use DnDevNavigationMenu (auto-fetches routes):**
 ```tsx
-import { DnDevNavigationMenu, DISPLAY } from '@donotdev/ui/routing';
+import { DnDevNavigationMenu, DISPLAY } from '@donotdev/ui';
 
 function Sidebar() {
   return (
@@ -151,7 +151,7 @@ function Sidebar() {
 
 **✅ Or use useNavigationItems for custom sidebar:**
 ```tsx
-import { Link, useNavigationItems } from '@donotdev/ui/routing';
+import { Link, useNavigationItems } from '@donotdev/ui';
 
 function CustomSidebar() {
   const menuItems = useNavigationItems(); // ✅ Auth-filtered routes
@@ -194,7 +194,7 @@ function Sidebar() {
 
 **✅ Use framework useNavigate:**
 ```tsx
-import { useNavigate } from '@donotdev/ui/routing';
+import { useNavigate } from '@donotdev/ui';
 
 function LoginForm() {
   const navigate = useNavigate();
@@ -228,7 +228,7 @@ navigate('/products', {
 
 **✅ Use framework useSearchParams (read-only, returns URLSearchParams directly):**
 ```tsx
-import { useSearchParams } from '@donotdev/ui/routing';
+import { useSearchParams } from '@donotdev/ui';
 
 function ProductList() {
   const searchParams = useSearchParams();
@@ -240,7 +240,7 @@ function ProductList() {
 
 **✅ Or use useQueryParams helper:**
 ```tsx
-import { useQueryParams } from '@donotdev/ui/routing';
+import { useQueryParams } from '@donotdev/ui';
 
 function ProductList() {
   const { page, sort } = useQueryParams({ page: '1', sort: 'name' });
@@ -254,7 +254,7 @@ function ProductList() {
 
 **✅ Use framework useMatch:**
 ```tsx
-import { useMatch } from '@donotdev/ui/routing';
+import { useMatch } from '@donotdev/ui';
 
 function NavigationItem({ path }) {
   const isActive = useMatch(path);
@@ -360,7 +360,7 @@ import { Link, useNavigate } from 'react-router-dom';
 **Fix:**
 ```tsx
 // ✅ CORRECT
-import { Link, useNavigate } from '@donotdev/ui/routing';
+import { Link, useNavigate } from '@donotdev/ui';
 ```
 
 ---
@@ -416,7 +416,7 @@ function Sidebar() {
 **Fix:**
 ```tsx
 // ✅ CORRECT
-import { DnDevNavigationMenu } from '@donotdev/ui/routing';
+import { DnDevNavigationMenu } from '@donotdev/ui';
 
 function Sidebar() {
   return <DnDevNavigationMenu vertical />; // Auto-fetches routes
@@ -437,7 +437,7 @@ import { Link } from 'react-router-dom';
 **Fix:**
 ```tsx
 // ✅ CORRECT
-import { Link } from '@donotdev/ui/routing';
+import { Link } from '@donotdev/ui';
 
 <Link path="/products" label="Products" />
 ```
@@ -459,7 +459,7 @@ import {
   useSearchParams,
   useNavigationItems,
   DnDevNavigationMenu,
-} from '@donotdev/ui/routing';
+} from '@donotdev/ui';
 ```
 
 ### Common Patterns
@@ -489,7 +489,7 @@ const menuItems = useNavigationItems(); // Auth-filtered routes
 
 ## Summary
 
-1. **Always use `@donotdev/ui/routing`** - never `react-router-dom`
+1. **Always import from `@donotdev/ui`** — never `react-router-dom`
 2. **Use `DnDevNavigationMenu`** for sidebars/headers
 3. **Use `useNavigationItems()`** for custom navigation
 4. **Don't use `<Outlet />` manually** - framework handles it

package/templates/root-consumer/guides/dndev/advanced/COOKIE_REFERENCE.md.example

@@ -1,252 +1,252 @@
-# Cookie Reference Guide
-
-**For Framework Consumers: GDPR Compliance**
-
----
-
-## Overview
-
-This guide maps DoNotDev framework features to the cookies they set, helping you configure your cookie consent banner and privacy policy correctly.
-
----
-
-## Cookie Categories (GDPR)
-
-- **Necessary** - Essential for service to function (no consent required per GDPR Article 6(1)(f))
-- **Functional** - Enhances experience (requires consent per GDPR Article 6(1)(a))
-- **Analytics** - Usage tracking (requires consent)
-- **Marketing** - Advertising/tracking (requires consent)
-
----
-
-## Feature Cookie Mapping
-
-### Authentication (`@donotdev/auth`)
-
-**Provider: Firebase Authentication**
-
-| Cookie Name | Category | Purpose | Expires |
-|------------|----------|---------|---------|
-| `__session` | Necessary | Session authentication token | Session |
-| `__Secure-*` | Necessary | Security tokens (HTTPS only) | Varies |
-
-**GDPR Status:** Necessary - Authentication is essential for account-based services.
-
-**Environment Variables:**
-```bash
-VITE_FIREBASE_API_KEY=your-key
-VITE_FIREBASE_PROJECT_ID=your-project
-```
-
----
-
-### OAuth (`@donotdev/oauth`)
-
-**Providers: Google, GitHub OAuth**
-
-| Cookie Name | Category | Purpose | Expires |
-|------------|----------|---------|---------|
-| OAuth state cookies | Necessary | CSRF protection during OAuth flow | Session |
-| Provider session cookies | Necessary | Maintain OAuth session | Per provider |
-
-**GDPR Status:** Necessary - Part of authentication flow.
-
-**Environment Variables:**
-```bash
-VITE_AUTH_PARTNERS=google,github
-```
-
-**Third-party cookies set by OAuth providers:**
-- **Google:** `SID`, `HSID`, `SSID`, `APISID`, `SAPISID` (necessary for OAuth)
-- **GitHub:** `user_session`, `logged_in` (necessary for OAuth)
-
----
-
-### Billing (`@donotdev/billing`)
-
-**Provider: Stripe**
-
-| Cookie Name | Category | Purpose | Expires |
-|------------|----------|---------|---------|
-| `__stripe_mid` | Necessary | Fraud prevention | 1 year |
-| `__stripe_sid` | Necessary | Checkout session | 30 minutes |
-
-**GDPR Status:** Necessary - Required for payment processing and fraud prevention.
-
-**Environment Variables:**
-```bash
-VITE_STRIPE_PUBLIC_KEY=pk_live_xxx
-```
-
-**Stripe Privacy:** Stripe sets these cookies when Checkout or Customer Portal is opened. They're classified as necessary for PCI compliance and fraud prevention.
-
----
-
-### Framework Core Cookies
-
-**Set by `@donotdev/core`**
-
-| Cookie Name | Category | Purpose | Expires |
-|------------|----------|---------|---------|
-| `dndev-cookie-consent` | Necessary | Stores user's cookie preferences | 365 days |
-| `dndev-theme` | Necessary | Remembers dark/light mode preference | 365 days |
-| `dndev-lang` | Necessary | Remembers language preference | 365 days |
-
-**GDPR Status:** Necessary (essential for UX, no tracking, purely local preferences)
-
----
-
-## Analytics & Marketing (Optional)
-
-These are NOT included in the framework but commonly added by consumers:
-
-### Google Analytics
-
-| Cookie Name | Category | Purpose | Expires |
-|------------|----------|---------|---------|
-| `_ga` | Analytics | Distinguish users | 2 years |
-| `_gid` | Analytics | Distinguish users | 24 hours |
-| `_gat` | Analytics | Throttle requests | 1 minute |
-
-**GDPR Status:** Analytics - Requires explicit consent.
-
-**Setup:** Consumer must add Google Analytics script and obtain consent.
-
-### Facebook Pixel
-
-| Cookie Name | Category | Purpose | Expires |
-|------------|----------|---------|---------|
-| `_fbp` | Marketing | Track conversions | 90 days |
-
-**GDPR Status:** Marketing - Requires explicit consent.
-
----
-
-## Cookie Banner Configuration
-
-### Minimal Setup (Auth + Billing + Theme/Lang)
-
-If your app only uses auth, billing, theme, and language preferences, all cookies are **necessary**:
-
-```typescript
-// src/config/app.ts
-export const appConfig: AppConfig = {
-  features: {
-    // No config needed - all framework cookies are necessary
-  },
-};
-```
-
-**Result:** No cookie banner shown - all cookies are GDPR-compliant without consent.
-
-### With Analytics/Marketing
-
-If you add Google Analytics or marketing pixels:
-
-```typescript
-// src/config/app.ts
-export const appConfig: AppConfig = {
-  features: {
-    requiredCookies: ['necessary', 'functional', 'analytics'],
-  },
-};
-```
-
-**Result:** Cookie banner shows all categories, users must consent to analytics.
-
----
-
-## Privacy Policy Template
-
-**Example text for your privacy policy:**
-
-```markdown
-## Cookies We Use
-
-### Essential Cookies (Always Active)
-
-We use essential cookies that are necessary for our service to function:
-
-- **Authentication** (Firebase): Maintains your login session
-- **Payment Processing** (Stripe): Enables secure payments and fraud prevention
-- **Cookie Preferences**: Remembers your cookie consent choices
-
-These cookies are essential and cannot be disabled.
-
-### Functional Cookies (Optional)
-
-With your consent, we use functional cookies to enhance your experience:
-
-- **Theme Preference**: Remembers your dark/light mode choice
-- **Language Preference**: Remembers your selected language
-
-You can disable these in cookie settings.
-
-### Analytics Cookies (Optional) [If applicable]
-
-With your consent, we use Google Analytics to understand how visitors use our site.
-This helps us improve the user experience.
-
-You can disable these in cookie settings.
-```
-
----
-
-## Testing Cookie Compliance
-
-### Check What Cookies Are Set
-
-```javascript
-// Browser console
-document.cookie
-```
-
-### Verify Consent Before Analytics
-
-```typescript
-import { useConsent } from '@donotdev/core';
-
-function MyAnalytics() {
-  const hasAnalyticsConsent = useConsent('hasCategory')('analytics');
-
-  useEffect(() => {
-    if (hasAnalyticsConsent) {
-      // Initialize Google Analytics
-    }
-  }, [hasAnalyticsConsent]);
-}
-```
-
----
-
-## GDPR Compliance Checklist
-
-- [ ] List all cookies in privacy policy with categories
-- [ ] Only set analytics/marketing cookies after consent
-- [ ] Provide cookie settings link in footer
-- [ ] Allow users to withdraw consent
-- [ ] Store consent for 12 months maximum
-- [ ] Don't block essential features if functional cookies declined
-
-**Framework handles:** Consent storage, banner UI, category management
-
-**You handle:** Privacy policy text, analytics integration, marketing pixels
-
----
-
-## Quick Reference
-
-| Feature | Cookies | Category | Consent Required? |
-|---------|---------|----------|-------------------|
-| Auth | `__session`, `__Secure-*` | Necessary | No |
-| OAuth | Provider session cookies | Necessary | No |
-| Billing | `__stripe_mid`, `__stripe_sid` | Necessary | No |
-| Theme | `dndev-theme` | Necessary | No |
-| Language | `dndev-lang` | Necessary | No |
-| Consent | `dndev-cookie-consent` | Necessary | No |
-| Analytics | `_ga`, `_gid` | Analytics | Yes |
-| Marketing | `_fbp`, etc. | Marketing | Yes |
-
----
-
-**Need help?** Check your browser DevTools → Application → Cookies to see exactly what's being set.
+# Cookie Reference Guide
+
+**For Framework Consumers: GDPR Compliance**
+
+---
+
+## Overview
+
+This guide maps DoNotDev framework features to the cookies they set, helping you configure your cookie consent banner and privacy policy correctly.
+
+---
+
+## Cookie Categories (GDPR)
+
+- **Necessary** - Essential for service to function (no consent required per GDPR Article 6(1)(f))
+- **Functional** - Enhances experience (requires consent per GDPR Article 6(1)(a))
+- **Analytics** - Usage tracking (requires consent)
+- **Marketing** - Advertising/tracking (requires consent)
+
+---
+
+## Feature Cookie Mapping
+
+### Authentication (`@donotdev/auth`)
+
+**Provider: Firebase Authentication**
+
+| Cookie Name | Category | Purpose | Expires |
+|------------|----------|---------|---------|
+| `__session` | Necessary | Session authentication token | Session |
+| `__Secure-*` | Necessary | Security tokens (HTTPS only) | Varies |
+
+**GDPR Status:** Necessary - Authentication is essential for account-based services.
+
+**Environment Variables:**
+```bash
+VITE_FIREBASE_API_KEY=your-key
+VITE_FIREBASE_PROJECT_ID=your-project
+```
+
+---
+
+### OAuth (`@donotdev/oauth`)
+
+**Providers: Google, GitHub OAuth**
+
+| Cookie Name | Category | Purpose | Expires |
+|------------|----------|---------|---------|
+| OAuth state cookies | Necessary | CSRF protection during OAuth flow | Session |
+| Provider session cookies | Necessary | Maintain OAuth session | Per provider |
+
+**GDPR Status:** Necessary - Part of authentication flow.
+
+**Environment Variables:**
+```bash
+VITE_AUTH_PARTNERS=google,github
+```
+
+**Third-party cookies set by OAuth providers:**
+- **Google:** `SID`, `HSID`, `SSID`, `APISID`, `SAPISID` (necessary for OAuth)
+- **GitHub:** `user_session`, `logged_in` (necessary for OAuth)
+
+---
+
+### Billing (`@donotdev/billing`)
+
+**Provider: Stripe**
+
+| Cookie Name | Category | Purpose | Expires |
+|------------|----------|---------|---------|
+| `__stripe_mid` | Necessary | Fraud prevention | 1 year |
+| `__stripe_sid` | Necessary | Checkout session | 30 minutes |
+
+**GDPR Status:** Necessary - Required for payment processing and fraud prevention.
+
+**Environment Variables:**
+```bash
+VITE_STRIPE_PUBLIC_KEY=pk_live_xxx
+```
+
+**Stripe Privacy:** Stripe sets these cookies when Checkout or Customer Portal is opened. They're classified as necessary for PCI compliance and fraud prevention.
+
+---
+
+### Framework Core Cookies
+
+**Set by `@donotdev/core`**
+
+| Cookie Name | Category | Purpose | Expires |
+|------------|----------|---------|---------|
+| `dndev-cookie-consent` | Necessary | Stores user's cookie preferences | 365 days |
+| `dndev-theme` | Necessary | Remembers dark/light mode preference | 365 days |
+| `dndev-lang` | Necessary | Remembers language preference | 365 days |
+
+**GDPR Status:** Necessary (essential for UX, no tracking, purely local preferences)
+
+---
+
+## Analytics & Marketing (Optional)
+
+These are NOT included in the framework but commonly added by consumers:
+
+### Google Analytics
+
+| Cookie Name | Category | Purpose | Expires |
+|------------|----------|---------|---------|
+| `_ga` | Analytics | Distinguish users | 2 years |
+| `_gid` | Analytics | Distinguish users | 24 hours |
+| `_gat` | Analytics | Throttle requests | 1 minute |
+
+**GDPR Status:** Analytics - Requires explicit consent.
+
+**Setup:** Consumer must add Google Analytics script and obtain consent.
+
+### Facebook Pixel
+
+| Cookie Name | Category | Purpose | Expires |
+|------------|----------|---------|---------|
+| `_fbp` | Marketing | Track conversions | 90 days |
+
+**GDPR Status:** Marketing - Requires explicit consent.
+
+---
+
+## Cookie Banner Configuration
+
+### Minimal Setup (Auth + Billing + Theme/Lang)
+
+If your app only uses auth, billing, theme, and language preferences, all cookies are **necessary**:
+
+```typescript
+// src/config/app.ts
+export const appConfig: AppConfig = {
+  features: {
+    // No config needed - all framework cookies are necessary
+  },
+};
+```
+
+**Result:** No cookie banner shown - all cookies are GDPR-compliant without consent.
+
+### With Analytics/Marketing
+
+If you add Google Analytics or marketing pixels:
+
+```typescript
+// src/config/app.ts
+export const appConfig: AppConfig = {
+  features: {
+    requiredCookies: ['necessary', 'functional', 'analytics'],
+  },
+};
+```
+
+**Result:** Cookie banner shows all categories, users must consent to analytics.
+
+---
+
+## Privacy Policy Template
+
+**Example text for your privacy policy:**
+
+```markdown
+## Cookies We Use
+
+### Essential Cookies (Always Active)
+
+We use essential cookies that are necessary for our service to function:
+
+- **Authentication** (Firebase): Maintains your login session
+- **Payment Processing** (Stripe): Enables secure payments and fraud prevention
+- **Cookie Preferences**: Remembers your cookie consent choices
+
+These cookies are essential and cannot be disabled.
+
+### Functional Cookies (Optional)
+
+With your consent, we use functional cookies to enhance your experience:
+
+- **Theme Preference**: Remembers your dark/light mode choice
+- **Language Preference**: Remembers your selected language
+
+You can disable these in cookie settings.
+
+### Analytics Cookies (Optional) [If applicable]
+
+With your consent, we use Google Analytics to understand how visitors use our site.
+This helps us improve the user experience.
+
+You can disable these in cookie settings.
+```
+
+---
+
+## Testing Cookie Compliance
+
+### Check What Cookies Are Set
+
+```javascript
+// Browser console
+document.cookie
+```
+
+### Verify Consent Before Analytics
+
+```typescript
+import { useConsent } from '@donotdev/core';
+
+function MyAnalytics() {
+  const hasAnalyticsConsent = useConsent('hasCategory')('analytics');
+
+  useEffect(() => {
+    if (hasAnalyticsConsent) {
+      // Initialize Google Analytics
+    }
+  }, [hasAnalyticsConsent]);
+}
+```
+
+---
+
+## GDPR Compliance Checklist
+
+- [ ] List all cookies in privacy policy with categories
+- [ ] Only set analytics/marketing cookies after consent
+- [ ] Provide cookie settings link in footer
+- [ ] Allow users to withdraw consent
+- [ ] Store consent for 12 months maximum
+- [ ] Don't block essential features if functional cookies declined
+
+**Framework handles:** Consent storage, banner UI, category management
+
+**You handle:** Privacy policy text, analytics integration, marketing pixels
+
+---
+
+## Quick Reference
+
+| Feature | Cookies | Category | Consent Required? |
+|---------|---------|----------|-------------------|
+| Auth | `__session`, `__Secure-*` | Necessary | No |
+| OAuth | Provider session cookies | Necessary | No |
+| Billing | `__stripe_mid`, `__stripe_sid` | Necessary | No |
+| Theme | `dndev-theme` | Necessary | No |
+| Language | `dndev-lang` | Necessary | No |
+| Consent | `dndev-cookie-consent` | Necessary | No |
+| Analytics | `_ga`, `_gid` | Analytics | Yes |
+| Marketing | `_fbp`, etc. | Marketing | Yes |
+
+---
+
+**Need help?** Check your browser DevTools → Application → Cookies to see exactly what's being set.