@nextsparkjs/core 0.1.0-beta.8 → 0.1.0-beta.82

package/templates/contents/themes/starter/entities/tasks/api/presets.ts

@@ -0,0 +1,84 @@
+/**
+ * API Presets for Tasks Entity
+ *
+ * These presets appear in the DevTools API Explorer's "Presets" tab.
+ * The endpoint is automatically derived from the entity name: /api/v1/tasks
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage tasks with status and priorities',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Tasks',
+      description: 'Fetch all tasks with default pagination',
+      method: 'GET',
+      params: {
+        limit: 10,
+        offset: 0
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-todo',
+      title: 'List To-Do Tasks',
+      description: 'Fetch tasks in to-do status',
+      method: 'GET',
+      params: {
+        status: 'todo',
+        limit: 20
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-in-progress',
+      title: 'List In Progress',
+      description: 'Fetch tasks currently in progress',
+      method: 'GET',
+      params: {
+        status: 'in-progress',
+        limit: 20
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-urgent',
+      title: 'List Urgent Tasks',
+      description: 'Fetch high priority and urgent tasks',
+      method: 'GET',
+      params: {
+        priority: 'urgent',
+        sortBy: 'dueDate',
+        sortOrder: 'asc'
+      },
+      tags: ['read', 'filter', 'priority']
+    },
+    {
+      id: 'create-task',
+      title: 'Create New Task',
+      description: 'Create a new task with sample data',
+      method: 'POST',
+      payload: {
+        title: 'New Task',
+        description: 'Task description here',
+        status: 'todo',
+        priority: 'medium',
+        tags: ['development']
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'search-title',
+      title: 'Search by Title',
+      description: 'Search tasks by title',
+      method: 'GET',
+      params: {
+        search: 'feature',
+        searchField: 'title'
+      },
+      tags: ['read', 'search']
+    }
+  ]
+})

package/templates/contents/themes/starter/entities/tasks/tasks.config.ts

@@ -55,49 +55,8 @@ export const taskEntityConfig: EntityConfig = {
   // ==========================================
   // 4. PERMISSIONS SYSTEM
   // ==========================================
-  permissions: {
-    actions: [
-      {
-        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'],
-      },
-      {
-        action: 'list',
-        label: 'List tasks',
-        description: 'Can see the tasks list',
-        roles: ['owner', 'admin', 'member'],
-      },
-      {
-        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,
-      },
-    ],
-    customActions: [
-      {
-        action: 'assign',
-        label: 'Assign tasks',
-        description: 'Can assign tasks to team members',
-        roles: ['owner', 'admin'],
-      },
-    ],
-  },
+  // Permissions are now centralized in permissions.config.ts
+  // See: contents/themes/starter/config/permissions.config.ts -> entities.tasks
 
   // ==========================================
   // FIELDS (imported from separate file)

package/templates/contents/themes/starter/entities/tasks/tasks.service.ts

@@ -99,7 +99,6 @@ export class TasksService {
         updatedAt: task.updatedAt,
       }
     } catch (error) {
-      console.error('TasksService.getById error:', error)
       throw new Error(
         error instanceof Error ? error.message : 'Failed to fetch task'
       )
@@ -229,7 +228,6 @@ export class TasksService {
         total,
       }
     } catch (error) {
-      console.error('TasksService.list error:', error)
       throw new Error(
         error instanceof Error ? error.message : 'Failed to list tasks'
       )
@@ -259,7 +257,6 @@ export class TasksService {
 
       return tasks
     } catch (error) {
-      console.error('TasksService.getByStatus error:', error)
       throw new Error(
         error instanceof Error
           ? error.message
@@ -323,7 +320,6 @@ export class TasksService {
         updatedAt: task.updatedAt,
       }))
     } catch (error) {
-      console.error('TasksService.getOverdue error:', error)
       throw new Error(
         error instanceof Error ? error.message : 'Failed to fetch overdue tasks'
       )
@@ -379,7 +375,6 @@ export class TasksService {
         updatedAt: task.updatedAt,
       }))
     } catch (error) {
-      console.error('TasksService.getDueToday error:', error)
       throw new Error(
         error instanceof Error
           ? error.message

package/templates/contents/themes/starter/lib/selectors.ts

@@ -9,7 +9,7 @@
  * - Cypress tests (via tests/cypress/src/selectors.ts)
  */
 
-import { createSelectorHelpers, CORE_SELECTORS } from '@nextsparkjs/core/lib/test'
+import { createSelectorHelpers, CORE_SELECTORS } from '@nextsparkjs/core/selectors'
 
 // =============================================================================
 // BLOCK SELECTORS
@@ -90,5 +90,5 @@ export const entitySelectors = helpers.entitySelectors
  */
 export type ThemeSelectorsType = typeof THEME_SELECTORS
 export type BlockSelectorsType = typeof BLOCK_SELECTORS
-export type { Replacements } from '@nextsparkjs/core/lib/test'
+export type { Replacements } from '@nextsparkjs/core/selectors'
 export { CORE_SELECTORS }

package/templates/contents/themes/starter/messages/de/common.json

@@ -8,7 +8,10 @@
   "delete": "Löschen",
   "edit": "Bearbeiten",
   "create": "Erstellen",
-  "search": "Suchen...",
+  "search": {
+    "placeholder": "Suchen...",
+    "label": "Suchen"
+  },
   "noResults": "Keine Ergebnisse gefunden",
   "confirm": "Bestätigen",
   "back": "Zurück",

package/templates/contents/themes/starter/messages/de/features.json

@@ -0,0 +1,8 @@
+{
+  "analytics": {
+    "title": "Erweiterte Analysen",
+    "benefit1": "Detaillierte Einblicke mit benutzerdefinierten Berichten",
+    "benefit2": "Echtzeit-Daten-Dashboards",
+    "benefit3": "Daten in mehreren Formaten exportieren"
+  }
+}

package/templates/contents/themes/starter/messages/de/index.ts

@@ -0,0 +1,15 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+import public_ from './public.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation,
+  public: public_
+} as const

package/templates/contents/themes/starter/messages/en/common.json

@@ -8,7 +8,10 @@
   "delete": "Delete",
   "edit": "Edit",
   "create": "Create",
-  "search": "Search...",
+  "search": {
+    "placeholder": "Search...",
+    "label": "Search"
+  },
   "noResults": "No results found",
   "confirm": "Confirm",
   "back": "Back",

package/templates/contents/themes/starter/messages/en/features.json

@@ -0,0 +1,8 @@
+{
+  "analytics": {
+    "title": "Advanced Analytics",
+    "benefit1": "Deep insights with custom reports",
+    "benefit2": "Real-time data dashboards",
+    "benefit3": "Export data in multiple formats"
+  }
+}

package/templates/contents/themes/starter/messages/en/index.ts

@@ -0,0 +1,15 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+import public_ from './public.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation,
+  public: public_
+} as const

package/templates/contents/themes/starter/messages/es/common.json

@@ -8,7 +8,10 @@
   "delete": "Eliminar",
   "edit": "Editar",
   "create": "Crear",
-  "search": "Buscar...",
+  "search": {
+    "placeholder": "Buscar...",
+    "label": "Buscar"
+  },
   "noResults": "No se encontraron resultados",
   "confirm": "Confirmar",
   "back": "Volver",

package/templates/contents/themes/starter/messages/es/features.json

@@ -0,0 +1,8 @@
+{
+  "analytics": {
+    "title": "Analíticas Avanzadas",
+    "benefit1": "Información detallada con reportes personalizados",
+    "benefit2": "Dashboards de datos en tiempo real",
+    "benefit3": "Exporta datos en múltiples formatos"
+  }
+}

package/templates/contents/themes/starter/messages/es/index.ts

@@ -0,0 +1,15 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+import public_ from './public.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation,
+  public: public_
+} as const

package/templates/contents/themes/starter/messages/fr/common.json

@@ -8,7 +8,10 @@
   "delete": "Supprimer",
   "edit": "Modifier",
   "create": "Créer",
-  "search": "Rechercher...",
+  "search": {
+    "placeholder": "Rechercher...",
+    "label": "Rechercher"
+  },
   "noResults": "Aucun résultat trouvé",
   "confirm": "Confirmer",
   "back": "Retour",

package/templates/contents/themes/starter/messages/fr/features.json

@@ -0,0 +1,8 @@
+{
+  "analytics": {
+    "title": "Analytiques Avancées",
+    "benefit1": "Informations détaillées avec rapports personnalisés",
+    "benefit2": "Tableaux de bord de données en temps réel",
+    "benefit3": "Exporter les données dans plusieurs formats"
+  }
+}

package/templates/contents/themes/starter/messages/fr/index.ts

@@ -0,0 +1,15 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+import public_ from './public.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation,
+  public: public_
+} as const

package/templates/contents/themes/starter/messages/it/common.json

@@ -8,7 +8,10 @@
   "delete": "Elimina",
   "edit": "Modifica",
   "create": "Crea",
-  "search": "Cerca...",
+  "search": {
+    "placeholder": "Cerca...",
+    "label": "Cerca"
+  },
   "noResults": "Nessun risultato trovato",
   "confirm": "Conferma",
   "back": "Indietro",

package/templates/contents/themes/starter/messages/it/features.json

@@ -0,0 +1,8 @@
+{
+  "analytics": {
+    "title": "Analisi Avanzate",
+    "benefit1": "Informazioni dettagliate con report personalizzati",
+    "benefit2": "Dashboard dati in tempo reale",
+    "benefit3": "Esporta dati in più formati"
+  }
+}

package/templates/contents/themes/starter/messages/it/index.ts

@@ -0,0 +1,13 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation
+} as const

package/templates/contents/themes/starter/messages/pt/common.json

@@ -8,7 +8,10 @@
   "delete": "Excluir",
   "edit": "Editar",
   "create": "Criar",
-  "search": "Pesquisar...",
+  "search": {
+    "placeholder": "Pesquisar...",
+    "label": "Pesquisar"
+  },
   "noResults": "Nenhum resultado encontrado",
   "confirm": "Confirmar",
   "back": "Voltar",

package/templates/contents/themes/starter/messages/pt/features.json

@@ -0,0 +1,8 @@
+{
+  "analytics": {
+    "title": "Analytics Avançado",
+    "benefit1": "Insights detalhados com relatórios personalizados",
+    "benefit2": "Dashboards de dados em tempo real",
+    "benefit3": "Exportar dados em múltiplos formatos"
+  }
+}

package/templates/contents/themes/starter/messages/pt/index.ts

@@ -0,0 +1,13 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation
+} as const

package/templates/contents/themes/starter/styles/globals.css

@@ -1,11 +1,81 @@
-/* Starter Theme Global Styles */
+/* =============================================
+   STARTER THEME - ÚNICA FUENTE DE VERDAD
 
-/* Import base styles from core */
-@import '@nextsparkjs/core/styles/globals.css';
+   Este archivo contiene TODO el design system del theme.
+   Editar este archivo para customizar colores, tipografía y tokens.
+   NO importa globals.css del core - es completamente independiente.
+   ============================================= */
 
-/* Theme-specific CSS variables */
+/* =============================================
+   IMPORTS
+   ============================================= */
+@import "tailwindcss";
+@import "@nextsparkjs/core/styles/utilities.css";
+@import "@nextsparkjs/core/styles/docs.css";
+@source "../../../**/*.{js,ts,jsx,tsx}";
+/* Core package: monorepo (short path) + npm projects (long path) */
+@source "../node_modules/@nextsparkjs/core/dist/**/*.js";
+@source "../../../../node_modules/@nextsparkjs/core/dist/**/*.js";
+
+/* =============================================
+   THEME VARIABLES - LIGHT MODE (OKLCH)
+
+   Formato OKLCH: oklch(lightness chroma hue)
+   - lightness: 0 (negro) a 1 (blanco)
+   - chroma: 0 (gris) a 0.4 (muy saturado)
+   - hue: 0-360 grados (rojo=0, amarillo=90, verde=150, azul=240)
+
+   Para colores neutros (grises), chroma = 0
+   ============================================= */
 :root {
-  /* Custom spacing */
+  /* Surface Colors - Fondos principales */
+  --background: oklch(1 0 0);              /* Blanco puro */
+  --foreground: oklch(0.145 0 0);          /* Casi negro */
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+
+  /* Interactive Colors - Acciones principales */
+  --primary: oklch(0.205 0 0);             /* Negro para acciones principales */
+  --primary-foreground: oklch(0.985 0 0);  /* Blanco para texto sobre primary */
+  --secondary: oklch(0.97 0 0);            /* Gris muy claro */
+  --secondary-foreground: oklch(0.205 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+
+  /* State Colors - Estados del sistema */
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);    /* Gris medio para texto secundario */
+  --destructive: oklch(0.577 0.245 27.325); /* Rojo para errores/danger */
+  --destructive-foreground: oklch(0.985 0 0);
+
+  /* Border & Input - Bordes e inputs */
+  --border: oklch(0.922 0 0);              /* Gris claro para bordes */
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.205 0 0);                /* Color del focus ring */
+
+  /* Chart Colors - Para gráficos */
+  --chart-1: oklch(0.646 0.222 41.116);    /* Naranja */
+  --chart-2: oklch(0.6 0.118 184.704);     /* Teal */
+  --chart-3: oklch(0.398 0.07 227.392);    /* Azul oscuro */
+  --chart-4: oklch(0.828 0.189 84.429);    /* Amarillo */
+  --chart-5: oklch(0.769 0.188 70.08);     /* Dorado */
+
+  /* Sidebar - Barra lateral del dashboard */
+  --sidebar-background: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.395 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.205 0 0);
+
+  /* Design Tokens */
+  --radius: 0.5rem;
+
+  /* Custom spacing (opcional) */
   --spacing-xs: 0.125rem;
   --spacing-sm: 0.25rem;
   --spacing-md: 0.5rem;
@@ -14,7 +84,113 @@
   --spacing-2xl: 2rem;
 }
 
-/* Dark mode overrides if needed */
+/* =============================================
+   THEME VARIABLES - DARK MODE
+
+   El dark mode invierte lightness pero mantiene el mismo hue y chroma.
+   Esto asegura consistencia visual entre modos.
+   ============================================= */
 .dark {
-  /* Custom dark mode variables */
+  /* Surface Colors */
+  --background: oklch(0.145 0 0);          /* Casi negro */
+  --foreground: oklch(0.985 0 0);          /* Casi blanco */
+  --card: oklch(0.145 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.145 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+
+  /* Interactive Colors */
+  --primary: oklch(0.985 0 0);             /* Invertido: blanco como primary */
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+
+  /* State Colors */
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --destructive: oklch(0.396 0.141 25.723); /* Rojo más oscuro en dark */
+  --destructive-foreground: oklch(0.985 0 0);
+
+  /* Border & Input */
+  --border: oklch(0.269 0 0);
+  --input: oklch(0.269 0 0);
+  --ring: oklch(0.439 0 0);
+
+  /* Chart Colors - Ajustados para dark mode */
+  --chart-1: oklch(0.488 0.243 264.376);   /* Azul */
+  --chart-2: oklch(0.696 0.17 162.48);     /* Verde */
+  --chart-3: oklch(0.769 0.188 70.08);     /* Naranja */
+  --chart-4: oklch(0.627 0.265 303.9);     /* Púrpura */
+  --chart-5: oklch(0.645 0.246 16.439);    /* Rosa */
+
+  /* Sidebar */
+  --sidebar-background: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.97 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.97 0 0);
+  --sidebar-border: oklch(0.269 0 0);
+  --sidebar-ring: oklch(0.439 0 0);
+}
+
+/* =============================================
+   TAILWIND v4 THEME MAPPING
+
+   Este bloque @theme conecta las CSS variables con las clases de Tailwind.
+   Ejemplo: --color-primary permite usar bg-primary, text-primary, etc.
+   ============================================= */
+@theme {
+  /* Main semantic colors */
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+
+  /* Chart colors */
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+
+  /* Sidebar colors */
+  --color-sidebar: var(--sidebar-background);
+  --color-sidebar-background: var(--sidebar-background);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+}
+
+/* =============================================
+   BASE STYLES
+   ============================================= */
+* {
+  border-color: var(--border);
+}
+
+body {
+  background-color: var(--background);
+  color: var(--foreground);
 }

package/templates/contents/themes/starter/templates/(dashboard)/analytics/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonAnalyticsPage } from '@nextsparkjs/core/components/ui/skeleton-features'
+
+export default function AnalyticsLoading() {
+  return <SkeletonAnalyticsPage />
+}

package/templates/contents/themes/starter/templates/(public)/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonLandingPage } from '@nextsparkjs/core/components/ui/skeleton-public'
+
+export default function HomeLoading() {
+  return <SkeletonLandingPage />
+}