@microsoft/dragon-copilot-sdk-lexical-react 0.2.6-beta.4636686 → 1.0.1

package/node_modules/@hccm/web-tcl/dist/cjs/text-control-lib/textarea-control.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.TextAreaControl=void 0;const e=require("./base-control");class t extends e.BaseControl{constructor(e){super(e);this.type="TextArea"}}exports.TextAreaControl=t;

package/node_modules/@hccm/web-tcl/dist/cjs/text-control-lib/tinymce-control.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The TinyMCE control class
+ * @class
+ */
+export class TinyMceControl extends ContentEditableControl {
+    tinyMceIframe: any;
+    tinyMceEditor: any;
+    adjustScrollPosition(): void;
+    #private;
+}
+import { ContentEditableControl } from "./contenteditable-control";

package/node_modules/@hccm/web-tcl/dist/cjs/text-control-lib/tinymce-control.js

@@ -0,0 +1 @@
+"use strict";var t,e,n;Object.defineProperty(exports,"__esModule",{value:true});exports.TinyMceControl=void 0;const i=require("tslib");const o=require("./contenteditable-control");const r=require("../logger/logging");class c extends o.ContentEditableControl{constructor(e){super(e.getBody());t.add(this);this.tinyMceIframe=e.iframeElement;this.type="TinyMCE";this.tinyMceEditor=e}replaceText(t,e,n){this.tinyMceEditor.undoManager.beforeChange();const i=super.replaceText(t,e,n);if(this.htmlElement.childElementCount===0){this.htmlElement.innerHTML="<p><br></p>"}return i}setSelection(t=0,e=0){super.setSelection(t,e);this.tinyMceEditor.undoManager.add()}getSelectionCoordinates(){if(this.tinyMceIframe){const t=this.tinyMceIframe.getBoundingClientRect();const e=this.tinyMceIframe.contentWindow.getSelection();if(!e||e.rangeCount===0)return null;const n=e.getRangeAt(0).getBoundingClientRect();return{left:t.left+n.left,top:t.top+n.top,right:t.left+n.right,bottom:t.top+n.bottom}}return super.getSelectionCoordinates()}adjustScrollPosition(){try{if(!i.__classPrivateFieldGet(this,t,"m",n).call(this)){this.tinyMceEditor.getContainer().scrollIntoView()}const o=i.__classPrivateFieldGet(this,t,"m",e).call(this);const r=this.tinyMceEditor.getWin();const c=r.document.documentElement;if(!c||!o)return;const s=c.scrollTop;const l=s+c.clientHeight;const d=o.top+s;const g=o.bottom+s;if(d<s){r.scrollTo(0,d)}else if(g>l){const t=g-c.clientHeight;r.scrollTo(0,t)}}catch(t){r.logger.error("TinyMceControl.adjustScrollPosition","Error adjusting scroll position",t)}}}exports.TinyMceControl=c;t=new WeakSet,e=function t(){let e=this.tinyMceEditor.selection.getBoundingClientRect();if(!e){if(this.tinyMceEditor.selection.isCollapsed()){r.logger.debug("TinyMceControl.#getBoundingClientRectOfEditor","rect is undefined, expanding selection to get rect");const t=this.tinyMceEditor.selection.getRng();this.tinyMceEditor.selection.expand();e=this.tinyMceEditor.selection.getBoundingClientRect();this.tinyMceEditor.selection.collapse(t.startContainer,t.startOffset)}if(!e){r.logger.debug("TinyMceControl.#getBoundingClientRectOfEditor","Could not adjust scroll position as rect is undefined")}}return e},n=function t(){if(!this.tinyMceEditor)return false;const e=document.getElementById(this.tinyMceEditor.id).clientHeight;const n=this.tinyMceEditor.getContainer();const i=n.getBoundingClientRect();const o=0;const r=window.innerHeight||document.documentElement.clientHeight;const c=i.top>=o&&i.top<=r;const s=i.bottom>=o&&i.bottom<=r;const l=e>window.innerHeight;return c&&s||l};

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/channel.d.ts

@@ -0,0 +1,15 @@
+import { type NextObserver, type Observable } from "rxjs";
+export type Typed<TMap> = {
+    [K in keyof TMap]: {
+        type: K;
+    };
+};
+export type ChannelSender<TMessageMap extends Typed<TMessageMap>> = {
+    send(this: void, message: TMessageMap[keyof TMessageMap]): void;
+};
+export type ChannelReceiver<TMessageMap extends Typed<TMessageMap>> = {
+    receiveAll(this: void): Observable<TMessageMap[keyof TMessageMap]>;
+    receive<K extends keyof TMessageMap>(this: void, type: K): Observable<TMessageMap[K]>;
+};
+export declare function channelSender<TMessageMap extends Typed<TMessageMap>>(value: NextObserver<TMessageMap[keyof TMessageMap]>): ChannelSender<TMessageMap>;
+export declare function channelReceiver<TMessageMap extends Typed<TMessageMap>>(value$: Observable<TMessageMap[keyof TMessageMap]>): ChannelReceiver<TMessageMap>;

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/channel.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.channelSender=r;exports.channelReceiver=t;const e=require("rxjs");function r(e){return{send(r){e.next(r)}}}function t(r){return{receiveAll(){return r},receive(t){return r.pipe((0,e.filter)(e=>e.type===t))}}}

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/commands.d.ts

@@ -0,0 +1,64 @@
+import type { ProcessingStatus } from "./processing-status";
+import type { AdditionalReplaceTextParameters } from "./types";
+type CommandMap = {
+    initialize: {
+        isDisabled: boolean;
+        useGuiMarkup: boolean;
+    };
+    dispose: undefined;
+    focus: {
+        id: string;
+    };
+    activate: {
+        id: string;
+    };
+    deactivate: {
+        id: string;
+    };
+    selectNode: {
+        id: string;
+        shouldFocus: boolean;
+    };
+    setStatus: {
+        id: string;
+        status: ProcessingStatus;
+    };
+    replaceText: {
+        id: string;
+        text: string;
+        selection: {
+            start: number;
+            length: number;
+        };
+        additionalParameters?: AdditionalReplaceTextParameters;
+    };
+    setSelection: {
+        id: string;
+        selection: {
+            start: number;
+            length: number;
+        };
+    };
+    setText: {
+        id: string;
+        text: string;
+    };
+    setRecordingState: {
+        state: "started" | "stopped";
+    };
+    undo: {
+        id: string;
+    };
+    redo: {
+        id: string;
+    };
+};
+export type WebTCLCommands = {
+    [K in keyof CommandMap]: CommandMap[K] extends undefined ? {
+        type: K;
+    } : {
+        type: K;
+    } & CommandMap[K];
+};
+export type WebTCLCommand = WebTCLCommands[keyof WebTCLCommands];
+export {};

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/commands.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/custom-controls/custom-control.d.ts

@@ -0,0 +1,212 @@
+import type { Capabilities } from "../../text-control-lib/text-control";
+import type { AdditionalReplaceTextParameters } from "../types";
+/**
+ * A command indicates what changed on the custom-control
+ */
+export type CustomControlCommand = {
+    /**
+     * The text to replace.
+     */
+    text: {
+        value: string;
+        start: number;
+        length: number;
+        additionalParameters?: AdditionalReplaceTextParameters;
+    };
+    /**
+     * The selection of the text.
+     */
+    selection: {
+        start: number;
+        end: number;
+    };
+    /**
+     * Indicates if the custom-control should be focused or not.
+     */
+    focus: boolean;
+    /**
+     * Forwards the undo voice command to the custom control.
+     */
+    undo: undefined;
+    /**
+     * Forwards the redo voice command to the custom control.
+     */
+    redo: undefined;
+};
+/**
+ * Represents the state of a custom control.
+ */
+export type CustomControlState = {
+    /**
+     * The text content of the custom-control
+     */
+    text: string;
+    /**
+     * The selection of the text
+     */
+    selection: {
+        start: number;
+        end: number;
+    };
+    /**
+     * Indicates if the custom-control has the focus or not.
+     */
+    focus: boolean;
+};
+/**
+ * Custom Control
+ */
+export interface CustomControl {
+    /**
+     * Used to synchronize changes from the {@link CustomControl} with the {@link HTMLElement}
+     * @param type {@link CustomControlCommand} indicates what changed
+     * @param action The function to execute for the given {@param type}
+     */
+    handle<K extends keyof CustomControlCommand>(type: K, action: (command: CustomControlCommand[K]) => void): void;
+    /**
+     * Used to synchronize changes from the {@link HTMLElement} with the {@link CustomControl}
+     * @param changes indicates what changed
+     */
+    update(changes: Partial<CustomControlState>): void;
+    /**
+     * Defines new line characters
+     * @default "\n"
+     * @example
+     * ```ts
+     *  function(element: HTMLElement, control: CustomControl) {
+     *    control.newline = "\n";
+     *  }
+     * ```
+     */
+    newline: string;
+    /**
+     * Defines paragraph characters
+     * @default "\n\n"
+     * @example
+     * ```ts
+     *  function (element: HTMLElement, control: CustomControl) {
+     *    control.paragraph = "\n\n";
+     *  }
+     * ```
+     */
+    paragraph: string;
+    /**
+     * Indicates if the control is multiline or not
+     * @default false
+     * @example
+     * ```ts
+     *  function (element: HTMLElement, control: CustomControl) {
+     *    control.isMultiline = true;
+     *  }
+     * ```
+     */
+    isMultiline: boolean;
+    /**
+     * Represents the set of additional/custom features supported by a custom control.
+     *
+     * @property undoRedo - Indicates whether undo and redo functionality is available.
+     * @example
+     * ```ts
+     *  function (element: HTMLElement, control: CustomControl) {
+     *    control.capabilities = {
+     *      undoRedo: true
+     *    }
+     *  }
+     * ```
+     */
+    capabilities?: Capabilities;
+}
+/**
+ * Binds {@link HTMLElement} to {@link CustomControl}, synchronizing their state.
+ * Changes happened in {@link HTMLElement} are propagate to {@link CustomControl}, and vice-versa.
+ * - Initializes {@link CustomControl} with initial state of {@link HTMLElement}
+ * - Set event handlers from {@link CustomControl}, applying changes to {@link HTMLElement}
+ * - Set event handlers from {@link HTMLElement}, applying changes to {@link CustomControl}
+ * - Return a function to disconnect {@link HTMLElement} and {@link CustomControl}.
+ *
+ * @example
+ * ```ts
+ *  const customInput: CustomControlInitializer = (element, control) => {
+ *    if (!(element instanceof HTMLInputElement)) {
+ *      throw new Error("Element is not an input element");
+ *    }
+ *
+ *    // configure the custom control
+ *    control.update({
+ *      newline: "\n",
+ *      paragraph: "\n\n",
+ *    });
+ *
+ *    const updateCustomControl = () => {
+ *      control.update({
+ *        text: element.value,
+ *        selection: {
+ *          start: element.selectionStart ?? 0,
+ *          length: (element.selectionEnd ?? 0) - (element.selectionStart ?? 0),
+ *        },
+ *        focus: element === element.ownerDocument.activeElement,
+ *      });
+ *    };
+ *
+ *    // initial state for web-tcl
+ *    updateCustomControl();
+ *
+ *    // handle events coming from web-tcl
+ *    control.handle("selection", ({ start, end }) => {
+ *      element.setSelectionRange(start, end);
+ *    });
+ *
+ *    control.handle("text", ({ value, start, length }) => {
+ *      if (!value) {
+ *        element.value = "";
+ *      } else {
+ *        element.value = `${element.value.slice(0, start)}${value}${element.value.slice(start + length)}`;
+ *      }
+ *      element.dispatchEvent(new Event("change", { bubbles: true }));
+ *    });
+ *
+ *    control.handle("focus", (focus) => {
+ *      if (focus) {
+ *        element.focus();
+ *      } else {
+ *        element.blur();
+ *      }
+ *    });
+ *
+ *    // handle events coming from the HTML element
+ *    element.addEventListener("input", notifyCustomControl);
+ *    element.addEventListener("change", notifyCustomControl);
+ *    element.addEventListener("select", notifyCustomControl);
+ *    element.addEventListener("focusin", notifyCustomControl);
+ *    element.addEventListener("focusout", notifyCustomControl);
+ *
+ *    return function () {
+ *      element.removeEventListener("input", notifyCustomControl);
+ *      element.removeEventListener("change", notifyCustomControl);
+ *      element.removeEventListener("select", notifyCustomControl);
+ *      element.removeEventListener("focusin", notifyCustomControl);
+ *      element.removeEventListener("focusout", notifyCustomControl);
+ *    };
+ *  };
+ * ```
+ * @param element
+ * @param control
+ * @returns a function to remove event handlers, disconnecting {@link HTMLElement} and {@link CustomControl}.
+ */
+export type CustomControlInitializer = (element: HTMLElement, control: CustomControl) => () => void;
+/**
+ * Collection of {@link CustomControl} - key is string, value is {@link CustomControlInitializer}
+ * @example
+ * ```ts
+ *  const customControls = {
+ *    "customControlType": function (element: HTMLElement, control: CustomControl) {
+ *      // implementation
+ *    },
+ *  }
+ * ```
+ */
+export interface CustomControlCollection {
+    readonly [name: string]: CustomControlInitializer;
+    readonly [name: number]: never;
+    readonly [name: symbol]: never;
+}

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/custom-controls/custom-control.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/custom-controls/index.d.ts

@@ -0,0 +1,6 @@
+import type { CustomControl, CustomControlInitializer, CustomControlCollection, CustomControlCommand, CustomControlState } from "./custom-control";
+export type { CustomControl, CustomControlInitializer, CustomControlCollection, CustomControlCommand, CustomControlState, };
+export declare const CustomControls: {
+    readonly inputCustomControl: CustomControlInitializer;
+    readonly textareaCustomControl: CustomControlInitializer;
+};

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/custom-controls/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.CustomControls=void 0;const t=require("./input-custom-control");const o=require("./textarea-custom-control");exports.CustomControls={inputCustomControl:t.inputCustomControl,textareaCustomControl:o.textareaCustomControl};

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/custom-controls/input-custom-control.d.ts

@@ -0,0 +1,2 @@
+import type { CustomControlInitializer } from "./custom-control";
+export declare const inputCustomControl: CustomControlInitializer;

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/custom-controls/input-custom-control.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.inputCustomControl=void 0;const e=function(e,t){if(!(e instanceof HTMLInputElement)){throw new Error("Element must be an input")}t.newline="\n";t.paragraph="\n\n";t.isMultiline=false;const n=()=>{var n,s;t.update({text:e.value,selection:{start:(n=e.selectionStart)!==null&&n!==void 0?n:0,end:(s=e.selectionEnd)!==null&&s!==void 0?s:0},focus:e===e.ownerDocument.activeElement})};n();t.handle("text",({value:t,start:n,length:s})=>{e.value=e.value.slice(0,n)+t+e.value.slice(n+s);e.dispatchEvent(new Event("change",{bubbles:true}))});t.handle("selection",({start:t,end:n})=>{e.setSelectionRange(t,n)});t.handle("focus",t=>{if(t){e.focus()}else{e.blur()}});e.addEventListener("input",n);e.addEventListener("change",n);e.addEventListener("select",n);e.addEventListener("focusin",n);e.addEventListener("focusout",n);return function(){e.removeEventListener("input",n);e.removeEventListener("change",n);e.removeEventListener("select",n);e.removeEventListener("focusin",n);e.removeEventListener("focusout",n)}};exports.inputCustomControl=e;

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/custom-controls/textarea-custom-control.d.ts

@@ -0,0 +1,2 @@
+import type { CustomControlInitializer } from "./custom-control";
+export declare const textareaCustomControl: CustomControlInitializer;

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/custom-controls/textarea-custom-control.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.textareaCustomControl=void 0;const e=function(e,t){if(!(e instanceof HTMLTextAreaElement)){throw new Error("Element must be an input")}t.newline="\n";t.paragraph="\n\n";t.isMultiline=true;const n=()=>{var n,s;t.update({text:e.value,selection:{start:(n=e.selectionStart)!==null&&n!==void 0?n:0,end:(s=e.selectionEnd)!==null&&s!==void 0?s:0},focus:e===e.ownerDocument.activeElement})};n();t.handle("text",({value:t,start:n,length:s})=>{e.value=e.value.slice(0,n)+t+e.value.slice(n+s);e.dispatchEvent(new Event("change",{bubbles:true}))});t.handle("selection",({start:t,end:n})=>{e.setSelectionRange(t,n)});t.handle("focus",t=>{if(t){e.focus()}else{e.blur()}});e.addEventListener("input",n);e.addEventListener("change",n);e.addEventListener("select",n);e.addEventListener("focusin",n);e.addEventListener("focusout",n);return function(){e.removeEventListener("input",n);e.removeEventListener("change",n);e.removeEventListener("select",n);e.removeEventListener("focusin",n);e.removeEventListener("focusout",n)}};exports.textareaCustomControl=e;

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/diagnostics.d.ts

@@ -0,0 +1,37 @@
+import type { WebTCLCommand } from "./commands";
+import { type WebTCLEvent } from "./events";
+import type { WebTCLState } from "./state";
+type Diagnostics = {
+    isEnabled: true;
+    trace(message: DiagnosticMessage): void;
+} | {
+    isEnabled: false;
+};
+export declare function createDiagnostics(): Diagnostics;
+export type DiagnosticMessageMap = {
+    "worker-created": object;
+    "worker-destroyed": object;
+    "command-executing": {
+        command: WebTCLCommand;
+    };
+    "command-executed": {
+        command: WebTCLCommand;
+    };
+    "state-changed": {
+        state: WebTCLState;
+        newState: WebTCLState;
+        trigger: WebTCLEvent;
+    };
+    "event-dispatching": {
+        event: WebTCLEvent;
+    };
+    "event-dispatched": {
+        event: WebTCLEvent;
+    };
+};
+export type DiagnosticMessage = {
+    [K in keyof DiagnosticMessageMap]: {
+        type: K;
+    } & DiagnosticMessageMap[K];
+}[keyof DiagnosticMessageMap];
+export {};

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/diagnostics.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.createDiagnostics=n;const e=require("../package-info");const t=require("./events");let s=0;function n(){var n;const r=s++;switch((n=sessionStorage.getItem("WEBTCL_ENABLE_DIAGNOSTICS"))!==null&&n!==void 0?n:""){case"console":{let s=0;return{isEnabled:true,trace(n){const o=s++;console.log("%s@%s:[%d][%d]:%s at %f\n%s",e.name,e.version,r,o,n.type,(0,t.currentTimestamp)(),JSON.stringify(n,null,2))}}}default:return{isEnabled:false}}}

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/dom-observable.d.ts

@@ -0,0 +1,13 @@
+import { Observable } from "rxjs";
+export type ControlsMutation = {
+    type: "childList";
+    target: HTMLElement;
+    added: HTMLElement[];
+    removed: HTMLElement[];
+} | {
+    type: "attributes";
+    target: HTMLElement;
+    attributeName: string;
+};
+export declare const attributesToObserve: ("data-dragon-container" | "data-nusa-container" | "data-dragon-concept-name" | "data-nusa-concept-name" | "data-dragon-enabled" | "data-nusa-enabled")[];
+export declare function createDomObservable(target: Node): Observable<ControlsMutation>;

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/dom-observable.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.attributesToObserve=void 0;exports.createDomObservable=r;const e=require("rxjs");const t=require("./webtcl-attributes");exports.attributesToObserve=[...t.DragonAttributesMap.container,...t.DragonAttributesMap.conceptName,...t.DragonAttributesMap.isEnabled];function r(t){return new e.Observable(e=>{const r=new MutationObserver(t=>{t.forEach(t=>{if(!t.target||t.target.nodeType!==Node.ELEMENT_NODE){return}if(t.type==="childList"){const r=Array.from(t.addedNodes).filter(e=>e.nodeType===Node.ELEMENT_NODE);const o=Array.from(t.removedNodes).filter(e=>e.nodeType===Node.ELEMENT_NODE);if(r.length===0&&o.length===0){return}e.next({type:"childList",target:t.target,added:r,removed:o})}if(t.type==="attributes"&&t.attributeName){e.next({type:"attributes",target:t.target,attributeName:t.attributeName})}})});const o={childList:true,subtree:true,attributes:true,attributeFilter:exports.attributesToObserve};r.observe(t,o);return()=>{r.disconnect()}})}

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/events.d.ts

@@ -0,0 +1,39 @@
+import type { ProcessingStatus } from "./processing-status";
+import type { WebTCLState } from "./state";
+type EventMap = {
+    initialized: Pick<WebTCLState, "isInitialized" | "isDisabled">;
+    focusChanged: {
+        id: string;
+        isFocused: boolean;
+    };
+    disposed: undefined;
+    controlChanged: {
+        id: string;
+        text: string;
+        selection: {
+            start: number;
+            length: number;
+        };
+    };
+    statusChanged: {
+        id: string;
+        status: ProcessingStatus;
+    };
+    controlsChanged: Pick<WebTCLState, "textControls" | "focusedControl">;
+};
+export type WebTCLEvents = {
+    [K in keyof EventMap]: EventMap[K] extends undefined ? {
+        type: K;
+        timestamp: number;
+    } : {
+        type: K;
+        timestamp: number;
+    } & EventMap[K];
+};
+export type WebTCLEvent = WebTCLEvents[keyof WebTCLEvents];
+/**
+ * Get the current time in high resolution milliseconds
+ * @returns the current time in milliseconds
+ */
+export declare const currentTimestamp: () => number;
+export {};

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/events.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.currentTimestamp=void 0;const e=()=>performance.timeOrigin+performance.now();exports.currentTimestamp=e;

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/iframe-support.d.ts

@@ -0,0 +1,29 @@
+import type { CustomControlCollection } from "./custom-controls";
+/**
+ * Options for configuring iframe message handling.
+ *
+ * @property contextWindow - The window context in which the iframe is running.
+ * @property customControls - (Optional) A collection of custom controls to be used within the iframe.
+ */
+export type IframeMessagesOptions = {
+    contextWindow: Window;
+    customControls?: CustomControlCollection;
+};
+/**
+ * Subscribes to messages sent to the current window from its parent and forwards them as commmands to the web-tcl client.
+ * It also subscribes to events coming from the web-tcl client and fowards them to its parent as messages.
+ *
+ * @remarks
+ * **IMPORTANT:** This function should only be called when running inside an iframe.
+ *
+ * - Listens for messages from the parent window and forwards them to the WebTCL client.
+ * - Forwards events from the WebTCL client back to the parent window using `postMessage`.
+ * - Manages all subscriptions and resources, cleaning them up when the returned unsubscribe function is called.
+ *
+ * @param options - Configuration options for the subscription.
+ * @param options.contextWindow - The window context in which the iframe is running.
+ * @param options.customControls - (Optional) A collection of custom control types to be used within the iframe.
+ * @returns A cleanup function that unsubscribes from all events and disposes the WebTCL client.
+ * @throws Error if called outside of an iframe context.
+ */
+export declare function subscribeToIframeMessages({ contextWindow, customControls }: IframeMessagesOptions): () => void;

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/iframe-support.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.subscribeToIframeMessages=n;const e=require("rxjs");const r=require("./webtcl-client");const s=require("./webtcl-controller");const t=require("../speech-document");const o=require("../logger/logging");function n({contextWindow:n,customControls:a}){if(!i(n)){throw Error("Not running inside an iframe")}const c=(0,s.createController)({speechdocument:new t.SpeechDocument({customControls:a})});const u=(0,r.createClient)({controller:c});const g=new e.Subscription;let d="";function m(e){try{if(!d){o.logger.warning("iframe-support.sendToParent","originOfSubscriber is not set");return}n.parent.postMessage(e,d)}catch(e){o.logger.error("iframe-support.subscribeToIframeMessages","Failed to send message to parent:",e)}}const p=(0,e.fromEvent)(n,"message");g.add(p.subscribe(e=>{if(!e.data){o.logger.debug("iframe-support.messages$.subscribe","message.data is empty");return}if(e.source!==n.parent){o.logger.debug("iframe-support.messages$.subscribe",`message is not from parent`);return}if(!c.isValidCommand(e.data)){o.logger.debug("iframe-support.messages$.subscribe","message.data is not a valid WebTCLCommand");return}if(e.data.type==="initialize"){d=e.origin}u.commands.send(e.data)}));g.add(u.events.receiveAll().subscribe(e=>{m(e)}));n.parent.postMessage({type:"dragon-iframe-support-ready"},"*");return()=>{u.dispose();g.unsubscribe()}}function i(e){try{return e.self!==e.top}catch(e){return true}}

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/index.d.ts

@@ -0,0 +1,26 @@
+import type { WebTCLClient } from "./webtcl-client";
+import type { CustomControlInitializer, CustomControlCollection } from "./custom-controls";
+import { getAttributeValue, setAttributeValue, hasAttribute, removeAttribute } from "./webtcl-attributes";
+export type { WebTCLCommands, WebTCLCommand } from "./commands";
+export type { WebTCLEvents, WebTCLEvent } from "./events";
+export type { WebTCLState } from "./state";
+export type { WebTCLClient };
+export { subscribeToIframeMessages } from "./iframe-support";
+export type { AdditionalReplaceTextParameters, FormattingBoundary } from "./types";
+export { FormattingBoundaries } from "./types";
+export declare const webTCLAttributes: {
+    getValue: typeof getAttributeValue;
+    setValue: typeof setAttributeValue;
+    has: typeof hasAttribute;
+    remove: typeof removeAttribute;
+};
+export type { CustomControlInitializer, CustomControlCollection };
+export type WebTCLClientOptions = {
+    selector: string;
+    /**
+     * Custom Controls
+     * @see {@link CustomControlCollection}
+     */
+    customControls?: CustomControlCollection;
+};
+export declare function createClient({ customControls, ...otherOptions }: WebTCLClientOptions): WebTCLClient;

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.webTCLAttributes=exports.FormattingBoundaries=exports.subscribeToIframeMessages=void 0;exports.createClient=i;const e=require("tslib");const t=require("../speech-document");const r=require("./webtcl-controller");const s=require("./webtcl-client");const o=require("./webtcl-attributes");var u=require("./iframe-support");Object.defineProperty(exports,"subscribeToIframeMessages",{enumerable:true,get:function(){return u.subscribeToIframeMessages}});var n=require("./types");Object.defineProperty(exports,"FormattingBoundaries",{enumerable:true,get:function(){return n.FormattingBoundaries}});exports.webTCLAttributes={getValue:o.getAttributeValue,setValue:o.setAttributeValue,has:o.hasAttribute,remove:o.removeAttribute};function i(o){var{customControls:u}=o,n=e.__rest(o,["customControls"]);const i=(0,r.createController)(Object.assign(Object.assign({},n),{speechdocument:new t.SpeechDocument({customControls:u})}));return(0,s.createClient)({controller:i})}

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/processing-status.d.ts

@@ -0,0 +1 @@
+export type ProcessingStatus = "pending" | "idle";

package/node_modules/@hccm/web-tcl/dist/cjs/webtcl/processing-status.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});