@nextsparkjs/core 0.1.0-beta.13 → 0.1.0-beta.130

package/dist/lib/test/utils.d.ts

@@ -1,24 +1,10 @@
 /**
  * Testing Utilities
  * Helper functions for consistent testing attribute generation
- */
-/**
- * Create consistent test IDs following the pattern: [component]-[element]-[action?]
- *
- * @param component - Main component name (e.g., 'task', 'nav', 'user')
- * @param element - Element type (e.g., 'card', 'button', 'input')
- * @param action - Optional action (e.g., 'delete', 'edit', 'toggle')
- * @returns Test ID string or undefined in production
- */
-export declare function createTestId(component: string, element: string, action?: string): string | undefined;
-/**
- * Create Cypress-specific IDs following the pattern: [domain]-[element]
  *
- * @param domain - Application domain (e.g., 'todo', 'nav', 'user')
- * @param element - Element identifier (e.g., 'item', 'button', 'menu')
- * @returns Cypress ID string or undefined in production
+ * NOTE: For data-cy selectors, use sel() from '@nextsparkjs/core/selectors'
+ * This file contains runtime utilities for accessibility and keyboard handling.
  */
-export declare function createCyId(domain: string, element: string): string | undefined;
 /**
  * Create state-based data attributes for conditional testing
  *
@@ -57,44 +43,6 @@ export declare function createTestingProps(config: {
  * @returns Formatted aria-label
  */
 export declare function createAriaLabel(template: string, values: Record<string, string | number | boolean>): string;
-/**
- * Common testing patterns for different component types
- */
-export declare const testingPatterns: {
-    task: {
-        card: (taskId: string) => {
-            [k: string]: string;
-        };
-        checkbox: () => {
-            [k: string]: string;
-        };
-        title: () => {
-            [k: string]: string;
-        };
-        deleteButton: () => {
-            [k: string]: string;
-        };
-    };
-    nav: {
-        searchDropdown: () => {
-            [k: string]: string;
-        };
-        notifications: () => {
-            [k: string]: string;
-        };
-        userMenu: () => {
-            [k: string]: string;
-        };
-    };
-    form: {
-        input: (fieldName: string) => {
-            [k: string]: string;
-        };
-        submitButton: () => {
-            [k: string]: string;
-        };
-    };
-};
 /**
  * Keyboard navigation helpers
  */
@@ -112,104 +60,4 @@ export declare const keyboardHelpers: {
      */
     createArrowNavigationHandler: (currentIndex: number, maxIndex: number, onIndexChange: (index: number) => void) => (e: React.KeyboardEvent) => void;
 };
-/**
- * Create entity-specific Cypress ID following the convention: {slug}-{component}-{detail?}
- *
- * @param entitySlug - Entity slug from config (e.g., 'squads', 'people', 'projects')
- * @param component - Component type (e.g., 'form', 'field', 'section', 'table')
- * @param detail - Optional detail (e.g., field name, section name, action)
- * @returns Cypress ID string or undefined in production
- *
- * @example
- * createEntityCyId('squads', 'form')           // 'squads-form'
- * createEntityCyId('squads', 'field', 'name')  // 'squads-field-name'
- * createEntityCyId('squads', 'form', 'submit') // 'squads-form-submit'
- */
-export declare function createEntityCyId(entitySlug: string, component: string, detail?: string): string | undefined;
-/**
- * Entity testing helper interface
- */
-export interface EntityTestingHelper {
-    /** Generic selector: {slug}-{component}-{detail?} - Use for custom/non-standard selectors */
-    get: (component: string, detail?: string) => string | undefined;
-    /** {slug}-page */
-    page: () => string | undefined;
-    /** {slug}-form-page */
-    formPage: () => string | undefined;
-    /** {slug}-form */
-    form: () => string | undefined;
-    /** {slug}-form-submit */
-    formSubmit: () => string | undefined;
-    /** {slug}-form-cancel */
-    formCancel: () => string | undefined;
-    /** {slug}-field-{name} */
-    field: (name: string) => string | undefined;
-    /** {slug}-field-{name}-option-{value} */
-    fieldOption: (name: string, value: string) => string | undefined;
-    /** {slug}-field-{name}-error */
-    fieldError: (name: string) => string | undefined;
-    /** {slug}-section-{name} */
-    section: (name: string) => string | undefined;
-    /** {slug}-card-{id} */
-    card: (id: string) => string | undefined;
-    /** {slug}-table */
-    table: () => string | undefined;
-    /** {slug}-row-{id} */
-    row: (id: string) => string | undefined;
-    /** {slug}-create-btn */
-    createBtn: () => string | undefined;
-    /** {slug}-search-input */
-    searchInput: () => string | undefined;
-    /** {slug}-filter-{field} */
-    filter: (field: string) => string | undefined;
-    /** {slug}-filter-{field}-trigger */
-    filterTrigger: (field: string) => string | undefined;
-    /** {slug}-filter-{field}-option-{value} */
-    filterOption: (field: string, value: string) => string | undefined;
-    /** {slug}-action-{action}-{id} */
-    action: (action: string, id: string) => string | undefined;
-    /** {slug}-actions-trigger-{id} */
-    actionsTrigger: (id: string) => string | undefined;
-    /** {slug}-confirm-delete */
-    confirmDelete: () => string | undefined;
-    /** {slug}-confirm-delete-btn */
-    confirmDeleteBtn: () => string | undefined;
-    /** {slug}-cancel-delete-btn */
-    cancelDeleteBtn: () => string | undefined;
-}
-/**
- * Create a testing helper factory for a specific entity.
- * Uses the entity slug from config to generate consistent data-cy selectors.
- *
- * Convention: {slug}-{component}-{detail}
- *
- * @param entitySlug - Entity slug from EntityConfig (e.g., 'squads', 'people')
- * @returns EntityTestingHelper with pre-bound selector generators
- *
- * @example
- * // In your component file:
- * import { createEntityTestingHelper } from './'
- * import { squadsEntityConfig } from './squads.config'
- *
- * const testId = createEntityTestingHelper(squadsEntityConfig.slug)
- *
- * // Usage in JSX:
- * <div data-cy={testId.formPage()}>           // squads-form-page
- *   <form data-cy={testId.form()}>            // squads-form
- *     <div data-cy={testId.section('basic')}> // squads-section-basic
- *       <input data-cy={testId.field('name')} /> // squads-field-name
- *     </div>
- *     <button data-cy={testId.formSubmit()}>  // squads-form-submit
- *       Submit
- *     </button>
- *   </form>
- * </div>
- *
- * // Card example:
- * <Card data-cy={testId.card(squad.id)}>     // squads-card-{id}
- *
- * // Custom selector example (for non-standard selectors):
- * <div data-cy={testId.get('color-preset', color)}>  // squads-color-preset-{color}
- */
-export declare function createEntityTestingHelper(entitySlug: string): EntityTestingHelper;
 //# sourceMappingURL=utils.d.ts.map

package/dist/lib/test/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/test/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/test/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAC9D,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;IAChE,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;;EA+BA;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAChD,MAAM,CAIR;AAMD;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;0CACmC,MAAM,IAAI,MACtC,GAAG,KAAK,CAAC,aAAa;IAQhC;;OAEG;mCAC4B,MAAM,IAAI,MAC/B,GAAG,KAAK,CAAC,aAAa;IAQhC;;OAEG;iDAEa,MAAM,YACV,MAAM,iBACD,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,MAE9B,GAAG,KAAK,CAAC,aAAa;CAajC,CAAA"}

package/dist/lib/test/utils.js

@@ -1,15 +1,6 @@
 const isDevelopment = process.env.NODE_ENV === "development";
 const isTest = process.env.NODE_ENV === "test";
 const enableTestingAttributes = isDevelopment || isTest;
-function createTestId(component, element, action) {
-  if (!enableTestingAttributes) return void 0;
-  const parts = [component, element, action].filter(Boolean);
-  return parts.join("-");
-}
-function createCyId(domain, element) {
-  if (!enableTestingAttributes) return void 0;
-  return `${domain}-${element}`;
-}
 function createStateAttr(state) {
   return state;
 }
@@ -45,54 +36,6 @@ function createAriaLabel(template, values) {
     return String(values[key] ?? match);
   });
 }
-const testingPatterns = {
-  // Task/Todo components
-  task: {
-    card: (taskId) => createTestingProps({
-      testId: createTestId("task", "card"),
-      cyId: createCyId("task", "item"),
-      taskId
-    }),
-    checkbox: () => createTestingProps({
-      testId: createTestId("task", "checkbox"),
-      cyId: createCyId("task", "toggle")
-    }),
-    title: () => createTestingProps({
-      testId: createTestId("task", "title"),
-      cyId: createCyId("task", "title")
-    }),
-    deleteButton: () => createTestingProps({
-      testId: createTestId("task", "delete", "button"),
-      cyId: createCyId("task", "delete")
-    })
-  },
-  // Navigation components
-  nav: {
-    searchDropdown: () => createTestingProps({
-      testId: createTestId("nav", "search", "dropdown"),
-      cyId: createCyId("nav", "search")
-    }),
-    notifications: () => createTestingProps({
-      testId: createTestId("nav", "notifications", "button"),
-      cyId: createCyId("nav", "notifications")
-    }),
-    userMenu: () => createTestingProps({
-      testId: createTestId("nav", "user", "menu"),
-      cyId: createCyId("nav", "user-menu")
-    })
-  },
-  // Form components
-  form: {
-    input: (fieldName) => createTestingProps({
-      testId: createTestId("form", fieldName, "input"),
-      cyId: createCyId("form", fieldName)
-    }),
-    submitButton: () => createTestingProps({
-      testId: createTestId("form", "submit", "button"),
-      cyId: createCyId("form", "submit")
-    })
-  }
-};
 const keyboardHelpers = {
   /**
    * Handle Enter and Space key activation
@@ -134,57 +77,10 @@ const keyboardHelpers = {
     };
   }
 };
-function createEntityCyId(entitySlug, component, detail) {
-  if (!enableTestingAttributes) return void 0;
-  const parts = [entitySlug, component, detail].filter(Boolean);
-  return parts.join("-");
-}
-function createEntityTestingHelper(entitySlug) {
-  return {
-    // Generic (framework-agnostic)
-    get: (component, detail) => createEntityCyId(entitySlug, component, detail),
-    // Page
-    page: () => createEntityCyId(entitySlug, "page"),
-    formPage: () => createEntityCyId(entitySlug, "form-page"),
-    // Form
-    form: () => createEntityCyId(entitySlug, "form"),
-    formSubmit: () => createEntityCyId(entitySlug, "form-submit"),
-    formCancel: () => createEntityCyId(entitySlug, "form-cancel"),
-    // Fields
-    field: (name) => createEntityCyId(entitySlug, "field", name),
-    fieldOption: (name, value) => createEntityCyId(entitySlug, `field-${name}-option`, value),
-    fieldError: (name) => createEntityCyId(entitySlug, `field-${name}`, "error"),
-    // Sections
-    section: (name) => createEntityCyId(entitySlug, "section", name),
-    // Card
-    card: (id) => createEntityCyId(entitySlug, "card", id),
-    // List/Table
-    table: () => createEntityCyId(entitySlug, "table"),
-    row: (id) => createEntityCyId(entitySlug, "row", id),
-    createBtn: () => createEntityCyId(entitySlug, "create-btn"),
-    searchInput: () => createEntityCyId(entitySlug, "search-input"),
-    // Filters
-    filter: (field) => createEntityCyId(entitySlug, "filter", field),
-    filterTrigger: (field) => createEntityCyId(entitySlug, `filter-${field}`, "trigger"),
-    filterOption: (field, value) => createEntityCyId(entitySlug, `filter-${field}-option`, value),
-    // Actions
-    action: (action, id) => createEntityCyId(entitySlug, `action-${action}`, id),
-    actionsTrigger: (id) => createEntityCyId(entitySlug, "actions-trigger", id),
-    // Dialogs
-    confirmDelete: () => createEntityCyId(entitySlug, "confirm-delete"),
-    confirmDeleteBtn: () => createEntityCyId(entitySlug, "confirm-delete-btn"),
-    cancelDeleteBtn: () => createEntityCyId(entitySlug, "cancel-delete-btn")
-  };
-}
 export {
   createAriaLabel,
-  createCyId,
-  createEntityCyId,
-  createEntityTestingHelper,
   createPriorityAttr,
   createStateAttr,
-  createTestId,
   createTestingProps,
-  keyboardHelpers,
-  testingPatterns
+  keyboardHelpers
 };

package/dist/lib/theme/ThemeProvider.js

@@ -1,9 +1,9 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
 import React, { createContext, useContext, useEffect, useState } from "react";
-import { ThemeService } from "../services/theme.service";
-import { ImportResolverProvider } from "./import-resolver";
-import { applyThemeStyles } from "./theme-loader";
+import { ThemeService } from "../services/theme.service.js";
+import { ImportResolverProvider } from "./import-resolver.js";
+import { applyThemeStyles } from "./theme-loader.js";
 const ThemeContext = createContext(null);
 function ThemeProvider({ children, defaultTheme = "default" }) {
   const [currentTheme, setCurrentTheme] = useState(null);

package/dist/lib/theme/get-default-theme-mode.d.ts

@@ -6,9 +6,20 @@
  * 2. User not logged in → use defaultMode from theme.config
  */
 type ThemeMode = 'light' | 'dark' | 'system';
+export interface ThemeSettings {
+    defaultMode: ThemeMode;
+    allowUserToggle: boolean;
+}
+/**
+ * Get theme settings for the RootLayout
+ * Returns defaultMode and whether user can toggle theme
+ * Server-side only function
+ */
+export declare function getThemeSettings(): Promise<ThemeSettings>;
 /**
  * Get the default theme mode for the current user
  * Server-side only function
+ * @deprecated Use getThemeSettings() instead for full theme configuration
  */
 export declare function getDefaultThemeMode(): Promise<ThemeMode>;
 export {};

package/dist/lib/theme/get-default-theme-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-default-theme-mode.d.ts","sourceRoot":"","sources":["../../../src/lib/theme/get-default-theme-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,KAAK,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE5C;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,SAAS,CAAC,CA+C9D"}
+{"version":3,"file":"get-default-theme-mode.d.ts","sourceRoot":"","sources":["../../../src/lib/theme/get-default-theme-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,KAAK,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE5C,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,SAAS,CAAA;IACtB,eAAe,EAAE,OAAO,CAAA;CACzB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAqB/D;AA8CD;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,SAAS,CAAC,CAG9D"}

package/dist/lib/theme/get-default-theme-mode.js

@@ -1,42 +1,59 @@
-import { auth } from "../auth";
-import { ThemeService } from "../services/theme.service";
+import { auth } from "../auth.js";
+import { ThemeService } from "../services/theme.service.js";
 import { headers } from "next/headers";
-async function getDefaultThemeMode() {
+async function getThemeSettings() {
+  var _a, _b;
+  const activeThemeName = process.env.NEXT_PUBLIC_ACTIVE_THEME || "default";
+  const themeConfig = ThemeService.getByName(activeThemeName);
+  const appConfig = ThemeService.getAppConfig(activeThemeName);
+  const allowUserToggle = ((_b = (_a = appConfig == null ? void 0 : appConfig.ui) == null ? void 0 : _a.theme) == null ? void 0 : _b.allowUserToggle) ?? true;
+  const configDefaultMode = (themeConfig == null ? void 0 : themeConfig.defaultMode) || "system";
+  if (allowUserToggle) {
+    const userTheme = await getUserThemePreference();
+    if (userTheme) {
+      return { defaultMode: userTheme, allowUserToggle };
+    }
+  }
+  return { defaultMode: configDefaultMode, allowUserToggle };
+}
+const VALID_THEME_MODES = ["light", "dark", "system"];
+function isValidThemeMode(value) {
+  return typeof value === "string" && VALID_THEME_MODES.includes(value);
+}
+async function getUserThemePreference() {
   var _a, _b, _c;
   try {
     const session = await auth.api.getSession({
       headers: await headers()
     });
     if ((_a = session == null ? void 0 : session.user) == null ? void 0 : _a.id) {
-      try {
-        const baseUrl = process.env.NEXT_PUBLIC_APP_URL || "http://localhost:5173";
-        const response = await fetch(`${baseUrl}/api/user/profile?includeMeta=true`, {
-          headers: {
-            cookie: (await headers()).get("cookie") || ""
-          },
-          cache: "no-store"
-        });
-        if (response.ok) {
-          const data = await response.json();
-          if ((_c = (_b = data.meta) == null ? void 0 : _b.uiPreferences) == null ? void 0 : _c.theme) {
-            const userTheme = data.meta.uiPreferences.theme;
-            return userTheme;
-          }
+      const baseUrl = process.env.NEXT_PUBLIC_APP_URL || "http://localhost:5173";
+      const response = await fetch(`${baseUrl}/api/user/profile?includeMeta=true`, {
+        headers: {
+          cookie: (await headers()).get("cookie") || ""
+        },
+        cache: "no-store"
+      });
+      if (response.ok) {
+        const data = await response.json();
+        const theme = (_c = (_b = data.meta) == null ? void 0 : _b.uiPreferences) == null ? void 0 : _c.theme;
+        if (isValidThemeMode(theme)) {
+          return theme;
         }
-      } catch (error) {
       }
     }
   } catch (error) {
+    if (process.env.NODE_ENV === "development") {
+      console.warn("[getThemeSettings] Failed to fetch user preference:", error);
+    }
   }
-  try {
-    const activeThemeName = process.env.NEXT_PUBLIC_ACTIVE_THEME || "default";
-    const themeConfig = ThemeService.getByName(activeThemeName);
-    const defaultMode = (themeConfig == null ? void 0 : themeConfig.defaultMode) || "system";
-    return defaultMode;
-  } catch (error) {
-    return "system";
-  }
+  return null;
+}
+async function getDefaultThemeMode() {
+  const { defaultMode } = await getThemeSettings();
+  return defaultMode;
 }
 export {
-  getDefaultThemeMode
+  getDefaultThemeMode,
+  getThemeSettings
 };

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

@@ -1 +1 @@
-{"version":3,"file":"theme-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/theme/theme-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAIpD;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,SAAS,IAAI,WAAW,EAAE,CAEzC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAUrE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAqC/E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA8BtE;AAwED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CA2CzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAOA;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB5F"}
+{"version":3,"file":"theme-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/theme/theme-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAIpD;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,SAAS,IAAI,WAAW,EAAE,CAEzC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAUrE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAqC/E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA8BtE;AAmFD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CA2CzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAOA;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB5F"}

package/dist/lib/theme/theme-loader.js

@@ -1,5 +1,5 @@
-import { ThemeService } from "../services/theme.service";
-import { preloadThemeOverrides, clearOverrideCache } from "./override-resolver";
+import { ThemeService } from "../services/theme.service.js";
+import { preloadThemeOverrides, clearOverrideCache } from "./override-resolver.js";
 function getThemes() {
   return ThemeService.getAll();
 }
@@ -78,24 +78,29 @@ function applyColorVariables(colors) {
     root.style.setProperty(`--theme-color-${key}`, String(value));
   });
 }
+function hasJSColors(theme) {
+  var _a, _b;
+  return !!(((_a = theme.config) == null ? void 0 : _a.colors) || ((_b = theme.config) == null ? void 0 : _b.darkColors));
+}
 function applyCurrentModeColors(theme) {
   var _a, _b;
+  if (!hasJSColors(theme)) return;
   const darkMode = isDarkMode();
   const colors = darkMode && ((_a = theme.config) == null ? void 0 : _a.darkColors) ? theme.config.darkColors : (_b = theme.config) == null ? void 0 : _b.colors;
   if (colors) {
     applyColorVariables(colors);
-    console.log(`[Theme] Applied ${darkMode ? "dark" : "light"} mode colors for theme: ${theme.name}`);
   }
 }
 function setupDarkModeObserver(theme) {
   if (typeof window === "undefined") return;
   if (darkModeObserver) {
     darkModeObserver.disconnect();
+    darkModeObserver = null;
   }
+  if (!hasJSColors(theme)) return;
   darkModeObserver = new MutationObserver((mutations) => {
     for (const mutation of mutations) {
       if (mutation.attributeName === "class") {
-        console.log("[Theme] Dark mode class changed, reapplying colors");
         applyCurrentModeColors(theme);
       }
     }
@@ -104,7 +109,6 @@ function setupDarkModeObserver(theme) {
     attributes: true,
     attributeFilter: ["class"]
   });
-  console.log("[Theme] Dark mode observer initialized");
 }
 function applyThemeStyles(theme) {
   var _a, _b, _c;

package/dist/lib/translations/i18n-integration.js

@@ -1,6 +1,6 @@
-import { TranslationService } from "../services/translation.service";
-import { loadMergedTranslations } from "./registry";
-import { getAllEntityConfigs, ensureInitialized } from "../entities/registry";
+import { TranslationService } from "../services/translation.service.js";
+import { loadMergedTranslations } from "./registry.js";
+import { getAllEntityConfigs, ensureInitialized } from "../entities/registry.js";
 async function loadAllI18nTranslations(locale) {
   try {
     await ensureEntitiesInitialized();
@@ -41,7 +41,7 @@ function getOptimizedNamespaces(pathname) {
     if (pathname.startsWith("/dashboard")) {
       console.log(`[i18n-integration] \u{1F4F1} Dashboard detected \u2192 Loading authenticated user namespaces`);
       return {
-        core: ["common", "dashboard", "settings", "public", "validation", "teams"],
+        core: ["common", "dashboard", "settings", "public", "validation", "teams", "admin"],
         entities: [],
         // Entities will be loaded dynamically
         strategy: "DASHBOARD_AUTHENTICATED"

package/dist/lib/translations/registry.d.ts

@@ -24,6 +24,8 @@ export declare function registerThemeMessages(locale: string, messages: Record<s
  * 1. Core translations provide the base
  * 2. Theme translations can override/extend core
  * 3. Entity translations can override/extend both (highest priority)
+ *
+ * Uses globalThis cache to prevent re-loading on each request
  */
 export declare function loadMergedTranslations(locale: SupportedLocale): Promise<Record<string, unknown>>;
 //# sourceMappingURL=registry.d.ts.map

package/dist/lib/translations/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/translations/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AA2ExD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE7F;AAiDD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkClC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/translations/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AA+FxD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE7F;AAmDD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4DlC"}

package/dist/lib/translations/registry.js

@@ -1,4 +1,12 @@
-import { TranslationService } from "../services/translation.service";
+import { TranslationService } from "../services/translation.service.js";
+const DEBUG_I18N = process.env.NEXTSPARK_DEBUG_I18N === "true";
+const globalCache = globalThis;
+function getTranslationCache() {
+  if (!globalCache.__nextspark_translations_cache) {
+    globalCache.__nextspark_translations_cache = /* @__PURE__ */ new Map();
+  }
+  return globalCache.__nextspark_translations_cache;
+}
 function deepMergeMessages(target, source) {
   const result = { ...target };
   for (const key of Object.keys(source)) {
@@ -56,11 +64,25 @@ async function loadEntityTranslationsFromRegistry(locale) {
     const entityTranslations = await TranslationService.loadAllEntities(activeTheme, locale);
     return entityTranslations;
   } catch (error) {
-    console.warn(`[translations] Failed to load entity translations for ${locale}:`, error);
+    if (DEBUG_I18N) {
+      console.warn(`[translations] Failed to load entity translations for ${locale}:`, error);
+    }
     return {};
   }
 }
 async function loadMergedTranslations(locale) {
+  const activeTheme = process.env.NEXT_PUBLIC_ACTIVE_THEME || "default";
+  const cacheKey = `${locale}-${activeTheme}`;
+  const cache = getTranslationCache();
+  if (cache.has(cacheKey)) {
+    if (DEBUG_I18N) {
+      console.log(`[i18n] Cache hit for ${cacheKey}`);
+    }
+    return cache.get(cacheKey);
+  }
+  if (DEBUG_I18N) {
+    console.log(`[i18n] Loading translations for ${cacheKey}`);
+  }
   const fallbackChain = getLocaleFallbackChain(locale);
   let mergedMessages = {};
   for (const fallbackLocale of [...fallbackChain].reverse()) {
@@ -74,7 +96,9 @@ async function loadMergedTranslations(locale) {
     const themeMessages = await loadThemeTranslations(locale);
     mergedMessages = deepMergeMessages(mergedMessages, themeMessages);
   } catch {
-    console.warn(`[translations] No theme messages for ${locale}`);
+    if (DEBUG_I18N) {
+      console.warn(`[translations] No theme messages for ${locale}`);
+    }
   }
   try {
     const entityMessages = await loadEntityTranslationsFromRegistry(locale);
@@ -83,6 +107,10 @@ async function loadMergedTranslations(locale) {
     }
   } catch {
   }
+  cache.set(cacheKey, mergedMessages);
+  if (DEBUG_I18N) {
+    console.log(`[i18n] Cached translations for ${cacheKey} with ${Object.keys(mergedMessages).length} namespaces`);
+  }
   return mergedMessages;
 }
 export {

package/dist/lib/user-data.d.ts

@@ -8,23 +8,41 @@ import type { PlanType, UserFlag } from './entities/types';
 import type { SessionUser } from './auth';
 /**
  * Interface for user plan and flag data
+ * @property plan - User's subscription plan type (free, starter, premium)
+ * @property flags - Array of feature flags assigned to the user
+ * @property cached - Whether this data was retrieved from cache vs database
  */
 export interface UserPlanData {
     plan: PlanType;
     flags: UserFlag[];
     cached: boolean;
 }
+/**
+ * Custom error class for user data operations
+ */
+export declare class UserDataError extends Error {
+    readonly userId: string;
+    readonly operation: string;
+    readonly originalError?: unknown;
+    constructor(message: string, userId: string, operation: string, originalError?: unknown);
+}
 /**
  * Get user plan and flags from database
  * Uses user_metas table to store plan and flags data
+ *
+ * @throws UserDataError in production when database operations fail
  */
 export declare function getUserPlanAndFlags(userId: string): Promise<UserPlanData>;
 /**
  * Update user plan in database
+ *
+ * @throws UserDataError in production when database operations fail
  */
 export declare function updateUserPlan(userId: string, plan: PlanType): Promise<boolean>;
 /**
  * Update user flags in database
+ *
+ * @throws UserDataError in production when database operations fail
  */
 export declare function updateUserFlags(userId: string, flags: UserFlag[]): Promise<boolean>;
 /**

package/dist/lib/user-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-data.d.ts","sourceRoot":"","sources":["../../src/lib/user-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAgBzC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB;AAYD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA0E/E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBrF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBzF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG;IACrF,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB,CAAC,CAQD"}
+{"version":3,"file":"user-data.d.ts","sourceRoot":"","sources":["../../src/lib/user-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AA6CzC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB;AAGD;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;aACd,SAAS,EAAE,MAAM;aACjB,aAAa,CAAC,EAAE,OAAO;gBAHvC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO;CAK1C;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAmH/E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA+DrF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA+DzF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG;IACrF,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB,CAAC,CAQD"}