@nextsparkjs/core 0.1.0-beta.1 → 0.1.0-beta.2

package/templates/contents/themes/starter/config/dev.config.ts

@@ -0,0 +1,74 @@
+/**
+ * Starter Theme - Development Configuration
+ *
+ * This file contains development-only settings that should never affect production.
+ * Settings like DevKeyring are only rendered in non-production environments.
+ *
+ * @see core/lib/config/types.ts for DevConfig interface
+ */
+
+import type { DevConfig } from '@nextsparkjs/core/lib/config/types'
+
+export const DEV_CONFIG_OVERRIDES: DevConfig = {
+  // =============================================================================
+  // DEV KEYRING (Development/QA Only)
+  // =============================================================================
+  /**
+   * DevKeyring - Quick login users for development and testing
+   *
+   * These users should match entries in your sample data migrations.
+   * The component is only rendered in non-production environments.
+   *
+   * User structure:
+   * - id: Unique identifier for the user button
+   * - email: User's email address (must exist in database)
+   * - name: Display name shown in the keyring
+   * - password: Password for auto-fill
+   * - teamRoles: Description of team memberships (for reference)
+   */
+  devKeyring: {
+    enabled: true,
+    users: [
+      // ========================================
+      // STARTER THEME TEST USERS
+      // ========================================
+      {
+        id: 'superadmin',
+        email: 'superadmin@starter.dev',
+        name: 'Super Admin',
+        password: 'Test1234',
+        teamRoles: 'Starter Team (owner) - SUPERADMIN ROLE',
+      },
+      {
+        id: 'developer',
+        email: 'developer@starter.dev',
+        name: 'Developer',
+        password: 'Test1234',
+        teamRoles: 'Starter Team (admin) - DEVELOPER ROLE',
+      },
+      {
+        id: 'owner',
+        email: 'owner@starter.dev',
+        name: 'Team Owner',
+        password: 'Test1234',
+        teamRoles: 'Starter Team (owner)',
+      },
+      {
+        id: 'admin',
+        email: 'admin@starter.dev',
+        name: 'Team Admin',
+        password: 'Test1234',
+        teamRoles: 'Starter Team (admin)',
+      },
+      {
+        id: 'member',
+        email: 'member@starter.dev',
+        name: 'Team Member',
+        password: 'Test1234',
+        teamRoles: 'Starter Team (member)',
+      },
+    ],
+  },
+}
+
+export default DEV_CONFIG_OVERRIDES

package/templates/contents/themes/starter/config/permissions.config.ts

@@ -0,0 +1,64 @@
+/**
+ * Starter Theme - Permissions Configuration
+ *
+ * SINGLE SOURCE OF TRUTH for all permissions and roles in this theme.
+ *
+ * This file defines:
+ * - roles: Custom roles beyond core (owner, admin, member, viewer)
+ * - teams: Team-level permissions (team.view, team.edit, etc.)
+ * - entities: Entity CRUD permissions (tasks)
+ * - features: Theme-specific feature permissions
+ *
+ * All sections use unified format: { action: '...', roles: [...] }
+ *
+ * Use PermissionService.canDoAction(role, action) to check any permission.
+ */
+
+import type { ThemePermissionsConfig } from '@nextsparkjs/core/lib/permissions/types'
+
+export const PERMISSIONS_CONFIG_OVERRIDES: ThemePermissionsConfig = {
+  // ==========================================
+  // TEAM PERMISSIONS
+  // ==========================================
+  // Unified format: { action, label, description, roles, dangerous? }
+  teams: [
+    // View permissions
+    { action: 'team.view', label: 'View Team', description: 'Can view team details', roles: ['owner', 'admin', 'member', 'viewer'] },
+    { action: 'team.members.view', label: 'View Members', description: 'Can see team member list', roles: ['owner', 'admin', 'member', 'viewer'] },
+    { action: 'team.settings.view', label: 'View Settings', description: 'Can view team settings', roles: ['owner', 'admin', 'member'] },
+    { action: 'team.billing.view', label: 'View Billing', description: 'Can view billing information', roles: ['owner', 'admin'] },
+
+    // Edit permissions
+    { action: 'team.edit', label: 'Edit Team', description: 'Can modify team name and details', roles: ['owner', 'admin'] },
+    { action: 'team.settings.edit', label: 'Edit Settings', description: 'Can modify team settings', roles: ['owner', 'admin'] },
+    { action: 'team.billing.manage', label: 'Manage Billing', description: 'Can manage subscriptions and payments', roles: ['owner'] },
+
+    // Member management
+    { action: 'team.members.invite', label: 'Invite Members', description: 'Can invite new team members', roles: ['owner', 'admin'] },
+    { action: 'team.members.remove', label: 'Remove Members', description: 'Can remove team members', roles: ['owner', 'admin'] },
+    { action: 'team.members.update_role', label: 'Update Roles', description: 'Can change member roles', roles: ['owner', 'admin'] },
+
+    // Dangerous
+    { action: 'team.delete', label: 'Delete Team', description: 'Can permanently delete the team', roles: ['owner'], dangerous: true },
+  ],
+
+  // ==========================================
+  // ENTITY PERMISSIONS
+  // ==========================================
+  // Define CRUD permissions for each entity in your theme
+  entities: {
+    // ------------------------------------------
+    // TASKS ENTITY
+    // ------------------------------------------
+    tasks: [
+      { action: 'create', label: 'Create tasks', description: 'Can create new tasks', roles: ['owner', 'admin', 'member'] },
+      { action: 'read', label: 'View tasks', description: 'Can view task details', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List tasks', description: 'Can see the tasks list', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit tasks', description: 'Can modify task information', roles: ['owner', 'admin', 'member'] },
+      { action: 'delete', label: 'Delete tasks', description: 'Can delete tasks', roles: ['owner', 'admin'], dangerous: true },
+      { action: 'assign', label: 'Assign tasks', description: 'Can assign tasks to team members', roles: ['owner', 'admin'] },
+    ],
+  },
+}
+
+export default PERMISSIONS_CONFIG_OVERRIDES

package/templates/contents/themes/starter/config/theme.config.ts

@@ -0,0 +1,83 @@
+/**
+ * Starter Theme Configuration
+ *
+ * Theme visual configuration: colors, typography, spacing, and component overrides.
+ * This file defines the look and feel of your theme.
+ */
+
+import type { ThemeConfig } from '@nextsparkjs/core/types/theme'
+
+export const starterThemeConfig: ThemeConfig = {
+  // ==========================================
+  // BASIC IDENTIFICATION
+  // ==========================================
+  name: 'starter',
+  displayName: 'Starter',
+  version: '1.0.0',
+  description: 'Minimal starter theme for NextSpark',
+  author: 'NextSpark Team',
+
+  // ==========================================
+  // PLUGINS (Optional)
+  // ==========================================
+  plugins: [],
+
+  // ==========================================
+  // STYLES CONFIGURATION
+  // ==========================================
+  styles: {
+    globals: 'globals.css',
+    components: 'components.css',
+    variables: {
+      '--spacing-xs': '0.125rem',
+      '--spacing-sm': '0.25rem',
+      '--spacing-md': '0.5rem',
+      '--spacing-lg': '1rem',
+      '--spacing-xl': '1.5rem',
+      '--spacing-2xl': '2rem',
+    },
+  },
+
+  // ==========================================
+  // THEME CONFIGURATION
+  // ==========================================
+  // Colors come from globals.css - no need to define here
+  // This section is for typography and spacing overrides
+  config: {
+    // ------------------------------------------
+    // TYPOGRAPHY
+    // ------------------------------------------
+    fonts: {
+      sans: 'system-ui, -apple-system, sans-serif',
+      serif: 'Georgia, serif',
+      mono: 'ui-monospace, monospace',
+    },
+
+    // ------------------------------------------
+    // SPACING (Border Radius)
+    // ------------------------------------------
+    spacing: {
+      radius: '0.5rem',
+      'radius-sm': 'calc(0.5rem - 4px)',
+      'radius-md': 'calc(0.5rem - 2px)',
+      'radius-lg': '0.5rem',
+      'radius-xl': 'calc(0.5rem + 4px)',
+    },
+  },
+
+  // ==========================================
+  // COMPONENT OVERRIDES (Optional)
+  // ==========================================
+  components: {
+    overrides: {
+      // Override core shadcn/ui components with theme-specific versions:
+      // '@nextsparkjs/core/components/ui/button': () => import('../components/overrides/Button').then(m => m.Button),
+    },
+    custom: {
+      // Custom theme-specific components:
+      // CustomHeader: () => import('../components/custom/CustomHeader').then(m => m.CustomHeader),
+    },
+  },
+}
+
+export default starterThemeConfig

package/templates/contents/themes/starter/docs/01-overview/01-introduction.md

@@ -0,0 +1,33 @@
+# Starter Theme Introduction
+
+Welcome to the Starter theme for NextSpark. This minimal theme provides everything you need to begin building your application.
+
+## Features
+
+- **Tasks Entity**: A complete example entity with CRUD operations
+- **Analytics Dashboard**: Custom dashboard page example
+- **Hero Block**: Page builder block example
+- **Multi-language Support**: Translations in 6 languages (en, es, fr, it, de, pt)
+- **Cypress Tests**: Complete test infrastructure
+
+## Getting Started
+
+1. Install dependencies: `pnpm install`
+2. Configure environment: `cp .env.example .env.local`
+3. Run migrations: `pnpm db:migrate`
+4. Start development: `pnpm dev`
+
+## Project Structure
+
+```
+starter/
+├── config/         # Theme configuration files
+├── entities/       # Entity definitions (tasks)
+├── blocks/         # Page builder blocks (hero)
+├── templates/      # Page templates (public, dashboard)
+├── messages/       # i18n translations
+├── lib/            # Utilities and hooks
+├── tests/          # Cypress test suite
+├── styles/         # CSS files
+└── docs/           # Documentation
+```

package/templates/contents/themes/starter/docs/01-overview/02-customization.md

@@ -0,0 +1,46 @@
+# Customizing the Starter Theme
+
+This guide explains how to customize the starter theme for your needs.
+
+## Renaming the Theme
+
+When you run `npx nextspark init`, the theme is automatically renamed based on your project name.
+
+## Adding New Entities
+
+1. Create a new folder in `entities/`
+2. Add the required files:
+   - `[entity].config.ts`
+   - `[entity].fields.ts`
+   - `[entity].types.ts`
+   - `migrations/`
+   - `messages/`
+
+## Adding New Blocks
+
+1. Create a new folder in `blocks/`
+2. Add the required files:
+   - `config.ts`
+   - `schema.ts`
+   - `fields.ts`
+   - `component.tsx`
+   - `index.ts`
+
+## Adding Dashboard Pages
+
+1. Create a new folder in `templates/(dashboard)/`
+2. Add `page.tsx` and any components
+3. Update `config/dashboard.config.ts` to add navigation
+
+## Modifying Styles
+
+Edit the CSS files in `styles/`:
+- `globals.css` - Global styles and CSS variables
+- `components.css` - Component-specific styles
+
+## Adding Languages
+
+1. Create a new folder in `messages/[locale]/`
+2. Copy files from `messages/en/`
+3. Translate all strings
+4. Update `config/app.config.ts` to include the new locale

package/templates/contents/themes/starter/entities/tasks/messages/de.json

@@ -0,0 +1,263 @@
+{
+  "entity": {
+    "name": "Aufgabe",
+    "namePlural": "Aufgaben",
+    "description": "Verwalten Sie Ihre Aufgaben und To-Do-Elemente"
+  },
+  "title": "Meine Aufgaben",
+  "subtitle": "Organisieren Sie Ihre Arbeit und behalten Sie die Kontrolle über Ihre Projekte.",
+  "description": "Organisieren Sie Ihre Arbeit und behalten Sie die Kontrolle über Ihre Projekte.",
+  "fields": {
+    "title": {
+      "label": "Titel",
+      "placeholder": "Aufgabentitel eingeben...",
+      "description": "Der Titel der Aufgabe"
+    },
+    "description": {
+      "label": "Beschreibung",
+      "placeholder": "Details zu dieser Aufgabe hinzufügen...",
+      "description": "Detaillierte Beschreibung der Aufgabe"
+    },
+    "status": {
+      "label": "Status",
+      "placeholder": "Status auswählen...",
+      "description": "Aktueller Status der Aufgabe"
+    },
+    "priority": {
+      "label": "Priorität",
+      "placeholder": "Priorität auswählen...",
+      "description": "Prioritätsstufe der Aufgabe"
+    },
+    "dueDate": {
+      "label": "Fälligkeitsdatum",
+      "placeholder": "Datum auswählen...",
+      "description": "Wann die Aufgabe fällig ist"
+    },
+    "estimatedHours": {
+      "label": "Geschätzte Stunden",
+      "placeholder": "0",
+      "description": "Geschätzte Zeit zur Fertigstellung in Stunden"
+    },
+    "tags": {
+      "label": "Tags",
+      "placeholder": "Tags hinzufügen...",
+      "description": "Tags zur Kategorisierung"
+    }
+  },
+  "status": {
+    "todo": "Zu erledigen",
+    "in-progress": "In Bearbeitung",
+    "review": "In Überprüfung",
+    "done": "Erledigt",
+    "blocked": "Blockiert",
+    "completed": "Abgeschlossen",
+    "pending": "Ausstehend",
+    "active": "Aktiv"
+  },
+  "priority": {
+    "low": "Niedrig",
+    "medium": "Mittel",
+    "high": "Hoch",
+    "urgent": "Dringend"
+  },
+  "actions": {
+    "create": "Aufgabe erstellen",
+    "edit": "Aufgabe bearbeiten",
+    "delete": "Aufgabe löschen",
+    "duplicate": "Aufgabe duplizieren",
+    "markComplete": "Als erledigt markieren",
+    "markIncomplete": "Als unerledigt markieren",
+    "archive": "Aufgabe archivieren",
+    "completed": "Aufgabe erledigt!",
+    "reactivated": "Aufgabe reaktiviert!",
+    "deleted": "Aufgabe gelöscht",
+    "markCompleted": "erledigt",
+    "markPending": "ausstehend",
+    "taskStatusChanged": "Aufgabe \"{title}\" {action}",
+    "taskDeleted": "Aufgabe \"{title}\" gelöscht",
+    "toggleError": "Fehler beim Ändern des Status der Aufgabe \"{title}\"",
+    "deleteError": "Fehler beim Löschen der Aufgabe",
+    "updateError": "Fehler beim Aktualisieren der Aufgabe"
+  },
+  "messages": {
+    "created": "Aufgabe erfolgreich erstellt",
+    "updated": "Aufgabe erfolgreich aktualisiert",
+    "deleted": "Aufgabe erfolgreich gelöscht",
+    "duplicated": "Aufgabe erfolgreich dupliziert",
+    "completed": "Aufgabe als erledigt markiert",
+    "confirmDelete": "Sind Sie sicher, dass Sie diese Aufgabe löschen möchten?",
+    "noTasks": "Keine Aufgaben gefunden",
+    "createFirst": "Erstellen Sie Ihre erste Aufgabe, um zu beginnen"
+  },
+  "filters": {
+    "all": "Alle Aufgaben",
+    "active": "Aktiv",
+    "completed": "Abgeschlossen",
+    "overdue": "Überfällig",
+    "dueToday": "Heute fällig",
+    "dueThisWeek": "Diese Woche fällig"
+  },
+  "sorting": {
+    "newest": "Neueste zuerst",
+    "oldest": "Älteste zuerst",
+    "priority": "Nach Priorität",
+    "dueDate": "Nach Fälligkeitsdatum",
+    "alphabetical": "Alphabetisch"
+  },
+  "stats": {
+    "active": "Aktiv",
+    "completed": "Abgeschlossen",
+    "total": "Aufgaben gesamt",
+    "totalDescription": "Alle Aufgaben im System",
+    "pending": "Ausstehend",
+    "pendingDescription": "Aufgaben, die auf Erledigung warten",
+    "overdue": "Überfällig"
+  },
+  "form": {
+    "addTitle": "Neue Aufgabe hinzufügen",
+    "addDescription": "Erstellen Sie eine neue Aufgabe, um zu verfolgen, was erledigt werden muss",
+    "titleLabel": "Aufgabentitel",
+    "titlePlaceholder": "Was muss erledigt werden?",
+    "titleDescription": "Geben Sie den Titel der neuen Aufgabe ein. Dieses Feld ist erforderlich.",
+    "descriptionLabel": "Aufgabenbeschreibung (optional)",
+    "descriptionPlaceholder": "Beschreibung hinzufügen (optional)",
+    "descriptionHelp": "Optionale Beschreibung für weitere Details zur Aufgabe.",
+    "addButton": "Aufgabe hinzufügen",
+    "adding": "Wird hinzugefügt...",
+    "enterTitle": "Geben Sie einen Titel ein, um die Schaltfläche zu aktivieren",
+    "creating": "Aufgabe wird erstellt, bitte warten",
+    "pressToCreate": "Drücken Sie, um die neue Aufgabe zu erstellen",
+    "addSuccess": "Aufgabe erfolgreich hinzugefügt!",
+    "addError": "Aufgabe konnte nicht hinzugefügt werden",
+    "tryAgain": "Bitte versuchen Sie es später erneut",
+    "taskCreated": "Aufgabe \"{title}\" erfolgreich erstellt",
+    "createError": "Fehler beim Erstellen der Aufgabe \"{title}\""
+  },
+  "task": {
+    "completed": "erledigt",
+    "active": "aktiv",
+    "deleteConfirm": "Sind Sie sicher, dass Sie diese Aufgabe löschen möchten?",
+    "deleteSuccess": "Aufgabe erfolgreich gelöscht",
+    "toggleSuccess": "Aufgabenstatus aktualisiert"
+  },
+  "overview": {
+    "title": "Aufgabenübersicht",
+    "label": "Aufgabenzusammenfassung",
+    "activeTasks": "{count} aktive Aufgaben",
+    "completedTasks": "{count} erledigte Aufgaben",
+    "totalTasks": "{count} Aufgaben insgesamt"
+  },
+  "sections": {
+    "activeTasks": "Aktive Aufgaben",
+    "completedTasks": "Erledigte Aufgaben"
+  },
+  "empty": {
+    "title": "Noch keine Aufgaben",
+    "description": "Fügen Sie oben Ihre erste Aufgabe hinzu, um zu beginnen!"
+  },
+  "accessibility": {
+    "taskCard": "Aufgabe: {title}. {status}. Drücken Sie Enter für Details.",
+    "completedTaskCard": "Erledigte Aufgabe: {title}. Drücken Sie Enter für Details.",
+    "toggleTask": "Aufgabe \"{title}\" als {action} markieren",
+    "reactivateTask": "Erledigte Aufgabe \"{title}\" reaktivieren",
+    "deleteTask": "Aufgabe \"{title}\" löschen",
+    "deleteCompletedTask": "Erledigte Aufgabe \"{title}\" löschen",
+    "createdDate": "Erstellt am {date}",
+    "completedDate": "Abgeschlossen am {date}"
+  },
+  "time": {
+    "daysAgo": "vor {count} Tag{count, plural, one {} other {en}}",
+    "hoursAgo": "vor {count} Stunde{count, plural, one {} other {n}}",
+    "minutesAgo": "vor {count} Minute{count, plural, one {} other {n}}",
+    "justNow": "Gerade eben"
+  },
+  "page": {
+    "statsAriaLabel": "Aufgabenstatistiken",
+    "listTitle": "Aufgabenliste",
+    "listDescription": "Verwalten Sie Ihre ausstehenden Aufgaben und organisieren Sie sich besser",
+    "today": "Heute"
+  },
+  "list": {
+    "title": "Aufgabenliste",
+    "description": "Verwalten Sie alle Ihre Aufgaben an einem Ort",
+    "allTasks": "Alle Aufgaben"
+  },
+  "detail": {
+    "loading": {
+      "message": "Aufgabendetails werden geladen",
+      "ariaLabel": "Aufgabendetails werden geladen",
+      "srText": "Aufgabendetails werden geladen..."
+    },
+    "navigation": {
+      "backToTasks": "Zurück zu Aufgaben",
+      "backAriaLabel": "Zurück zur Aufgabenliste",
+      "returnNavigation": "Rückwärtsnavigation",
+      "viewAllTasks": "Alle Aufgaben anzeigen",
+      "viewAllDescription": "Zurück zur vollständigen Aufgabenliste"
+    },
+    "error": {
+      "notFound": "Die angeforderte Aufgabe konnte nicht gefunden werden. Sie wurde möglicherweise gelöscht oder Sie haben keine Berechtigung, sie anzuzeigen.",
+      "title": "Aufgabe nicht gefunden"
+    },
+    "status": {
+      "completed": "Abgeschlossen",
+      "pending": "Ausstehend",
+      "active": "In Bearbeitung",
+      "completedAriaLabel": "Aufgabe abgeschlossen",
+      "pendingAriaLabel": "Aufgabe ausstehend"
+    },
+    "priority": {
+      "high": "Hoch",
+      "medium": "Mittel",
+      "low": "Niedrig",
+      "label": "Priorität"
+    },
+    "categories": {
+      "design": "Design",
+      "development": "Entwicklung",
+      "meetings": "Meetings",
+      "documentation": "Dokumentation",
+      "testing": "Testen",
+      "general": "Allgemein"
+    },
+    "sections": {
+      "description": "Beschreibung",
+      "actions": "Aktionen",
+      "information": "Information",
+      "classification": "Klassifizierung",
+      "metadata": "Aufgaben-Metadaten"
+    },
+    "actions": {
+      "title": "Aktionen",
+      "description": "Verwalten Sie den Status und die Optionen dieser Aufgabe. Tastenkombinationen: Cmd+Enter zum Abschließen, Cmd+Backspace zum Löschen.",
+      "markPending": "Als ausstehend markieren",
+      "markCompleted": "Als erledigt markieren",
+      "delete": "Löschen",
+      "markPendingAriaLabel": "Aufgabe \"{title}\" als ausstehend markieren. Tastenkombination: Cmd+Enter",
+      "markCompletedAriaLabel": "Aufgabe \"{title}\" als erledigt markieren. Tastenkombination: Cmd+Enter",
+      "deleteAriaLabel": "Aufgabe \"{title}\" endgültig löschen. Tastenkombination: Cmd+Backspace"
+    },
+    "info": {
+      "created": "Erstellt",
+      "lastUpdate": "Letzte Aktualisierung",
+      "status": "Status",
+      "priority": "Priorität",
+      "category": "Kategorie",
+      "taskId": "Aufgaben-ID",
+      "noDescription": "Keine Beschreibung für diese Aufgabe verfügbar.",
+      "inferredInfo": "Automatisch abgeleitete Information"
+    },
+    "messages": {
+      "taskCompleted": "Aufgabe \"{title}\" erfolgreich abgeschlossen",
+      "taskReactivated": "Aufgabe \"{title}\" erfolgreich reaktiviert",
+      "taskDeleted": "Aufgabe \"{title}\" erfolgreich gelöscht",
+      "toggleError": "Fehler beim Ändern des Status der Aufgabe \"{title}\"",
+      "deleteError": "Fehler beim Löschen der Aufgabe \"{title}\"",
+      "completedToast": "Aufgabe abgeschlossen",
+      "reactivatedToast": "Aufgabe reaktiviert",
+      "deletedToast": "Aufgabe gelöscht",
+      "updateErrorToast": "Fehler beim Aktualisieren der Aufgabe",
+      "deleteErrorToast": "Fehler beim Löschen der Aufgabe"
+    }
+  }
+}