@10up/block-renderer-prompt-generator 0.1.4

package/README.md

@@ -0,0 +1,334 @@
+# @10up/block-renderer-prompt-generator
+
+Generate AI system prompts with block documentation, design tokens, and patterns. These prompts guide AI assistants in generating valid WordPress block structures.
+
+## Installation
+
+```bash
+npm install @10up/block-renderer-prompt-generator
+# or
+pnpm add @10up/block-renderer-prompt-generator
+```
+
+## Overview
+
+This package generates comprehensive system prompts for AI assistants that include:
+
+1. **Block documentation** - Available blocks with their props and constraints
+2. **Design tokens** - Colors, typography, spacing from theme.json
+3. **Patterns** - Available block patterns that can be referenced
+4. **User preferences** - Style guide and preferred blocks
+5. **Format instructions** - How to structure the JSON output
+
+## Usage
+
+### Generate Complete System Prompt
+
+The main entry point - generates a full system prompt:
+
+```typescript
+import { generateSystemPrompt } from '@10up/block-renderer-prompt-generator';
+
+const prompt = generateSystemPrompt({
+  catalog: blockCatalog,
+  tokens: themeTokens,
+  patterns: patternRegistry,
+  preferences: userPreferences,
+  compact: false
+});
+
+// Use as system prompt for AI
+```
+
+### Generate Minimal Prompt
+
+For smaller context windows:
+
+```typescript
+import { generateMinimalPrompt } from '@10up/block-renderer-prompt-generator';
+
+const prompt = generateMinimalPrompt({
+  tokens: themeTokens,
+  patterns: patternRegistry,
+});
+```
+
+### Prompt Options
+
+```typescript
+interface GeneratePromptOptions {
+  /** Block catalog for documentation */
+  catalog?: BlockCatalog;
+  /** Theme tokens for color/typography docs */
+  tokens?: ThemeTokens;
+  /** Available patterns */
+  patterns?: PatternRegistry;
+  /** User preferences */
+  preferences?: BlockPreferencesConfig;
+  /** Use compact format for smaller context */
+  compact?: boolean;
+}
+```
+
+## Individual Generators
+
+### Block Documentation
+
+```typescript
+import {
+  generateBlocksPrompt,
+  generateBlockList,
+  generateBlockDocumentation,
+  generateNestingRulesPrompt,
+} from '@10up/block-renderer-prompt-generator';
+
+// Full block documentation
+const blocksDoc = generateBlocksPrompt(catalog);
+
+// Simple list of block names
+const blockList = generateBlockList(catalog);
+// 'core/paragraph, core/heading, core/group, ...'
+
+// Documentation for a single block
+const paragraphDoc = generateBlockDocumentation(paragraphDefinition);
+
+// Nesting rules documentation
+const nestingDoc = generateNestingRulesPrompt(catalog);
+```
+
+### Token Documentation
+
+```typescript
+import {
+  generateTokensPrompt,
+  generateColorsPrompt,
+  generateGradientsPrompt,
+  generateTypographyPrompt,
+  generateSpacingPrompt,
+  generateShadowsPrompt,
+  generateLayoutPrompt,
+} from '@10up/block-renderer-prompt-generator';
+
+// Complete token documentation
+const tokensDoc = generateTokensPrompt(tokens);
+
+// Individual token types
+const colorsDoc = generateColorsPrompt(tokens);
+const gradientsDoc = generateGradientsPrompt(tokens);
+const typographyDoc = generateTypographyPrompt(tokens);
+const spacingDoc = generateSpacingPrompt(tokens);
+const shadowsDoc = generateShadowsPrompt(tokens);
+const layoutDoc = generateLayoutPrompt(tokens);
+```
+
+### Pattern Documentation
+
+```typescript
+import {
+  generatePatternsPrompt,
+  generatePatternList,
+  generatePatternDocumentation,
+  generateCompactPatternList,
+} from '@10up/block-renderer-prompt-generator';
+
+// Full pattern documentation
+const patternsDoc = generatePatternsPrompt(patterns);
+
+// Simple list of pattern slugs
+const patternList = generatePatternList(patterns);
+// 'theme/hero-section, theme/feature-grid, ...'
+
+// Documentation for a single pattern
+const heroDoc = generatePatternDocumentation(heroPattern);
+
+// Compact list for smaller context
+const compactList = generateCompactPatternList(patterns);
+```
+
+### Section Styles Documentation
+
+```typescript
+import {
+  generateSectionStylesPrompt,
+  generateSectionStyleList,
+  generateSectionStyleDocumentation,
+  generateCompactSectionStyleList,
+} from '@10up/block-renderer-prompt-generator';
+
+// Full section styles documentation
+const stylesDoc = generateSectionStylesPrompt(sectionStyles);
+
+// Simple list of style names
+const styleList = generateSectionStyleList(sectionStyles);
+
+// Documentation for a single section style
+const heroStyleDoc = generateSectionStyleDocumentation('hero', heroStyle);
+
+// Compact list for smaller context
+const compactList = generateCompactSectionStyleList(sectionStyles);
+```
+
+### Ignite WP Documentation
+
+```typescript
+import {
+  generateIgnitePrompt,
+  generateCompactIgnitePrompt,
+} from '@10up/block-renderer-prompt-generator';
+
+// Full Ignite WP documentation (typography presets, fluid values)
+const igniteDoc = generateIgnitePrompt(igniteTokens);
+
+// Compact version for smaller context
+const compactIgniteDoc = generateCompactIgnitePrompt(igniteTokens);
+```
+
+### Critical Styling Rules
+
+```typescript
+import { generateCriticalStylingRules } from '@10up/block-renderer-prompt-generator';
+
+// Generate rules for consistent AI styling decisions
+const rules = generateCriticalStylingRules();
+// Returns markdown with best practices for block styling
+```
+
+## Generated Prompt Structure
+
+A complete generated prompt includes:
+
+```markdown
+# WordPress Block Generation
+
+You are generating WordPress blocks using a JSON format...
+
+## Block Tree Format
+
+The JSON structure you should generate...
+
+## Available Blocks
+
+### core/paragraph
+Text block with the following props:
+- content (string): The paragraph text
+- dropCap (boolean): Enable drop cap
+...
+
+### core/heading
+Heading block with levels 1-6...
+
+## Design Tokens
+
+### Colors
+Available colors: primary (#0073aa), secondary (#23282d), ...
+
+### Typography
+Font sizes: small (13px), medium (16px), large (20px), ...
+
+### Spacing
+Spacing scale: 20 (0.5rem), 30 (0.75rem), 40 (1rem), ...
+
+## Available Patterns
+
+### theme/hero-section
+A full-width hero with heading and CTA...
+
+### theme/feature-grid
+Three-column feature grid...
+
+## User Preferences
+
+### Preferred Blocks
+- core/group (for containers)
+- core/columns (for layouts)
+
+### Style Guide
+- Always use constrained layout for groups
+- Prefer semantic heading levels
+```
+
+## Compact Mode
+
+For AI models with smaller context windows, use compact mode:
+
+```typescript
+const prompt = generateSystemPrompt({
+  catalog,
+  tokens,
+  patterns,
+  compact: true  // Shorter, more concise output
+});
+```
+
+Compact mode:
+- Uses shorter descriptions
+- Omits detailed attribute documentation
+- Lists only essential tokens
+- Removes examples
+
+## Complete Exports
+
+### System Prompt
+
+| Function | Description |
+|----------|-------------|
+| `generateSystemPrompt(options)` | Generate complete system prompt |
+| `generateMinimalPrompt(options)` | Generate minimal prompt |
+| `generateCriticalStylingRules()` | Generate critical styling rules |
+
+### Block Documentation
+
+| Function | Description |
+|----------|-------------|
+| `generateBlocksPrompt(catalog)` | Full blocks documentation |
+| `generateBlockList(catalog)` | Simple comma-separated list |
+| `generateBlockDocumentation(definition)` | Single block documentation |
+| `generateNestingRulesPrompt(catalog)` | Nesting rules documentation |
+
+### Token Documentation
+
+| Function | Description |
+|----------|-------------|
+| `generateTokensPrompt(tokens, options?)` | Complete tokens documentation |
+| `generateColorsPrompt(tokens)` | Color tokens documentation |
+| `generateGradientsPrompt(tokens)` | Gradient tokens documentation |
+| `generateTypographyPrompt(tokens)` | Typography documentation |
+| `generateSpacingPrompt(tokens)` | Spacing tokens documentation |
+| `generateShadowsPrompt(tokens)` | Shadow tokens documentation |
+| `generateLayoutPrompt(tokens)` | Layout settings documentation |
+
+### Pattern Documentation
+
+| Function | Description |
+|----------|-------------|
+| `generatePatternsPrompt(patterns)` | Full patterns documentation |
+| `generatePatternList(patterns)` | Simple comma-separated list |
+| `generatePatternDocumentation(pattern)` | Single pattern documentation |
+| `generateCompactPatternList(patterns)` | Compact pattern list |
+
+### Section Styles Documentation
+
+| Function | Description |
+|----------|-------------|
+| `generateSectionStylesPrompt(styles)` | Full section styles documentation |
+| `generateSectionStyleList(styles)` | Simple list of style names |
+| `generateSectionStyleDocumentation(name, style)` | Single section style docs |
+| `generateCompactSectionStyleList(styles)` | Compact section style list |
+
+### Ignite WP Documentation
+
+| Function | Description |
+|----------|-------------|
+| `generateIgnitePrompt(tokens)` | Full Ignite WP documentation |
+| `generateCompactIgnitePrompt(tokens)` | Compact Ignite WP documentation |
+
+### Types
+
+| Type | Description |
+|------|-------------|
+| `GeneratePromptOptions` | Options for prompt generation |
+| `TokenPromptOptions` | Options for token prompt generation |
+
+## License
+
+MIT

package/dist/blocks-prompt.d.ts

@@ -0,0 +1,18 @@
+import type { BlockDefinition, BlockCatalog } from '@10up/block-renderer-core';
+/**
+ * Generates documentation for a single block.
+ */
+export declare function generateBlockDocumentation(definition: BlockDefinition): string;
+/**
+ * Generates a simple block list for prompts.
+ */
+export declare function generateBlockList(catalog: BlockCatalog): string;
+/**
+ * Generates full block documentation for prompts.
+ */
+export declare function generateBlocksPrompt(catalog: BlockCatalog): string;
+/**
+ * Generates nesting rules documentation.
+ */
+export declare function generateNestingRulesPrompt(catalog: BlockCatalog): string;
+//# sourceMappingURL=blocks-prompt.d.ts.map

package/dist/blocks-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks-prompt.d.ts","sourceRoot":"","sources":["../src/blocks-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE/E;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAkD9E;AAkBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAwB/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAuBlE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAkCxE"}

package/dist/blocks-prompt.js

@@ -0,0 +1,133 @@
+/**
+ * Generates documentation for a single block.
+ */
+export function generateBlockDocumentation(definition) {
+    const lines = [];
+    // Block name and title
+    lines.push(`### ${definition.name}`);
+    if (definition.title) {
+        lines.push(`**${definition.title}**`);
+    }
+    if (definition.description) {
+        lines.push(definition.description);
+    }
+    lines.push('');
+    // Supports InnerBlocks
+    if (definition.hasInnerBlocks) {
+        lines.push('**Supports children:** Yes');
+    }
+    // Parent constraints
+    if (definition.parent && definition.parent.length > 0) {
+        lines.push(`**Must be inside:** ${definition.parent.join(', ')}`);
+    }
+    // Ancestor constraints
+    if (definition.ancestor && definition.ancestor.length > 0) {
+        lines.push(`**Must have ancestor:** ${definition.ancestor.join(', ')}`);
+    }
+    // Allowed children
+    if (definition.allowedBlocks) {
+        if (definition.allowedBlocks === true) {
+            lines.push('**Can contain:** any block');
+        }
+        else if (definition.allowedBlocks.length > 0) {
+            lines.push(`**Can contain:** ${definition.allowedBlocks.join(', ')}`);
+        }
+    }
+    // Multiple constraint
+    if (definition.multiple === false) {
+        lines.push('**Note:** Can only appear once per post');
+    }
+    // Dynamic block
+    if (definition.isDynamic) {
+        lines.push('**Type:** Dynamic (server-rendered)');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Groups blocks by category.
+ */
+function groupByCategory(catalog) {
+    const groups = new Map();
+    for (const definition of catalog.values()) {
+        const category = definition.category || 'other';
+        const existing = groups.get(category) || [];
+        existing.push(definition);
+        groups.set(category, existing);
+    }
+    return groups;
+}
+/**
+ * Generates a simple block list for prompts.
+ */
+export function generateBlockList(catalog) {
+    const lines = ['## Available Blocks', ''];
+    const grouped = groupByCategory(catalog);
+    // Sort categories
+    const sortedCategories = Array.from(grouped.keys()).sort();
+    for (const category of sortedCategories) {
+        const blocks = grouped.get(category) || [];
+        // Format category name
+        const categoryName = category.charAt(0).toUpperCase() + category.slice(1);
+        lines.push(`### ${categoryName}`, '');
+        for (const block of blocks) {
+            const inner = block.hasInnerBlocks ? ' (supports children)' : '';
+            lines.push(`- \`${block.name}\`: ${block.title || block.name}${inner}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Generates full block documentation for prompts.
+ */
+export function generateBlocksPrompt(catalog) {
+    const lines = [
+        '## Available Blocks',
+        '',
+        'Use these blocks when generating content:',
+        '',
+    ];
+    const grouped = groupByCategory(catalog);
+    const sortedCategories = Array.from(grouped.keys()).sort();
+    for (const category of sortedCategories) {
+        const blocks = grouped.get(category) || [];
+        const categoryName = category.charAt(0).toUpperCase() + category.slice(1);
+        lines.push(`### ${categoryName}`, '');
+        for (const block of blocks) {
+            lines.push(generateBlockDocumentation(block));
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Generates nesting rules documentation.
+ */
+export function generateNestingRulesPrompt(catalog) {
+    const lines = [
+        '## Nesting Rules',
+        '',
+        'Some blocks have specific nesting requirements:',
+        '',
+    ];
+    for (const definition of catalog.values()) {
+        const hasConstraints = definition.parent?.length ||
+            definition.ancestor?.length ||
+            (definition.allowedBlocks && definition.allowedBlocks !== true);
+        if (!hasConstraints)
+            continue;
+        lines.push(`**${definition.name}**:`);
+        if (definition.parent?.length) {
+            lines.push(`  - Must be direct child of: ${definition.parent.join(', ')}`);
+        }
+        if (definition.ancestor?.length) {
+            lines.push(`  - Must be nested inside: ${definition.ancestor.join(', ')}`);
+        }
+        if (definition.allowedBlocks && definition.allowedBlocks !== true) {
+            lines.push(`  - Can only contain: ${definition.allowedBlocks.join(', ')}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=blocks-prompt.js.map

package/dist/blocks-prompt.js.map

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

package/dist/ignite-prompt.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Ignite WP Prompt Generator
+ *
+ * Generates AI-friendly documentation for Ignite WP features:
+ * - Color & Style Hierarchy
+ * - Section Styles with class names
+ * - Typography Presets with class names
+ * - Fluid Typography tokens
+ * - Fluid Spacing tokens
+ */
+import type { IgniteTokens, SectionStyle } from '@10up/block-renderer-theme-json';
+/**
+ * Generate the Ignite WP prompt section
+ *
+ * @param igniteTokens - Extracted Ignite tokens
+ * @param sectionStyles - Section styles from the theme (optional)
+ * @returns Markdown formatted prompt content
+ */
+export declare function generateIgnitePrompt(igniteTokens: IgniteTokens, sectionStyles?: SectionStyle[]): string;
+/**
+ * Generate a compact Ignite prompt (for reduced token usage)
+ */
+export declare function generateCompactIgnitePrompt(igniteTokens: IgniteTokens, sectionStyles?: SectionStyle[]): string;
+//# sourceMappingURL=ignite-prompt.d.ts.map

package/dist/ignite-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignite-prompt.d.ts","sourceRoot":"","sources":["../src/ignite-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACb,MAAM,iCAAiC,CAAC;AAEzC;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,aAAa,CAAC,EAAE,YAAY,EAAE,GAC7B,MAAM,CAwGR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,YAAY,EAC1B,aAAa,CAAC,EAAE,YAAY,EAAE,GAC7B,MAAM,CA6BR"}

package/dist/ignite-prompt.js

@@ -0,0 +1,143 @@
+/**
+ * Ignite WP Prompt Generator
+ *
+ * Generates AI-friendly documentation for Ignite WP features:
+ * - Color & Style Hierarchy
+ * - Section Styles with class names
+ * - Typography Presets with class names
+ * - Fluid Typography tokens
+ * - Fluid Spacing tokens
+ */
+/**
+ * Generate the Ignite WP prompt section
+ *
+ * @param igniteTokens - Extracted Ignite tokens
+ * @param sectionStyles - Section styles from the theme (optional)
+ * @returns Markdown formatted prompt content
+ */
+export function generateIgnitePrompt(igniteTokens, sectionStyles) {
+    const lines = ['## Ignite WP Extensions', ''];
+    // Color and Style Hierarchy (most important guidance)
+    lines.push('### Color & Style Hierarchy', '');
+    lines.push('**IMPORTANT:** Follow this priority order for styling:');
+    lines.push('');
+    lines.push('1. **Section Styles** (highest priority) - Use for container blocks (groups, columns)');
+    lines.push('   - Apply via `className: "is-style-{slug}"` on `core/group` or `core/columns`');
+    lines.push('   - Section styles automatically set text, background, link colors, and scoped CSS variables');
+    lines.push('   - Child elements inherit colors automatically');
+    lines.push('');
+    lines.push('2. **Semantic Color Variables** - Use for element colors that should inherit from context');
+    lines.push('   - `var(--wp--custom--color--text--primary)` - Main text color (inherits from section)');
+    lines.push('   - `var(--wp--custom--color--text--secondary)` - Secondary text');
+    lines.push('   - `var(--wp--custom--color--accent)` - Accent/link color');
+    lines.push('   - These adapt automatically when inside different section styles');
+    lines.push('');
+    lines.push('3. **Raw Colors** (avoid) - Break inheritance and should rarely be used');
+    lines.push('   - Only use when you need a specific color that should NOT change based on context');
+    lines.push('');
+    // Section Styles Summary
+    if (sectionStyles && sectionStyles.length > 0) {
+        lines.push('### Available Section Styles', '');
+        lines.push('| Style | Class | Background | Text |');
+        lines.push('|-------|-------|------------|------|');
+        for (const style of sectionStyles) {
+            const className = `is-style-${style.slug}`;
+            const bg = style.styles.global?.color?.background || '-';
+            const text = style.styles.global?.color?.text || '-';
+            lines.push(`| ${style.title} | \`${className}\` | ${bg} | ${text} |`);
+        }
+        lines.push('');
+        lines.push('**Usage Example:**');
+        lines.push('```json');
+        lines.push('{');
+        lines.push('  "key": "hero-section",');
+        lines.push('  "type": "core/group",');
+        lines.push('  "props": {');
+        lines.push('    "className": "is-style-surface-contrast",');
+        lines.push('    "layout": { "type": "constrained" }');
+        lines.push('  },');
+        lines.push('  "children": ["heading-1", "paragraph-1"]');
+        lines.push('}');
+        lines.push('```');
+        lines.push('');
+    }
+    // Typography Presets
+    if (igniteTokens.typographyPresets.length > 0) {
+        lines.push('### Typography Presets', '');
+        lines.push('**IMPORTANT:** Always prefer typography presets over using font size tokens directly.');
+        lines.push('Apply presets using BOTH the `typographyPreset` attribute AND the `className`.');
+        lines.push('');
+        lines.push('| Preset | Slug | Class Name | Font Size | Weight |');
+        lines.push('|--------|------|------------|-----------|--------|');
+        for (const preset of igniteTokens.typographyPresets) {
+            lines.push(`| ${preset.name} | \`${preset.slug}\` | \`is-typography-preset-${preset.slug}\` | ${preset.fontSize} | ${preset.fontWeight || '-'} |`);
+        }
+        lines.push('');
+        lines.push('**Usage Example:**');
+        lines.push('```json');
+        lines.push('{');
+        lines.push('  "key": "heading-1",');
+        lines.push('  "type": "core/heading",');
+        lines.push('  "props": {');
+        lines.push('    "content": "Welcome",');
+        lines.push('    "level": 1,');
+        lines.push('    "typographyPreset": "display-lg",');
+        lines.push('    "className": "is-typography-preset-display-lg"');
+        lines.push('  }');
+        lines.push('}');
+        lines.push('```');
+        lines.push('');
+    }
+    // Fluid Typography
+    if (Object.keys(igniteTokens.fluidTypography).length > 0) {
+        lines.push('### Fluid Typography Tokens', '');
+        lines.push('These custom properties use `clamp()` for responsive sizing.');
+        lines.push('');
+        lines.push('**Note:** Prefer typography presets over these tokens when possible.');
+        lines.push('');
+        for (const [path, value] of Object.entries(igniteTokens.fluidTypography)) {
+            const varName = `--wp--custom--${path.replace(/\./g, '--')}`;
+            lines.push(`- \`${varName}\`: min=${value.min}, max=${value.max}`);
+        }
+        lines.push('');
+    }
+    // Fluid Spacing
+    if (Object.keys(igniteTokens.fluidSpacing).length > 0) {
+        lines.push('### Fluid Spacing Tokens', '');
+        lines.push('These custom properties use `clamp()` for responsive spacing:');
+        lines.push('');
+        for (const [path, value] of Object.entries(igniteTokens.fluidSpacing)) {
+            const varName = `--wp--custom--${path.replace(/\./g, '--')}`;
+            lines.push(`- \`${varName}\`: min=${value.min}, max=${value.max}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate a compact Ignite prompt (for reduced token usage)
+ */
+export function generateCompactIgnitePrompt(igniteTokens, sectionStyles) {
+    const lines = ['## Ignite WP', ''];
+    // Compact hierarchy guidance
+    lines.push('**Style Priority:** Section Styles > Semantic Colors > Raw Colors');
+    lines.push('');
+    // Section Styles (compact)
+    if (sectionStyles && sectionStyles.length > 0) {
+        lines.push('**Section Styles:** ' + sectionStyles.map(s => `\`is-style-${s.slug}\``).join(', '));
+        lines.push('');
+    }
+    // Typography Presets (compact)
+    if (igniteTokens.typographyPresets.length > 0) {
+        lines.push('**Typography Presets:** Prefer over font-size tokens. Use BOTH `typographyPreset` attribute AND `className: "is-typography-preset-{slug}"`.');
+        lines.push(igniteTokens.typographyPresets.map(p => `\`${p.slug}\``).join(', '));
+        lines.push('');
+    }
+    // Fluid Typography (compact)
+    if (Object.keys(igniteTokens.fluidTypography).length > 0) {
+        lines.push('**Fluid Typography:** ' + Object.keys(igniteTokens.fluidTypography).map(path => `\`--wp--custom--${path.replace(/\./g, '--')}\``).join(', '));
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=ignite-prompt.js.map

package/dist/ignite-prompt.js.map

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