@nextsparkjs/core 0.1.0-beta.75 → 0.1.0-beta.76

package/dist/types/meta.types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Meta data system types - Entity Agnostic
+ */
+export type CoreEntityType = 'user';
+export type EntityType = string;
+export type MetaDataType = 'string' | 'number' | 'boolean' | 'json' | 'array';
+export interface EntityConfig {
+    entityType: EntityType;
+    tableName: string;
+    metaTableName: string;
+    idColumn: string;
+    apiPath: string;
+}
+export declare const CORE_ENTITY_CONFIGS: Record<CoreEntityType, EntityConfig>;
+export declare function getEntityMetaConfig(entityType: string): EntityConfig | undefined;
+export declare function isCoreEntity(entityType: string): entityType is CoreEntityType;
+export interface EntityMeta {
+    id: string;
+    metaKey: string;
+    metaValue: unknown;
+    dataType: MetaDataType;
+    isPublic: boolean;
+    isSearchable: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateMetaPayload {
+    metaKey: string;
+    metaValue: unknown;
+    dataType?: MetaDataType;
+    isPublic?: boolean;
+    isSearchable?: boolean;
+}
+export interface UpdateMetaPayload extends Partial<CreateMetaPayload> {
+    id?: string;
+}
+export interface BulkMetaPayload {
+    meta: Record<string, unknown>;
+}
+export type EntityResponse<T> = T & {
+    meta?: Record<string, unknown>;
+};
+export interface EntityWithMeta<T = Record<string, unknown>> {
+    entity: T;
+    meta: Record<string, unknown>;
+}
+export type MetaValue<T = unknown> = T | undefined;
+export type KnownUserMetaKeys = 'securitySettings' | 'notificationPreferences' | 'uiPreferences' | 'privacySettings';
+export declare function getMetaValue<T = unknown>(meta: Record<string, unknown>, key: string, defaultValue?: T): MetaValue<T>;
+export type UserResponse = EntityResponse<Record<string, unknown>>;
+export type DynamicEntityResponse<T = Record<string, unknown>> = EntityResponse<T>;
+//# sourceMappingURL=meta.types.d.ts.map

package/dist/types/meta.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.types.d.ts","sourceRoot":"","sources":["../../src/types/meta.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAGpC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAChC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAG9E,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,cAAc,EAAE,YAAY,CAQpE,CAAC;AAGF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CA0ChF;AAGD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,IAAI,cAAc,CAE7E;AAGD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,iBAAiB,CAAC;IACnE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAGD,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAGvE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,MAAM,EAAE,CAAC,CAAC;IACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAGD,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,SAAS,CAAC;AAGnD,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,yBAAyB,GACzB,eAAe,GACf,iBAAiB,CAAC;AAKtB,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,CAAC,GACf,SAAS,CAAC,CAAC,CAAC,CAEd;AAGD,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAGnE,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/pattern-reference.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Pattern Reference Types
+ *
+ * These types define the structure of pattern references stored in page blocks.
+ * Pattern references are resolved at render time to support automatic propagation
+ * of changes when patterns are edited.
+ *
+ * NOTE: The full Pattern entity (config, service, fields) is in core/entities/patterns.
+ * This file provides minimal types for core components that only need reference handling.
+ * For full Pattern types and service, import from '@nextsparkjs/core/entities/patterns'.
+ */
+import type { BlockInstance } from './blocks';
+/**
+ * Pattern status values
+ */
+export type PatternStatus = 'draft' | 'published';
+/**
+ * Pattern entity (minimal interface for core components)
+ *
+ * This is the minimal Pattern interface needed by core components.
+ * The full Pattern type with all fields is defined in the theme entity.
+ */
+export interface Pattern {
+    id: string;
+    userId: string;
+    teamId: string;
+    title: string;
+    slug: string;
+    blocks: BlockInstance[];
+    status: PatternStatus;
+    description?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Pattern reference stored in page/post blocks array
+ *
+ * This is NOT a real block - it's a reference that gets resolved at render time.
+ * The pattern's actual blocks are fetched and expanded when rendering the page.
+ *
+ * @example
+ * // In a page's blocks array:
+ * [
+ *   { id: 'block-1', blockSlug: 'hero', props: {...} },
+ *   { type: 'pattern', ref: 'pattern-uuid', id: 'instance-1' }, // Pattern reference
+ *   { id: 'block-2', blockSlug: 'cta', props: {...} }
+ * ]
+ */
+export interface PatternReference {
+    type: 'pattern';
+    ref: string;
+    id: string;
+}
+/**
+ * Type guard to check if a block is a pattern reference
+ *
+ * @param block - Block or pattern reference to check
+ * @returns True if block is a pattern reference
+ *
+ * @example
+ * if (isPatternReference(block)) {
+ *   // Handle pattern reference
+ *   const pattern = await PatternsService.getById(block.ref, userId)
+ * } else {
+ *   // Handle regular block
+ *   renderBlock(block)
+ * }
+ */
+export declare function isPatternReference(block: unknown): block is PatternReference;
+//# sourceMappingURL=pattern-reference.d.ts.map

package/dist/types/pattern-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-reference.d.ts","sourceRoot":"","sources":["../../src/types/pattern-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,WAAW,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,MAAM,EAAE,aAAa,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAQ5E"}

package/dist/types/plugin.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Plugin Type Definitions
+ *
+ * Central type definitions for the plugin system.
+ * Used across plugin registry, loaders, and components.
+ */
+/**
+ * Plugin lifecycle hooks
+ */
+export interface PluginHooks {
+    onLoad?: () => Promise<void>;
+    onActivate?: () => Promise<void>;
+    onDeactivate?: () => Promise<void>;
+    onUnload?: () => Promise<void>;
+}
+/**
+ * Plugin configuration interface
+ */
+export interface PluginConfig {
+    name: string;
+    displayName: string;
+    version: string;
+    description?: string;
+    enabled: boolean;
+    dependencies?: string[];
+    hooks?: PluginHooks;
+    components?: Record<string, any>;
+    services?: Record<string, any>;
+    api?: Record<string, any>;
+}
+/**
+ * Plugin route endpoint information
+ */
+export interface RouteFileEndpoint {
+    path: string;
+    filePath: string;
+    relativePath: string;
+    methods: string[];
+    isRouteFile: boolean;
+}
+/**
+ * Plugin registry entry with metadata
+ */
+export interface PluginRegistryEntry {
+    name: string;
+    config: PluginConfig;
+    hasAPI: boolean;
+    apiPath: string | null;
+    routeFiles?: RouteFileEndpoint[];
+    entities?: any[];
+    hasMessages?: boolean;
+    hasAssets?: boolean;
+}
+/**
+ * Plugin name type alias
+ */
+export type PluginName = string;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAChC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA"}

package/dist/types/task.types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Core Task types for the application
+ * Centralized type definitions to ensure consistency across components
+ */
+export interface Task {
+    id: string;
+    userId: string;
+    title: string;
+    description?: string;
+    completed: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Task priority levels with display information
+ */
+export interface TaskPriority {
+    level: 'low' | 'medium' | 'high';
+    label: string;
+    color: string;
+}
+/**
+ * Task category information
+ */
+export interface TaskCategory {
+    name: string;
+    icon?: string;
+}
+/**
+ * Extended Task interface for search functionality
+ * Includes inferred metadata for better UX
+ */
+export interface SearchableTask extends Task {
+    priority?: TaskPriority['level'];
+    category?: string;
+}
+/**
+ * Task update payload for API calls
+ */
+export interface TaskUpdatePayload {
+    title?: string;
+    description?: string;
+    completed?: boolean;
+}
+/**
+ * Task creation payload for API calls
+ */
+export interface TaskCreatePayload {
+    title: string;
+    description?: string;
+}
+/**
+ * Priority levels with their display configuration
+ */
+export declare const TASK_PRIORITIES: Record<TaskPriority['level'], Omit<TaskPriority, 'level'>>;
+/**
+ * Available task categories
+ */
+export declare const TASK_CATEGORIES: readonly ["Diseño", "Desarrollo", "Reuniones", "Documentación", "Testing", "General"];
+export type TaskCategoryType = typeof TASK_CATEGORIES[number];
+//# sourceMappingURL=task.types.d.ts.map

package/dist/types/task.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.types.d.ts","sourceRoot":"","sources":["../../src/types/task.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,IAAI;IAE1C,QAAQ,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAatF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,uFAOlB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAA"}

package/dist/types/testing.types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Testing and Accessibility Types
+ * Centralized attributes for test automation and accessibility compliance
+ */
+/**
+ * Testing attributes for automation (Cypress, Jest, etc.)
+ */
+export interface TestingProps {
+    'data-testid'?: string;
+    'data-cy'?: string;
+    'data-state'?: 'active' | 'completed' | 'pending' | 'loading' | 'error';
+    'data-priority'?: 'low' | 'medium' | 'high';
+    'data-status'?: 'active' | 'completed' | 'pending';
+    'data-task-id'?: string;
+    'data-user-id'?: string;
+}
+/**
+ * Accessibility attributes for WCAG compliance
+ */
+export interface AccessibilityProps {
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    'aria-expanded'?: boolean;
+    'aria-selected'?: boolean;
+    'aria-checked'?: boolean | 'mixed';
+    'aria-disabled'?: boolean;
+    'aria-hidden'?: boolean;
+    'aria-live'?: 'off' | 'polite' | 'assertive';
+    'aria-atomic'?: boolean;
+    'aria-controls'?: string;
+    'aria-activedescendant'?: string;
+    'aria-haspopup'?: boolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+    'role'?: 'button' | 'link' | 'menuitem' | 'option' | 'tab' | 'tabpanel' | 'dialog' | 'alertdialog' | 'region' | 'banner' | 'navigation' | 'main' | 'complementary' | 'contentinfo';
+    'tabIndex'?: number;
+}
+/**
+ * Combined props for components that need both testing and accessibility
+ */
+export interface ComponentTestingProps extends TestingProps, AccessibilityProps {
+}
+/**
+ * Keyboard navigation props
+ */
+export interface KeyboardNavigationProps {
+    onKeyDown?: (event: React.KeyboardEvent) => void;
+    onKeyUp?: (event: React.KeyboardEvent) => void;
+    onKeyPress?: (event: React.KeyboardEvent) => void;
+}
+/**
+ * Focus management props
+ */
+export interface FocusManagementProps {
+    autoFocus?: boolean;
+    tabIndex?: number;
+    onFocus?: (event: React.FocusEvent) => void;
+    onBlur?: (event: React.FocusEvent) => void;
+}
+/**
+ * Complete accessibility + testing props
+ */
+export interface FullAccessibilityProps extends ComponentTestingProps, KeyboardNavigationProps, FocusManagementProps {
+}
+/**
+ * Component-specific testing attribute types
+ */
+export interface TaskTestingProps extends TestingProps {
+    'data-task-id': string;
+    'data-status': 'active' | 'completed';
+    'data-priority'?: 'low' | 'medium' | 'high';
+}
+export interface NavigationTestingProps extends TestingProps {
+    'data-nav-item': string;
+    'data-current'?: boolean;
+    'data-expanded'?: boolean;
+}
+export interface FormTestingProps extends TestingProps {
+    'data-field-name': string;
+    'data-field-type': 'input' | 'textarea' | 'select' | 'checkbox' | 'radio';
+    'data-required'?: boolean;
+    'data-invalid'?: boolean;
+}
+/**
+ * Testing ID naming patterns
+ */
+export type TestIdPattern = `${string}-card` | `${string}-button` | `${string}-input` | `${string}-dropdown` | `${string}-modal` | `${string}-form` | `${string}-list` | `${string}-item` | `${string}-title` | `${string}-description` | `${string}-checkbox` | `${string}-toggle` | `${string}-menu` | `${string}-nav` | `${string}-search` | `${string}-notification`;
+/**
+ * Cypress ID naming patterns
+ */
+export type CypressIdPattern = `todo-${string}` | `task-${string}` | `nav-${string}` | `user-${string}` | `form-${string}` | `modal-${string}` | `dropdown-${string}` | `search-${string}` | `notification-${string}`;
+//# sourceMappingURL=testing.types.d.ts.map

package/dist/types/testing.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.types.d.ts","sourceRoot":"","sources":["../../src/types/testing.types.ts"],"names":[],"mappings":"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"}

package/dist/types/theme.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Theme Type Definitions
+ *
+ * Central type definitions for the theme system.
+ * Used across theme registry, loaders, and components.
+ */
+import type React from 'react';
+/**
+ * Theme configuration interface
+ */
+export interface ThemeConfig {
+    name: string;
+    displayName: string;
+    version: string;
+    description?: string;
+    author?: string;
+    enabled?: boolean;
+    dependencies?: string[];
+    plugins?: string[];
+    styles?: {
+        globals?: string;
+        components?: string;
+        variables?: Record<string, string>;
+    };
+    colors?: ThemeColors;
+    typography?: ThemeTypography;
+    spacing?: ThemeSpacing;
+    components?: Record<string, any>;
+    config?: Record<string, any>;
+    [key: string]: any;
+}
+/**
+ * Theme color configuration
+ */
+export interface ThemeColors {
+    primary?: string;
+    secondary?: string;
+    accent?: string;
+    background?: string;
+    foreground?: string;
+    muted?: string;
+    border?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Theme typography configuration
+ */
+export interface ThemeTypography {
+    fontFamily?: {
+        sans?: string;
+        serif?: string;
+        mono?: string;
+    };
+    fontSize?: Record<string, string>;
+    fontWeight?: Record<string, number>;
+    lineHeight?: Record<string, string>;
+}
+/**
+ * Theme spacing configuration
+ */
+export interface ThemeSpacing {
+    unit?: number;
+    scale?: Record<string, string>;
+    radius?: Record<string, string>;
+}
+/**
+ * Component override configuration
+ */
+export interface ComponentOverride {
+    path: string;
+    component: React.ComponentType<any>;
+    priority?: number;
+    [key: string]: any;
+}
+/**
+ * Template override configuration
+ * Used in auto-generated template registries
+ */
+export interface TemplateOverride {
+    name: string;
+    themeName: string;
+    templateType: string;
+    fileName: string;
+    relativePath: string;
+    appPath: string;
+    templatePath: string;
+    priority: number;
+    metadata?: any;
+}
+/**
+ * Template registry entry
+ * Used in auto-generated template registries
+ */
+export interface TemplateRegistryEntry {
+    appPath: string;
+    component: any;
+    template: TemplateOverride;
+    alternatives: TemplateOverride[];
+}
+//# sourceMappingURL=theme.d.ts.map

package/dist/types/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":"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"}

package/dist/types/user.types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * User-related types and constants
+ * All role configuration is centralized in app.config.ts
+ */
+import { USER_ROLES_CONFIG } from '../lib/config';
+import type { UserFlag } from '../lib/entities/types';
+export type UserRole = typeof USER_ROLES_CONFIG.availableRoles[number];
+export type CoreRole = typeof USER_ROLES_CONFIG.coreRoles[number];
+/**
+ * USER_ROLES
+ * This constant is generated dynamically from the app config.
+ * It is used to check user roles and permissions.
+ */
+export declare const USER_ROLES: Record<Uppercase<any>, any>;
+export declare const ROLE_HIERARCHY: any;
+/**
+ * Type guard to check if a role is a core role
+ *
+ * Core roles are protected system roles (member, superadmin, developer) that:
+ * - Cannot be removed by themes
+ * - Have special behavior in guards/middleware
+ * - Are defined in the core application config
+ *
+ * @param role - The role to check
+ * @returns True if the role is a core role, false if it's a theme-specific role
+ *
+ * @example
+ * ```typescript
+ * if (isCoreRole('member')) {
+ *   // This is a protected core role
+ * }
+ *
+ * if (isCoreRole('editor')) {
+ *   // False - this is a theme-specific role
+ * }
+ * ```
+ */
+export declare const isCoreRole: (role: UserRole) => role is CoreRole;
+/**
+ * Helper to check if a role is a theme-specific role (not a core role)
+ *
+ * Theme roles are custom roles added by themes via `additionalRoles`.
+ * They provide flexibility for vertical-specific applications (CRM, Blog, etc.)
+ *
+ * @param role - The role to check
+ * @returns True if the role is theme-specific, false if it's a core role
+ *
+ * @example
+ * ```typescript
+ * if (isThemeRole('editor')) {
+ *   // This is a custom role added by the theme
+ * }
+ *
+ * if (isThemeRole('member')) {
+ *   // False - this is a core role
+ * }
+ * ```
+ */
+export declare const isThemeRole: (role: UserRole) => boolean;
+export declare const roleHelpers: {
+    /**
+     * Check if a role has hierarchy level equal or higher than required role
+     */
+    hasRoleLevel: (userRole: UserRole, requiredRole: UserRole) => boolean;
+    /**
+     * Check if user is admin or higher
+     */
+    isAdmin: (userRole: UserRole) => boolean;
+    /**
+     * Check if user is superadmin
+     */
+    isSuperAdmin: (userRole: UserRole) => boolean;
+    /**
+     * Check if user is developer
+     */
+    isDeveloper: (userRole: UserRole) => boolean;
+    /**
+     * Check if user can access Admin Panel (superadmin or developer)
+     */
+    canAccessAdmin: (userRole: UserRole) => boolean;
+    /**
+     * Get role display name translation key
+     * Use with i18n: t(getRoleDisplayKey(role))
+     */
+    getRoleDisplayKey: (role: UserRole) => string;
+    /**
+     * Get all roles ordered by hierarchy (highest permissions first)
+     */
+    getAllRolesByHierarchy: () => UserRole[];
+};
+export interface User {
+    id: string;
+    email: string;
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+    role: UserRole;
+    image?: string;
+    emailVerified?: boolean;
+    createdAt?: Date;
+    updatedAt?: Date;
+    country?: string;
+    timezone?: string;
+    language?: string;
+}
+export interface UserWithFlags extends User {
+    flags: UserFlag[];
+}
+export interface SessionUser extends User {
+    flags?: UserFlag[];
+}
+//# sourceMappingURL=user.types.d.ts.map

package/dist/types/user.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.types.d.ts","sourceRoot":"","sources":["../../src/types/user.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,MAAM,MAAM,QAAQ,GAAG,OAAO,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AAGvE,MAAM,MAAM,QAAQ,GAAG,OAAO,iBAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAclE;;;;GAIG;AAEH,eAAO,MAAM,UAAU,6BAA6D,CAAC;AAGrF,eAAO,MAAM,cAAc,KAA8B,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,QAAQ,KAAG,IAAI,IAAI,QAEnD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,QAAQ,KAAG,OAE5C,CAAC;AAGF,eAAO,MAAM,WAAW;IACtB;;OAEG;6BACsB,QAAQ,gBAAgB,QAAQ,KAAG,OAAO;IAInE;;OAEG;wBACiB,QAAQ,KAAG,OAAO;IAItC;;OAEG;6BACsB,QAAQ,KAAG,OAAO;IAI3C;;OAEG;4BACqB,QAAQ,KAAG,OAAO;IAI1C;;OAEG;+BACwB,QAAQ,KAAG,OAAO;IAI7C;;;OAGG;8BACuB,QAAQ,KAAG,MAAM;IAI3C;;OAEG;kCACyB,QAAQ,EAAE;CAKvC,CAAC;AAGF,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,aAAc,SAAQ,IAAI;IACzC,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAGD,MAAM,WAAW,WAAY,SAAQ,IAAI;IACvC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpB"}

package/dist/utils/dev/TranslationDebugger.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Componente de debug para monitorear el estado de las traducciones
+ * Solo se muestra en desarrollo para ayudar a diagnosticar problemas de i18n
+ *
+ * Para activarlo, agregar ?debug-i18n=true a la URL
+ */
+export declare function TranslationDebugger(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TranslationDebugger.d.ts.map

package/dist/utils/dev/TranslationDebugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationDebugger.d.ts","sourceRoot":"","sources":["../../../src/utils/dev/TranslationDebugger.tsx"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,mBAAmB,4CAgKlC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/core",
-  "version": "0.1.0-beta.75",
+  "version": "0.1.0-beta.76",
   "description": "NextSpark - The complete SaaS framework for Next.js",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",
@@ -228,6 +228,22 @@
       "types": "./dist/components/patterns/pages/index.d.ts",
       "import": "./dist/components/patterns/pages/index.js"
     },
+    "./components/app": {
+      "types": "./dist/components/app/index.d.ts",
+      "import": "./dist/components/app/index.js"
+    },
+    "./components/app/layouts": {
+      "types": "./dist/components/app/layouts/index.d.ts",
+      "import": "./dist/components/app/layouts/index.js"
+    },
+    "./components/app/layouts/PublicNavbar": {
+      "types": "./dist/components/app/layouts/PublicNavbar.d.ts",
+      "import": "./dist/components/app/layouts/PublicNavbar.js"
+    },
+    "./components/app/layouts/PublicFooter": {
+      "types": "./dist/components/app/layouts/PublicFooter.d.ts",
+      "import": "./dist/components/app/layouts/PublicFooter.js"
+    },
     "./components/*": {
       "types": "./dist/components/*.d.ts",
       "import": "./dist/components/*.js"
@@ -279,6 +295,10 @@
     "./entities/*": {
       "types": "./dist/entities/*.d.ts",
       "import": "./dist/entities/*.js"
+    },
+    "./entities/patterns/*": {
+      "types": "./dist/entities/patterns/*.d.ts",
+      "import": "./dist/entities/patterns/*.js"
     }
   },
   "files": [
@@ -334,13 +354,14 @@
     "typescript": "^5"
   },
   "dependencies": {
+    "@nextsparkjs/ui": "workspace:*",
     "@codemirror/lang-json": "^6.0.2",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@hookform/resolvers": "^5.2.1",
     "@inquirer/prompts": "^7.2.0",
-    "@nextsparkjs/testing": "0.1.0-beta.53",
+    "@nextsparkjs/testing": "^0.1.0-beta.75",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-avatar": "^1.1.10",