@10up/block-renderer-preferences 0.1.4

package/README.md

@@ -0,0 +1,328 @@
+# @10up/block-renderer-preferences
+
+Load and manage user preferences for AI block generation. Preferences guide AI assistants on preferred blocks, styles, and patterns.
+
+## Installation
+
+```bash
+npm install @10up/block-renderer-preferences
+# or
+pnpm add @10up/block-renderer-preferences
+```
+
+## Overview
+
+This package:
+
+1. **Loads preferences** - From `block-preferences.json` or `.blockrc.json`
+2. **Validates with Zod** - Ensures preference files are correctly formatted
+3. **Formats for AI prompts** - Converts preferences to AI-friendly text
+4. **Provides defaults** - Sensible defaults when no file exists
+
+## Usage
+
+### Load Preferences
+
+Automatically find and load preferences from a directory:
+
+```typescript
+import { loadPreferences } from '@10up/block-renderer-preferences';
+
+const prefs = loadPreferences('/path/to/project');
+// Searches for:
+// - /path/to/project/block-preferences.json
+// - /path/to/project/.blockrc.json
+// - /path/to/project/.block-renderer/preferences.json
+
+if (prefs) {
+  console.log(prefs.preferredBlocks);
+  console.log(prefs.avoidBlocks);
+  console.log(prefs.styleGuide);
+}
+```
+
+### Load from Specific File
+
+```typescript
+import { loadPreferencesFromFile } from '@10up/block-renderer-preferences';
+
+const prefs = loadPreferencesFromFile('/path/to/custom-prefs.json');
+```
+
+### Find Preferences File
+
+```typescript
+import { findPreferencesFile } from '@10up/block-renderer-preferences';
+
+const filePath = findPreferencesFile('/path/to/project');
+// Returns path to preferences file or null if not found
+```
+
+### Create Default Preferences
+
+```typescript
+import { createDefaultPreferences } from '@10up/block-renderer-preferences';
+
+const defaults = createDefaultPreferences();
+// Returns sensible default configuration
+```
+
+### Merge Preferences
+
+Combine multiple preference sources:
+
+```typescript
+import { mergePreferences, createDefaultPreferences } from '@10up/block-renderer-preferences';
+
+const defaults = createDefaultPreferences();
+const userPrefs = loadPreferencesFromFile('/path/to/prefs.json');
+const merged = mergePreferences(defaults, userPrefs);
+```
+
+### Format for AI Prompts
+
+```typescript
+import { formatPreferencesForPrompt } from '@10up/block-renderer-preferences';
+
+const promptSection = formatPreferencesForPrompt(prefs);
+// Returns formatted markdown for AI system prompt
+```
+
+## Preferences Schema
+
+### BlockPreferencesConfig
+
+The main configuration object:
+
+```typescript
+interface BlockPreferencesConfig {
+  // Block preferences
+  blocks?: BlocksPreferences;
+
+  // Layout preferences
+  layout?: LayoutPreferences;
+
+  // Typography preferences
+  typography?: TypographyPreferences;
+
+  // Color preferences
+  colors?: ColorPreferences;
+
+  // Spacing preferences
+  spacing?: SpacingPreferences;
+
+  // Image preferences
+  images?: ImagePreferences;
+
+  // Style guide
+  styleGuide?: StyleGuide;
+
+  // Brand guidelines
+  brand?: BrandGuideline;
+}
+```
+
+### BlocksPreferences
+
+```typescript
+interface BlocksPreferences {
+  /** Blocks to prefer when multiple options exist */
+  preferred?: string[];
+  /** Blocks to avoid using */
+  avoid?: string[];
+  /** Default block for text content */
+  defaultText?: string;
+  /** Default container block */
+  defaultContainer?: string;
+}
+```
+
+### LayoutPreferences
+
+```typescript
+interface LayoutPreferences {
+  /** Default layout type for groups */
+  defaultType?: 'constrained' | 'flex' | 'flow' | 'grid';
+  /** Maximum content width */
+  maxWidth?: string;
+  /** Default alignment */
+  defaultAlign?: 'left' | 'center' | 'right' | 'wide' | 'full';
+}
+```
+
+### TypographyPreferences
+
+```typescript
+interface TypographyPreferences {
+  /** Use semantic heading levels */
+  useSemanticHeadings?: boolean;
+  /** Maximum heading level to use */
+  maxHeadingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+  /** Default font size */
+  defaultFontSize?: string;
+}
+```
+
+### ColorPreferences
+
+```typescript
+interface ColorPreferences {
+  /** Preferred color tokens to use */
+  preferred?: string[];
+  /** Colors to avoid */
+  avoid?: string[];
+  /** Default background color */
+  defaultBackground?: string;
+  /** Default text color */
+  defaultText?: string;
+}
+```
+
+### SpacingPreferences
+
+```typescript
+interface SpacingPreferences {
+  /** Default spacing token */
+  default?: string;
+  /** Preferred spacing scale */
+  scale?: string[];
+}
+```
+
+### ImagePreferences
+
+```typescript
+interface ImagePreferences {
+  /** Preferred image sizes */
+  preferredSizes?: string[];
+  /** Default aspect ratio */
+  defaultAspectRatio?: string;
+  /** Always include alt text */
+  requireAlt?: boolean;
+}
+```
+
+### StyleGuide
+
+```typescript
+interface StyleGuide {
+  /** Custom style rules */
+  rules?: string[];
+  /** Preferred patterns by category */
+  patternsByCategory?: Record<string, string[]>;
+  /** Patterns to avoid */
+  avoidPatterns?: string[];
+}
+```
+
+### BrandGuideline
+
+```typescript
+interface BrandGuideline {
+  /** Brand name */
+  name?: string;
+  /** Brand description */
+  description?: string;
+  /** Voice and tone guidelines */
+  voiceTone?: string[];
+}
+```
+
+## Example Configuration
+
+```json
+{
+  "blocks": {
+    "preferred": ["core/group", "core/columns"],
+    "avoid": ["core/freeform", "core/html"],
+    "defaultText": "core/paragraph",
+    "defaultContainer": "core/group"
+  },
+  "layout": {
+    "defaultType": "constrained",
+    "defaultAlign": "wide"
+  },
+  "typography": {
+    "useSemanticHeadings": true,
+    "maxHeadingLevel": 4
+  },
+  "colors": {
+    "preferred": ["primary", "secondary", "base", "contrast"],
+    "avoid": ["error", "warning"]
+  },
+  "spacing": {
+    "default": "50",
+    "scale": ["30", "40", "50", "60", "70"]
+  },
+  "images": {
+    "preferredSizes": ["large", "full"],
+    "requireAlt": true
+  },
+  "styleGuide": {
+    "rules": [
+      "Always use constrained layout for content groups",
+      "Prefer flex layout for button containers",
+      "Use consistent spacing throughout sections"
+    ],
+    "patternsByCategory": {
+      "hero": ["theme/hero-centered", "theme/hero-split"]
+    },
+    "avoidPatterns": ["theme/deprecated-banner"]
+  },
+  "brand": {
+    "name": "Acme Corp",
+    "voiceTone": [
+      "Professional but approachable",
+      "Clear and concise",
+      "Helpful and supportive"
+    ]
+  }
+}
+```
+
+## Complete Exports
+
+### Functions
+
+| Function | Description |
+|----------|-------------|
+| `loadPreferences(directory)` | Auto-detect and load preferences |
+| `loadPreferencesFromFile(filePath)` | Load from specific file |
+| `findPreferencesFile(directory)` | Find preferences file path |
+| `createDefaultPreferences()` | Create default configuration |
+| `mergePreferences(base, override)` | Merge preference objects |
+| `formatPreferencesForPrompt(prefs)` | Format for AI prompt |
+
+### Types
+
+| Type | Description |
+|------|-------------|
+| `BlockPreferencesConfig` | Main configuration type |
+| `BlocksPreferences` | Block selection preferences |
+| `LayoutPreferences` | Layout preferences |
+| `TypographyPreferences` | Typography preferences |
+| `ColorPreferences` | Color preferences |
+| `SpacingPreferences` | Spacing preferences |
+| `ImagePreferences` | Image preferences |
+| `StyleGuide` | Style guide rules |
+| `BrandGuideline` | Brand guidelines |
+| `Preferences` | Alias for BlockPreferencesConfig |
+
+### Zod Schemas
+
+| Schema | Description |
+|--------|-------------|
+| `blockPreferencesConfigSchema` | Main config schema |
+| `blockPreferencesSchema` | Block preferences schema |
+| `layoutPreferencesSchema` | Layout preferences schema |
+| `typographyPreferencesSchema` | Typography preferences schema |
+| `colorPreferencesSchema` | Color preferences schema |
+| `spacingPreferencesSchema` | Spacing preferences schema |
+| `imagePreferencesSchema` | Image preferences schema |
+| `styleGuideSchema` | Style guide schema |
+| `brandGuidelineSchema` | Brand guideline schema |
+| `preferencesSchema` | Alias for main schema |
+
+## License
+
+MIT

package/dist/formatter.d.ts

@@ -0,0 +1,6 @@
+import type { BlockPreferencesConfig } from './schema.js';
+/**
+ * Formats preferences as a markdown string for AI prompts.
+ */
+export declare function formatPreferencesForPrompt(config: BlockPreferencesConfig): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAwBjF"}

package/dist/formatter.js

@@ -0,0 +1,141 @@
+/**
+ * Formats preferences as a markdown string for AI prompts.
+ */
+export function formatPreferencesForPrompt(config) {
+    const sections = [];
+    // Format main preferences
+    if (config.preferences) {
+        sections.push(formatMainPreferences(config.preferences));
+    }
+    // Format style guide rules
+    if (config.styleGuide?.rules && config.styleGuide.rules.length > 0) {
+        sections.push(formatStyleGuideRules(config.styleGuide.rules));
+    }
+    // Format style guide examples
+    if (config.styleGuide?.examples && Object.keys(config.styleGuide.examples).length > 0) {
+        sections.push(formatStyleGuideExamples(config.styleGuide.examples));
+    }
+    // Format brand guidelines
+    if (config.brandGuidelines && Object.keys(config.brandGuidelines).length > 0) {
+        sections.push(formatBrandGuidelines(config.brandGuidelines));
+    }
+    return sections.filter(s => s.length > 0).join('\n\n');
+}
+/**
+ * Formats main preferences section.
+ */
+function formatMainPreferences(preferences) {
+    const lines = ['## User Preferences'];
+    // Layout preferences
+    if (preferences.layout) {
+        lines.push('\n**Layout:**');
+        if (preferences.layout.preferGrid !== undefined) {
+            lines.push(`- ${preferences.layout.preferGrid ? 'Prefer' : 'Avoid'} CSS Grid layouts`);
+        }
+        if (preferences.layout.defaultContainerBlock) {
+            lines.push(`- Default container: ${preferences.layout.defaultContainerBlock}`);
+        }
+        if (preferences.layout.defaultAlignment) {
+            lines.push(`- Default alignment: ${preferences.layout.defaultAlignment}`);
+        }
+        if (preferences.layout.preferConstrained !== undefined) {
+            lines.push(`- ${preferences.layout.preferConstrained ? 'Use' : 'Avoid'} constrained layout`);
+        }
+    }
+    // Block preferences
+    if (preferences.blocks) {
+        lines.push('\n**Blocks:**');
+        if (preferences.blocks.preferButtonsOverLinks !== undefined) {
+            lines.push(`- ${preferences.blocks.preferButtonsOverLinks ? 'Prefer' : 'Avoid'} buttons over links for CTAs`);
+        }
+        if (preferences.blocks.preferPatternWhenAvailable !== undefined) {
+            lines.push(`- ${preferences.blocks.preferPatternWhenAvailable ? 'Use' : "Don't use"} patterns when available`);
+        }
+        if (preferences.blocks.avoidBlocks && preferences.blocks.avoidBlocks.length > 0) {
+            lines.push(`- Avoid: ${preferences.blocks.avoidBlocks.join(', ')}`);
+        }
+        if (preferences.blocks.preferBlocks) {
+            for (const [use, block] of Object.entries(preferences.blocks.preferBlocks)) {
+                lines.push(`- For ${use}: use ${block}`);
+            }
+        }
+    }
+    // Typography preferences
+    if (preferences.typography) {
+        lines.push('\n**Typography:**');
+        if (preferences.typography.defaultHeadingLevel !== undefined) {
+            lines.push(`- Default heading level: h${preferences.typography.defaultHeadingLevel}`);
+        }
+        if (preferences.typography.preferredFontSizes && preferences.typography.preferredFontSizes.length > 0) {
+            lines.push(`- Preferred font sizes: ${preferences.typography.preferredFontSizes.join(', ')}`);
+        }
+        if (preferences.typography.useDropCap !== undefined) {
+            lines.push(`- Drop cap: ${preferences.typography.useDropCap ? 'enabled' : 'disabled'}`);
+        }
+    }
+    // Color preferences
+    if (preferences.colors) {
+        lines.push('\n**Colors:**');
+        if (preferences.colors.preferPresetColors !== undefined) {
+            lines.push(`- ${preferences.colors.preferPresetColors ? 'Use' : 'Allow custom'} preset colors`);
+        }
+        if (preferences.colors.defaultBackgroundColor) {
+            lines.push(`- Default background: ${preferences.colors.defaultBackgroundColor}`);
+        }
+        if (preferences.colors.defaultTextColor) {
+            lines.push(`- Default text color: ${preferences.colors.defaultTextColor}`);
+        }
+    }
+    // Spacing preferences
+    if (preferences.spacing) {
+        lines.push('\n**Spacing:**');
+        if (preferences.spacing.defaultBlockGap) {
+            lines.push(`- Default block gap: ${preferences.spacing.defaultBlockGap}`);
+        }
+        if (preferences.spacing.preferMarginOverPadding !== undefined) {
+            lines.push(`- Prefer ${preferences.spacing.preferMarginOverPadding ? 'margin' : 'padding'}`);
+        }
+    }
+    // Image preferences
+    if (preferences.images) {
+        lines.push('\n**Images:**');
+        if (preferences.images.defaultSizeSlug) {
+            lines.push(`- Default size: ${preferences.images.defaultSizeSlug}`);
+        }
+        if (preferences.images.preferFigureCaption !== undefined) {
+            lines.push(`- Figure caption: ${preferences.images.preferFigureCaption ? 'include' : 'optional'}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Formats style guide rules section.
+ */
+function formatStyleGuideRules(rules) {
+    const lines = ['## Style Guide Rules', ''];
+    for (const rule of rules) {
+        lines.push(`- ${rule}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Formats style guide examples section.
+ */
+function formatStyleGuideExamples(examples) {
+    const lines = ['## Design Examples', ''];
+    for (const [name, description] of Object.entries(examples)) {
+        lines.push(`- **${name}**: ${description}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Formats brand guidelines section.
+ */
+function formatBrandGuidelines(guidelines) {
+    const lines = ['## Brand Guidelines', '', 'When creating these elements, use these configurations:'];
+    for (const [name, config] of Object.entries(guidelines)) {
+        lines.push(`- **${name}**: ${config.block} with ${JSON.stringify(config.props)}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { layoutPreferencesSchema, blockPreferencesSchema, typographyPreferencesSchema, colorPreferencesSchema, spacingPreferencesSchema, imagePreferencesSchema, preferencesSchema, styleGuideSchema, brandGuidelineSchema, blockPreferencesConfigSchema, } from './schema.js';
+export type { LayoutPreferences, BlocksPreferences, TypographyPreferences, ColorPreferences, SpacingPreferences, ImagePreferences, Preferences, StyleGuide, BrandGuideline, BlockPreferencesConfig, } from './schema.js';
+export { findPreferencesFile, loadPreferencesFromFile, loadPreferences, mergePreferences, createDefaultPreferences, } from './loader.js';
+export { formatPreferencesForPrompt, } from './formatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACd,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Schema and types
+export { layoutPreferencesSchema, blockPreferencesSchema, typographyPreferencesSchema, colorPreferencesSchema, spacingPreferencesSchema, imagePreferencesSchema, preferencesSchema, styleGuideSchema, brandGuidelineSchema, blockPreferencesConfigSchema, } from './schema.js';
+// Loader
+export { findPreferencesFile, loadPreferencesFromFile, loadPreferences, mergePreferences, createDefaultPreferences, } from './loader.js';
+// Formatter
+export { formatPreferencesForPrompt, } from './formatter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAerB,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,YAAY;AACZ,OAAO,EACL,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,23 @@
+import { type BlockPreferencesConfig } from './schema.js';
+/**
+ * Finds a preferences file in the given directory.
+ */
+export declare function findPreferencesFile(directory: string): string | null;
+/**
+ * Loads preferences from a specific file path.
+ */
+export declare function loadPreferencesFromFile(filePath: string): BlockPreferencesConfig;
+/**
+ * Loads preferences from a directory (auto-discovers file).
+ */
+export declare function loadPreferences(directory: string): BlockPreferencesConfig | null;
+/**
+ * Merges multiple preference configs together.
+ * Later configs override earlier ones.
+ */
+export declare function mergePreferences(...configs: (BlockPreferencesConfig | null | undefined)[]): BlockPreferencesConfig;
+/**
+ * Creates a default preferences config.
+ */
+export declare function createDefaultPreferences(): BlockPreferencesConfig;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAWxF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAehF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAQhF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,OAAO,EAAE,CAAC,sBAAsB,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GACxD,sBAAsB,CAsCxB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,sBAAsB,CAsBjE"}

package/dist/loader.js

@@ -0,0 +1,113 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { blockPreferencesConfigSchema } from './schema.js';
+/**
+ * Known preference file names
+ */
+const PREFERENCE_FILE_NAMES = [
+    'block-preferences.json',
+    '.blockrc.json',
+    '.blockrc',
+];
+/**
+ * Finds a preferences file in the given directory.
+ */
+export function findPreferencesFile(directory) {
+    for (const fileName of PREFERENCE_FILE_NAMES) {
+        const filePath = path.join(directory, fileName);
+        if (fs.existsSync(filePath)) {
+            return filePath;
+        }
+    }
+    return null;
+}
+/**
+ * Loads preferences from a specific file path.
+ */
+export function loadPreferencesFromFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const data = JSON.parse(content);
+    // Validate against schema
+    const result = blockPreferencesConfigSchema.safeParse(data);
+    if (!result.success) {
+        const errors = result.error.issues.map(issue => `${issue.path.join('.')}: ${issue.message}`);
+        throw new Error(`Invalid preferences file: ${errors.join(', ')}`);
+    }
+    return result.data;
+}
+/**
+ * Loads preferences from a directory (auto-discovers file).
+ */
+export function loadPreferences(directory) {
+    const filePath = findPreferencesFile(directory);
+    if (!filePath) {
+        return null;
+    }
+    return loadPreferencesFromFile(filePath);
+}
+/**
+ * Merges multiple preference configs together.
+ * Later configs override earlier ones.
+ */
+export function mergePreferences(...configs) {
+    const result = {};
+    for (const config of configs) {
+        if (!config)
+            continue;
+        // Merge preferences
+        if (config.preferences) {
+            result.preferences = {
+                ...result.preferences,
+                ...config.preferences,
+            };
+        }
+        // Merge style guide
+        if (config.styleGuide) {
+            result.styleGuide = {
+                rules: [
+                    ...(result.styleGuide?.rules || []),
+                    ...(config.styleGuide.rules || []),
+                ],
+                examples: {
+                    ...result.styleGuide?.examples,
+                    ...config.styleGuide.examples,
+                },
+            };
+        }
+        // Merge brand guidelines
+        if (config.brandGuidelines) {
+            result.brandGuidelines = {
+                ...result.brandGuidelines,
+                ...config.brandGuidelines,
+            };
+        }
+    }
+    return result;
+}
+/**
+ * Creates a default preferences config.
+ */
+export function createDefaultPreferences() {
+    return {
+        preferences: {
+            layout: {
+                defaultContainerBlock: 'core/group',
+                defaultAlignment: 'none',
+                preferConstrained: true,
+            },
+            blocks: {
+                preferColumnsOverGrid: true,
+                preferButtonsOverLinks: true,
+                avoidBlocks: ['core/freeform', 'core/html'],
+            },
+            typography: {
+                defaultHeadingLevel: 2,
+                useDropCap: false,
+            },
+            colors: {
+                preferPresetColors: true,
+            },
+        },
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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