canvas-design-mcp 0.9.0

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/wizard.d.ts

@@ -0,0 +1,3 @@
+import type { InstitutionConfig } from './types.js';
+export declare function runWizard(): Promise<InstitutionConfig>;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../src/wizard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAqCpD,wBAAsB,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA6N5D"}

package/dist/wizard.js

@@ -0,0 +1,229 @@
+import { confirm, input, password } from '@inquirer/prompts';
+import Color from 'color';
+import { saveConfig } from './config.js';
+import { wcagContrastRatio } from './tools/contrast.js';
+import { getPhilosophyKb, savePhilosophyKb, updatePhilosophyKb, PHILOSOPHY_TEMPLATE, } from './tools/philosophy.js';
+function deriveColors(primary, secondary) {
+    const c = Color(primary);
+    return {
+        primary,
+        primaryDark: c.darken(0.25).hex(),
+        primaryLight: c.lightness(93).hex(),
+        secondary,
+    };
+}
+function printMcpConfig() {
+    const config = {
+        mcpServers: {
+            'canvas-design': {
+                command: 'npx',
+                args: ['canvas-design-mcp'],
+            },
+        },
+    };
+    console.log('\n┌─────────────────────────────────────────────────────────┐');
+    console.log('│  Add this to your Claude Code MCP settings:             │');
+    console.log('└─────────────────────────────────────────────────────────┘\n');
+    console.log(JSON.stringify(config, null, 2));
+    console.log('\nRestart Claude Code (or your MCP host) to activate.\n');
+    console.log('Works in: Claude Code · VS Code · ChatGPT Codex · any MCP host\n');
+}
+export async function runWizard() {
+    console.log('\n╔═══════════════════════════════════════════════════════════╗');
+    console.log('║          Canvas Design Studio — First Run Setup           ║');
+    console.log('╚═══════════════════════════════════════════════════════════╝\n');
+    console.log('This wizard saves your institution config once.');
+    console.log('All fields except Canvas URL and API token can be changed later.\n');
+    const institution = await input({
+        message: 'Institution name:',
+        default: 'Boise State University',
+    });
+    let primaryHex;
+    while (true) {
+        primaryHex = await input({
+            message: 'Primary brand color (#hex):',
+            default: '#0033A0',
+            validate: (v) => /^#[0-9A-Fa-f]{6}$/.test(v) || 'Enter a valid hex color (e.g. #0033A0)',
+        });
+        const primaryRatio = wcagContrastRatio(primaryHex, '#ffffff');
+        if (primaryRatio >= 4.5) {
+            console.log(`  Contrast on white: ${primaryRatio.toFixed(2)}:1 — passes WCAG AA`);
+            break;
+        }
+        console.log(`  Contrast on white: ${primaryRatio.toFixed(2)}:1 — ${primaryRatio >= 3.0 ? 'marginal' : 'fails'} for body text (AA requires 4.5:1)`);
+        console.log('  White text on this color may not be readable at small sizes. Consider darkening slightly.');
+        const go = await confirm({ message: 'Proceed with this color?', default: true });
+        if (go)
+            break;
+    }
+    let secondaryHex;
+    while (true) {
+        secondaryHex = await input({
+            message: 'Secondary / accent color (#hex):',
+            default: '#D64309',
+            validate: (v) => /^#[0-9A-Fa-f]{6}$/.test(v) || 'Enter a valid hex color (e.g. #D64309)',
+        });
+        const secondaryRatio = wcagContrastRatio(secondaryHex, '#ffffff');
+        if (secondaryRatio >= 4.5) {
+            console.log(`  Contrast on white: ${secondaryRatio.toFixed(2)}:1 — passes WCAG AA`);
+            break;
+        }
+        console.log(`  Contrast on white: ${secondaryRatio.toFixed(2)}:1 — ${secondaryRatio >= 3.0 ? 'marginal' : 'fails'} for body text (AA requires 4.5:1)`);
+        console.log('  White text on this color may not be readable at small sizes. Consider darkening slightly.');
+        const go = await confirm({ message: 'Proceed with this color?', default: true });
+        if (go)
+            break;
+    }
+    const canvasUrl = await input({
+        message: 'Canvas base URL:',
+        default: 'https://boisestate.instructure.com',
+        validate: (v) => v.startsWith('https://') || 'URL must start with https://',
+    });
+    const apiToken = await password({
+        message: 'Canvas API token (optional — leave blank to generate HTML and paste it manually):',
+        mask: '*',
+        validate: (v) => !v || v.length > 10 || 'Token looks too short — leave blank or paste the full token from Canvas Account Settings > Approved Integrations',
+    });
+    const professorEmail = await input({
+        message: 'Professor email for FERPA scan allowlist (optional):',
+        default: '',
+    });
+    const favoriteCoursesRaw = await input({
+        message: 'Favorite Canvas course IDs, comma-separated (optional):',
+        default: '',
+        validate: (v) => {
+            if (!v.trim())
+                return true;
+            return v.split(',').every(id => /^\d+$/.test(id.trim())) || 'Use only numeric Canvas course IDs separated by commas.';
+        },
+    });
+    const favoriteCourses = favoriteCoursesRaw
+        .split(',')
+        .map(id => id.trim())
+        .filter(Boolean)
+        .map(Number);
+    const colors = deriveColors(primaryHex, secondaryHex);
+    const config = {
+        institution,
+        colors,
+        canvasUrl,
+        apiToken: apiToken || '',
+        professorEmail: professorEmail.trim() || undefined,
+        favoriteCourses: favoriteCourses.length > 0 ? favoriteCourses : undefined,
+        kbTipShown: false,
+    };
+    saveConfig(config);
+    // Optional Panopto section — always skippable
+    const panoptoDomain = await input({
+        message: 'Panopto domain (e.g. bsu.hosted.panopto.com, or leave blank to skip):',
+        default: '',
+    });
+    if (panoptoDomain.trim()) {
+        const whitelistAnswer = await input({
+            message: 'Is Panopto whitelisted for iframes in Canvas? (yes / no / unsure):',
+            default: 'unsure',
+            validate: (v) => ['yes', 'no', 'unsure'].includes(v.toLowerCase()) || 'Enter yes, no, or unsure',
+        });
+        const iframeWhitelisted = whitelistAnswer.toLowerCase() === 'yes' ? true :
+            whitelistAnswer.toLowerCase() === 'no' ? false :
+                null;
+        const panoptoClientId = await input({
+            message: 'Panopto API client ID (leave blank to skip — enables video search and caption download):',
+            default: '',
+        });
+        let panoptoClientSecret = '';
+        if (panoptoClientId.trim()) {
+            panoptoClientSecret = await password({
+                message: 'Panopto API client secret:',
+                mask: '*',
+            });
+        }
+        config.panopto = {
+            domain: panoptoDomain.trim().replace(/^https?:\/\//i, ''),
+            iframeWhitelisted,
+            ...(panoptoClientId.trim() ? { clientId: panoptoClientId.trim(), clientSecret: panoptoClientSecret } : {}),
+        };
+        saveConfig(config);
+        console.log(`✓ Panopto domain: ${panoptoDomain.trim()}`);
+        console.log(`  iFrame whitelisted: ${iframeWhitelisted === null ? 'unsure' : String(iframeWhitelisted)}`);
+        if (panoptoClientId.trim())
+            console.log('✓ Panopto API credentials saved');
+    }
+    // Philosophy KB phase — runs after Panopto, before final summary
+    const kbResult = getPhilosophyKb();
+    if (!kbResult.exists) {
+        const buildKb = await confirm({
+            message: 'Would you like to build your teaching philosophy KB now?\nClaude uses it to tailor every Canvas page to your style.\n(You can skip and build it in Claude later.)',
+            default: true,
+        });
+        if (buildKb) {
+            console.log('\nBuilding your teaching philosophy KB...\n');
+            const philosophyQuestions = [
+                "What's one thing you always tell students about this subject that you wish they'd really internalize?",
+                "What does a student who truly gets it do differently from one who just completes the work?",
+                "What's the biggest mistake students make on your assignments?",
+                "What separates an A from a B in concrete terms?",
+                "Are there teaching frameworks you consciously draw from? (Bloom's, UDL, constructivism, andragogy, etc.)",
+                "Any quotes or sayings you use regularly in class?",
+            ];
+            const answers = [];
+            for (const q of philosophyQuestions) {
+                const answer = await input({ message: q });
+                if (answer.trim())
+                    answers.push(answer.trim());
+            }
+            const coreContent = answers.map(a => `- ${a}`).join('\n');
+            const kbContent = PHILOSOPHY_TEMPLATE.replace('## Core Teaching Philosophy\n', `## Core Teaching Philosophy\n\n${coreContent}\n`);
+            savePhilosophyKb(kbContent);
+            console.log('✓ Teaching philosophy KB saved');
+        }
+        else {
+            savePhilosophyKb(PHILOSOPHY_TEMPLATE);
+            console.log('✓ Philosophy KB template saved — build it in Claude anytime');
+        }
+    }
+    else {
+        const updateKb = await confirm({
+            message: 'You already have a philosophy KB. Would you like to review or update it?',
+            default: false,
+        });
+        if (updateKb) {
+            console.log('\nYour current philosophy KB:\n');
+            console.log(kbResult.content);
+            console.log('');
+            const addCourse = await confirm({
+                message: 'Would you like to add course-specific focus for a course?',
+                default: false,
+            });
+            if (addCourse) {
+                const courseKey = await input({
+                    message: 'Course key (e.g. "ITM 370 — AI Augmented Projects"):',
+                    validate: (v) => v.trim().length > 0 || 'Course key is required',
+                });
+                const courseNote = await input({
+                    message: `What should Claude know specifically about ${courseKey.trim()}?`,
+                });
+                if (courseNote.trim()) {
+                    updatePhilosophyKb({ entry: courseNote.trim(), section: 'course', courseKey: courseKey.trim() });
+                    console.log(`✓ Course-specific focus added for ${courseKey.trim()}`);
+                }
+            }
+        }
+    }
+    console.log('\n✓ Config saved to ~/.canvas-design-mcp/institution.json');
+    console.log(`✓ Primary:   ${colors.primary}  →  dark: ${colors.primaryDark}  light: ${colors.primaryLight}`);
+    console.log(`✓ Secondary: ${colors.secondary}`);
+    if (!apiToken.trim()) {
+        console.log('  Canvas API token skipped. You can still generate HTML and paste it into Canvas manually.');
+    }
+    if (professorEmail.trim()) {
+        console.log(`✓ FERPA scan allowlist email: ${professorEmail.trim()}`);
+    }
+    if (favoriteCourses.length > 0) {
+        console.log(`✓ Favorite Canvas courses: ${favoriteCourses.join(', ')}`);
+    }
+    console.log('✓ Canvas Design Studio is ready\n');
+    printMcpConfig();
+    return config;
+}
+//# sourceMappingURL=wizard.js.map

package/dist/wizard.js.map

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

package/docs/canvas-design-kb/00-meta/Changelog.md

@@ -0,0 +1,42 @@
+# Changelog
+
+Parent: [Canvas Design Knowledge Base](../README.md) | [KB Overview](KB-Overview.md)
+
+## 2026-05-10 - Public Documentation Cleanup
+
+- Removed production guidance for the third-party Canvas design add-on and deleted those 04-tools pages.
+- Kept third-party showcase references only where they are framed as external inspiration in [Inspiration and Showcases](../07-resources/Inspiration-and-Showcases.md).
+- Converted the KB map and major reference pages away from Obsidian-style links.
+- Reworked public resources so Canvas Design Studio is positioned as a standalone Canvas-safe HTML generator, not an integration with a commercial Canvas add-on.
+
+## 2026-04-28 - Resource Evaluation Pass
+
+New files:
+
+- [Canvas Built-In CSS Classes](../01-canvas-rce/Canvas-Built-In-CSS-Classes.md) - Canvas utility classes such as `border`, `content-box`, `grid-row`, `col-*`, and `ic-Table`.
+- [Other Canvas Design Tools](../04-tools/Other-Canvas-Design-Tools.md) - external Canvas design references, including Loree, HowToCanvas, Fleximode, JHU, Canvas Commons, and Canvas source links.
+- [Inspiration and Showcases](../07-resources/Inspiration-and-Showcases.md) - real Canvas examples and design lessons.
+
+Updated files:
+
+- [HTML Allowlist](../01-canvas-rce/HTML-Allowlist.md) - added built-in CSS class notes.
+- [RCE Limitations and Workarounds](../01-canvas-rce/RCE-Limitations-and-Workarounds.md) - grid gap workaround references built-in classes.
+- [Official Canvas Links](../07-resources/Official-Canvas-Links.md) - consolidated production-facing Canvas and utility links.
+- [README](../README.md) - updated KB map and quick reference table.
+
+## 2026-04-28 - Initial Build
+
+- Created the first knowledge base structure.
+- Populated the core Canvas RCE, design-system, pattern, accessibility, and resource files.
+
+## Template for Future Entries
+
+```text
+## YYYY-MM-DD - Brief description
+
+- What changed and why
+- Source/reference if applicable
+- Files affected: path/to/file.md
+```
+
+[KB Overview](KB-Overview.md) | [Contributing](Contributing.md)

package/docs/canvas-design-kb/00-meta/Contributing.md

@@ -0,0 +1,58 @@
+# Contributing to This KB
+
+> **Parent:** [README](../README.md) | **Related:** [KB Overview](./KB-Overview.md), [Changelog](./Changelog.md)
+
+---
+
+## How to Add Notes
+
+### Adding a New Pattern
+
+1. Create a new file in `05-patterns/` named descriptively: `Assignment-Page.md`, `Reading-Page.md`, etc.
+2. Include the standard front matter: `> **Parent:** [README](../README.md) | **Related:** ...`
+3. Add the anatomy, full HTML template, and customization checklist
+4. Link from [README](../README.md) in the appropriate section
+5. Add to [Changelog](./Changelog.md)
+
+### Adding a New Component to the Library
+
+1. Open [Component Library](../03-design-systems/Component-Library.md)
+2. Add a numbered section with the component name
+3. Include the ready-to-paste HTML
+4. Add a note about any Canvas-specific gotchas
+5. Update [Changelog](./Changelog.md)
+
+### Updating an Existing Note
+
+When Canvas changes behavior or a tool releases a new version:
+1. Update the relevant file(s)
+2. Add a dated entry to [Changelog](./Changelog.md)
+3. If a link has changed, update the URL and note the change
+
+---
+
+## Formatting Conventions
+
+- **Parent link** at top of every file
+- **Related** links to closely connected files
+- **Source** links to external authoritative references
+- **⚠️** for warnings or "use with caution" notes
+- **✅/❌** for allowed/not-allowed comparisons
+- HTML code blocks use triple backticks with `html` language tag
+- Inline code uses single backticks for HTML tags and CSS properties
+
+---
+
+## What to Check Before Publishing a Pattern
+
+- [ ] All HTML tested in Canvas RCE (paste into HTML view, save, verify nothing stripped)
+- [ ] Checked in student view
+- [ ] Tested on mobile (or Canvas mobile app)
+- [ ] Color contrast checked against WCAG AA
+- [ ] Heading hierarchy correct (H2 → H3 → H4)
+- [ ] All images have `alt` attributes
+- [ ] Links have descriptive text
+
+---
+
+*[KB Overview](./KB-Overview.md) | [Changelog](./Changelog.md)*

package/docs/canvas-design-kb/00-meta/KB-Overview.md

@@ -0,0 +1,51 @@
+# KB Overview
+
+Parent: [Canvas Design Knowledge Base](../README.md)
+
+This knowledge base is structured around three concerns:
+
+1. Canvas constraints: what HTML and CSS survive inside the Canvas Rich Content Editor.
+2. Design systems: how to define a consistent visual language for a course.
+3. Patterns and examples: reusable Canvas-safe components plus real course examples for inspiration.
+
+## Folder Structure
+
+```text
+canvas-design-kb/
+|-- README.md                  # Top-level map
+|-- 00-meta/                   # KB management
+|-- 01-canvas-rce/             # How Canvas handles HTML/CSS
+|-- 02-design-md/              # DESIGN.md specification notes
+|-- 03-design-systems/         # Design system principles and components
+|-- 04-tools/                  # Canvas admin/tooling context
+|-- 05-patterns/               # Page and component templates
+|-- 06-accessibility/          # WCAG and inclusive design
+`-- 07-resources/              # External links and references
+```
+
+## Update Cadence
+
+| Area | When to review |
+|---|---|
+| HTML allowlist | When Canvas releases a major update |
+| DESIGN.md spec | Monthly while the spec is evolving |
+| Patterns and templates | Whenever a reusable page pattern is added |
+| Accessibility | When WCAG or institutional guidance changes |
+| External links | Before each public release |
+
+## How to Use in Canvas Design Studio
+
+1. Use [DESIGN.md Canvas Template](../02-design-md/DESIGN-MD-Canvas-Template.md) as the course design contract.
+2. Treat [HTML Allowlist](../01-canvas-rce/HTML-Allowlist.md) and [CSS Inline Strategy](../01-canvas-rce/CSS-Inline-Strategy.md) as hard constraints.
+3. Pull reusable snippets from [Component Library](../03-design-systems/Component-Library.md).
+4. Use [Course Home Page](../05-patterns/Course-Home-Page.md) as the first page-level pattern.
+5. Validate final HTML with [Accessibility Overview](../06-accessibility/Accessibility-Overview.md) and the `validate_canvas_html` MCP tool.
+
+## Key Decisions
+
+- Canvas strips `<style>` tags from content, so generated page CSS must be inline.
+- Canvas reserves `<h1>` for the page title, so generated content starts at `<h2>`.
+- The beginner workflow remains first-class: generate Canvas-safe HTML, then paste it manually into Canvas.
+- Optional Canvas API publishing is a convenience, not a requirement.
+
+See also: [Changelog](Changelog.md), [Contributing](Contributing.md)

package/docs/canvas-design-kb/01-canvas-rce/CSS-Inline-Strategy.md

@@ -0,0 +1,166 @@
+# CSS Inline Strategy for Canvas
+
+> **Parent:** [README](../README.md) | **Related:** [HTML Allowlist](./HTML-Allowlist.md), [RCE Overview](./RCE-Overview.md)
+
+---
+
+## The Core Constraint
+
+Canvas strips `<style>` blocks from the RCE on save. **Every CSS declaration must live in a `style=""` attribute on the element it affects.**
+
+This is non-negotiable at the page level unless your institution has a Canvas admin who can inject global CSS via the Theme Editor (see [Canvas Theme Editor](../04-tools/Canvas-Theme-Editor.md)).
+
+---
+
+## Writing Inline Styles That Survive
+
+### ✅ Reliable Patterns
+
+```html
+<!-- Basic block with border and padding -->
+<div style="border: 2px solid #0F6E56; padding: 16px; margin-bottom: 16px;">
+  Content here
+</div>
+
+<!-- Colored background callout -->
+<div style="background: #e1f5ee; border-left: 4px solid #0F6E56; padding: 14px 18px;">
+  <strong>Tip:</strong> Important note here.
+</div>
+
+<!-- Two-column flex layout -->
+<div style="display: flex; margin-bottom: 20px;">
+  <div style="flex: 1; padding: 12px; border: 1px solid #ddd;">Left column</div>
+  <div style="flex: 1; padding: 12px; border: 1px solid #ddd; margin-left: 12px;">Right column</div>
+</div>
+
+<!-- Card with border-radius -->
+<div style="border: 1px solid #e0e0d8; border-radius: 10px; padding: 18px; margin-bottom: 16px;">
+  Card content
+</div>
+
+<!-- Styled button link -->
+<a href="#" style="display: inline-block; background: #0F6E56; color: #ffffff; padding: 10px 20px; border-radius: 6px; text-decoration: none; font-weight: bold;">
+  Button Label
+</a>
+```
+
+### ❌ Things That Will Be Stripped
+
+```html
+<!-- STRIPPED: <style> block -->
+<style>
+  .my-card { border-radius: 8px; }
+</style>
+
+<!-- STRIPPED: box-shadow -->
+<div style="box-shadow: 0 2px 8px rgba(0,0,0,0.15);">
+
+<!-- STRIPPED: transform -->
+<div style="transform: rotate(3deg);">
+
+<!-- STRIPPED: transition -->
+<div style="transition: all 0.3s ease;">
+
+<!-- STRIPPED: gap (use margin instead) -->
+<div style="display: flex; gap: 16px;">
+```
+
+---
+
+## Color Strategy
+
+Since `opacity` is stripped, use **RGBA colors** for semi-transparent effects:
+
+```html
+<!-- Semi-transparent background -->
+<div style="background: rgba(15, 110, 86, 0.1); padding: 16px;">
+
+<!-- Border with transparency -->
+<div style="border: 1px solid rgba(0,0,0,0.15); padding: 16px;">
+```
+
+---
+
+## Flex Layout Without `gap`
+
+Since `gap` isn't reliable, use negative margins on the parent + margins on children:
+
+```html
+<!-- Flex grid with spacing -->
+<div style="display: flex; flex-wrap: wrap; margin-right: -12px;">
+  <div style="flex: 1; min-width: 200px; margin-right: 12px; margin-bottom: 12px; border: 1px solid #ddd; padding: 16px; border-radius: 8px;">
+    Item 1
+  </div>
+  <div style="flex: 1; min-width: 200px; margin-right: 12px; margin-bottom: 12px; border: 1px solid #ddd; padding: 16px; border-radius: 8px;">
+    Item 2
+  </div>
+</div>
+```
+
+---
+
+## Using CSS Inliner Tools
+
+For complex layouts built externally (e.g., in a local HTML file with a `<style>` block), use an **inliner tool** to convert all CSS to inline styles before pasting into Canvas:
+
+| Tool | URL | Notes |
+|---|---|---|
+| Juice (CLI) | https://github.com/Automattic/juice | Best for automation |
+| CSS Inliner (web) | https://htmlemail.io/inline/ | Good for one-off use |
+| Premailer | https://premailer.dialect.ca/ | Email-focused but works |
+
+**Workflow:**
+1. Write HTML with a `<style>` block (readable, maintainable)
+2. Run through inliner
+3. Paste resulting inline-only HTML into Canvas RCE HTML view
+4. Save and verify
+
+---
+
+## Account-Level CSS (Admin Only)
+
+If you have Canvas admin access, you can inject global CSS via:
+
+**Admin → Account → Themes → Upload JS/CSS**
+
+This allows `<style>` classes to work across all courses in the account. Useful for institution-wide design systems.
+
+See [Canvas Theme Editor](../04-tools/Canvas-Theme-Editor.md) for details.
+
+---
+
+## Property Reference Cheat Sheet
+
+| CSS Property | Canvas Allowed? | Notes |
+|---|---|---|
+| `background` | ✅ | Includes `background-color` shorthand |
+| `border` | ✅ | All border shorthand works |
+| `border-radius` | ✅ | Works reliably |
+| `color` | ✅ | Text color |
+| `display` | ✅ | `flex`, `grid`, `block`, `inline-block` all work |
+| `flex` | ✅ | Shorthand works; individual flex properties vary |
+| `font` | ✅ | Shorthand; `font-size`, `font-weight`, `font-family` all survive |
+| `height` / `width` | ✅ | Including `%` and `px` values |
+| `margin` / `padding` | ✅ | All variants |
+| `max-width` / `min-width` | ✅ | Responsive containment |
+| `overflow` | ✅ | Useful for layout containment |
+| `position` | ✅ | `relative`, `absolute` work |
+| `text-align` | ✅ | |
+| `text-decoration` | ✅ | |
+| `vertical-align` | ✅ | |
+| `z-index` | ✅ | |
+| `box-shadow` | ❌ | Stripped |
+| `filter` | ❌ | Stripped |
+| `transform` | ❌ | Stripped |
+| `transition` | ❌ | Stripped |
+| `animation` | ❌ | Stripped |
+| `opacity` | ❌ | Use `rgba()` colors instead |
+| `gap` | ❌ | Use `margin` on children |
+
+---
+
+## See Also
+
+- [HTML Allowlist](./HTML-Allowlist.md) — Master reference for all allowed tags and properties
+- [RCE Limitations And Workarounds](./RCE-Limitations-and-Workarounds.md) — Edge cases and institutional escalations
+- [Component Library](../03-design-systems/Component-Library.md) — Pre-built components using only allowed CSS