@pie-players/pie-assessment-toolkit 0.3.75 → 1.0.0-beta.1

package/dist/services/tts/provider-options.d.ts

@@ -7,7 +7,11 @@ import type { BoundarySpacingMode } from "./text-processing.js";
  * each value at runtime.
  */
 export interface ToolkitTTSProviderOptions extends TTSProviderOptions {
-    /** Highlight words or sentences while reading. Defaults by provider capability. */
+    /**
+     * Highlight words or sentences while reading. Defaults by provider
+     * capability. A playback that sends no word boundaries highlights its
+     * sentence in either mode.
+     */
     highlightMode?: "word" | "sentence";
     /** Locale for text processing; the toolkit sets it per speak. */
     locale?: string;
@@ -38,4 +42,11 @@ export interface ToolkitTTSProviderOptions extends TTSProviderOptions {
 /** A provider configuration as the toolkit reads it. */
 export interface ToolkitTTSConfig extends TTSConfig {
     providerOptions?: ToolkitTTSProviderOptions;
+    /**
+     * Highlight math token by token; `false` highlights each formula as one
+     * block. The highlight pipeline reads it, and providers ignore it.
+     *
+     * @default true
+     */
+    mathTokenHighlighting?: boolean;
 }

package/dist/services/tts/ssml/spoken-text.js

@@ -8,7 +8,7 @@ import { normalizeTextForSpeech } from "../text-processing.js";
  * stripping used by:
  *   - the catalog span aligner (`catalog-span-alignment.ts`),
  *   - the math speech tokenizer (`math-alignment/speech-tokenizer.ts`),
- *   - the runtime generated-speech path (PIE-623).
+ *   - the runtime generated-speech path.
  *
  * Keeping one implementation guarantees provider word-boundary offsets (which
  * are into the raw SSML string) map to the same spoken text on every path.

package/dist/services/tts/start-failure.d.ts

@@ -1,10 +1,3 @@
-/**
- * The `code` a speak's rejection carries when speech could not start, as
- * distinct from a failure while speaking. Read by shape: several copies of the
- * toolkit can share a page, so an error class from one fails `instanceof` in
- * another.
- */
-export declare const TTS_START_FAILED_CODE = "tts-start-failed";
 /** Whether a speak rejected because speech could not start. */
 export declare function isTTSStartFailure(error: unknown): boolean;
 /** Marks `cause` as a start failure, keeping its message and stack. */

package/dist/services/tts/start-failure.js

@@ -4,7 +4,7 @@
  * toolkit can share a page, so an error class from one fails `instanceof` in
  * another.
  */
-export const TTS_START_FAILED_CODE = "tts-start-failed";
+const TTS_START_FAILED_CODE = "tts-start-failed";
 /** Whether a speak rejected because speech could not start. */
 export function isTTSStartFailure(error) {
     return (typeof error === "object" &&

package/dist/services/tts/text-segmentation.d.ts

@@ -6,6 +6,11 @@ export interface SentenceSegmentationOptions {
     locale?: string;
     useSentenceSegmenter?: boolean;
 }
+/**
+ * `text` split into sentences at their offsets in it, by Intl.Segmenter unless
+ * the policy disables it or it is missing. The segmenter path drops
+ * whitespace-only segments; the regex fallback keeps every match.
+ */
 export declare const segmentSentences: (text: string, options?: SentenceSegmentationOptions) => SentenceSegment[];
 /**
  * `text` in pieces of at most `maxLength` characters: whole sentences while they

package/dist/services/tts/text-segmentation.js

@@ -1,11 +1,14 @@
+/**
+ * `text` split into sentences at their offsets in it, by Intl.Segmenter unless
+ * the policy disables it or it is missing. The segmenter path drops
+ * whitespace-only segments; the regex fallback keeps every match.
+ */
 export const segmentSentences = (text, options) => {
-    const useSentenceSegmenter = options?.useSentenceSegmenter !== false;
-    try {
-        if (!useSentenceSegmenter) {
-            throw new Error("Segmenter disabled by policy");
-        }
-        const Segmenter = globalThis.Intl?.Segmenter;
-        if (typeof Segmenter === "function") {
+    const Segmenter = options?.useSentenceSegmenter === false
+        ? undefined
+        : globalThis.Intl?.Segmenter;
+    if (typeof Segmenter === "function") {
+        try {
             const segmenter = new Segmenter(options?.locale, {
                 granularity: "sentence",
             });
@@ -18,9 +21,9 @@ export const segmentSentences = (text, options) => {
             if (parsed.length > 0)
                 return parsed;
         }
-    }
-    catch {
-        // Fall through to regex segmentation.
+        catch {
+            // Fall through to regex segmentation.
+        }
     }
     const sentenceRegex = /[^.!?]+(?:[.!?]+|$)/g;
     const raw = text.match(sentenceRegex) || [text];

package/dist/services/tts-runtime-config.d.ts

@@ -1,9 +1,9 @@
-import type { TTSConfig } from "./TTSService.js";
+import type { SpeedRateBucket } from "@pie-players/pie-tts";
 import type { TextToSpeechToolProviderConfig, ToolProviderConfig } from "./tools-config-normalizer.js";
 import { type SREMathSpeechOptions } from "./tts/math-speech.js";
+import type { ToolkitTTSConfig } from "./tts/provider-options.js";
 export type TTSLayoutMode = "reserved-row" | "expanding-row" | "floating-overlay" | "left-aligned";
 export interface TTSHostToolbarLayout {
-    mount: "before-buttons";
     controlsRow: {
         reserveSpace: boolean;
         expandWhenToolActive: boolean;
@@ -50,6 +50,11 @@ export interface TTSRuntimeSettings {
     language?: string;
     transportMode?: "pie" | "custom";
     endpointMode?: "synthesizePath" | "rootPost";
+    /**
+     * The probe the server provider runs before it reports ready: `voices` reads
+     * the voices route, `endpoint` sends OPTIONS to the synthesis route, `none`
+     * probes nothing. Defaults to `voices` on a `server` backend.
+     */
     endpointValidationMode?: "voices" | "endpoint" | "none";
     includeAuthOnAssetFetch?: boolean;
     /** Origins trusted with the `Authorization` header on asset fetches. */
@@ -58,9 +63,13 @@ export interface TTSRuntimeSettings {
     credentials?: "omit" | "same-origin" | "include";
     /** Headers sent with every request to the TTS server. */
     headers?: Record<string, string>;
-    validateEndpoint?: boolean;
+    /** Server-side caching, sent on the `custom` transport. */
     cache?: boolean;
-    speedRate?: "slow" | "medium" | "fast";
+    /**
+     * Speed bucket sent on the `custom` transport; derived from `rate` when
+     * unset.
+     */
+    speedRate?: SpeedRateBucket;
     /**
      * The custom transport's locale, sent on every read in place of the content
      * language. Where markup and the tool name no language it is also the read's
@@ -100,10 +109,16 @@ export interface TTSRuntimeSettings {
     /**
      * Options passed through to the provider. The fields derived from the
      * settings above, such as `locale` and the Polly engine, win over these.
+     * The `custom` transport reads the three typed keys; the settings of the
+     * same names win over them.
      */
-    providerOptions?: Record<string, unknown>;
+    providerOptions?: {
+        speedRate?: SpeedRateBucket;
+        lang_id?: string;
+        cache?: boolean;
+        [option: string]: unknown;
+    };
 }
-export declare const normalizeTTSLayoutMode: (value: unknown, fallback?: TTSLayoutMode) => TTSLayoutMode;
 export declare const normalizeTTSSpeedControlOptions: (value: unknown) => NormalizedTTSSpeedOption[];
 export declare const formatTTSSpeedOptionsAsText: (values: number[]) => string;
 /**
@@ -114,18 +129,23 @@ export declare const formatTTSSpeedOptionsAsText: (values: number[]) => string;
 export declare const parseTTSSpeedOptionsFromText: (text: string) => number[];
 /**
  * The runtime settings of a `textToSpeech` provider entry: its top-level keys
- * with defaults applied. `enabled` and the runtime `provider` object belong to
- * the tool registration and are dropped.
+ * with defaults applied, an unknown `layoutMode` resolved to `left-aligned`.
+ * `enabled` and the runtime `provider` object belong to the tool registration
+ * and are dropped.
  */
-export declare const resolveTTSRuntimeSettings: (config: TextToSpeechToolProviderConfig | ToolProviderConfig | TTSRuntimeSettings | undefined) => TTSRuntimeSettings;
+export declare const resolveTTSRuntimeSettings: (config: TextToSpeechToolProviderConfig | ToolProviderConfig | TTSRuntimeSettings | undefined) => TTSRuntimeSettings & {
+    layoutMode: TTSLayoutMode;
+};
 export declare const resolveTTSBackend: (config: TTSRuntimeSettings) => NonNullable<TTSRuntimeSettings["backend"]>;
 /**
  * The provider configuration built from host settings: the contract's portable
  * fields plus the server adapter's, under the adapter's names.
  */
-export type RuntimeTTSConfig = Pick<TTSConfig, "voice" | "rate" | "pitch" | "providerOptions" | "mathTokenHighlighting"> & Pick<TTSRuntimeSettings, "apiEndpoint" | "language" | "transportMode" | "endpointMode" | "endpointValidationMode" | "includeAuthOnAssetFetch" | "assetOrigins" | "credentials" | "headers" | "validateEndpoint"> & {
+export type RuntimeTTSConfig = Pick<ToolkitTTSConfig, "voice" | "rate" | "pitch" | "providerOptions" | "mathTokenHighlighting"> & Pick<TTSRuntimeSettings, "apiEndpoint" | "language" | "transportMode" | "endpointMode" | "endpointValidationMode" | "includeAuthOnAssetFetch" | "assetOrigins" | "credentials" | "headers"> & {
     provider?: TTSRuntimeSettings["serverProvider"];
 };
 export declare const buildRuntimeTTSConfig: (config: TTSRuntimeSettings) => RuntimeTTSConfig;
-export declare const resolveTTSLayoutMode: (config: TTSRuntimeSettings) => TTSLayoutMode;
-export declare const resolveTTSHostToolbarLayout: (config: TTSRuntimeSettings) => TTSHostToolbarLayout;
+/** The toolbar layout hints for the layout mode of resolved settings. */
+export declare const resolveTTSHostToolbarLayout: (config: {
+    layoutMode: TTSLayoutMode;
+}) => TTSHostToolbarLayout;

package/dist/services/tts-runtime-config.js

@@ -7,10 +7,14 @@ const VALID_TTS_LAYOUT_MODES = new Set([
 ]);
 const toRecord = (value) => value && typeof value === "object" ? value : {};
 const withDefault = (value, fallback) => value === undefined ? fallback : value;
-export const normalizeTTSLayoutMode = (value, fallback = "left-aligned") => typeof value === "string" &&
+/** A custom server provider speaks the custom transport, as `ServerTTSProvider` does on its own. */
+const defaultTransportMode = (config) => resolveTTSBackend(config) === "server" && config.serverProvider === "custom"
+    ? "custom"
+    : "pie";
+const normalizeTTSLayoutMode = (value) => typeof value === "string" &&
     VALID_TTS_LAYOUT_MODES.has(value)
     ? value
-    : fallback;
+    : "left-aligned";
 const DEFAULT_TTS_SPEED_CONTROL_OPTIONS = Object.freeze([
     { rate: 0.8, label: "Slow", ariaLabel: "Slow speed" },
     { rate: 1, label: "Normal", ariaLabel: "Normal speed", default: true },
@@ -57,11 +61,7 @@ export const normalizeTTSSpeedControlOptions = (value) => {
         if (rate === undefined || dedupedRates.has(rate))
             continue;
         dedupedRates.add(rate);
-        const defaultLabel = rate === 1
-            ? "Normal"
-            : typeof entry === "number"
-                ? formatSpeedLabel(rate)
-                : formatSpeedLabel(rate);
+        const defaultLabel = rate === 1 ? "Normal" : formatSpeedLabel(rate);
         const label = typeof entry === "number"
             ? defaultLabel
             : trimOptionalText(record.label) || defaultLabel;
@@ -148,9 +148,8 @@ const applyRuntimeDefaults = (config) => {
     const withServerDefaults = {
         ...withLayoutDefaults,
         apiEndpoint: withDefault(withLayoutDefaults.apiEndpoint, "/api/tts"),
-        transportMode: withDefault(withLayoutDefaults.transportMode, "pie"),
+        transportMode: withDefault(withLayoutDefaults.transportMode, defaultTransportMode(config)),
         endpointValidationMode: withDefault(withLayoutDefaults.endpointValidationMode, "voices"),
-        validateEndpoint: withDefault(withLayoutDefaults.validateEndpoint, true),
         includeAuthOnAssetFetch: withDefault(withLayoutDefaults.includeAuthOnAssetFetch, false),
         rate: withDefault(withLayoutDefaults.rate, 1.0),
         language: withDefault(withLayoutDefaults.language, "en-US"),
@@ -167,8 +166,9 @@ const applyRuntimeDefaults = (config) => {
 };
 /**
  * The runtime settings of a `textToSpeech` provider entry: its top-level keys
- * with defaults applied. `enabled` and the runtime `provider` object belong to
- * the tool registration and are dropped.
+ * with defaults applied, an unknown `layoutMode` resolved to `left-aligned`.
+ * `enabled` and the runtime `provider` object belong to the tool registration
+ * and are dropped.
  */
 export const resolveTTSRuntimeSettings = (config) => {
     const { enabled: _enabled, provider: _provider, ...settings } = toRecord(config);
@@ -178,7 +178,7 @@ export const resolveTTSBackend = (config) => config.backend || "browser";
 export const buildRuntimeTTSConfig = (config) => {
     const runtimeProvider = resolveTTSBackend(config) === "server" ? config.serverProvider : undefined;
     const polly = runtimeProvider === "polly";
-    const transportMode = config.transportMode || (runtimeProvider === "custom" ? "custom" : "pie");
+    const transportMode = config.transportMode || defaultTransportMode(config);
     const mathSpeech = normalizeSREMathSpeechOptions(config.mathSpeech);
     const runtimeConfig = {
         voice: config.defaultVoice,
@@ -224,7 +224,6 @@ export const buildRuntimeTTSConfig = (config) => {
         assetOrigins: config.assetOrigins,
         credentials: config.credentials,
         headers: config.headers,
-        validateEndpoint: config.validateEndpoint,
         // Toolkit-level highlight setting carried through the config channel
         // (like apiEndpoint/transportMode); consumed by the highlight pipeline,
         // ignored by providers. Only forwarded when set so the pipeline default
@@ -235,13 +234,11 @@ export const buildRuntimeTTSConfig = (config) => {
     };
     return runtimeConfig;
 };
-export const resolveTTSLayoutMode = (config) => normalizeTTSLayoutMode(config.layoutMode);
+/** The toolbar layout hints for the layout mode of resolved settings. */
 export const resolveTTSHostToolbarLayout = (config) => {
-    const layoutMode = resolveTTSLayoutMode(config);
-    switch (layoutMode) {
+    switch (config.layoutMode) {
         case "reserved-row":
             return {
-                mount: "before-buttons",
                 controlsRow: {
                     reserveSpace: true,
                     expandWhenToolActive: false,
@@ -252,7 +249,6 @@ export const resolveTTSHostToolbarLayout = (config) => {
             };
         case "expanding-row":
             return {
-                mount: "before-buttons",
                 controlsRow: {
                     reserveSpace: false,
                     expandWhenToolActive: true,
@@ -263,7 +259,6 @@ export const resolveTTSHostToolbarLayout = (config) => {
             };
         case "floating-overlay":
             return {
-                mount: "before-buttons",
                 controlsRow: {
                     reserveSpace: false,
                     expandWhenToolActive: false,
@@ -275,7 +270,6 @@ export const resolveTTSHostToolbarLayout = (config) => {
         case "left-aligned":
         default:
             return {
-                mount: "before-buttons",
                 controlsRow: {
                     reserveSpace: false,
                     expandWhenToolActive: false,

package/dist/tools/content-capability-resolution.d.ts

@@ -34,7 +34,7 @@ import type { CatalogOwnerSnapshot } from "../services/AccessibilityCatalogResol
 export type ContentCapabilityPolicy = {
     outcome: "granted";
     /** Feature parameters carried by the decision, if any. */
-    parameters?: unknown;
+    parameters?: Record<string, unknown>;
 }
 /**
  * No source granted it and none denied it. A capability declaring
@@ -65,7 +65,7 @@ export interface ResolvedContentCapability {
      * tell them apart at render time.
      */
     granted: boolean;
-    parameters?: unknown;
+    parameters?: Record<string, unknown>;
     /** Whatever the capability's own `resolve` returned; never inspected here. */
     content: unknown;
 }

package/dist/tools/registration.d.ts

@@ -23,6 +23,8 @@
 export type { HostedToolContext, HostedToolSize, ToolContentDependencyContext, ToolModuleLoader, ToolProviderDescriptor, ToolRegistration, ToolRenderElement, ToolSurfaceRenderContext, ToolSurfaceRenderResult, ToolSurfaceServices, ToolToolbarButtonDefinition, ToolToolbarRenderResult, ToolbarContext, } from "../services/ToolRegistry.js";
 export { ToolRegistry } from "../services/ToolRegistry.js";
 export { resolveToolRegistrationName } from "../services/ToolRegistry.js";
+export type { ToolFailurePhase } from "../services/tool-failure.js";
+export { reportToolFailure } from "../services/tool-failure.js";
 export type { CatalogOwnerSnapshot } from "../services/AccessibilityCatalogResolver.js";
 export type { ToolSelectionAction, ToolSelectionContext, } from "../services/selection-action.js";
 export { resolveFallbackToolIcon } from "../services/tool-icons.js";
@@ -30,13 +32,13 @@ export type { ContentCapabilityPhase, ContentCapabilityPolicy, ResolveContentCap
 export { resolveContentCapabilities } from "./content-capability-resolution.js";
 export type { ToolSurfaceHost, ToolSurfaceHostInput, ToolSurfaceHostOptions, ToolSurfaceHostSnapshot, ToolSurfaceScope, } from "./tool-surface-host.js";
 export { createToolSurfaceHost } from "./tool-surface-host.js";
-export type { ToolContext } from "../services/tool-context.js";
-export { hasChoiceInteraction, hasMathContent, hasReadableText, hasScienceContent, } from "../services/tool-context.js";
+export type { ElementSupports, ToolContext, } from "../services/tool-context.js";
+export { elementSupports, hasMathContent, hasReadableText, hasSpokenContent, hasScienceContent, } from "../services/tool-context.js";
 export type { ParsedToolInstanceId } from "../services/tool-instance-id.js";
 export { createScopedToolId, parseScopedToolId, } from "../services/tool-instance-id.js";
 export type { ToolComponentFactory, ToolComponentFactoryMap, ToolComponentOverrides, ToolTagMap, } from "./tool-tag-map.js";
 export { createToolElement, resolveToolTag } from "./tool-tag-map.js";
-export { applyOverlaySurface, createScopedVisibilityBinding, syncButtonAndOverlayVisibility, } from "./registrations/toolbar-registration-helpers.js";
+export { applyOverlaySurface, createScopedVisibilityBinding, syncButtonAndOverlayVisibility, TOOL_ACTIVE_CHANGE_EVENT, } from "./registrations/toolbar-registration-helpers.js";
 export type { HighlightCoordinatorApi, ToolCoordinatorApi, ToolkitCoordinatorApi, TtsServiceApi, } from "../services/interfaces.js";
 export type { AssessmentToolkitRegionScopeContext, AssessmentToolkitRuntimeContext, AssessmentToolkitShellContext, } from "../context/assessment-toolkit-context.js";
 export { connectToolRegionScopeContext, connectToolRuntimeContext, connectToolShellContext, createToolCoordinatorRegistration, type ToolCoordinatorRegistration, } from "../runtime/tool-host-contract.js";
@@ -48,11 +50,10 @@ export { findShellScopeHost, resolveContentRegion, } from "../runtime/content-re
 export { composedClosest, composedContains, flatTextContent, isShadowRootNode, retargetToTree, } from "../services/tts/flat-tree.js";
 export type { ToolPlacementLevel } from "../services/tools-config-normalizer.js";
 export type { CalculatorToolProviderConfig, TextToSpeechToolProviderConfig, ToolProviderConfig, } from "../services/tools-config-normalizer.js";
-export type { ToolProviderApi, ToolProviderCapabilities, } from "../services/tool-providers/ToolProviderApi.js";
+export type { ToolProviderApi } from "../services/tool-providers/ToolProviderApi.js";
 export { TTSToolProvider } from "../services/tool-providers/index.js";
 export type { NormalizedTTSSpeedOption, TTSLayoutMode, TTSSpeedOption, } from "../services/tts-runtime-config.js";
-export { buildRuntimeTTSConfig, formatTTSSpeedOptionsAsText, normalizeTTSLayoutMode, normalizeTTSSpeedControlOptions, parseTTSSpeedOptionsFromText, resolveTTSHostToolbarLayout, resolveTTSLayoutMode, resolveTTSRuntimeSettings, } from "../services/tts-runtime-config.js";
-export { PIE_TTS_CONTROL_HANDOFF_EVENT } from "../services/tts-control-events.js";
+export { buildRuntimeTTSConfig, formatTTSSpeedOptionsAsText, normalizeTTSSpeedControlOptions, parseTTSSpeedOptionsFromText, resolveTTSHostToolbarLayout, resolveTTSRuntimeSettings, } from "../services/tts-runtime-config.js";
 export { bindTtsAudioHandoff, pauseTtsForMediaAudio, } from "../services/audio-handoff.js";
 export { isTTSStartFailure } from "../services/tts/start-failure.js";
 export { browserVoiceMatchesLanguage, findBrowserVoice, waitForBrowserVoices, } from "../services/tts/browser-provider.js";

package/dist/tools/registration.js

@@ -25,15 +25,17 @@ export { ToolRegistry } from "../services/ToolRegistry.js";
 // title is the registration's name, so the shell needs the same `nameKey`-then-
 // `name` precedence the toolbar uses rather than the raw English field.
 export { resolveToolRegistrationName } from "../services/ToolRegistry.js";
+export { reportToolFailure } from "../services/tool-failure.js";
 // So a gateway button and the toolbar button for the same tool draw one icon.
 export { resolveFallbackToolIcon } from "../services/tool-icons.js";
 export { resolveContentCapabilities } from "./content-capability-resolution.js";
 export { createToolSurfaceHost } from "./tool-surface-host.js";
-export { hasChoiceInteraction, hasMathContent, hasReadableText, hasScienceContent, } from "../services/tool-context.js";
+export { elementSupports, hasMathContent, hasReadableText, hasSpokenContent, hasScienceContent, } from "../services/tool-context.js";
 export { createScopedToolId, parseScopedToolId, } from "../services/tool-instance-id.js";
 export { createToolElement, resolveToolTag } from "./tool-tag-map.js";
-// Toolbar button/overlay wiring shared by every toolbar-toggle registration.
-export { applyOverlaySurface, createScopedVisibilityBinding, syncButtonAndOverlayVisibility, } from "./registrations/toolbar-registration-helpers.js";
+// Toolbar button/overlay wiring shared by every toolbar-toggle registration,
+// and the event a tool element announces its own active state with.
+export { applyOverlaySurface, createScopedVisibilityBinding, syncButtonAndOverlayVisibility, TOOL_ACTIVE_CHANGE_EVENT, } from "./registrations/toolbar-registration-helpers.js";
 export { connectToolRegionScopeContext, connectToolRuntimeContext, connectToolShellContext, createToolCoordinatorRegistration, } from "../runtime/tool-host-contract.js";
 export { ZIndexLayer } from "../services/ToolCoordinator.js";
 export { HighlightColor, HighlightCoordinator, } from "../services/HighlightCoordinator.js";
@@ -43,12 +45,11 @@ export { composedClosest, composedContains, flatTextContent, isShadowRootNode, r
 // The TTS provider stays here because it is written against the `pie-tts`
 // contract package, which the toolkit's own `TTSService` also depends on.
 export { TTSToolProvider } from "../services/tool-providers/index.js";
-export { buildRuntimeTTSConfig, formatTTSSpeedOptionsAsText, normalizeTTSLayoutMode, normalizeTTSSpeedControlOptions, parseTTSSpeedOptionsFromText, resolveTTSHostToolbarLayout, resolveTTSLayoutMode, resolveTTSRuntimeSettings, } from "../services/tts-runtime-config.js";
-// Read-aloud coordination for a tool that plays or controls speech: the control
-// handoff event between TTS surfaces, pausing speech while a media element plays,
-// recognising a start failure the TTS service reports, and choosing a browser
-// voice for a language once the browser has published its voices.
-export { PIE_TTS_CONTROL_HANDOFF_EVENT } from "../services/tts-control-events.js";
+export { buildRuntimeTTSConfig, formatTTSSpeedOptionsAsText, normalizeTTSSpeedControlOptions, parseTTSSpeedOptionsFromText, resolveTTSHostToolbarLayout, resolveTTSRuntimeSettings, } from "../services/tts-runtime-config.js";
+// Read-aloud coordination for a tool that plays or controls speech: pausing
+// speech while a media element plays, recognising a start failure the TTS
+// service reports, and choosing a browser voice for a language once the browser
+// has published its voices.
 export { bindTtsAudioHandoff, pauseTtsForMediaAudio, } from "../services/audio-handoff.js";
 export { isTTSStartFailure } from "../services/tts/start-failure.js";
 export { browserVoiceMatchesLanguage, findBrowserVoice, waitForBrowserVoices, } from "../services/tts/browser-provider.js";

package/dist/tools/registrations/toolbar-registration-helpers.d.ts

@@ -1,5 +1,11 @@
 import type { ToolToolbarButtonDefinition, ToolToolbarRenderResult, ToolbarContext } from "../../services/ToolRegistry.js";
 export type ToolOverlaySurface = "default" | "frameless";
+/**
+ * The event a tool element dispatches, bubbling and composed, with
+ * `{ active: boolean }` as its detail when it opens or closes its own panel.
+ * A registration relays it as the toolbar button's active state.
+ */
+export declare const TOOL_ACTIVE_CHANGE_EVENT = "pie-tool-active-change";
 export declare function createScopedVisibilityBinding(toolId: string, toolbarContext: ToolbarContext): {
     fullToolId: string;
     isActive: () => boolean;

package/dist/tools/registrations/toolbar-registration-helpers.js

@@ -1,4 +1,10 @@
 import { createScopedToolId } from "../../services/tool-instance-id.js";
+/**
+ * The event a tool element dispatches, bubbling and composed, with
+ * `{ active: boolean }` as its detail when it opens or closes its own panel.
+ * A registration relays it as the toolbar button's active state.
+ */
+export const TOOL_ACTIVE_CHANGE_EVENT = "pie-tool-active-change";
 export function createScopedVisibilityBinding(toolId, toolbarContext) {
     const fullToolId = createScopedToolId(toolId, toolbarContext.scope.level, toolbarContext.scope.scopeId);
     return {

package/dist/tools/tool-surface-host.js

@@ -43,12 +43,6 @@ function stableSerializableJson(value) {
         if (typeof current === "undefined") {
             return undefined;
         }
-        if (typeof current === "function" || typeof current === "symbol") {
-            throw new TypeError(`${path} is not JSON-serializable`);
-        }
-        if (typeof current === "bigint") {
-            throw new TypeError(`${path} is not JSON-serializable`);
-        }
         if (typeof current !== "object") {
             throw new TypeError(`${path} is not JSON-serializable`);
         }
@@ -339,7 +333,7 @@ export function createToolSurfaceHost(onSnapshot, options) {
                     // test-administration override grants it.
                     placed = true;
                     granted = entry.required || entry.alwaysAvailable;
-                    parameters = entry.settings;
+                    parameters = entry.parameters;
                     break;
                 }
                 if (!placed)
@@ -465,7 +459,6 @@ export function createToolSurfaceHost(onSnapshot, options) {
                 }
             }
             report(toolId, "render", `Tool "${toolId}" failed to render into the "${current.surface}" surface.`, error);
-            return;
         }
     }
     function reconcile() {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-assessment-toolkit",
-	"version": "0.3.75",
+	"version": "1.0.0-beta.1",
 	"type": "module",
 	"description": "PIE assessment toolkit: composable services + reference implementation for assessment players and tool coordination",
 	"license": "MIT",
@@ -54,8 +54,10 @@
 			"import": "./dist/policy/engine.js"
 		}
 	},
+	"customElements": "custom-elements.json",
 	"files": [
 		"dist",
+		"custom-elements.json",
 		"README.md"
 	],
 	"scripts": {
@@ -67,16 +69,16 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@pie-players/pie-calculator": "0.3.75",
-		"@pie-players/pie-context": "0.3.75",
-		"@pie-players/pie-players-shared": "0.3.75",
-		"@pie-players/pie-tts": "0.3.75",
+		"@pie-players/pie-calculator": "1.0.0-beta.1",
+		"@pie-players/pie-context": "1.0.0-beta.1",
+		"@pie-players/pie-players-shared": "1.0.0-beta.1",
+		"@pie-players/pie-tts": "1.0.0-beta.1",
 		"speech-rule-engine": "5.0.0-rc.4"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.5.15",
 		"@happy-dom/global-registrator": "^20.14.5",
-		"@pie-players/tts-client-server": "0.3.75",
+		"@pie-players/tts-client-server": "1.0.0-beta.1",
 		"svelte": "^5.57.1",
 		"svelte-check": "^4.7.6",
 		"typescript": "^5.9.3"

package/dist/components/chunks/ItemToolBar-bxwyhr5p.js

@@ -1,2 +0,0 @@
-import{ia as h,ja as F}from"./ItemToolBar-7tt7v2xp.js";var Y=["assessment","section","item","passage","rubric"],H=new Set(Y);function U(f){return H.has(f)}function N(f,p,c){let w=f.trim(),E=c.trim();if(!w||!E)throw Error("Tool instance ids require non-empty tool and scope ids");if(!U(p))throw Error(`Unknown tool scope level '${p}'. Register custom levels with registerToolScopeLevel().`);return`${w}:${p}:${E}`}function q(f){let p=f.split(":");if(p.length!==3)return null;let[c,w,E]=p;if(!c||!E)return null;if(!U(w))return null;return{baseToolId:c,scopeLevel:w,scopeId:E}}function B(f){return(...p)=>{console.debug(`[${f}]`,...p)}}var z=B("ToolCoordinator"),T;(function(f){f[f.BASE=0]="BASE",f[f.TOOL=1000]="TOOL",f[f.MODAL=2000]="MODAL",f[f.CONTROL=3000]="CONTROL",f[f.HIGHLIGHT=4000]="HIGHLIGHT"})(T||(T={}));function J(f,p){if(!p?.baseId)return!0;return(q(f)?.baseToolId??f)===p.baseId}function M(f){return{id:f.id,name:f.name,isVisible:f.isVisible,element:f.element,layer:f.layer}}class V{tools=new Map;listeners=new Set;subscribe(f){return this.listeners.add(f),()=>{this.listeners.delete(f)}}notifyListeners(){for(let f of this.listeners)try{f()}catch(p){console.warn("[ToolCoordinator] listener failed:",p)}}registerTool(f,p,c,w){z("registerTool called:",{id:f,name:p,hasElement:!!c,layer:w});let E=this.tools.get(f);if(E){E.name=p;let u=E.registered;if(E.registered=!0,w!==void 0&&!E.layerDeclared)E.layer=w,E.layerDeclared=!0,this.stackOnTop(E);else if(!u)this.stackOnTop(E)}else E={id:f,name:p,registered:!0,element:null,layer:w??T.TOOL,layerDeclared:w!==void 0,isVisible:!1,baseZIndex:0},this.tools.set(f,E),this.stackOnTop(E);if(c)this.updateToolElement(f,c)}unregisterTool(f){let p=this.tools.get(f);if(!p?.registered)return;this.detachElement(p),p.registered=!1}releaseTool(f){let p=this.tools.get(f);if(!p)return;if(this.detachElement(p),this.tools.delete(f),p.isVisible)this.notifyListeners()}showTool(f){let p=this.tools.get(f);if(!p){z(`Tool ${f} not found`);return}if(p.element)this.bringToFront(p.element);this.setVisible(p,!0)}hideTool(f){let p=this.tools.get(f);if(!p){z(`Tool ${f} not found`);return}this.setVisible(p,!1)}toggleTool(f){let p=this.tools.get(f);if(!p){z(`Tool ${f} not found`);return}if(p.isVisible)this.hideTool(f);else this.showTool(f)}isToolVisible(f){return this.tools.get(f)?.isVisible??!1}bringToFront(f){let p=Array.from(this.tools.values()).find((c)=>c.element===f);if(!p)return;this.stackOnTop(p)}getRegisteredTools(){return Array.from(this.tools.values()).filter((f)=>f.registered).map((f)=>f.id)}getToolElement(f){return this.tools.get(f)?.element??null}setVisible(f,p){if(f.isVisible===p)return;f.isVisible=p,this.notifyListeners()}detachElement(f){if(f.element&&f.mouseDownHandler)f.element.removeEventListener("mousedown",f.mouseDownHandler);f.element=null,f.mouseDownHandler=void 0}stackOnTop(f){let p=Array.from(this.tools.values()).filter((w)=>w.registered&&w.layer===f.layer&&w!==f).sort((w,E)=>w.baseZIndex-E.baseZIndex),c=f.layer+p.length+1;if(f.baseZIndex===c&&p.every((w)=>w.baseZIndex<c))return;[...p,f].forEach((w,E)=>{if(w.baseZIndex=f.layer+1+E,w.element)w.element.style.zIndex=String(w.baseZIndex)})}updateToolElement(f,p){let c=this.tools.get(f);if(!c?.registered){z(`Tool ${f} not found`);return}if(c.element===p)return;if(c.element?.isConnected&&c.element.contains(p))return;this.detachElement(c);let w=()=>this.bringToFront(p);if(p.addEventListener("mousedown",w),c.element=p,c.mouseDownHandler=w,p.style.zIndex=String(c.baseZIndex),c.isVisible)this.bringToFront(p)}hideAllTools(f){let p=!1;for(let c of this.tools.values()){if(!c.isVisible||!J(c.id,f))continue;c.isVisible=!1,p=!0}if(p)this.notifyListeners()}getToolState(f){let p=this.tools.get(f);return p?.registered?M(p):void 0}getVisibleTools(f){return Array.from(this.tools.values()).filter((p)=>p.isVisible&&J(p.id,f)).map(M)}}import{dynamicMessageKey as a}from"@pie-players/pie-players-shared/i18n/provider";import{validateCustomElementTag as W}from"@pie-players/pie-players-shared/pie/tag-names";var P=(f,p)=>{let c=p?.toolTagMap?.[f];if(c===void 0&&!f.includes("-"))throw Error(`No element tag is mapped for tool "${f}". Install a tag map on the registry via setComponentOverrides({ toolTagMap }) — for the packaged capabilities, PACKAGED_TOOL_TAG_MAP from "@pie-players/pie-default-tool-loaders".`);return W(c??f,`tool component tag for "${f}"`)};var R=["assessment","section","item","passage","rubric","element"];function j(f,p){if(typeof f!=="string"||f.trim().length===0)throw Error(`Invalid tool registration: "${p}" must be a non-empty string.`)}var S=[{pattern:/<script\b/i,reason:"contains a <script> tag"},{pattern:/\son[a-z]+\s*=/i,reason:"contains an inline event handler (on*=) attribute"},{pattern:/javascript:/i,reason:"contains a javascript: URL"},{pattern:/<foreignObject\b/i,reason:"contains a <foreignObject> element"}];function G(f,p,c){let w=p.trimStart(),E=w.toLowerCase().startsWith("<svg"),u=/^https?:/i.test(w);if(/^data:/i.test(w))throw Error(`Invalid tool registration "${f}": "${c}" may not be a data: URL.`);if(!E&&!u)return;for(let{pattern:X,reason:_}of S)if(X.test(p))throw Error(`Invalid tool registration "${f}": "${c}" ${_}. Inline SVG icons must not include scriptable content.`)}function Q(f){j(f.toolId,"toolId"),j(f.name,"name"),j(f.description,"description");let p=f.activation==="region";if(!p||f.icon!==void 0){if(typeof f.icon!=="string"&&typeof f.icon!=="function")throw Error(`Invalid tool registration "${f.toolId}": "icon" must be a string or function.`)}if(typeof f.icon==="string")G(f.toolId,f.icon,"icon");if(!Array.isArray(f.supportedLevels)||f.supportedLevels.length===0)throw Error(`Invalid tool registration "${f.toolId}": "supportedLevels" must be a non-empty array.`);let c=f.supportedLevels.find((w)=>!R.includes(w));if(c)throw Error(`Invalid tool registration "${f.toolId}": unsupported level "${c}".`);if(f.activation!==void 0&&f.activation!=="toolbar-toggle"&&f.activation!=="selection-gateway"&&f.activation!=="region")throw Error(`Invalid tool registration "${f.toolId}": unsupported activation "${String(f.activation)}".`);if(f.surfaces!==void 0&&(!Array.isArray(f.surfaces)||f.surfaces.some((w)=>typeof w!=="string"||w.trim().length===0)))throw Error(`Invalid tool registration "${f.toolId}": "surfaces" must be an array of non-empty strings.`);if(p&&!f.surfaces?.length)throw Error(`Invalid tool registration "${f.toolId}": region tools must declare at least one host surface in "surfaces".`);if(p&&typeof f.renderSurface!=="function")throw Error(`Invalid tool registration "${f.toolId}": region tools must implement "renderSurface".`);if(f.resolvesWithoutGrant!==void 0&&typeof f.resolvesWithoutGrant!=="boolean")throw Error(`Invalid tool registration "${f.toolId}": "resolvesWithoutGrant" must be a boolean.`);if(f.resolvesWithoutGrant&&!f.requiresAuthoredContent)throw Error(`Invalid tool registration "${f.toolId}": "resolvesWithoutGrant" requires "requiresAuthoredContent".`);if(f.renderSurface!==void 0&&typeof f.renderSurface!=="function")throw Error(`Invalid tool registration "${f.toolId}": "renderSurface" must be a function.`);if(f.renderSurface&&!f.surfaces?.length)throw Error(`Invalid tool registration "${f.toolId}": "renderSurface" requires at least one entry in "surfaces".`);if(f.singletonScope!==void 0&&f.singletonScope!=="section")throw Error(`Invalid tool registration "${f.toolId}": unsupported singletonScope "${String(f.singletonScope)}".`);if(f.activation==="selection-gateway"&&f.singletonScope!=="section")throw Error(`Invalid tool registration "${f.toolId}": selection-gateway tools must declare singletonScope "section".`);if(f.activation!=="region"&&typeof f.isVisibleInContext!=="function")throw Error(`Invalid tool registration "${f.toolId}": "isVisibleInContext" must be a function.`);if(f.isVisibleInContext!==void 0&&typeof f.isVisibleInContext!=="function")throw Error(`Invalid tool registration "${f.toolId}": "isVisibleInContext" must be a function when present.`);if(f.isApplicableToContent!==void 0&&typeof f.isApplicableToContent!=="function")throw Error(`Invalid tool registration "${f.toolId}": "isApplicableToContent" must be a function when present.`);if(f.requiresAuthoredContent!==void 0){if(typeof f.requiresAuthoredContent!=="object"||f.requiresAuthoredContent===null||typeof f.requiresAuthoredContent.resolve!=="function")throw Error(`Invalid tool registration "${f.toolId}": "requiresAuthoredContent" must be an object with a "resolve" function.`)}if(f.renderToolbar!==void 0){if(typeof f.renderToolbar!=="function")throw Error(`Invalid tool registration "${f.toolId}": "renderToolbar" must be a function.`)}else if(!p)throw Error(`Invalid tool registration "${f.toolId}": "renderToolbar" must be a function.`)}class D{tools=new Map;componentOverrides={};watchedUndefinedToolElements=new Set;moduleLoaders=new Map;loadedToolModules=new Set;warnedLoaderReplacements=new Set;warnedUnregisteredAllowedTools=new Set;moduleLoadPromises=new Map;changeListeners=new Set;emitChange(f){for(let p of this.changeListeners)try{p(f)}catch(c){console.warn("[ToolRegistry] change listener failed:",c)}}onRegistryChange(f){this.changeListeners.add(f);let p=!0;return()=>{if(!p)return;p=!1,this.changeListeners.delete(f)}}normalizeToolId(f){return f.trim()}normalizeToolIds(f){return f.map((p)=>this.normalizeToolId(p))}register(f){if(Q(f),this.tools.has(f.toolId))throw Error(`Tool '${f.toolId}' is already registered`);this.tools.set(f.toolId,f),this.emitChange({kind:"register",toolIds:[f.toolId]})}override(f){if(Q(f),!this.tools.has(f.toolId))throw Error(`Cannot override non-existent tool '${f.toolId}'`);this.tools.set(f.toolId,f),this.emitChange({kind:"override",toolIds:[f.toolId]})}unregister(f){if(!this.tools.has(f))return;this.tools.delete(f),this.emitChange({kind:"unregister",toolIds:[f]})}get(f){return this.tools.get(f)}has(f){return this.tools.has(f)}getAllToolIds(){return Array.from(this.tools.keys())}getAllTools(){return Array.from(this.tools.values())}getToolsByLevel(f){return this.getAllTools().filter((p)=>p.supportedLevels.includes(f))}getToolActivation(f){return this.get(f)?.activation||"toolbar-toggle"}getToolSingletonScope(f){return this.get(f)?.singletonScope||null}getToolsBySurface(f){if(!f)return[];return this.getAllTools().filter((p)=>typeof p.renderSurface==="function"&&p.surfaces?.includes(f))}getContentDependentSupportIds(){return this.getAllTools().filter((f)=>f.requiresAuthoredContent).map((f)=>f.toolId).sort()}filterToolIdsByActivation(f,p){return f.filter((c)=>this.getToolActivation(c)===p)}filterVisibleInContext(f,p){let c=[];for(let w of f){let E=this.get(w);if(!E){if(!this.warnedUnregisteredAllowedTools.has(w))this.warnedUnregisteredAllowedTools.add(w),console.warn(`Tool '${w}' is allowed but not registered`);continue}if(!E.supportedLevels.includes(p.level))continue;try{if(E.isVisibleInContext?.(p))c.push(E)}catch(u){console.error(`Error evaluating visibility for tool '${w}':`,u)}}return c}isApplicableToAnyContext(f,p){let c=this.get(f);if(!c?.isApplicableToContent)return!0;if(p.length===0)return!0;return p.some((w)=>{try{return c.isApplicableToContent?.(w)??!0}catch(E){return console.error(`Error evaluating applicability for tool '${f}':`,E),!0}})}getToolMetadata(){return this.getAllTools().map((f)=>({toolId:f.toolId,name:f.name,description:f.description,supportedLevels:f.supportedLevels,activation:f.activation||"toolbar-toggle",singletonScope:f.singletonScope||null,surfaces:f.surfaces||[],requiresAuthoredContent:Boolean(f.requiresAuthoredContent),contentDependencyDescription:f.requiresAuthoredContent?.description??null}))}clear(){let f=this.getAllToolIds();if(f.length===0)return;this.tools.clear(),this.emitChange({kind:"clear",toolIds:f})}setComponentOverrides(f){if(this.componentOverrides===f)return;this.componentOverrides=f,this.emitChange({kind:"component-overrides",toolIds:[]})}setToolModuleLoaders(f){let p=Object.entries(f).filter((w)=>w[1]!==void 0);for(let[w,E]of p)if(j(w,"tool module loader id"),typeof E!=="function")throw Error(`Invalid tool module loader for "${w}": expected a function.`);let c=[];for(let[w,E]of p){if(this.moduleLoaders.get(w)===E)continue;if(this.loadedToolModules.has(w)||this.moduleLoadPromises.has(w)){this.warnLoaderReplacedAfterLoad(w);continue}this.moduleLoaders.set(w,E),c.push(w)}if(c.length>0)this.emitChange({kind:"module-loaders",toolIds:c})}warnLoaderReplacedAfterLoad(f){if(this.warnedLoaderReplacements.has(f))return;this.warnedLoaderReplacements.add(f),console.warn(`[ToolRegistry] Ignored a new module loader for "${f}": its module already loaded, so the elements it defines stay in place. Register loaders before the tool first renders.`)}async ensureToolModuleLoaded(f){if(this.loadedToolModules.has(f))return;let p=this.moduleLoadPromises.get(f);if(p){await p;return}let c=this.moduleLoaders.get(f);if(!c){this.watchUndefinedToolElement(f);return}let w=(async()=>{await c(),this.loadedToolModules.add(f),this.warnIfLoadedToolElementUndefined(f)})();this.moduleLoadPromises.set(f,w);try{await w}finally{this.moduleLoadPromises.delete(f)}}undefinedToolElementTag(f){if(typeof customElements>"u"||typeof document>"u")return null;let p=this.componentOverrides;if(p.toolComponentFactories?.[f])return null;let c;try{c=P(f,p)}catch{return null}return customElements.get(c)?null:c}warnIfLoadedToolElementUndefined(f){let p=this.undefinedToolElementTag(f);if(!p)return;F(document,`loadedToolElementUndefined.${f}.${p}`,`[ToolRegistry] Tool "${f}" renders <${p}>, but its module loader finished without defining it, so the tool renders blank. The tag map and the loader disagree: map "${f}" to the tag its loader defines, or register a loader that defines <${p}>. Reported once per page.`)}watchUndefinedToolElement(f){if(this.watchedUndefinedToolElements.has(f))return;let p=this.undefinedToolElementTag(f);if(!p)return;this.watchedUndefinedToolElements.add(f);let c=document,w=setTimeout(()=>{if(customElements.get(p))return;F(c,`undefinedToolElement.${f}`,`[ToolRegistry] Tool "${f}" renders <${p}>, which is still undefined after ${h/1000} s, and its registry has no module loader for it. Pass toolModuleLoaders to createPackagedToolRegistry (DEFAULT_TOOL_MODULE_LOADERS from @pie-players/pie-default-tool-loaders loads the stock tools), register one with setToolModuleLoaders, or import the tool's package before it renders. Reported once per page.`)},h);customElements.whenDefined(p).then(()=>clearTimeout(w))}async ensureToolModulesLoaded(f){let p=await Promise.allSettled(f.map((w)=>this.ensureToolModuleLoaded(w))),c=new Map;return p.forEach((w,E)=>{if(w.status==="rejected")c.set(f[E],w.reason)}),c}isToolModuleLoaded(f){return this.loadedToolModules.has(f)}renderForToolbar(f,p,c){let w=this.get(f);if(!w)throw Error(`Tool '${f}' is not registered`);if(typeof w.renderToolbar!=="function")throw Error(`Tool '${f}' has activation "${w.activation||"toolbar-toggle"}" and renders into a host surface, not a toolbar. Remove it from toolbar placement.`);let E={...c,componentOverrides:{...this.componentOverrides||{},...c.componentOverrides||{}}};return w.renderToolbar(p,E)}renderForSurface(f,p){let c=this.get(f);if(!c)throw Error(`Tool '${f}' is not registered`);if(typeof c.renderSurface!=="function")throw Error(`Tool '${f}' does not render into a host surface. Surface capabilities declare "surfaces" and implement "renderSurface".`);return c.renderSurface({...p,componentOverrides:{...this.componentOverrides||{},...p.componentOverrides||{}}})}}var b={assessment:[],section:[],item:[],passage:[],rubric:[],element:[]};var C={section:[...b.section],item:[...b.item],passage:[...b.passage]};function A(f){return typeof f==="object"&&f!==null&&!Array.isArray(f)}function O(f,p){if(f==null)return[];if(!Array.isArray(f))throw Error(`Invalid tools config at "${p}": expected an array of tool ids.`);if(f.find((w)=>typeof w!=="string")!==void 0)throw Error(`Invalid tools config at "${p}": all entries must be strings.`);return f}function K(f){if(f==null)return;if(!A(f))throw Error('Invalid tools config at "placement": expected an object with section/item/passage arrays.');return f}function k(f){if(f==null)return;if(!A(f))throw Error('Invalid tools config at "policy": expected an object with allowed/blocked arrays.');return f}function L(f,p){if(p==null)return;if(!A(p))throw Error(`Invalid tools config at "providers.${f}": expected an object.`);let c=p;if("enabled"in c&&c.enabled!==void 0&&typeof c.enabled!=="boolean")throw Error(`Invalid tools config at "providers.${f}.enabled": expected a boolean.`);if("settings"in c&&c.settings!==void 0&&!A(c.settings))throw Error(`Invalid tools config at "providers.${f}.settings": expected an object.`);if("provider"in c&&c.provider!==void 0&&!A(c.provider))throw Error(`Invalid tools config at "providers.${f}.provider": expected an object.`);return c}function Z(f){if(f==null)return{};if(!A(f))throw Error('Invalid tools config at "providers": expected an object keyed by tool id.');let p={};for(let[c,w]of Object.entries(f))p[c]=L(c,w);return p}function $(f){if(!f||f.length===0)return[];let p=new Set;for(let c of f){if(typeof c!=="string")throw Error("Invalid tools config: tool list entries must be strings.");let w=c.trim();if(!w)continue;p.add(w)}return Array.from(p)}function ff(f){if(!f)return[];return $(f.split(",").map((p)=>p.trim()).filter(Boolean))}function v(f,p){if(f==null)return;if(f==="on"||f==="off")return f;throw Error(`Invalid tools config at "${p}": expected "on" or "off", got ${JSON.stringify(f)}.`)}function pf(f){if(f!=null&&!A(f))throw Error('Invalid tools config: expected an object with "policy", "placement", and "providers".');let p=k(f?.policy),c=K(f?.placement),w=Z(f?.providers),E=v(f?.pnpEnforcement,"pnpEnforcement"),u={policy:{allowed:$(O(p?.allowed,"policy.allowed")),blocked:$(O(p?.blocked,"policy.blocked"))},placement:{section:$(O(c?.section,"placement.section")).length?$(O(c?.section,"placement.section")):[...C.section],item:$(O(c?.item,"placement.item")).length?$(O(c?.item,"placement.item")):[...C.item],passage:$(O(c?.passage,"placement.passage")).length?$(O(c?.passage,"placement.passage")):[...C.passage]},providers:w};if(E)u.pnpEnforcement=E;return u}
-export{N as m,T as n,V as o,D as p,$ as q,ff as r,pf as s};