@pie-players/pie-assessment-toolkit 0.3.74 → 1.0.0-beta.0

package/dist/services/I18nService.js

@@ -1,84 +0,0 @@
-/**
- * I18nService
- *
- * The toolkit's view of the shared i18n provider: a delegating wrapper over
- * `SimpleI18n` from `players-shared` that adds toolkit-scoped logging and wires
- * the lazy catalog loaders.
- *
- * It was once a near-verbatim second copy of that class — same fields, same
- * lookup, same plural selection. Duplicate implementations of one contract drift
- * silently, because nothing fails when only one of them is fixed. Keep this a
- * wrapper.
- *
- * Part of PIE Assessment Toolkit.
- */
-import { createPieI18n } from "@pie-players/pie-players-shared/i18n";
-import { createLogger } from "../utils/logger.js";
-const log = createLogger("I18nService");
-/**
- * Toolkit-scoped i18n service.
- *
- * Serves every locale this repository ships, English resident and the rest
- * lazily loaded.
- */
-export class I18nService {
-    i18n;
-    constructor(config = {}) {
-        this.i18n = createPieI18n(config);
-        log("I18nService created", {
-            locale: this.i18n.getLocale(),
-            fallbackLocale: config.fallbackLocale ?? "en-US",
-        });
-    }
-    /**
-     * Set the locale, loading its catalog first.
-     *
-     * Never falls back to the browser locale: a rendered-string change reaches a
-     * host's live delivery on their next install with no build signal on their
-     * side, so the locale has to be something the host asked for.
-     */
-    async initialize(config) {
-        log(`Initializing with locale: ${config.locale ?? this.i18n.getLocale()}`);
-        await this.i18n.initialize(config);
-    }
-    t(key, values) {
-        return this.i18n.t(key, values);
-    }
-    plural(key, options) {
-        return this.i18n.plural(key, options);
-    }
-    getLocale() {
-        return this.i18n.getLocale();
-    }
-    async setLocale(locale) {
-        log(`Setting locale to: ${locale}`);
-        await this.i18n.setLocale(locale);
-    }
-    getDirection() {
-        return this.i18n.getDirection();
-    }
-    getAvailableLocales() {
-        return this.i18n.getAvailableLocales();
-    }
-    isLocaleLoaded(locale) {
-        return this.i18n.isLocaleLoaded(locale);
-    }
-    subscribe(listener) {
-        return this.i18n.subscribe(listener);
-    }
-    hasKey(key) {
-        return this.i18n.hasKey(key);
-    }
-    addCustomMessages(locale, messages) {
-        this.i18n.addCustomMessages(locale, messages);
-    }
-    withLocale(locale) {
-        return this.i18n.withLocale(locale);
-    }
-    formatNumber(value, options) {
-        return this.i18n.formatNumber?.(value, options) ?? String(value);
-    }
-    formatDate(date, options) {
-        return this.i18n.formatDate?.(date, options) ?? date.toISOString();
-    }
-}

package/dist/services/ThemeProvider.d.ts

@@ -1,95 +0,0 @@
-/**
- * ThemeProvider
- *
- * Applies consistent accessibility theming across items and tools.
- * Uses CSS custom properties and classes for framework-agnostic theming.
- *
- * Features:
- * - High contrast mode
- * - Font size scaling (small, normal, large, xlarge)
- * - Color customization (background, foreground, accent)
- * - Consistent theming across shadow DOM boundaries
- * - No framework dependencies
- *
- * Part of PIE Assessment Toolkit.
- */
-import type { ThemeProviderApi } from "./interfaces.js";
-/**
- * Font size options
- */
-export type FontSize = "small" | "normal" | "large" | "xlarge";
-/**
- * Theme configuration
- */
-export interface ThemeConfig {
-    highContrast?: boolean;
-    fontSize?: FontSize;
-    backgroundColor?: string;
-    foregroundColor?: string;
-    accentColor?: string;
-    linkColor?: string;
-    errorColor?: string;
-    successColor?: string;
-    warningColor?: string;
-}
-export declare class ThemeProvider implements ThemeProviderApi {
-    private currentTheme;
-    private styleElement;
-    private rootElement;
-    private styleContainer;
-    constructor(rootElement?: HTMLElement | null);
-    /**
-     * Initialize theme styles
-     */
-    private initializeStyles;
-    /**
-     * Apply theme configuration
-     *
-     * @param config Partial theme configuration (merged with current theme)
-     */
-    applyTheme(config: ThemeConfig): void;
-    /**
-     * Apply CSS custom properties to root element
-     */
-    private applyCSSVariables;
-    /**
-     * Apply CSS classes to root element
-     */
-    private applyCSSClasses;
-    /**
-     * Update global theme styles
-     */
-    private updateGlobalStyles;
-    /**
-     * Set high contrast mode
-     */
-    setHighContrast(enabled: boolean): void;
-    /**
-     * Set font size
-     */
-    setFontSize(size: FontSize): void;
-    /**
-     * Set color scheme
-     */
-    setColors(colors: {
-        backgroundColor?: string;
-        foregroundColor?: string;
-        accentColor?: string;
-    }): void;
-    /**
-     * Get current theme configuration
-     */
-    getCurrentTheme(): Required<ThemeConfig>;
-    /**
-     * Reset to default theme
-     */
-    reset(): void;
-    /**
-     * Adjust color opacity (helper)
-     */
-    private adjustOpacity;
-    /**
-     * Cleanup - remove theme styles
-     */
-    destroy(): void;
-}

package/dist/services/ThemeProvider.js

@@ -1,334 +0,0 @@
-/**
- * ThemeProvider
- *
- * Applies consistent accessibility theming across items and tools.
- * Uses CSS custom properties and classes for framework-agnostic theming.
- *
- * Features:
- * - High contrast mode
- * - Font size scaling (small, normal, large, xlarge)
- * - Color customization (background, foreground, accent)
- * - Consistent theming across shadow DOM boundaries
- * - No framework dependencies
- *
- * Part of PIE Assessment Toolkit.
- */
-/**
- * Font size scale (in rem units)
- */
-const FONT_SIZE_SCALE = {
-    small: 0.875, // 14px at 16px base
-    normal: 1.0, // 16px at 16px base
-    large: 1.25, // 20px at 16px base
-    xlarge: 1.5, // 24px at 16px base
-};
-/**
- * Default theme values
- */
-const DEFAULT_THEME = {
-    highContrast: false,
-    fontSize: "normal",
-    backgroundColor: "#ffffff",
-    foregroundColor: "#000000",
-    accentColor: "#3f51b5",
-    linkColor: "#146eb3",
-    errorColor: "#ff9800",
-    successColor: "#4caf50",
-    warningColor: "#d32f2f",
-};
-/**
- * High contrast theme overrides
- */
-const HIGH_CONTRAST_THEME = {
-    backgroundColor: "#000000",
-    foregroundColor: "#ffffff",
-    accentColor: "#ffff00",
-    linkColor: "#00ffff",
-    errorColor: "#ff0000",
-    successColor: "#00ff00",
-    warningColor: "#ffff00",
-};
-export class ThemeProvider {
-    currentTheme = { ...DEFAULT_THEME };
-    styleElement = null;
-    rootElement;
-    styleContainer = null;
-    constructor(rootElement = typeof document !== "undefined"
-        ? document.documentElement
-        : null) {
-        this.rootElement = rootElement;
-        // SSR guard
-        if (typeof document === "undefined") {
-            console.warn("ThemeProvider: document not available (SSR context)");
-            return;
-        }
-        this.initializeStyles();
-    }
-    /**
-     * Initialize theme styles
-     */
-    initializeStyles() {
-        if (!this.rootElement)
-            return;
-        const rootNode = this.rootElement.getRootNode();
-        if (rootNode instanceof ShadowRoot) {
-            this.styleContainer = rootNode;
-            this.styleElement = rootNode.querySelector('style[data-pie-theme-styles="true"]');
-        }
-        else {
-            this.styleContainer = document.head;
-            this.styleElement = document.getElementById("pie-theme-styles");
-        }
-        if (!this.styleElement) {
-            this.styleElement = document.createElement("style");
-            if (this.styleContainer instanceof ShadowRoot) {
-                this.styleElement.setAttribute("data-pie-theme-styles", "true");
-                this.styleContainer.appendChild(this.styleElement);
-            }
-            else {
-                this.styleElement.id = "pie-theme-styles";
-                document.head.appendChild(this.styleElement);
-            }
-        }
-        // Apply default theme
-        this.applyTheme({});
-    }
-    /**
-     * Apply theme configuration
-     *
-     * @param config Partial theme configuration (merged with current theme)
-     */
-    applyTheme(config) {
-        if (!this.rootElement)
-            return;
-        // Merge with current theme
-        const newTheme = {
-            ...this.currentTheme,
-            ...config,
-        };
-        // Apply high contrast overrides if enabled
-        if (newTheme.highContrast) {
-            Object.assign(newTheme, HIGH_CONTRAST_THEME);
-        }
-        this.currentTheme = newTheme;
-        // Apply CSS custom properties
-        this.applyCSSVariables();
-        // Apply CSS classes
-        this.applyCSSClasses();
-        // Update global styles
-        this.updateGlobalStyles();
-    }
-    /**
-     * Apply CSS custom properties to root element
-     */
-    applyCSSVariables() {
-        if (!this.rootElement)
-            return;
-        const { fontSize, backgroundColor, foregroundColor, accentColor, linkColor, errorColor, successColor, warningColor, } = this.currentTheme;
-        // Font sizing
-        this.rootElement.style.setProperty("--pie-font-scale", String(FONT_SIZE_SCALE[fontSize]));
-        // Canonical PIE variables
-        this.rootElement.style.setProperty("--pie-background", backgroundColor);
-        this.rootElement.style.setProperty("--pie-text", foregroundColor);
-        this.rootElement.style.setProperty("--pie-primary", accentColor);
-        this.rootElement.style.setProperty("--pie-tertiary", linkColor);
-        this.rootElement.style.setProperty("--pie-incorrect", errorColor);
-        this.rootElement.style.setProperty("--pie-correct", successColor);
-        this.rootElement.style.setProperty("--pie-missing", warningColor);
-        // Derived surface tokens
-        this.rootElement.style.setProperty("--pie-background-dark", this.adjustOpacity(backgroundColor, 0.95));
-        this.rootElement.style.setProperty("--pie-secondary-background", this.adjustOpacity(backgroundColor, 0.92));
-        this.rootElement.style.setProperty("--pie-border", this.adjustOpacity(foregroundColor, 0.25));
-        this.rootElement.style.setProperty("--pie-border-light", this.adjustOpacity(foregroundColor, 0.16));
-        this.rootElement.style.setProperty("--pie-border-dark", this.adjustOpacity(foregroundColor, 0.4));
-        this.rootElement.style.setProperty("--pie-focus-checked", this.adjustOpacity(accentColor, 0.18));
-        this.rootElement.style.setProperty("--pie-focus-checked-border", accentColor);
-        // Button tokens used by toolkit controls
-        this.rootElement.style.setProperty("--pie-button-bg", backgroundColor);
-        this.rootElement.style.setProperty("--pie-button-border", this.adjustOpacity(foregroundColor, 0.2));
-        this.rootElement.style.setProperty("--pie-button-color", foregroundColor);
-        this.rootElement.style.setProperty("--pie-button-hover-bg", this.adjustOpacity(accentColor, 0.1));
-        this.rootElement.style.setProperty("--pie-button-hover-border", this.adjustOpacity(accentColor, 0.5));
-        this.rootElement.style.setProperty("--pie-button-hover-color", foregroundColor);
-        this.rootElement.style.setProperty("--pie-button-active-bg", this.adjustOpacity(accentColor, 0.16));
-        this.rootElement.style.setProperty("--pie-button-focus-outline", accentColor);
-    }
-    /**
-     * Apply CSS classes to root element
-     */
-    applyCSSClasses() {
-        if (!this.rootElement)
-            return;
-        const { highContrast, fontSize } = this.currentTheme;
-        // High contrast class
-        this.rootElement.classList.toggle("pie-high-contrast", highContrast);
-        // Font size classes
-        this.rootElement.classList.remove("pie-font-small", "pie-font-normal", "pie-font-large", "pie-font-xlarge");
-        this.rootElement.classList.add(`pie-font-${fontSize}`);
-    }
-    /**
-     * Update global theme styles
-     */
-    updateGlobalStyles() {
-        if (!this.styleElement)
-            return;
-        this.styleElement.textContent = `
-      /* PIE Assessment Toolkit - Theme Styles */
-
-      /* Font scaling */
-      .pie-themed,
-      .pie-themed * {
-        font-size: calc(1rem * var(--pie-font-scale, 1));
-      }
-
-      /* Color theming */
-      .pie-themed {
-        background-color: var(--pie-background);
-        color: var(--pie-text);
-      }
-
-      .pie-themed a {
-        color: var(--pie-tertiary);
-      }
-
-      .pie-themed a:hover {
-        opacity: 0.8;
-      }
-
-      /* High contrast mode */
-      .pie-high-contrast .pie-themed {
-        border: 2px solid var(--pie-text);
-      }
-
-      .pie-high-contrast .pie-themed a {
-        text-decoration: underline;
-        font-weight: bold;
-      }
-
-      .pie-high-contrast .pie-themed button {
-        border: 2px solid var(--pie-text);
-        background-color: var(--pie-background);
-        color: var(--pie-text);
-      }
-
-      .pie-high-contrast .pie-themed button:hover {
-        background-color: var(--pie-text);
-        color: var(--pie-background);
-      }
-
-      /* Error/Success/Warning states */
-      .pie-themed .pie-error {
-        color: var(--pie-incorrect);
-      }
-
-      .pie-themed .pie-success {
-        color: var(--pie-correct);
-      }
-
-      .pie-themed .pie-warning {
-        color: var(--pie-missing);
-      }
-
-      /* Focus indicators (accessibility) */
-      .pie-themed *:focus-visible {
-        outline: 3px solid var(--pie-focus-checked-border);
-        outline-offset: 2px;
-      }
-
-      .pie-high-contrast *:focus-visible {
-        outline-width: 4px;
-      }
-
-      /* Responsive font scaling */
-      @media (max-width: 768px) {
-        .pie-themed,
-        .pie-themed * {
-          font-size: calc(1rem * var(--pie-font-scale, 1) * 0.9);
-        }
-      }
-    `;
-    }
-    /**
-     * Set high contrast mode
-     */
-    setHighContrast(enabled) {
-        this.applyTheme({ highContrast: enabled });
-    }
-    /**
-     * Set font size
-     */
-    setFontSize(size) {
-        this.applyTheme({ fontSize: size });
-    }
-    /**
-     * Set color scheme
-     */
-    setColors(colors) {
-        this.applyTheme(colors);
-    }
-    /**
-     * Get current theme configuration
-     */
-    getCurrentTheme() {
-        return { ...this.currentTheme };
-    }
-    /**
-     * Reset to default theme
-     */
-    reset() {
-        this.currentTheme = { ...DEFAULT_THEME };
-        this.applyTheme({});
-    }
-    /**
-     * Adjust color opacity (helper)
-     */
-    adjustOpacity(color, opacity) {
-        // Simple hex to rgba conversion
-        if (color.startsWith("#")) {
-            const r = parseInt(color.slice(1, 3), 16);
-            const g = parseInt(color.slice(3, 5), 16);
-            const b = parseInt(color.slice(5, 7), 16);
-            return `rgba(${r}, ${g}, ${b}, ${opacity})`;
-        }
-        // If already rgba/rgb, just return as-is (simplified)
-        return color;
-    }
-    /**
-     * Cleanup - remove theme styles
-     */
-    destroy() {
-        if (this.styleElement) {
-            this.styleElement.remove();
-            this.styleElement = null;
-        }
-        this.styleContainer = null;
-        if (!this.rootElement)
-            return;
-        // Remove CSS classes
-        this.rootElement.classList.remove("pie-high-contrast", "pie-font-small", "pie-font-normal", "pie-font-large", "pie-font-xlarge");
-        // Remove CSS custom properties
-        this.rootElement.style.removeProperty("--pie-font-scale");
-        this.rootElement.style.removeProperty("--pie-background");
-        this.rootElement.style.removeProperty("--pie-text");
-        this.rootElement.style.removeProperty("--pie-primary");
-        this.rootElement.style.removeProperty("--pie-tertiary");
-        this.rootElement.style.removeProperty("--pie-incorrect");
-        this.rootElement.style.removeProperty("--pie-correct");
-        this.rootElement.style.removeProperty("--pie-missing");
-        this.rootElement.style.removeProperty("--pie-background-dark");
-        this.rootElement.style.removeProperty("--pie-secondary-background");
-        this.rootElement.style.removeProperty("--pie-border");
-        this.rootElement.style.removeProperty("--pie-border-light");
-        this.rootElement.style.removeProperty("--pie-border-dark");
-        this.rootElement.style.removeProperty("--pie-focus-checked");
-        this.rootElement.style.removeProperty("--pie-focus-checked-border");
-        this.rootElement.style.removeProperty("--pie-button-bg");
-        this.rootElement.style.removeProperty("--pie-button-border");
-        this.rootElement.style.removeProperty("--pie-button-color");
-        this.rootElement.style.removeProperty("--pie-button-hover-bg");
-        this.rootElement.style.removeProperty("--pie-button-hover-border");
-        this.rootElement.style.removeProperty("--pie-button-hover-color");
-        this.rootElement.style.removeProperty("--pie-button-active-bg");
-        this.rootElement.style.removeProperty("--pie-button-focus-outline");
-    }
-}

package/dist/services/defaultPersonalNeedsProfile.d.ts

@@ -1,21 +0,0 @@
-import type { PersonalNeedsProfile } from "@pie-players/pie-players-shared/types";
-/**
- * An empty personal-needs profile: nothing granted, nothing prohibited, nothing
- * activated at init.
- *
- * The core ships no populated default on purpose. It once derived one from every
- * registered tool's `pnpSupportIds`, which read *registry membership* as
- * *eligibility tier* — registration means "policy-addressable", not "universal,
- * on by default" — so an accommodation-tier capability was granted to every
- * student of every host that supplied no profile. The remedy at the time was a
- * compile-time list of ids to exclude, which a host could not extend for its own
- * accommodation.
- *
- * Which capabilities a deployment grants by default is a property of the
- * program, not of this package: TTS is a universal feature in one program and a
- * documented accommodation in another. That belongs in policy configuration
- * alongside the district and test-administration levels. A named preset of
- * today's universal set ships as data from
- * `@pie-players/pie-default-tool-loaders`, for hosts that want it.
- */
-export declare function createEmptyPersonalNeedsProfile(): PersonalNeedsProfile;

package/dist/services/defaultPersonalNeedsProfile.js

@@ -1,26 +0,0 @@
-/**
- * An empty personal-needs profile: nothing granted, nothing prohibited, nothing
- * activated at init.
- *
- * The core ships no populated default on purpose. It once derived one from every
- * registered tool's `pnpSupportIds`, which read *registry membership* as
- * *eligibility tier* — registration means "policy-addressable", not "universal,
- * on by default" — so an accommodation-tier capability was granted to every
- * student of every host that supplied no profile. The remedy at the time was a
- * compile-time list of ids to exclude, which a host could not extend for its own
- * accommodation.
- *
- * Which capabilities a deployment grants by default is a property of the
- * program, not of this package: TTS is a universal feature in one program and a
- * documented accommodation in another. That belongs in policy configuration
- * alongside the district and test-administration levels. A named preset of
- * today's universal set ships as data from
- * `@pie-players/pie-default-tool-loaders`, for hosts that want it.
- */
-export function createEmptyPersonalNeedsProfile() {
-    return {
-        supports: [],
-        prohibitedSupports: [],
-        activateAtInit: [],
-    };
-}