// Copyright 2014 The Flutter Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. import 'package:path/path.dart' as path; import 'base_code_gen.dart'; import 'key_data.dart'; import 'utils.dart'; /// Given an [input] string, wraps the text at 80 characters and prepends each /// line with the [prefix] string. Use for generated comments. String _wrapString(String input, {String prefix = ' /// '}) { final int wrapWidth = 80 - prefix.length; final StringBuffer result = StringBuffer(); final List words = input.split(RegExp(r'\s+')); String currentLine = words.removeAt(0); for (final String word in words) { if ((currentLine.length + word.length) < wrapWidth) { currentLine += ' $word'; } else { result.writeln('$prefix$currentLine'); currentLine = word; } } if (currentLine.isNotEmpty) { result.writeln('$prefix$currentLine'); } return result.toString(); } /// Generates the keyboard_keys.dart based on the information in the key data /// structure given to it. class KeyboardKeysCodeGenerator extends BaseCodeGenerator { KeyboardKeysCodeGenerator(KeyData keyData) : super(keyData); /// Gets the generated definitions of PhysicalKeyboardKeys. String get _physicalDefinitions { final StringBuffer definitions = StringBuffer(); for (final Key entry in keyData.data) { final String firstComment = _wrapString('Represents the location of the ' '"${entry.commentName}" key on a generalized keyboard.'); final String otherComments = _wrapString('See the function ' '[RawKeyEvent.physicalKey] for more information.'); definitions.write(''' $firstComment /// $otherComments static const PhysicalKeyboardKey ${entry.constantName} = PhysicalKeyboardKey._(${toHex(entry.usbHidCode, digits: 8)}); '''); } return definitions.toString(); } String get _physicalDebugNames { final StringBuffer result = StringBuffer(); for (final Key entry in keyData.data) { result.write(''' ${toHex(entry.usbHidCode, digits: 8)}: '${entry.commentName}', '''); } return result.toString(); } /// Gets the generated definitions of LogicalKeyboardKeys. String get _logicalDefinitions { final StringBuffer definitions = StringBuffer(); void printKey(int flutterId, String constantName, String commentName, {String otherComments}) { final String firstComment = _wrapString('Represents the logical "$commentName" key on the keyboard.'); otherComments ??= _wrapString('See the function [RawKeyEvent.logicalKey] for more information.'); definitions.write(''' $firstComment /// $otherComments static const LogicalKeyboardKey $constantName = LogicalKeyboardKey._(${toHex(flutterId, digits: 11)}); '''); } for (final Key entry in keyData.data) { printKey( entry.flutterId, entry.constantName, entry.commentName, ); } for (final String name in Key.synonyms.keys) { // Use the first item in the synonyms as a template for the ID to use. // It won't end up being the same value because it'll be in the pseudo-key // plane. final Key entry = keyData.data.firstWhere((Key item) => item.name == Key.synonyms[name][0]); final Set unionNames = Key.synonyms[name].map((dynamic name) { return upperCamelToLowerCamel(name as String); }).toSet(); printKey(Key.synonymPlane | entry.flutterId, name, Key.getCommentName(name), otherComments: _wrapString('This key represents the union of the keys ' '$unionNames when comparing keys. This key will never be generated ' 'directly, its main use is in defining key maps.')); } return definitions.toString(); } String get _logicalSynonyms { final StringBuffer synonyms = StringBuffer(); for (final String name in Key.synonyms.keys) { for (final String synonym in Key.synonyms[name].cast()) { final String keyName = upperCamelToLowerCamel(synonym); synonyms.writeln(' $keyName: $name,'); } } return synonyms.toString(); } String get _logicalDebugNames { final StringBuffer result = StringBuffer(); for (final Key entry in keyData.data) { result.write(''' ${toHex(entry.flutterId, digits: 11)}: '${entry.commentName}', '''); } for (final String name in Key.synonyms.keys) { // Use the first item in the synonyms as a template for the ID to use. // It won't end up being the same value because it'll be in the pseudo-key // plane. final Key entry = keyData.data.firstWhere((Key item) => item.name == Key.synonyms[name][0]); result.write(''' ${toHex(Key.synonymPlane | entry.flutterId, digits: 11)}: '${Key.getCommentName(name)}', '''); } return result.toString(); } /// This generates the map of USB HID codes to physical keys. String get _predefinedHidCodeMap { final StringBuffer scanCodeMap = StringBuffer(); for (final Key entry in keyData.data) { scanCodeMap.writeln(' ${toHex(entry.usbHidCode)}: ${entry.constantName},'); } return scanCodeMap.toString().trimRight(); } /// This generates the map of Flutter key codes to logical keys. String get _predefinedKeyCodeMap { final StringBuffer keyCodeMap = StringBuffer(); for (final Key entry in keyData.data) { keyCodeMap.writeln(' ${toHex(entry.flutterId, digits: 10)}: ${entry.constantName},'); } for (final String entry in Key.synonyms.keys) { // Use the first item in the synonyms as a template for the ID to use. // It won't end up being the same value because it'll be in the pseudo-key // plane. final Key primaryKey = keyData.data.firstWhere((Key item) { return item.name == Key.synonyms[entry][0]; }, orElse: () => null); assert(primaryKey != null); keyCodeMap.writeln(' ${toHex(Key.synonymPlane | primaryKey.flutterId, digits: 10)}: $entry,'); } return keyCodeMap.toString().trimRight(); } @override String get templatePath => path.join(flutterRoot.path, 'dev', 'tools', 'gen_keycodes', 'data', 'keyboard_key.tmpl'); @override Map mappings() { return { 'PHYSICAL_KEY_MAP': _predefinedHidCodeMap, 'LOGICAL_KEY_MAP': _predefinedKeyCodeMap, 'LOGICAL_KEY_DEFINITIONS': _logicalDefinitions, 'LOGICAL_KEY_SYNONYMS': _logicalSynonyms, 'LOGICAL_KEY_DEBUG_NAMES': _logicalDebugNames, 'PHYSICAL_KEY_DEFINITIONS': _physicalDefinitions, 'PHYSICAL_KEY_DEBUG_NAMES': _physicalDebugNames, }; } }