canvas-design-mcp 0.9.0

package/README.md

@@ -0,0 +1,250 @@
+# Canvas Design Studio
+
+**An MCP server that gives AI assistants the power to generate, validate, and maintain beautiful Canvas LMS assignment pages.**
+
+Works in Claude Code, VS Code, ChatGPT Codex, and any MCP-compatible host. Zero mandatory cloud APIs — your Canvas API token is optional.
+
+---
+
+## What It Does
+
+| Tool | What it does |
+|---|---|
+| `generate_canvas_page` | Turns a raw assignment brief into polished, Canvas-safe HTML with a hero banner, two-column layout, and brand colors |
+| `validate_canvas_html` | Checks HTML against Canvas RCE sanitizer rules and WCAG 2.1 AA accessibility checks |
+| `update_canvas_kb` | Fetches the current Canvas HTML allowlist directly from Canvas LMS source and reports any changes |
+| `setup_institution` | Re-runs the setup wizard to update brand colors, Canvas URL, API token, Panopto config, and philosophy KB |
+| `list_canvas_courses` | Lists your Canvas courses with semester filtering, student counts, and favorite pinning to help choose the right one |
+| `publish_to_canvas` | Validates and publishes generated HTML directly to a Canvas course page — with FERPA preflight and title collision protection |
+| `critique_canvas_page` | Scores visual design quality (0–100) with 8 structural checks, strengths, and prioritized findings |
+| `redesign_canvas_page` | Applies mechanical fixes (font floor, hero placeholder) and returns remaining findings for the AI to address |
+| `search_panopto_videos` | Browse or search your Panopto lecture library — titles, durations, captions status (requires Panopto API) |
+| `embed_panopto_video` | Generate Canvas-safe Panopto embed HTML — iframe for whitelisted institutions, accessible fallback link otherwise |
+| `fetch_panopto_captions` | Download Panopto captions, strip timestamps, save as a plain-text Markdown transcript to your local KB |
+| `ingest_assignment_folder` | Read assignment materials from a folder (course config, brief, rubric, shell) and generate a Canvas page in one step |
+| `get_philosophy_kb` | Load your teaching philosophy KB into the AI's context — steers tone, emphasis, and pedagogy across all tools |
+| `update_philosophy_kb` | Add a quote, teaching insight, lecture-sourced statement, or course-specific note to your philosophy KB |
+| `get_student_personas` | Load saved student personas — statistically grounded demographic profiles for realistic audience feedback |
+| `generate_student_personas` | Generate 1–20 student personas using real probability distributions for race, disability, and 21 other dimensions |
+| `load_canvas_page` | Read the most recently generated HTML page from `output/` back into context (or load a named file) |
+| `save_canvas_page` | Write improved HTML back to `output/` — automatically backs up the previous version before overwriting |
+
+---
+
+## Quick Start
+
+### Option A — npm global install
+
+```bash
+npm install -g github:Ryfter/canvas-design-studio
+```
+
+Then add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "canvas-design-mcp": {
+      "command": "canvas-design-mcp"
+    }
+  }
+}
+```
+
+**Claude Desktop** — `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)  
+**VS Code** — `.vscode/mcp.json` (use `"servers"` key, not `"mcpServers"`)  
+**Cursor, Kiro, LM Studio, AnythingLLM, Codex CLI** — see [docs/installation.md](docs/installation.md) for client-specific config
+
+### Option B — Docker (no Node.js required)
+
+```bash
+# Pull the image
+docker pull ghcr.io/ryfter/canvas-design-studio:latest
+```
+
+```json
+{
+  "mcpServers": {
+    "canvas-design": {
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm",
+        "-v", "${HOME}/.canvas-design-mcp:/root/.canvas-design-mcp",
+        "ghcr.io/ryfter/canvas-design-studio:latest"
+      ]
+    }
+  }
+}
+```
+
+The `-v` mount gives the container access to your institution config. Run the setup wizard once on the host before using Docker (see Step 2 below).
+
+### 2. First run
+
+On first use, a setup wizard runs in your terminal:
+
+```
+╔═══════════════════════════════════════════════════════════╗
+║          Canvas Design Studio — First Run Setup           ║
+╚═══════════════════════════════════════════════════════════╝
+
+Institution name: (Boise State University)
+Primary brand color (#hex): (#0033A0)
+Secondary / accent color (#hex): (#D64309)
+Canvas base URL: (https://boisestate.instructure.com)
+Canvas API token (optional — leave blank to generate HTML and paste it manually):
+Professor email for FERPA scan allowlist (optional):
+Favorite Canvas course IDs, comma-separated (optional):
+```
+
+Config saves to `~/.canvas-design-mcp/institution.json` — survives `npx` reinstalls.
+
+---
+
+## Generating a Page
+
+Ask your AI assistant:
+
+> "Generate a Canvas assignment page for ITM 370, Assignment 16.06 — AI Augmented Projects, Fall 2026, Dr. Rank. Brief: Students record a 5-minute video demo of their passion project and upload to YouTube."
+
+The tool returns:
+
+- **Canvas-safe HTML** — inline styles only, no `<script>`, no disallowed properties
+- **Hero image prompt** — copy/paste into ChatGPT or Midjourney (1200×400px)
+- **Filename** — `itm-370-16.06-page.html`
+
+---
+
+## Canvas HTML Rules Enforced
+
+The validator and generator both enforce Canvas RCE constraints:
+
+| Disallowed | Reason |
+|---|---|
+| `<style>` blocks | Canvas strips them — use inline `style=""` |
+| `<script>` | Not permitted in Canvas RCE |
+| `box-shadow` | Stripped by sanitizer |
+| `opacity` | Stripped — use `rgba()` instead |
+| `gap` | Stripped in flex/grid — use `margin` on children |
+| `filter`, `transform`, `transition`, `animation` | All stripped |
+| `<h1>` | Reserved for Canvas page title |
+| `<img>` without `alt` | Accessibility violation |
+
+---
+
+## Ingest Workflow (Professors)
+
+Drop three files in an `ingest/` folder and ask your AI to build the page:
+
+```
+ingest/
+├── course-config.md      ← course number, name, professor, semester
+├── assignment-brief.md   ← raw assignment instructions (any format)
+└── style-notes.md        ← optional layout/tone preferences
+```
+
+> "Read everything in `ingest/`, then generate a Canvas assignment page."
+
+The AI reads all three files, rewrites the brief into student-friendly copy, applies your brand colors, and saves the result to `output/`.
+
+---
+
+## Publishing to Canvas
+
+Publishing directly to Canvas requires a Canvas API token. Professors who prefer the manual workflow can skip this entirely — just paste the generated HTML into Canvas as normal.
+
+### 1. List your courses
+
+> "List my Canvas courses for this semester"
+
+The tool returns each course with its ID, student count, teachers, and term — enough to confirm you have the right one before publishing.
+
+### 2. Publish a page
+
+> "Publish the generated HTML to course 12345 as 'ITM 310 — Assignment 16.06'"
+
+Before writing to Canvas, the tool automatically:
+
+- Scans for obvious FERPA/PII risks (student IDs, grade disclosures)
+- Validates the HTML against Canvas RCE rules
+- Checks for existing pages with similar titles
+
+### 3. Handle a title collision
+
+If a similar page already exists, the tool stops and asks how to proceed:
+
+```
+A page with a similar title already exists:
+  Existing: "ITM 310 — Assignment 16.06 AI Projects"
+  New:      "ITM 310 — Assignment 16.06"
+
+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 named variation
+  collisionAction: "cancel"  to stop
+```
+
+Canvas keeps full page revision history, so an update is always reversible. Use `skipFerpaCheck: true` or `forcePublish: true` only after reviewing the warning they describe.
+
+---
+
+## Keeping the KB Current
+
+Canvas occasionally updates its HTML allowlist. Run:
+
+> "Update the Canvas knowledge base"
+
+The tool fetches `canvas_sanitize.rb` directly from the Canvas LMS GitHub source and reports additions or removals. Results are cached for 24 hours; pass `force: true` to refresh immediately.
+
+---
+
+## Configuration
+
+Config file: `~/.canvas-design-mcp/institution.json`
+
+```json
+{
+  "institution": "Boise State University",
+  "colors": {
+    "primary": "#0033A0",
+    "primaryDark": "#002277",
+    "primaryLight": "#E6ECF9",
+    "secondary": "#D64309"
+  },
+  "canvasUrl": "https://boisestate.instructure.com",
+  "apiToken": "",
+  "professorEmail": "you@university.edu",
+  "favoriteCourses": [12345, 67890],
+  "kbTipShown": false
+}
+```
+
+`apiToken`, `professorEmail`, and `favoriteCourses` are optional. The generate and validate tools work without an API token. Run `setup_institution` to update any field interactively.
+
+---
+
+## Requirements
+
+- Node.js 18 or later
+- Any MCP-compatible AI host (Claude Code, VS Code Copilot, ChatGPT Codex, etc.)
+
+---
+
+## Roadmap
+
+- **v0.1** — Core MCP server: generate, validate, KB refresh, institution setup ✓
+- **v0.2** — Direct Canvas publishing: `list_canvas_courses` + `publish_to_canvas` ✓
+- **v0.3** — Accessibility module (WCAG 2.1 AA checks in wizard, validator, and generator) ✓
+- **v0.4** — Design Intelligence Brain (critique + redesign suggestions via host AI) ✓
+- **v0.5** — Panopto video integration (search, embed, caption download) ✓
+- **v0.6** — Assignment folder ingest (drop files in a folder, get a page) ✓
+- **v0.7** — Professor philosophy KB (steering context for every page Claude generates) ✓
+- **v0.8** — Student persona review (statistically grounded audience feedback before publishing) ✓
+- **v0.9** — Assignment improvement loop (load page from output/, apply critique, save back with backup) ✓
+
+---
+
+## License
+
+MIT

package/dist/canvas-api.d.ts

@@ -0,0 +1,24 @@
+import type { CanvasCourse, CanvasPage, InstitutionConfig } from './types.js';
+export interface CanvasApiClientOptions {
+    retryDelaysMs?: number[];
+}
+export declare class CanvasApiError extends Error {
+    code: string;
+    status: number;
+    details?: unknown;
+    constructor(status: number, code: string, message: string, details?: unknown);
+}
+export declare class CanvasApiClient {
+    private readonly config;
+    private readonly retryDelaysMs;
+    constructor(config: InstitutionConfig, options?: CanvasApiClientOptions);
+    listCourses(enrollmentWorkflowStates?: string | string[]): Promise<CanvasCourse[]>;
+    listPages(courseId: number): Promise<CanvasPage[]>;
+    createPage(courseId: number, title: string, html: string): Promise<CanvasPage>;
+    updatePage(courseId: number, pageUrl: string, html: string): Promise<CanvasPage>;
+    private paginatedGet;
+    private request;
+    private headers;
+    private fetchWithRetry;
+}
+//# sourceMappingURL=canvas-api.d.ts.map

package/dist/canvas-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-api.d.ts","sourceRoot":"","sources":["../src/canvas-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAK9E,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEN,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAO7E;AAqED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;gBAE7B,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAE,sBAA2B;IAKrE,WAAW,CAAC,wBAAwB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQlF,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIlD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAM9E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAMxE,YAAY;YAcZ,OAAO;IASrB,OAAO,CAAC,OAAO;YAQD,cAAc;CAsB7B"}

package/dist/canvas-api.js

@@ -0,0 +1,146 @@
+export class CanvasApiError extends Error {
+    code;
+    status;
+    details;
+    constructor(status, code, message, details) {
+        super(message);
+        this.name = 'CanvasApiError';
+        this.status = status;
+        this.code = code;
+        this.details = details;
+    }
+}
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, '');
+}
+function appendQueryValue(url, key, value) {
+    if (value === undefined)
+        return;
+    const values = Array.isArray(value) ? value : [value];
+    for (const item of values) {
+        url.searchParams.append(key, item);
+    }
+}
+function joinApiUrl(baseUrl, path, params) {
+    const url = new URL(`${trimTrailingSlash(baseUrl)}/api/v1/${path.replace(/^\/+/, '')}`);
+    for (const [key, value] of Object.entries(params ?? {})) {
+        appendQueryValue(url, key, value);
+    }
+    return url.toString();
+}
+function parseNextLink(linkHeader) {
+    if (!linkHeader)
+        return undefined;
+    const next = linkHeader.split(',').find(part => part.includes('rel="next"'));
+    const match = next?.match(/<([^>]+)>/);
+    return match?.[1];
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function responseDetails(response) {
+    try {
+        return await response.json();
+    }
+    catch {
+        try {
+            return await response.text();
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+function mapError(status, details) {
+    if (status === 401) {
+        return new CanvasApiError(status, 'CANVAS_UNAUTHORIZED', 'Canvas rejected the API token. Run setup_institution to update it.', details);
+    }
+    if (status === 403) {
+        return new CanvasApiError(status, 'CANVAS_FORBIDDEN', 'Your Canvas API token or Canvas role does not allow editing pages in this course.', details);
+    }
+    if (status === 404) {
+        return new CanvasApiError(status, 'CANVAS_NOT_FOUND', 'Course or page not found. It may have been deleted, concluded, or unavailable to your Canvas role.', details);
+    }
+    if (status === 422) {
+        return new CanvasApiError(status, 'CANVAS_REJECTED_HTML', 'Canvas rejected the page content. Review the Canvas response details.', details);
+    }
+    if (status === 429) {
+        return new CanvasApiError(status, 'CANVAS_RATE_LIMITED', 'Canvas is rate limiting requests. Try again in a few minutes.', details);
+    }
+    return new CanvasApiError(status, 'CANVAS_HTTP_ERROR', `Canvas API returned HTTP ${status}.`, details);
+}
+export class CanvasApiClient {
+    config;
+    retryDelaysMs;
+    constructor(config, options = {}) {
+        this.config = config;
+        this.retryDelaysMs = options.retryDelaysMs ?? [2000, 4000, 8000];
+    }
+    async listCourses(enrollmentWorkflowStates) {
+        return this.paginatedGet('courses', {
+            per_page: '50',
+            'include[]': ['term', 'total_students', 'teachers'],
+            'enrollment_workflow_state[]': enrollmentWorkflowStates,
+        });
+    }
+    async listPages(courseId) {
+        return this.paginatedGet(`courses/${courseId}/pages`, { per_page: '50' });
+    }
+    async createPage(courseId, title, html) {
+        return this.request('POST', `courses/${courseId}/pages`, {
+            wiki_page: { title, body: html, published: true },
+        });
+    }
+    async updatePage(courseId, pageUrl, html) {
+        return this.request('PUT', `courses/${courseId}/pages/${encodeURIComponent(pageUrl)}`, {
+            wiki_page: { body: html },
+        });
+    }
+    async paginatedGet(path, params) {
+        let nextUrl = joinApiUrl(this.config.canvasUrl, path, params);
+        const all = [];
+        while (nextUrl) {
+            const response = await this.fetchWithRetry(nextUrl, { method: 'GET', headers: this.headers() });
+            const body = await response.json();
+            all.push(...body);
+            nextUrl = parseNextLink(response.headers.get('link'));
+        }
+        return all;
+    }
+    async request(method, path, body) {
+        const response = await this.fetchWithRetry(joinApiUrl(this.config.canvasUrl, path), {
+            method,
+            headers: this.headers(),
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        return response.json();
+    }
+    headers() {
+        return {
+            Authorization: `Bearer ${this.config.apiToken ?? ''}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        };
+    }
+    async fetchWithRetry(url, init) {
+        for (let attempt = 0; attempt <= this.retryDelaysMs.length; attempt += 1) {
+            let response;
+            try {
+                response = await fetch(url, init);
+            }
+            catch (err) {
+                throw new CanvasApiError(0, 'CANVAS_NETWORK_ERROR', 'Canvas API unreachable - check your Canvas URL in institution config and try again.', err);
+            }
+            if (response.ok)
+                return response;
+            const details = await responseDetails(response);
+            if (response.status === 429 && attempt < this.retryDelaysMs.length) {
+                await sleep(this.retryDelaysMs[attempt]);
+                continue;
+            }
+            throw mapError(response.status, details);
+        }
+        throw new CanvasApiError(429, 'CANVAS_RATE_LIMITED', 'Canvas is rate limiting requests. Try again in a few minutes.');
+    }
+}
+//# sourceMappingURL=canvas-api.js.map

package/dist/canvas-api.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+import type { InstitutionConfig } from './types.js';
+export declare function configExists(): boolean;
+export declare function loadConfig(): InstitutionConfig;
+export declare function saveConfig(config: InstitutionConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKpD,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,UAAU,IAAI,iBAAiB,CAM9C;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAK1D"}

package/dist/config.js

@@ -0,0 +1,22 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+const CONFIG_DIR = join(homedir(), '.canvas-design-mcp');
+const CONFIG_PATH = join(CONFIG_DIR, 'institution.json');
+export function configExists() {
+    return existsSync(CONFIG_PATH);
+}
+export function loadConfig() {
+    if (!configExists()) {
+        throw new Error(`No institution config found at ${CONFIG_PATH}. Run setup_institution first.`);
+    }
+    const raw = readFileSync(CONFIG_PATH, 'utf-8');
+    return JSON.parse(raw);
+}
+export function saveConfig(config) {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAGxE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,oBAAoB,CAAC,CAAC;AACzD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AAEzD,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,kCAAkC,WAAW,gCAAgC,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAyB;IAClD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}

package/dist/design-engine.d.ts

@@ -0,0 +1,5 @@
+import type { InstitutionConfig } from './types.js';
+export declare function resolveTokens(template: string, config: InstitutionConfig): string;
+export declare function loadTemplate(name: string): string;
+export declare function applyTemplate(templateName: string, config: InstitutionConfig): string;
+//# sourceMappingURL=design-engine.d.ts.map

package/dist/design-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-engine.d.ts","sourceRoot":"","sources":["../src/design-engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAYjF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAGrF"}

package/dist/design-engine.js

@@ -0,0 +1,23 @@
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export function resolveTokens(template, config) {
+    const tokens = {
+        '{{institution.name}}': config.institution,
+        '{{colors.primary}}': config.colors.primary,
+        '{{colors.primaryDark}}': config.colors.primaryDark,
+        '{{colors.primaryLight}}': config.colors.primaryLight,
+        '{{colors.secondary}}': config.colors.secondary,
+    };
+    return Object.entries(tokens).reduce((html, [token, value]) => html.replaceAll(token, value), template);
+}
+export function loadTemplate(name) {
+    const templatePath = join(__dirname, 'templates', `${name}.html`);
+    return readFileSync(templatePath, 'utf-8');
+}
+export function applyTemplate(templateName, config) {
+    const template = loadTemplate(templateName);
+    return resolveTokens(template, config);
+}
+//# sourceMappingURL=design-engine.js.map

package/dist/design-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-engine.js","sourceRoot":"","sources":["../src/design-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAGpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,MAAyB;IACvE,MAAM,MAAM,GAA2B;QACrC,sBAAsB,EAAE,MAAM,CAAC,WAAW;QAC1C,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;QAC3C,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW;QACnD,yBAAyB,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY;QACrD,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS;KAChD,CAAC;IACF,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAClC,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,EACvD,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAClE,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,MAAyB;IAC3E,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}