@nextsparkjs/theme-productivity 0.1.0-beta.1

package/config/theme.config.ts

@@ -0,0 +1,106 @@
+/**
+ * Productivity Theme Configuration
+ *
+ * A Trello-style task management app with boards, lists, and cards.
+ * Collaborative mode: owner can invite team members.
+ */
+
+import type { ThemeConfig } from '@nextsparkjs/core/types/theme'
+
+export const productivityThemeConfig: ThemeConfig = {
+  name: 'productivity',
+  displayName: 'Productivity',
+  version: '1.0.0',
+  description: 'A collaborative task management app with boards, lists, and cards',
+  author: 'NextSpark Team',
+
+  plugins: [],
+
+  styles: {
+    globals: 'globals.css',
+    components: 'components.css',
+    variables: {
+      '--spacing-xs': '0.125rem',
+      '--spacing-sm': '0.25rem',
+      '--spacing-md': '0.5rem',
+      '--spacing-lg': '1rem',
+      '--spacing-xl': '1.5rem',
+      '--spacing-2xl': '2rem'
+    }
+  },
+
+  // Modern, clean productivity aesthetic
+  config: {
+    colors: {
+      background: 'oklch(0.98 0.005 240)',
+      foreground: 'oklch(0.2 0.02 260)',
+      card: 'oklch(1.0 0 0)',
+      'card-foreground': 'oklch(0.2 0.02 260)',
+      popover: 'oklch(1.0 0 0)',
+      'popover-foreground': 'oklch(0.2 0.02 260)',
+      // Blue primary for productivity focus
+      primary: 'oklch(0.55 0.2 250)',
+      'primary-foreground': 'oklch(1.0 0 0)',
+      secondary: 'oklch(0.95 0.01 240)',
+      'secondary-foreground': 'oklch(0.3 0.02 260)',
+      muted: 'oklch(0.96 0.005 240)',
+      'muted-foreground': 'oklch(0.45 0.015 260)',
+      accent: 'oklch(0.92 0.03 200)',
+      'accent-foreground': 'oklch(0.2 0.02 260)',
+      destructive: 'oklch(0.55 0.22 25)',
+      'destructive-foreground': 'oklch(1.0 0 0)',
+      border: 'oklch(0.9 0.01 240)',
+      input: 'oklch(0.9 0.01 240)',
+      ring: 'oklch(0.55 0.2 250)',
+
+      // Chart colors for analytics
+      'chart-1': 'oklch(0.55 0.2 250)',
+      'chart-2': 'oklch(0.6 0.18 150)',
+      'chart-3': 'oklch(0.65 0.15 50)',
+      'chart-4': 'oklch(0.5 0.2 300)',
+      'chart-5': 'oklch(0.55 0.15 30)',
+
+      // Sidebar - slightly tinted
+      sidebar: 'oklch(0.97 0.01 250)',
+      'sidebar-foreground': 'oklch(0.2 0.02 260)',
+      'sidebar-primary': 'oklch(0.55 0.2 250)',
+      'sidebar-primary-foreground': 'oklch(1.0 0 0)',
+      'sidebar-accent': 'oklch(0.92 0.03 200)',
+      'sidebar-accent-foreground': 'oklch(0.2 0.02 260)',
+      'sidebar-border': 'oklch(0.9 0.01 240)',
+      'sidebar-ring': 'oklch(0.55 0.2 250)'
+    },
+
+    fonts: {
+      sans: 'Inter, system-ui, sans-serif',
+      serif: 'Georgia, serif',
+      mono: 'JetBrains Mono, monospace'
+    },
+
+    spacing: {
+      radius: '0.75rem',
+      'radius-sm': '0.5rem',
+      'radius-md': '0.625rem',
+      'radius-lg': '0.75rem',
+      'radius-xl': '1rem'
+    },
+
+    breakpoints: {
+      'shadow-2xs': '0 1px 2px 0 rgb(0 0 0 / 0.03)',
+      'shadow-xs': '0 1px 2px 0 rgb(0 0 0 / 0.05)',
+      'shadow-sm': '0 1px 3px 0 rgb(0 0 0 / 0.1)',
+      shadow: '0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)',
+      'shadow-md': '0 4px 6px -1px rgb(0 0 0 / 0.1)',
+      'shadow-lg': '0 10px 15px -3px rgb(0 0 0 / 0.1)',
+      'shadow-xl': '0 20px 25px -5px rgb(0 0 0 / 0.1)',
+      'shadow-2xl': '0 25px 50px -12px rgb(0 0 0 / 0.25)'
+    }
+  },
+
+  components: {
+    overrides: {},
+    custom: {}
+  }
+}
+
+export default productivityThemeConfig

package/entities/boards/boards.config.ts

@@ -0,0 +1,61 @@
+/**
+ * Boards Entity Configuration
+ * 
+ * Trello-style boards for organizing lists and cards.
+ */
+
+import { LayoutDashboard } from 'lucide-react'
+import type { EntityConfig } from '@nextsparkjs/core/lib/entities/types'
+import { boardFields } from './boards.fields'
+
+export const boardEntityConfig: EntityConfig = {
+  // ==========================================
+  // 1. BASIC IDENTIFICATION
+  // ==========================================
+  slug: 'boards',
+  enabled: true,
+  names: {
+    singular: 'board',
+    plural: 'Boards'
+  },
+  icon: LayoutDashboard,
+  
+  // ==========================================
+  // 2. ACCESS AND SCOPE CONFIGURATION
+  // ==========================================
+  access: {
+    public: false,          // Private boards
+    api: true,
+    metadata: false,
+    shared: true            // Shared within team
+  },
+  
+  // ==========================================
+  // 3. UI/UX FEATURES
+  // ==========================================
+  ui: {
+    dashboard: {
+      showInMenu: true,
+      showInTopbar: true
+    },
+    public: {
+      hasArchivePage: false,
+      hasSinglePage: false
+    },
+    features: {
+      searchable: true,
+      sortable: true,
+      filterable: true,
+      bulkOperations: false,
+      importExport: false
+    }
+  },
+  
+  // ==========================================
+  // FIELDS
+  // ==========================================
+  fields: boardFields,
+}
+
+export default boardEntityConfig
+

package/entities/boards/boards.fields.ts

@@ -0,0 +1,154 @@
+/**
+ * Boards Entity Fields Configuration
+ */
+
+import type { EntityField } from '@nextsparkjs/core/lib/entities/types'
+
+export const boardFields: EntityField[] = [
+  {
+    name: 'name',
+    type: 'text',
+    required: true,
+    display: {
+      label: 'Name',
+      description: 'Board name',
+      placeholder: 'Enter board name...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 1,
+      columnWidth: 12,
+    },
+    api: {
+      readOnly: false,
+      searchable: true,
+      sortable: true,
+    },
+  },
+  {
+    name: 'description',
+    type: 'textarea',
+    required: false,
+    display: {
+      label: 'Description',
+      description: 'Optional board description',
+      placeholder: 'Describe what this board is for...',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 2,
+      columnWidth: 12,
+    },
+    api: {
+      readOnly: false,
+      searchable: true,
+      sortable: false,
+    },
+  },
+  {
+    name: 'color',
+    type: 'select',
+    required: false,
+    defaultValue: 'blue',
+    options: [
+      { value: 'blue', label: 'Blue' },
+      { value: 'green', label: 'Green' },
+      { value: 'purple', label: 'Purple' },
+      { value: 'orange', label: 'Orange' },
+      { value: 'red', label: 'Red' },
+      { value: 'pink', label: 'Pink' },
+      { value: 'gray', label: 'Gray' },
+    ],
+    display: {
+      label: 'Color',
+      description: 'Board background color',
+      placeholder: 'Select color...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 3,
+      columnWidth: 6,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: false,
+    },
+  },
+  {
+    name: 'archived',
+    type: 'boolean',
+    required: false,
+    defaultValue: false,
+    display: {
+      label: 'Archived',
+      description: 'Archive this board',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 4,
+      columnWidth: 6,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: true,
+    },
+  },
+  {
+    name: 'position',
+    type: 'number',
+    required: false,
+    defaultValue: 0,
+    display: {
+      label: 'Position',
+      description: 'Display order',
+      showInList: false,
+      showInDetail: false,
+      showInForm: false,
+      order: 5,
+    },
+    api: {
+      readOnly: false,
+      searchable: false,
+      sortable: true,
+    },
+  },
+  {
+    name: 'createdAt',
+    type: 'datetime',
+    required: false,
+    display: {
+      label: 'Created At',
+      description: 'When the board was created',
+      showInList: true,
+      showInDetail: true,
+      showInForm: false,
+      order: 98,
+    },
+    api: {
+      readOnly: true,
+      searchable: false,
+      sortable: true,
+    },
+  },
+  {
+    name: 'updatedAt',
+    type: 'datetime',
+    required: false,
+    display: {
+      label: 'Updated At',
+      description: 'When the board was last modified',
+      showInList: false,
+      showInDetail: true,
+      showInForm: false,
+      order: 99,
+    },
+    api: {
+      readOnly: true,
+      searchable: false,
+      sortable: true,
+    },
+  },
+]
+

package/entities/boards/boards.service.ts

@@ -0,0 +1,256 @@
+/**
+ * Boards Service
+ * Provides data access methods for boards entity.
+ */
+import { queryOneWithRLS, queryWithRLS, mutateWithRLS } from '@nextsparkjs/core/lib/db'
+
+export interface Board {
+  id: string
+  name: string
+  description: string | null
+  color: string | null
+  isArchived: boolean
+  position: number
+  userId: string
+  teamId: string
+  createdAt: Date
+  updatedAt: Date
+}
+
+export interface BoardListOptions {
+  limit?: number
+  offset?: number
+  orderBy?: string
+  orderDir?: 'asc' | 'desc'
+  teamId?: string
+  isArchived?: boolean
+}
+
+export interface BoardListResult {
+  boards: Board[]
+  total: number
+}
+
+export interface BoardCreateData {
+  name: string
+  description?: string | null
+  color?: string | null
+  isArchived?: boolean
+  position?: number
+  teamId: string
+}
+
+export interface BoardUpdateData {
+  name?: string
+  description?: string | null
+  color?: string | null
+  isArchived?: boolean
+  position?: number
+}
+
+interface DbBoard {
+  id: string
+  name: string
+  description: string | null
+  color: string | null
+  is_archived: boolean
+  position: number
+  user_id: string
+  team_id: string
+  created_at: string
+  updated_at: string
+}
+
+function mapDbBoard(dbBoard: DbBoard): Board {
+  return {
+    id: dbBoard.id,
+    name: dbBoard.name,
+    description: dbBoard.description,
+    color: dbBoard.color,
+    isArchived: dbBoard.is_archived,
+    position: dbBoard.position,
+    userId: dbBoard.user_id,
+    teamId: dbBoard.team_id,
+    createdAt: new Date(dbBoard.created_at),
+    updatedAt: new Date(dbBoard.updated_at),
+  }
+}
+
+export class BoardsService {
+  /**
+   * Get a board by ID with RLS
+   */
+  static async getById(id: string, userId: string): Promise<Board | null> {
+    const result = await queryOneWithRLS<DbBoard>(
+      userId,
+      `SELECT * FROM boards WHERE id = $1`,
+      [id]
+    )
+
+    return result ? mapDbBoard(result) : null
+  }
+
+  /**
+   * List boards with RLS and filtering
+   */
+  static async list(userId: string, options: BoardListOptions = {}): Promise<BoardListResult> {
+    const {
+      limit = 50,
+      offset = 0,
+      orderBy = 'position',
+      orderDir = 'asc',
+      teamId,
+      isArchived,
+    } = options
+
+    const conditions: string[] = []
+    const params: any[] = []
+    let paramIndex = 1
+
+    if (teamId) {
+      conditions.push(`team_id = $${paramIndex++}`)
+      params.push(teamId)
+    }
+
+    if (isArchived !== undefined) {
+      conditions.push(`is_archived = $${paramIndex++}`)
+      params.push(isArchived)
+    }
+
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : ''
+
+    // Get total count
+    const countResult = await queryOneWithRLS<{ count: string }>(
+      userId,
+      `SELECT COUNT(*) as count FROM boards ${whereClause}`,
+      params
+    )
+    const total = parseInt(countResult?.count || '0', 10)
+
+    // Get boards
+    const validOrderBy = ['position', 'name', 'created_at', 'updated_at'].includes(orderBy)
+      ? orderBy
+      : 'position'
+    const validOrderDir = orderDir === 'desc' ? 'DESC' : 'ASC'
+
+    params.push(limit, offset)
+    const boards = await queryWithRLS<DbBoard>(
+      userId,
+      `SELECT * FROM boards ${whereClause} ORDER BY ${validOrderBy} ${validOrderDir} LIMIT $${paramIndex++} OFFSET $${paramIndex++}`,
+      params
+    )
+
+    return {
+      boards: boards.map(mapDbBoard),
+      total,
+    }
+  }
+
+  /**
+   * Get boards ordered by position
+   */
+  static async getByPosition(userId: string, teamId?: string): Promise<Board[]> {
+    const result = await this.list(userId, {
+      orderBy: 'position',
+      orderDir: 'asc',
+      teamId,
+      isArchived: false,
+    })
+
+    return result.boards
+  }
+
+  /**
+   * Create a new board with RLS
+   */
+  static async create(userId: string, data: BoardCreateData): Promise<Board> {
+    const {
+      name,
+      description = null,
+      color = null,
+      isArchived = false,
+      position = 0,
+      teamId,
+    } = data
+
+    const result = await mutateWithRLS<DbBoard>(
+      userId,
+      `INSERT INTO boards (name, description, color, is_archived, position, user_id, team_id)
+       VALUES ($1, $2, $3, $4, $5, $6, $7)
+       RETURNING *`,
+      [name, description, color, isArchived, position, userId, teamId]
+    )
+
+    if (!result) {
+      throw new Error('Failed to create board')
+    }
+
+    return mapDbBoard(result)
+  }
+
+  /**
+   * Update a board with RLS
+   */
+  static async update(userId: string, id: string, data: BoardUpdateData): Promise<Board> {
+    const updates: string[] = []
+    const params: any[] = []
+    let paramIndex = 1
+
+    if (data.name !== undefined) {
+      updates.push(`name = $${paramIndex++}`)
+      params.push(data.name)
+    }
+
+    if (data.description !== undefined) {
+      updates.push(`description = $${paramIndex++}`)
+      params.push(data.description)
+    }
+
+    if (data.color !== undefined) {
+      updates.push(`color = $${paramIndex++}`)
+      params.push(data.color)
+    }
+
+    if (data.isArchived !== undefined) {
+      updates.push(`is_archived = $${paramIndex++}`)
+      params.push(data.isArchived)
+    }
+
+    if (data.position !== undefined) {
+      updates.push(`position = $${paramIndex++}`)
+      params.push(data.position)
+    }
+
+    if (updates.length === 0) {
+      throw new Error('No fields to update')
+    }
+
+    updates.push(`updated_at = NOW()`)
+    params.push(id)
+
+    const result = await mutateWithRLS<DbBoard>(
+      userId,
+      `UPDATE boards SET ${updates.join(', ')} WHERE id = $${paramIndex} RETURNING *`,
+      params
+    )
+
+    if (!result) {
+      throw new Error('Board not found or access denied')
+    }
+
+    return mapDbBoard(result)
+  }
+
+  /**
+   * Delete a board with RLS
+   */
+  static async delete(userId: string, id: string): Promise<boolean> {
+    const result = await mutateWithRLS<DbBoard>(
+      userId,
+      `DELETE FROM boards WHERE id = $1 RETURNING *`,
+      [id]
+    )
+
+    return result !== null
+  }
+}

package/entities/boards/boards.types.ts

@@ -0,0 +1,57 @@
+/**
+ * Board Service Types
+ *
+ * Type definitions for the BoardsService.
+ * Boards represent workspaces that contain lists and cards for project organization.
+ *
+ * @module BoardsTypes
+ */
+
+// Main entity interface
+export interface Board {
+  id: string
+  name: string
+  description: string | null
+  color: string | null
+  isArchived: boolean
+  position: number
+  teamId: string
+  userId: string
+  createdAt: string
+  updatedAt: string
+}
+
+// List options
+export interface BoardListOptions {
+  limit?: number
+  offset?: number
+  teamId?: string
+  isArchived?: boolean
+  orderBy?: 'name' | 'position' | 'createdAt'
+  orderDir?: 'asc' | 'desc'
+}
+
+// List result
+export interface BoardListResult {
+  boards: Board[]
+  total: number
+}
+
+// Create data (required fields + teamId + optional fields)
+export interface BoardCreateData {
+  name: string
+  teamId: string
+  description?: string
+  color?: string
+  isArchived?: boolean
+  position?: number
+}
+
+// Update data (all fields optional)
+export interface BoardUpdateData {
+  name?: string
+  description?: string | null
+  color?: string | null
+  isArchived?: boolean
+  position?: number
+}

package/entities/boards/messages/en.json

@@ -0,0 +1,80 @@
+{
+  "title": "Boards",
+  "singular": "Board",
+  "plural": "Boards",
+  "description": "Organize your work into boards",
+
+  "fields": {
+    "name": {
+      "label": "Name",
+      "placeholder": "Enter board name...",
+      "description": "Board name"
+    },
+    "description": {
+      "label": "Description",
+      "placeholder": "Describe what this board is for...",
+      "description": "Optional board description"
+    },
+    "color": {
+      "label": "Color",
+      "placeholder": "Select color...",
+      "description": "Board background color",
+      "options": {
+        "blue": "Blue",
+        "green": "Green",
+        "purple": "Purple",
+        "orange": "Orange",
+        "red": "Red",
+        "pink": "Pink",
+        "gray": "Gray"
+      }
+    },
+    "archived": {
+      "label": "Archived",
+      "description": "Archive this board"
+    },
+    "position": {
+      "label": "Position",
+      "description": "Display order"
+    },
+    "createdAt": {
+      "label": "Created At",
+      "description": "When the board was created"
+    },
+    "updatedAt": {
+      "label": "Updated At",
+      "description": "When the board was last modified"
+    }
+  },
+
+  "actions": {
+    "create": "New Board",
+    "edit": "Edit Board",
+    "delete": "Delete Board",
+    "archive": "Archive Board",
+    "unarchive": "Unarchive Board",
+    "duplicate": "Duplicate Board"
+  },
+
+  "messages": {
+    "created": "Board created successfully",
+    "updated": "Board updated successfully",
+    "deleted": "Board deleted successfully",
+    "archived": "Board archived",
+    "unarchived": "Board unarchived",
+    "confirmDelete": "Are you sure you want to delete this board? All lists and cards will be permanently removed."
+  },
+
+  "empty": {
+    "title": "No boards yet",
+    "description": "Create your first board to start organizing your work.",
+    "action": "Create your first board"
+  },
+
+  "filters": {
+    "all": "All Boards",
+    "active": "Active",
+    "archived": "Archived"
+  }
+}
+