@pure-ds/core 0.5.60 → 0.6.1

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

@@ -246,6 +246,14 @@ export const ontology = {
       tags: ["form", "schema", "auto-generate"],
       category: "form"
     },
+    { 
+      id: "pds-live-edit", 
+      name: "Live Edit", 
+      description: "Contextual live editing for PDS design settings",
+      selectors: ["pds-live-edit"],
+      tags: ["editor", "live", "config", "tooling"],
+      category: "tooling"
+    },
     { 
       id: "pds-splitpanel", 
       name: "Split Panel", 

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

@@ -3,6 +3,8 @@
  * Kept separate to avoid pulling live-only logic into the base runtime bundle.
  */
 
+import { validateDesignConfig, validateInitConfig } from "./pds-config.js";
+
 const __ABSOLUTE_URL_PATTERN__ = /^[a-z][a-z0-9+\-.]*:\/\//i;
 const __MODULE_URL__ = (() => {
   try {
@@ -130,6 +132,11 @@ export function stripFunctions(obj) {
 
 // Internal: normalize first-arg config to a full generator config and extract enhancers if provided inline
 export function normalizeInitConfig(inputConfig = {}, options = {}, { presets, defaultLog }) {
+  const logFn =
+    inputConfig && typeof inputConfig.log === "function"
+      ? inputConfig.log
+      : defaultLog;
+
   // If caller passed a plain design config (legacy), keep as-is
   const hasDesignKeys =
     typeof inputConfig === "object" &&
@@ -167,10 +174,17 @@ export function normalizeInitConfig(inputConfig = {}, options = {}, { presets, d
     "design" in (inputConfig || {}) ||
     "enhancers" in (inputConfig || {});
 
+  if (inputConfig && typeof inputConfig === "object") {
+    validateInitConfig(inputConfig, { log: logFn, context: "PDS.start" });
+  }
+
   let generatorConfig;
   let presetInfo = null;
 
   if (hasNewShape) {
+    if (designOverrides && typeof designOverrides === "object") {
+      validateDesignConfig(designOverrides, { log: logFn, context: "PDS.start" });
+    }
     // Always resolve a preset; default if none provided
     const effectivePreset = String(presetId || "default").toLowerCase();
     const found =
@@ -228,6 +242,7 @@ export function normalizeInitConfig(inputConfig = {}, options = {}, { presets, d
       log: userLog || defaultLog,
     };
   } else if (hasDesignKeys) {
+    validateDesignConfig(inputConfig, { log: logFn, context: "PDS.start" });
     // Back-compat: treat the provided object as the full design, wrap it
     const { log: userLog, ...designConfig } = inputConfig;
     generatorConfig = {

package/src/js/pds-core/pds-theme-utils.js

@@ -0,0 +1,33 @@
+const DEFAULT_THEMES = ["light", "dark"];
+const VALID_THEMES = new Set(DEFAULT_THEMES);
+
+export function normalizePresetThemes(preset) {
+  const themes = Array.isArray(preset?.themes)
+    ? preset.themes.map((theme) => String(theme).toLowerCase())
+    : DEFAULT_THEMES;
+  const normalized = themes.filter((theme) => VALID_THEMES.has(theme));
+  return normalized.length ? normalized : DEFAULT_THEMES;
+}
+
+export function resolveThemePreference(preference, { preferDocument = true } = {}) {
+  const normalized = String(preference || "").toLowerCase();
+  if (VALID_THEMES.has(normalized)) return normalized;
+
+  if (preferDocument && typeof document !== "undefined") {
+    const applied = document.documentElement?.getAttribute("data-theme");
+    if (VALID_THEMES.has(applied)) return applied;
+  }
+
+  if (typeof window !== "undefined" && window.matchMedia) {
+    const prefersDark = window.matchMedia("(prefers-color-scheme: dark)").matches;
+    return prefersDark ? "dark" : "light";
+  }
+
+  return "light";
+}
+
+export function isPresetThemeCompatible(preset, themePreference) {
+  const resolvedTheme = resolveThemePreference(themePreference);
+  const themes = normalizePresetThemes(preset);
+  return themes.includes(resolvedTheme);
+}

package/src/js/pds.d.ts

@@ -104,6 +104,9 @@ export interface CompiledState {
   };
 }
 
+/** Public config types for editor IntelliSense */
+export type PDSInitConfig = import("./pds-core/pds-config.js").PDSInitConfig;
+
 /**
  * Generator - programmatic API to produce tokens, layered CSS and helper modules from a config.
  * Typical usage:
@@ -286,7 +289,6 @@ export class PDS extends EventTarget {
     // live-only
     preloadStyles?: boolean;
     criticalLayers?: string[];
-    applyConfiguratorStyles?: boolean;
     managerURL?: string;
     // static-only
     staticPaths?: Record<string, string>;

package/src/js/pds.js

@@ -68,6 +68,10 @@ import {
   setupAutoDefinerAndEnhancers,
   stripFunctions,
 } from "./pds-core/pds-start-helpers.js";
+import {
+  isPresetThemeCompatible,
+  resolveThemePreference,
+} from "./pds-core/pds-theme-utils.js";
 
 const __slugifyPreset = (str = "") =>
   String(str)
@@ -261,6 +265,24 @@ Object.defineProperty(PDS, "theme", {
   set(value) {
     try {
       if (typeof window === "undefined") return;
+      const currentPreset = PDS.currentConfig?.design || null;
+      const resolvedTheme = resolveThemePreference(value);
+      if (currentPreset && !isPresetThemeCompatible(currentPreset, resolvedTheme)) {
+        const presetName =
+          currentPreset?.name ||
+          PDS.currentPreset?.name ||
+          PDS.currentConfig?.preset ||
+          "current preset";
+        console.warn(
+          `PDS theme "${resolvedTheme}" not supported by preset "${presetName}".`
+        );
+        PDS.dispatchEvent(
+          new CustomEvent("pds:theme:blocked", {
+            detail: { theme: value, resolvedTheme, preset: presetName },
+          })
+        );
+        return;
+      }
       if (value === null || value === undefined) {
         localStorage.removeItem(__themeStorageKey);
       } else {