@pure-ds/core 0.4.37 → 0.5.2

package/dist/types/src/js/pds-core/pds-generator.d.ts

@@ -1,43 +1,47 @@
 /**
- * Adopt primitives stylesheet into a shadow root
- * This is the primary method components should use
+ * Validate a design configuration for accessibility sanity checks.
+ * Currently validates color contrast for primary buttons and base surface text
+ * in both light and dark themes.
  *
- * @param {ShadowRoot} shadowRoot - The shadow root to adopt into
- * @param {CSSStyleSheet[]} additionalSheets - Additional component-specific stylesheets
- * @returns {Promise<void>}
- *
- * @example
- * // In your web component:
- * import { PDS } from 'pure-ds';
- *
- * async connectedCallback() {
- *   this.attachShadow({ mode: 'open' });
- *
- *   const componentStyles = new CSSStyleSheet();
- *   componentStyles.replaceSync(`...your styles...`);
- *
- *   await PDS.adoptPrimitives(this.shadowRoot, [componentStyles]);
- * }
+ * @param {object} designConfig - A full or partial PDS config object
+ * @param {object} [options]
+ * @param {number} [options.minContrast=4.5] - Minimum contrast ratio for normal text
+ * @returns {{ ok: boolean, issues: Array<{path:string, message:string, ratio:number, min:number, context?:string}> }}
  */
-export function adoptPrimitives(shadowRoot: ShadowRoot, additionalSheets?: CSSStyleSheet[]): Promise<void>;
+export function validateDesign(designConfig?: object, options?: {
+    minContrast?: number;
+}): {
+    ok: boolean;
+    issues: Array<{
+        path: string;
+        message: string;
+        ratio: number;
+        min: number;
+        context?: string;
+    }>;
+};
 /**
- * Adopt multiple layers into a shadow root
- * For complex components that need more than just primitives
+ * Validate multiple design configurations at once.
+ * Useful for build-time enforcement of preset compliance.
  *
- * @param {ShadowRoot} shadowRoot - The shadow root to adopt into
- * @param {string[]} layers - Array of layer names to adopt (e.g., ['tokens', 'primitives', 'components'])
- * @param {CSSStyleSheet[]} additionalSheets - Additional component-specific stylesheets
- * @returns {Promise<void>}
+ * @param {Array<object>} designs - Array of design configs; items may include an optional `name` property.
+ * @param {object} [options] - Options forwarded to validateDesign (e.g., { minContrast })
+ * @returns {{ ok: boolean, results: Array<{ name?: string, ok: boolean, issues: Array<{path:string, message:string, ratio:number, min:number, context?:string}> }> }}
  */
-export function adoptLayers(shadowRoot: ShadowRoot, layers?: string[], additionalSheets?: CSSStyleSheet[]): Promise<void>;
-/**
- * Create a component-specific stylesheet from CSS string
- * Helper to create constructable stylesheets
- *
- * @param {string} css - CSS string
- * @returns {CSSStyleSheet}
- */
-export function createStylesheet(css: string): CSSStyleSheet;
+export function validateDesigns(designs?: Array<object>, options?: object): {
+    ok: boolean;
+    results: Array<{
+        name?: string;
+        ok: boolean;
+        issues: Array<{
+            path: string;
+            message: string;
+            ratio: number;
+            min: number;
+            context?: string;
+        }>;
+    }>;
+};
 /**
  * Generator - A JS-config-first design system
  * Generates comprehensive CSS variables and styles from a minimal configuration
@@ -45,18 +49,6 @@ export function createStylesheet(css: string): CSSStyleSheet;
 export class Generator {
     static "__#private@#instance": any;
     static get instance(): any;
-    /**
-     * Static method to apply styles to document
-     * Creates a link element with BLOB URL
-     * @param {Generator} [generator] - Optional Generator instance (defaults to singleton)
-     */
-    static applyStyles(generator?: Generator): void;
-    /**
-     * Install runtime styles for PDS using constructable stylesheets when
-     * available, otherwise update a single <style id="pds-runtime-stylesheet">.
-     * This approach reduces flicker and avoids link/blob swapping.
-     */
-    static installRuntimeStyles(cssText: any): void;
     constructor(options?: {});
     options: {
         debug: boolean;

package/dist/types/src/js/pds-core/pds-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pds-generator.d.ts","sourceRoot":"","sources":["../../../../../src/js/pds-core/pds-generator.js"],"names":[],"mappings":"AA29JA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,4CAjBW,UAAU,qBACV,aAAa,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAqCzB;AAED;;;;;;;;GAQG;AACH,wCALW,UAAU,WACV,MAAM,EAAE,qBACR,aAAa,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAmDzB;AAED;;;;;;GAMG;AACH,sCAHW,MAAM,GACJ,aAAa,CAMzB;AA7kKD;;;GAGG;AACH;IAEE,mCAAiB;IAEjB,2BAEC;IAi3JD;;;;OAIG;IACH,+BAFW,SAAS,QAgCnB;IAED;;;;OAIG;IACH,gDA6CC;IAj8JD,0BA6CC;IA5CC;;MAIC;IAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAmC;IA6BrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgBC;IAycD;;;;OAIG;IACH,kDAyBC;IA0ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6DC;IAorGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEC;IAGD,oBAEC;IA8vBD,qBAEC;IACD,yBAEC;IACD,yBAEC;IACD,wBAEC;IACD,yBAMC;IAED;;;;;;OAMG;IACH,oBA6JC;IAGD,4BAEC;IACD,gCAEC;IACD,gCAEC;IACD,+BAEC;IAmBD;;;OAGG;IACH;;;;;;MAoBC;;CA2GF"}
+{"version":3,"file":"pds-generator.d.ts","sourceRoot":"","sources":["../../../../../src/js/pds-core/pds-generator.js"],"names":[],"mappings":"AAg4JA;;;;;;;;;GASG;AACH,8CALW,MAAM,YAEd;IAAyB,WAAW,GAA5B,MAAM;CACd,GAAU;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAC,MAAM,CAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,GAAG,EAAC,MAAM,CAAC;QAAC,OAAO,CAAC,EAAC,MAAM,CAAA;KAAC,CAAC,CAAA;CAAE,CAyIpH;AAED;;;;;;;GAOG;AACH,0CAJW,KAAK,CAAC,MAAM,CAAC,YACb,MAAM,GACJ;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAC,IAAI,EAAC,MAAM,CAAC;YAAC,OAAO,EAAC,MAAM,CAAC;YAAC,KAAK,EAAC,MAAM,CAAC;YAAC,GAAG,EAAC,MAAM,CAAC;YAAC,OAAO,CAAC,EAAC,MAAM,CAAA;SAAC,CAAC,CAAA;KAAE,CAAC,CAAA;CAAE,CAkGpK;AAznKD;;;GAGG;AACH;IAEE,mCAAiB;IAEjB,2BAEC;IAOD,0BA6CC;IA5CC;;MAIC;IAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAmC;IA6BrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgBC;IAycD;;;;OAIG;IACH,kDAyBC;IA0ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6DC;IAorGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEC;IAGD,oBAEC;IA8vBD,qBAEC;IACD,yBAEC;IACD,yBAEC;IACD,wBAEC;IACD,yBAMC;IAED;;;;;;OAMG;IACH,oBA6JC;IAGD,4BAEC;IACD,gCAEC;IACD,gCAEC;IACD,+BAEC;IAmBD;;;OAGG;IACH;;;;;;MAoBC;;CAmBF"}

package/dist/types/src/js/pds-core/pds-live.d.ts

@@ -0,0 +1,39 @@
+export function startLive(PDS: any, config: any, { emitReady, applyResolvedTheme, setupSystemListenerIfNeeded }: {
+    emitReady: any;
+    applyResolvedTheme: any;
+    setupSystemListenerIfNeeded: any;
+}): Promise<{
+    generator: Generator;
+    config: {
+        design: any;
+        preset: any;
+    } | {
+        design: {
+            colors: unknown;
+        } | {
+            typography: unknown;
+        } | {
+            spatialRhythm: unknown;
+        } | {
+            shape: unknown;
+        } | {
+            behavior: unknown;
+        } | {
+            layout: unknown;
+        } | {
+            advanced: unknown;
+        } | {
+            a11y: unknown;
+        } | {
+            components: unknown;
+        } | {
+            icons: unknown;
+        };
+    } | {
+        debug: boolean;
+    };
+    theme: string;
+    autoDefiner: any;
+}>;
+import { Generator } from "./pds-generator.js";
+//# sourceMappingURL=pds-live.d.ts.map

package/dist/types/src/js/pds-core/pds-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pds-live.d.ts","sourceRoot":"","sources":["../../../../../src/js/pds-core/pds-live.js"],"names":[],"mappings":"AAoNA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6NC;0BA7ayB,oBAAoB"}

package/dist/types/src/js/pds-core/pds-runtime.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Install runtime styles for PDS using constructable stylesheets when
+ * available, otherwise update a single <style id="pds-runtime-stylesheet">.
+ * This approach reduces flicker and avoids link/blob swapping.
+ */
+export function installRuntimeStyles(cssText: any): void;
+/**
+ * Apply generated styles to the current document.
+ * @param {Generator} [generator] - Optional Generator instance (defaults to singleton)
+ */
+export function applyStyles(generator?: Generator): void;
+/**
+ * Adopt primitives stylesheet into a shadow root.
+ * This is the primary method components should use.
+ *
+ * @param {ShadowRoot} shadowRoot - The shadow root to adopt into
+ * @param {CSSStyleSheet[]} additionalSheets - Additional component-specific stylesheets
+ * @returns {Promise<void>}
+ */
+export function adoptPrimitives(shadowRoot: ShadowRoot, additionalSheets?: CSSStyleSheet[], generator?: any): Promise<void>;
+/**
+ * Adopt multiple layers into a shadow root.
+ * For complex components that need more than just primitives.
+ *
+ * @param {ShadowRoot} shadowRoot - The shadow root to adopt into
+ * @param {string[]} layers - Array of layer names to adopt (e.g., ['tokens', 'primitives', 'components'])
+ * @param {CSSStyleSheet[]} additionalSheets - Additional component-specific stylesheets
+ * @returns {Promise<void>}
+ */
+export function adoptLayers(shadowRoot: ShadowRoot, layers?: string[], additionalSheets?: CSSStyleSheet[], generator?: any): Promise<void>;
+/**
+ * Create a component-specific stylesheet from CSS string.
+ * Helper to create constructable stylesheets.
+ *
+ * @param {string} css - CSS string
+ * @returns {CSSStyleSheet}
+ */
+export function createStylesheet(css: string): CSSStyleSheet;
+//# sourceMappingURL=pds-runtime.d.ts.map

package/dist/types/src/js/pds-core/pds-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pds-runtime.d.ts","sourceRoot":"","sources":["../../../../../src/js/pds-core/pds-runtime.js"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,yDAwCC;AAED;;;GAGG;AACH,wCAFW,SAAS,QAyBnB;AAMD;;;;;;;GAOG;AACH,4CAJW,UAAU,qBACV,aAAa,EAAE,oBACb,OAAO,CAAC,IAAI,CAAC,CAwBzB;AAED;;;;;;;;GAQG;AACH,wCALW,UAAU,WACV,MAAM,EAAE,qBACR,aAAa,EAAE,oBACb,OAAO,CAAC,IAAI,CAAC,CA4CzB;AAED;;;;;;GAMG;AACH,sCAHW,MAAM,GACJ,aAAa,CAMzB"}

package/dist/types/src/js/pds-core/pds-start-helpers.d.ts

@@ -0,0 +1,60 @@
+export function ensureAbsoluteAssetURL(value: any, options?: {}): any;
+export function stripFunctions(obj: any): any;
+export function normalizeInitConfig(inputConfig: {}, options: {}, { presets, defaultLog }: {
+    presets: any;
+    defaultLog: any;
+}): {
+    generatorConfig: {
+        design: any;
+        preset: any;
+        log: any;
+    } | {
+        design: {
+            colors: unknown;
+        } | {
+            typography: unknown;
+        } | {
+            spatialRhythm: unknown;
+        } | {
+            shape: unknown;
+        } | {
+            behavior: unknown;
+        } | {
+            layout: unknown;
+        } | {
+            advanced: unknown;
+        } | {
+            a11y: unknown;
+        } | {
+            components: unknown;
+        } | {
+            icons: unknown;
+        };
+        log: any;
+    };
+    enhancers: any;
+    presetInfo: {
+        id: any;
+        name: any;
+    };
+};
+export function resolveThemeAndApply({ manageTheme, themeStorageKey, applyResolvedTheme, setupSystemListenerIfNeeded }: {
+    manageTheme: any;
+    themeStorageKey: any;
+    applyResolvedTheme: any;
+    setupSystemListenerIfNeeded: any;
+}): {
+    resolvedTheme: string;
+    storedTheme: string;
+};
+export function resolveRuntimeAssetRoot(config: any, { resolvePublicAssetURL }: {
+    resolvePublicAssetURL: any;
+}): any;
+export function setupAutoDefinerAndEnhancers(options: any, { baseEnhancers }?: {
+    baseEnhancers?: any[];
+}): Promise<{
+    autoDefiner: any;
+    mergedEnhancers: any[];
+}>;
+export function ensureTrailingSlash(value: any): any;
+//# sourceMappingURL=pds-start-helpers.d.ts.map

package/dist/types/src/js/pds-core/pds-start-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pds-start-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/js/pds-core/pds-start-helpers.js"],"names":[],"mappings":"AAmBA,sEAgCC;AA0CD,8CAsBC;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuGC;AAGD;;;;;;;;EAmCC;AAED;;QASC;AAGD;;;;;GAmIC;AAtYM,qDAGI"}

package/dist/types/src/js/pds-core/pds-utilities.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Convenience to adopt only primitives into a ShadowRoot
+ *
+ * @param {ShadowRoot} shadowRoot - The shadow root to adopt into
+ * @param {CSSStyleSheet[]} additionalSheets - Additional component-specific stylesheets
+ * @returns {Promise<void>}
+ */
+export function adoptPrimitives(shadowRoot: ShadowRoot, additionalSheets?: CSSStyleSheet[]): Promise<void>;
+/**
+ * Adopt multiple layers into a shadow root
+ * For complex components that need more than just primitives
+ *
+ * @param {ShadowRoot} shadowRoot - The shadow root to adopt into
+ * @param {string[]} layers - Array of layer names to adopt (e.g., ['tokens', 'primitives', 'components'])
+ * @param {CSSStyleSheet[]} additionalSheets - Additional component-specific stylesheets
+ * @returns {Promise<void>}
+ */
+export function adoptLayers(shadowRoot: ShadowRoot, layers?: string[], additionalSheets?: CSSStyleSheet[]): Promise<void>;
+/**
+ * Create a component-specific stylesheet from CSS string
+ * Helper to create constructable stylesheets
+ *
+ * @param {string} css - CSS string
+ * @returns {CSSStyleSheet}
+ */
+export function createStylesheet(css: string): CSSStyleSheet;
+//# sourceMappingURL=pds-utilities.d.ts.map

package/dist/types/src/js/pds-core/pds-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pds-utilities.d.ts","sourceRoot":"","sources":["../../../../../src/js/pds-core/pds-utilities.js"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,4CAJW,UAAU,qBACV,aAAa,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAIzB;AAED;;;;;;;;GAQG;AACH,wCALW,UAAU,WACV,MAAM,EAAE,qBACR,aAAa,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAqDzB;AAED;;;;;;GAMG;AACH,sCAHW,MAAM,GACJ,aAAa,CAMzB"}

package/dist/types/src/js/pds-gen.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Validate multiple designs
+ */
+export function validateDesigns(designs?: any[], options?: {}): Promise<{
+    ok: boolean;
+    results: {
+        name: any;
+        ok: boolean;
+        issues: ({
+            path: string;
+            message: string;
+            ratio: number;
+            min: number;
+            context: string;
+        } | {
+            path: string;
+            message: string;
+            ratio: number;
+            min: number;
+            context?: undefined;
+        })[];
+    }[];
+}>;
+import { Generator } from "./common/pds-core/pds-generator.js";
+import ontology from "./common/pds-core/pds-ontology.js";
+import { PDSQuery } from "./common/pds-core/pds-query.js";
+import { presets } from "./common/pds-core/pds-config.js";
+/**
+ * Validate a single design config
+ */
+export function validateDesign(designConfig?: {}, options?: {}): Promise<{
+    ok: boolean;
+    issues: ({
+        path: string;
+        message: string;
+        ratio: number;
+        min: number;
+        context: string;
+    } | {
+        path: string;
+        message: string;
+        ratio: number;
+        min: number;
+        context?: undefined;
+    })[];
+}>;
+export { Generator, ontology, PDSQuery, presets };
+//# sourceMappingURL=pds-gen.d.ts.map

package/dist/types/src/js/pds-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pds-gen.d.ts","sourceRoot":"","sources":["../../../../src/js/pds-gen.js"],"names":[],"mappings":"AAqKA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;GA2FC;0BAhQyB,oCAAoC;qBACzC,mCAAmC;yBAC/B,gCAAgC;wBACjC,iCAAiC;AAyBzD;;GAEG;AACH;;;;;;;;;;;;;;;GAiIC"}

package/dist/types/src/js/pds-live-runtime.d.ts

@@ -0,0 +1,7 @@
+export function startLive(PDS: any, config: any): Promise<{
+    generator: any;
+    config: any;
+    theme: any;
+    autoDefiner: any;
+}>;
+//# sourceMappingURL=pds-live-runtime.d.ts.map

package/dist/types/src/js/pds-live-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pds-live-runtime.d.ts","sourceRoot":"","sources":["../../../../src/js/pds-live-runtime.js"],"names":[],"mappings":"AAAA;;;;;GA6OC"}

package/dist/types/src/js/pds-live-validation.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Validate a single design configuration for accessibility sanity checks.
+ *
+ * @param {PDS} PDS - Runtime instance providing Generator access
+ * @param {object} designConfig - Candidate design configuration
+ * @param {object} [options]
+ * @param {number} [options.minContrast=4.5]
+ * @returns {{ ok: boolean, issues: Array<{path:string, message:string, ratio:number, min:number, context?:string}> }}
+ */
+export function validateDesignInternal(PDS: any, designConfig?: object, options?: {
+    minContrast?: number;
+}): {
+    ok: boolean;
+    issues: Array<{
+        path: string;
+        message: string;
+        ratio: number;
+        min: number;
+        context?: string;
+    }>;
+};
+/**
+ * Validate multiple design configurations.
+ *
+ * @param {PDS} PDS - Runtime instance providing Generator access
+ * @param {Array<object>} designs - List of designs or preset references
+ * @param {object} [options]
+ * @returns {{ ok: boolean, results: Array<{ name?: string, ok: boolean, issues: Array<{path:string, message:string, ratio:number, min:number, context?:string}> }> }}
+ */
+export function validateDesignsInternal(PDS: any, designs?: Array<object>, options?: object): {
+    ok: boolean;
+    results: Array<{
+        name?: string;
+        ok: boolean;
+        issues: Array<{
+            path: string;
+            message: string;
+            ratio: number;
+            min: number;
+            context?: string;
+        }>;
+    }>;
+};
+//# sourceMappingURL=pds-live-validation.d.ts.map

package/dist/types/src/js/pds-live-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pds-live-validation.d.ts","sourceRoot":"","sources":["../../../../src/js/pds-live-validation.js"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH,gEALW,MAAM,YAEd;IAAyB,WAAW,GAA5B,MAAM;CACd,GAAU;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAC,MAAM,CAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,GAAG,EAAC,MAAM,CAAC;QAAC,OAAO,CAAC,EAAC,MAAM,CAAA;KAAC,CAAC,CAAA;CAAE,CA0IpH;AAED;;;;;;;GAOG;AACH,4DAJW,KAAK,CAAC,MAAM,CAAC,YACb,MAAM,GACJ;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAC,IAAI,EAAC,MAAM,CAAC;YAAC,OAAO,EAAC,MAAM,CAAC;YAAC,KAAK,EAAC,MAAM,CAAC;YAAC,GAAG,EAAC,MAAM,CAAC;YAAC,OAAO,CAAC,EAAC,MAAM,CAAA;SAAC,CAAC,CAAA;KAAE,CAAC,CAAA;CAAE,CAmHpK"}

package/dist/types/src/js/pds-live.d.ts

@@ -0,0 +1,11 @@
+export function startLive(PDS: any, config: any): Promise<{
+    generator: any;
+    config: any;
+    theme: any;
+    autoDefiner: any;
+}>;
+declare namespace _default {
+    export { startLive };
+}
+export default _default;
+//# sourceMappingURL=pds-live.d.ts.map

package/dist/types/src/js/pds-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pds-live.d.ts","sourceRoot":"","sources":["../../../../src/js/pds-live.js"],"names":[],"mappings":"AAEA;;;;;GAEC"}

package/dist/types/src/js/pds-manager.d.ts

@@ -0,0 +1,2 @@
+export { startLive } from "./pds-core/pds-live.js";
+//# sourceMappingURL=pds-manager.d.ts.map

package/dist/types/src/js/pds-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pds-manager.d.ts","sourceRoot":"","sources":["../../../../src/js/pds-manager.js"],"names":[],"mappings":""}

package/dist/types/src/js/pds.d.ts

@@ -3,7 +3,7 @@
  *
  * This object exposes the core runtime building blocks for the Pure Design System.
  * It intentionally provides a small, stable surface area so consuming apps can:
- * - programmatically generate design system artifacts (via `Generator`),
+ * - programmatically generate design system artifacts (via `getGenerator()` in live mode),
  * - adopt styles into Shadow DOM (via `adoptLayers` / `adoptPrimitives`),
  * - query runtime mode and obtain constructable stylesheets (via `registry`).
  *
@@ -19,18 +19,14 @@
  *   `CSSStyleSheet.replaceSync()` — callers should guard invalid input or wrap calls in try/catch.
  */
 export type PDSAPI = {
-    /**
-     * - Generator class to produce design system assets
-     */
-    Generator: typeof import("./pds-core/pds-generator.js").Generator;
     /**
      * - Singleton runtime registry for live/static mode
      */
     registry: import("./pds-core/pds-registry.js").PDSRegistry;
     /**
-     * - Ontology helpers and metadata for components
+     * - Apply generated styles to the document (live-only)
      */
-    ontology: any;
+    applyStyles: (generator?: import("./pds-core/pds-generator.js").Generator) => void;
     /**
      * - Adopt multiple layers into a ShadowRoot. May log errors and fallback to additionalSheets when static imports fail.
      */
@@ -46,34 +42,12 @@ export type PDSAPI = {
 };
 /** @type {PDSAPI & PDSBase} */
 export const PDS: PDSAPI & PDSBase;
-/**
- * Validate a design configuration for accessibility sanity checks.
- * Currently validates color contrast for primary buttons and base surface text
- * in both light and dark themes.
- *
- * @param {object} designConfig - A full or partial PDS config object
- * @param {object} [options]
- * @param {number} [options.minContrast=4.5] - Minimum contrast ratio for normal text
- * @returns {{ ok: boolean, issues: Array<{path:string, message:string, ratio:number, min:number, context?:string}> }}
- */
-export function validateDesign(designConfig?: object, options?: {
-    minContrast?: number;
-}): {
-    ok: boolean;
-    issues: Array<{
-        path: string;
-        message: string;
-        ratio: number;
-        min: number;
-        context?: string;
-    }>;
-};
 /**
  * Public PDS runtime object exported to consumers.
  *
  * This object exposes the core runtime building blocks for the Pure Design System.
  * It intentionally provides a small, stable surface area so consuming apps can:
- * - programmatically generate design system artifacts (via `Generator`),
+ * - programmatically generate design system artifacts (via `getGenerator()` in live mode),
  * - adopt styles into Shadow DOM (via `adoptLayers` / `adoptPrimitives`),
  * - query runtime mode and obtain constructable stylesheets (via `registry`).
  *
@@ -89,14 +63,13 @@ export function validateDesign(designConfig?: object, options?: {
  *   `CSSStyleSheet.replaceSync()` — callers should guard invalid input or wrap calls in try/catch.
  *
  * @typedef {Object} PDSAPI
- * @property {typeof import("./pds-core/pds-generator.js").Generator} Generator - Generator class to produce design system assets
  * @property {import("./pds-core/pds-registry.js").PDSRegistry} registry - Singleton runtime registry for live/static mode
- * @property {any} ontology - Ontology helpers and metadata for components
+ * @property {(generator?: import("./pds-core/pds-generator.js").Generator) => void} applyStyles - Apply generated styles to the document (live-only)
  * @property {(shadowRoot: ShadowRoot, layers?: string[], additionalSheets?: CSSStyleSheet[]) => Promise<void>} adoptLayers - Adopt multiple layers into a ShadowRoot. May log errors and fallback to additionalSheets when static imports fail.
  * @property {(shadowRoot: ShadowRoot, additionalSheets?: CSSStyleSheet[]) => Promise<void>} adoptPrimitives - Adopt primitives layer into a ShadowRoot. Designed as a convenience for components.
  * @property {(css:string) => CSSStyleSheet} createStylesheet - Create a constructable stylesheet from CSS text. @throws {DOMException} on invalid CSS in some browsers.
  * @property {() => boolean} isLiveMode - Returns true when running in live/designer-backed mode
- * @property {(el: Element) => import("./pds-core/pds-ontology.js").ComponentDef | null} findComponentForElement - Helper to find a component definition for a DOM element
+ * @property {() => Promise<typeof import("./pds-core/pds-generator.js").Generator>} getGenerator - Live-only accessor for the Generator class
  */
 /**
  * Workspace for the Pure Design System runtime API

package/dist/types/src/js/pds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pds.d.ts","sourceRoot":"","sources":["../../../../src/js/pds.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;eAuBc,cAAc,6BAA6B,EAAE,SAAS;;;;cACtD,OAAO,4BAA4B,EAAE,WAAW;;;;cAChD,GAAG;;;;iBACH,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,gBAAgB,CAAC,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC;;;;qBAChG,CAAC,UAAU,EAAE,UAAU,EAAE,gBAAgB,CAAC,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC;;;;sBAC7E,CAAC,GAAG,EAAC,MAAM,KAAK,aAAa;;AAW3C,+BAA+B;AAC/B,kBADW,MAAM,GAAG,OAAO,CACD;AA6R1B;;;;;;;;;GASG;AACH,8CALW,MAAM,YAEd;IAAyB,WAAW,GAA5B,MAAM;CACd,GAAU;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,IAAI,EAAC,MAAM,CAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,GAAG,EAAC,MAAM,CAAC;QAAC,OAAO,CAAC,EAAC,MAAM,CAAA;KAAC,CAAC,CAAA;CAAE,CAyIpH;AApdD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;GAIG;AACH;CAAoC"}
+{"version":3,"file":"pds.d.ts","sourceRoot":"","sources":["../../../../src/js/pds.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;cAuBc,OAAO,4BAA4B,EAAE,WAAW;;;;iBAChD,CAAC,SAAS,CAAC,EAAE,OAAO,6BAA6B,EAAE,SAAS,KAAK,IAAI;;;;iBACrE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,gBAAgB,CAAC,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC;;;;qBAChG,CAAC,UAAU,EAAE,UAAU,EAAE,gBAAgB,CAAC,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC;;;;sBAC7E,CAAC,GAAG,EAAC,MAAM,KAAK,aAAa;;AAW3C,+BAA+B;AAC/B,kBADW,MAAM,GAAG,OAAO,CACD;AArC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;GAIG;AACH;CAAoC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pure-ds/core",
   "shortname": "pds",
-  "version": "0.4.37",
+  "version": "0.5.2",
   "description": "Pure Design System - Why develop a Design System when you can generate one?",
   "repository": {
     "type": "git",
@@ -26,11 +26,11 @@
   "module": "./public/assets/js/pds.js",
   "types": "./dist/types/pds.d.ts",
   "bin": {
-    "pds-export": "packages/pds-cli/bin/pds-static.mjs",
-    "pds-sync-assets": "packages/pds-cli/bin/sync-assets.mjs",
-    "pds-build-icons": "packages/pds-cli/bin/pds-build-icons.mjs",
-    "pds-setup-copilot": "packages/pds-cli/bin/pds-setup-copilot.mjs",
-    "pds-init-config": "packages/pds-cli/bin/pds-init-config.mjs"
+    "pds-export": "packages/pds-cli/bin/pds-static.js",
+    "pds-sync-assets": "packages/pds-cli/bin/sync-assets.js",
+    "pds-build-icons": "packages/pds-cli/bin/pds-build-icons.js",
+    "pds-setup-copilot": "packages/pds-cli/bin/pds-setup-copilot.js",
+    "pds-init-config": "packages/pds-cli/bin/pds-init-config.js"
   },
   "exports": {
     ".": {
@@ -44,7 +44,6 @@
   "files": [
     ".github/copilot-instructions.md",
     ".cursorrules",
-    "getting-started.md",
     "dist/types/",
     "public/assets/js/",
     "public/assets/pds/components/",
@@ -77,11 +76,11 @@
     "types": "tsc -p tsconfig.json && node scripts/sync-types.mjs",
     "postinstall": "node packages/pds-cli/bin/postinstall.mjs",
     "prepds:export": "npm run types",
-    "pds:export": "node packages/pds-cli/bin/pds-static.mjs",
-    "pds:build-icons": "node packages/pds-cli/bin/pds-build-icons.mjs",
-    "pds:manifest": "node packages/pds-cli/bin/generate-manifest.mjs",
-    "pds:css-data": "node packages/pds-cli/bin/generate-css-data.mjs",
-    "pds:dx": "node packages/pds-cli/bin/pds-dx.mjs",
+    "pds:export": "node packages/pds-cli/bin/pds-static.js",
+    "pds:build-icons": "node packages/pds-cli/bin/pds-build-icons.js",
+    "pds:manifest": "node packages/pds-cli/bin/generate-manifest.js",
+    "pds:css-data": "node packages/pds-cli/bin/generate-css-data.js",
+    "pds:dx": "node packages/pds-cli/bin/pds-dx.js",
     "storybook:generate": "cd packages/pds-storybook && npm run generate-stories",
     "storybook:dev": "cd packages/pds-storybook && npm run storybook:dev",
     "storybook:build": "cd packages/pds-storybook && npm run storybook:build"