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

package/dist/lib/config/nextspark-types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * NextSpark NPM Distribution Configuration Types
+ *
+ * Type definitions for nextspark.config.ts (project-level configuration)
+ * This is separate from app.config.ts (application runtime configuration)
+ *
+ * @module core/lib/config/nextspark-types
+ */
+export interface NextSparkConfig {
+    /** Active theme name */
+    theme: string;
+    /** Enabled plugins */
+    plugins?: string[];
+    /** Feature flags */
+    features?: {
+        billing?: boolean;
+        teams?: boolean;
+        superadmin?: boolean;
+        aiChat?: boolean;
+    };
+    /** Database configuration */
+    database?: {
+        provider: 'postgres' | 'mysql' | 'sqlite';
+        runMigrations?: boolean;
+    };
+    /** Auth configuration */
+    auth?: {
+        providers: ('email' | 'google')[];
+        requireEmailVerification?: boolean;
+    };
+    /** App metadata */
+    app?: {
+        name?: string;
+        description?: string;
+    };
+}
+/**
+ * Helper function to define configuration with TypeScript support
+ */
+export declare function defineConfig(config: NextSparkConfig): NextSparkConfig;
+//# sourceMappingURL=nextspark-types.d.ts.map

package/dist/lib/config/nextspark-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextspark-types.d.ts","sourceRoot":"","sources":["../../../src/lib/config/nextspark-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IAEb,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB,oBAAoB;IACpB,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,MAAM,CAAC,EAAE,OAAO,CAAA;KACjB,CAAA;IAED,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACT,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;QACzC,aAAa,CAAC,EAAE,OAAO,CAAA;KACxB,CAAA;IAED,yBAAyB;IACzB,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,CAAC,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAA;QACjC,wBAAwB,CAAC,EAAE,OAAO,CAAA;KACnC,CAAA;IAED,mBAAmB;IACnB,GAAG,CAAC,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAErE"}

package/dist/lib/config/roles-merge.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Roles Configuration Merge System
+ *
+ * This module provides specialized merge logic for the user roles configuration.
+ * Unlike the generic deepMerge utility (which replaces arrays entirely), this
+ * function implements additive merge for roles while protecting core system roles.
+ *
+ * Key Features:
+ * - Core roles (member, superadmin, developer) are always present and protected
+ * - Themes can add custom roles via `additionalRoles`
+ * - Developer role hierarchy is always forced to 100
+ * - Non-developer roles cannot exceed hierarchy 99
+ * - Validation with console warnings (non-blocking)
+ *
+ * @module roles-merge
+ */
+/**
+ * Core roles configuration (from DEFAULT_APP_CONFIG)
+ * Contains the protected roles that cannot be removed
+ */
+export interface CoreRolesConfig {
+    coreRoles: readonly string[];
+    defaultRole: string;
+    availableRoles: readonly string[];
+    hierarchy: Record<string, number>;
+    displayNames: Record<string, string>;
+    descriptions: Record<string, string>;
+}
+/**
+ * Theme roles configuration (from theme app.config.ts)
+ * Allows themes to extend the role system
+ */
+export interface ThemeRolesConfig {
+    additionalRoles?: readonly string[];
+    defaultRole?: string;
+    hierarchy?: Record<string, number>;
+    displayNames?: Record<string, string>;
+    descriptions?: Record<string, string>;
+}
+/**
+ * Core team roles configuration (from DEFAULT_APP_CONFIG.teamRoles)
+ * Contains the protected team role (owner) that cannot be removed
+ *
+ * Note: Team permissions are now defined in permissions.config.ts
+ * and accessed via permissions-registry (TEAM_PERMISSIONS_BY_ROLE)
+ */
+export interface CoreTeamRolesConfig {
+    coreTeamRoles: readonly string[];
+    defaultTeamRole: string;
+    availableTeamRoles: readonly string[];
+    hierarchy: Record<string, number>;
+    displayNames: Record<string, string>;
+    descriptions: Record<string, string>;
+}
+/**
+ * Theme team roles configuration (from theme app.config.ts)
+ * Allows themes to customize team roles (except 'owner')
+ *
+ * Note: Team permissions are now defined in permissions.config.ts
+ * Use the `teams` array in permissions.config.ts to define role permissions.
+ */
+export interface ThemeTeamRolesConfig {
+    /** Additional team roles to add */
+    additionalTeamRoles?: readonly string[];
+    /** Team roles to remove (cannot include 'owner') */
+    removeTeamRoles?: readonly string[];
+    /** Default role for new team members */
+    defaultTeamRole?: string;
+    /** Hierarchy overrides (cannot modify 'owner') */
+    hierarchy?: Record<string, number>;
+    /** Display name overrides */
+    displayNames?: Record<string, string>;
+    /** Description overrides */
+    descriptions?: Record<string, string>;
+}
+/**
+ * Merged team roles configuration result
+ *
+ * Note: Team permissions are NOT included here anymore.
+ * Use TEAM_PERMISSIONS_BY_ROLE from permissions-registry instead.
+ */
+export interface MergedTeamRolesConfig {
+    coreTeamRoles: readonly string[];
+    availableTeamRoles: readonly string[];
+    defaultTeamRole: string;
+    hierarchy: Record<string, number>;
+    displayNames: Record<string, string>;
+    descriptions: Record<string, string>;
+}
+/**
+ * Merged roles configuration result
+ * Contains core roles + theme additions with validation applied
+ */
+export interface MergedRolesConfig {
+    coreRoles: readonly string[];
+    availableRoles: readonly string[];
+    defaultRole: string;
+    hierarchy: Record<string, number>;
+    displayNames: Record<string, string>;
+    descriptions: Record<string, string>;
+}
+/**
+ * Merge core roles configuration with theme-specific overrides
+ *
+ * This function implements the extensible roles system by:
+ * 1. Protecting core roles from removal
+ * 2. Appending theme additionalRoles to core roles
+ * 3. Merging hierarchy with validation (developer=100, others <=99)
+ * 4. Merging displayNames and descriptions (theme overrides core)
+ * 5. Validating defaultRole exists in available roles
+ *
+ * @param coreConfig - Core roles configuration from DEFAULT_APP_CONFIG
+ * @param themeConfig - Optional theme roles configuration overrides
+ * @returns Merged and validated roles configuration
+ *
+ * @example
+ * ```typescript
+ * const merged = mergeRolesConfig(
+ *   DEFAULT_APP_CONFIG.userRoles,
+ *   { additionalRoles: ['editor', 'moderator'] }
+ * )
+ * // merged.availableRoles: ['member', 'superadmin', 'developer', 'editor', 'moderator']
+ * ```
+ */
+export declare function mergeRolesConfig(coreConfig: CoreRolesConfig, themeConfig?: ThemeRolesConfig): MergedRolesConfig;
+/**
+ * Merge core team roles configuration with theme-specific overrides
+ *
+ * This function implements the extensible team roles system by:
+ * 1. Protecting the 'owner' role from removal (critical for team creation)
+ * 2. Allowing themes to add custom team roles via `additionalTeamRoles`
+ * 3. Allowing themes to remove non-core roles via `removeTeamRoles`
+ * 4. Merging hierarchy with validation (owner=100, others <=99)
+ * 5. Validating defaultTeamRole exists in available roles
+ *
+ * @param coreConfig - Core team roles configuration from DEFAULT_APP_CONFIG
+ * @param themeConfig - Optional theme team roles configuration overrides
+ * @returns Merged and validated team roles configuration
+ *
+ * @example
+ * ```typescript
+ * const merged = mergeTeamRolesConfig(
+ *   DEFAULT_APP_CONFIG.teamRoles,
+ *   {
+ *     additionalTeamRoles: ['editor', 'guest'],
+ *     removeTeamRoles: ['viewer'],
+ *   }
+ * )
+ * // merged.availableTeamRoles: ['owner', 'admin', 'member', 'editor', 'guest']
+ * ```
+ */
+export declare function mergeTeamRolesConfig(coreConfig: CoreTeamRolesConfig, themeConfig?: ThemeTeamRolesConfig): MergedTeamRolesConfig;
+//# sourceMappingURL=roles-merge.d.ts.map

package/dist/lib/config/roles-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles-merge.d.ts","sourceRoot":"","sources":["../../../src/lib/config/roles-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,eAAe,EAAE,MAAM,CAAA;IACvB,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,oDAAoD;IACpD,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAwBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,eAAe,EAC3B,WAAW,CAAC,EAAE,gBAAgB,GAC7B,iBAAiB,CAuHnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,mBAAmB,EAC/B,WAAW,CAAC,EAAE,oBAAoB,GACjC,qBAAqB,CAmJvB"}

package/dist/lib/config/types.d.ts

@@ -0,0 +1,352 @@
+/**
+ * Configuration Type Definitions
+ *
+ * TypeScript interfaces and types for application configuration.
+ * These provide type safety and auto-completion for config files.
+ */
+import type { IconName } from './icon-map';
+/**
+ * Teams Mode
+ *
+ * Defines how teams work in the application.
+ */
+export type TeamsMode = 'single-user' | 'single-tenant' | 'multi-tenant';
+/**
+ * Teams Configuration Options
+ */
+export interface TeamsConfigOptions {
+    /** Maximum number of teams a user can create */
+    maxTeamsPerUser?: number | null;
+    /** Maximum members per team */
+    maxMembersPerTeam?: number | null;
+    /** Allow users to leave all teams */
+    allowLeaveAllTeams?: boolean;
+    /**
+     * Allow users to create additional teams in multi-tenant mode
+     * - true (default): Users can create multiple teams without limit
+     * - false: Users can only be owner of maximum 1 team
+     * Note: Only applies to multi-tenant mode. Signup team is always created.
+     */
+    allowCreateTeams?: boolean;
+}
+/**
+ * Teams Configuration
+ */
+export interface TeamsConfig {
+    /** Teams mode */
+    mode: TeamsMode;
+    /** Additional options */
+    options?: TeamsConfigOptions;
+}
+/**
+ * Mobile Navigation Item
+ *
+ * Represents a single item in the mobile bottom navigation bar.
+ */
+export interface MobileNavItem {
+    /** Unique identifier for the nav item */
+    id: string;
+    /** Translation key for the label (e.g., 'common.mobileNav.home') */
+    labelKey: string;
+    /** Navigation href (optional if item triggers an action) */
+    href?: string;
+    /** Icon name from Lucide icons */
+    icon: IconName;
+    /** Whether this item is enabled and should be displayed */
+    enabled: boolean;
+    /** Whether this is the central elevated button (e.g., Quick Create) */
+    isCentral?: boolean;
+    /** Action to trigger instead of navigation */
+    action?: 'quickCreate' | 'moreSheet';
+}
+/**
+ * Mobile "More" Sheet Item
+ *
+ * Represents a single item in the mobile "More" options sheet.
+ */
+export interface MobileNavMoreItem {
+    /** Unique identifier for the more sheet item */
+    id: string;
+    /** Translation key for the label */
+    labelKey: string;
+    /** Navigation href */
+    href: string;
+    /** Icon name from Lucide icons */
+    icon: IconName;
+    /** Whether this item is enabled and should be displayed */
+    enabled: boolean;
+    /** Whether this link opens in a new tab */
+    external?: boolean;
+}
+/**
+ * Mobile Navigation Configuration
+ *
+ * Complete configuration for mobile navigation system.
+ */
+export interface MobileNavConfig {
+    /** Bottom navigation bar items */
+    items: MobileNavItem[];
+    /** "More" sheet secondary navigation items */
+    moreSheetItems: MobileNavMoreItem[];
+}
+/**
+ * Topbar Feature Flags
+ *
+ * Controls which features are enabled in the desktop topbar.
+ */
+export interface TopbarConfig {
+    features: {
+        quickCreate: boolean;
+        search: boolean;
+        notifications: boolean;
+        help: boolean;
+        theme: boolean;
+        admin: boolean;
+        userMenu: boolean;
+    };
+}
+/**
+ * Settings Page Configuration
+ */
+export interface SettingsPageConfig {
+    enabled: boolean;
+    order?: number;
+}
+export interface SettingsConfig {
+    pages: {
+        profile: SettingsPageConfig;
+        billing: SettingsPageConfig;
+        apiKeys: SettingsPageConfig;
+        password: SettingsPageConfig;
+    };
+}
+/**
+ * Documentation Category Configuration
+ *
+ * Configuration for a single documentation category (public or superadmin).
+ */
+export interface DocsCategoryConfig {
+    /** Enable/disable this documentation level in the sidebar */
+    enabled: boolean;
+    /** Whether this category should be expanded by default on page load */
+    open?: boolean;
+    /** Custom label displayed in the sidebar for this category */
+    label: string;
+}
+/**
+ * Documentation System Configuration
+ *
+ * Controls documentation system behavior including visibility,
+ * search functionality, and category-specific settings.
+ *
+ * Structure:
+ * - public: User-facing documentation at /docs
+ * - superadmin: Admin documentation at /superadmin/docs
+ *
+ * NOTE: Plugin docs are NOT in the registry - they are for developer reference only (IDE/LLM).
+ */
+export interface DocsConfig {
+    /** Enable/disable the entire documentation system */
+    enabled: boolean;
+    /** Make public documentation accessible without authentication */
+    publicAccess?: boolean;
+    /** Enable search functionality in the sidebar */
+    searchEnabled: boolean;
+    /** Show breadcrumbs navigation in documentation pages */
+    breadcrumbs: boolean;
+    /** Public documentation configuration (for /docs routes) */
+    public?: DocsCategoryConfig;
+    /** Superadmin documentation configuration (for /superadmin/docs routes) */
+    superadmin?: DocsCategoryConfig;
+}
+/**
+ * DevKeyring User Configuration
+ *
+ * Represents a test user for quick login during development.
+ */
+export interface DevKeyringUser {
+    /** Unique identifier for the user */
+    id: string;
+    /** User's email address */
+    email: string;
+    /** User's display name */
+    name: string;
+    /** User's password (for auto-fill) */
+    password: string;
+    /** Team roles description (e.g., "TeamA (admin), TeamB (member)") */
+    teamRoles?: string;
+}
+/**
+ * DevKeyring Configuration
+ *
+ * Configuration for development/QA quick login feature.
+ * Only rendered in non-production environments.
+ */
+export interface DevKeyringConfig {
+    /** Enable/disable the DevKeyring feature */
+    enabled: boolean;
+    /** List of test users available for quick login */
+    users: DevKeyringUser[];
+}
+/**
+ * Team Roles Configuration
+ *
+ * Defines roles within teams (team_members.role).
+ * Separate from global user roles (users.role).
+ *
+ * NOTE: Team PERMISSIONS are now defined in permissions.config.ts
+ * under the `teams` section. This is the SINGLE SOURCE OF TRUTH
+ * for all permissions. Use PermissionService.canDoAction() to check.
+ */
+export interface TeamRolesConfig {
+    /** Protected core team roles - CANNOT be removed by themes */
+    coreTeamRoles: readonly string[];
+    /** Default role for new team members */
+    defaultTeamRole: string;
+    /** All available team roles */
+    availableTeamRoles: readonly string[];
+    /** Role hierarchy (higher = more permissions within team) */
+    hierarchy: Record<string, number>;
+    /** Role display names (translation keys) */
+    displayNames: Record<string, string>;
+    /** Role descriptions */
+    descriptions: Record<string, string>;
+}
+/**
+ * Webhook Endpoint Configuration
+ *
+ * Represents a single webhook endpoint with its URL source and event patterns.
+ */
+export interface WebhookEndpointConfig {
+    /** Environment variable name containing the URL (security best practice) */
+    envVar: string;
+    /** Description of this webhook's purpose */
+    description?: string;
+    /**
+     * Event patterns this webhook matches (for auto-routing)
+     * Examples: 'task:*', 'subscription:created', '*:created'
+     * Uses glob-like matching: * matches any segment
+     */
+    patterns?: string[];
+    /** Whether this endpoint is enabled */
+    enabled?: boolean;
+}
+/**
+ * Webhooks Configuration
+ *
+ * Defines multiple webhook endpoints, each identified by a unique key.
+ * URLs are read from environment variables for security.
+ */
+export interface WebhooksConfig {
+    /** Named webhook endpoints */
+    endpoints: Record<string, WebhookEndpointConfig>;
+    /** Default endpoint key for fallback when no pattern matches */
+    defaultEndpoint?: string;
+}
+/**
+ * Scheduled Actions Configuration
+ *
+ * Controls the scheduled actions system behavior.
+ * Core provides defaults, themes can override.
+ */
+export interface ScheduledActionsConfig {
+    /** Enable/disable scheduled actions system */
+    enabled: boolean;
+    /** Retention period for completed/failed actions in days */
+    retentionDays: number;
+    /** Maximum actions to process per cron run */
+    batchSize: number;
+    /** Default timeout per action in milliseconds */
+    defaultTimeout: number;
+    /**
+     * @deprecated Use webhooks.endpoints instead for multi-endpoint support
+     * Legacy single webhook URL for backward compatibility
+     */
+    webhookUrl?: string;
+    /** Multi-endpoint webhook configuration */
+    webhooks?: WebhooksConfig;
+    /**
+     * Deduplication settings to prevent duplicate actions
+     * Uses time-window approach: same entityId within window = duplicate
+     *
+     * Behavior:
+     * - windowSeconds > 0: Updates existing action's payload (override)
+     * - windowSeconds = 0: Disables deduplication (track all changes)
+     */
+    deduplication?: {
+        /** Time window in seconds to detect duplicates (default: 5). Set to 0 to disable. */
+        windowSeconds: number;
+    };
+}
+/**
+ * Complete Application Configuration
+ *
+ * Root configuration object structure.
+ *
+ * Note: This interface defines the core required types for type safety.
+ * Additional properties can be added in app.config.ts and will be validated at runtime.
+ */
+export interface AppConfig {
+    app: {
+        name: string;
+        version: string;
+    };
+    i18n: {
+        supportedLocales: string[];
+        defaultLocale: string;
+        cookie: {
+            name: string;
+            maxAge: number;
+            httpOnly: boolean;
+            secure: string | boolean;
+            sameSite: 'lax' | 'strict' | 'none';
+            path: string;
+        };
+        namespaces: string[];
+        performance: {
+            preloadCriticalNamespaces: string[];
+        };
+    };
+    topbar: TopbarConfig;
+    settings: SettingsConfig;
+    mobileNav: MobileNavConfig;
+    /** Documentation system configuration */
+    docs?: DocsConfig;
+    /**
+     * DevKeyring configuration for development/QA quick login
+     *
+     * @deprecated DevKeyring configuration has moved to dev.config.ts
+     * This property is kept for backwards compatibility but should not be used.
+     * Use DEV_CONFIG from config-sync.ts instead.
+     */
+    devKeyring?: DevKeyringConfig;
+    /** Team roles configuration (for team_members.role) */
+    teamRoles?: TeamRolesConfig;
+    /** Scheduled actions system configuration */
+    scheduledActions?: ScheduledActionsConfig;
+    [key: string]: any;
+}
+/**
+ * Development Configuration
+ *
+ * Contains development-only settings that should never affect production.
+ * This configuration is loaded from dev.config.ts in each theme.
+ *
+ * @example
+ * ```typescript
+ * // contents/themes/my-theme/config/dev.config.ts
+ * export const DEV_CONFIG_OVERRIDES: DevConfig = {
+ *   devKeyring: {
+ *     enabled: true,
+ *     users: [
+ *       { id: 'dev', email: 'dev@test.com', name: 'Developer', password: 'test123' },
+ *     ],
+ *   },
+ * }
+ * ```
+ */
+export interface DevConfig {
+    /** DevKeyring configuration for quick login in development */
+    devKeyring?: DevKeyringConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/config/types.d.ts.map

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

package/dist/lib/constants/reserved-slugs.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Reserved Slugs for Pages System
+ *
+ * This file contains all slugs that cannot be used for dynamic pages
+ * to prevent conflicts with system routes, API endpoints, and existing entities.
+ *
+ * Auto-updated by build-registry.mjs to include entity slugs from ENTITY_REGISTRY
+ */
+export declare const RESERVED_SLUGS: readonly ["api", "auth", "admin", "login", "register", "dashboard", "signin", "signout", "signup", "verify", "reset-password", "forgot-password", "_next", "_vercel", "_error", "_document", "_app", "public", "static", "assets", "images", "theme", "favicon.ico", "robots.txt", "sitemap.xml", "manifest.json", "app", "core", "lib", "components", "utils", "styles", "fonts", "index", "home", "page", "post", "posts", "blog", "article", "articles", "v1", "v2", "v3"];
+export type ReservedSlug = (typeof RESERVED_SLUGS)[number];
+/**
+ * Check if a slug is reserved
+ */
+export declare function isReservedSlug(slug: string): boolean;
+/**
+ * Validate a slug for pages system
+ * Returns error message if invalid, null if valid
+ */
+export declare function validatePageSlug(slug: string): string | null;
+/**
+ * Generate a slug from a string (typically a title)
+ */
+export declare function generateSlug(input: string): string;
+/**
+ * Suggest alternative slugs if the current one is taken or reserved
+ */
+export declare function suggestAlternativeSlug(slug: string, existingSlugs?: string[]): string[];
+//# sourceMappingURL=reserved-slugs.d.ts.map

package/dist/lib/constants/reserved-slugs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved-slugs.d.ts","sourceRoot":"","sources":["../../../src/lib/constants/reserved-slugs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,cAAc,+cA2DjB,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqC5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAsB3F"}