@nextsparkjs/theme-default 0.1.0-beta.44 → 0.1.0-beta.45

package/entities/posts/api/presets.ts

@@ -0,0 +1,74 @@
+/**
+ * API Presets for Posts Entity
+ *
+ * These presets appear in the DevTools API Explorer's "Presets" tab.
+ * The endpoint is automatically derived from the entity name: /api/v1/posts
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage blog posts with builder and taxonomies',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Posts',
+      description: 'Fetch all posts with default pagination',
+      method: 'GET',
+      params: {
+        limit: 10,
+        offset: 0
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-published',
+      title: 'List Published Posts',
+      description: 'Fetch only published posts',
+      method: 'GET',
+      params: {
+        status: 'published',
+        limit: 20,
+        sortBy: 'createdAt',
+        sortOrder: 'desc'
+      },
+      tags: ['read', 'filter', 'public']
+    },
+    {
+      id: 'list-drafts',
+      title: 'List Draft Posts',
+      description: 'Fetch posts in draft status',
+      method: 'GET',
+      params: {
+        status: 'draft',
+        limit: 20
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'create-draft',
+      title: 'Create Draft Post',
+      description: 'Create a new post as draft',
+      method: 'POST',
+      payload: {
+        title: 'My New Blog Post',
+        slug: 'my-new-blog-post',
+        status: 'draft',
+        excerpt: 'A brief introduction to my post',
+        blocks: []
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'search-title',
+      title: 'Search by Title',
+      description: 'Search posts by title',
+      method: 'GET',
+      params: {
+        search: 'NextSpark',
+        searchField: 'title'
+      },
+      tags: ['read', 'search']
+    }
+  ]
+})

package/entities/tasks/api/docs.md

@@ -0,0 +1,126 @@
+# Tasks API
+
+Manage tasks with status tracking, priorities, and metadata support. Tasks are team-scoped private entities.
+
+## Overview
+
+The Tasks API allows you to create, read, update, and delete task records. Tasks support status workflows, priority levels, due dates, and metadata. Each task belongs to a team and is filtered based on the authenticated user's team context.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Tasks
+`GET /api/v1/tasks`
+
+Returns a paginated list of tasks for the current team.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `status` (string, optional): Filter by status (todo, in-progress, review, done, blocked)
+- `priority` (string, optional): Filter by priority (low, medium, high, urgent)
+- `search` (string, optional): Search term for title/description
+- `sortBy` (string, optional): Field to sort by
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "task_123",
+      "title": "Implement new feature",
+      "description": "Add user authentication flow",
+      "status": "in-progress",
+      "priority": "high",
+      "dueDate": "2024-02-01",
+      "estimatedHours": 8,
+      "tags": ["feature", "auth"],
+      "createdAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 42,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Task
+`GET /api/v1/tasks/[id]`
+
+Returns a single task by ID.
+
+**Path Parameters:**
+- `id` (string, required): Task ID
+
+### Create Task
+`POST /api/v1/tasks`
+
+Create a new task record.
+
+**Request Body:**
+```json
+{
+  "title": "New Task",
+  "description": "Task details here",
+  "status": "todo",
+  "priority": "medium",
+  "dueDate": "2024-02-15",
+  "estimatedHours": 4,
+  "tags": ["development"]
+}
+```
+
+### Update Task
+`PATCH /api/v1/tasks/[id]`
+
+Update an existing task.
+
+**Path Parameters:**
+- `id` (string, required): Task ID
+
+**Request Body:**
+Any fields to update (partial update supported).
+
+### Delete Task
+`DELETE /api/v1/tasks/[id]`
+
+Delete a task record.
+
+**Path Parameters:**
+- `id` (string, required): Task ID
+
+## Fields
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| title | text | Yes | - | Task title |
+| description | textarea | No | - | Detailed description |
+| status | select | No | todo | todo, in-progress, review, done, blocked |
+| priority | select | No | medium | low, medium, high, urgent |
+| tags | tags | No | [] | Task tags for categorization |
+| dueDate | date | No | - | Task deadline |
+| estimatedHours | number | No | - | Estimated time to complete |
+
+## Metadata Support
+
+Tasks support the metadata system. Use the metadata endpoints to store additional custom data:
+- `POST /api/v1/tasks/[id]/meta` - Add metadata
+- `GET /api/v1/tasks/[id]/meta` - Get metadata
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Task doesn't exist |
+| 422 | Validation Error - Invalid data |

package/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/lib/selectors.ts

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

package/messages/de/admin.json

@@ -214,6 +214,51 @@
     "messages": {
       "saved": "Erfolgreich gespeichert",
       "created": "Erfolgreich erstellt"
+    },
+    "header": {
+      "actions": {
+        "saveDraft": "Entwurf Speichern",
+        "publish": "Veröffentlichen",
+        "update": "Aktualisieren"
+      }
+    },
+    "canvas": {
+      "empty": {
+        "title": "Noch keine Blöcke",
+        "subtitle": "Fügen Sie Blöcke aus der Seitenleiste hinzu"
+      },
+      "editingBadge": "Bearbeiten",
+      "error": {
+        "blockNotFound": "Block nicht gefunden"
+      }
+    },
+    "floatingToolbar": {
+      "drag": "Ziehen zum Neuordnen",
+      "duplicate": "Block duplizieren",
+      "delete": "Block löschen"
+    },
+    "settingsPanel": {
+      "title": "Block-Eigenschaften",
+      "empty": {
+        "message": "Kein Block ausgewählt",
+        "hint": "Wählen Sie einen Block aus dem Canvas, um seine Einstellungen zu bearbeiten"
+      },
+      "error": {
+        "notFound": "Block-Konfiguration nicht gefunden"
+      },
+      "actions": {
+        "reset": "Zurücksetzen",
+        "remove": "Entfernen"
+      },
+      "tabs": {
+        "content": "Inhalt",
+        "design": "Design",
+        "advanced": "Erweitert",
+        "noContentFields": "Keine Inhaltsfelder",
+        "noDesignFields": "Keine Designfelder",
+        "noAdvancedFields": "Keine erweiterten Felder"
+      },
+      "noFields": "Dieser Block hat keine konfigurierbaren Felder"
     }
   }
 }

package/messages/en/admin.json

@@ -214,6 +214,51 @@
     "messages": {
       "saved": "Saved successfully",
       "created": "Created successfully"
+    },
+    "header": {
+      "actions": {
+        "saveDraft": "Save Draft",
+        "publish": "Publish",
+        "update": "Update"
+      }
+    },
+    "canvas": {
+      "empty": {
+        "title": "No blocks yet",
+        "subtitle": "Add blocks from the left sidebar"
+      },
+      "editingBadge": "Editing",
+      "error": {
+        "blockNotFound": "Block not found"
+      }
+    },
+    "floatingToolbar": {
+      "drag": "Drag to reorder",
+      "duplicate": "Duplicate block",
+      "delete": "Delete block"
+    },
+    "settingsPanel": {
+      "title": "Block Properties",
+      "empty": {
+        "message": "No block selected",
+        "hint": "Select a block from the canvas to edit its settings"
+      },
+      "error": {
+        "notFound": "Block configuration not found"
+      },
+      "actions": {
+        "reset": "Reset",
+        "remove": "Remove"
+      },
+      "tabs": {
+        "content": "Content",
+        "design": "Design",
+        "advanced": "Advanced",
+        "noContentFields": "No content fields",
+        "noDesignFields": "No design fields",
+        "noAdvancedFields": "No advanced fields"
+      },
+      "noFields": "This block has no configurable fields"
     }
   }
 }

package/messages/es/admin.json

@@ -214,6 +214,51 @@
     "messages": {
       "saved": "Guardado exitosamente",
       "created": "Creado exitosamente"
+    },
+    "header": {
+      "actions": {
+        "saveDraft": "Guardar Borrador",
+        "publish": "Publicar",
+        "update": "Actualizar"
+      }
+    },
+    "canvas": {
+      "empty": {
+        "title": "Aún no hay bloques",
+        "subtitle": "Agrega bloques desde la barra lateral izquierda"
+      },
+      "editingBadge": "Editando",
+      "error": {
+        "blockNotFound": "Bloque no encontrado"
+      }
+    },
+    "floatingToolbar": {
+      "drag": "Arrastra para reordenar",
+      "duplicate": "Duplicar bloque",
+      "delete": "Eliminar bloque"
+    },
+    "settingsPanel": {
+      "title": "Propiedades del Bloque",
+      "empty": {
+        "message": "Ningún bloque seleccionado",
+        "hint": "Selecciona un bloque del canvas para editar su configuración"
+      },
+      "error": {
+        "notFound": "Configuración del bloque no encontrada"
+      },
+      "actions": {
+        "reset": "Restablecer",
+        "remove": "Eliminar"
+      },
+      "tabs": {
+        "content": "Contenido",
+        "design": "Diseño",
+        "advanced": "Avanzado",
+        "noContentFields": "Sin campos de contenido",
+        "noDesignFields": "Sin campos de diseño",
+        "noAdvancedFields": "Sin campos avanzados"
+      },
+      "noFields": "Este bloque no tiene campos configurables"
     }
   }
 }

package/messages/fr/admin.json

@@ -214,6 +214,51 @@
     "messages": {
       "saved": "Enregistre avec succes",
       "created": "Cree avec succes"
+    },
+    "header": {
+      "actions": {
+        "saveDraft": "Sauvegarder Brouillon",
+        "publish": "Publier",
+        "update": "Mettre à jour"
+      }
+    },
+    "canvas": {
+      "empty": {
+        "title": "Pas encore de blocs",
+        "subtitle": "Ajoutez des blocs depuis la barre laterale"
+      },
+      "editingBadge": "Edition",
+      "error": {
+        "blockNotFound": "Bloc non trouve"
+      }
+    },
+    "floatingToolbar": {
+      "drag": "Glissez pour reordonner",
+      "duplicate": "Dupliquer le bloc",
+      "delete": "Supprimer le bloc"
+    },
+    "settingsPanel": {
+      "title": "Proprietes du Bloc",
+      "empty": {
+        "message": "Aucun bloc selectionne",
+        "hint": "Selectionnez un bloc du canvas pour modifier ses parametres"
+      },
+      "error": {
+        "notFound": "Configuration du bloc non trouvee"
+      },
+      "actions": {
+        "reset": "Reinitialiser",
+        "remove": "Supprimer"
+      },
+      "tabs": {
+        "content": "Contenu",
+        "design": "Design",
+        "advanced": "Avance",
+        "noContentFields": "Pas de champs de contenu",
+        "noDesignFields": "Pas de champs de design",
+        "noAdvancedFields": "Pas de champs avances"
+      },
+      "noFields": "Ce bloc n'a pas de champs configurables"
     }
   }
 }

package/messages/it/admin.json

@@ -214,6 +214,51 @@
     "messages": {
       "saved": "Salvato con successo",
       "created": "Creato con successo"
+    },
+    "header": {
+      "actions": {
+        "saveDraft": "Salva Bozza",
+        "publish": "Pubblica",
+        "update": "Aggiorna"
+      }
+    },
+    "canvas": {
+      "empty": {
+        "title": "Nessun blocco ancora",
+        "subtitle": "Aggiungi blocchi dalla barra laterale"
+      },
+      "editingBadge": "Modifica",
+      "error": {
+        "blockNotFound": "Blocco non trovato"
+      }
+    },
+    "floatingToolbar": {
+      "drag": "Trascina per riordinare",
+      "duplicate": "Duplica blocco",
+      "delete": "Elimina blocco"
+    },
+    "settingsPanel": {
+      "title": "Proprietà del Blocco",
+      "empty": {
+        "message": "Nessun blocco selezionato",
+        "hint": "Seleziona un blocco dal canvas per modificare le impostazioni"
+      },
+      "error": {
+        "notFound": "Configurazione del blocco non trovata"
+      },
+      "actions": {
+        "reset": "Ripristina",
+        "remove": "Rimuovi"
+      },
+      "tabs": {
+        "content": "Contenuto",
+        "design": "Design",
+        "advanced": "Avanzato",
+        "noContentFields": "Nessun campo contenuto",
+        "noDesignFields": "Nessun campo design",
+        "noAdvancedFields": "Nessun campo avanzato"
+      },
+      "noFields": "Questo blocco non ha campi configurabili"
     }
   }
 }

package/messages/pt/admin.json

@@ -214,6 +214,51 @@
     "messages": {
       "saved": "Salvo com sucesso",
       "created": "Criado com sucesso"
+    },
+    "header": {
+      "actions": {
+        "saveDraft": "Salvar Rascunho",
+        "publish": "Publicar",
+        "update": "Atualizar"
+      }
+    },
+    "canvas": {
+      "empty": {
+        "title": "Nenhum bloco ainda",
+        "subtitle": "Adicione blocos da barra lateral"
+      },
+      "editingBadge": "Editando",
+      "error": {
+        "blockNotFound": "Bloco não encontrado"
+      }
+    },
+    "floatingToolbar": {
+      "drag": "Arraste para reordenar",
+      "duplicate": "Duplicar bloco",
+      "delete": "Excluir bloco"
+    },
+    "settingsPanel": {
+      "title": "Propriedades do Bloco",
+      "empty": {
+        "message": "Nenhum bloco selecionado",
+        "hint": "Selecione um bloco do canvas para editar as configurações"
+      },
+      "error": {
+        "notFound": "Configuração do bloco não encontrada"
+      },
+      "actions": {
+        "reset": "Redefinir",
+        "remove": "Remover"
+      },
+      "tabs": {
+        "content": "Conteúdo",
+        "design": "Design",
+        "advanced": "Avançado",
+        "noContentFields": "Sem campos de conteúdo",
+        "noDesignFields": "Sem campos de design",
+        "noAdvancedFields": "Sem campos avançados"
+      },
+      "noFields": "Este bloco não tem campos configuráveis"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/theme-default",
-  "version": "0.1.0-beta.44",
+  "version": "0.1.0-beta.45",
   "private": false,
   "type": "module",
   "main": "./config/theme.config.ts",
@@ -17,8 +17,8 @@
     "react-dom": "^19.0.0",
     "react-markdown": "^10.1.0",
     "zod": "^4.0.0",
-    "@nextsparkjs/core": "0.1.0-beta.44",
-    "@nextsparkjs/testing": "0.1.0-beta.44"
+    "@nextsparkjs/core": "0.1.0-beta.45",
+    "@nextsparkjs/testing": "0.1.0-beta.45"
   },
   "nextspark": {
     "type": "theme",

package/styles/globals.css

@@ -3,8 +3,20 @@
  *
  * Pure neutral grays using OKLCH color space.
  * Based on shadcn/ui default configuration.
+ *
+ * ÚNICA FUENTE DE VERDAD para estilos del theme.
+ * Editar este archivo para customizar el design system.
  */
 
+/* =============================================
+   IMPORTS
+   ============================================= */
+@import "tailwindcss";
+@import "@nextsparkjs/core/styles/ui.css";
+@import "@nextsparkjs/core/styles/utilities.css";
+@import "@nextsparkjs/core/styles/docs.css";
+@source "../../../**/*.{js,ts,jsx,tsx}";
+
 /* =============================================
    DEFAULT THEME - LIGHT MODE
    ============================================= */
@@ -177,3 +189,15 @@
   --shadow-xl: var(--shadow-xl);
   --shadow-2xl: var(--shadow-2xl);
 }
+
+/* =============================================
+   BASE STYLES
+   ============================================= */
+* {
+  border-color: var(--border);
+}
+
+body {
+  background-color: var(--background);
+  color: var(--foreground);
+}