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

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

@@ -0,0 +1,141 @@
+/**
+ * Billing System Types
+ *
+ * Core types for plans, subscriptions, usage tracking, and billing events.
+ * Used throughout the billing system for type safety.
+ */
+export type PlanType = 'free' | 'paid' | 'enterprise';
+export type PlanVisibility = 'public' | 'hidden' | 'invite_only';
+export interface Plan {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    type: PlanType;
+    visibility: PlanVisibility;
+    priceMonthly: number | null;
+    priceYearly: number | null;
+    currency: string;
+    trialDays: number;
+    features: string[];
+    limits: Record<string, number>;
+    metadata: Record<string, unknown>;
+    sortOrder: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type SubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'paused' | 'expired';
+export type PaymentProvider = 'stripe' | 'paddle' | 'lemonsqueezy';
+export type BillingInterval = 'monthly' | 'yearly';
+export interface Subscription {
+    id: string;
+    teamId: string;
+    userId: string | null;
+    planId: string;
+    status: SubscriptionStatus;
+    currentPeriodStart: Date;
+    currentPeriodEnd: Date;
+    trialEndsAt: Date | null;
+    canceledAt: Date | null;
+    cancelAtPeriodEnd: boolean;
+    billingInterval: BillingInterval;
+    paymentProvider: PaymentProvider | null;
+    externalSubscriptionId: string | null;
+    externalCustomerId: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface SubscriptionWithPlan extends Subscription {
+    plan: Plan;
+}
+export interface Usage {
+    id: string;
+    subscriptionId: string;
+    limitSlug: string;
+    periodKey: string;
+    currentValue: number;
+    lastIncrementAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface UsageEvent {
+    id: string;
+    subscriptionId: string;
+    userId: string | null;
+    teamId: string;
+    limitSlug: string;
+    delta: number;
+    action: string | null;
+    resourceType: string | null;
+    resourceId: string | null;
+    periodKey: string;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+}
+export interface BillingEvent {
+    id: string;
+    subscriptionId: string;
+    type: 'payment' | 'refund' | 'invoice' | 'credit' | 'lifecycle';
+    status: 'pending' | 'succeeded' | 'failed';
+    amount: number;
+    currency: string;
+    externalPaymentId: string | null;
+    invoiceUrl: string | null;
+    receiptUrl: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+}
+export type InvoiceStatus = 'pending' | 'paid' | 'failed' | 'refunded';
+/**
+ * Invoice from Stripe synced to local database
+ */
+export interface Invoice {
+    id: string;
+    teamId: string;
+    invoiceNumber: string;
+    date: Date;
+    amount: number;
+    currency: string;
+    status: InvoiceStatus;
+    pdfUrl: string | null;
+    description: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface QuotaInfo {
+    allowed: boolean;
+    current: number;
+    max: number;
+    remaining: number;
+    percentUsed: number;
+}
+export interface UserUsageSummary {
+    userId: string;
+    userName: string;
+    userEmail: string;
+    limitSlug: string;
+    totalUsage: number;
+    percentage: number;
+}
+export interface TopConsumer {
+    userId: string;
+    userName: string;
+    totalUsage: number;
+    percentage: number;
+}
+export interface TeamUsageSummary {
+    byLimit: Record<string, {
+        current: number;
+        limit: number;
+        percentUsed: number;
+    }>;
+    byUser: UserUsageSummary[];
+    topConsumers: TopConsumer[];
+}
+export interface CanPerformActionResult {
+    allowed: boolean;
+    reason?: 'no_permission' | 'feature_not_in_plan' | 'quota_exceeded';
+    quota?: QuotaInfo;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/lib/blocks/loader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Block Loader Utility
+ *
+ * Provides access to lazy-loaded block components from the generated registry.
+ * Components are pre-loaded as React.lazy by the registry generator.
+ *
+ * @module core/lib/blocks/loader
+ */
+import { ComponentType } from 'react';
+type BlockComponent = ComponentType<any>;
+/**
+ * Get all block components from the generated registry
+ * Components are pre-loaded as React.lazy by the registry generator
+ *
+ * @returns Record of slug -> lazy component mappings
+ */
+export declare function getBlockComponents(): Record<string, BlockComponent>;
+/**
+ * Get a specific block component by slug
+ *
+ * @param slug - Block slug (e.g., 'hero', 'features-grid')
+ * @returns The block component or undefined if not found
+ */
+export declare function getBlockComponent(slug: string): BlockComponent | undefined;
+/**
+ * Check if a block exists in the registry
+ *
+ * @param slug - Block slug to check
+ * @returns true if block exists
+ */
+export declare function hasBlock(slug: string): boolean;
+/**
+ * Convert flat dot-notation props to nested objects
+ *
+ * Transforms: { "cta.text": "Hello", "cta.link": "/path" }
+ * Into: { cta: { text: "Hello", link: "/path" } }
+ *
+ * Special handling for CTA-like objects:
+ * - Only includes if both text AND link are present and non-empty
+ * - Adds default target="_self" if not specified
+ *
+ * @param props - Flat props object with possible dot notation keys
+ * @returns Normalized props with nested objects
+ */
+export declare function normalizeBlockProps(props: Record<string, unknown>): Record<string, unknown>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/lib/blocks/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/lib/blocks/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAIrC,KAAK,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;AAExC;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgD3F"}

package/dist/lib/blocks/pattern-resolver.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Pattern Resolver Utility
+ *
+ * Resolves pattern references in blocks arrays by replacing references
+ * with the actual blocks from the pattern.
+ *
+ * Used in public page rendering to expand pattern references so that
+ * pages show the actual pattern content instead of references.
+ *
+ * @module core/lib/blocks/pattern-resolver
+ */
+import type { BlockInstance } from '../../types/blocks';
+import type { Pattern, PatternReference } from '../../types/pattern-reference';
+/**
+ * Resolve pattern references in a blocks array
+ *
+ * Replaces { type: 'pattern', ref: 'uuid' } with actual blocks from the pattern.
+ * Pattern references are expanded inline, maintaining the order of the blocks array.
+ *
+ * If a pattern is not found in the cache, the reference is skipped (graceful degradation).
+ *
+ * @param blocks - Array of blocks which may contain pattern references
+ * @param patternCache - Map of pattern ID -> Pattern data
+ * @returns Flattened array of blocks with patterns expanded
+ *
+ * @example
+ * // Input blocks array:
+ * [
+ *   { id: 'block-1', blockSlug: 'hero', props: {...} },
+ *   { type: 'pattern', ref: 'pattern-uuid', id: 'instance-1' },
+ *   { id: 'block-2', blockSlug: 'cta', props: {...} }
+ * ]
+ *
+ * // Pattern with uuid 'pattern-uuid' contains:
+ * [
+ *   { id: 'p-block-1', blockSlug: 'text', props: {...} },
+ *   { id: 'p-block-2', blockSlug: 'button', props: {...} }
+ * ]
+ *
+ * // Result after resolution:
+ * [
+ *   { id: 'block-1', blockSlug: 'hero', props: {...} },
+ *   { id: 'p-block-1', blockSlug: 'text', props: {...} },    // From pattern
+ *   { id: 'p-block-2', blockSlug: 'button', props: {...} },  // From pattern
+ *   { id: 'block-2', blockSlug: 'cta', props: {...} }
+ * ]
+ */
+export declare function resolvePatternReferences(blocks: (BlockInstance | PatternReference)[], patternCache: Map<string, Pattern>): BlockInstance[];
+/**
+ * Extract pattern IDs from a blocks array
+ *
+ * Scans blocks array and returns unique pattern IDs that need to be fetched.
+ * Used to batch fetch all referenced patterns in a single query.
+ *
+ * @param blocks - Array of blocks which may contain pattern references
+ * @returns Array of unique pattern IDs
+ *
+ * @example
+ * const blocks = [
+ *   { id: 'block-1', blockSlug: 'hero', props: {...} },
+ *   { type: 'pattern', ref: 'pattern-uuid-1', id: 'instance-1' },
+ *   { type: 'pattern', ref: 'pattern-uuid-2', id: 'instance-2' },
+ *   { type: 'pattern', ref: 'pattern-uuid-1', id: 'instance-3' },  // Duplicate
+ *   { id: 'block-2', blockSlug: 'cta', props: {...} }
+ * ]
+ *
+ * const patternIds = extractPatternIds(blocks)
+ * // Result: ['pattern-uuid-1', 'pattern-uuid-2']
+ */
+export declare function extractPatternIds(blocks: (BlockInstance | PatternReference)[]): string[];
+//# sourceMappingURL=pattern-resolver.d.ts.map

package/dist/lib/blocks/pattern-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-resolver.d.ts","sourceRoot":"","sources":["../../../src/lib/blocks/pattern-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAG9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,CAAC,aAAa,GAAG,gBAAgB,CAAC,EAAE,EAC5C,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,aAAa,EAAE,CA0BjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,CAAC,aAAa,GAAG,gBAAgB,CAAC,EAAE,GAC3C,MAAM,EAAE,CAUV"}

package/dist/lib/blocks/patterns-resolver.service.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Patterns Resolver Service
+ *
+ * Minimal service for resolving pattern references in public pages.
+ * This is a core service that provides only the functionality needed
+ * for public page rendering without RLS (for anonymous access).
+ *
+ * NOTE: The full PatternsService (CRUD, list, etc.) is in core/entities/patterns.
+ * This service specifically handles anonymous pattern resolution at render time,
+ * while PatternsService handles authenticated operations with RLS.
+ *
+ * @module core/lib/blocks/patterns-resolver.service
+ */
+import type { Pattern } from '../../types/pattern-reference';
+/**
+ * Core service for pattern resolution
+ *
+ * Provides only the methods needed for public page rendering.
+ * Uses direct queries without RLS since public pages are anonymous.
+ */
+export declare class PatternsResolverService {
+    /**
+     * Get multiple patterns by IDs (batch fetch)
+     *
+     * Used for resolving pattern references in public pages.
+     * Only fetches PUBLISHED patterns (drafts are not shown publicly).
+     *
+     * @param ids - Array of pattern IDs
+     * @returns Array of published patterns
+     *
+     * @example
+     * const patternRefs = [{ ref: 'uuid-1' }, { ref: 'uuid-2' }]
+     * const patterns = await PatternsResolverService.getByIds(
+     *   patternRefs.map(p => p.ref)
+     * )
+     */
+    static getByIds(ids: string[]): Promise<Pattern[]>;
+}
+//# sourceMappingURL=patterns-resolver.service.d.ts.map

package/dist/lib/blocks/patterns-resolver.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns-resolver.service.d.ts","sourceRoot":"","sources":["../../../src/lib/blocks/patterns-resolver.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAiB5D;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC;;;;;;;;;;;;;;OAcG;WACU,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAsDzD"}

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

@@ -0,0 +1,12 @@
+/**
+ * Default Application Configuration (Core)
+ *
+ * This file contains the default configuration values for the application.
+ * These values can be overridden by theme-specific app.config.ts files.
+ *
+ * The merge system will combine this default config with theme-specific configs,
+ * allowing themes to override only the values they need to change.
+ */
+import type { AppConfig } from './types';
+export declare const DEFAULT_APP_CONFIG: AppConfig;
+//# sourceMappingURL=app.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.config.d.ts","sourceRoot":"","sources":["../../../src/lib/config/app.config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAMxC,eAAO,MAAM,kBAAkB,EAAE,SAuZhC,CAAA"}

package/dist/lib/config/config-loader.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Core Configuration Loader
+ *
+ * This module provides async access to the merged application configuration.
+ * The actual merge logic is in config-sync.ts (synchronous).
+ *
+ * @deprecated Most code should import directly from config-sync.ts for synchronous access.
+ * This async loader is maintained for backward compatibility with code that expects async config loading.
+ */
+import type { ApplicationConfig } from './config-types';
+/**
+ * Load application configuration (async wrapper for compatibility)
+ *
+ * @deprecated Import APP_CONFIG_MERGED from config-sync.ts instead for synchronous access
+ */
+export declare function loadApplicationConfig(): Promise<ApplicationConfig>;
+/**
+ * Get application configuration (cached)
+ * This ensures configuration is only loaded once per application lifecycle
+ */
+export declare function getApplicationConfig(): Promise<ApplicationConfig>;
+/**
+ * Clear configuration cache (useful for testing)
+ */
+export declare function clearConfigCache(): void;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/lib/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/config/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAOvD;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAyDxE;AAsGD;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAOvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/lib/config/config-sync.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Synchronous Configuration Access
+ *
+ * For cases where we need synchronous access to configuration values,
+ * we directly import the project config. This is primarily for types and
+ * constants that need to be available at build time.
+ *
+ * Configuration Merge System:
+ * 1. Loads default configs from core (app.config + dashboard.config)
+ * 2. Loads theme-specific config overrides (if exists)
+ * 3. Validates theme config (development only)
+ * 4. Merges theme config over defaults (theme overrides)
+ * 5. Provides unified configuration for the application
+ */
+export declare const APP_CONFIG_MERGED: any;
+export declare const DASHBOARD_CONFIG: any;
+export declare const DEV_CONFIG: import("./types").DevConfig;
+export declare const SUPPORTED_LOCALES: any;
+export declare const DEFAULT_LOCALE: any;
+export declare const AVAILABLE_ROLES: any;
+export declare const DEFAULT_ROLE: any;
+export declare const APP_NAME: any;
+export declare const APP_VERSION: any;
+export declare const I18N_CONFIG: any;
+export declare const APP_CONFIG: any;
+export declare const USER_ROLES_CONFIG: any;
+export declare const API_CONFIG: any;
+export declare const MOBILE_NAV_CONFIG: any;
+export declare const TEAMS_CONFIG: any;
+export declare const TOPBAR_CONFIG: any;
+export declare const SIDEBAR_CONFIG: any;
+export declare const SETTINGS_CONFIG: any;
+export declare const ENTITIES_CONFIG: any;
+export declare const HOMEPAGE_CONFIG: any;
+export declare const PERFORMANCE_CONFIG: any;
+export declare const ACCESSIBILITY_CONFIG: any;
+export declare const isSettingsPageEnabled: (pageName: string) => boolean;
+export interface EnabledSettingsPage {
+    key: string;
+    order: number;
+    label: string;
+}
+export declare const getEnabledSettingsPages: () => EnabledSettingsPage[];
+export declare const isTopbarFeatureEnabled: (feature: string) => boolean;
+export declare const getTopbarFeatureConfig: <T = Record<string, unknown>>(feature: string) => T | undefined;
+export type SupportedLocale = typeof APP_CONFIG_MERGED.i18n.supportedLocales[number];
+export type TranslationNamespace = typeof APP_CONFIG_MERGED.i18n.namespaces[number];
+export type UserRole = typeof APP_CONFIG_MERGED.userRoles.availableRoles[number];
+//# sourceMappingURL=config-sync.d.ts.map

package/dist/lib/config/config-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-sync.d.ts","sourceRoot":"","sources":["../../../src/lib/config/config-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAyNH,eAAO,MAAM,iBAAiB,KAAkB,CAAA;AAChD,eAAO,MAAM,gBAAgB,KAAwB,CAAA;AACrD,eAAO,MAAM,UAAU,6BAAkB,CAAA;AAGzC,eAAO,MAAM,iBAAiB,KAA0C,CAAA;AACxE,eAAO,MAAM,cAAc,KAAuC,CAAA;AAClE,eAAO,MAAM,eAAe,KAA6C,CAAA;AACzE,eAAO,MAAM,YAAY,KAA0C,CAAA;AACnE,eAAO,MAAM,QAAQ,KAA6B,CAAA;AAClD,eAAO,MAAM,WAAW,KAAgC,CAAA;AAGxD,eAAO,MAAM,WAAW,KAAyB,CAAA;AACjD,eAAO,MAAM,UAAU,KAAwB,CAAA;AAC/C,eAAO,MAAM,iBAAiB,KAA8B,CAAA;AAC5D,eAAO,MAAM,UAAU,KAAwB,CAAA;AAC/C,eAAO,MAAM,iBAAiB,KAA8B,CAAA;AAC5D,eAAO,MAAM,YAAY,KAA0B,CAAA;AAInD,eAAO,MAAM,aAAa,KAA0B,CAAA;AACpD,eAAO,MAAM,cAAc,KAA2B,CAAA;AACtD,eAAO,MAAM,eAAe,KAA4B,CAAA;AACxD,eAAO,MAAM,eAAe,KAA4B,CAAA;AACxD,eAAO,MAAM,eAAe,KAA4B,CAAA;AACxD,eAAO,MAAM,kBAAkB,KAA+B,CAAA;AAC9D,eAAO,MAAM,oBAAoB,KAAiC,CAAA;AAIlE,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,OAExD,CAAA;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,uBAAuB,QAAO,mBAAmB,EAE7D,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,OAExD,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,KAAG,CAAC,GAAG,SAGzF,CAAA;AAGD,MAAM,MAAM,eAAe,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;AACpF,MAAM,MAAM,oBAAoB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;AACnF,MAAM,MAAM,QAAQ,GAAG,OAAO,iBAAiB,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA"}

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

@@ -0,0 +1,105 @@
+/**
+ * Core Configuration Types
+ *
+ * Base types and interfaces for application configuration system.
+ * These types define the structure but not the values.
+ */
+export interface I18nConfig {
+    supportedLocales: readonly string[];
+    defaultLocale: string;
+    detectionStrategy: readonly ('user_database' | 'cookie' | 'header' | 'default')[];
+    cookie: {
+        name: string;
+        maxAge: number;
+        httpOnly: boolean;
+        secure: 'auto' | boolean;
+        sameSite: 'strict' | 'lax' | 'none';
+        path: string;
+    };
+    namespaces: readonly string[];
+    performance: {
+        lazyLoadNamespaces: boolean;
+        preloadCriticalNamespaces: readonly string[];
+        enableFallbackChaining: boolean;
+    };
+}
+export interface UserRolesConfig {
+    defaultRole: string;
+    availableRoles: readonly string[];
+    hierarchy: Record<string, number>;
+    displayNames: Record<string, string>;
+}
+export interface FeaturesConfig {
+    enableAnalytics: boolean;
+    enableNotifications: boolean;
+    enableBilling: boolean;
+    enableTeamFeatures: boolean;
+    enableAdvancedSecurity: boolean;
+    enableAPIAccess: boolean;
+}
+export interface ApiConfig {
+    cors: {
+        allowedOrigins: {
+            development: string[];
+            production: string[];
+        };
+        allowAllOrigins: {
+            development: boolean;
+            production: boolean;
+        };
+        /**
+         * Theme extension pattern for CORS origins
+         * Use this to add theme-specific origins without duplicating core defaults
+         * These are merged with core allowedOrigins at runtime
+         */
+        additionalOrigins?: {
+            development?: readonly string[];
+            production?: readonly string[];
+        };
+    };
+}
+export interface UiConfig {
+    theme: {
+        defaultMode: 'light' | 'dark' | 'system';
+        allowUserToggle: boolean;
+    };
+    notifications: {
+        position: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+        maxVisible: number;
+        autoHideDuration: number;
+    };
+}
+export interface AppMetadata {
+    name: string;
+    version: string;
+    description: string;
+    contact: {
+        email: string;
+        website: string;
+        documentation: string;
+    };
+}
+export interface EnvironmentConfig {
+    enableDebugLogs: boolean;
+    enableTranslationDebugging: boolean;
+    strictTypeChecking: boolean;
+    enablePerformanceMonitoring: boolean;
+}
+export interface ApplicationConfig {
+    i18n: I18nConfig;
+    app: AppMetadata;
+    userRoles: UserRolesConfig;
+    features: FeaturesConfig;
+    api: ApiConfig;
+    ui: UiConfig;
+    environments: {
+        development: EnvironmentConfig;
+        production: EnvironmentConfig;
+    };
+}
+export type SupportedLocaleGeneric<T extends I18nConfig> = T['supportedLocales'][number];
+export type TranslationNamespaceGeneric<T extends I18nConfig> = T['namespaces'][number];
+export type ThemeMode = UiConfig['theme']['defaultMode'];
+export type NotificationPosition = UiConfig['notifications']['position'];
+export type UserRoleGeneric<T extends UserRolesConfig> = T['availableRoles'][number];
+//# sourceMappingURL=config-types.d.ts.map

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

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

package/dist/lib/config/config-utils.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Core Configuration Utilities
+ *
+ * Core utility functions for configuration validation and runtime helpers.
+ * These functions work with any configuration that follows the defined interfaces.
+ */
+import type { ApplicationConfig, I18nConfig, EnvironmentConfig } from './config-types';
+/**
+ * Get current environment configuration
+ */
+export declare function getEnvConfig(config: ApplicationConfig): EnvironmentConfig;
+/**
+ * Check if we're in development mode
+ */
+export declare function isDevelopment(): boolean;
+/**
+ * Check if we're in production mode
+ */
+export declare function isProduction(): boolean;
+/**
+ * Validate I18n configuration
+ */
+export declare function validateI18nConfig(config: I18nConfig): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Validate complete application configuration
+ */
+export declare function validateApplicationConfig(config: ApplicationConfig): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get allowed CORS origins for current environment
+ */
+export declare function getAllowedCorsOrigins(config: ApplicationConfig): string[];
+/**
+ * Check if all origins are allowed for CORS in current environment
+ */
+export declare function isCorsAllowAllOrigins(config: ApplicationConfig): boolean;
+/**
+ * Get user role hierarchy level
+ */
+export declare function getRoleHierarchy(config: ApplicationConfig, role: string): number;
+/**
+ * Check if a role has higher or equal permissions than another
+ */
+export declare function hasRolePermission(config: ApplicationConfig, userRole: string, requiredRole: string): boolean;
+/**
+ * Get feature flag value with environment fallback
+ */
+export declare function getFeatureFlag(config: ApplicationConfig, featureName: keyof ApplicationConfig['features']): boolean;
+/**
+ * Log configuration status (development only)
+ */
+export declare function debugConfig(config: ApplicationConfig): void;
+//# sourceMappingURL=config-utils.d.ts.map

package/dist/lib/config/config-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/config/config-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAMtF;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAGzE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B3F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAmCzG;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAGzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAGxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAI5G;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC,UAAU,CAAC,GAAG,OAAO,CAEnH;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAkB3D"}