@nextsparkjs/theme-default 0.1.0-beta.1 → 0.1.0-beta.100

package/entities/pages/api/presets.ts

@@ -0,0 +1,72 @@
+/**
+ * API Presets for Pages Entity
+ *
+ * These presets appear in the DevTools API Explorer's "Presets" tab.
+ * The endpoint is automatically derived from the entity name: /api/v1/pages
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage builder-enabled pages',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Pages',
+      description: 'Fetch all pages with default pagination',
+      method: 'GET',
+      params: {
+        limit: 10,
+        offset: 0
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-published',
+      title: 'List Published Pages',
+      description: 'Fetch only published pages',
+      method: 'GET',
+      params: {
+        status: 'published',
+        limit: 20
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-by-locale',
+      title: 'List Spanish Pages',
+      description: 'Fetch pages in Spanish locale',
+      method: 'GET',
+      params: {
+        locale: 'es',
+        limit: 10
+      },
+      tags: ['read', 'filter', 'i18n']
+    },
+    {
+      id: 'create-draft',
+      title: 'Create Draft Page',
+      description: 'Create a new page as draft',
+      method: 'POST',
+      payload: {
+        title: 'New Page',
+        slug: 'new-page',
+        status: 'draft',
+        locale: 'en',
+        blocks: []
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'search-title',
+      title: 'Search by Title',
+      description: 'Search pages by title',
+      method: 'GET',
+      params: {
+        search: 'About',
+        searchField: 'title'
+      },
+      tags: ['read', 'search']
+    }
+  ]
+})

package/entities/posts/api/docs.md

@@ -0,0 +1,120 @@
+# Posts API
+
+Manage blog posts with builder support and taxonomies. Posts render at /blog/[slug] and support categories, featured images, and excerpts.
+
+## Overview
+
+The Posts API allows you to create, read, update, and delete blog posts with builder content. Posts support the page builder for content creation and include taxonomy management for categories.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Posts
+`GET /api/v1/posts`
+
+Returns a paginated list of posts.
+
+**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 (draft, published, scheduled, archived)
+- `search` (string, optional): Search term for title/excerpt
+- `sortBy` (string, optional): Field to sort by
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "post_123",
+      "title": "Getting Started with NextSpark",
+      "slug": "getting-started",
+      "status": "published",
+      "excerpt": "Learn how to build amazing apps with NextSpark",
+      "featuredImage": "/uploads/hero.jpg",
+      "blocks": [...],
+      "createdAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 42,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Post
+`GET /api/v1/posts/[id]`
+
+Returns a single post by ID.
+
+**Path Parameters:**
+- `id` (string, required): Post ID
+
+### Create Post
+`POST /api/v1/posts`
+
+Create a new post record.
+
+**Request Body:**
+```json
+{
+  "title": "My New Blog Post",
+  "slug": "my-new-blog-post",
+  "status": "draft",
+  "excerpt": "A brief introduction to my post",
+  "blocks": []
+}
+```
+
+### Update Post
+`PATCH /api/v1/posts/[id]`
+
+Update an existing post.
+
+**Path Parameters:**
+- `id` (string, required): Post ID
+
+**Request Body:**
+Any fields to update (partial update supported).
+
+### Delete Post
+`DELETE /api/v1/posts/[id]`
+
+Delete a post record.
+
+**Path Parameters:**
+- `id` (string, required): Post ID
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| title | text | Yes | Post title |
+| slug | text | Yes | URL-friendly identifier |
+| status | select | Yes | draft, published, scheduled, archived |
+| excerpt | textarea | No | Short summary of the post |
+| featuredImage | image | No | Main image for the post |
+| blocks | json | No | Page builder content |
+
+## Taxonomies
+
+Posts support the following taxonomies:
+- **categories** (post_category): Multiple categories can be assigned
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Post doesn't exist |
+| 422 | Validation Error - Invalid data |

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,8 +9,7 @@
  * - Cypress tests (via tests/cypress/src/selectors.ts)
  */
 
-import { createSelectorHelpers } from '@nextsparkjs/core/lib/test/selector-factory'
-import { CORE_SELECTORS } from '@nextsparkjs/core/lib/test/core-selectors'
+import { createSelectorHelpers, CORE_SELECTORS } from '@nextsparkjs/core/selectors'
 
 // =============================================================================
 // BLOCK SELECTORS
@@ -134,11 +133,15 @@ export const DEVTOOLS_SELECTORS = {
 
 /**
  * Complete theme selectors merging core and blocks.
+ * NOTE: devtools must be MERGED (not replaced) to keep CORE_SELECTORS.devtools
  */
 export const THEME_SELECTORS = {
   ...CORE_SELECTORS,
   blocks: BLOCK_SELECTORS,
-  devtools: DEVTOOLS_SELECTORS,
+  devtools: {
+    ...CORE_SELECTORS.devtools,
+    ...DEVTOOLS_SELECTORS,
+  },
 } as const
 
 // =============================================================================
@@ -193,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/core/lib/test/selector-factory'
+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,62 @@
     "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",
+      "pattern": {
+        "title": "Pattern Reference",
+        "locked": {
+          "title": "Pattern is read-only",
+          "description": "To edit this pattern's content, edit the pattern directly. Changes will be reflected everywhere it's used."
+        },
+        "actions": {
+          "edit": "Edit Pattern",
+          "remove": "Remove from page"
+        }
+      }
     }
   }
 }

package/messages/en/navigation.json

@@ -4,5 +4,6 @@
   "support": "Support",
   "docs": "Documentation",
   "dashboard": "Dashboard",
-  "pages": "Pages"
+  "pages": "Pages",
+  "media": "Media"
 }

package/messages/es/admin.json

@@ -214,6 +214,62 @@
     "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",
+      "pattern": {
+        "title": "Referencia de Patrón",
+        "locked": {
+          "title": "El patrón es de solo lectura",
+          "description": "Para editar el contenido de este patrón, edítalo directamente. Los cambios se reflejarán en todos los lugares donde se usa."
+        },
+        "actions": {
+          "edit": "Editar Patrón",
+          "remove": "Quitar de la página"
+        }
+      }
     }
   }
 }