few large files"); this class is an * internal implementation detail, not part of the Domain public contract. * * @package AIPT\Core\ContentStructure\Domain * @since 2.8.0 */ namespace AIPT\Core\ContentStructure\Domain; defined( 'ABSPATH' ) || exit; /** * Normalizes the Title, SeoMeta, Faq and ImageAlt structures. */ class FormulaStructureNormalizer { /** * @var FieldCatalog */ private $fields; /** * @param FieldCatalog $fields Field catalog (shared with DefinitionNormalizer). */ public function __construct( FieldCatalog $fields ) { $this->fields = $fields; } /** * @param array $input Raw structure input. * @param array $default Default structure. * @param string $scope FieldCatalog scope ('product'). * @param bool $allow_custom_fields Context flag. * @param array &$errors Collected errors. * @return array */ public function normalizeTitleStructure( array $input, array $default, string $scope, bool $allow_custom_fields, array &$errors ): array { $raw_parts = is_array( $input['parts'] ?? null ) ? array_values( $input['parts'] ) : array(); if ( count( $raw_parts ) < DefinitionPrimitives::TITLE_PARTS_MIN || count( $raw_parts ) > DefinitionPrimitives::TITLE_PARTS_MAX ) { $errors[] = DefinitionPrimitives::issue( 'structure.parts', 'out_of_range', __( 'A title needs between 1 and 10 parts.', 'ai-product-tools' ) ); } if ( count( $raw_parts ) > DefinitionPrimitives::TITLE_PARTS_MAX ) { $raw_parts = array_slice( $raw_parts, 0, DefinitionPrimitives::TITLE_PARTS_MAX ); } $seen_ids = array(); $part_keys = SectionCatalog::titlePartKeys(); $parts = array(); $part_ids = array(); foreach ( $raw_parts as $index => $raw_part ) { if ( ! is_array( $raw_part ) ) { $errors[] = DefinitionPrimitives::issue( 'structure.parts[' . $index . ']', 'invalid_shape', __( 'Invalid title part.', 'ai-product-tools' ) ); continue; } $part = $this->normalizeTitlePart( $raw_part, $part_keys, $scope, $allow_custom_fields, 'structure.parts[' . $index . ']', $seen_ids, $errors ); $parts[] = $part; $part_ids[] = $part['id']; } $separator = $input['separator'] ?? $default['separator']; if ( ! DefinitionPrimitives::inEnum( $separator, array( 'dash', 'pipe', 'comma', 'space' ) ) ) { $errors[] = DefinitionPrimitives::issue( 'structure.separator', 'invalid_enum', __( 'Invalid separator.', 'ai-product-tools' ) ); $separator = $default['separator']; } $max_chars = DefinitionPrimitives::intOr( $input['maxChars'] ?? null, $default['maxChars'] ); if ( $max_chars < DefinitionPrimitives::TITLE_MAX_CHARS_MIN || $max_chars > DefinitionPrimitives::TITLE_MAX_CHARS_MAX ) { $errors[] = DefinitionPrimitives::issue( 'structure.maxChars', 'out_of_range', __( 'Character limit is out of range.', 'ai-product-tools' ) ); } $overflow_drop_part_id = $input['overflowDropPartId'] ?? null; if ( null !== $overflow_drop_part_id && ! in_array( $overflow_drop_part_id, $part_ids, true ) ) { $errors[] = DefinitionPrimitives::issue( 'structure.overflowDropPartId', 'unknown_ref', __( 'This part does not exist.', 'ai-product-tools' ) ); $overflow_drop_part_id = null; } $dedupe = DefinitionPrimitives::boolOr( $input['dedupe'] ?? $default['dedupe'], true ); $avoid_all_caps = DefinitionPrimitives::boolOr( $input['avoidAllCaps'] ?? $default['avoidAllCaps'] ?? true, true ); $avoid_sku = DefinitionPrimitives::boolOr( $input['avoidSku'] ?? $default['avoidSku'] ?? true, true ); $raw_keywords = $input['keywords'] ?? $default['keywords'] ?? array(); return array( 'parts' => $parts, 'separator' => $separator, 'maxChars' => $max_chars, 'overflowDropPartId' => $overflow_drop_part_id, 'dedupe' => $dedupe, 'avoidAllCaps' => $avoid_all_caps, 'avoidSku' => $avoid_sku, 'keywords' => $this->normalizeTitleKeywords( is_array( $raw_keywords ) ? array_values( $raw_keywords ) : array(), $errors ), ); } /** * Keywords the AI works into a title's AI-written parts: single-line * text, each at most {@see DefinitionPrimitives::TITLE_KEYWORD_MAX_LEN} * characters, at most {@see DefinitionPrimitives::TITLE_KEYWORDS_MAX}, * without case-insensitive duplicates. Whether a run uses them is the * plan's call (`EntitlementPolicy`), not the schema's. * * @param array $raw Raw keyword list. * @param array &$errors Collected errors. * @return string[] */ private function normalizeTitleKeywords( array $raw, array &$errors ): array { if ( count( $raw ) > DefinitionPrimitives::TITLE_KEYWORDS_MAX ) { $errors[] = DefinitionPrimitives::issue( 'structure.keywords', 'too_many', __( 'A title takes up to 10 keywords.', 'ai-product-tools' ) ); $raw = array_slice( $raw, 0, DefinitionPrimitives::TITLE_KEYWORDS_MAX ); } $keywords = array(); $seen = array(); foreach ( $raw as $index => $keyword ) { $result = DefinitionPrimitives::singleLineText( $keyword, DefinitionPrimitives::TITLE_KEYWORD_MAX_LEN ); if ( $result['overLimit'] ) { $errors[] = DefinitionPrimitives::issue( 'structure.keywords[' . $index . ']', 'too_long', __( 'Keyword is too long.', 'ai-product-tools' ) ); continue; } $key = mb_strtolower( $result['value'], 'UTF-8' ); if ( '' === $result['value'] || isset( $seen[ $key ] ) ) { continue; } $seen[ $key ] = true; $keywords[] = $result['value']; } return $keywords; } /** * @param array $item Raw title part. * @param array $part_keys SectionCatalog::titlePartKeys(). * @param string $scope FieldCatalog scope. * @param bool $allow_custom_fields Context flag. * @param string $path Error path for this item. * @param array &$seen_ids Ids already used earlier in this list. * @param array &$errors Collected errors. * @return array TitlePart-shaped array. */ private function normalizeTitlePart( array $item, array $part_keys, string $scope, bool $allow_custom_fields, string $path, array &$seen_ids, array &$errors ): array { $id = DefinitionPrimitives::normalizeId( $item['id'] ?? null, $path, $seen_ids, $errors ); $key = $item['key'] ?? ''; if ( ! is_string( $key ) || ! isset( $part_keys[ $key ] ) ) { $errors[] = DefinitionPrimitives::issue( $path . '.key', 'invalid_enum', __( 'Invalid title part key.', 'ai-product-tools' ) ); $key = 'custom'; } $allowed_modes = $part_keys[ $key ]['modes'] ?? array( 'data', 'ai', 'fixed' ); $enabled = DefinitionPrimitives::boolOr( $item['enabled'] ?? null, true ); $mode = $item['mode'] ?? $allowed_modes[0]; if ( ! DefinitionPrimitives::inEnum( $mode, $allowed_modes ) ) { $errors[] = DefinitionPrimitives::issue( $path . '.mode', 'invalid_enum', __( 'This mode is not allowed for this part.', 'ai-product-tools' ) ); $mode = $allowed_modes[0]; } $field = is_string( $item['field'] ?? null ) ? $item['field'] : ''; if ( '' !== $field && ! DefinitionPrimitives::validFieldRef( $field, $this->fields, $scope, $allow_custom_fields ) ) { $errors[] = DefinitionPrimitives::issue( $path . '.field', 'invalid_field_ref', DefinitionPrimitives::unavailableFieldMessage( $field ) ); $field = ''; } $text_result = DefinitionPrimitives::singleLineText( $item['text'] ?? '', DefinitionPrimitives::TITLE_PART_TEXT_MAX_LEN ); if ( $text_result['overLimit'] ) { $errors[] = DefinitionPrimitives::issue( $path . '.text', 'too_long', __( 'Text is too long.', 'ai-product-tools' ) ); } $max_chars = array_key_exists( 'maxChars', $item ) ? $item['maxChars'] : null; if ( null !== $max_chars ) { $max_chars = DefinitionPrimitives::intOr( $max_chars, 0 ); if ( $max_chars < 1 || $max_chars > DefinitionPrimitives::PART_MAX_CHARS_MAX ) { $errors[] = DefinitionPrimitives::issue( $path . '.maxChars', 'out_of_range', __( 'Character limit is out of range.', 'ai-product-tools' ) ); $max_chars = null; } } $missing = $item['missing'] ?? 'skip'; if ( ! DefinitionPrimitives::inEnum( $missing, array( 'skip', 'fallback' ) ) ) { $errors[] = DefinitionPrimitives::issue( $path . '.missing', 'invalid_enum', __( 'Invalid missing-part policy.', 'ai-product-tools' ) ); $missing = 'skip'; } $fallback_result = DefinitionPrimitives::multiLineText( $item['fallback'] ?? '', DefinitionPrimitives::FALLBACK_TEXT_MAX_LEN ); if ( $fallback_result['overLimit'] ) { $errors[] = DefinitionPrimitives::issue( $path . '.fallback', 'too_long', __( 'Fallback text is too long.', 'ai-product-tools' ) ); } return array( 'id' => $id, 'key' => $key, 'enabled' => $enabled, 'mode' => $mode, 'field' => $field, 'text' => $text_result['value'], 'maxChars' => $max_chars, 'missing' => $missing, 'fallback' => $fallback_result['value'], ); } /** * @param array $input Raw structure input. * @param array $default Default structure. * @param string $scope FieldCatalog scope ('product'). * @param bool $allow_custom_fields Context flag. * @param array &$errors Collected errors. * @return array */ public function normalizeSeoMetaStructure( array $input, array $default, string $scope, bool $allow_custom_fields, array &$errors ): array { $title_input = is_array( $input['title'] ?? null ) ? $input['title'] : array(); $title_tokens = $this->normalizeSeoTokenList( is_array( $title_input['tokens'] ?? null ) ? $title_input['tokens'] : array(), $scope, $allow_custom_fields, 'structure.title.tokens', $errors ); $title_separator = $title_input['separator'] ?? $default['title']['separator']; if ( ! DefinitionPrimitives::inEnum( $title_separator, array( 'pipe', 'dash', 'colon' ) ) ) { $errors[] = DefinitionPrimitives::issue( 'structure.title.separator', 'invalid_enum', __( 'Invalid separator.', 'ai-product-tools' ) ); $title_separator = $default['title']['separator']; } $title_bounds = $this->normalizeCharRange( $title_input, $default['title'], DefinitionPrimitives::SEO_TITLE_CHARS_MAX, 'structure.title', $errors ); $description_input = is_array( $input['description'] ?? null ) ? $input['description'] : array(); $description_tokens = $this->normalizeSeoTokenList( is_array( $description_input['tokens'] ?? null ) ? $description_input['tokens'] : array(), $scope, $allow_custom_fields, 'structure.description.tokens', $errors ); $description_bounds = $this->normalizeCharRange( $description_input, $default['description'], DefinitionPrimitives::SEO_DESC_CHARS_MAX, 'structure.description', $errors ); $keyword_input = is_array( $input['keyword'] ?? null ) ? $input['keyword'] : array(); $keyword_source = $keyword_input['source'] ?? $default['keyword']['source']; if ( ! DefinitionPrimitives::inEnum( $keyword_source, array( 'focus_keyword', 'product_name', 'generate', 'none' ) ) ) { $errors[] = DefinitionPrimitives::issue( 'structure.keyword.source', 'invalid_enum', __( 'Invalid keyword source.', 'ai-product-tools' ) ); $keyword_source = $default['keyword']['source']; } $keyword_once = DefinitionPrimitives::boolOr( $keyword_input['once'] ?? $default['keyword']['once'], true ); return array( 'title' => array( 'tokens' => $title_tokens, 'separator' => $title_separator, 'targetMin' => $title_bounds['targetMin'], 'targetMax' => $title_bounds['targetMax'], 'hardMax' => $title_bounds['hardMax'], ), 'description' => array( 'tokens' => $description_tokens, 'targetMin' => $description_bounds['targetMin'], 'targetMax' => $description_bounds['targetMax'], 'hardMax' => $description_bounds['hardMax'], ), 'keyword' => array( 'source' => $keyword_source, 'once' => $keyword_once, ), ); } /** * Normalize a {targetMin, targetMax, hardMax} character range (SEO * title/description bounds; hardMax is required, never null, unlike * the word-count WordRange used by sections). * * @param array $input Raw sub-object. * @param array $default Default sub-object. * @param int $max_bound Maximum allowed character count. * @param string $path Error path prefix. * @param array &$errors Collected errors. * @return array{targetMin:int,targetMax:int,hardMax:int} */ private function normalizeCharRange( array $input, array $default, int $max_bound, string $path, array &$errors ): array { $target_min = DefinitionPrimitives::intOr( $input['targetMin'] ?? null, $default['targetMin'] ); $target_max = DefinitionPrimitives::intOr( $input['targetMax'] ?? null, $default['targetMax'] ); $hard_max = DefinitionPrimitives::intOr( $input['hardMax'] ?? null, $default['hardMax'] ); if ( $target_min < 0 || $target_min > $max_bound ) { $errors[] = DefinitionPrimitives::issue( $path . '.targetMin', 'out_of_range', __( 'Target minimum is out of range.', 'ai-product-tools' ) ); } if ( $target_max < 0 || $target_max > $max_bound ) { $errors[] = DefinitionPrimitives::issue( $path . '.targetMax', 'out_of_range', __( 'Target maximum is out of range.', 'ai-product-tools' ) ); } if ( $target_min > $target_max ) { $errors[] = DefinitionPrimitives::issue( $path . '.targetMax', 'invalid_range', __( 'Target maximum must be at least the target minimum.', 'ai-product-tools' ) ); } if ( $hard_max < 0 || $hard_max > $max_bound ) { $errors[] = DefinitionPrimitives::issue( $path . '.hardMax', 'out_of_range', __( 'Hard maximum is out of range.', 'ai-product-tools' ) ); } elseif ( $hard_max < $target_max ) { $errors[] = DefinitionPrimitives::issue( $path . '.hardMax', 'invalid_range', __( 'Hard maximum must be at least the target maximum.', 'ai-product-tools' ) ); } return array( 'targetMin' => $target_min, 'targetMax' => $target_max, 'hardMax' => $hard_max, ); } /** * @param array $raw_tokens Raw SeoToken list. * @param string $scope FieldCatalog scope. * @param bool $allow_custom_fields Context flag. * @param string $path Error path prefix (no trailing dot). * @param array &$errors Collected errors. * @return array */ private function normalizeSeoTokenList( array $raw_tokens, string $scope, bool $allow_custom_fields, string $path, array &$errors ): array { $token_keys = SectionCatalog::seoTokenKeys(); $seen_ids = array(); $tokens = array(); foreach ( array_values( $raw_tokens ) as $index => $raw_token ) { if ( ! is_array( $raw_token ) ) { $errors[] = DefinitionPrimitives::issue( $path . '[' . $index . ']', 'invalid_shape', __( 'Invalid token.', 'ai-product-tools' ) ); continue; } $item_path = $path . '[' . $index . ']'; $id = DefinitionPrimitives::normalizeId( $raw_token['id'] ?? null, $item_path, $seen_ids, $errors ); $key = $raw_token['key'] ?? ''; if ( ! is_string( $key ) || ! isset( $token_keys[ $key ] ) ) { $errors[] = DefinitionPrimitives::issue( $item_path . '.key', 'invalid_enum', __( 'Invalid SEO token key.', 'ai-product-tools' ) ); $key = 'custom'; } $allowed_modes = $token_keys[ $key ]['modes'] ?? array( 'ai', 'fixed' ); $mode = $raw_token['mode'] ?? $allowed_modes[0]; if ( ! DefinitionPrimitives::inEnum( $mode, $allowed_modes ) ) { $errors[] = DefinitionPrimitives::issue( $item_path . '.mode', 'invalid_enum', __( 'This mode is not allowed for this token.', 'ai-product-tools' ) ); $mode = $allowed_modes[0]; } $field = is_string( $raw_token['field'] ?? null ) ? $raw_token['field'] : ''; if ( '' !== $field && ! DefinitionPrimitives::validFieldRef( $field, $this->fields, $scope, $allow_custom_fields ) ) { $errors[] = DefinitionPrimitives::issue( $item_path . '.field', 'invalid_field_ref', DefinitionPrimitives::unavailableFieldMessage( $field ) ); $field = ''; } $text_result = DefinitionPrimitives::singleLineText( $raw_token['text'] ?? '', DefinitionPrimitives::TOKEN_TEXT_MAX_LEN ); if ( $text_result['overLimit'] ) { $errors[] = DefinitionPrimitives::issue( $item_path . '.text', 'too_long', __( 'Text is too long.', 'ai-product-tools' ) ); } $tokens[] = array( 'id' => $id, 'key' => $key, 'mode' => $mode, 'field' => $field, 'text' => $text_result['value'], ); } return $tokens; } /** * @param array $input Raw structure input. * @param array $default Default structure. * @param string $scope FieldCatalog scope ('product'). * @param int[] $known_source_ids Ids valid for 'src:' refs. * @param bool $allow_custom_fields Context flag. * @param array &$errors Collected errors. * @return array{groups:array,maxQuestions:int} */ public function normalizeFaqStructure( array $input, array $default, string $scope, array $known_source_ids, bool $allow_custom_fields, array &$errors ): array { $raw_groups = is_array( $input['groups'] ?? null ) ? array_values( $input['groups'] ) : array(); $seen_ids = array(); $groups = array(); foreach ( $raw_groups as $index => $raw_group ) { if ( ! is_array( $raw_group ) ) { $errors[] = DefinitionPrimitives::issue( 'structure.groups[' . $index . ']', 'invalid_shape', __( 'Invalid FAQ group.', 'ai-product-tools' ) ); continue; } $groups[] = $this->normalizeFaqGroup( $raw_group, $scope, $known_source_ids, $allow_custom_fields, 'structure.groups[' . $index . ']', $seen_ids, $errors ); } $max_questions = DefinitionPrimitives::intOr( $input['maxQuestions'] ?? null, $default['maxQuestions'] ); if ( $max_questions < DefinitionPrimitives::FAQ_MAX_QUESTIONS_MIN || $max_questions > DefinitionPrimitives::FAQ_MAX_QUESTIONS_MAX ) { $errors[] = DefinitionPrimitives::issue( 'structure.maxQuestions', 'out_of_range', __( 'Question cap is out of range.', 'ai-product-tools' ) ); } $mode = $input['mode'] ?? $default['mode']; if ( ! DefinitionPrimitives::inEnum( $mode, array( 'both', 'questions', 'answers' ) ) ) { $errors[] = DefinitionPrimitives::issue( 'structure.mode', 'invalid_enum', __( 'Invalid FAQ mode.', 'ai-product-tools' ) ); $mode = $default['mode']; } return array( 'groups' => $groups, 'maxQuestions' => $max_questions, 'mode' => $mode, ); } /** * @param array $item Raw FAQ group. * @param string $scope FieldCatalog scope. * @param int[] $known_source_ids Ids valid for 'src:' refs. * @param bool $allow_custom_fields Context flag. * @param string $path Error path for this item. * @param array &$seen_ids Ids already used earlier in this list. * @param array &$errors Collected errors. * @return array FaqGroup-shaped array. */ private function normalizeFaqGroup( array $item, string $scope, array $known_source_ids, bool $allow_custom_fields, string $path, array &$seen_ids, array &$errors ): array { $id = DefinitionPrimitives::normalizeId( $item['id'] ?? null, $path, $seen_ids, $errors ); $name_result = DefinitionPrimitives::singleLineText( $item['name'] ?? '', DefinitionPrimitives::NAME_MAX_LEN ); if ( $name_result['overLimit'] ) { $errors[] = DefinitionPrimitives::issue( $path . '.name', 'too_long', __( 'Group name is too long.', 'ai-product-tools' ) ); } $topic_result = DefinitionPrimitives::singleLineText( $item['topic'] ?? '', DefinitionPrimitives::GROUP_TOPIC_MAX_LEN ); if ( $topic_result['overLimit'] ) { $errors[] = DefinitionPrimitives::issue( $path . '.topic', 'too_long', __( 'Group topic is too long.', 'ai-product-tools' ) ); } $enabled = DefinitionPrimitives::boolOr( $item['enabled'] ?? null, true ); $count = DefinitionPrimitives::intOr( $item['count'] ?? null, DefinitionPrimitives::FAQ_GROUP_COUNT_MIN ); if ( $count < DefinitionPrimitives::FAQ_GROUP_COUNT_MIN || $count > DefinitionPrimitives::FAQ_GROUP_COUNT_MAX ) { $errors[] = DefinitionPrimitives::issue( $path . '.count', 'out_of_range', __( 'Question count is out of range.', 'ai-product-tools' ) ); } $answer_input = is_array( $item['answer'] ?? null ) ? $item['answer'] : array(); $answer_target = DefinitionPrimitives::intOr( $answer_input['targetMax'] ?? null, DefinitionPrimitives::FAQ_ANSWER_TARGET_MAX ); $answer_hard = DefinitionPrimitives::intOr( $answer_input['hardMax'] ?? null, DefinitionPrimitives::FAQ_ANSWER_HARD_MAX ); if ( $answer_target < 1 || $answer_target > DefinitionPrimitives::FAQ_ANSWER_TARGET_MAX ) { $errors[] = DefinitionPrimitives::issue( $path . '.answer.targetMax', 'out_of_range', __( 'Answer length target is out of range.', 'ai-product-tools' ) ); } if ( $answer_hard < 0 || $answer_hard > DefinitionPrimitives::FAQ_ANSWER_HARD_MAX ) { $errors[] = DefinitionPrimitives::issue( $path . '.answer.hardMax', 'out_of_range', __( 'Answer hard limit is out of range.', 'ai-product-tools' ) ); } elseif ( $answer_hard < $answer_target ) { $errors[] = DefinitionPrimitives::issue( $path . '.answer.hardMax', 'invalid_range', __( 'Answer hard limit must be at least the target.', 'ai-product-tools' ) ); } $sources = DefinitionPrimitives::sectionSources( $item['sources'] ?? null, array( 'inherit' => true, 'refs' => array() ), $known_source_ids, $path . '.sources', $errors ); $condition = DefinitionPrimitives::condition( $item['condition'] ?? null, array( 'enabled' => false, 'field' => '', 'operator' => 'not_empty', 'value' => '' ), $this->fields, $scope, $allow_custom_fields, $path . '.condition', $errors ); $instruction_result = DefinitionPrimitives::multiLineText( $item['instruction'] ?? '', DefinitionPrimitives::INSTRUCTION_MAX_LEN ); if ( $instruction_result['overLimit'] ) { $errors[] = DefinitionPrimitives::issue( $path . '.instruction', 'too_long', __( 'Instruction is too long.', 'ai-product-tools' ) ); } return array( 'id' => $id, 'name' => $name_result['value'], 'topic' => $topic_result['value'], 'enabled' => $enabled, 'count' => $count, 'answer' => array( 'targetMax' => $answer_target, 'hardMax' => $answer_hard, ), 'sources' => $sources, 'condition' => $condition, 'instruction' => $instruction_result['value'], ); } /** * @param array $input Raw structure input. * @param array $default Default structure. * @param array &$errors Collected errors. * @return array */ public function normalizeImageAltStructure( array $input, array $default, array &$errors ): array { $context = $input['context'] ?? $default['context']; if ( ! DefinitionPrimitives::inEnum( $context, array( 'product_data', 'vision' ) ) ) { $errors[] = DefinitionPrimitives::issue( 'structure.context', 'invalid_enum', __( 'Invalid image context.', 'ai-product-tools' ) ); $context = $default['context']; } $max_chars = DefinitionPrimitives::intOr( $input['maxChars'] ?? null, $default['maxChars'] ); if ( $max_chars < DefinitionPrimitives::IMAGE_ALT_MAX_CHARS_MIN || $max_chars > DefinitionPrimitives::IMAGE_ALT_MAX_CHARS_MAX ) { $errors[] = DefinitionPrimitives::issue( 'structure.maxChars', 'out_of_range', __( 'Character limit is out of range.', 'ai-product-tools' ) ); } $rules_input = is_array( $input['rules'] ?? null ) ? $input['rules'] : array(); $default_rules = $default['rules']; $rules = array(); foreach ( array_keys( $default_rules ) as $key ) { $rules[ $key ] = DefinitionPrimitives::boolOr( $rules_input[ $key ] ?? $default_rules[ $key ], (bool) $default_rules[ $key ] ); } $instruction_result = DefinitionPrimitives::multiLineText( $input['instruction'] ?? $default['instruction'], DefinitionPrimitives::INSTRUCTION_MAX_LEN ); if ( $instruction_result['overLimit'] ) { $errors[] = DefinitionPrimitives::issue( 'structure.instruction', 'too_long', __( 'Instruction is too long.', 'ai-product-tools' ) ); } $starter = $input['starter'] ?? $default['starter']; if ( ! is_string( $starter ) || 1 !== preg_match( '/^[a-z0-9_]{1,40}$/', $starter ) ) { $starter = ''; } return array( 'context' => $context, 'maxChars' => $max_chars, 'rules' => $rules, 'instruction' => $instruction_result['value'], 'starter' => $starter, ); } }