@donotdev/cli 0.0.19 → 0.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/cli",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "Command-line interface for DoNotDev Framework",
   "type": "module",
   "private": false,

package/templates/app-demo/.env.example

@@ -0,0 +1 @@
+VITE_AUTH_PARTNERS=password, google, github, apple, discord, facebook, linkedin, reddit, twitch, twitter, microsoft, spotify, yahoo

package/templates/{root-consumer → app-demo}/entities/ExampleEntity.ts.example

@@ -32,13 +32,16 @@ export const productEntity = defineEntity({
   listCardFields: ['images', 'name', 'price', 'category'],
 
   // ==========================================================================
-  // ACCESS RULES - Who can do what
+  // ACCESS RULES - Who can do what (maps to Supabase RLS policies)
   // ==========================================================================
   //
   // 'guest'   → Anyone (including not logged in)
   // 'user'    → Any logged-in user
-  // 'owner'   → Only the document owner (createdById matches)
   // 'admin'   → Only admin role
+  // 'super'   → Only super admin
+  //
+  // NOTE: These are DB-level roles. For owner-based logic, use field-level
+  // 'editable' / 'visibility' settings (see FIELD DEFINITIONS below).
   //
   access: {
     create: 'admin',   // Only admins can create products
@@ -67,16 +70,19 @@ export const productEntity = defineEntity({
   // 'images'    → Image upload (multiple)
   // 'reference' → Link to another entity
   //
-  // VISIBILITY:
-  // 'guest'  → Everyone can see this field
-  // 'user'   → Only logged-in users
-  // 'owner'  → Only document owner
-  // 'admin'  → Only admins
+  // VISIBILITY (field-level, UI only):
+  // 'guest'   → Everyone can see this field
+  // 'user'    → Only logged-in users
+  // 'admin'   → Only admins
+  // 'super'   → Only super admins
+  // 'hidden'  → Never sent to client (server-only)
   //
-  // EDITABLE:
+  // EDITABLE (field-level, UI only):
   // 'admin'       → Only admins can edit
-  // 'owner'       → Only owner can edit
+  // 'owner'       → Only document creator can edit
+  // 'user'        → Any authenticated user can edit
   // 'create-only' → Set on creation, read-only after
+  // false         → Never editable (read-only)
   //
   fields: {
     // ==========================================================================

package/templates/app-demo/index.html.example

@@ -20,7 +20,7 @@
       box-sizing: border-box;
     }
     body {
-      font-family: 'Inter', var(--font-family, ui-sans-serif, system-ui, -apple-system, sans-serif);
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif;
       line-height: 1.5;
       -webkit-font-smoothing: antialiased;
       -moz-osx-font-smoothing: grayscale;

package/templates/app-demo/public/favicon.svg.example

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 500 500" xmlns:v="https://vecta.io/nano"><path d="M11.995 68.133c-.747.14-2.114 1.276-2.986 2.409l-1.557 2.199-.062 104.273.684 251.717c.935 2.835 3.423 4.749 6.347 4.89 2.366.142 3.61-.566 10.767-5.599l42.311-30.054L112.3 366.14l16.366-11.768c3.234-2.268 6.098-4.749 6.346-5.599 1.369-3.828 9.271-32.679 9.023-32.891-.124-.213-1.743.78-3.547 2.198-1.803 1.347-8.773 6.309-15.432 10.916L87.1 355.862l-24.891 17.65-23.831 16.729c-5.413 3.898-10.143 7.017-10.454 7.017-.685 0-.809-291.837-.063-292.334.249-.141 1.619.497 3.049 1.559l51.521 37.711 18.668 13.61 20.222 14.674 13.69 9.996 9.333 6.734 12.756 9.215c10.455 7.798 15.992 11.767 16.553 11.908.374.073 1.99-4.889 3.609-11.058l3.048-11.202-5.537-4.038-10.641-7.799c-2.863-1.984-10.391-7.584-16.8-12.405l-23.21-17.154-20.721-15.24L89.4 121.157c-2.613-1.986-7.653-5.671-11.2-8.223L23.506 73.096c-6.471-4.679-8.774-5.671-11.512-4.962l.001-.001zm235.829 4.466c-1.057.708-2.302 2.055-2.737 2.977-.622 1.276-.809 14.673-.746 62.733l.062 61.104 4.915 8.01 10.206 16.871 5.225 8.861.187-62.308 1.057-61.812c.56.212 6.098 4.111 12.321 8.648l43.806 31.97c1.307.991 1.431.708 5.973-9.641l4.667-10.705-1.618-1.346-14.747-10.845-20.844-15.313-36.65-26.864c-5.788-4.182-7.841-4.608-11.077-2.34zm-34.784 196.85l-7.279 15.807-11.511 25.166c.123.141 5.351-3.474 11.697-7.939l18.356-13.042 8.027-5.813c1.057-.922.685-1.701-6.347-13.469l-7.466-12.546-5.477 11.838v-.002z" fill="var(--primary,#dc143c)"/><path d="M376.752 57.145l-4.977 11.2c-1.432 2.907-4.792 10.066-7.468 15.95l-9.955 21.619-25.388 54.583-11.2 24.101-20.658 43.949-11.7 24.81-7.84 16.304c-.809 1.347-.621 1.631-15.679-23.747l-26.072-43.949-22.213-37.71c-8.587-14.815-10.267-16.73-12.322-14.319-.435.566-2.676 8.009-4.978 16.586l-22.711 82.228-13.378 47.494-8.153 29.064-18.232 64.86-12.133 43.382-4.355 16.162c.186 0 3.671-7.443 14.871-31.898l10.578-22.684 8.088-17.013 8.774-18.43 9.771-20.556 7.901-16.659 9.333-19.848 9.957-21.267 10.765-23.038c6.844-14.957 9.397-20.061 10.08-20.273.374-.142 3.485 4.606 6.968 10.562l24.828 41.255 31.981 52.809c5.289 8.932 6.846 11.06 8.153 11.2.87.142 1.929-.212 2.302-.779.685-.851 19.6-65.499 44.054-150.421l25.823-88.889 17.798-62.168c-.125-.141-1.308 2.34-2.615 5.53h.002z" fill="var(--accent,#ffd700)"/><path d="M359.081 153.904l-3.111 11.555c-1.369 4.89-2.302 9.074-2.053 9.287s5.041 3.757 10.703 7.869l33.289 24.314 37.645 27.505 19.601 14.318 6.409 4.536c2.489 1.49 5.538-.991-32.542 26.369l-38.269 27.432-31.236 22.402-33.913 24.456-28.187 20.273-12.134 8.648c-10.019 7.16-19.413 13.681-19.848 13.681-.188 0-.374-14.248-.374-31.757v-31.686l-4.419-7.088-10.019-16.518c-3.111-5.102-5.849-9.356-6.098-9.356s-.375 11.909-.249 26.37l.249 64.223v37.711l2.054 2.623c1.866 2.268 2.489 2.553 4.914 2.553 3.237 0 4.169-.568 18.855-11.202l76.535-55.291 21.78-15.807 120.403-86.411c3.67-2.552 5.102-4.748 5.475-8.434.188-2.409 0-3.971-.746-5.599-1.244-2.623-2.677-3.686-48.908-37.711l-51.023-37.642-14.624-10.774-12.88-9.427c-2.986-2.199-5.724-4.041-6.035-4.041-.374 0-.934 1.206-1.245 2.622l.001-.003z" fill="var(--primary,#dc143c)"/></svg>

package/templates/app-demo/src/App.tsx.example

@@ -26,5 +26,7 @@ import { appConfig } from './config/app';
  * @author AMBROISE PARK Consulting
  */
 export function App() {
-  return <ViteAppProviders config={appConfig} layout={{ breadcrumbs: 'smart' }} />;
+  return (
+    <ViteAppProviders config={appConfig} layout={{ breadcrumbs: 'smart' }} />
+  );
 }

package/templates/app-demo/src/config/app.ts.example

@@ -1,3 +1,4 @@
+// apps/demo/src/config/app.ts
 /**
  * @fileoverview Application configuration
  * @description Defines application metadata, layout preset, and feature flags

package/templates/app-demo/src/entities/booking.ts.example

@@ -0,0 +1,75 @@
+// apps/demo/src/entities/booking.ts
+
+import { defineEntity, when } from '@donotdev/core';
+
+/**
+ * Booking entity — demonstrates complex conditional logic.
+ *
+ * - groupSize: visible only for group bookings
+ * - companyName: visible only for corporate bookings
+ * - invoiceAddress: visible for corporate OR group with 10+ people
+ */
+export const bookingEntity = defineEntity({
+  name: 'Booking',
+  collection: 'bookings',
+  fields: {
+    bookingType: {
+      name: 'bookingType',
+      type: 'select',
+      label: 'Booking Type',
+      visibility: 'user',
+      validation: {
+        required: true,
+        options: [
+          { value: 'individual', label: 'Individual' },
+          { value: 'group', label: 'Group (5+)' },
+          { value: 'corporate', label: 'Corporate' },
+        ],
+      },
+    },
+    groupSize: {
+      name: 'groupSize',
+      type: 'number',
+      label: 'Number of People',
+      visibility: 'user',
+      conditions: {
+        visible: when('bookingType').equals('group'),
+        required: when('bookingType').equals('group'),
+      },
+    },
+    companyName: {
+      name: 'companyName',
+      type: 'text',
+      label: 'Company Name',
+      visibility: 'user',
+      conditions: {
+        visible: when('bookingType').equals('corporate'),
+        required: when('bookingType').equals('corporate'),
+      },
+    },
+    invoiceAddress: {
+      name: 'invoiceAddress',
+      type: 'address',
+      label: 'Invoice Address',
+      visibility: 'user',
+      conditions: {
+        visible: when('bookingType')
+          .equals('corporate')
+          .or(when('groupSize').greaterThan(10)),
+      },
+    },
+    date: {
+      name: 'date',
+      type: 'date',
+      label: 'Booking Date',
+      visibility: 'user',
+      validation: { required: true },
+    },
+    notes: {
+      name: 'notes',
+      type: 'textarea',
+      label: 'Special Requests',
+      visibility: 'user',
+    },
+  },
+});

package/templates/app-demo/src/entities/onboarding.ts.example

@@ -0,0 +1,160 @@
+// apps/demo/src/entities/onboarding.ts
+
+import { defineEntity, when } from '@donotdev/core';
+import { defineWorkflow } from '@donotdev/crud';
+
+/**
+ * Entities for the Customer Onboarding workflow demo.
+ * Each entity represents one step in the wizard.
+ */
+
+export const companyEntity = defineEntity({
+  name: 'Company',
+  collection: 'companies',
+  fields: {
+    name: {
+      name: 'name',
+      type: 'text',
+      label: 'Company Name',
+      visibility: 'user',
+      validation: { required: true, minLength: 2 },
+    },
+    industry: {
+      name: 'industry',
+      type: 'select',
+      label: 'Industry',
+      visibility: 'user',
+      validation: {
+        required: true,
+        options: [
+          { value: 'tech', label: 'Technology' },
+          { value: 'finance', label: 'Finance' },
+          { value: 'healthcare', label: 'Healthcare' },
+          { value: 'retail', label: 'Retail' },
+          { value: 'other', label: 'Other' },
+        ],
+      },
+    },
+    size: {
+      name: 'size',
+      type: 'number',
+      label: 'Number of Employees',
+      visibility: 'user',
+      validation: { required: true, min: 1 },
+    },
+    website: {
+      name: 'website',
+      type: 'url',
+      label: 'Website',
+      visibility: 'user',
+    },
+  },
+});
+
+export const contactEntity = defineEntity({
+  name: 'Contact',
+  collection: 'contacts',
+  fields: {
+    firstName: {
+      name: 'firstName',
+      type: 'text',
+      label: 'First Name',
+      visibility: 'user',
+      validation: { required: true },
+    },
+    lastName: {
+      name: 'lastName',
+      type: 'text',
+      label: 'Last Name',
+      visibility: 'user',
+      validation: { required: true },
+    },
+    email: {
+      name: 'email',
+      type: 'email',
+      label: 'Email',
+      visibility: 'user',
+      validation: { required: true },
+    },
+    phone: {
+      name: 'phone',
+      type: 'tel',
+      label: 'Phone',
+      visibility: 'user',
+    },
+  },
+});
+
+export const preferencesEntity = defineEntity({
+  name: 'Preferences',
+  collection: 'preferences',
+  fields: {
+    language: {
+      name: 'language',
+      type: 'select',
+      label: 'Language',
+      visibility: 'user',
+      validation: {
+        options: [
+          { value: 'en', label: 'English' },
+          { value: 'fr', label: 'French' },
+          { value: 'de', label: 'German' },
+          { value: 'es', label: 'Spanish' },
+        ],
+      },
+    },
+    notifications: {
+      name: 'notifications',
+      type: 'switch',
+      label: 'Enable Email Notifications',
+      visibility: 'user',
+    },
+  },
+});
+
+/**
+ * Customer Onboarding Workflow
+ *
+ * 4 steps:
+ * 1. Company Info (required)
+ * 2. Primary Contact (required)
+ * 3. Preferences (skippable)
+ * 4. Billing — only shown if company size > 10
+ */
+export const onboardingWorkflow = defineWorkflow({
+  id: 'customer-onboarding',
+  name: 'Customer Onboarding',
+  persist: true,
+
+  steps: [
+    {
+      id: 'company',
+      title: 'Company Info',
+      entity: companyEntity,
+      fields: ['name', 'industry', 'size', 'website'],
+    },
+    {
+      id: 'contact',
+      title: 'Primary Contact',
+      entity: contactEntity,
+      fields: ['firstName', 'lastName', 'email', 'phone'],
+    },
+    {
+      id: 'preferences',
+      title: 'Preferences',
+      entity: preferencesEntity,
+      fields: ['language', 'notifications'],
+      allowSkip: true,
+    },
+    {
+      id: 'billing',
+      title: 'Billing',
+      description: 'Required for companies with more than 10 employees',
+      entity: companyEntity,
+      fields: ['website'], // placeholder — real app would have billing entity
+      conditions: {
+        visible: when('size').greaterThan(10),
+      },
+    },
+  ],
+});

package/templates/app-demo/src/entities/product.ts.example

@@ -1,3 +1,5 @@
+// apps/demo/src/entities/product.ts
+
 import { defineEntity } from '@donotdev/core';
 
 export const productEntity = defineEntity({
@@ -5,20 +7,28 @@ export const productEntity = defineEntity({
   collection: 'products',
   fields: {
     name: {
+      name: 'name',
+      label: 'Name',
       type: 'text',
       visibility: 'user',
       validation: { required: true, minLength: 3 },
     },
     description: {
+      name: 'description',
+      label: 'Description',
       type: 'textarea',
       visibility: 'user',
     },
     price: {
+      name: 'price',
+      label: 'Price',
       type: 'number',
       visibility: 'user',
       validation: { required: true, min: 0 },
     },
     category: {
+      name: 'category',
+      label: 'Category',
       type: 'select',
       visibility: 'user',
       validation: {
@@ -31,6 +41,8 @@ export const productEntity = defineEntity({
       },
     },
     image: {
+      name: 'image',
+      label: 'Image',
       type: 'image',
       visibility: 'user',
     },

package/templates/app-demo/src/entities/quote.ts.example

@@ -0,0 +1,70 @@
+// apps/demo/src/entities/quote.ts
+
+import { defineEntity, when } from '@donotdev/core';
+
+/**
+ * Insurance Quote entity — demonstrates conditional field visibility.
+ *
+ * - licensePlate: only visible when productType === 'car'
+ * - propertyAddress: only visible when productType === 'home'
+ * - estimatedValue: visible for car OR home (not health)
+ * - notes: disabled until productType is selected
+ */
+export const quoteEntity = defineEntity({
+  name: 'Quote',
+  collection: 'quotes',
+  fields: {
+    productType: {
+      name: 'productType',
+      type: 'select',
+      label: 'Product',
+      visibility: 'user',
+      validation: {
+        required: true,
+        options: [
+          { value: 'health', label: 'Health Insurance' },
+          { value: 'car', label: 'Car Insurance' },
+          { value: 'home', label: 'Home Insurance' },
+        ],
+      },
+    },
+    licensePlate: {
+      name: 'licensePlate',
+      type: 'text',
+      label: 'License Plate',
+      visibility: 'user',
+      conditions: {
+        visible: when('productType').equals('car'),
+        required: when('productType').equals('car'),
+      },
+    },
+    propertyAddress: {
+      name: 'propertyAddress',
+      type: 'address',
+      label: 'Property Address',
+      visibility: 'user',
+      conditions: {
+        visible: when('productType').equals('home'),
+        required: when('productType').equals('home'),
+      },
+    },
+    estimatedValue: {
+      name: 'estimatedValue',
+      type: 'number',
+      label: 'Estimated Value',
+      visibility: 'user',
+      conditions: {
+        visible: when('productType').in(['car', 'home']),
+      },
+    },
+    notes: {
+      name: 'notes',
+      type: 'textarea',
+      label: 'Additional Notes',
+      visibility: 'user',
+      conditions: {
+        disabled: when('productType').notExists(),
+      },
+    },
+  },
+});

package/templates/app-demo/src/pages/ChangelogPage.tsx.example

@@ -1,3 +1,5 @@
+// apps/demo/src/pages/ChangelogPage.tsx
+
 import { History } from 'lucide-react';
 
 import { WhatsNewTemplate } from '@donotdev/templates';
@@ -10,5 +12,30 @@ export const meta: PageMeta = {
 };
 
 export default function ChangelogPage() {
-  return <WhatsNewTemplate />;
+  return (
+    <WhatsNewTemplate
+      changelog={[
+        {
+          version: '1.0.0',
+          date: '2026-01-15',
+          type: 'major',
+          title: 'Initial Release',
+          description: 'First public release of the demo app.',
+          changes: [
+            {
+              type: 'added',
+              items: [
+                'Condition builder with when() API',
+                'Multi-step workflow engine',
+              ],
+            },
+            {
+              type: 'changed',
+              items: ['Entity form renderer supports dynamic fields'],
+            },
+          ],
+        },
+      ]}
+    />
+  );
 }

package/templates/app-demo/src/pages/ConditionalFormPage.tsx.example

@@ -0,0 +1,88 @@
+// apps/demo/src/pages/ConditionalFormPage.tsx
+
+import { SlidersHorizontal } from 'lucide-react';
+
+import { Card, Tabs } from '@donotdev/components';
+import { EntityFormRenderer } from '@donotdev/ui';
+
+import { quoteEntity } from '../entities/quote';
+import { bookingEntity } from '../entities/booking';
+
+import type { PageMeta } from '@donotdev/core';
+
+export const meta: PageMeta = {
+  icon: <SlidersHorizontal />,
+  title: 'Conditional Forms',
+  preset: 'admin',
+};
+
+/**
+ * Conditional Forms Demo — shows field visibility driven by `when()` conditions.
+ *
+ * Two examples:
+ * 1. Insurance Quote — fields appear/disappear based on product type
+ * 2. Booking — complex conditions with .or() combinator
+ */
+export default function ConditionalFormPage() {
+  return (
+    <div style={{ maxWidth: 640, margin: '0 auto' }}>
+      <Card
+        title="Conditional Forms"
+        content="Fields appear, hide, or become required based on other field values. Powered by when() condition builder."
+      >
+        <Tabs
+          items={[
+            {
+              value: 'quote',
+              label: 'Insurance Quote',
+              content: (
+                <Card
+                  title="Insurance Quote"
+                  content='Select a product type to see conditional fields appear. "Car" shows license plate, "Home" shows address, both show estimated value.'
+                >
+                  <EntityFormRenderer
+                    entity={quoteEntity}
+                    operation="create"
+                    onSubmit={async (data) => {
+                      alert(
+                        `Quote submitted: ${JSON.stringify(data, null, 2)}`
+                      );
+                    }}
+                    submitText="Get Quote"
+                    cancelText={null}
+                    warnOnUnsavedChanges={false}
+                    hideVisibilityInfo
+                  />
+                </Card>
+              ),
+            },
+            {
+              value: 'booking',
+              label: 'Booking',
+              content: (
+                <Card
+                  title="Booking Form"
+                  content='"Group" shows group size, "Corporate" shows company name. Invoice address appears for corporate OR groups with 10+ people.'
+                >
+                  <EntityFormRenderer
+                    entity={bookingEntity}
+                    operation="create"
+                    onSubmit={async (data) => {
+                      alert(
+                        `Booking submitted: ${JSON.stringify(data, null, 2)}`
+                      );
+                    }}
+                    submitText="Book Now"
+                    cancelText={null}
+                    warnOnUnsavedChanges={false}
+                    hideVisibilityInfo
+                  />
+                </Card>
+              ),
+            },
+          ]}
+        />
+      </Card>
+    </div>
+  );
+}

package/templates/app-demo/src/pages/DashboardPage.tsx.example

@@ -1,3 +1,5 @@
+// apps/demo/src/pages/DashboardPage.tsx
+
 import { LayoutDashboard } from 'lucide-react';
 
 import { DashboardTemplate } from '@donotdev/templates';