@gtcx/accessibility 0.1.0

package/dist/tech-literacy.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Tech Literacy Detection and Adaptation
+ *
+ * Automatically detects user's technical proficiency and adapts UI accordingly
+ */
+export type TechLiteracyLevel = 'beginner' | 'intermediate' | 'advanced';
+interface InteractionPattern {
+    /** Time to complete action in ms */
+    actionTime: number;
+    /** Number of errors/corrections */
+    errorCount: number;
+    /** Used keyboard shortcuts */
+    usedShortcuts: boolean;
+    /** Scrolled to find features */
+    searchedFeatures: boolean;
+    /** Requested help */
+    requestedHelp: boolean;
+    /** Used voice input */
+    usedVoice: boolean;
+    /** Interaction timestamp */
+    timestamp: number;
+}
+interface LiteracyScore {
+    level: TechLiteracyLevel;
+    confidence: number;
+    signals: string[];
+}
+/**
+ * Detect tech literacy level from interaction patterns
+ */
+export declare function detectTechLiteracy(interactions: InteractionPattern[]): Promise<LiteracyScore>;
+/**
+ * Tech literacy detector with continuous learning
+ */
+export declare class TechLiteracyDetector {
+    private interactions;
+    private currentLevel;
+    private onLevelChange?;
+    constructor(options?: {
+        initialLevel?: TechLiteracyLevel;
+        onLevelChange?: (level: TechLiteracyLevel) => void;
+    });
+    /**
+     * Record an interaction for analysis
+     */
+    recordInteraction(pattern: Omit<InteractionPattern, 'timestamp'>): void;
+    /**
+     * Evaluate current literacy level
+     */
+    evaluate(): Promise<LiteracyScore>;
+    /**
+     * Get current assessed level
+     */
+    getLevel(): TechLiteracyLevel;
+    /**
+     * Manually set level (user preference)
+     */
+    setLevel(level: TechLiteracyLevel): void;
+}
+export declare const LITERACY_UI_CONFIGS: {
+    readonly beginner: {
+        readonly buttonSize: "large";
+        readonly fontSize: "large";
+        readonly navigation: "simple";
+        readonly icons: "labeled";
+        readonly animations: "minimal";
+        readonly guidance: "proactive";
+        readonly inputMode: "touch";
+        readonly errorHandling: "guided";
+        readonly confirmations: "explicit";
+        readonly shortcuts: "hidden";
+    };
+    readonly intermediate: {
+        readonly buttonSize: "medium";
+        readonly fontSize: "medium";
+        readonly navigation: "standard";
+        readonly icons: "tooltips";
+        readonly animations: "standard";
+        readonly guidance: "contextual";
+        readonly inputMode: "mixed";
+        readonly errorHandling: "inline";
+        readonly confirmations: "smart";
+        readonly shortcuts: "discoverable";
+    };
+    readonly advanced: {
+        readonly buttonSize: "compact";
+        readonly fontSize: "small";
+        readonly navigation: "full";
+        readonly icons: "minimal";
+        readonly animations: "full";
+        readonly guidance: "on-demand";
+        readonly inputMode: "keyboard";
+        readonly errorHandling: "technical";
+        readonly confirmations: "minimal";
+        readonly shortcuts: "prominent";
+    };
+};
+export {};
+//# sourceMappingURL=tech-literacy.d.ts.map

package/dist/tech-literacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-literacy.d.ts","sourceRoot":"","sources":["../src/tech-literacy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;AAEzE,UAAU,kBAAkB;IAC1B,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,gCAAgC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qBAAqB;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,uBAAuB;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,kBAAkB,EAAE,GACjC,OAAO,CAAC,aAAa,CAAC,CAqExB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,aAAa,CAAC,CAAqC;gBAE/C,OAAO,CAAC,EAAE;QACpB,YAAY,CAAC,EAAE,iBAAiB,CAAC;QACjC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;KACpD;IAKD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI;IAiBvE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAWxC;;OAEG;IACH,QAAQ,IAAI,iBAAiB;IAI7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;CAIzC;AAGD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCtB,CAAC"}

package/dist/tech-literacy.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Tech Literacy Detection and Adaptation
+ *
+ * Automatically detects user's technical proficiency and adapts UI accordingly
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LITERACY_UI_CONFIGS = exports.TechLiteracyDetector = void 0;
+exports.detectTechLiteracy = detectTechLiteracy;
+/**
+ * Detect tech literacy level from interaction patterns
+ */
+async function detectTechLiteracy(interactions) {
+    if (interactions.length < 3) {
+        // Not enough data, default to beginner (safest)
+        return {
+            level: 'beginner',
+            confidence: 0.3,
+            signals: ['insufficient_data'],
+        };
+    }
+    const signals = [];
+    let score = 50; // Start neutral
+    // Analyze patterns
+    const avgActionTime = average(interactions.map(i => i.actionTime));
+    const totalErrors = sum(interactions.map(i => i.errorCount));
+    const shortcutUsage = interactions.filter(i => i.usedShortcuts).length;
+    const helpRequests = interactions.filter(i => i.requestedHelp).length;
+    const voiceUsage = interactions.filter(i => i.usedVoice).length;
+    // Fast completion suggests higher literacy
+    if (avgActionTime < 2000) {
+        score += 15;
+        signals.push('fast_completion');
+    }
+    else if (avgActionTime > 8000) {
+        score -= 15;
+        signals.push('slow_completion');
+    }
+    // Errors suggest lower literacy
+    if (totalErrors > interactions.length * 2) {
+        score -= 20;
+        signals.push('high_error_rate');
+    }
+    else if (totalErrors === 0) {
+        score += 10;
+        signals.push('no_errors');
+    }
+    // Keyboard shortcuts suggest advanced
+    if (shortcutUsage > interactions.length * 0.3) {
+        score += 25;
+        signals.push('keyboard_shortcuts');
+    }
+    // Help requests suggest beginner
+    if (helpRequests > interactions.length * 0.3) {
+        score -= 15;
+        signals.push('frequent_help_requests');
+    }
+    // Voice usage is neutral (accessibility or preference)
+    if (voiceUsage > 0) {
+        signals.push('voice_user');
+    }
+    // Determine level
+    let level;
+    if (score >= 70) {
+        level = 'advanced';
+    }
+    else if (score >= 40) {
+        level = 'intermediate';
+    }
+    else {
+        level = 'beginner';
+    }
+    // Confidence based on data quality
+    const confidence = Math.min(0.95, 0.5 + (interactions.length * 0.05));
+    return { level, confidence, signals };
+}
+/**
+ * Tech literacy detector with continuous learning
+ */
+class TechLiteracyDetector {
+    interactions = [];
+    currentLevel = 'beginner';
+    onLevelChange;
+    constructor(options) {
+        this.currentLevel = options?.initialLevel || 'beginner';
+        this.onLevelChange = options?.onLevelChange;
+    }
+    /**
+     * Record an interaction for analysis
+     */
+    recordInteraction(pattern) {
+        this.interactions.push({
+            ...pattern,
+            timestamp: Date.now(),
+        });
+        // Keep last 50 interactions
+        if (this.interactions.length > 50) {
+            this.interactions = this.interactions.slice(-50);
+        }
+        // Re-evaluate periodically
+        if (this.interactions.length % 5 === 0) {
+            this.evaluate();
+        }
+    }
+    /**
+     * Evaluate current literacy level
+     */
+    async evaluate() {
+        const result = await detectTechLiteracy(this.interactions);
+        if (result.level !== this.currentLevel && result.confidence > 0.7) {
+            this.currentLevel = result.level;
+            this.onLevelChange?.(result.level);
+        }
+        return result;
+    }
+    /**
+     * Get current assessed level
+     */
+    getLevel() {
+        return this.currentLevel;
+    }
+    /**
+     * Manually set level (user preference)
+     */
+    setLevel(level) {
+        this.currentLevel = level;
+        this.onLevelChange?.(level);
+    }
+}
+exports.TechLiteracyDetector = TechLiteracyDetector;
+// UI configuration per literacy level
+exports.LITERACY_UI_CONFIGS = {
+    beginner: {
+        buttonSize: 'large', // min 48px touch target
+        fontSize: 'large', // 18px+
+        navigation: 'simple', // Linear, no nested menus
+        icons: 'labeled', // Always show text with icons
+        animations: 'minimal', // Reduce motion
+        guidance: 'proactive', // Show help automatically
+        inputMode: 'touch', // Optimize for touch
+        errorHandling: 'guided', // Step-by-step error recovery
+        confirmations: 'explicit', // Confirm all actions
+        shortcuts: 'hidden', // Don't show keyboard shortcuts
+    },
+    intermediate: {
+        buttonSize: 'medium',
+        fontSize: 'medium', // 16px
+        navigation: 'standard', // Some nesting allowed
+        icons: 'tooltips', // Show text on hover
+        animations: 'standard',
+        guidance: 'contextual', // Show help when hovering
+        inputMode: 'mixed', // Touch + keyboard
+        errorHandling: 'inline', // Inline error messages
+        confirmations: 'smart', // Confirm destructive only
+        shortcuts: 'discoverable', // Show shortcuts in tooltips
+    },
+    advanced: {
+        buttonSize: 'compact',
+        fontSize: 'small', // 14px
+        navigation: 'full', // All features accessible
+        icons: 'minimal', // Icons only, no labels
+        animations: 'full',
+        guidance: 'on-demand', // Help only when requested
+        inputMode: 'keyboard', // Keyboard-first
+        errorHandling: 'technical', // Technical error details
+        confirmations: 'minimal', // Skip most confirmations
+        shortcuts: 'prominent', // Show all shortcuts
+    },
+};
+// Utility functions
+function average(arr) {
+    return arr.length ? arr.reduce((a, b) => a + b, 0) / arr.length : 0;
+}
+function sum(arr) {
+    return arr.reduce((a, b) => a + b, 0);
+}
+//# sourceMappingURL=tech-literacy.js.map

package/dist/tech-literacy.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@gtcx/accessibility",
+  "version": "0.1.0",
+  "description": "Inclusive design — tech literacy adaptation, WCAG contrast, a11y React hooks",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}