@pure-ds/core 0.5.19 → 0.5.21

package/src/js/pds-core/pds-live.js

@@ -13,7 +13,6 @@ import {
   ensureAbsoluteAssetURL,
   ensureTrailingSlash,
   attachFoucListener,
-  createSetTheme,
   normalizeInitConfig,
   resolveRuntimeAssetRoot,
   resolveThemeAndApply,
@@ -74,10 +73,6 @@ async function __attachLiveAPIs(PDS, { applyResolvedTheme, setupSystemListenerIf
     return await queryEngine.search(question);
   };
 
-  // Expose internal theme helpers for configurator usage
-  PDS._applyResolvedTheme = applyResolvedTheme;
-  PDS._setupSystemListenerIfNeeded = setupSystemListenerIfNeeded;
-
   // Live-only compiled getter
   if (!Object.getOwnPropertyDescriptor(PDS, "compiled")) {
     Object.defineProperty(PDS, "compiled", {
@@ -92,27 +87,6 @@ async function __attachLiveAPIs(PDS, { applyResolvedTheme, setupSystemListenerIf
     });
   }
 
-  // Live-only setTheme helper
-  PDS.setTheme = createSetTheme({
-    PDS,
-    defaultStorageKey: "pure-ds-theme",
-    setupSystemListenerIfNeeded,
-    onApply: async ({ resolvedTheme }) => {
-      if (PDS.registry.isLive && Generator.instance) {
-        try {
-          const currentGenerator = Generator.instance;
-          if (currentGenerator && currentGenerator.configure) {
-            const newConfig = { ...currentGenerator.config, theme: resolvedTheme };
-            currentGenerator.configure(newConfig);
-            await applyStyles(Generator.instance);
-          }
-        } catch (error) {
-          console.warn("Failed to update styles for new theme:", error);
-        }
-      }
-    },
-  });
-
   // Live-only preload helper
   PDS.preloadCritical = function(config, options = {}) {
     if (typeof window === "undefined" || !document.head || !config) {

package/src/js/pds-core/pds-start-helpers.js

@@ -272,66 +272,6 @@ export function resolveThemeAndApply({ manageTheme, themeStorageKey, applyResolv
   return { resolvedTheme, storedTheme };
 }
 
-// Internal: create a reusable setTheme helper for live/static modes
-export function createSetTheme({
-  PDS,
-  defaultStorageKey = "pure-ds-theme",
-  setupSystemListenerIfNeeded,
-  onApply,
-} = {}) {
-  return async function setTheme(theme, options = {}) {
-    const { storageKey = defaultStorageKey, persist = true } = options;
-
-    if (!["light", "dark", "system"].includes(theme)) {
-      throw new Error(
-        `Invalid theme "${theme}". Must be "light", "dark", or "system".`
-      );
-    }
-
-    if (typeof window === "undefined") {
-      return theme === "system" ? "light" : theme;
-    }
-
-    let resolvedTheme = theme;
-    if (theme === "system") {
-      const prefersDark =
-        window.matchMedia &&
-        window.matchMedia("(prefers-color-scheme: dark)").matches;
-      resolvedTheme = prefersDark ? "dark" : "light";
-    }
-
-    document.documentElement.setAttribute("data-theme", resolvedTheme);
-
-    if (persist) {
-      try {
-        localStorage.setItem(storageKey, theme);
-      } catch (e) {}
-    }
-
-    try {
-      setupSystemListenerIfNeeded?.(theme);
-    } catch (e) {}
-
-    if (typeof onApply === "function") {
-      await onApply({ theme, resolvedTheme });
-    }
-
-    try {
-      PDS?.dispatchEvent(
-        new CustomEvent("pds:theme:changed", {
-          detail: {
-            theme: resolvedTheme,
-            requested: theme,
-            source: "programmatic",
-          },
-        })
-      );
-    } catch (e) {}
-
-    return resolvedTheme;
-  };
-}
-
 export function resolveRuntimeAssetRoot(config, { resolvePublicAssetURL }) {
   const hasCustomRoot = Boolean(config?.public?.root || config?.static?.root);
   let candidate = resolvePublicAssetURL(config);

package/src/js/pds.d.ts

@@ -298,7 +298,6 @@ export class PDS extends EventTarget {
   readonly autoDefiner?: any;
 
   // Instance helpers
-  setTheme?(theme: 'light' | 'dark' | 'system', options?: { storageKey?: string; persist?: boolean }): Promise<string>;
   preloadCritical?(config: any, options?: { theme?: string; layers?: string[] }): void;
 }
 

package/src/js/pds.js

@@ -42,6 +42,7 @@ const PDS = new PDSBase();
 // State properties
 PDS.initializing = false;
 PDS.currentPreset = null;
+PDS.debug = false;
 
 import {
   adoptLayers,
@@ -57,7 +58,6 @@ import {
   ensureAbsoluteAssetURL,
   ensureTrailingSlash,
   attachFoucListener,
-  createSetTheme,
   normalizeInitConfig,
   resolveRuntimeAssetRoot,
   resolveThemeAndApply,
@@ -73,14 +73,21 @@ const __slugifyPreset = (str = "") =>
     .replace(/^-+|-+$/g, "");
 
 const __defaultLog = function (level = "log", message, ...data) {
-  const debug = this?.debug || this?.design?.debug || false;
-  if (debug || level === "error" || level === "warn") {
-    const method = console[level] || console.log;
-    if (data.length > 0) {
-      method(message, ...data);
-    } else {
-      method(message);
-    }
+  const isStaticMode = Boolean(PDS.registry && !PDS.registry.isLive);
+  const debug =
+    (this?.debug || this?.design?.debug || PDS.debug || false) === true;
+
+  if (isStaticMode) {
+    if (!PDS.debug) return;
+  } else if (!debug && level !== "error" && level !== "warn") {
+    return;
+  }
+
+  const method = console[level] || console.log;
+  if (data.length > 0) {
+    method(message, ...data);
+  } else {
+    method(message);
   }
 };
 
@@ -110,7 +117,6 @@ PDS.adoptPrimitives = adoptPrimitives;
 /** Create a constructable CSSStyleSheet from a CSS string */
 PDS.createStylesheet = createStylesheet;
 
-
 /** Return true when running inside a live/designer-backed environment */
 PDS.isLiveMode = () => registry.isLive;
 PDS.ask = ask;
@@ -146,15 +152,6 @@ function __emitPDSReady(detail) {
   }
 }
 
-/** Current configuration (set after PDS.start() completes) - read-only, frozen after initialization */
-Object.defineProperty(PDS, "currentConfig", {
-  value: null,
-  writable: true,
-  enumerable: true,
-  configurable: false,
-});
-
-// Always expose PDS on the window in browser contexts so consumers can access it in both live and static modes
 if (typeof window !== "undefined") {
   // @ts-ignore
   window.PDS = PDS;
@@ -273,10 +270,6 @@ Object.defineProperty(PDS, "theme", {
   },
 });
 
-// Internal theme helpers (used by configurator/live tooling)
-PDS._applyResolvedTheme = __applyResolvedTheme;
-PDS._setupSystemListenerIfNeeded = __setupSystemListenerIfNeeded;
-
 // ----------------------------------------------------------------------------
 // Default Enhancers — first-class citizens alongside AutoDefiner
 // ----------------------------------------------------------------------------
@@ -287,8 +280,6 @@ PDS._setupSystemListenerIfNeeded = __setupSystemListenerIfNeeded;
  */
 PDS.defaultEnhancers = defaultPDSEnhancers;
 
-
-
 /**
  * Initialize PDS in live mode with the given configuration (new unified shape).
  * Typically invoked via PDS.start({ mode: 'live', ... }).
@@ -352,7 +343,6 @@ async function start(config) {
 /** Primary unified entry point */
 PDS.start = start;
 
-
 /**
  * Initialize PDS in static mode with the same unified configuration shape as live mode.
  *
@@ -410,13 +400,6 @@ async function staticInit(config) {
       setupSystemListenerIfNeeded: __setupSystemListenerIfNeeded,
     });
 
-    // 1b) Static-mode setTheme helper (live mode overrides this later)
-      PDS.setTheme = createSetTheme({
-        PDS,
-        defaultStorageKey: themeStorageKey,
-        setupSystemListenerIfNeeded: __setupSystemListenerIfNeeded,
-      });
-
     // Normalize first-arg to allow { preset, design, enhancers }
     const runtimeConfig = await __loadRuntimeConfig(assetRootURL, config);
     const runtimeDesign =
@@ -463,7 +446,10 @@ async function staticInit(config) {
         }
       : config;
 
-    const normalized = normalizeInitConfig(normalizedInput, {}, { presets, defaultLog: __defaultLog });
+    const normalized = normalizeInitConfig(normalizedInput, {}, {
+      presets,
+      defaultLog: __defaultLog,
+    });
     const userEnhancers = normalized.enhancers;
 
     // 2) Derive static asset URLs from the normalized public root
@@ -494,8 +480,7 @@ async function staticInit(config) {
           document.adoptedStyleSheets = [...others, stylesSheet];
         }
       } catch (e) {
-        // No config available in static mode, using console
-        console.warn("Failed to apply static styles:", e);
+        __defaultLog.call(PDS, "warn", "Failed to apply static styles:", e);
       }
     }
 
@@ -514,8 +499,9 @@ async function staticInit(config) {
       autoDefiner = res.autoDefiner;
       mergedEnhancers = res.mergedEnhancers || [];
     } catch (error) {
-      // No config available in static mode, using console
-      console.error(
+      __defaultLog.call(
+        PDS,
+        "error",
         "❌ Failed to initialize AutoDefiner/Enhancers (static):",
         error
       );
@@ -553,8 +539,9 @@ async function staticInit(config) {
 
 // Note: PDS.static is not exported. Use PDS.start({ mode: 'static', ... }).
 
-
 // Note: PDS object is not frozen to allow runtime properties like currentConfig
 // to be set during initialization. The config object itself is frozen for immutability.
 
+export const applyResolvedTheme = __applyResolvedTheme;
+export const setupSystemListenerIfNeeded = __setupSystemListenerIfNeeded;
 export { PDS };