canvas-design-mcp 0.9.0

package/dist/tools/accessibility.js

@@ -0,0 +1,149 @@
+import { wcagContrastRatio } from './contrast.js';
+const VAGUE_LINK_TEXT = new Set([
+    'click here', 'here', 'read more', 'more', 'link', 'this link', 'learn more',
+]);
+const DECORATIVE_SRC = /spacer|pixel|blank|transparent|1x1/i;
+function ctx(s) {
+    return s.length > 60 ? s.slice(0, 60) + '...' : s;
+}
+function checkContrast(html) {
+    const warnings = [];
+    const styleAttr = /style="([^"]*)"/gi;
+    let m;
+    while ((m = styleAttr.exec(html)) !== null) {
+        const style = m[1];
+        // Match background-color:#hex and background:#hex shorthand (not gradients/URLs)
+        const bgM = /(?:background-color|background):\s*(#[0-9a-fA-F]{6}|#[0-9a-fA-F]{3})\b/i.exec(style);
+        const fgM = /(?<![a-z-])color:\s*(#[0-9a-fA-F]{6}|#[0-9a-fA-F]{3})\b/i.exec(style);
+        if (!bgM || !fgM)
+            continue;
+        let ratio;
+        try {
+            ratio = wcagContrastRatio(fgM[1], bgM[1]);
+        }
+        catch {
+            continue;
+        }
+        const sizeM = /font-size:\s*(\d+(?:\.\d+)?)px/i.exec(style);
+        const boldM = /font-weight:\s*(700|bold)\b/i.exec(style);
+        const size = sizeM ? parseFloat(sizeM[1]) : 0;
+        const isLarge = size >= 24 || (!!boldM && size >= 18);
+        const threshold = isLarge ? 3.0 : 4.5;
+        if (ratio < threshold) {
+            const label = isLarge ? 'large text' : 'body text';
+            warnings.push({
+                check: 'contrast-ratio',
+                message: `${fgM[1]} on ${bgM[1]}: ${ratio.toFixed(2)}:1 — fails WCAG AA for ${label} (requires ${threshold}:1)`,
+                context: ctx(style),
+            });
+        }
+    }
+    return warnings;
+}
+function checkMeaningfulAlt(html) {
+    const warnings = [];
+    const imgTag = /<img[^>]*>/gi;
+    let m;
+    while ((m = imgTag.exec(html)) !== null) {
+        const img = m[0];
+        const altM = /\balt=(["'])(.*?)\1/i.exec(img);
+        const srcM = /\bsrc=(["'])(.*?)\1/i.exec(img);
+        if (!altM || !srcM)
+            continue;
+        if (altM[2] === '' && srcM[2] && !DECORATIVE_SRC.test(srcM[2])) {
+            warnings.push({
+                check: 'empty-alt',
+                message: 'Content image has alt="" — add descriptive alt text or confirm it is decorative',
+                context: ctx(img),
+            });
+        }
+    }
+    return warnings;
+}
+function checkHeadingHierarchy(html) {
+    const warnings = [];
+    const headingTag = /<(h[2-6])[\s>]/gi;
+    const seq = [];
+    let m;
+    while ((m = headingTag.exec(html)) !== null) {
+        seq.push({ level: parseInt(m[1][1], 10), tag: m[0] });
+    }
+    for (let i = 1; i < seq.length; i++) {
+        const prev = seq[i - 1].level;
+        const curr = seq[i].level;
+        if (curr > prev + 1) {
+            warnings.push({
+                check: 'heading-skip',
+                message: `Heading jumps from H${prev} to H${curr} — skipped levels break screen reader navigation`,
+                context: ctx(seq[i].tag),
+            });
+            break;
+        }
+    }
+    return warnings;
+}
+function checkDescriptiveLinks(html) {
+    const warnings = [];
+    const linkTag = /<a[\s][^>]*>([\s\S]*?)<\/a>/gi;
+    let m;
+    while ((m = linkTag.exec(html)) !== null) {
+        const text = m[1].replace(/<[^>]+>/g, '').trim().toLowerCase();
+        if (VAGUE_LINK_TEXT.has(text)) {
+            warnings.push({
+                check: 'vague-link',
+                message: `"${text}" is not descriptive — use text that explains where the link goes`,
+                context: ctx(m[0]),
+            });
+        }
+    }
+    return warnings;
+}
+function checkTableHeaders(html) {
+    const warnings = [];
+    const tableTag = /<table[\s\S]*?<\/table>/gi;
+    let m;
+    while ((m = tableTag.exec(html)) !== null) {
+        if (!/<th[\s>]/i.test(m[0])) {
+            warnings.push({
+                check: 'table-no-headers',
+                message: 'Table has no <th> elements — add headers so screen readers can identify columns and rows',
+                context: ctx(m[0]),
+            });
+        }
+    }
+    return warnings;
+}
+function checkPanoptoNoCaptions(html) {
+    const warnings = [];
+    const iframeRe = /<iframe[^>]+>/gi;
+    let m;
+    while ((m = iframeRe.exec(html)) !== null) {
+        const tag = m[0];
+        const srcM = /\bsrc=(["'])(.*?)\1/i.exec(tag);
+        if (!srcM)
+            continue;
+        const src = srcM[2];
+        if (!/panopto/i.test(src))
+            continue;
+        if (/captions=true/i.test(src))
+            continue;
+        warnings.push({
+            check: 'video-no-captions',
+            message: 'Panopto embed found without captions enabled — add &captions=true to the embed URL.',
+            context: ctx(tag),
+        });
+    }
+    return warnings;
+}
+export function auditAccessibility(html) {
+    const stripped = html.replace(/<!--[\s\S]*?-->/g, '');
+    return [
+        ...checkContrast(stripped),
+        ...checkMeaningfulAlt(stripped),
+        ...checkHeadingHierarchy(stripped),
+        ...checkDescriptiveLinks(stripped),
+        ...checkTableHeaders(stripped),
+        ...checkPanoptoNoCaptions(stripped),
+    ];
+}
+//# sourceMappingURL=accessibility.js.map

package/dist/tools/accessibility.js.map

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

package/dist/tools/contrast.d.ts

@@ -0,0 +1,2 @@
+export declare function wcagContrastRatio(hex1: string, hex2: string): number;
+//# sourceMappingURL=contrast.d.ts.map

package/dist/tools/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../src/tools/contrast.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpE"}

package/dist/tools/contrast.js

@@ -0,0 +1,7 @@
+import Color from 'color';
+export function wcagContrastRatio(hex1, hex2) {
+    const l1 = Color(hex1).luminosity();
+    const l2 = Color(hex2).luminosity();
+    return (Math.max(l1, l2) + 0.05) / (Math.min(l1, l2) + 0.05);
+}
+//# sourceMappingURL=contrast.js.map

package/dist/tools/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","sourceRoot":"","sources":["../../src/tools/contrast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAY;IAC1D,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACpC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/tools/critique.d.ts

@@ -0,0 +1,23 @@
+export interface CritiqueInput {
+    html: string;
+    pageType: 'assignment' | 'week-overview' | 'course-home' | 'syllabus' | 'other';
+    primaryGoal: string;
+    audience?: string;
+    mode?: 'quick' | 'comprehensive';
+}
+export interface CritiqueFinding {
+    area: 'hierarchy' | 'content' | 'color' | 'typography' | 'layout' | 'completeness';
+    issue: string;
+    suggestion: string;
+    priority: 'high' | 'medium' | 'low';
+}
+export interface CritiqueResult {
+    score: number;
+    mode: 'quick' | 'comprehensive';
+    pageType: string;
+    strengths: string[];
+    findings: CritiqueFinding[];
+    kbContext?: string;
+}
+export declare function critiqueCanvasPage(input: CritiqueInput): CritiqueResult;
+//# sourceMappingURL=critique.d.ts.map

package/dist/tools/critique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critique.d.ts","sourceRoot":"","sources":["../../src/tools/critique.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,GAAG,eAAe,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,GAAG,cAAc,CAAC;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,eAAe,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgLD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAyBvE"}

package/dist/tools/critique.js

@@ -0,0 +1,194 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+const DEDUCTIONS = { high: 15, medium: 8, low: 3 };
+function wordCount(text) {
+    return text.split(/\s+/).filter(Boolean).length;
+}
+function stripTags(html) {
+    return html.replace(/<[^>]+>/g, '');
+}
+function checkUnreplacedHero(html) {
+    if (!html.includes('HERO_IMAGE_URL'))
+        return undefined;
+    return {
+        area: 'completeness',
+        issue: 'Hero image placeholder has not been replaced.',
+        suggestion: 'Replace HERO_IMAGE_URL with the URL of your hosted 1200×400px banner image.',
+        priority: 'high',
+    };
+}
+function checkWallOfText(html) {
+    const pTag = /<p[^>]*>([\s\S]*?)<\/p>/gi;
+    let m;
+    while ((m = pTag.exec(html)) !== null) {
+        if (wordCount(stripTags(m[1])) > 80) {
+            return {
+                area: 'content',
+                issue: 'A paragraph exceeds 80 words — hard for students to scan quickly.',
+                suggestion: 'Break long paragraphs into bullet points or split across multiple section cards.',
+                priority: 'high',
+            };
+        }
+    }
+    return undefined;
+}
+function checkNoHeadings(html) {
+    if (/<h[23][\s>]/i.test(html))
+        return undefined;
+    return {
+        area: 'hierarchy',
+        issue: 'Page has no H2 or H3 headings — content has no visible structure.',
+        suggestion: 'Add H2 headings to divide major sections. Use H3 for subsections within a card.',
+        priority: 'high',
+    };
+}
+function checkTooSparse(html) {
+    const total = wordCount(stripTags(html));
+    if (total >= 100)
+        return undefined;
+    return {
+        area: 'content',
+        issue: `Page contains only ${total} words — looks unfinished.`,
+        suggestion: 'Add more content: an overview, details, submission instructions, or grading notes.',
+        priority: 'medium',
+    };
+}
+function expandHex3(hex) {
+    if (hex.length === 4) {
+        return '#' + hex[1] + hex[1] + hex[2] + hex[2] + hex[3] + hex[3];
+    }
+    return hex.toLowerCase();
+}
+function checkColorChaos(html) {
+    const hexPattern = /#[0-9a-fA-F]{6}|#[0-9a-fA-F]{3}\b/g;
+    const colors = new Set((html.match(hexPattern) ?? []).map(expandHex3));
+    if (colors.size <= 7)
+        return undefined;
+    return {
+        area: 'color',
+        issue: `${colors.size} distinct colors used — visual palette is fragmented.`,
+        suggestion: 'Limit to 6–7 colors: primary, secondary, neutrals, and semantic status colors.',
+        priority: 'medium',
+    };
+}
+function checkFontFloor(html) {
+    const pattern = /font-size:\s*(\d+(?:\.\d+)?)px/gi;
+    let m;
+    while ((m = pattern.exec(html)) !== null) {
+        if (parseFloat(m[1]) < 13) {
+            return {
+                area: 'typography',
+                issue: `Font size ${m[1]}px found — below the 13px minimum for mobile readability.`,
+                suggestion: 'Use a minimum of 13px for all visible text.',
+                priority: 'medium',
+            };
+        }
+    }
+    return undefined;
+}
+function checkMissingSubmissionLanguage(html, pageType) {
+    if (pageType !== 'assignment')
+        return undefined;
+    if (/submit|upload|due|deadline/i.test(html))
+        return undefined;
+    return {
+        area: 'completeness',
+        issue: 'Assignment page has no submission instructions — students will not know what to do.',
+        suggestion: 'Add a section explaining how to submit, the expected format, and the due date.',
+        priority: 'medium',
+    };
+}
+function extractDivText(html, className) {
+    const escapedClass = className.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const openTagRe = new RegExp(`<div[^>]*class="[^"]*${escapedClass}[^"]*"[^>]*>`);
+    const openTagMatch = openTagRe.exec(html);
+    if (!openTagMatch)
+        return '';
+    const start = openTagMatch.index + openTagMatch[0].length;
+    let depth = 1;
+    let pos = start;
+    while (pos < html.length && depth > 0) {
+        const openIdx = html.indexOf('<div', pos);
+        const closeIdx = html.indexOf('</div>', pos);
+        if (closeIdx < 0)
+            break;
+        if (openIdx >= 0 && openIdx < closeIdx) {
+            const ch = html[openIdx + 4];
+            if (ch === '>' || ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r')
+                depth++;
+            pos = openIdx + 4;
+        }
+        else {
+            depth--;
+            if (depth === 0)
+                return stripTags(html.slice(start, closeIdx));
+            pos = closeIdx + 6;
+        }
+    }
+    return stripTags(html.slice(start, pos));
+}
+function checkColumnImbalance(html) {
+    if (!html.includes('col-md-8') || !html.includes('col-md-4'))
+        return undefined;
+    const wideWords = wordCount(extractDivText(html, 'col-md-8'));
+    const narrowWords = wordCount(extractDivText(html, 'col-md-4'));
+    if (narrowWords === 0 || wideWords / narrowWords <= 3)
+        return undefined;
+    return {
+        area: 'layout',
+        issue: 'Left column has significantly more content than the sidebar — layout feels lopsided.',
+        suggestion: 'Move secondary content (grading notes, resources) into the sidebar to balance columns.',
+        priority: 'low',
+    };
+}
+function calculateScore(findings) {
+    const deduction = findings.reduce((sum, f) => sum + DEDUCTIONS[f.priority], 0);
+    return Math.max(0, 100 - deduction);
+}
+function deriveStrengths(html, findings) {
+    const foundAreas = new Set(findings.map(f => f.area));
+    const strengths = [];
+    if (!foundAreas.has('hierarchy') && /<h[23][\s>]/i.test(html)) {
+        strengths.push('Clear heading structure');
+    }
+    if (!foundAreas.has('color')) {
+        strengths.push('Consistent color palette');
+    }
+    if (!foundAreas.has('content')) {
+        strengths.push('Well-proportioned content length');
+    }
+    return strengths.slice(0, 3);
+}
+function loadKb() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    try {
+        return readFileSync(join(__dirname, '../../src/kb/design-principles.md'), 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+export function critiqueCanvasPage(input) {
+    const { html, pageType, mode = 'quick' } = input;
+    const findings = [
+        checkUnreplacedHero(html),
+        checkWallOfText(html),
+        checkNoHeadings(html),
+        checkTooSparse(html),
+        checkColorChaos(html),
+        checkFontFloor(html),
+        checkMissingSubmissionLanguage(html, pageType),
+        checkColumnImbalance(html),
+    ].filter((f) => f !== undefined);
+    const score = calculateScore(findings);
+    const strengths = deriveStrengths(html, findings);
+    const result = { score, mode, pageType, strengths, findings };
+    if (mode === 'comprehensive') {
+        const kb = loadKb();
+        if (kb)
+            result.kbContext = kb;
+    }
+    return result;
+}
+//# sourceMappingURL=critique.js.map

package/dist/tools/critique.js.map

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

package/dist/tools/generate.d.ts

@@ -0,0 +1,18 @@
+import type { InstitutionConfig } from '../types.js';
+export interface GenerateInput {
+    assignmentBrief: string;
+    courseName: string;
+    courseNumber: string;
+    assignmentNumber: string;
+    professorName: string;
+    semester: string;
+    styleNotes?: string;
+}
+export interface GenerateOutput {
+    html: string;
+    heroImagePrompt: string;
+    filename: string;
+    warnings: string[];
+}
+export declare function generateCanvasPage(input: GenerateInput, config: InstitutionConfig): GenerateOutput;
+//# sourceMappingURL=generate.d.ts.map

package/dist/tools/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/tools/generate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgCD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,iBAAiB,GAAG,cAAc,CAkElG"}

package/dist/tools/generate.js

@@ -0,0 +1,101 @@
+import { resolveTokens } from '../design-engine.js';
+import { validateCanvasHtml } from './validate.js';
+import { auditAccessibility } from './accessibility.js';
+function buildStatBadge(value, label) {
+    return (`<div style="background:rgba(255,255,255,0.15);border-radius:8px;padding:8px 16px;` +
+        `margin-right:10px;margin-bottom:8px;text-align:center;color:#ffffff;">` +
+        `<div style="font-size:22px;font-weight:700;font-family:Lato,sans-serif;">${value}</div>` +
+        `<div style="font-size:11px;color:rgba(255,255,255,0.85);font-family:Lato,sans-serif;">${label}</div>` +
+        `</div>`);
+}
+function buildSectionCard(label, content, accentColor) {
+    return (`<div style="background:#ffffff;border-radius:10px;border:1px solid #e0e0d8;padding:20px 24px;margin-bottom:14px;">` +
+        `<div style="font-size:11px;font-weight:700;letter-spacing:0.08em;text-transform:uppercase;` +
+        `color:${accentColor};margin-bottom:8px;font-family:Lato,sans-serif;">${label}</div>` +
+        content +
+        `</div>`);
+}
+function buildSidebarCard(title, content, bgColor, textColor) {
+    return (`<div style="background:${bgColor};border-radius:10px;padding:16px 20px;margin-bottom:12px;border:1px solid #e0e0d8;">` +
+        `<div style="font-size:11px;font-weight:700;letter-spacing:0.08em;text-transform:uppercase;` +
+        `color:${textColor};margin-bottom:8px;font-family:Lato,sans-serif;">${title}</div>` +
+        content +
+        `</div>`);
+}
+export function generateCanvasPage(input, config) {
+    const { courseNumber, assignmentNumber, courseName, assignmentBrief, professorName, semester } = input;
+    const lines = assignmentBrief.split('\n').filter(l => l.trim());
+    const overview = lines.slice(0, 3).join(' ').trim();
+    const details = lines.slice(3);
+    const overviewContent = `<p style="font-size:15px;color:#1A1A1A;line-height:1.65;margin:0;font-family:Lato,sans-serif;">${overview}</p>`;
+    const detailItems = details
+        .map(line => `<div style="display:flex;align-items:flex-start;margin-bottom:10px;">` +
+        `<span style="color:${config.colors.secondary};font-weight:700;font-size:16px;margin-right:10px;line-height:1.4;">&rarr;</span>` +
+        `<p style="font-size:14px;color:#1A1A1A;margin:0;line-height:1.65;font-family:Lato,sans-serif;">${line.replace(/^[-*]\s*/, '')}</p>` +
+        `</div>`)
+        .join('\n');
+    const leftContent = buildSectionCard('Overview', overviewContent, config.colors.primary) +
+        (detailItems ? buildSectionCard('Details', detailItems, config.colors.primary) : '');
+    const gradingContent = `<div style="border-left:3px solid ${config.colors.secondary};padding-left:12px;">` +
+        `<p style="font-size:14px;color:#1A1A1A;line-height:1.65;margin:0;font-family:Lato,sans-serif;">See rubric in Canvas for grading criteria.</p>` +
+        `</div>`;
+    const rightContent = `<div style="background:${config.colors.primary};border-radius:10px;padding:20px;margin-bottom:12px;">` +
+        `<div style="font-size:11px;font-weight:700;letter-spacing:0.08em;text-transform:uppercase;` +
+        `color:rgba(255,255,255,0.7);margin-bottom:12px;font-family:Lato,sans-serif;">What to Submit</div>` +
+        `<p style="color:rgba(255,255,255,0.85);font-size:13px;font-family:Lato,sans-serif;">Submit via Canvas. Check the assignment for specific requirements.</p>` +
+        `</div>` +
+        buildSidebarCard('Grading', gradingContent, '#ffffff', '#555550');
+    const statBadges = buildStatBadge(professorName, 'Professor') +
+        buildStatBadge(semester, 'Semester');
+    const html = buildFullPage({
+        courseNumber,
+        assignmentNumber,
+        courseName,
+        subtitle: `${courseNumber} &middot; ${semester}`,
+        heroAlt: `${courseName} assignment hero image`,
+        statBadges,
+        leftContent,
+        rightContent,
+    }, config);
+    const validation = validateCanvasHtml(html);
+    const a11y = auditAccessibility(html);
+    const warnings = [
+        ...validation.violations.map(v => v.rule),
+        ...a11y.map(w => `a11y: ${w.check} — ${w.message}`),
+    ];
+    const heroImagePrompt = `A cinematic wide-format banner image for a university course assignment about ${courseName}. ` +
+        `Show a dynamic, professional academic workspace. Color palette dominated by ${config.colors.primary} ` +
+        `with accent highlights in ${config.colors.secondary}. ` +
+        `Clean, professional, slightly cinematic mood. No text. No people. Horizontal format, 3:1 aspect ratio, high resolution.`;
+    const filename = `${courseNumber.toLowerCase().replace(/\s+/g, '-')}-${assignmentNumber}-page.html`;
+    return { html, heroImagePrompt, filename, warnings };
+}
+function buildFullPage(tokens, config) {
+    const resolved = resolveTokens('{{colors.primaryDark}}|{{colors.primary}}|{{colors.secondary}}', config).split('|');
+    const [primaryDark, primary, secondary] = resolved;
+    return `<!-- Canvas Design Studio — Generated Page -->
+<!-- Canvas-safe: inline styles only, no scripts, no gap, no box-shadow -->
+<div style="max-width:860px;margin:0 auto;font-family:Lato,sans-serif;background:#F4F3EF;padding:16px;">
+
+  <!-- HERO BANNER -->
+  <div style="background:linear-gradient(135deg,${primaryDark} 0%,${primary} 60%,#1A5BCC 100%);border-radius:14px;overflow:hidden;margin-bottom:20px;">
+    <img src="HERO_IMAGE_URL" alt="${tokens.heroAlt}" style="width:100%;height:200px;object-fit:cover;display:block;border-radius:14px 14px 0 0;">
+    <div style="padding:28px 32px;">
+      <div style="display:inline-block;background:${secondary};color:#ffffff;font-size:11px;font-weight:700;letter-spacing:0.08em;text-transform:uppercase;padding:3px 12px;border-radius:20px;margin-bottom:10px;">${tokens.courseNumber} &middot; ${tokens.assignmentNumber}</div>
+      <h2 style="color:#ffffff;font-size:28px;font-weight:700;line-height:1.2;margin:0 0 6px 0;font-family:Lato,sans-serif;">${tokens.courseName}</h2>
+      <p style="color:rgba(255,255,255,0.85);font-size:15px;font-weight:400;margin:0 0 20px 0;font-family:Lato,sans-serif;">${tokens.subtitle}</p>
+      <div style="display:flex;flex-wrap:wrap;">${tokens.statBadges}</div>
+    </div>
+  </div>
+
+  <!-- TWO-COLUMN BODY -->
+  <div class="content-box">
+    <div class="grid-row">
+      <div class="col-xs-12 col-md-8" style="padding-right:12px;">${tokens.leftContent}</div>
+      <div class="col-xs-12 col-md-4">${tokens.rightContent}</div>
+    </div>
+  </div>
+
+</div>`;
+}
+//# sourceMappingURL=generate.js.map

package/dist/tools/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/tools/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAoBxD,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa;IAClD,OAAO,CACL,mFAAmF;QACnF,wEAAwE;QACxE,4EAA4E,KAAK,QAAQ;QACzF,yFAAyF,KAAK,QAAQ;QACtG,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,OAAe,EAAE,WAAmB;IAC3E,OAAO,CACL,oHAAoH;QACpH,4FAA4F;QAC5F,SAAS,WAAW,oDAAoD,KAAK,QAAQ;QACrF,OAAO;QACP,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,OAAe,EAAE,OAAe,EAAE,SAAiB;IAC1F,OAAO,CACL,0BAA0B,OAAO,sFAAsF;QACvH,4FAA4F;QAC5F,SAAS,SAAS,oDAAoD,KAAK,QAAQ;QACnF,OAAO;QACP,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAoB,EAAE,MAAyB;IAChF,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAEvG,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE/B,MAAM,eAAe,GAAG,kGAAkG,QAAQ,MAAM,CAAC;IAEzI,MAAM,WAAW,GAAG,OAAO;SACxB,GAAG,CAAC,IAAI,CAAC,EAAE,CACV,uEAAuE;QACvE,sBAAsB,MAAM,CAAC,MAAM,CAAC,SAAS,mFAAmF;QAChI,kGAAkG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM;QACpI,QAAQ,CACT;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,WAAW,GACf,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QACpE,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEvF,MAAM,cAAc,GAClB,qCAAqC,MAAM,CAAC,MAAM,CAAC,SAAS,uBAAuB;QACnF,+IAA+I;QAC/I,QAAQ,CAAC;IAEX,MAAM,YAAY,GAChB,0BAA0B,MAAM,CAAC,MAAM,CAAC,OAAO,wDAAwD;QACvG,4FAA4F;QAC5F,mGAAmG;QACnG,4JAA4J;QAC5J,QAAQ;QACR,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAEpE,MAAM,UAAU,GACd,cAAc,CAAC,aAAa,EAAE,WAAW,CAAC;QAC1C,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAG,aAAa,CAAC;QACzB,YAAY;QACZ,gBAAgB;QAChB,UAAU;QACV,QAAQ,EAAE,GAAG,YAAY,aAAa,QAAQ,EAAE;QAChD,OAAO,EAAE,GAAG,UAAU,wBAAwB;QAC9C,UAAU;QACV,WAAW;QACX,YAAY;KACb,EAAE,MAAM,CAAC,CAAC;IAEX,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG;QACf,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;KACpD,CAAC;IAEF,MAAM,eAAe,GACnB,iFAAiF,UAAU,IAAI;QAC/F,+EAA+E,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG;QACvG,6BAA6B,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI;QACxD,yHAAyH,CAAC;IAE5H,MAAM,QAAQ,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,gBAAgB,YAAY,CAAC;IAEpG,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACvD,CAAC;AAaD,SAAS,aAAa,CAAC,MAAkB,EAAE,MAAyB;IAClE,MAAM,QAAQ,GAAG,aAAa,CAC5B,gEAAgE,EAChE,MAAM,CACP,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC;IAEnD,OAAO;;;;;kDAKyC,WAAW,OAAO,OAAO;qCACtC,MAAM,CAAC,OAAO;;oDAEC,SAAS,yJAAyJ,MAAM,CAAC,YAAY,aAAa,MAAM,CAAC,gBAAgB;+HAC9I,MAAM,CAAC,UAAU;8HAClB,MAAM,CAAC,QAAQ;kDAC3F,MAAM,CAAC,UAAU;;;;;;;oEAOC,MAAM,CAAC,WAAW;wCAC9C,MAAM,CAAC,YAAY;;;;OAIpD,CAAC;AACR,CAAC"}

package/dist/tools/gotchas.d.ts

@@ -0,0 +1,7 @@
+import type { CanvasCourse } from '../types.js';
+export declare function courseCoordinatorGotcha(course: CanvasCourse): string | undefined;
+export declare function titleCollisionGotcha(existingTitle: string, newTitle: string, score: number): string;
+export declare function tokenScopeGotcha(canvasUrl: string): string;
+export declare function ferpaGotcha(reason: string, line: number): string;
+export declare function versionControlTip(): string;
+//# sourceMappingURL=gotchas.d.ts.map

package/dist/tools/gotchas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gotchas.d.ts","sourceRoot":"","sources":["../../src/tools/gotchas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAwBhD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAahF;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAanG;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/tools/gotchas.js

@@ -0,0 +1,61 @@
+function plural(count, singular, pluralValue = `${singular}s`) {
+    return `${count} ${count === 1 ? singular : pluralValue}`;
+}
+function teacherCount(course) {
+    if (course.teachers)
+        return course.teachers.length;
+    return course.enrollments?.filter(enrollment => enrollment.type === 'teacher' || enrollment.role === 'TeacherEnrollment').length ?? 0;
+}
+function studentCount(course) {
+    if (typeof course.total_students === 'number')
+        return course.total_students;
+    return course.enrollments?.filter(enrollment => enrollment.type === 'student' || enrollment.role === 'StudentEnrollment').length ?? 0;
+}
+function normalizeCanvasUrl(canvasUrl) {
+    return canvasUrl.replace(/\/+$/, '');
+}
+export function courseCoordinatorGotcha(course) {
+    const teachers = teacherCount(course);
+    const students = studentCount(course);
+    if (students === 0 || teachers >= 3) {
+        return [
+            `Heads up: this course has ${plural(teachers, 'teacher')} and ${plural(students, 'student')}.`,
+            'If you are listed as a coordinator rather than the instructor of record, publishing here may affect a live course you do not manage.',
+            'Double-check that this is the right course before publishing.',
+        ].join(' ');
+    }
+    return undefined;
+}
+export function titleCollisionGotcha(existingTitle, newTitle, score) {
+    return [
+        'A page with a similar title already exists:',
+        `  Existing: "${existingTitle}"`,
+        `  New:      "${newTitle}"`,
+        `  Similarity: ${score.toFixed(2)}`,
+        '',
+        'Rerun publish_to_canvas with one of these options:',
+        '  collisionAction: "update" to replace the existing page content',
+        '  collisionAction: "create" to create a new page with this title',
+        '  collisionAction: "related" and relatedPageTitle to create a clearly named variation',
+        '  collisionAction: "cancel" to stop without changing Canvas',
+    ].join('\n');
+}
+export function tokenScopeGotcha(canvasUrl) {
+    const settingsUrl = `${normalizeCanvasUrl(canvasUrl)}/profile/settings`;
+    return [
+        'Your Canvas API token or Canvas role does not allow editing pages in this course.',
+        `If you expected this to work, check that you can edit Pages in the course and generate a new token at ${settingsUrl}.`,
+        'Then run setup_institution to update the stored token.',
+    ].join(' ');
+}
+export function ferpaGotcha(reason, line) {
+    return [
+        `This HTML may contain student data (${reason} near line ${line}).`,
+        'Publishing student records to a Canvas page may violate FERPA.',
+        'Review before continuing. Pass skipFerpaCheck: true only after confirming the content is safe to publish.',
+    ].join(' ');
+}
+export function versionControlTip() {
+    return 'Tip: Save your HTML source to a Git repo before publishing. Canvas stores page revisions, but they are hard to diff and expire. Git is the right tool for tracking changes over time.';
+}
+//# sourceMappingURL=gotchas.js.map

package/dist/tools/gotchas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gotchas.js","sourceRoot":"","sources":["../../src/tools/gotchas.ts"],"names":[],"mappings":"AAEA,SAAS,MAAM,CAAC,KAAa,EAAE,QAAgB,EAAE,WAAW,GAAG,GAAG,QAAQ,GAAG;IAC3E,OAAO,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,MAAoB;IACxC,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IACnD,OAAO,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAC7C,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,mBAAmB,CACzE,CAAC,MAAM,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,MAAoB;IACxC,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,cAAc,CAAC;IAC5E,OAAO,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAC7C,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,mBAAmB,CACzE,CAAC,MAAM,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,OAAO,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAoB;IAC1D,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEtC,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,6BAA6B,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG;YAC9F,sIAAsI;YACtI,+DAA+D;SAChE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,aAAqB,EAAE,QAAgB,EAAE,KAAa;IACzF,OAAO;QACL,6CAA6C;QAC7C,gBAAgB,aAAa,GAAG;QAChC,gBAAgB,QAAQ,GAAG;QAC3B,iBAAiB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACnC,EAAE;QACF,oDAAoD;QACpD,kEAAkE;QAClE,kEAAkE;QAClE,uFAAuF;QACvF,6DAA6D;KAC9D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,WAAW,GAAG,GAAG,kBAAkB,CAAC,SAAS,CAAC,mBAAmB,CAAC;IACxE,OAAO;QACL,mFAAmF;QACnF,yGAAyG,WAAW,GAAG;QACvH,wDAAwD;KACzD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,IAAY;IACtD,OAAO;QACL,uCAAuC,MAAM,cAAc,IAAI,IAAI;QACnE,gEAAgE;QAChE,2GAA2G;KAC5G,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,uLAAuL,CAAC;AACjM,CAAC"}