coretik-block-generator-mcp 1.0.0

package/dist/schemas/learned-conventions.js

@@ -0,0 +1,47 @@
+/**
+ * Schema for learned conventions stored in .coretik-conventions.json
+ */
+export function createEmptyConventions() {
+    return {
+        version: 1,
+        learnedAt: new Date().toISOString(),
+        blockCount: 0,
+        php: {
+            imports: [],
+            traits: [],
+            interfaces: [],
+            baseClasses: {},
+            propertyVisibility: 'protected',
+            useSettingsPattern: true,
+            extraMethods: [],
+        },
+        template: {
+            wrapperTag: 'div',
+            wrapperAttributes: [],
+            escapingFunctions: {},
+            emptyCheckStyle: '!empty',
+            imageRenderFunction: 'wp_get_attachment_image',
+            htmlSnippets: [],
+        },
+        scss: {
+            methodology: 'BEM',
+            containerLayout: 'flex',
+            spacingVariables: [],
+            colorVariables: [],
+            breakpoints: [],
+        },
+        naming: {
+            blockNamePrefix: {},
+            classNameSuffix: {},
+            bemSuffix: {},
+            templateSubDir: {},
+        },
+        fields: {
+            commonFieldPatterns: [],
+            imageReturnFormat: 'id',
+            linkReturnFormat: 'array',
+        },
+        generations: {},
+    };
+}
+//# sourceMappingURL=learned-conventions.js.map

package/dist/schemas/learned-conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learned-conventions.js","sourceRoot":"","sources":["../../src/schemas/learned-conventions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyDH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,CAAC;QACb,GAAG,EAAE;YACH,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,EAAE;YACf,kBAAkB,EAAE,WAAW;YAC/B,kBAAkB,EAAE,IAAI;YACxB,YAAY,EAAE,EAAE;SACjB;QACD,QAAQ,EAAE;YACR,UAAU,EAAE,KAAK;YACjB,iBAAiB,EAAE,EAAE;YACrB,iBAAiB,EAAE,EAAE;YACrB,eAAe,EAAE,QAAQ;YACzB,mBAAmB,EAAE,yBAAyB;YAC9C,YAAY,EAAE,EAAE;SACjB;QACD,IAAI,EAAE;YACJ,WAAW,EAAE,KAAK;YAClB,eAAe,EAAE,MAAM;YACvB,gBAAgB,EAAE,EAAE;YACpB,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,EAAE;SAChB;QACD,MAAM,EAAE;YACN,eAAe,EAAE,EAAE;YACnB,eAAe,EAAE,EAAE;YACnB,SAAS,EAAE,EAAE;YACb,cAAc,EAAE,EAAE;SACnB;QACD,MAAM,EAAE;YACN,mBAAmB,EAAE,EAAE;YACvB,iBAAiB,EAAE,IAAI;YACvB,gBAAgB,EAAE,OAAO;SAC1B;QACD,WAAW,EAAE,EAAE;KAChB,CAAC;AACJ,CAAC"}

package/dist/services/convention-store.d.ts

@@ -0,0 +1,9 @@
+import type { LearnedConventions } from '../schemas/learned-conventions.js';
+export declare function loadConventions(projectRoot: string): Promise<LearnedConventions | null>;
+export declare function saveConventions(projectRoot: string, conventions: LearnedConventions): Promise<void>;
+/**
+ * Merge new learnings into existing conventions.
+ * New values take precedence; arrays are deduplicated.
+ */
+export declare function mergeConventions(existing: LearnedConventions, incoming: LearnedConventions): LearnedConventions;
+//# sourceMappingURL=convention-store.d.ts.map

package/dist/services/convention-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-store.d.ts","sourceRoot":"","sources":["../../src/services/convention-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAK5E,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAQ7F;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,kBAAkB,GAC3B,kBAAkB,CA8CpB"}

package/dist/services/convention-store.js

@@ -0,0 +1,84 @@
+import { join } from 'path';
+import { readFileSafe, writeFileSafe } from '../utils.js';
+const FILENAME = '.coretik-conventions.json';
+export async function loadConventions(projectRoot) {
+    const content = await readFileSafe(join(projectRoot, FILENAME));
+    if (!content)
+        return null;
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveConventions(projectRoot, conventions) {
+    const filePath = join(projectRoot, FILENAME);
+    await writeFileSafe(filePath, JSON.stringify(conventions, null, 2));
+}
+/**
+ * Merge new learnings into existing conventions.
+ * New values take precedence; arrays are deduplicated.
+ */
+export function mergeConventions(existing, incoming) {
+    return {
+        version: Math.max(existing.version, incoming.version),
+        learnedAt: incoming.learnedAt,
+        blockCount: incoming.blockCount,
+        php: {
+            imports: dedup([...existing.php.imports, ...incoming.php.imports]),
+            traits: dedup([...existing.php.traits, ...incoming.php.traits]),
+            interfaces: dedup([...existing.php.interfaces, ...incoming.php.interfaces]),
+            baseClasses: { ...existing.php.baseClasses, ...incoming.php.baseClasses },
+            propertyVisibility: incoming.php.propertyVisibility,
+            useSettingsPattern: incoming.php.useSettingsPattern,
+            extraMethods: dedup([...existing.php.extraMethods, ...incoming.php.extraMethods]),
+        },
+        template: {
+            wrapperTag: incoming.template.wrapperTag,
+            wrapperAttributes: dedup([...existing.template.wrapperAttributes, ...incoming.template.wrapperAttributes]),
+            escapingFunctions: mergeRecordArrays(existing.template.escapingFunctions, incoming.template.escapingFunctions),
+            emptyCheckStyle: incoming.template.emptyCheckStyle,
+            imageRenderFunction: incoming.template.imageRenderFunction,
+            htmlSnippets: incoming.template.htmlSnippets,
+        },
+        scss: {
+            methodology: incoming.scss.methodology,
+            containerLayout: incoming.scss.containerLayout,
+            spacingVariables: dedup([...existing.scss.spacingVariables, ...incoming.scss.spacingVariables]),
+            colorVariables: dedup([...existing.scss.colorVariables, ...incoming.scss.colorVariables]),
+            breakpoints: dedup([...existing.scss.breakpoints, ...incoming.scss.breakpoints]),
+        },
+        naming: incoming.naming,
+        fields: {
+            commonFieldPatterns: mergeFieldPatterns(existing.fields.commonFieldPatterns, incoming.fields.commonFieldPatterns),
+            imageReturnFormat: incoming.fields.imageReturnFormat,
+            linkReturnFormat: incoming.fields.linkReturnFormat,
+        },
+        generations: { ...existing.generations, ...incoming.generations },
+    };
+}
+function dedup(arr) {
+    return [...new Set(arr)];
+}
+function mergeRecordArrays(a, b) {
+    const result = { ...a };
+    for (const [key, values] of Object.entries(b)) {
+        result[key] = dedup([...(result[key] || []), ...values]);
+    }
+    return result;
+}
+function mergeFieldPatterns(existing, incoming) {
+    const map = new Map();
+    for (const p of [...existing, ...incoming]) {
+        const key = `${p.name}:${p.type}`;
+        const prev = map.get(key);
+        map.set(key, {
+            name: p.name,
+            type: p.type,
+            frequency: prev ? Math.max(prev.frequency, p.frequency) : p.frequency,
+        });
+    }
+    return [...map.values()].sort((a, b) => b.frequency - a.frequency);
+}
+//# sourceMappingURL=convention-store.js.map

package/dist/services/convention-store.js.map

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

package/dist/services/feedback.d.ts

@@ -0,0 +1,29 @@
+import type { LearnedConventions } from '../schemas/learned-conventions.js';
+interface PathsConfig {
+    blocksPhp: string;
+    templates: string;
+    scss: string;
+    thumbnails: string;
+    acfAdmin: string;
+}
+export declare function hashContent(content: string): string;
+/**
+ * Record a generation manifest entry for a block.
+ */
+export declare function recordGeneration(conventions: LearnedConventions, blockName: string, files: Record<string, string>): LearnedConventions;
+interface FeedbackResult {
+    summary: string;
+    changes: Array<{
+        file: string;
+        fileType: string;
+        status: 'unchanged' | 'modified' | 'deleted' | 'not_tracked';
+    }>;
+    learnedPatterns: string[];
+}
+/**
+ * Analyze a block to detect manual edits since generation.
+ * Extracts patterns from the edited files to improve future generations.
+ */
+export declare function analyzeFeedback(blockName: string, projectRoot: string, paths: PathsConfig, conventions: LearnedConventions): Promise<FeedbackResult>;
+export {};
+//# sourceMappingURL=feedback.d.ts.map

package/dist/services/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/services/feedback.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAG5E,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,kBAAkB,EAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,kBAAkB,CAUpB;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;KAC9D,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAAC,cAAc,CAAC,CA4HzB"}

package/dist/services/feedback.js

@@ -0,0 +1,199 @@
+import { createHash } from 'crypto';
+import { join, relative } from 'path';
+import { readFileSafe, findFiles } from '../utils.js';
+export function hashContent(content) {
+    return createHash('sha256').update(content).digest('hex').substring(0, 16);
+}
+/**
+ * Record a generation manifest entry for a block.
+ */
+export function recordGeneration(conventions, blockName, files // filetype -> content
+) {
+    const hashes = {};
+    for (const [key, content] of Object.entries(files)) {
+        hashes[key] = hashContent(content);
+    }
+    conventions.generations[blockName] = {
+        generatedAt: new Date().toISOString(),
+        files: hashes,
+    };
+    return conventions;
+}
+/**
+ * Analyze a block to detect manual edits since generation.
+ * Extracts patterns from the edited files to improve future generations.
+ */
+export async function analyzeFeedback(blockName, projectRoot, paths, conventions) {
+    const cleanName = blockName.replace(/^(block|component|composite)\./, '');
+    const generation = conventions.generations[blockName] || conventions.generations[cleanName];
+    if (!generation) {
+        return {
+            summary: `Block "${blockName}" has no generation record. Use learn_conventions to analyze existing blocks instead.`,
+            changes: [],
+            learnedPatterns: [],
+        };
+    }
+    const changes = [];
+    const learnedPatterns = [];
+    // Find the PHP file
+    const phpDir = join(projectRoot, paths.blocksPhp);
+    const phpFiles = await findFiles(phpDir, /\.php$/);
+    let phpContent = null;
+    let phpPath = '';
+    for (const file of phpFiles) {
+        const content = await readFileSafe(file);
+        if (content && (content.includes(`'${blockName}'`) ||
+            content.includes(`'block.${cleanName}'`) ||
+            content.includes(`'component.${cleanName}'`))) {
+            phpContent = content;
+            phpPath = relative(projectRoot, file);
+            break;
+        }
+    }
+    // Check PHP changes
+    if (phpContent) {
+        const currentHash = hashContent(phpContent);
+        const originalHash = generation.files['php'];
+        if (originalHash && currentHash !== originalHash) {
+            changes.push({ file: phpPath, fileType: 'php', status: 'modified' });
+            const patterns = extractPhpEditPatterns(phpContent);
+            learnedPatterns.push(...patterns);
+        }
+        else if (originalHash) {
+            changes.push({ file: phpPath, fileType: 'php', status: 'unchanged' });
+        }
+    }
+    else if (generation.files['php']) {
+        changes.push({ file: 'php', fileType: 'php', status: 'deleted' });
+    }
+    // Check template changes
+    const templatePaths = [
+        join(projectRoot, paths.templates, 'block', `${cleanName}.php`),
+        join(projectRoot, paths.templates, 'component', `${cleanName}.php`),
+    ];
+    let templateContent = null;
+    let templatePath = '';
+    for (const tp of templatePaths) {
+        const content = await readFileSafe(tp);
+        if (content) {
+            templateContent = content;
+            templatePath = relative(projectRoot, tp);
+            break;
+        }
+    }
+    if (templateContent) {
+        const currentHash = hashContent(templateContent);
+        const originalHash = generation.files['template'];
+        if (originalHash && currentHash !== originalHash) {
+            changes.push({ file: templatePath, fileType: 'template', status: 'modified' });
+            const patterns = extractTemplateEditPatterns(templateContent);
+            learnedPatterns.push(...patterns);
+        }
+        else if (originalHash) {
+            changes.push({ file: templatePath, fileType: 'template', status: 'unchanged' });
+        }
+    }
+    else if (generation.files['template']) {
+        changes.push({ file: 'template', fileType: 'template', status: 'deleted' });
+    }
+    // Check SCSS changes
+    const scssFile = join(projectRoot, paths.scss, `_${cleanName}.scss`);
+    const scssContent = await readFileSafe(scssFile);
+    if (scssContent) {
+        const currentHash = hashContent(scssContent);
+        const originalHash = generation.files['scss'];
+        if (originalHash && currentHash !== originalHash) {
+            changes.push({ file: relative(projectRoot, scssFile), fileType: 'scss', status: 'modified' });
+            const patterns = extractScssEditPatterns(scssContent);
+            learnedPatterns.push(...patterns);
+        }
+        else if (originalHash) {
+            changes.push({ file: relative(projectRoot, scssFile), fileType: 'scss', status: 'unchanged' });
+        }
+    }
+    else if (generation.files['scss']) {
+        changes.push({ file: 'scss', fileType: 'scss', status: 'deleted' });
+    }
+    // Build summary
+    const modified = changes.filter(c => c.status === 'modified');
+    const unchanged = changes.filter(c => c.status === 'unchanged');
+    let summary = `# Feedback for "${blockName}"\n\n`;
+    if (modified.length === 0 && unchanged.length > 0) {
+        summary += `No manual edits detected. All ${unchanged.length} tracked file(s) are unchanged.\n`;
+    }
+    else {
+        summary += `## Modified files (${modified.length}):\n`;
+        for (const c of modified) {
+            summary += `- ${c.file} (${c.fileType})\n`;
+        }
+        if (unchanged.length > 0) {
+            summary += `\n## Unchanged files (${unchanged.length}):\n`;
+            for (const c of unchanged) {
+                summary += `- ${c.file} (${c.fileType})\n`;
+            }
+        }
+        if (learnedPatterns.length > 0) {
+            summary += `\n## Patterns learned from edits:\n`;
+            for (const p of learnedPatterns) {
+                summary += `- ${p}\n`;
+            }
+        }
+    }
+    return { summary, changes, learnedPatterns };
+}
+// ─── Edit Pattern Extractors ────────────────────────────────────────────────
+function extractPhpEditPatterns(content) {
+    const patterns = [];
+    // Detect new use-statements (imports)
+    const imports = content.match(/^use\s+[A-Z][^;]+;/gm) || [];
+    if (imports.length > 0) {
+        patterns.push(`PHP imports: ${imports.map(i => i.replace(/^use\s+/, '').replace(/;$/, '')).join(', ')}`);
+    }
+    // Detect traits
+    const classBody = content.match(/class\s+\w+[^{]*\{([\s\S]*)\}/)?.[1] || '';
+    const traits = classBody.match(/^\s+use\s+(\w+);/gm) || [];
+    if (traits.length > 0) {
+        patterns.push(`PHP traits: ${traits.map(t => t.trim().replace(/^use\s+/, '').replace(/;$/, '')).join(', ')}`);
+    }
+    // Detect extra methods
+    const methods = content.match(/public\s+function\s+(\w+)\s*\(/g) || [];
+    const standard = new Set(['fieldsBuilder', 'toArray', 'prepareComponents', 'getPlainHtml', '__construct']);
+    const extra = methods
+        .map(m => m.match(/function\s+(\w+)/)?.[1])
+        .filter((m) => !!m && !standard.has(m));
+    if (extra.length > 0) {
+        patterns.push(`Extra PHP methods: ${extra.join(', ')}`);
+    }
+    return patterns;
+}
+function extractTemplateEditPatterns(content) {
+    const patterns = [];
+    // Detect wrapper tag
+    const tagMatch = content.match(/<(\w+)\s+class="/);
+    if (tagMatch && tagMatch[1] !== 'div') {
+        patterns.push(`Template uses <${tagMatch[1]}> as wrapper (not default <div>)`);
+    }
+    // Detect escaping functions
+    const escFns = new Set((content.match(/(esc_html|esc_attr|esc_url|wp_kses|wp_kses_post)\(/g) || [])
+        .map(m => m.replace('(', '')));
+    if (escFns.size > 0) {
+        patterns.push(`Escaping functions: ${[...escFns].join(', ')}`);
+    }
+    return patterns;
+}
+function extractScssEditPatterns(content) {
+    const patterns = [];
+    // Detect CSS variables
+    const vars = content.match(/var\(--([^)]+)\)/g) || [];
+    if (vars.length > 0) {
+        const uniqueVars = [...new Set(vars)];
+        patterns.push(`CSS variables: ${uniqueVars.join(', ')}`);
+    }
+    // Detect breakpoints
+    const bps = content.match(/@include\s+\w+|@media\s*\([^)]+\)/g) || [];
+    if (bps.length > 0) {
+        patterns.push(`Breakpoints/mixins: ${[...new Set(bps)].join(', ')}`);
+    }
+    return patterns;
+}
+//# sourceMappingURL=feedback.js.map

package/dist/services/feedback.js.map

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

package/dist/services/naming.d.ts

@@ -0,0 +1,51 @@
+import type { BlockType } from '../constants.js';
+/**
+ * Convert a label to various case formats used in Coretik.
+ */
+/** "Text And Image" → "text-and-image" */
+export declare function toKebabCase(label: string): string;
+/** "Text And Image" → "text_and_image" */
+export declare function toSnakeCase(label: string): string;
+/** "Text And Image" → "TextAndImage" */
+export declare function toPascalCase(label: string): string;
+/** "Text And Image" → "textAndImage" */
+export declare function toCamelCase(label: string): string;
+/**
+ * Generate the Coretik block NAME constant.
+ * Convention: "type.kebab-case"
+ * e.g. "component.title", "block.text-and-image", "block.title-editor"
+ */
+export declare function toBlockName(label: string, type: BlockType): string;
+/**
+ * Generate the PHP class name.
+ * Convention: PascalCase + suffix based on type
+ * e.g. "TitleComponent", "TextAndImageBlock", "TitleAndTextComposite"
+ */
+export declare function toClassName(label: string, type: BlockType): string;
+/**
+ * Generate the PHP subdirectory based on block type.
+ * Convention: Component/, Block/, Composite/
+ */
+export declare function toSubDirectory(type: BlockType): string;
+/**
+ * Generate the template path relative to template directory.
+ * Convention: type/kebab-case.php
+ * e.g. "block/text-and-image.php"
+ */
+export declare function toTemplatePath(label: string, type: BlockType): string;
+/**
+ * Generate the SCSS filename.
+ * Convention: _kebab-case.scss
+ */
+export declare function toScssFilename(label: string): string;
+/**
+ * Generate the BEM-style CSS base class.
+ * Convention: kebab-case-block
+ */
+export declare function toBemBase(label: string, type: BlockType): string;
+/**
+ * Generate the ACF thumbnail filename.
+ * Convention: type--kebab-case.jpg (or .png)
+ */
+export declare function toThumbnailFilename(label: string, type: BlockType): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/services/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/services/naming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AAEH,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAMlE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAGhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAE1E"}

package/dist/services/naming.js

@@ -0,0 +1,87 @@
+/**
+ * Convert a label to various case formats used in Coretik.
+ */
+/** "Text And Image" → "text-and-image" */
+export function toKebabCase(label) {
+    return label
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .replace(/[^a-zA-Z0-9-]/g, '')
+        .toLowerCase();
+}
+/** "Text And Image" → "text_and_image" */
+export function toSnakeCase(label) {
+    return toKebabCase(label).replace(/-/g, '_');
+}
+/** "Text And Image" → "TextAndImage" */
+export function toPascalCase(label) {
+    return label
+        .replace(/[^a-zA-Z0-9\s]/g, '')
+        .split(/[\s_-]+/)
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+        .join('');
+}
+/** "Text And Image" → "textAndImage" */
+export function toCamelCase(label) {
+    const pascal = toPascalCase(label);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+ * Generate the Coretik block NAME constant.
+ * Convention: "type.kebab-case"
+ * e.g. "component.title", "block.text-and-image", "block.title-editor"
+ */
+export function toBlockName(label, type) {
+    return `${type}.${toKebabCase(label)}`;
+}
+/**
+ * Generate the PHP class name.
+ * Convention: PascalCase + suffix based on type
+ * e.g. "TitleComponent", "TextAndImageBlock", "TitleAndTextComposite"
+ */
+export function toClassName(label, type) {
+    const pascal = toPascalCase(label);
+    const suffix = type === 'component' ? 'Component' : type === 'composite' ? 'Composite' : 'Block';
+    // Avoid double suffix
+    if (pascal.endsWith(suffix))
+        return pascal;
+    return `${pascal}${suffix}`;
+}
+/**
+ * Generate the PHP subdirectory based on block type.
+ * Convention: Component/, Block/, Composite/
+ */
+export function toSubDirectory(type) {
+    return type.charAt(0).toUpperCase() + type.slice(1) + '/';
+}
+/**
+ * Generate the template path relative to template directory.
+ * Convention: type/kebab-case.php
+ * e.g. "block/text-and-image.php"
+ */
+export function toTemplatePath(label, type) {
+    return `${type}/${toKebabCase(label)}.php`;
+}
+/**
+ * Generate the SCSS filename.
+ * Convention: _kebab-case.scss
+ */
+export function toScssFilename(label) {
+    return `_${toKebabCase(label)}.scss`;
+}
+/**
+ * Generate the BEM-style CSS base class.
+ * Convention: kebab-case-block
+ */
+export function toBemBase(label, type) {
+    const suffix = type === 'component' ? '-component' : '-block';
+    return `${toKebabCase(label)}${suffix}`;
+}
+/**
+ * Generate the ACF thumbnail filename.
+ * Convention: type--kebab-case.jpg (or .png)
+ */
+export function toThumbnailFilename(label, type) {
+    return `${type}--${toKebabCase(label)}.jpg`;
+}
+//# sourceMappingURL=naming.js.map

package/dist/services/naming.js.map

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

package/dist/services/pattern-extractor.d.ts

@@ -0,0 +1,14 @@
+import type { LearnedConventions } from '../schemas/learned-conventions.js';
+interface PathsConfig {
+    blocksPhp: string;
+    templates: string;
+    scss: string;
+    thumbnails: string;
+    acfAdmin: string;
+}
+/**
+ * Scan all existing blocks and extract patterns into LearnedConventions.
+ */
+export declare function extractPatterns(projectRoot: string, paths: PathsConfig): Promise<LearnedConventions>;
+export {};
+//# sourceMappingURL=pattern-extractor.d.ts.map

package/dist/services/pattern-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-extractor.d.ts","sourceRoot":"","sources":["../../src/services/pattern-extractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAI5E,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAe7B"}