/* * The MIT License (MIT) * * Copyright (c) 2015 - present Instructure, Inc. * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ import { PlacementPropValues, PlacementValueArray, PlacementStringValues, mirrorMap } from './PositionPropTypes' import executeMirrorFunction from './executeMirrorFunction' /** * Given a string or array of one or two placement values, mirrors the placement * horizontally. * * Examples * ```js * mirrorHorizontalPlacement('top start') // input * ['top', 'end'] // output * * mirrorPlacement('top start', ' ') // input * 'top end' //output * ``` * * @param {string|Array} placement - a string of the form '`` ``' or array [``, ``] * @param {string} delimiter - when provided, a value with which the result array will be joined * @returns {string|Array} - an array of values or, if the delimiter was supplied, a string of * delimiter separated values */ function mirrorHorizontalPlacement( placement: PlacementValueArray | PlacementStringValues, delimiter?: D ): D extends string ? D extends ' ' ? PlacementPropValues : string : PlacementValueArray { return executeMirrorFunction( placement, (first, second) => { return [first, second].map((value) => { return value === 'start' || value === 'end' ? mirrorMap[value] : value }) as PlacementValueArray }, delimiter ) } export default mirrorHorizontalPlacement export { mirrorHorizontalPlacement }