@nextsparkjs/theme-default 0.1.0-beta.17 → 0.1.0-beta.170

package/entities/pages/api/docs.md

@@ -0,0 +1,114 @@
+# Pages API
+
+Manage builder-enabled pages in the system. Pages render at root URLs (e.g., /about, /contact) and support the page builder for content creation.
+
+## Overview
+
+The Pages API allows you to create, read, update, and delete pages with builder content. Pages are public content and can be accessed by all authenticated users.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Pages
+`GET /api/v1/pages`
+
+Returns a paginated list of pages.
+
+**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)
+- `locale` (string, optional): Filter by locale (en, es)
+- `search` (string, optional): Search term for title/slug
+- `sortBy` (string, optional): Field to sort by
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "page_123",
+      "title": "About Us",
+      "slug": "about",
+      "status": "published",
+      "locale": "en",
+      "blocks": [...],
+      "createdAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 15,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Page
+`GET /api/v1/pages/[id]`
+
+Returns a single page by ID.
+
+**Path Parameters:**
+- `id` (string, required): Page ID
+
+### Create Page
+`POST /api/v1/pages`
+
+Create a new page record.
+
+**Request Body:**
+```json
+{
+  "title": "Contact Us",
+  "slug": "contact",
+  "status": "draft",
+  "locale": "en",
+  "blocks": []
+}
+```
+
+### Update Page
+`PATCH /api/v1/pages/[id]`
+
+Update an existing page.
+
+**Path Parameters:**
+- `id` (string, required): Page ID
+
+**Request Body:**
+Any fields to update (partial update supported).
+
+### Delete Page
+`DELETE /api/v1/pages/[id]`
+
+Delete a page record.
+
+**Path Parameters:**
+- `id` (string, required): Page ID
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| title | text | Yes | Page title |
+| slug | text | Yes | URL-friendly identifier |
+| status | select | Yes | draft, published, scheduled, archived |
+| locale | select | Yes | en, es |
+| blocks | json | No | Page builder content |
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Page doesn't exist |
+| 422 | Validation Error - Invalid data |

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"
     }
   }
 }