import type { NodeTypeGuide } from '../types';

/**
 * Checks if a node has text/string fields that might use expressions.
 */
function hasTextFields(nodeDefinition: {
	properties?: Array<{ type: string; typeOptions?: { multipleValues?: boolean } }>;
}): boolean {
	if (!nodeDefinition.properties) return false;

	return nodeDefinition.properties.some(
		(prop) => prop.type === 'string' && prop.typeOptions?.multipleValues !== true,
	);
}

export const TEXT_FIELDS_GUIDE: NodeTypeGuide = {
	patterns: ['*'],
	condition: (ctx) => hasTextFields(ctx.nodeDefinition),
	content: `
## Text Field Expression Formatting

### PREFERRED METHOD: Embedding expressions directly within text
\`\`\`
"text": "=ALERT: It is currently {{ $('Weather Node').item.json.weather }} in {{ $('Weather Node').item.json.city }}!"
\`\`\`

### Alternative method: Using string concatenation (use only when needed)
\`\`\`
"text": "={{ 'ALERT: It is currently ' + $('Weather Node').item.json.weather + ' in ' + $('Weather Node').item.json.city + '!' }}"
\`\`\`

### Key Points:
- Use the embedded expression format when mixing static text with dynamic values
- The entire string must start with = when using expressions
- Expressions within text use single curly braces {{ }}
- The outer expression wrapper uses double curly braces ={{ }}`,
};