@pie-players/pie-assessment-toolkit 0.3.25 → 0.3.27

package/dist/services/framework-error.d.ts

@@ -0,0 +1,34 @@
+import type { ToolConfigDiagnostic } from "./tool-config-validation.js";
+export type FrameworkErrorKind = "tool-config" | "runtime-init" | "runtime-dispose" | "coordinator-init" | "provider-init" | "provider-register" | "tts-init" | "unknown";
+export type FrameworkErrorSeverity = "warning" | "error";
+export interface FrameworkErrorModel {
+    kind: FrameworkErrorKind;
+    severity: FrameworkErrorSeverity;
+    source: string;
+    message: string;
+    details: string[];
+    recoverable: boolean;
+    cause?: unknown;
+}
+export declare function toFrameworkErrorModel(args: {
+    kind: FrameworkErrorKind;
+    severity?: FrameworkErrorSeverity;
+    source: string;
+    message: string;
+    details?: string[];
+    recoverable?: boolean;
+    cause?: unknown;
+}): FrameworkErrorModel;
+export declare function frameworkErrorFromUnknown(args: {
+    kind: FrameworkErrorKind;
+    source: string;
+    error: unknown;
+    recoverable?: boolean;
+}): FrameworkErrorModel;
+export declare function frameworkErrorFromToolConfigDiagnostics(args: {
+    source: string;
+    diagnostics: ToolConfigDiagnostic[];
+    recoverable?: boolean;
+}): FrameworkErrorModel;
+export declare function formatFrameworkErrorForConsole(error: FrameworkErrorModel): string;
+//# sourceMappingURL=framework-error.d.ts.map

package/dist/services/framework-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-error.d.ts","sourceRoot":"","sources":["../../src/services/framework-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAC3B,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,mBAAmB,GACnB,UAAU,GACV,SAAS,CAAC;AAEb,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,mBAAmB,CAUtB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC/C,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,mBAAmB,CAYtB;AAED,wBAAgB,uCAAuC,CAAC,IAAI,EAAE;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,mBAAmB,CAetB;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAIjF"}

package/dist/services/framework-error.js

@@ -0,0 +1,43 @@
+export function toFrameworkErrorModel(args) {
+    return {
+        kind: args.kind,
+        severity: args.severity ?? "error",
+        source: args.source,
+        message: args.message,
+        details: [...(args.details || [])],
+        recoverable: args.recoverable === true,
+        cause: args.cause,
+    };
+}
+export function frameworkErrorFromUnknown(args) {
+    const message = args.error instanceof Error && args.error.message.trim().length > 0
+        ? args.error.message
+        : String(args.error || "Unknown framework error");
+    return toFrameworkErrorModel({
+        kind: args.kind,
+        source: args.source,
+        message,
+        recoverable: args.recoverable,
+        cause: args.error,
+    });
+}
+export function frameworkErrorFromToolConfigDiagnostics(args) {
+    const details = args.diagnostics.map((diagnostic) => `${diagnostic.path}: ${diagnostic.message}`);
+    const message = details.length > 0
+        ? "Invalid tools config."
+        : "Invalid tools config (no diagnostics details were provided).";
+    return toFrameworkErrorModel({
+        kind: "tool-config",
+        source: args.source,
+        message,
+        details,
+        recoverable: args.recoverable,
+    });
+}
+export function formatFrameworkErrorForConsole(error) {
+    const prefix = `[pie-framework:${error.kind}:${error.source}]`;
+    if (error.details.length === 0)
+        return `${prefix} ${error.message}`;
+    return `${prefix} ${error.message}\n- ${error.details.join("\n- ")}`;
+}
+//# sourceMappingURL=framework-error.js.map

package/dist/services/framework-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-error.js","sourceRoot":"","sources":["../../src/services/framework-error.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,qBAAqB,CAAC,IAQrC;IACA,OAAO;QACN,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,OAAO;QAClC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAClC,WAAW,EAAE,IAAI,CAAC,WAAW,KAAK,IAAI;QACtC,KAAK,EAAE,IAAI,CAAC,KAAK;KACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAKzC;IACA,MAAM,OAAO,GACZ,IAAI,CAAC,KAAK,YAAY,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAClE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;QACpB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAC;IACpD,OAAO,qBAAqB,CAAC;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO;QACP,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;KACjB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uCAAuC,CAAC,IAIvD;IACA,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CACnC,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAC3D,CAAC;IACF,MAAM,OAAO,GACZ,OAAO,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,uBAAuB;QACzB,CAAC,CAAC,8DAA8D,CAAC;IACnE,OAAO,qBAAqB,CAAC;QAC5B,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO;QACP,OAAO;QACP,WAAW,EAAE,IAAI,CAAC,WAAW;KAC7B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAA0B;IACxE,MAAM,MAAM,GAAG,kBAAkB,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;IAC/D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;IACpE,OAAO,GAAG,MAAM,IAAI,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AACtE,CAAC"}

package/dist/services/tool-config-validation.d.ts

@@ -0,0 +1,31 @@
+import { type CanonicalToolsConfig } from "./tools-config-normalizer.js";
+import { type FrameworkErrorModel } from "./framework-error.js";
+import type { ToolRegistry } from "./ToolRegistry.js";
+export type ToolConfigStrictness = "off" | "warn" | "error";
+export type ToolConfigDiagnosticSeverity = "warning" | "error";
+export interface ToolConfigDiagnostic {
+    code: "tools.unknownToolId" | "tools.unsupportedLevel" | "tools.unknownProviderKey" | "tools.deprecatedProviderKey" | "tools.providerSanitizeFailed" | "tools.providerValidateFailed" | "tools.invalidProviderValidation";
+    severity: ToolConfigDiagnosticSeverity;
+    path: string;
+    message: string;
+    toolId?: string;
+    providerId?: string;
+}
+export interface ToolConfigValidationOptions {
+    strictness?: ToolConfigStrictness;
+    source?: string;
+    toolRegistry?: ToolRegistry | null;
+}
+export interface ToolConfigValidationResult {
+    config: CanonicalToolsConfig;
+    diagnostics: ToolConfigDiagnostic[];
+}
+export declare function frameworkErrorFromToolConfigValidation(args: {
+    source: string;
+    diagnostics?: ToolConfigDiagnostic[] | null;
+    error?: unknown;
+    recoverable?: boolean;
+}): FrameworkErrorModel;
+export declare function normalizeToolConfigStrictness(value: unknown): ToolConfigStrictness;
+export declare function normalizeAndValidateToolsConfig(input?: Partial<CanonicalToolsConfig> | null, options?: ToolConfigValidationOptions): ToolConfigValidationResult;
+//# sourceMappingURL=tool-config-validation.d.ts.map

package/dist/services/tool-config-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-config-validation.d.ts","sourceRoot":"","sources":["../../src/services/tool-config-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,oBAAoB,EAGzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAGN,KAAK,mBAAmB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGxE,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACpC,IAAI,EACD,qBAAqB,GACrB,wBAAwB,GACxB,0BAA0B,GAC1B,6BAA6B,GAC7B,8BAA8B,GAC9B,8BAA8B,GAC9B,iCAAiC,CAAC;IACrC,QAAQ,EAAE,4BAA4B,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC3C,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,0BAA0B;IAC1C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAED,wBAAgB,sCAAsC,CAAC,IAAI,EAAE;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,mBAAmB,CActB;AAID,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,OAAO,GACZ,oBAAoB,CAKtB;AA6OD,wBAAgB,+BAA+B,CAC9C,KAAK,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI,EAC5C,OAAO,GAAE,2BAAgC,GACvC,0BAA0B,CA+D5B"}

package/dist/services/tool-config-validation.js

@@ -0,0 +1,242 @@
+import { normalizeToolsConfig, } from "./tools-config-normalizer.js";
+import { frameworkErrorFromToolConfigDiagnostics, frameworkErrorFromUnknown, } from "./framework-error.js";
+import { createPackagedToolRegistry } from "./createDefaultToolRegistry.js";
+export function frameworkErrorFromToolConfigValidation(args) {
+    if (Array.isArray(args.diagnostics) && args.diagnostics.length > 0) {
+        return frameworkErrorFromToolConfigDiagnostics({
+            source: args.source,
+            diagnostics: args.diagnostics,
+            recoverable: args.recoverable,
+        });
+    }
+    return frameworkErrorFromUnknown({
+        kind: "tool-config",
+        source: args.source,
+        error: args.error ?? new Error("Invalid tools config"),
+        recoverable: args.recoverable,
+    });
+}
+const DEFAULT_STRICTNESS = "error";
+export function normalizeToolConfigStrictness(value) {
+    if (value === "off" || value === "warn" || value === "error") {
+        return value;
+    }
+    return DEFAULT_STRICTNESS;
+}
+function createDiagnostic(diagnostic) {
+    return diagnostic;
+}
+function getRegistryToolMap(toolRegistry) {
+    if (!toolRegistry)
+        return new Map();
+    return new Map(toolRegistry
+        .getAllTools()
+        .slice()
+        .sort((left, right) => left.toolId.localeCompare(right.toolId))
+        .map((tool) => [tool.toolId, tool]));
+}
+function sanitizeProviderConfig(providerId, providerConfig, tool, diagnostics) {
+    if (!providerConfig || !tool?.provider?.sanitizeConfig)
+        return providerConfig;
+    try {
+        const sanitized = tool.provider.sanitizeConfig(providerConfig);
+        if (!sanitized || typeof sanitized !== "object" || Array.isArray(sanitized)) {
+            diagnostics.push(createDiagnostic({
+                code: "tools.providerSanitizeFailed",
+                severity: "error",
+                path: `providers.${providerId}`,
+                message: `Provider sanitizer for "${providerId}" must return an object.`,
+                providerId,
+                toolId: providerId,
+            }));
+            return providerConfig;
+        }
+        return sanitized;
+    }
+    catch (error) {
+        diagnostics.push(createDiagnostic({
+            code: "tools.providerSanitizeFailed",
+            severity: "error",
+            path: `providers.${providerId}`,
+            message: `Provider sanitizer failed for "${providerId}": ${error instanceof Error ? error.message : String(error)}`,
+            providerId,
+            toolId: providerId,
+        }));
+        return providerConfig;
+    }
+}
+function validateProviderConfig(providerId, providerConfig, tool, diagnostics) {
+    if (!providerConfig || !tool?.provider?.validateConfig)
+        return;
+    try {
+        const providerDiagnostics = tool.provider.validateConfig(providerConfig);
+        if (!Array.isArray(providerDiagnostics)) {
+            diagnostics.push(createDiagnostic({
+                code: "tools.invalidProviderValidation",
+                severity: "error",
+                path: `providers.${providerId}`,
+                message: `Provider validator for "${providerId}" must return an array.`,
+                providerId,
+                toolId: providerId,
+            }));
+            return;
+        }
+        for (const diagnostic of providerDiagnostics) {
+            diagnostics.push({
+                ...diagnostic,
+                path: diagnostic.path || `providers.${providerId}`,
+                providerId: diagnostic.providerId || providerId,
+                toolId: diagnostic.toolId || providerId,
+            });
+        }
+    }
+    catch (error) {
+        diagnostics.push(createDiagnostic({
+            code: "tools.providerValidateFailed",
+            severity: "error",
+            path: `providers.${providerId}`,
+            message: `Provider validator failed for "${providerId}": ${error instanceof Error ? error.message : String(error)}`,
+            providerId,
+            toolId: providerId,
+        }));
+    }
+}
+function collectPlacementDiagnostics(config, toolMap, diagnostics) {
+    if (toolMap.size === 0)
+        return;
+    const levelOrder = ["section", "item", "passage"];
+    for (const level of levelOrder) {
+        for (const toolId of config.placement[level]) {
+            const tool = toolMap.get(toolId);
+            if (!tool) {
+                diagnostics.push(createDiagnostic({
+                    code: "tools.unknownToolId",
+                    severity: "error",
+                    path: `placement.${level}`,
+                    message: `Unknown tool id "${toolId}" in placement.${level}.`,
+                    toolId,
+                }));
+                continue;
+            }
+            const supportsLevel = tool.supportedLevels.includes(level);
+            // Leniency policy: section-capable tools are tolerated in item placement.
+            // This avoids strict failures for common host config patterns while still
+            // enforcing upward-invalid placements (for example item-only -> section).
+            const allowSectionToolInItemPlacement = level === "item" && tool.supportedLevels.includes("section");
+            if (!supportsLevel && !allowSectionToolInItemPlacement) {
+                diagnostics.push(createDiagnostic({
+                    code: "tools.unsupportedLevel",
+                    severity: "error",
+                    path: `placement.${level}`,
+                    message: `Tool "${toolId}" does not support level "${level}".`,
+                    toolId,
+                }));
+            }
+        }
+    }
+}
+function collectPolicyDiagnostics(config, toolMap, diagnostics) {
+    if (toolMap.size === 0)
+        return;
+    for (const toolId of config.policy.allowed || []) {
+        if (toolMap.has(toolId))
+            continue;
+        diagnostics.push(createDiagnostic({
+            code: "tools.unknownToolId",
+            severity: "error",
+            path: "policy.allowed",
+            message: `Unknown tool id "${toolId}" in policy.allowed.`,
+            toolId,
+        }));
+    }
+    for (const toolId of config.policy.blocked || []) {
+        if (toolMap.has(toolId))
+            continue;
+        diagnostics.push(createDiagnostic({
+            code: "tools.unknownToolId",
+            severity: "error",
+            path: "policy.blocked",
+            message: `Unknown tool id "${toolId}" in policy.blocked.`,
+            toolId,
+        }));
+    }
+}
+function collectProviderKeyDiagnostics(config, toolMap, hasDeprecatedTtsKey, diagnostics) {
+    if (hasDeprecatedTtsKey) {
+        diagnostics.push(createDiagnostic({
+            code: "tools.deprecatedProviderKey",
+            severity: "error",
+            path: "providers.tts",
+            message: `Provider key "tts" is no longer supported. Use "providers.textToSpeech".`,
+            providerId: "tts",
+            toolId: "textToSpeech",
+        }));
+    }
+    for (const providerId of Object.keys(config.providers).sort()) {
+        if (toolMap.size === 0 || toolMap.has(providerId))
+            continue;
+        diagnostics.push(createDiagnostic({
+            code: "tools.unknownProviderKey",
+            severity: "error",
+            path: `providers.${providerId}`,
+            message: `Unknown provider key "${providerId}".`,
+            providerId,
+            toolId: providerId,
+        }));
+    }
+}
+function emitWarnings(diagnostics, source) {
+    if (diagnostics.length === 0)
+        return;
+    for (const diagnostic of diagnostics) {
+        const prefix = `[tool-config-validation:${source}]`;
+        console.warn(`${prefix} ${diagnostic.path} - ${diagnostic.message}`);
+    }
+}
+function throwValidationError(diagnostics, source) {
+    const formatted = diagnostics
+        .map((diagnostic) => `- ${diagnostic.path}: ${diagnostic.message}`)
+        .join("\n");
+    throw new Error(`[tool-config-validation:${source}] Invalid tools config:\n${formatted}`);
+}
+export function normalizeAndValidateToolsConfig(input, options = {}) {
+    const strictness = normalizeToolConfigStrictness(options.strictness);
+    const source = options.source ?? "tools";
+    const registryTools = getRegistryToolMap(options.toolRegistry ?? createPackagedToolRegistry());
+    const normalized = normalizeToolsConfig(input);
+    const diagnostics = [];
+    const hasDeprecatedTtsKey = Object.prototype.hasOwnProperty.call(normalized.providers, "tts");
+    const nextProviders = {
+        ...(normalized.providers || {}),
+    };
+    for (const providerId of Object.keys(nextProviders).sort()) {
+        if (providerId === "tts") {
+            delete nextProviders.tts;
+            continue;
+        }
+        const tool = registryTools.get(providerId);
+        nextProviders[providerId] = sanitizeProviderConfig(providerId, nextProviders[providerId], tool, diagnostics);
+        validateProviderConfig(providerId, nextProviders[providerId], tool, diagnostics);
+    }
+    const nextConfig = {
+        ...normalized,
+        providers: nextProviders,
+    };
+    collectPlacementDiagnostics(nextConfig, registryTools, diagnostics);
+    collectPolicyDiagnostics(nextConfig, registryTools, diagnostics);
+    collectProviderKeyDiagnostics(nextConfig, registryTools, hasDeprecatedTtsKey, diagnostics);
+    if (hasDeprecatedTtsKey) {
+        throwValidationError(diagnostics.filter((entry) => entry.code === "tools.deprecatedProviderKey"), source);
+    }
+    if (strictness === "warn") {
+        emitWarnings(diagnostics, source);
+    }
+    if (strictness === "error" && diagnostics.length > 0) {
+        throwValidationError(diagnostics, source);
+    }
+    return {
+        config: nextConfig,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=tool-config-validation.js.map

package/dist/services/tool-config-validation.js.map

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

package/dist/services/toolbar-items.d.ts

@@ -21,6 +21,7 @@ export interface ToolbarLinkItem extends ToolbarItemBase {
 }
 export type ToolbarItem = ToolbarButtonItem | ToolbarLinkItem;
 export declare function isToolbarLinkItem(item: ToolbarItem): item is ToolbarLinkItem;
+export declare function isValidToolbarItemShape(value: unknown): value is ToolbarItem;
 export declare function isInlineSvgIcon(icon: string | undefined): boolean;
 export declare function isExternalIconUrl(icon: string | undefined): boolean;
 //# sourceMappingURL=toolbar-items.d.ts.map

package/dist/services/toolbar-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar-items.d.ts","sourceRoot":"","sources":["../../src/services/toolbar-items.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACzD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,GAAG,CAAC,EAAE,KAAK,CAAC;CACZ;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,IAAI,eAAe,CAE5E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE"}
+{"version":3,"file":"toolbar-items.d.ts","sourceRoot":"","sources":["../../src/services/toolbar-items.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACzD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,GAAG,CAAC,EAAE,KAAK,CAAC;CACZ;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,IAAI,eAAe,CAE5E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAgB5E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE"}

package/dist/services/toolbar-items.js

@@ -1,10 +1,36 @@
 export function isToolbarLinkItem(item) {
     return typeof item.href === "string";
 }
+export function isValidToolbarItemShape(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const item = value;
+    if (typeof item.id !== "string" || item.id.trim().length === 0)
+        return false;
+    if (typeof item.label !== "string" || item.label.trim().length === 0)
+        return false;
+    if (item.ariaLabel !== undefined && typeof item.ariaLabel !== "string")
+        return false;
+    if (item.icon !== undefined && typeof item.icon !== "string")
+        return false;
+    if (item.tooltip !== undefined && typeof item.tooltip !== "string")
+        return false;
+    if (item.active !== undefined && typeof item.active !== "boolean")
+        return false;
+    if (item.disabled !== undefined && typeof item.disabled !== "boolean")
+        return false;
+    const hasHref = typeof item.href === "string";
+    const hasOnClick = typeof item.onClick === "function";
+    if (hasHref === hasOnClick)
+        return false;
+    if (hasHref)
+        return true;
+    return hasOnClick;
+}
 export function isInlineSvgIcon(icon) {
-    return typeof icon === "string" && icon.startsWith("<svg");
+    return typeof icon === "string" && icon.trimStart().startsWith("<svg");
 }
 export function isExternalIconUrl(icon) {
-    return typeof icon === "string" && icon.startsWith("http");
+    return typeof icon === "string" && icon.trimStart().startsWith("http");
 }
 //# sourceMappingURL=toolbar-items.js.map

package/dist/services/toolbar-items.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar-items.js","sourceRoot":"","sources":["../../src/services/toolbar-items.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IAClD,OAAO,OAAQ,IAAwB,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAwB;IACvD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACzD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"toolbar-items.js","sourceRoot":"","sources":["../../src/services/toolbar-items.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IAClD,OAAO,OAAQ,IAAwB,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7E,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnF,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3E,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACjF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAChF,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAEpF,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC;IACtD,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAwB;IACvD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACzD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC"}

package/dist/services/tts/visual-line-ranges.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Derive visual line box ranges inside a root element for TTS read-along.
+ *
+ * Cloud TTS (Polly, Google, etc.) only provides word/sentence character offsets.
+ * “Lines” are layout-dependent (wrap, zoom, font size), so we compute them in
+ * the browser from the same DOM Range already used for word highlighting.
+ */
+/**
+ * Intersect `range` with the contents of `root` (document order).
+ * Returns null if there is no non-empty intersection.
+ */
+export declare function intersectRangeWithElement(range: Range, root: Element): Range | null;
+/**
+ * Returns one Range per visual line that intersects `focus`, expanded to the
+ * full width of each line within `root`. Falls back to `[intersectedFocus]`
+ * when layout or caret APIs are unavailable.
+ */
+export declare function visualLineRangesForFocusInRoot(root: Element, focus: Range): Range[];
+//# sourceMappingURL=visual-line-ranges.d.ts.map

package/dist/services/tts/visual-line-ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-line-ranges.d.ts","sourceRoot":"","sources":["../../../src/services/tts/visual-line-ranges.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgDH;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,GACX,KAAK,GAAG,IAAI,CA+Bd;AA6DD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC7C,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,KAAK,GACV,KAAK,EAAE,CA0GT"}