@pure-ds/core 0.7.52 → 0.7.54

package/src/js/pds.d.ts

@@ -283,6 +283,13 @@ export interface AskOptions {
   [key: string]: any;
 }
 
+export type PDSParseTemplateLike = TemplateStringsArray | {
+  strings: string[];
+  values: unknown[];
+};
+
+export type PDSParseInput = string | PDSParseTemplateLike;
+
 export class PDS extends EventTarget {
   // Static surface
   static registry: PDSRegistry;
@@ -332,7 +339,8 @@ export class PDS extends EventTarget {
   static ontology?: any;
   static enums?: Record<string, any>;
   static common?: Record<string, any>;
-  static parse?: (html: string) => Element[];
+  static parse?: (html: PDSParseInput, ...values: unknown[]) => NodeListOf<ChildNode>;
+  static html?: (html: PDSParseInput, ...values: unknown[]) => DocumentFragment;
   static msg: (template: string | PDSStrResult, options?: Record<string, any>) => string;
   static str: (strings: TemplateStringsArray, ...values: any[]) => PDSStrResult;
   static configureLocalization: (config?: PDSLocalizationConfig | null) => {
@@ -395,7 +403,8 @@ export class PDS extends EventTarget {
    * @param options.duration - Duration in milliseconds (auto-calculated if not provided)
    * @param options.closable - Whether toast can be manually closed (default: true)
    * @param options.persistent - If true, toast won't auto-dismiss (default: false)
-   * @returns Toast ID (can be used to dismiss programmatically)
+  * @param options.returnToastElement - If true, returns the live toast element instead of the toast ID
+  * @returns Toast ID (default), or live toast element when returnToastElement is true
    * 
    * @example
    * await PDS.toast('Changes saved!', { type: 'success' });
@@ -411,6 +420,7 @@ export class PDS extends EventTarget {
       duration?: number;
       closable?: boolean;
       persistent?: boolean;
+      returnToastElement?: false;
     }
   ): Promise<string>;
   
@@ -425,11 +435,12 @@ export class PDS extends EventTarget {
    * await PDS.toast.success('Profile updated!');
    */
   static toast: {
-    (message: string, options?: { type?: 'information' | 'success' | 'warning' | 'error'; title?: string; duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
-    success(message: string, options?: { title?: string; duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
-    error(message: string, options?: { title?: string; duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
-    warning(message: string, options?: { title?: string; duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
-    info(message: string, options?: { title?: string; duration?: number; closable?: boolean; persistent?: boolean }): Promise<string>;
+    (message: string, options: { type?: 'information' | 'success' | 'warning' | 'error'; title?: string; duration?: number; closable?: boolean; persistent?: boolean; returnToastElement: true }): Promise<HTMLElement | null>;
+    (message: string, options?: { type?: 'information' | 'success' | 'warning' | 'error'; title?: string; duration?: number; closable?: boolean; persistent?: boolean; returnToastElement?: false }): Promise<string>;
+    success(message: string, options?: { title?: string; duration?: number; closable?: boolean; persistent?: boolean; returnToastElement?: boolean }): Promise<string | HTMLElement | null>;
+    error(message: string, options?: { title?: string; duration?: number; closable?: boolean; persistent?: boolean; returnToastElement?: boolean }): Promise<string | HTMLElement | null>;
+    warning(message: string, options?: { title?: string; duration?: number; closable?: boolean; persistent?: boolean; returnToastElement?: boolean }): Promise<string | HTMLElement | null>;
+    info(message: string, options?: { title?: string; duration?: number; closable?: boolean; persistent?: boolean; returnToastElement?: boolean }): Promise<string | HTMLElement | null>;
   };
   
   /**
@@ -740,3 +751,6 @@ export class SchemaForm extends HTMLElement {
     options?: boolean | EventListenerOptions
   ): void;
 }
+
+export function parse(html: PDSParseInput, ...values: unknown[]): NodeListOf<ChildNode>;
+export function html(html: PDSParseInput, ...values: unknown[]): DocumentFragment;

package/src/js/pds.js

@@ -638,8 +638,13 @@ PDS.adoptLayers = adoptLayers;
 /** Convenience to adopt only primitives into a ShadowRoot */
 PDS.adoptPrimitives = adoptPrimitives;
 
-/** Parse an HTML string into a NodeList */
-PDS.parse = common.parseHTML;
+/** Parse HTML strings or tagged templates into a NodeList */
+export const parse = common.parseHTML;
+PDS.parse = parse;
+
+/** Parse HTML or tagged templates into a DocumentFragment */
+export const html = common.parseFragment;
+PDS.html = html;
 
 /** Create a constructable CSSStyleSheet from a CSS string */
 PDS.createStylesheet = createStylesheet;