@pie-players/pie-assessment-toolkit 0.2.0

package/dist/tools/tool-coordinator.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Tool Coordinator Store (Svelte-specific)
+ *
+ * Svelte store-based implementation of tool coordination.
+ * This is a framework-specific alternative to the class-based ToolCoordinator service.
+ *
+ * **When to use:**
+ * - In Svelte components that need reactive tool state
+ * - When you want automatic subscription/unsubscription
+ *
+ * **When NOT to use:**
+ * - In framework-agnostic code
+ * - When you need fine-grained control over service lifecycle
+ * - In testing scenarios (prefer class-based ToolCoordinator with DI)
+ *
+ * For framework-agnostic code, use the class-based ToolCoordinator from services/.
+ */
+import type { ToolCoordinator, ToolId, ToolState } from "./types";
+interface ToolCoordinatorState {
+    tools: Map<ToolId, ToolState>;
+    highestZIndex: number;
+    activeTool: ToolId | null;
+}
+declare const subscribe: (this: void, run: import("svelte/store").Subscriber<ToolCoordinatorState>, invalidate?: () => void) => import("svelte/store").Unsubscriber;
+/**
+ * Register a new tool with the coordinator
+ */
+export declare function registerTool(id: ToolId, name: string, element?: HTMLElement): void;
+/**
+ * Unregister a tool
+ */
+export declare function unregisterTool(id: ToolId): void;
+/**
+ * Show a tool
+ */
+export declare function showTool(id: ToolId): void;
+/**
+ * Hide a tool
+ */
+export declare function hideTool(id: ToolId): void;
+/**
+ * Toggle a tool's visibility
+ */
+export declare function toggleTool(id: ToolId): void;
+/**
+ * Bring a tool to front (highest z-index)
+ * Can be called with either a tool ID or an element directly
+ */
+export declare function bringToFront(idOrElement: ToolId | HTMLElement): void;
+/**
+ * Update tool element reference
+ */
+export declare function updateToolElement(id: ToolId, element: HTMLElement): void;
+/**
+ * Hide all tools
+ */
+export declare function hideAllTools(): void;
+/**
+ * Get tool state
+ */
+export declare function getToolState(id: ToolId): ToolState | undefined;
+/**
+ * Check if a tool is visible
+ */
+export declare function isToolVisible(id: ToolId): boolean;
+export declare const visibleTools: import("svelte/store").Readable<ToolState[]>;
+export declare const activeTool: import("svelte/store").Readable<ToolState | null | undefined>;
+export declare const toolCoordinatorStore: ToolCoordinator & {
+    subscribe: typeof subscribe;
+};
+/** @deprecated Use toolCoordinatorStore instead */
+export declare const toolCoordinator: ToolCoordinator & {
+    subscribe: typeof subscribe;
+};
+export {};
+//# sourceMappingURL=tool-coordinator.d.ts.map

package/dist/tools/tool-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-coordinator.d.ts","sourceRoot":"","sources":["../../src/tools/tool-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAElE,UAAU,oBAAoB;IAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AASD,QAAA,MAAQ,SAAS,4IAAyD,CAAC;AAE3E;;GAEG;AACH,wBAAgB,YAAY,CAC3B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACnB,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAQ/C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAgBzC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAazC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAS3C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA8BpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAWxE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CASnC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAG9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAGD,eAAO,MAAM,YAAY,8CAExB,CAAC;AAGF,eAAO,MAAM,UAAU,+DAEtB,CAAC;AAIF,eAAO,MAAM,oBAAoB,EAAE,eAAe,GAAG;IACpD,SAAS,EAAE,OAAO,SAAS,CAAC;CAa5B,CAAC;AAGF,mDAAmD;AACnD,eAAO,MAAM,eAAe;eAjBhB,OAAO,SAAS;CAiBuB,CAAC"}

package/dist/tools/tool-coordinator.js

@@ -0,0 +1,197 @@
+/**
+ * Tool Coordinator Store (Svelte-specific)
+ *
+ * Svelte store-based implementation of tool coordination.
+ * This is a framework-specific alternative to the class-based ToolCoordinator service.
+ *
+ * **When to use:**
+ * - In Svelte components that need reactive tool state
+ * - When you want automatic subscription/unsubscription
+ *
+ * **When NOT to use:**
+ * - In framework-agnostic code
+ * - When you need fine-grained control over service lifecycle
+ * - In testing scenarios (prefer class-based ToolCoordinator with DI)
+ *
+ * For framework-agnostic code, use the class-based ToolCoordinator from services/.
+ */
+import { derived, get, writable } from "svelte/store";
+const initialState = {
+    tools: new Map(),
+    highestZIndex: 1000,
+    activeTool: null,
+};
+// Create the writable store
+const { subscribe, update } = writable(initialState);
+/**
+ * Register a new tool with the coordinator
+ */
+export function registerTool(id, name, element) {
+    update((state) => {
+        state.tools.set(id, {
+            id,
+            name,
+            isVisible: false,
+            isActive: false,
+            zIndex: state.highestZIndex,
+            element,
+        });
+        return state;
+    });
+}
+/**
+ * Unregister a tool
+ */
+export function unregisterTool(id) {
+    update((state) => {
+        state.tools.delete(id);
+        if (state.activeTool === id) {
+            state.activeTool = null;
+        }
+        return state;
+    });
+}
+/**
+ * Show a tool
+ */
+export function showTool(id) {
+    update((state) => {
+        const tool = state.tools.get(id);
+        if (tool) {
+            tool.isVisible = true;
+            tool.isActive = true;
+            tool.zIndex = ++state.highestZIndex;
+            state.activeTool = id;
+            // Update element z-index if available
+            if (tool.element) {
+                tool.element.style.zIndex = String(tool.zIndex);
+            }
+        }
+        return state;
+    });
+}
+/**
+ * Hide a tool
+ */
+export function hideTool(id) {
+    update((state) => {
+        const tool = state.tools.get(id);
+        if (tool) {
+            tool.isVisible = false;
+            tool.isActive = false;
+            if (state.activeTool === id) {
+                state.activeTool = null;
+            }
+        }
+        return state;
+    });
+}
+/**
+ * Toggle a tool's visibility
+ */
+export function toggleTool(id) {
+    const state = get({ subscribe });
+    const tool = state.tools.get(id);
+    if (tool?.isVisible) {
+        hideTool(id);
+    }
+    else {
+        showTool(id);
+    }
+}
+/**
+ * Bring a tool to front (highest z-index)
+ * Can be called with either a tool ID or an element directly
+ */
+export function bringToFront(idOrElement) {
+    update((state) => {
+        // If given an element directly, just update its z-index
+        if (idOrElement instanceof HTMLElement) {
+            idOrElement.style.zIndex = String(++state.highestZIndex);
+            return state;
+        }
+        // Otherwise, treat as tool ID (legacy behavior)
+        const id = idOrElement;
+        const tool = state.tools.get(id);
+        if (tool && tool.isVisible) {
+            tool.zIndex = ++state.highestZIndex;
+            tool.isActive = true;
+            state.activeTool = id;
+            // Update element z-index if available
+            if (tool.element) {
+                tool.element.style.zIndex = String(tool.zIndex);
+            }
+            // Deactivate other tools
+            state.tools.forEach((t, tId) => {
+                if (tId !== id) {
+                    t.isActive = false;
+                }
+            });
+        }
+        return state;
+    });
+}
+/**
+ * Update tool element reference
+ */
+export function updateToolElement(id, element) {
+    update((state) => {
+        const tool = state.tools.get(id);
+        if (tool) {
+            tool.element = element;
+            if (tool.isVisible && element) {
+                element.style.zIndex = String(tool.zIndex);
+            }
+        }
+        return state;
+    });
+}
+/**
+ * Hide all tools
+ */
+export function hideAllTools() {
+    update((state) => {
+        state.tools.forEach((tool) => {
+            tool.isVisible = false;
+            tool.isActive = false;
+        });
+        state.activeTool = null;
+        return state;
+    });
+}
+/**
+ * Get tool state
+ */
+export function getToolState(id) {
+    const state = get({ subscribe });
+    return state.tools.get(id);
+}
+/**
+ * Check if a tool is visible
+ */
+export function isToolVisible(id) {
+    return getToolState(id)?.isVisible ?? false;
+}
+// Derived store for getting all visible tools
+export const visibleTools = derived({ subscribe }, ($state) => Array.from($state.tools.values()).filter((tool) => tool.isVisible));
+// Derived store for getting active tool
+export const activeTool = derived({ subscribe }, ($state) => $state.activeTool ? $state.tools.get($state.activeTool) : null);
+// Export the main store with explicit type
+// Renamed to toolCoordinatorStore to distinguish from class-based ToolCoordinator
+export const toolCoordinatorStore = {
+    subscribe,
+    registerTool,
+    unregisterTool,
+    showTool,
+    hideTool,
+    toggleTool,
+    bringToFront,
+    updateToolElement,
+    hideAllTools,
+    getToolState,
+    isToolVisible,
+};
+// Backward compatibility alias (deprecated - use toolCoordinatorStore)
+/** @deprecated Use toolCoordinatorStore instead */
+export const toolCoordinator = toolCoordinatorStore;
+//# sourceMappingURL=tool-coordinator.js.map

package/dist/tools/tool-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-coordinator.js","sourceRoot":"","sources":["../../src/tools/tool-coordinator.ts"],"names":[],"mappings":"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"}