@nextsparkjs/theme-blog 0.1.0-beta.44 → 0.1.0-beta.46

package/api/authors/docs.md

@@ -0,0 +1,135 @@
+# Authors API
+
+Public author profiles and post listings. No authentication required.
+
+## Overview
+
+The Authors API provides read-only access to author profiles and their published posts. This endpoint is designed for public consumption and does not require authentication.
+
+## Authentication
+
+**No authentication required** - This is a public endpoint.
+
+## Endpoints
+
+### List Authors
+`GET /api/v1/theme/blog/authors`
+
+Returns a list of all authors who have published posts.
+
+**Example Request:**
+```bash
+curl https://example.com/api/v1/theme/blog/authors
+```
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "user_abc123",
+      "name": "John Doe",
+      "username": "johndoe",
+      "bio": "Full-stack developer and tech writer",
+      "image": "https://example.com/avatar.jpg",
+      "postCount": 15
+    },
+    {
+      "id": "user_def456",
+      "name": "Jane Smith",
+      "username": "janesmith",
+      "bio": "Product designer and UX enthusiast",
+      "image": "https://example.com/avatar2.jpg",
+      "postCount": 8
+    }
+  ]
+}
+```
+
+### Get Author Profile
+`GET /api/v1/theme/blog/authors/[username]`
+
+Returns an author's profile with their published posts.
+
+**Path Parameters:**
+- `username` (string, required): Author's username
+
+**Example Request:**
+```bash
+curl https://example.com/api/v1/theme/blog/authors/johndoe
+```
+
+**Example Response:**
+```json
+{
+  "author": {
+    "id": "user_abc123",
+    "name": "John Doe",
+    "username": "johndoe",
+    "bio": "Full-stack developer and tech writer",
+    "image": "https://example.com/avatar.jpg"
+  },
+  "posts": [
+    {
+      "id": "post_123",
+      "title": "Getting Started with Next.js",
+      "slug": "getting-started-with-nextjs",
+      "excerpt": "A comprehensive guide...",
+      "featuredImage": "https://example.com/image.jpg",
+      "publishedAt": "2024-01-15T10:30:00Z",
+      "categories": [
+        {
+          "id": "cat_123",
+          "name": "Technology",
+          "slug": "technology"
+        }
+      ]
+    }
+  ],
+  "stats": {
+    "totalPosts": 15
+  }
+}
+```
+
+## Response Fields
+
+### Author Object
+
+| Field | Type | Description |
+|-------|------|-------------|
+| id | string | Author user ID |
+| name | string | Author display name |
+| username | string | Author username (URL-friendly) |
+| bio | string | Author biography |
+| image | string | Author avatar URL |
+| postCount | number | Number of published posts (list endpoint only) |
+
+### Author Profile Response
+
+| Field | Type | Description |
+|-------|------|-------------|
+| author | object | Author profile information |
+| posts | array | Array of published posts |
+| stats.totalPosts | number | Total number of published posts |
+
+## Features
+
+- **No Auth Required**: Accessible without authentication
+- **Rate Limited**: 100 requests per minute per IP
+- **Cached**: Responses cached for 60 seconds
+- **Sorted by Post Count**: Authors with more posts appear first
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 404 | Not Found - Author not found |
+| 429 | Too Many Requests - Rate limit exceeded |
+| 500 | Internal Server Error |
+
+## Related APIs
+
+- **[Public Posts](/api/v1/theme/blog/posts/public)** - Public post feed
+- **[Posts](/api/v1/posts)** - Authenticated CRUD operations

package/api/authors/presets.ts

@@ -0,0 +1,45 @@
+/**
+ * API Presets for Authors Route
+ *
+ * Public author profiles and their published posts
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  endpoint: '/api/v1/theme/blog/authors',
+  summary: 'Public author profiles with published posts',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Authors',
+      description: 'Get all authors with published posts',
+      method: 'GET',
+      params: {
+        limit: 50
+      },
+      tags: ['read', 'list', 'public']
+    },
+    {
+      id: 'get-by-username',
+      title: 'Get Author by Username',
+      description: 'Get author profile with their posts',
+      method: 'GET',
+      pathParams: {
+        username: '{{username}}'
+      },
+      tags: ['read', 'detail', 'public']
+    },
+    {
+      id: 'list-with-post-count',
+      title: 'List with Post Count',
+      description: 'Get authors sorted by number of posts',
+      method: 'GET',
+      params: {
+        sortBy: 'postCount',
+        sortOrder: 'desc'
+      },
+      tags: ['read', 'list', 'public']
+    }
+  ]
+})

package/api/posts/public/docs.md

@@ -0,0 +1,124 @@
+# Public Posts API
+
+Public feed of published blog posts. No authentication required.
+
+## Overview
+
+The Public Posts API provides read-only access to published blog posts. This endpoint is designed for public consumption by blog visitors and does not require authentication.
+
+## Authentication
+
+**No authentication required** - This is a public endpoint.
+
+## Endpoints
+
+### List Published Posts
+`GET /api/v1/theme/blog/posts/public`
+
+Returns a paginated list of published posts.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20, Max: 100
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `category` (string, optional): Filter by category slug
+
+**Example Request:**
+```bash
+curl https://example.com/api/v1/theme/blog/posts/public?limit=10&category=technology
+```
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "post_abc123",
+      "title": "Getting Started with Next.js",
+      "slug": "getting-started-with-nextjs",
+      "excerpt": "A comprehensive guide to building modern web apps",
+      "featuredImage": "https://example.com/image.jpg",
+      "featured": true,
+      "publishedAt": "2024-01-15T10:30:00Z",
+      "author": {
+        "id": "user_123",
+        "name": "John Doe",
+        "username": "johndoe",
+        "image": "https://example.com/avatar.jpg"
+      },
+      "categories": [
+        {
+          "id": "cat_123",
+          "name": "Technology",
+          "slug": "technology"
+        }
+      ]
+    }
+  ],
+  "pagination": {
+    "total": 25,
+    "limit": 10,
+    "offset": 0,
+    "hasMore": true
+  }
+}
+```
+
+## Response Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| id | string | Post unique identifier |
+| title | string | Post title |
+| slug | string | URL-friendly slug |
+| excerpt | string | Brief description |
+| featuredImage | string | Featured image URL |
+| featured | boolean | Whether post is featured |
+| publishedAt | datetime | Publication timestamp |
+| author | object | Author information |
+| author.id | string | Author user ID |
+| author.name | string | Author display name |
+| author.username | string | Author username |
+| author.image | string | Author avatar URL |
+| categories | array | Associated categories |
+
+## Features
+
+- **No Auth Required**: Accessible without authentication
+- **Rate Limited**: 100 requests per minute per IP
+- **Cached**: Responses cached for 60 seconds
+- **Category Filter**: Filter posts by category slug
+
+## Pagination
+
+The API uses offset-based pagination:
+
+```json
+{
+  "pagination": {
+    "total": 100,
+    "limit": 20,
+    "offset": 0,
+    "hasMore": true
+  }
+}
+```
+
+To get the next page:
+```
+GET /api/v1/theme/blog/posts/public?offset=20&limit=20
+```
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid query parameters |
+| 404 | Not Found - Category not found |
+| 429 | Too Many Requests - Rate limit exceeded |
+| 500 | Internal Server Error |
+
+## Related APIs
+
+- **[Posts](/api/v1/posts)** - Authenticated CRUD operations
+- **[Authors](/api/v1/theme/blog/authors)** - Author profiles
+- **[Categories](/api/v1/categories)** - Category management

package/api/posts/public/presets.ts

@@ -0,0 +1,65 @@
+/**
+ * API Presets for Public Posts
+ *
+ * Public feed of published blog posts (no authentication required)
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  endpoint: '/api/v1/theme/blog/posts/public',
+  summary: 'Public feed of published blog posts',
+  presets: [
+    {
+      id: 'list-recent',
+      title: 'List Recent Posts',
+      description: 'Get recent published posts',
+      method: 'GET',
+      params: {
+        limit: 20
+      },
+      tags: ['read', 'list', 'public']
+    },
+    {
+      id: 'list-with-limit',
+      title: 'List with Custom Limit',
+      description: 'Get posts with specific limit',
+      method: 'GET',
+      params: {
+        limit: '{{limit}}'
+      },
+      tags: ['read', 'list', 'public']
+    },
+    {
+      id: 'list-by-category',
+      title: 'List by Category',
+      description: 'Get posts filtered by category slug',
+      method: 'GET',
+      params: {
+        category: '{{category}}'
+      },
+      tags: ['read', 'filter', 'public']
+    },
+    {
+      id: 'list-paginated',
+      title: 'List Paginated',
+      description: 'Get paginated posts',
+      method: 'GET',
+      params: {
+        limit: '{{limit}}',
+        offset: '{{offset}}'
+      },
+      tags: ['read', 'list', 'public']
+    },
+    {
+      id: 'list-featured',
+      title: 'List Featured Posts',
+      description: 'Get featured published posts',
+      method: 'GET',
+      params: {
+        featured: 'true'
+      },
+      tags: ['read', 'filter', 'public']
+    }
+  ]
+})

package/entities/categories/api/docs.md

@@ -0,0 +1,119 @@
+# Categories API
+
+Manage blog categories for organizing and filtering posts.
+
+## Overview
+
+The Categories API allows you to create, read, update, and delete category records. Categories provide a hierarchical organization system for blog posts through a many-to-many relationship.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Categories
+`GET /api/v1/categories`
+
+Returns a paginated list of categories.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `search` (string, optional): Search by name, description
+- `sortBy` (string, optional): Field to sort by
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "category_abc123",
+      "name": "Technology",
+      "slug": "technology",
+      "description": "Posts about tech and software development",
+      "createdAt": "2024-01-15T10:30:00Z",
+      "updatedAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 8,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Category
+`GET /api/v1/categories/[id]`
+
+Returns a single category by ID.
+
+### Create Category
+`POST /api/v1/categories`
+
+Create a new category.
+
+**Request Body:**
+```json
+{
+  "name": "Technology",
+  "slug": "technology",
+  "description": "Posts about tech and software development"
+}
+```
+
+### Update Category
+`PATCH /api/v1/categories/[id]`
+
+Update an existing category. Supports partial updates.
+
+### Delete Category
+`DELETE /api/v1/categories/[id]`
+
+Delete a category record. This will remove the category from all associated posts.
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| name | text | Yes | Category name |
+| slug | text | Yes | URL-friendly slug (auto-generated if not provided) |
+| description | textarea | No | Category description |
+| createdAt | datetime | Auto | Creation timestamp |
+| updatedAt | datetime | Auto | Last update timestamp |
+
+## Post-Category Relationship
+
+Categories are linked to posts through a `post_categories` pivot table. When filtering posts by category:
+
+1. Use the [Public Posts API](/api/v1/theme/blog/posts/public) with `category` query parameter
+2. Query the pivot table directly for advanced filtering
+
+## Features
+
+- **Searchable**: name, description
+- **Sortable**: All fields
+- **Metadata**: Supported
+
+## Permissions
+
+- **Create/Update/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 - Category doesn't exist |
+| 422 | Validation Error - Invalid data |
+
+## Related APIs
+
+- **[Posts](/api/v1/posts)** - Blog posts
+- **[Public Posts](/api/v1/theme/blog/posts/public)** - Filter by category

package/entities/categories/api/presets.ts

@@ -0,0 +1,67 @@
+/**
+ * API Presets for Categories Entity
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage blog categories for organizing posts',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Categories',
+      description: 'Get all categories with pagination',
+      method: 'GET',
+      params: {
+        limit: 50
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'search-by-name',
+      title: 'Search by Name',
+      description: 'Search categories by name',
+      method: 'GET',
+      params: {
+        search: '{{name}}'
+      },
+      tags: ['read', 'search']
+    },
+    {
+      id: 'create-category',
+      title: 'Create Category',
+      description: 'Create a new category',
+      method: 'POST',
+      payload: {
+        name: 'New Category',
+        slug: 'new-category',
+        description: 'Category description'
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'update-category',
+      title: 'Update Category',
+      description: 'Update an existing category',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        name: '{{name}}',
+        description: '{{description}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'delete-category',
+      title: 'Delete Category',
+      description: 'Delete a category record',
+      method: 'DELETE',
+      pathParams: {
+        id: '{{id}}'
+      },
+      tags: ['write', 'delete']
+    }
+  ]
+})

package/entities/posts/api/docs.md

@@ -0,0 +1,174 @@
+# Posts API
+
+Manage blog posts with content builder, featured images, categories, and publication workflow.
+
+## Overview
+
+The Posts API allows you to create, read, update, and delete blog posts. Posts support a flexible content builder system, category organization, and a draft-to-published workflow.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+**Note:** For public access to published posts, use the [Public Posts API](/api/v1/theme/blog/posts/public) instead.
+
+## 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)
+- `featured` (boolean, optional): Filter by featured flag
+- `search` (string, optional): Search by title, excerpt, content
+- `sortBy` (string, optional): Field to sort by
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "post_abc123",
+      "title": "Getting Started with Next.js",
+      "slug": "getting-started-with-nextjs",
+      "excerpt": "A comprehensive guide to building modern web apps",
+      "content": "[{\"type\":\"text\",\"content\":\"...\"}]",
+      "featuredImage": "https://example.com/image.jpg",
+      "featured": true,
+      "status": "published",
+      "publishedAt": "2024-01-15T10:30:00Z",
+      "createdAt": "2024-01-10T08:00:00Z",
+      "updatedAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 25,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Post
+`GET /api/v1/posts/[id]`
+
+Returns a single post by ID.
+
+### Create Post
+`POST /api/v1/posts`
+
+Create a new blog post.
+
+**Request Body:**
+```json
+{
+  "title": "My New Post",
+  "slug": "my-new-post",
+  "excerpt": "A brief description of the post",
+  "content": "[{\"type\":\"text\",\"content\":\"Post content here\"}]",
+  "featuredImage": "https://example.com/image.jpg",
+  "featured": false,
+  "status": "draft"
+}
+```
+
+### Update Post
+`PATCH /api/v1/posts/[id]`
+
+Update an existing post. Supports partial updates.
+
+### Publish Post
+`PATCH /api/v1/posts/[id]`
+
+Publish a draft post by setting status and publishedAt.
+
+**Request Body:**
+```json
+{
+  "status": "published",
+  "publishedAt": "2024-01-15T10:30:00Z"
+}
+```
+
+### Delete Post
+`DELETE /api/v1/posts/[id]`
+
+Delete a post record.
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| title | text | Yes | Post title |
+| slug | text | Yes | URL-friendly slug (auto-generated if not provided) |
+| excerpt | text | No | Brief description for previews |
+| content | json | No | Page builder content blocks |
+| featuredImage | url | No | Featured image URL |
+| featured | boolean | No | Whether post is featured. Default: false |
+| status | select | No | Status: draft, published. Default: draft |
+| publishedAt | datetime | No | Publication date/time |
+| createdAt | datetime | Auto | Creation timestamp |
+| updatedAt | datetime | Auto | Last update timestamp |
+
+## Content Builder
+
+Posts use a flexible content builder system. The `content` field stores an array of content blocks in JSON format:
+
+```json
+[
+  {
+    "type": "text",
+    "content": "Paragraph content here..."
+  },
+  {
+    "type": "heading",
+    "level": 2,
+    "content": "Section Title"
+  },
+  {
+    "type": "image",
+    "src": "https://example.com/image.jpg",
+    "alt": "Image description"
+  }
+]
+```
+
+## Categories
+
+Posts can be organized into categories using a many-to-many relationship. Categories are managed via the `/api/v1/categories` endpoint and linked to posts through a pivot table.
+
+To filter posts by category, use the Public Posts API with the `category` query parameter.
+
+## Features
+
+- **Searchable**: title, excerpt, content
+- **Sortable**: Most fields
+- **Public Access**: Published posts available via public API
+- **Metadata**: Supported
+
+## Permissions
+
+- **Create/Update/Delete**: Owner only (single-user blog mode)
+
+## 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 |
+
+## Related APIs
+
+- **[Categories](/api/v1/categories)** - Post categorization
+- **[Public Posts](/api/v1/theme/blog/posts/public)** - Public feed (no auth required)
+- **[Authors](/api/v1/theme/blog/authors)** - Author profiles

package/entities/posts/api/presets.ts

@@ -0,0 +1,137 @@
+/**
+ * API Presets for Posts Entity
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage blog posts with content builder and publication workflow',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Posts',
+      description: 'Get all posts with pagination',
+      method: 'GET',
+      params: {
+        limit: 20
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-published',
+      title: 'List Published Posts',
+      description: 'Get all published posts',
+      method: 'GET',
+      params: {
+        status: 'published'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-drafts',
+      title: 'List Draft Posts',
+      description: 'Get all draft posts',
+      method: 'GET',
+      params: {
+        status: 'draft'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-featured',
+      title: 'List Featured Posts',
+      description: 'Get all featured posts',
+      method: 'GET',
+      params: {
+        featured: 'true'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'search-by-title',
+      title: 'Search by Title',
+      description: 'Search posts by title',
+      method: 'GET',
+      params: {
+        search: '{{title}}'
+      },
+      tags: ['read', 'search']
+    },
+    {
+      id: 'create-draft',
+      title: 'Create Draft Post',
+      description: 'Create a new draft post',
+      method: 'POST',
+      payload: {
+        title: 'New Post Title',
+        slug: 'new-post-title',
+        excerpt: 'Brief description of the post',
+        status: 'draft'
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'publish-post',
+      title: 'Publish Post',
+      description: 'Publish a draft post',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        status: 'published',
+        publishedAt: '{{publishedAt}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'unpublish-post',
+      title: 'Unpublish Post',
+      description: 'Revert a post to draft',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        status: 'draft'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'set-featured',
+      title: 'Set as Featured',
+      description: 'Mark a post as featured',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        featured: true
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'update-content',
+      title: 'Update Content',
+      description: 'Update post content blocks',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        content: '{{content}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'delete-post',
+      title: 'Delete Post',
+      description: 'Delete a post record',
+      method: 'DELETE',
+      pathParams: {
+        id: '{{id}}'
+      },
+      tags: ['write', 'delete']
+    }
+  ]
+})

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
@@ -174,5 +174,5 @@ export const entitySelectors = helpers.entitySelectors
 export type ThemeSelectorsType = typeof THEME_SELECTORS
 export type BlockSelectorsType = typeof BLOCK_SELECTORS
 export type EntitySelectorsType = typeof ENTITY_SELECTORS
-export type { Replacements } from '@nextsparkjs/testing/selectors'
+export type { Replacements } from '@nextsparkjs/core/selectors'
 export { CORE_SELECTORS }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/theme-blog",
-  "version": "0.1.0-beta.44",
+  "version": "0.1.0-beta.46",
   "private": false,
   "type": "module",
   "main": "./config/theme.config.ts",
@@ -13,8 +13,8 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.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.46",
+    "@nextsparkjs/testing": "0.1.0-beta.46"
   },
   "nextspark": {
     "type": "theme",

package/styles/globals.css

@@ -3,8 +3,23 @@
  *
  * Warm amber/orange palette with editorial typography.
  * Fonts: Oxanium (sans), Merriweather (serif), Fira Code (mono)
+ *
+ * Ú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}";
+
+/* =============================================
+   BLOG THEME - LIGHT MODE
+   ============================================= */
 :root {
     --background: oklch(0.9885 0.0057 84.5659);
     --foreground: oklch(0.3660 0.0251 49.6085);
@@ -152,6 +167,18 @@
     --shadow-2xl: var(--shadow-2xl);
 }
 
+/* =============================================
+   BASE STYLES
+   ============================================= */
+* {
+  border-color: var(--border);
+}
+
+body {
+  background-color: var(--background);
+  color: var(--foreground);
+}
+
 /* ============================================================================
    TYPOGRAPHY
    ============================================================================ */