@nextsparkjs/theme-productivity 0.1.0-beta.1 → 0.1.0-beta.101

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NextSpark
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/config/app.config.ts

@@ -58,11 +58,10 @@ export const APP_CONFIG_OVERRIDES = {
   // =============================================================================
   api: {
     cors: {
-      allowedOrigins: {
-        development: [
-          'http://localhost:3000',
-          'http://localhost:5173',
-        ],
+      // Theme-specific CORS origins (extends core defaults, does not replace)
+      // No additional origins needed for productivity theme - uses core defaults
+      additionalOrigins: {
+        development: [],
         production: [],
       },
     },

package/config/dashboard.config.ts

@@ -53,6 +53,19 @@ export const DASHBOARD_CONFIG = {
     devtoolsAccess: {
       enabled: true,
     },
+    /**
+     * Settings menu dropdown (gear icon)
+     */
+    settingsMenu: {
+      enabled: true,
+      links: [
+        {
+          label: 'navigation.patterns',
+          href: '/dashboard/patterns',
+          icon: 'layers',
+        },
+      ],
+    },
     userMenu: {
       enabled: true,
       showAvatar: true,

package/config/permissions.config.ts

@@ -82,6 +82,17 @@ export const PERMISSIONS_CONFIG_OVERRIDES: ThemePermissionsConfig = {
       { action: 'update', label: 'Edit cards', description: 'Can modify card information', roles: ['owner', 'admin', 'member'] },
       { action: 'delete', label: 'Delete cards', description: 'Can delete cards', roles: ['owner', 'admin'], dangerous: true },
     ],
+
+    // ------------------------------------------
+    // PATTERNS
+    // ------------------------------------------
+    patterns: [
+      { action: 'create', label: 'Create Patterns', description: 'Can create reusable patterns', roles: ['owner', 'admin'] },
+      { action: 'read', label: 'View Patterns', description: 'Can view pattern details', roles: ['owner', 'admin', 'member'] },
+      { action: 'list', label: 'List Patterns', description: 'Can see the patterns list', roles: ['owner', 'admin', 'member'] },
+      { action: 'update', label: 'Edit Patterns', description: 'Can modify patterns', roles: ['owner', 'admin'] },
+      { action: 'delete', label: 'Delete Patterns', description: 'Can delete patterns', roles: ['owner', 'admin'], dangerous: true },
+    ],
   },
 
   // ==========================================

package/entities/boards/api/docs.md

@@ -0,0 +1,131 @@
+# Boards API
+
+Manage Trello-style boards for organizing lists and cards.
+
+## Overview
+
+The Boards API allows you to create, read, update, and archive board records. Boards are the top-level containers for organizing lists and cards in a Kanban-style workflow.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Boards
+`GET /api/v1/boards`
+
+Returns a paginated list of boards.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `archived` (boolean, optional): Filter by archived status
+- `search` (string, optional): Search by name, description
+- `sortBy` (string, optional): Field to sort by. Default: position
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "board_abc123",
+      "name": "Product Development",
+      "description": "Main product roadmap and feature tracking",
+      "color": "blue",
+      "archived": false,
+      "position": 1,
+      "createdAt": "2024-01-15T10:30:00Z",
+      "updatedAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 5,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Board
+`GET /api/v1/boards/[id]`
+
+Returns a single board by ID.
+
+### Create Board
+`POST /api/v1/boards`
+
+Create a new board.
+
+**Request Body:**
+```json
+{
+  "name": "New Project",
+  "description": "Board for tracking new project tasks",
+  "color": "purple"
+}
+```
+
+### Update Board
+`PATCH /api/v1/boards/[id]`
+
+Update an existing board. Supports partial updates.
+
+### Archive Board
+`PATCH /api/v1/boards/[id]`
+
+Archive a board (soft delete).
+
+**Request Body:**
+```json
+{
+  "archived": true
+}
+```
+
+### Delete Board
+`DELETE /api/v1/boards/[id]`
+
+Permanently delete a board. This will also delete all associated lists and cards.
+
+## Fields
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| name | text | Yes | - | Board name |
+| description | textarea | No | - | Board description |
+| color | select | No | blue | Background color (blue, green, purple, orange, red, pink, gray) |
+| archived | boolean | No | false | Whether board is archived |
+| position | number | No | 0 | Display order |
+| createdAt | datetime | Auto | - | Creation timestamp |
+| updatedAt | datetime | Auto | - | Last update timestamp |
+
+## Features
+
+- **Searchable**: name, description
+- **Sortable**: name, position, createdAt
+- **Shared Access**: Boards are shared within the team
+- **Soft Delete**: Use archive instead of permanent delete
+
+## Permissions
+
+- **Create/Update**: Owner, Admin
+- **Delete**: Owner only
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Board doesn't exist |
+| 422 | Validation Error - Invalid data |
+
+## Related APIs
+
+- **[Lists](/api/v1/lists)** - Lists within boards
+- **[Cards](/api/v1/cards)** - Cards within lists

package/entities/boards/api/presets.ts

@@ -0,0 +1,113 @@
+/**
+ * API Presets for Boards Entity
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage kanban boards for task organization',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Boards',
+      description: 'Get all boards with pagination',
+      method: 'GET',
+      params: {
+        limit: 20
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-active',
+      title: 'List Active Boards',
+      description: 'Get all non-archived boards',
+      method: 'GET',
+      params: {
+        archived: 'false'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-archived',
+      title: 'List Archived Boards',
+      description: 'Get all archived boards',
+      method: 'GET',
+      params: {
+        archived: 'true'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'search-by-name',
+      title: 'Search by Name',
+      description: 'Search boards by name',
+      method: 'GET',
+      params: {
+        search: '{{name}}'
+      },
+      tags: ['read', 'search']
+    },
+    {
+      id: 'create-board',
+      title: 'Create Board',
+      description: 'Create a new board',
+      method: 'POST',
+      payload: {
+        name: 'New Board',
+        description: 'Board description',
+        color: 'blue'
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'update-board',
+      title: 'Update Board',
+      description: 'Update an existing board',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        name: '{{name}}',
+        description: '{{description}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'archive-board',
+      title: 'Archive Board',
+      description: 'Archive a board',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        archived: true
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'restore-board',
+      title: 'Restore Board',
+      description: 'Restore an archived board',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        archived: false
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'delete-board',
+      title: 'Delete Board',
+      description: 'Permanently delete a board',
+      method: 'DELETE',
+      pathParams: {
+        id: '{{id}}'
+      },
+      tags: ['write', 'delete']
+    }
+  ]
+})

package/entities/cards/api/docs.md

@@ -0,0 +1,162 @@
+# Cards API
+
+Manage task cards within lists (the main work items).
+
+## Overview
+
+The Cards API allows you to create, read, update, and delete card records. Cards are the individual task items that can be dragged between lists within a board.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Cards
+`GET /api/v1/cards`
+
+Returns a paginated list of cards.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `listId` (string, optional): Filter by parent list
+- `boardId` (string, optional): Filter by parent board
+- `priority` (string, optional): Filter by priority (low, medium, high, urgent)
+- `assigneeId` (string, optional): Filter by assigned user
+- `search` (string, optional): Search by title, description
+- `sortBy` (string, optional): Field to sort by. Default: position
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "card_abc123",
+      "title": "Implement user authentication",
+      "description": "Add login and registration functionality",
+      "position": 1,
+      "dueDate": "2024-02-01",
+      "priority": "high",
+      "labels": ["feature", "urgent"],
+      "assigneeId": "user_456",
+      "listId": "list_xyz",
+      "boardId": "board_abc",
+      "createdAt": "2024-01-15T10:30:00Z",
+      "updatedAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 15,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Card
+`GET /api/v1/cards/[id]`
+
+Returns a single card by ID.
+
+### Create Card
+`POST /api/v1/cards`
+
+Create a new card.
+
+**Request Body:**
+```json
+{
+  "title": "New Feature Request",
+  "description": "Detailed description of the feature",
+  "listId": "list_xyz789",
+  "boardId": "board_abc123",
+  "priority": "medium",
+  "dueDate": "2024-02-15",
+  "assigneeId": "user_456"
+}
+```
+
+### Update Card
+`PATCH /api/v1/cards/[id]`
+
+Update an existing card. Supports partial updates.
+
+### Move Card
+`PATCH /api/v1/cards/[id]`
+
+Move a card to a different list (drag & drop).
+
+**Request Body:**
+```json
+{
+  "listId": "list_newlist",
+  "position": 3
+}
+```
+
+### Delete Card
+`DELETE /api/v1/cards/[id]`
+
+Delete a card.
+
+## Fields
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| title | text | Yes | - | Card title |
+| description | textarea | No | - | Detailed description |
+| position | number | No | 0 | Display order within list |
+| dueDate | date | No | - | Due date |
+| priority | select | No | - | Priority: low, medium, high, urgent |
+| labels | multiselect | No | - | Labels: urgent, important, bug, feature, enhancement, documentation |
+| assigneeId | reference | No | - | Assigned user ID |
+| listId | reference | Yes | - | Parent list ID |
+| boardId | reference | Yes | - | Parent board ID |
+| createdAt | datetime | Auto | - | Creation timestamp |
+| updatedAt | datetime | Auto | - | Last update timestamp |
+
+## Labels
+
+Cards can have multiple labels for categorization:
+
+| Label | Description |
+|-------|-------------|
+| urgent | Needs immediate attention |
+| important | High importance |
+| bug | Bug fix needed |
+| feature | New feature |
+| enhancement | Improvement to existing feature |
+| documentation | Documentation work |
+
+## Features
+
+- **Searchable**: title, description
+- **Sortable**: title, position, dueDate, priority, createdAt
+- **Filterable**: priority, labels
+- **Drag & Drop**: Move between lists
+- **Bulk Operations**: Supported
+- **Shared Access**: Cards are shared within the team
+
+## Permissions
+
+- **Create/Update/Move**: Owner, Admin, Member
+- **Delete**: Owner, Admin
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Card, List, or Board doesn't exist |
+| 422 | Validation Error - Invalid data |
+
+## Related APIs
+
+- **[Boards](/api/v1/boards)** - Parent boards
+- **[Lists](/api/v1/lists)** - Parent lists

package/entities/cards/api/presets.ts

@@ -0,0 +1,172 @@
+/**
+ * API Presets for Cards Entity
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage kanban cards (tasks) with priorities and assignments',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Cards',
+      description: 'Get all cards with pagination',
+      method: 'GET',
+      params: {
+        limit: 50
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-by-list',
+      title: 'List by List',
+      description: 'Get all cards for a specific list',
+      method: 'GET',
+      params: {
+        listId: '{{listId}}',
+        sortBy: 'position',
+        sortOrder: 'asc'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-by-board',
+      title: 'List by Board',
+      description: 'Get all cards for a specific board',
+      method: 'GET',
+      params: {
+        boardId: '{{boardId}}'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-my-cards',
+      title: 'List My Cards',
+      description: 'Get cards assigned to current user',
+      method: 'GET',
+      params: {
+        assigneeId: '{{userId}}'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-urgent',
+      title: 'List Urgent Cards',
+      description: 'Get all urgent priority cards',
+      method: 'GET',
+      params: {
+        priority: 'urgent'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-by-priority',
+      title: 'List by Priority',
+      description: 'Get cards filtered by priority level',
+      method: 'GET',
+      params: {
+        priority: '{{priority}}'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'search-by-title',
+      title: 'Search by Title',
+      description: 'Search cards by title',
+      method: 'GET',
+      params: {
+        search: '{{title}}'
+      },
+      tags: ['read', 'search']
+    },
+    {
+      id: 'create-card',
+      title: 'Create Card',
+      description: 'Create a new card in a list',
+      method: 'POST',
+      payload: {
+        title: 'New Card',
+        listId: '{{listId}}',
+        boardId: '{{boardId}}'
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'update-card',
+      title: 'Update Card',
+      description: 'Update card title and description',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        title: '{{title}}',
+        description: '{{description}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'move-card',
+      title: 'Move Card',
+      description: 'Move card to a different list',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        listId: '{{newListId}}',
+        position: '{{position}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'set-priority',
+      title: 'Set Priority',
+      description: 'Update card priority level',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        priority: '{{priority}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'assign-card',
+      title: 'Assign Card',
+      description: 'Assign card to a team member',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        assigneeId: '{{userId}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'set-due-date',
+      title: 'Set Due Date',
+      description: 'Set or update card due date',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        dueDate: '{{dueDate}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'delete-card',
+      title: 'Delete Card',
+      description: 'Delete a card',
+      method: 'DELETE',
+      pathParams: {
+        id: '{{id}}'
+      },
+      tags: ['write', 'delete']
+    }
+  ]
+})