@se-studio/project-build 1.0.117 → 1.0.119

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @se-studio/project-build
 
+## 1.0.119
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
+## 1.0.118
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
 ## 1.0.117
 
 ### Patch Changes

package/dist/cms-generate-html-style-guide.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+export {};
+//# sourceMappingURL=cms-generate-html-style-guide.d.ts.map

package/dist/cms-generate-html-style-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-generate-html-style-guide.d.ts","sourceRoot":"","sources":["../src/cms-generate-html-style-guide.ts"],"names":[],"mappings":";AACA,uFAAuF"}

package/dist/cms-generate-html-style-guide.js

@@ -0,0 +1,597 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+/**
+ * cms-generate-html-style-guide
+ *
+ * Generates a comprehensive HTML authoring style guide for HtmlComponent entries.
+ * Reads the project's design tokens from tailwind.config.json and globals.css and
+ * produces a self-contained markdown reference document.
+ *
+ * Usage:
+ *   cms-generate-html-style-guide [--app-dir <path>]
+ *
+ * Output:
+ *   <app-dir>/docs/cms-guidelines/html-component-style-guide.md
+ *
+ * The output file is picked up automatically by cms-merge-guidelines and included
+ * as the "Design System Reference" preamble in COMPONENT_GUIDELINES_FOR_LLM.md.
+ *
+ * Run this whenever tailwind.config.json or globals.css changes, or as part of
+ * the update-cms-guidelines workflow.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { loadTailwindConfig } from './loadTailwindConfig.js';
+// ---------------------------------------------------------------------------
+// CLI parsing
+// ---------------------------------------------------------------------------
+function parseAppDir() {
+    const args = process.argv.slice(2);
+    const idx = args.indexOf('--app-dir');
+    return idx !== -1 && args[idx + 1] ? args[idx + 1] : process.cwd();
+}
+// ---------------------------------------------------------------------------
+// CSS parsing helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extracts all @utility names from a globals.css string.
+ * Returns a list of { name, body } where body is the raw CSS inside the braces.
+ */
+function extractUtilities(css) {
+    const results = [];
+    // Match @utility <name> { ... } — handle nested braces via depth counting
+    const utilityRe = /@utility\s+([\w-]+)\s*\{/g;
+    let match = utilityRe.exec(css);
+    while (match !== null) {
+        const name = match[1];
+        const start = utilityRe.lastIndex;
+        let depth = 1;
+        let i = start;
+        while (i < css.length && depth > 0) {
+            if (css[i] === '{')
+                depth++;
+            else if (css[i] === '}')
+                depth--;
+            i++;
+        }
+        const body = css.slice(start, i - 1).trim();
+        results.push({ name, body });
+        match = utilityRe.exec(css);
+    }
+    return results;
+}
+/**
+ * Extracts .rtf-* class names present in the CSS.
+ */
+function extractRtfClasses(css) {
+    const names = new Set();
+    const rtfRe = /\.(rtf-[\w-]+)/g;
+    let m = rtfRe.exec(css);
+    while (m !== null) {
+        names.add(m[1]);
+        m = rtfRe.exec(css);
+    }
+    return [...names].sort();
+}
+/**
+ * Extracts CSS custom property declarations from :root blocks.
+ */
+function extractRootVars(css) {
+    const results = [];
+    // Find :root { ... } blocks
+    const rootRe = /:root\s*\{([^}]+)\}/g;
+    let m = rootRe.exec(css);
+    while (m !== null) {
+        const block = m[1];
+        const varRe = /--([\w-]+)\s*:\s*([^;]+);/g;
+        let v = varRe.exec(block);
+        while (v !== null) {
+            results.push({ name: `--${v[1]}`, value: v[2].trim() });
+            v = varRe.exec(block);
+        }
+        m = rootRe.exec(css);
+    }
+    return results;
+}
+function resolveSizePx(value) {
+    if (typeof value === 'number')
+        return value;
+    if (value !== null && typeof value === 'object') {
+        const v = value;
+        if (typeof v['sizePixels'] === 'number')
+            return v['sizePixels'];
+    }
+    return null;
+}
+function buildBreakpointsSection(config) {
+    const sizes = config.sizes ?? {};
+    const lines = ['## Breakpoints', ''];
+    lines.push('All breakpoints are **mobile-first**. Default styles apply to all sizes; use prefixes to override at larger breakpoints.');
+    lines.push('');
+    lines.push('| Prefix | Min-width | Columns |');
+    lines.push('|--------|-----------|---------|');
+    lines.push('| *(none)* | 0px (mobile) | ' + (sizes['mobile']?.cols ?? '—') + ' |');
+    for (const [name, s] of Object.entries(sizes)) {
+        if (name === 'mobile' || s.breakpoint === undefined)
+            continue;
+        lines.push(`| \`${name}:\` | ${s.breakpoint}px | ${s.cols ?? '—'} |`);
+    }
+    lines.push('');
+    lines.push('```html');
+    lines.push('<!-- Example: stacked on mobile, side-by-side on laptop -->');
+    lines.push('<div class="flex flex-col laptop:flex-row gap-6">...</div>');
+    lines.push('```');
+    return lines.join('\n');
+}
+function buildColourSection(config) {
+    const colorOptions = config.colorOptions ?? {};
+    const gradients = config.gradients ?? {};
+    const foregroundColors = new Set(config.foregroundColors ?? []);
+    const colorOpposites = config.colorOpposites ?? {};
+    const lines = ['## Colour Palette', ''];
+    lines.push('Use **lowercase** colour names in Tailwind classes (e.g. colour `Dark` → class `text-dark`).');
+    lines.push('');
+    if (Object.keys(colorOptions).length > 0) {
+        lines.push('| Name | Hex | `bg-*` class | `text-*` class | `border-*` class | Contrast pair |');
+        lines.push('|------|-----|-------------|----------------|-----------------|---------------|');
+        for (const [name, hex] of Object.entries(colorOptions)) {
+            const lc = name.toLowerCase();
+            const opposite = colorOpposites[name] ?? '—';
+            const foreground = foregroundColors.has(name) ? '*(text colour)*' : '';
+            lines.push(`| **${name}** ${foreground} | \`${hex}\` | \`bg-${lc}\` | \`text-${lc}\` | \`border-${lc}\` | ${opposite} |`);
+        }
+    }
+    if (Object.keys(gradients).length > 0) {
+        lines.push('');
+        lines.push('**Gradients:**');
+        lines.push('');
+        lines.push('| Name | Value | `bg-*` class |');
+        lines.push('|------|-------|-------------|');
+        for (const [name, value] of Object.entries(gradients)) {
+            const lc = name.toLowerCase();
+            lines.push(`| ${name} | \`${value}\` | \`bg-${lc}\` |`);
+        }
+    }
+    lines.push('');
+    lines.push('**Rules:**');
+    lines.push('- Never use hardcoded hex values. Always use the named classes above.');
+    lines.push('- For body copy on a dark background use the contrast pair (e.g. `bg-dark text-light`).');
+    lines.push('- Accent colours (Orange, Blue, Yellow) work as backgrounds and highlights.');
+    return lines.join('\n');
+}
+function buildTypographySection(config) {
+    const fontTable = config.fontTable;
+    const styles = fontTable?.styles;
+    if (!styles || Object.keys(styles).length === 0) {
+        return '## Typography\n\nNo typography styles defined in tailwind.config.json.';
+    }
+    // After the guard above, styles is guaranteed defined. Alias for closure access.
+    const definedStyles = styles;
+    const baseFont = fontTable?.font ?? 'sans-serif';
+    const baseWeight = fontTable?.weight ?? 400;
+    const lines = ['## Typography', ''];
+    lines.push(`Base font: **${baseFont}** | Base weight: **${baseWeight}**`);
+    lines.push('');
+    lines.push('Use the class name directly on any HTML element — the class controls font-size, weight, line-height, and letter-spacing across breakpoints.');
+    lines.push('');
+    // Categorise by approximate usage
+    const displayClasses = [];
+    const headingClasses = [];
+    const bodyClasses = [];
+    const specialClasses = [];
+    for (const name of Object.keys(styles)) {
+        if (name.startsWith('h1'))
+            displayClasses.push(name);
+        else if (name.startsWith('h2') || name.startsWith('h3') || name.startsWith('h4'))
+            headingClasses.push(name);
+        else if (name.startsWith('p'))
+            bodyClasses.push(name);
+        else
+            specialClasses.push(name);
+    }
+    function buildTypographyTable(names) {
+        const rows = [
+            '| Class | Mobile | Tablet | Laptop | Desktop | Weight | Notes |',
+            '|-------|--------|--------|--------|---------|--------|-------|',
+        ];
+        for (const name of names) {
+            const e = definedStyles[name];
+            const defaultPx = resolveSizePx(e['default']);
+            const tabletPx = resolveSizePx(e['tablet']);
+            const laptopVal = e['laptop'];
+            const laptopPx = laptopVal !== undefined ? resolveSizePx(laptopVal) : null;
+            const desktopVal = e['desktop'];
+            const desktopPx = desktopVal !== undefined ? resolveSizePx(desktopVal) : null;
+            const weight = typeof e['weight'] === 'number' ? e['weight'] : (baseWeight ?? '—');
+            const additional = e['additional'];
+            const notes = [];
+            if (additional?.['text-transform'] === 'uppercase')
+                notes.push('UPPERCASE');
+            if (typeof e['letterSpacing'] === 'number' && e['letterSpacing'] !== 0)
+                notes.push(`tracking ${e['letterSpacing']}px`);
+            rows.push(`| \`${name}\` | ${defaultPx !== null ? `${defaultPx}px` : '—'} | ${tabletPx !== null ? `${tabletPx}px` : '—'} | ${laptopPx !== null ? `${laptopPx}px` : '—'} | ${desktopPx !== null ? `${desktopPx}px` : '—'} | ${weight} | ${notes.join(', ')} |`);
+        }
+        return rows.join('\n');
+    }
+    if (displayClasses.length > 0) {
+        lines.push('### Display Headings');
+        lines.push('');
+        lines.push(buildTypographyTable(displayClasses));
+        lines.push('');
+    }
+    if (headingClasses.length > 0) {
+        lines.push('### Section & Sub-Headings');
+        lines.push('');
+        lines.push(buildTypographyTable(headingClasses));
+        lines.push('');
+    }
+    if (bodyClasses.length > 0) {
+        lines.push('### Body Text');
+        lines.push('');
+        lines.push(buildTypographyTable(bodyClasses));
+        lines.push('');
+    }
+    if (specialClasses.length > 0) {
+        lines.push('### Special Styles');
+        lines.push('');
+        lines.push(buildTypographyTable(specialClasses));
+        lines.push('');
+    }
+    lines.push('**Rules:**');
+    lines.push('- Apply the class directly: `<h2 class="h2">Heading</h2>`');
+    lines.push('- Never use `text-[Npx]`, `font-size`, or `font-weight` inline styles.');
+    lines.push('- For body copy, use `p1` (large) or `p2` (standard). Reserve `h*` classes for actual headings.');
+    return lines.join('\n');
+}
+function buildGridSection(config) {
+    const sizes = config.sizes ?? {};
+    const lines = ['## Grid & Layout', ''];
+    lines.push('Content is placed on a CSS grid. The grid column count changes per breakpoint; gaps and margins are fixed.');
+    lines.push('');
+    lines.push('| Breakpoint | Columns | Gap | Margin |');
+    lines.push('|------------|---------|-----|--------|');
+    for (const [name, s] of Object.entries(sizes)) {
+        const bp = s.breakpoint !== undefined ? `${s.breakpoint}px` : 'default';
+        const cols = s.cols !== undefined ? String(s.cols) : '—';
+        const gap = s.gap !== undefined ? `${s.gap}px` : '—';
+        const margin = s.margin !== undefined ? `${s.margin}px` : '—';
+        lines.push(`| ${name} (${bp}) | ${cols} | ${gap} | ${margin} |`);
+    }
+    lines.push('');
+    lines.push('### Grid Container Classes');
+    lines.push('');
+    lines.push("`HtmlComponent` content is placed inside the site's 12-column grid automatically. Use these classes to position content within it:");
+    lines.push('');
+    lines.push('| Class | Description |');
+    lines.push('|-------|-------------|');
+    lines.push('| `col-span-full` | Full width (all columns) |');
+    lines.push('| `laptop:col-start-2 laptop:col-span-10` | Centered with one-column margin each side (laptop+) |');
+    lines.push('| `laptop:col-start-2 laptop:col-span-4` | Left column (text side in two-column layout) |');
+    lines.push('| `laptop:col-start-7 laptop:col-span-5` | Right column (visual side in two-column layout) |');
+    lines.push('| `laptop:col-start-2 laptop:col-span-5` | Narrow left half |');
+    lines.push('| `laptop:col-start-7 laptop:col-span-6` | Wide right half |');
+    lines.push('');
+    lines.push('### Layout Notes');
+    lines.push('');
+    lines.push('- Wrap column children in a `content-cols-grid` parent to activate the column grid.');
+    lines.push('- On mobile, all columns are `col-span-full` by default.');
+    lines.push('- For edge-to-edge (full-bleed) content, set `fullWidth: true` on the HtmlComponent entry — the grid wrapper is removed.');
+    return lines.join('\n');
+}
+function buildSpacingSection() {
+    const lines = ['## Spacing Conventions', ''];
+    lines.push('Use Tailwind spacing utilities. Multiples of 4 (the Tailwind scale) are preferred.');
+    lines.push('');
+    lines.push('| Purpose | Classes |');
+    lines.push('|---------|---------|');
+    lines.push('| Section vertical padding (large) | `py-16 laptop:py-24` |');
+    lines.push('| Section vertical padding (medium) | `py-12 laptop:py-16` |');
+    lines.push('| Section vertical padding (small) | `py-8 laptop:py-12` |');
+    lines.push('| Between stacked elements | `space-y-4 laptop:space-y-8` |');
+    lines.push('| Flex/grid gap | `gap-4 laptop:gap-8` |');
+    lines.push('| Card padding | `p-6 laptop:p-10` |');
+    lines.push('');
+    lines.push('> **Note:** HtmlComponent renders inside the Section component which already provides top/bottom padding. Avoid adding extra outer padding that doubles the section gap.');
+    return lines.join('\n');
+}
+function buildUtilitiesSection(utilities) {
+    // Filter out internal/layout utilities unlikely to be useful in raw HTML
+    const skipList = new Set([
+        'unknown-component',
+        'button',
+        'outlined-button',
+        'visual-cols',
+        'visual-width',
+        'image-item-h',
+        'row-1-pageHalf',
+        'row-6-pageHalf',
+    ]);
+    const useful = utilities.filter((u) => !skipList.has(u.name));
+    if (useful.length === 0) {
+        return '## Custom Tailwind Utilities\n\n*None defined in globals.css.*';
+    }
+    const lines = ['## Custom Tailwind Utilities', ''];
+    lines.push('These utilities are available in addition to the standard Tailwind library:');
+    lines.push('');
+    lines.push('| Class | Description |');
+    lines.push('|-------|-------------|');
+    const descriptions = {
+        'animate-ticker': 'Horizontal ticker/marquee scroll animation (20s loop)',
+        'animate-fade-in-grow': 'Fade in + scale up entrance animation (0.5s)',
+        'animate-shape-shift': 'Animated shape morphing (clip-path + rotation, 9s loop)',
+        'animate-card-rotate': 'Subtle 3D rotation on hover (0.4s)',
+        'animate-clip-reveal': 'Left-to-right clip-path reveal animation (0.6s)',
+        'film-grain': 'Adds a subtle animated film grain overlay (fixed, z-index 9998)',
+        'section-spacing': 'Standard section top/bottom padding',
+    };
+    for (const { name } of useful) {
+        const desc = descriptions[name] ?? 'Custom utility — see globals.css for details';
+        lines.push(`| \`${name}\` | ${desc} |`);
+    }
+    return lines.join('\n');
+}
+function buildRtfSection(rtfClasses) {
+    const lines = ['## Rich Text Classes', ''];
+    lines.push('Apply these classes to an element that contains HTML produced from rich text or Markdown:');
+    lines.push('');
+    const rtfDescriptions = {
+        'rtf-standard': 'Default rich text styling. Handles headings, paragraphs, lists, blockquotes, and links with standard spacing. Use for most body content.',
+        'rtf-article': 'Editorial / blog styling with wider paragraph spacing and emphasis on readability. Use for long-form articles.',
+        'rtf-article-right': 'Article styling with paragraphs pinned to the right column (laptop+). Use for editorial layouts with a wide left margin.',
+        'rtf-legal': 'Legal document styling with compact spacing. Headings map to smaller sizes (h1→h3, h2→h4, etc.). Use for terms, privacy, and compliance content.',
+    };
+    if (rtfClasses.length === 0) {
+        lines.push('*No `.rtf-*` classes found in globals.css.*');
+    }
+    else {
+        lines.push('| Class | Use when… |');
+        lines.push('|-------|-----------|');
+        for (const cls of rtfClasses) {
+            const desc = rtfDescriptions[cls] ?? 'Custom rich text variant — see globals.css for details.';
+            lines.push(`| \`${cls}\` | ${desc} |`);
+        }
+        lines.push('');
+        lines.push('```html');
+        lines.push('<div class="rtf-standard">');
+        lines.push('  <h2>Heading</h2>');
+        lines.push('  <p>Paragraph with <strong>bold</strong> and <em>italic</em>.</p>');
+        lines.push('  <ul><li>List item</li></ul>');
+        lines.push('</div>');
+        lines.push('```');
+    }
+    return lines.join('\n');
+}
+function buildFontsSection(config) {
+    const fontTable = config.fontTable;
+    const baseFont = fontTable?.font;
+    const lines = ['## Fonts', ''];
+    if (baseFont) {
+        lines.push(`The primary font is **${baseFont}**, loaded via Next.js font optimisation.`);
+        lines.push('');
+        lines.push('| Tailwind property | CSS variable |');
+        lines.push('|-------------------|--------------|');
+        lines.push('| `font-sans` | `var(--font-sans)` — use for all body and heading text |');
+        lines.push('| `font-mono` | `var(--font-mono)` — use for code snippets |');
+        lines.push('');
+        lines.push('> **Do not** reference the font family by name in CSS. Use `font-sans` or rely on the typography classes which already apply the correct font.');
+    }
+    else {
+        lines.push('Font information not available in tailwind.config.json.');
+    }
+    return lines.join('\n');
+}
+function buildPatternsSection(config) {
+    const colors = Object.keys(config.colorOptions ?? {});
+    const darkColor = colors.find((c) => c.toLowerCase() === 'dark') ?? colors[0] ?? 'dark';
+    const lightColor = colors.find((c) => c.toLowerCase() === 'light') ?? colors[1] ?? 'light';
+    const accentColor = colors.find((c) => !['dark', 'light', 'gray', 'grey'].includes(c.toLowerCase())) ??
+        colors[2] ??
+        'orange';
+    const dc = darkColor.toLowerCase();
+    const lc = lightColor.toLowerCase();
+    const ac = accentColor.toLowerCase();
+    const lines = ['## Common Layout Patterns', ''];
+    lines.push('Copy-paste these patterns into `rawHtml`. Replace placeholder text with real content.');
+    lines.push('');
+    lines.push('### Centered Text Block');
+    lines.push('');
+    lines.push('```html');
+    lines.push('<div class="content-cols-grid">');
+    lines.push('  <div class="col-span-full laptop:col-start-2 laptop:col-span-10 space-y-6">');
+    lines.push('    <h2 class="h2">Section Heading</h2>');
+    lines.push('    <div class="rtf-standard">');
+    lines.push('      <p>Body copy goes here.</p>');
+    lines.push('    </div>');
+    lines.push('  </div>');
+    lines.push('</div>');
+    lines.push('```');
+    lines.push('');
+    lines.push('### Two-Column Layout (Text + Visual)');
+    lines.push('');
+    lines.push('```html');
+    lines.push('<div class="content-cols-grid gap-y-12">');
+    lines.push('  <div class="col-span-full laptop:col-start-2 laptop:col-span-4 flex flex-col gap-6">');
+    lines.push('    <h2 class="h2">Heading</h2>');
+    lines.push('    <p class="p1">Descriptive text alongside the visual.</p>');
+    lines.push('  </div>');
+    lines.push('  <div class="col-span-full laptop:col-start-7 laptop:col-span-5">');
+    lines.push('    <img src="..." alt="..." class="w-full rounded-lg" />');
+    lines.push('  </div>');
+    lines.push('</div>');
+    lines.push('```');
+    lines.push('');
+    lines.push('### Coloured Card');
+    lines.push('');
+    lines.push('```html');
+    lines.push('<div class="content-cols-grid">');
+    lines.push('  <div class="col-span-full laptop:col-start-2 laptop:col-span-10">');
+    lines.push(`    <div class="bg-${ac} text-${dc} p-8 laptop:p-12 rounded-lg flex flex-col gap-4">`);
+    lines.push('      <h3 class="h3">Card Title</h3>');
+    lines.push('      <p class="p2">Supporting description text.</p>');
+    lines.push('    </div>');
+    lines.push('  </div>');
+    lines.push('</div>');
+    lines.push('```');
+    lines.push('');
+    lines.push('### Card Grid');
+    lines.push('');
+    lines.push('```html');
+    lines.push('<div class="content-cols-grid gap-y-8">');
+    lines.push('  <!-- Header row -->');
+    lines.push('  <div class="col-span-full laptop:col-start-2 laptop:col-span-10">');
+    lines.push('    <h2 class="h2">Grid Title</h2>');
+    lines.push('  </div>');
+    lines.push('  <!-- Card grid -->');
+    lines.push('  <div class="col-span-full laptop:col-start-2 laptop:col-span-10');
+    lines.push('              grid grid-cols-1 tablet:grid-cols-2 laptop:grid-cols-3 gap-6">');
+    lines.push('    <div class="flex flex-col gap-4 p-6 border border-gray rounded-lg">');
+    lines.push('      <h3 class="h3">Card 1</h3>');
+    lines.push('      <p class="p2">Description.</p>');
+    lines.push('    </div>');
+    lines.push('    <!-- repeat for more cards -->');
+    lines.push('  </div>');
+    lines.push('</div>');
+    lines.push('```');
+    lines.push('');
+    lines.push('### Hero with Dark Background');
+    lines.push('');
+    lines.push('```html');
+    lines.push('<!-- Set isHero: true on this HtmlComponent entry -->');
+    lines.push(`<div class="bg-${dc} text-${lc} content-cols-grid py-16 laptop:py-32">`);
+    lines.push('  <div class="col-span-full laptop:col-start-2 laptop:col-span-10 flex flex-col gap-8">');
+    lines.push('    <h1 class="h1">Hero Heading</h1>');
+    lines.push('    <p class="p1 laptop:col-span-6">Subtitle or intro text.</p>');
+    lines.push('  </div>');
+    lines.push('</div>');
+    lines.push('```');
+    return lines.join('\n');
+}
+function buildHtmlComponentRules() {
+    return `## HtmlComponent Field Reference
+
+When authoring HTML for a \`HtmlComponent\` entry in Contentful, fill these fields:
+
+| Field | Required | Notes |
+|-------|----------|-------|
+| \`rawHtml\` | ✓ | The HTML markup. Use Tailwind classes; avoid inline \`style=\` attributes for layout/colour/typography. |
+| \`customCss\` | — | Scoped CSS only. Rules are automatically prefixed with \`[data-hc-id="<id>"]\` so they cannot leak. Use for complex interactions or pseudo-elements unavailable via Tailwind. |
+| \`customJs\` | — | JavaScript loaded via Next.js \`<Script>\`. Always test the \`scriptStrategy\` setting. |
+| \`markdownContent\` | — | Plain text summary of the component for site search indexing. Fill this to make the component searchable. |
+| \`isHero\` | — | Set \`true\` if the HTML contains an \`<h1>\`. Ensures this block appears first in the page content flow. |
+| \`fullWidth\` | — | Set \`true\` for edge-to-edge (full-bleed) layouts that break out of the column grid. |
+| \`excludeFromSearch\` | — | Set \`true\` to exclude from search indexing even if \`markdownContent\` is filled. |
+| \`scriptStrategy\` | — | \`afterInteractive\` (default, safe), \`lazyOnload\` (deferred), \`beforeInteractive\` (constrained). |
+
+### Authoring Rules
+
+1. **Classes, not inline styles.** Use Tailwind utility classes. Never write \`style="color: #FF5C00"\` — use \`class="text-orange"\` instead.
+2. **Respect the grid.** Wrap content in \`content-cols-grid\` and use column classes to align with surrounding sections.
+3. **Semantic HTML.** Use correct heading levels (\`<h1>\` only once per page, \`<h2>\` for section heads, \`<h3>\` for cards).
+4. **Accessible images.** Always include \`alt\` attributes. Decorative images use \`alt=""\`.
+5. **No custom font stacks.** Use \`font-sans\` or rely on typography classes. The project font is loaded by Next.js automatically.
+6. **Fill \`markdownContent\`** so site search can index the component's textual content.`;
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+function main() {
+    const appRoot = parseAppDir();
+    const appName = basename(appRoot);
+    console.log(`Generating HTML style guide for: ${appRoot}`);
+    // Load tailwind config
+    const config = loadTailwindConfig(appRoot);
+    if (!config) {
+        console.error(`ERROR: Could not load tailwind.config.json from ${appRoot}`);
+        console.error('  Run from or pass --app-dir pointing to an app directory.');
+        process.exit(1);
+    }
+    // Load globals.css
+    const globalsCssPath = join(appRoot, 'src/app/globals.css');
+    let globalsCss = '';
+    if (existsSync(globalsCssPath)) {
+        globalsCss = readFileSync(globalsCssPath, 'utf8');
+    }
+    else {
+        console.warn(`  WARNING: globals.css not found at ${globalsCssPath} — skipping CSS parsing`);
+    }
+    const utilities = extractUtilities(globalsCss);
+    const rtfClasses = extractRtfClasses(globalsCss);
+    const rootVars = extractRootVars(globalsCss);
+    console.log(`  Colours: ${Object.keys(config.colorOptions ?? {}).length}`);
+    console.log(`  Typography styles: ${Object.keys(config.fontTable?.styles ?? {}).length}`);
+    console.log(`  Utilities: ${utilities.length}`);
+    console.log(`  RTF classes: ${rtfClasses.length}`);
+    console.log(`  CSS variables: ${rootVars.length}`);
+    // Build sections
+    const now = new Date().toISOString().split('T')[0];
+    const sections = [
+        `# HTML Component Style Guide — ${appName}`,
+        '',
+        `> Auto-generated on ${now} from \`tailwind.config.json\` and \`src/app/globals.css\`.`,
+        '> Regenerate with: `pnpm cms-generate-html-style-guide`',
+        '',
+        'This guide defines every design token available for use in `HtmlComponent` `rawHtml` fields.',
+        'Read this before authoring any custom HTML for the site — it ensures visual consistency.',
+        '',
+        '---',
+        '',
+        buildHtmlComponentRules(),
+        '',
+        '---',
+        '',
+        buildBreakpointsSection(config),
+        '',
+        '---',
+        '',
+        buildColourSection(config),
+        '',
+        '---',
+        '',
+        buildTypographySection(config),
+        '',
+        '---',
+        '',
+        buildGridSection(config),
+        '',
+        '---',
+        '',
+        buildSpacingSection(),
+        '',
+        '---',
+        '',
+        buildFontsSection(config),
+        '',
+        '---',
+        '',
+        buildUtilitiesSection(utilities),
+        '',
+        '---',
+        '',
+        buildRtfSection(rtfClasses),
+        '',
+        '---',
+        '',
+        buildPatternsSection(config),
+    ];
+    // Include CSS variables if any interesting ones found
+    const interestingVars = rootVars.filter((v) => !v.name.startsWith('--color-') && !v.name.startsWith('--animate-'));
+    if (interestingVars.length > 0) {
+        sections.push('', '---', '', '## CSS Custom Properties', '');
+        sections.push('These tokens are available via `var(--name)` in `customCss` fields:');
+        sections.push('');
+        sections.push('| Variable | Default value |');
+        sections.push('|----------|---------------|');
+        for (const { name, value } of interestingVars) {
+            sections.push(`| \`${name}\` | \`${value}\` |`);
+        }
+    }
+    const output = sections.join('\n') + '\n';
+    // Write output
+    const outputDir = join(appRoot, 'docs/cms-guidelines');
+    mkdirSync(outputDir, { recursive: true });
+    const outputPath = join(outputDir, 'html-component-style-guide.md');
+    writeFileSync(outputPath, output);
+    console.log(`\nWrote ${outputPath}`);
+}
+main();
+//# sourceMappingURL=cms-generate-html-style-guide.js.map

package/dist/cms-generate-html-style-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-generate-html-style-guide.js","sourceRoot":"","sources":["../src/cms-generate-html-style-guide.ts"],"names":[],"mappings":";AACA,uFAAuF;AAEvF;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,SAAS,WAAW;IAClB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,OAAO,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,GAAG,GAAG,CAAC,CAAY,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;AACjF,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,OAAO,GAA0C,EAAE,CAAC;IAC1D,0EAA0E;IAC1E,MAAM,SAAS,GAAG,2BAA2B,CAAC;IAC9C,IAAI,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC;QAChC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,GAAG,KAAK,CAAC;QACd,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,KAAK,EAAE,CAAC;iBACvB,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,KAAK,EAAE,CAAC;YACjC,CAAC,EAAE,CAAC;QACN,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7B,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,KAAK,GAAG,iBAAiB,CAAC;IAChC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC,CAAC;QAC1B,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,OAAO,GAA2C,EAAE,CAAC;IAC3D,4BAA4B;IAC5B,MAAM,MAAM,GAAG,sBAAsB,CAAC;IACtC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAW,CAAC;QAC7B,MAAM,KAAK,GAAG,4BAA4B,CAAC;QAC3C,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAW,EAAE,EAAE,KAAK,EAAG,CAAC,CAAC,CAAC,CAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9E,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAQD,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,KAAsB,CAAC;QACjC,IAAI,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC,YAAY,CAAW,CAAC;IAC5E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,uBAAuB,CAAC,MAA8B;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,MAAM,KAAK,GAAa,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CACR,0HAA0H,CAC3H,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,8BAA8B,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACnF,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,IAAI,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;YAAE,SAAS;QAC9D,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,UAAU,QAAQ,CAAC,CAAC,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CAAC,MAA8B;IACxD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IACzC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IAEnD,MAAM,KAAK,GAAa,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CACR,8FAA8F,CAC/F,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAC;QAChG,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;QAC9F,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YACvD,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YAC7C,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,KAAK,CAAC,IAAI,CACR,OAAO,IAAI,MAAM,UAAU,QAAQ,GAAG,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,QAAQ,IAAI,CAC9G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACtD,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,KAAK,aAAa,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CACR,yFAAyF,CAC1F,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAE1F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,sBAAsB,CAAC,MAA8B;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAkC,CAAC;IAC5D,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,wEAAwE,CAAC;IAClF,CAAC;IAED,iFAAiF;IACjF,MAAM,aAAa,GAAG,MAAM,CAAC;IAC7B,MAAM,QAAQ,GAAG,SAAS,EAAE,IAAI,IAAI,YAAY,CAAC;IACjD,MAAM,UAAU,GAAG,SAAS,EAAE,MAAM,IAAI,GAAG,CAAC;IAE5C,MAAM,KAAK,GAAa,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,uBAAuB,UAAU,IAAI,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,6IAA6I,CAC9I,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,kCAAkC;IAClC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAChD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAC9E,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aACvB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACjD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,oBAAoB,CAAC,KAAe;QAC3C,MAAM,IAAI,GAAa;YACrB,iEAAiE;YACjE,iEAAiE;SAClE,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAkB,CAAC;YAC/C,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC5C,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,QAAQ,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3E,MAAM,UAAU,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;YAChC,MAAM,SAAS,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9E,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;YACnF,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAuC,CAAC;YACzE,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,UAAU,EAAE,CAAC,gBAAgB,CAAC,KAAK,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5E,IAAI,OAAO,CAAC,CAAC,eAAe,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;gBACpE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,IAAI,CACP,OAAO,IAAI,QAAQ,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,MAAM,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACpP,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IACrF,KAAK,CAAC,IAAI,CACR,iGAAiG,CAClG,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA8B;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,MAAM,KAAK,GAAa,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CACR,4GAA4G,CAC7G,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACzD,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACrD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,EAAE,OAAO,IAAI,MAAM,GAAG,MAAM,MAAM,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,oIAAoI,CACrI,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CACR,mGAAmG,CACpG,CAAC;IACF,KAAK,CAAC,IAAI,CACR,2FAA2F,CAC5F,CAAC;IACF,KAAK,CAAC,IAAI,CACR,8FAA8F,CAC/F,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC;IAClG,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CACR,0HAA0H,CAC3H,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,mBAAmB;IAC1B,MAAM,KAAK,GAAa,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;IACjG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,0KAA0K,CAC3K,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAgD;IAC7E,yEAAyE;IACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;QACvB,mBAAmB;QACnB,QAAQ;QACR,iBAAiB;QACjB,aAAa;QACb,cAAc;QACd,cAAc;QACd,gBAAgB;QAChB,gBAAgB;KACjB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,gEAAgE,CAAC;IAC1E,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAC1F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAEtC,MAAM,YAAY,GAA2B;QAC3C,gBAAgB,EAAE,uDAAuD;QACzE,sBAAsB,EAAE,8CAA8C;QACtE,qBAAqB,EAAE,yDAAyD;QAChF,qBAAqB,EAAE,oCAAoC;QAC3D,qBAAqB,EAAE,iDAAiD;QACxE,YAAY,EAAE,iEAAiE;QAC/E,iBAAiB,EAAE,qCAAqC;KACzD,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,8CAA8C,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,IAAI,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,UAAoB;IAC3C,MAAM,KAAK,GAAa,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CACR,2FAA2F,CAC5F,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,MAAM,eAAe,GAA2B;QAC9C,cAAc,EACZ,0IAA0I;QAC5I,aAAa,EACX,gHAAgH;QAClH,mBAAmB,EACjB,0HAA0H;QAC5H,WAAW,EACT,kJAAkJ;KACrJ,CAAC;IAEF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,GACR,eAAe,CAAC,GAAG,CAAC,IAAI,yDAAyD,CAAC;YACpF,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA8B;IACvD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAkC,CAAC;IAC5D,MAAM,QAAQ,GAAG,SAAS,EAAE,IAAI,CAAC;IAEjC,MAAM,KAAK,GAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,yBAAyB,QAAQ,2CAA2C,CAAC,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CACR,gJAAgJ,CACjJ,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,oBAAoB,CAAC,MAA8B;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACxF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAC3F,MAAM,WAAW,GACf,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,CAAC,CAAC;QACT,QAAQ,CAAC;IACX,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,EAAE,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,KAAK,GAAa,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CACR,uFAAuF,CACxF,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CACR,wFAAwF,CACzF,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;IACjF,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CACR,sBAAsB,EAAE,SAAS,EAAE,mDAAmD,CACvF,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;IAC3F,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IACtF,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,SAAS,EAAE,yCAAyC,CAAC,CAAC;IACrF,KAAK,CAAC,IAAI,CACR,yFAAyF,CAC1F,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAElB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;0FAsBiF,CAAC;AAC3F,CAAC;AAED,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,SAAS,IAAI;IACX,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAElC,OAAO,CAAC,GAAG,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;IAE3D,uBAAuB;IACvB,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,mDAAmD,OAAO,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,mBAAmB;IACnB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAC5D,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/B,UAAU,GAAG,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,uCAAuC,cAAc,yBAAyB,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAE7C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1F,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,kBAAkB,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,oBAAoB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAEnD,iBAAiB;IACjB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAW,CAAC;IAC7D,MAAM,QAAQ,GAAa;QACzB,kCAAkC,OAAO,EAAE;QAC3C,EAAE;QACF,uBAAuB,GAAG,6DAA6D;QACvF,yDAAyD;QACzD,EAAE;QACF,8FAA8F;QAC9F,0FAA0F;QAC1F,EAAE;QACF,KAAK;QACL,EAAE;QACF,uBAAuB,EAAE;QACzB,EAAE;QACF,KAAK;QACL,EAAE;QACF,uBAAuB,CAAC,MAAM,CAAC;QAC/B,EAAE;QACF,KAAK;QACL,EAAE;QACF,kBAAkB,CAAC,MAAM,CAAC;QAC1B,EAAE;QACF,KAAK;QACL,EAAE;QACF,sBAAsB,CAAC,MAAM,CAAC;QAC9B,EAAE;QACF,KAAK;QACL,EAAE;QACF,gBAAgB,CAAC,MAAM,CAAC;QACxB,EAAE;QACF,KAAK;QACL,EAAE;QACF,mBAAmB,EAAE;QACrB,EAAE;QACF,KAAK;QACL,EAAE;QACF,iBAAiB,CAAC,MAAM,CAAC;QACzB,EAAE;QACF,KAAK;QACL,EAAE;QACF,qBAAqB,CAAC,SAAS,CAAC;QAChC,EAAE;QACF,KAAK;QACL,EAAE;QACF,eAAe,CAAC,UAAU,CAAC;QAC3B,EAAE;QACF,KAAK;QACL,EAAE;QACF,oBAAoB,CAAC,MAAM,CAAC;KAC7B,CAAC;IAEF,sDAAsD;IACtD,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAC1E,CAAC;IACF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,0BAA0B,EAAE,EAAE,CAAC,CAAC;QAC7D,QAAQ,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QACrF,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9C,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,eAAe,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,UAAU,KAAK,MAAM,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE1C,eAAe;IACf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IACvD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC;IACpE,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAElC,OAAO,CAAC,GAAG,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/cms-merge-guidelines.js

@@ -17,7 +17,7 @@
  *   cms-merge-guidelines [--app-dir <path>] [--app-name <name>]
  */
 import { execSync } from 'node:child_process';
-import { readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { basename, extname, join } from 'node:path';
 // Parse CLI flags
 function parseCli() {
@@ -88,8 +88,15 @@ function main() {
     parts.push('');
     parts.push(`> Generated: ${generatedDate} | Commit: ${commitId}`);
     parts.push('');
-    parts.push('---');
-    parts.push('');
+    // HTML Component Style Guide preamble (if generated)
+    const htmlGuideFile = join(GUIDELINES_DIR, 'html-component-style-guide.md');
+    if (existsSync(htmlGuideFile)) {
+        const htmlGuideContent = readFileSync(htmlGuideFile, 'utf8').trim();
+        parts.push(htmlGuideContent);
+        parts.push('');
+        parts.push('---');
+        parts.push('');
+    }
     // Table of contents
     parts.push('## Table of Contents');
     parts.push('');

package/dist/cms-merge-guidelines.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/project-build",
-  "version": "1.0.117",
+  "version": "1.0.119",
   "description": "Build tools and management scripts for SE Studio projects",
   "repository": {
     "type": "git",
@@ -35,7 +35,8 @@
     "cms-merge-guidelines": "./dist/cms-merge-guidelines.js",
     "cms-capture-screenshots": "./dist/cms-capture-screenshots.js",
     "cms-update-colour-hints": "./dist/cms-update-colour-hints.js",
-    "cms-generate-collection-guidelines": "./dist/cms-generate-collection-guidelines.js"
+    "cms-generate-collection-guidelines": "./dist/cms-generate-collection-guidelines.js",
+    "cms-generate-html-style-guide": "./dist/cms-generate-html-style-guide.js"
   },
   "files": [
     "dist",
@@ -60,12 +61,12 @@
     "url": "https://github.com/Something-Else-Studio/se-core-product/issues"
   },
   "dependencies": {
-    "@biomejs/biome": "^2.4.9",
+    "@biomejs/biome": "^2.4.10",
     "@biomejs/js-api": "^4.0.0",
-    "@biomejs/wasm-nodejs": "^2.4.9",
+    "@biomejs/wasm-nodejs": "^2.4.10",
     "change-case": "^5.4.4",
     "chroma-js": "^3.2.0",
-    "contentful-management": "^12.0.0",
+    "contentful-management": "^12.2.0",
     "dotenv": "^17.3.1"
   },
   "devDependencies": {

package/skills/contentful-cms/cms-guidelines/README.md

@@ -75,13 +75,31 @@ cms-merge-guidelines --app-dir apps/example-om1
 
 | CLI | Purpose |
 |---|---|
+| `cms-generate-html-style-guide` | Generate `html-component-style-guide.md` from `tailwind.config.json` + `globals.css` |
 | `cms-generate-field-list` | Parse TypeScript types → `field-list.json` |
 | `cms-capture-screenshots` | Capture component screenshots for variant evaluation |
 | `cms-update-colour-hints` | Upsert a colour hint in `colour-hints.json` |
-| `cms-generate-collection-guidelines` | **New** — generate all collection/external `.md` files from a discovery URL |
+| `cms-generate-collection-guidelines` | Generate all collection/external `.md` files from a discovery URL |
 | `cms-merge-guidelines` | Merge all fragments → `COMPONENT_GUIDELINES_FOR_LLM.md` |
 
-All CLIs are provided by `@se-studio/contentful-cms`. Run `pnpm build` from the repo root to ensure they are built and linked.
+All CLIs are provided by `@se-studio/project-build`. Run `pnpm build` from the repo root to ensure they are built and linked.
+
+---
+
+## `cms-generate-html-style-guide`
+
+Generates `docs/cms-guidelines/html-component-style-guide.md` — a design system reference for any LLM or developer authoring HTML in `HtmlComponent` CMS entries.
+
+Does not require a running dev server. Reads only local files:
+- `tailwind.config.json` → colour palette, typography classes, grid configuration
+- `src/app/globals.css` → custom utilities, RTF class names, CSS custom properties
+
+```bash
+# From the app directory:
+pnpm cms-generate-html-style-guide
+```
+
+The output file is a **static fragment** — not generated by the LLM component pipeline. It is automatically included as a preamble in `COMPONENT_GUIDELINES_FOR_LLM.md` when `cms-merge-guidelines` runs. Regenerate it whenever the design system changes.
 
 ---
 
@@ -128,10 +146,11 @@ Outputs:
 ```
 <appDir>/
   docs/cms-guidelines/
+    html-component-style-guide.md     # design system reference (auto-generated; static fragment)
     components/          # one .md per componentType
     collections/         # one .md per collectionType
     externals/           # one .md per externalComponentType
-    COMPONENT_GUIDELINES_FOR_LLM.md   # merged document
+    COMPONENT_GUIDELINES_FOR_LLM.md   # merged document (includes style guide as preamble)
   generated/cms-discovery/
     field-list.json
     colour-hints.json

package/skills/contentful-cms/cms-guidelines/html-component-authoring.md

@@ -0,0 +1,259 @@
+---
+name: html-component-authoring
+description: Guidelines for authoring HTML content in HtmlComponent CMS entries. Covers how to use the project style guide, what classes to use, field semantics, and common layout patterns.
+license: Private
+metadata:
+  author: se-core-product
+  version: "1.0.0"
+---
+
+# HtmlComponent Authoring Guide
+
+`HtmlComponent` is a CMS content type that renders developer-authored HTML directly into the page. It bypasses the standard component registration system and is intended for one-off or highly custom layouts that the structured component library cannot produce.
+
+---
+
+## Before You Start
+
+**Read the project style guide.** Every app has an auto-generated HTML Component Style Guide at:
+
+```
+docs/cms-guidelines/html-component-style-guide.md
+```
+
+This file contains the exact colour names, typography class names, grid configuration, and custom utilities available for that specific project. It is derived from `tailwind.config.json` and `globals.css` — always consult it before writing any HTML.
+
+If the file does not exist, generate it first:
+
+```bash
+# From the app directory:
+pnpm cms-generate-html-style-guide
+```
+
+---
+
+## HtmlComponent Fields
+
+| Field | Required | Type | Purpose |
+|-------|----------|------|---------|
+| `rawHtml` | ✓ | Text | The HTML markup. Use Tailwind classes; never inline `style=` for colours/typography/layout. |
+| `customCss` | — | Text | Scoped CSS. Rules are automatically prefixed with `[data-hc-id="<id>"]` — they cannot pollute other components. |
+| `customJs` | — | Text | JavaScript loaded via Next.js `<Script>`. Use sparingly. |
+| `markdownContent` | — | Text | Plain text for search indexing. **Always fill this** so the component appears in site search. |
+| `isHero` | — | Boolean | `true` if the HTML contains an `<h1>`. Moves this block to the top of the page content flow. |
+| `fullWidth` | — | Boolean | `true` for edge-to-edge (full-bleed) layouts that break out of the column grid. |
+| `excludeFromSearch` | — | Boolean | `true` to exclude from search even if `markdownContent` is set. |
+| `loadScriptOnce` | — | Boolean | `true` (default) to deduplicate the script tag when the same entry appears multiple times. |
+| `scriptStrategy` | — | Enum | `afterInteractive` (default), `lazyOnload`, `beforeInteractive`. |
+
+---
+
+## The Four Non-Negotiable Rules
+
+1. **Use Tailwind classes, not inline styles.**
+   - ❌ `style="color: #FF5C00; font-size: 48px;"`
+   - ✓ `class="text-orange h2"`
+
+2. **Use named colour classes from the palette.**
+   - ❌ `class="bg-[#1F2E32]"` or `style="background: #1F2E32"`
+   - ✓ `class="bg-dark text-light"`
+
+3. **Use typography classes, not raw font sizes.**
+   - ❌ `class="text-[48px] font-semibold"`
+   - ✓ `class="h2"`
+
+4. **Respect the grid.** Wrap content in `content-cols-grid` and use `col-span-*` / `col-start-*` to align with other sections.
+
+---
+
+## Colour Usage
+
+All colour names are defined in the style guide. Use lowercase in Tailwind:
+
+```
+Dark    → bg-dark / text-dark / border-dark
+Light   → bg-light / text-light / border-light
+Orange  → bg-orange / text-orange
+Blue    → bg-blue / text-blue
+```
+
+For dark backgrounds, pair with the contrast colour (`bg-dark text-light`). Check the "Contrast pair" column in the style guide to know which pairings are approved.
+
+---
+
+## Typography Usage
+
+Pick from the named type styles in the style guide. Apply directly to the element:
+
+```html
+<h1 class="h1">Large display heading (uppercase, 96–200px)</h1>
+<h2 class="h2">Section heading (45–48px)</h2>
+<h3 class="h3">Sub-heading (21–44px, uppercase)</h3>
+<p class="p1">Large body (20–24px)</p>
+<p class="p2">Standard body (16px)</p>
+<p class="p3">Small body (13px)</p>
+```
+
+**For rich text blocks** (content rendered from Markdown or the CMS), wrap in an RTF class:
+
+```html
+<div class="rtf-standard">
+  <h2>Auto-styled heading</h2>
+  <p>Auto-styled paragraph with list and link support.</p>
+</div>
+```
+
+Available RTF classes: `rtf-standard`, `rtf-article`, `rtf-article-right`, `rtf-legal`.
+
+---
+
+## Grid & Layout
+
+HtmlComponent content lives inside the site's `Section` component, which provides the outer grid. To position content within the grid:
+
+```html
+<!-- Standard: wrap in content-cols-grid, span columns -->
+<div class="content-cols-grid">
+  <div class="col-span-full laptop:col-start-2 laptop:col-span-10">
+    <!-- content -->
+  </div>
+</div>
+```
+
+Common column spans (all on a 12-column laptop grid):
+
+| Use | Classes |
+|-----|---------|
+| Full width | `col-span-full` |
+| Centered (one column margin) | `laptop:col-start-2 laptop:col-span-10` |
+| Left half (text) | `laptop:col-start-2 laptop:col-span-4` |
+| Right half (visual) | `laptop:col-start-7 laptop:col-span-5` |
+
+For **full-bleed** content (background extends edge to edge), set `fullWidth: true` on the entry. The grid wrapper is removed and you control the full viewport width.
+
+---
+
+## Breakpoints
+
+All breakpoints are mobile-first. Use prefixes to override at larger sizes:
+
+| Prefix | Min-width |
+|--------|-----------|
+| *(none)* | 0px (mobile default) |
+| `tablet:` | 768px |
+| `laptop:` | 1024px |
+| `desktop:` | 1440px |
+
+```html
+<div class="flex flex-col laptop:flex-row gap-6">...</div>
+```
+
+---
+
+## Scoped CSS (`customCss`)
+
+Use `customCss` only for styles impossible with Tailwind (complex `:hover`, `::before`/`::after`, third-party widget overrides).
+
+Rules are automatically scoped to this entry's `data-hc-id` attribute — write selectors without the prefix:
+
+```css
+/* In customCss — this gets scoped to [data-hc-id="<id>"] automatically */
+.my-card:hover {
+  transform: translateY(-4px);
+  transition: transform 0.2s ease;
+}
+
+::before {
+  content: '';
+  display: block;
+}
+```
+
+Never redeclare colours or typography in `customCss` — those already exist as Tailwind classes.
+
+---
+
+## Common Patterns
+
+### Centered text block
+
+```html
+<div class="content-cols-grid">
+  <div class="col-span-full laptop:col-start-2 laptop:col-span-10 space-y-6">
+    <h2 class="h2">Section Heading</h2>
+    <div class="rtf-standard">
+      <p>Body copy goes here.</p>
+    </div>
+  </div>
+</div>
+```
+
+### Two-column (text + image)
+
+```html
+<div class="content-cols-grid gap-y-12">
+  <div class="col-span-full laptop:col-start-2 laptop:col-span-4 flex flex-col gap-6">
+    <h2 class="h2">Heading</h2>
+    <p class="p1">Supporting description.</p>
+  </div>
+  <div class="col-span-full laptop:col-start-7 laptop:col-span-5">
+    <img src="..." alt="..." class="w-full rounded-lg" />
+  </div>
+</div>
+```
+
+### Coloured card
+
+```html
+<div class="content-cols-grid">
+  <div class="col-span-full laptop:col-start-2 laptop:col-span-10">
+    <div class="bg-orange text-dark p-8 laptop:p-12 rounded-lg flex flex-col gap-4">
+      <h3 class="h3">Card Title</h3>
+      <p class="p2">Supporting text.</p>
+    </div>
+  </div>
+</div>
+```
+
+### Hero (set `isHero: true`)
+
+```html
+<!-- fullWidth: true → background goes edge-to-edge -->
+<div class="bg-dark text-light">
+  <div class="content-cols-grid py-16 laptop:py-32">
+    <div class="col-span-full laptop:col-start-2 laptop:col-span-10 flex flex-col gap-8">
+      <h1 class="h1">Hero Heading</h1>
+      <p class="p1 laptop:col-span-6">Subtitle or intro text.</p>
+    </div>
+  </div>
+</div>
+```
+
+---
+
+## Checklist Before Saving
+
+- [ ] `rawHtml` uses only Tailwind classes — no inline `style=` for colours/typography/layout
+- [ ] All colour references use named classes (`text-dark`, `bg-orange`), not hex values
+- [ ] Typography uses named classes (`h2`, `p1`), not raw `text-[Npx]`
+- [ ] Content is wrapped in `content-cols-grid` and positioned with `col-span-*` / `col-start-*`
+- [ ] `markdownContent` is filled with the plain-text equivalent for search indexing
+- [ ] `isHero: true` if the HTML contains an `<h1>`
+- [ ] `fullWidth: true` if the design needs an edge-to-edge background
+- [ ] Tested at mobile, tablet, and laptop breakpoints
+
+---
+
+## Generating and Updating the Style Guide
+
+The style guide is auto-generated and should be regenerated whenever the design system changes:
+
+```bash
+# From the app directory:
+pnpm cms-generate-html-style-guide
+
+# Then re-merge to include it in COMPONENT_GUIDELINES_FOR_LLM.md:
+pnpm cms-guidelines:merge
+```
+
+The style guide is also regenerated automatically as part of the `update-cms-guidelines` workflow (Step 3 in `fresh` mode, or any time you run a merge step).

package/skills/contentful-cms/update-cms-guidelines/SKILL.md

@@ -123,7 +123,20 @@ When complete, confirm:
 
 Backfill any registered types missing from the LLM draft using `showcase-examples.json` (see curate skill), and add minimal `accepted-variants` JSON for types with no variant file so screenshot capture can run.
 
-### Step 3 — Generate field list
+### Step 3 — Generate HTML Component Style Guide
+
+Generate the design system reference used when authoring `HtmlComponent` entries:
+
+```bash
+# From the app directory:
+pnpm run cms-generate-html-style-guide
+# or from repo root:
+pnpm --filter <appName> exec cms-generate-html-style-guide --app-dir .
+```
+
+Reads `tailwind.config.json` and `src/app/globals.css`; writes `docs/cms-guidelines/html-component-style-guide.md`. No dev server required. Safe to skip if the design system has not changed since the last run.
+
+### Step 4 — Generate field list
 
 ```bash
 # From the app directory:
@@ -134,12 +147,12 @@ pnpm --filter <appName> exec cms-generate-field-list --app-dir .
 
 Produces `generated/cms-discovery/field-list.json` (discovery API reads from this path). Some apps use `src/generated/` for showcase artifacts; see app docs.
 
-### Step 4 — Run generate-all-guidelines
+### Step 5 — Run generate-all-guidelines
 
 Read and follow the **generate-all-guidelines** skill:
 `.agents/skills/contentful-cms/generate-all-guidelines/SKILL.md`
 
-Skip its prerequisite check (you already verified everything through Step 3).
+Skip its prerequisite check (you already verified everything through Step 4).
 Run Phases 0–5 from that skill with **full regeneration rules**:
 
 - **Phase 0** — Discover types; **do not** skip components that already had old fragments (there should be none after clean slate).