[ { "path": ".gitignore", "content": "\n/target/\n\n# Compiled class file\n*.class\n\n# Log file\n*.log\n\n# BlueJ files\n*.ctxt\n\n# Mobile Tools for Java (J2ME)\n.mtj.tmp/\n\n# Package Files #\n*.jar\n*.war\n*.ear\n*.zip\n*.tar.gz\n*.rar\n\n# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml\nhs_err_pid*\n.idea/\n\n*.iml\n" }, { "path": "LICENSE", "content": " GNU GENERAL PUBLIC LICENSE\n Version 3, 29 June 2007\n\n Copyright (C) 2007 Free Software Foundation, Inc. \n Everyone is permitted to copy and distribute verbatim copies\n of this license document, but changing it is not allowed.\n\n Preamble\n\n The GNU General Public License is a free, copyleft license for\nsoftware and other kinds of works.\n\n The licenses for most software and other practical works are designed\nto take away your freedom to share and change the works. By contrast,\nthe GNU General Public License is intended to guarantee your freedom to\nshare and change all versions of a program--to make sure it remains free\nsoftware for all its users. We, the Free Software Foundation, use the\nGNU General Public License for most of our software; it applies also to\nany other work released this way by its authors. You can apply it to\nyour programs, too.\n\n When we speak of free software, we are referring to freedom, not\nprice. Our General Public Licenses are designed to make sure that you\nhave the freedom to distribute copies of free software (and charge for\nthem if you wish), that you receive source code or can get it if you\nwant it, that you can change the software or use pieces of it in new\nfree programs, and that you know you can do these things.\n\n To protect your rights, we need to prevent others from denying you\nthese rights or asking you to surrender the rights. Therefore, you have\ncertain responsibilities if you distribute copies of the software, or if\nyou modify it: responsibilities to respect the freedom of others.\n\n For example, if you distribute copies of such a program, whether\ngratis or for a fee, you must pass on to the recipients the same\nfreedoms that you received. You must make sure that they, too, receive\nor can get the source code. And you must show them these terms so they\nknow their rights.\n\n Developers that use the GNU GPL protect your rights with two steps:\n(1) assert copyright on the software, and (2) offer you this License\ngiving you legal permission to copy, distribute and/or modify it.\n\n For the developers' and authors' protection, the GPL clearly explains\nthat there is no warranty for this free software. For both users' and\nauthors' sake, the GPL requires that modified versions be marked as\nchanged, so that their problems will not be attributed erroneously to\nauthors of previous versions.\n\n Some devices are designed to deny users access to install or run\nmodified versions of the software inside them, although the manufacturer\ncan do so. This is fundamentally incompatible with the aim of\nprotecting users' freedom to change the software. The systematic\npattern of such abuse occurs in the area of products for individuals to\nuse, which is precisely where it is most unacceptable. Therefore, we\nhave designed this version of the GPL to prohibit the practice for those\nproducts. If such problems arise substantially in other domains, we\nstand ready to extend this provision to those domains in future versions\nof the GPL, as needed to protect the freedom of users.\n\n Finally, every program is threatened constantly by software patents.\nStates should not allow patents to restrict development and use of\nsoftware on general-purpose computers, but in those that do, we wish to\navoid the special danger that patents applied to a free program could\nmake it effectively proprietary. To prevent this, the GPL assures that\npatents cannot be used to render the program non-free.\n\n The precise terms and conditions for copying, distribution and\nmodification follow.\n\n TERMS AND CONDITIONS\n\n 0. Definitions.\n\n \"This License\" refers to version 3 of the GNU General Public License.\n\n \"Copyright\" also means copyright-like laws that apply to other kinds of\nworks, such as semiconductor masks.\n\n \"The Program\" refers to any copyrightable work licensed under this\nLicense. Each licensee is addressed as \"you\". \"Licensees\" and\n\"recipients\" may be individuals or organizations.\n\n To \"modify\" a work means to copy from or adapt all or part of the work\nin a fashion requiring copyright permission, other than the making of an\nexact copy. The resulting work is called a \"modified version\" of the\nearlier work or a work \"based on\" the earlier work.\n\n A \"covered work\" means either the unmodified Program or a work based\non the Program.\n\n To \"propagate\" a work means to do anything with it that, without\npermission, would make you directly or secondarily liable for\ninfringement under applicable copyright law, except executing it on a\ncomputer or modifying a private copy. Propagation includes copying,\ndistribution (with or without modification), making available to the\npublic, and in some countries other activities as well.\n\n To \"convey\" a work means any kind of propagation that enables other\nparties to make or receive copies. Mere interaction with a user through\na computer network, with no transfer of a copy, is not conveying.\n\n An interactive user interface displays \"Appropriate Legal Notices\"\nto the extent that it includes a convenient and prominently visible\nfeature that (1) displays an appropriate copyright notice, and (2)\ntells the user that there is no warranty for the work (except to the\nextent that warranties are provided), that licensees may convey the\nwork under this License, and how to view a copy of this License. If\nthe interface presents a list of user commands or options, such as a\nmenu, a prominent item in the list meets this criterion.\n\n 1. Source Code.\n\n The \"source code\" for a work means the preferred form of the work\nfor making modifications to it. \"Object code\" means any non-source\nform of a work.\n\n A \"Standard Interface\" means an interface that either is an official\nstandard defined by a recognized standards body, or, in the case of\ninterfaces specified for a particular programming language, one that\nis widely used among developers working in that language.\n\n The \"System Libraries\" of an executable work include anything, other\nthan the work as a whole, that (a) is included in the normal form of\npackaging a Major Component, but which is not part of that Major\nComponent, and (b) serves only to enable use of the work with that\nMajor Component, or to implement a Standard Interface for which an\nimplementation is available to the public in source code form. A\n\"Major Component\", in this context, means a major essential component\n(kernel, window system, and so on) of the specific operating system\n(if any) on which the executable work runs, or a compiler used to\nproduce the work, or an object code interpreter used to run it.\n\n The \"Corresponding Source\" for a work in object code form means all\nthe source code needed to generate, install, and (for an executable\nwork) run the object code and to modify the work, including scripts to\ncontrol those activities. However, it does not include the work's\nSystem Libraries, or general-purpose tools or generally available free\nprograms which are used unmodified in performing those activities but\nwhich are not part of the work. For example, Corresponding Source\nincludes interface definition files associated with source files for\nthe work, and the source code for shared libraries and dynamically\nlinked subprograms that the work is specifically designed to require,\nsuch as by intimate data communication or control flow between those\nsubprograms and other parts of the work.\n\n The Corresponding Source need not include anything that users\ncan regenerate automatically from other parts of the Corresponding\nSource.\n\n The Corresponding Source for a work in source code form is that\nsame work.\n\n 2. Basic Permissions.\n\n All rights granted under this License are granted for the term of\ncopyright on the Program, and are irrevocable provided the stated\nconditions are met. This License explicitly affirms your unlimited\npermission to run the unmodified Program. The output from running a\ncovered work is covered by this License only if the output, given its\ncontent, constitutes a covered work. This License acknowledges your\nrights of fair use or other equivalent, as provided by copyright law.\n\n You may make, run and propagate covered works that you do not\nconvey, without conditions so long as your license otherwise remains\nin force. You may convey covered works to others for the sole purpose\nof having them make modifications exclusively for you, or provide you\nwith facilities for running those works, provided that you comply with\nthe terms of this License in conveying all material for which you do\nnot control copyright. Those thus making or running the covered works\nfor you must do so exclusively on your behalf, under your direction\nand control, on terms that prohibit them from making any copies of\nyour copyrighted material outside their relationship with you.\n\n Conveying under any other circumstances is permitted solely under\nthe conditions stated below. Sublicensing is not allowed; section 10\nmakes it unnecessary.\n\n 3. Protecting Users' Legal Rights From Anti-Circumvention Law.\n\n No covered work shall be deemed part of an effective technological\nmeasure under any applicable law fulfilling obligations under article\n11 of the WIPO copyright treaty adopted on 20 December 1996, or\nsimilar laws prohibiting or restricting circumvention of such\nmeasures.\n\n When you convey a covered work, you waive any legal power to forbid\ncircumvention of technological measures to the extent such circumvention\nis effected by exercising rights under this License with respect to\nthe covered work, and you disclaim any intention to limit operation or\nmodification of the work as a means of enforcing, against the work's\nusers, your or third parties' legal rights to forbid circumvention of\ntechnological measures.\n\n 4. Conveying Verbatim Copies.\n\n You may convey verbatim copies of the Program's source code as you\nreceive it, in any medium, provided that you conspicuously and\nappropriately publish on each copy an appropriate copyright notice;\nkeep intact all notices stating that this License and any\nnon-permissive terms added in accord with section 7 apply to the code;\nkeep intact all notices of the absence of any warranty; and give all\nrecipients a copy of this License along with the Program.\n\n You may charge any price or no price for each copy that you convey,\nand you may offer support or warranty protection for a fee.\n\n 5. Conveying Modified Source Versions.\n\n You may convey a work based on the Program, or the modifications to\nproduce it from the Program, in the form of source code under the\nterms of section 4, provided that you also meet all of these conditions:\n\n a) The work must carry prominent notices stating that you modified\n it, and giving a relevant date.\n\n b) The work must carry prominent notices stating that it is\n released under this License and any conditions added under section\n 7. This requirement modifies the requirement in section 4 to\n \"keep intact all notices\".\n\n c) You must license the entire work, as a whole, under this\n License to anyone who comes into possession of a copy. This\n License will therefore apply, along with any applicable section 7\n additional terms, to the whole of the work, and all its parts,\n regardless of how they are packaged. This License gives no\n permission to license the work in any other way, but it does not\n invalidate such permission if you have separately received it.\n\n d) If the work has interactive user interfaces, each must display\n Appropriate Legal Notices; however, if the Program has interactive\n interfaces that do not display Appropriate Legal Notices, your\n work need not make them do so.\n\n A compilation of a covered work with other separate and independent\nworks, which are not by their nature extensions of the covered work,\nand which are not combined with it such as to form a larger program,\nin or on a volume of a storage or distribution medium, is called an\n\"aggregate\" if the compilation and its resulting copyright are not\nused to limit the access or legal rights of the compilation's users\nbeyond what the individual works permit. Inclusion of a covered work\nin an aggregate does not cause this License to apply to the other\nparts of the aggregate.\n\n 6. Conveying Non-Source Forms.\n\n You may convey a covered work in object code form under the terms\nof sections 4 and 5, provided that you also convey the\nmachine-readable Corresponding Source under the terms of this License,\nin one of these ways:\n\n a) Convey the object code in, or embodied in, a physical product\n (including a physical distribution medium), accompanied by the\n Corresponding Source fixed on a durable physical medium\n customarily used for software interchange.\n\n b) Convey the object code in, or embodied in, a physical product\n (including a physical distribution medium), accompanied by a\n written offer, valid for at least three years and valid for as\n long as you offer spare parts or customer support for that product\n model, to give anyone who possesses the object code either (1) a\n copy of the Corresponding Source for all the software in the\n product that is covered by this License, on a durable physical\n medium customarily used for software interchange, for a price no\n more than your reasonable cost of physically performing this\n conveying of source, or (2) access to copy the\n Corresponding Source from a network server at no charge.\n\n c) Convey individual copies of the object code with a copy of the\n written offer to provide the Corresponding Source. This\n alternative is allowed only occasionally and noncommercially, and\n only if you received the object code with such an offer, in accord\n with subsection 6b.\n\n d) Convey the object code by offering access from a designated\n place (gratis or for a charge), and offer equivalent access to the\n Corresponding Source in the same way through the same place at no\n further charge. You need not require recipients to copy the\n Corresponding Source along with the object code. If the place to\n copy the object code is a network server, the Corresponding Source\n may be on a different server (operated by you or a third party)\n that supports equivalent copying facilities, provided you maintain\n clear directions next to the object code saying where to find the\n Corresponding Source. Regardless of what server hosts the\n Corresponding Source, you remain obligated to ensure that it is\n available for as long as needed to satisfy these requirements.\n\n e) Convey the object code using peer-to-peer transmission, provided\n you inform other peers where the object code and Corresponding\n Source of the work are being offered to the general public at no\n charge under subsection 6d.\n\n A separable portion of the object code, whose source code is excluded\nfrom the Corresponding Source as a System Library, need not be\nincluded in conveying the object code work.\n\n A \"User Product\" is either (1) a \"consumer product\", which means any\ntangible personal property which is normally used for personal, family,\nor household purposes, or (2) anything designed or sold for incorporation\ninto a dwelling. In determining whether a product is a consumer product,\ndoubtful cases shall be resolved in favor of coverage. For a particular\nproduct received by a particular user, \"normally used\" refers to a\ntypical or common use of that class of product, regardless of the status\nof the particular user or of the way in which the particular user\nactually uses, or expects or is expected to use, the product. A product\nis a consumer product regardless of whether the product has substantial\ncommercial, industrial or non-consumer uses, unless such uses represent\nthe only significant mode of use of the product.\n\n \"Installation Information\" for a User Product means any methods,\nprocedures, authorization keys, or other information required to install\nand execute modified versions of a covered work in that User Product from\na modified version of its Corresponding Source. The information must\nsuffice to ensure that the continued functioning of the modified object\ncode is in no case prevented or interfered with solely because\nmodification has been made.\n\n If you convey an object code work under this section in, or with, or\nspecifically for use in, a User Product, and the conveying occurs as\npart of a transaction in which the right of possession and use of the\nUser Product is transferred to the recipient in perpetuity or for a\nfixed term (regardless of how the transaction is characterized), the\nCorresponding Source conveyed under this section must be accompanied\nby the Installation Information. But this requirement does not apply\nif neither you nor any third party retains the ability to install\nmodified object code on the User Product (for example, the work has\nbeen installed in ROM).\n\n The requirement to provide Installation Information does not include a\nrequirement to continue to provide support service, warranty, or updates\nfor a work that has been modified or installed by the recipient, or for\nthe User Product in which it has been modified or installed. Access to a\nnetwork may be denied when the modification itself materially and\nadversely affects the operation of the network or violates the rules and\nprotocols for communication across the network.\n\n Corresponding Source conveyed, and Installation Information provided,\nin accord with this section must be in a format that is publicly\ndocumented (and with an implementation available to the public in\nsource code form), and must require no special password or key for\nunpacking, reading or copying.\n\n 7. Additional Terms.\n\n \"Additional permissions\" are terms that supplement the terms of this\nLicense by making exceptions from one or more of its conditions.\nAdditional permissions that are applicable to the entire Program shall\nbe treated as though they were included in this License, to the extent\nthat they are valid under applicable law. If additional permissions\napply only to part of the Program, that part may be used separately\nunder those permissions, but the entire Program remains governed by\nthis License without regard to the additional permissions.\n\n When you convey a copy of a covered work, you may at your option\nremove any additional permissions from that copy, or from any part of\nit. (Additional permissions may be written to require their own\nremoval in certain cases when you modify the work.) You may place\nadditional permissions on material, added by you to a covered work,\nfor which you have or can give appropriate copyright permission.\n\n Notwithstanding any other provision of this License, for material you\nadd to a covered work, you may (if authorized by the copyright holders of\nthat material) supplement the terms of this License with terms:\n\n a) Disclaiming warranty or limiting liability differently from the\n terms of sections 15 and 16 of this License; or\n\n b) Requiring preservation of specified reasonable legal notices or\n author attributions in that material or in the Appropriate Legal\n Notices displayed by works containing it; or\n\n c) Prohibiting misrepresentation of the origin of that material, or\n requiring that modified versions of such material be marked in\n reasonable ways as different from the original version; or\n\n d) Limiting the use for publicity purposes of names of licensors or\n authors of the material; or\n\n e) Declining to grant rights under trademark law for use of some\n trade names, trademarks, or service marks; or\n\n f) Requiring indemnification of licensors and authors of that\n material by anyone who conveys the material (or modified versions of\n it) with contractual assumptions of liability to the recipient, for\n any liability that these contractual assumptions directly impose on\n those licensors and authors.\n\n All other non-permissive additional terms are considered \"further\nrestrictions\" within the meaning of section 10. If the Program as you\nreceived it, or any part of it, contains a notice stating that it is\ngoverned by this License along with a term that is a further\nrestriction, you may remove that term. If a license document contains\na further restriction but permits relicensing or conveying under this\nLicense, you may add to a covered work material governed by the terms\nof that license document, provided that the further restriction does\nnot survive such relicensing or conveying.\n\n If you add terms to a covered work in accord with this section, you\nmust place, in the relevant source files, a statement of the\nadditional terms that apply to those files, or a notice indicating\nwhere to find the applicable terms.\n\n Additional terms, permissive or non-permissive, may be stated in the\nform of a separately written license, or stated as exceptions;\nthe above requirements apply either way.\n\n 8. Termination.\n\n You may not propagate or modify a covered work except as expressly\nprovided under this License. Any attempt otherwise to propagate or\nmodify it is void, and will automatically terminate your rights under\nthis License (including any patent licenses granted under the third\nparagraph of section 11).\n\n However, if you cease all violation of this License, then your\nlicense from a particular copyright holder is reinstated (a)\nprovisionally, unless and until the copyright holder explicitly and\nfinally terminates your license, and (b) permanently, if the copyright\nholder fails to notify you of the violation by some reasonable means\nprior to 60 days after the cessation.\n\n Moreover, your license from a particular copyright holder is\nreinstated permanently if the copyright holder notifies you of the\nviolation by some reasonable means, this is the first time you have\nreceived notice of violation of this License (for any work) from that\ncopyright holder, and you cure the violation prior to 30 days after\nyour receipt of the notice.\n\n Termination of your rights under this section does not terminate the\nlicenses of parties who have received copies or rights from you under\nthis License. If your rights have been terminated and not permanently\nreinstated, you do not qualify to receive new licenses for the same\nmaterial under section 10.\n\n 9. Acceptance Not Required for Having Copies.\n\n You are not required to accept this License in order to receive or\nrun a copy of the Program. Ancillary propagation of a covered work\noccurring solely as a consequence of using peer-to-peer transmission\nto receive a copy likewise does not require acceptance. However,\nnothing other than this License grants you permission to propagate or\nmodify any covered work. These actions infringe copyright if you do\nnot accept this License. Therefore, by modifying or propagating a\ncovered work, you indicate your acceptance of this License to do so.\n\n 10. Automatic Licensing of Downstream Recipients.\n\n Each time you convey a covered work, the recipient automatically\nreceives a license from the original licensors, to run, modify and\npropagate that work, subject to this License. You are not responsible\nfor enforcing compliance by third parties with this License.\n\n An \"entity transaction\" is a transaction transferring control of an\norganization, or substantially all assets of one, or subdividing an\norganization, or merging organizations. If propagation of a covered\nwork results from an entity transaction, each party to that\ntransaction who receives a copy of the work also receives whatever\nlicenses to the work the party's predecessor in interest had or could\ngive under the previous paragraph, plus a right to possession of the\nCorresponding Source of the work from the predecessor in interest, if\nthe predecessor has it or can get it with reasonable efforts.\n\n You may not impose any further restrictions on the exercise of the\nrights granted or affirmed under this License. For example, you may\nnot impose a license fee, royalty, or other charge for exercise of\nrights granted under this License, and you may not initiate litigation\n(including a cross-claim or counterclaim in a lawsuit) alleging that\nany patent claim is infringed by making, using, selling, offering for\nsale, or importing the Program or any portion of it.\n\n 11. Patents.\n\n A \"contributor\" is a copyright holder who authorizes use under this\nLicense of the Program or a work on which the Program is based. The\nwork thus licensed is called the contributor's \"contributor version\".\n\n A contributor's \"essential patent claims\" are all patent claims\nowned or controlled by the contributor, whether already acquired or\nhereafter acquired, that would be infringed by some manner, permitted\nby this License, of making, using, or selling its contributor version,\nbut do not include claims that would be infringed only as a\nconsequence of further modification of the contributor version. For\npurposes of this definition, \"control\" includes the right to grant\npatent sublicenses in a manner consistent with the requirements of\nthis License.\n\n Each contributor grants you a non-exclusive, worldwide, royalty-free\npatent license under the contributor's essential patent claims, to\nmake, use, sell, offer for sale, import and otherwise run, modify and\npropagate the contents of its contributor version.\n\n In the following three paragraphs, a \"patent license\" is any express\nagreement or commitment, however denominated, not to enforce a patent\n(such as an express permission to practice a patent or covenant not to\nsue for patent infringement). To \"grant\" such a patent license to a\nparty means to make such an agreement or commitment not to enforce a\npatent against the party.\n\n If you convey a covered work, knowingly relying on a patent license,\nand the Corresponding Source of the work is not available for anyone\nto copy, free of charge and under the terms of this License, through a\npublicly available network server or other readily accessible means,\nthen you must either (1) cause the Corresponding Source to be so\navailable, or (2) arrange to deprive yourself of the benefit of the\npatent license for this particular work, or (3) arrange, in a manner\nconsistent with the requirements of this License, to extend the patent\nlicense to downstream recipients. \"Knowingly relying\" means you have\nactual knowledge that, but for the patent license, your conveying the\ncovered work in a country, or your recipient's use of the covered work\nin a country, would infringe one or more identifiable patents in that\ncountry that you have reason to believe are valid.\n\n If, pursuant to or in connection with a single transaction or\narrangement, you convey, or propagate by procuring conveyance of, a\ncovered work, and grant a patent license to some of the parties\nreceiving the covered work authorizing them to use, propagate, modify\nor convey a specific copy of the covered work, then the patent license\nyou grant is automatically extended to all recipients of the covered\nwork and works based on it.\n\n A patent license is \"discriminatory\" if it does not include within\nthe scope of its coverage, prohibits the exercise of, or is\nconditioned on the non-exercise of one or more of the rights that are\nspecifically granted under this License. You may not convey a covered\nwork if you are a party to an arrangement with a third party that is\nin the business of distributing software, under which you make payment\nto the third party based on the extent of your activity of conveying\nthe work, and under which the third party grants, to any of the\nparties who would receive the covered work from you, a discriminatory\npatent license (a) in connection with copies of the covered work\nconveyed by you (or copies made from those copies), or (b) primarily\nfor and in connection with specific products or compilations that\ncontain the covered work, unless you entered into that arrangement,\nor that patent license was granted, prior to 28 March 2007.\n\n Nothing in this License shall be construed as excluding or limiting\nany implied license or other defenses to infringement that may\notherwise be available to you under applicable patent law.\n\n 12. No Surrender of Others' Freedom.\n\n If conditions are imposed on you (whether by court order, agreement or\notherwise) that contradict the conditions of this License, they do not\nexcuse you from the conditions of this License. If you cannot convey a\ncovered work so as to satisfy simultaneously your obligations under this\nLicense and any other pertinent obligations, then as a consequence you may\nnot convey it at all. For example, if you agree to terms that obligate you\nto collect a royalty for further conveying from those to whom you convey\nthe Program, the only way you could satisfy both those terms and this\nLicense would be to refrain entirely from conveying the Program.\n\n 13. Use with the GNU Affero General Public License.\n\n Notwithstanding any other provision of this License, you have\npermission to link or combine any covered work with a work licensed\nunder version 3 of the GNU Affero General Public License into a single\ncombined work, and to convey the resulting work. The terms of this\nLicense will continue to apply to the part which is the covered work,\nbut the special requirements of the GNU Affero General Public License,\nsection 13, concerning interaction through a network will apply to the\ncombination as such.\n\n 14. Revised Versions of this License.\n\n The Free Software Foundation may publish revised and/or new versions of\nthe GNU General Public License from time to time. Such new versions will\nbe similar in spirit to the present version, but may differ in detail to\naddress new problems or concerns.\n\n Each version is given a distinguishing version number. If the\nProgram specifies that a certain numbered version of the GNU General\nPublic License \"or any later version\" applies to it, you have the\noption of following the terms and conditions either of that numbered\nversion or of any later version published by the Free Software\nFoundation. If the Program does not specify a version number of the\nGNU General Public License, you may choose any version ever published\nby the Free Software Foundation.\n\n If the Program specifies that a proxy can decide which future\nversions of the GNU General Public License can be used, that proxy's\npublic statement of acceptance of a version permanently authorizes you\nto choose that version for the Program.\n\n Later license versions may give you additional or different\npermissions. However, no additional obligations are imposed on any\nauthor or copyright holder as a result of your choosing to follow a\nlater version.\n\n 15. Disclaimer of Warranty.\n\n THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY\nAPPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT\nHOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM \"AS IS\" WITHOUT WARRANTY\nOF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,\nTHE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\nPURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM\nIS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF\nALL NECESSARY SERVICING, REPAIR OR CORRECTION.\n\n 16. Limitation of Liability.\n\n IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING\nWILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS\nTHE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY\nGENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE\nUSE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF\nDATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD\nPARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),\nEVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGES.\n\n 17. Interpretation of Sections 15 and 16.\n\n If the disclaimer of warranty and limitation of liability provided\nabove cannot be given local legal effect according to their terms,\nreviewing courts shall apply local law that most closely approximates\nan absolute waiver of all civil liability in connection with the\nProgram, unless a warranty or assumption of liability accompanies a\ncopy of the Program in return for a fee.\n\n END OF TERMS AND CONDITIONS\n\n How to Apply These Terms to Your New Programs\n\n If you develop a new program, and you want it to be of the greatest\npossible use to the public, the best way to achieve this is to make it\nfree software which everyone can redistribute and change under these terms.\n\n To do so, attach the following notices to the program. It is safest\nto attach them to the start of each source file to most effectively\nstate the exclusion of warranty; and each file should have at least\nthe \"copyright\" line and a pointer to where the full notice is found.\n\n \n Copyright (C) \n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation, either version 3 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License\n along with this program. If not, see .\n\nAlso add information on how to contact you by electronic and paper mail.\n\n If the program does terminal interaction, make it output a short\nnotice like this when it starts in an interactive mode:\n\n Copyright (C) \n This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.\n This is free software, and you are welcome to redistribute it\n under certain conditions; type `show c' for details.\n\nThe hypothetical commands `show w' and `show c' should show the appropriate\nparts of the General Public License. Of course, your program's commands\nmight be different; for a GUI interface, you would use an \"about box\".\n\n You should also get your employer (if you work as a programmer) or school,\nif any, to sign a \"copyright disclaimer\" for the program, if necessary.\nFor more information on this, and how to apply and follow the GNU GPL, see\n.\n\n The GNU General Public License does not permit incorporating your program\ninto proprietary programs. If your program is a subroutine library, you\nmay consider it more useful to permit linking proprietary applications with\nthe library. If this is what you want to do, use the GNU Lesser General\nPublic License instead of this License. But first, please read\n.\n" }, { "path": "README.md", "content": "\n## 项目简介\n\n本项目采用 SpringBoot 框架构建，致力于为 SpringBoot 应用程序的开发提升开发效率及编程体验。\n\n本项目由多个子项目组成，每个子项目聚焦解决一个问题。\n这里先简单介绍下这些子项目：\n* [commons-api2doc](https://github.com/terran4j/commons/tree/master/commons-api2doc): \n 简称 Api2Doc，是一款 Http API 文档自动化生成工具，\n 它通过反射的方式，读取 Controller 类的信息，\n 然后自动生成易于阅读的在线 API 文档，节省开发者手工编写 API 文档的工作量。\n* [commons-restpack](https://github.com/terran4j/commons/tree/master/commons-restpack): \n 简称 RestPack，是一款 Http API 数据包装框架，\n 它可以将 Http API 的返回结果包装成统一的报文格式。\n* [commons-dsql](https://github.com/terran4j/commons/tree/master/commons-dsql): \n 简称 DSQL，是一款从 SQL 到对象的自动映射框架，它尤其擅长动态复杂 SQL 的处理。\n 它结合了现在两大主流持久层框架 JPA 及 MyBatis 的优点，\n 从而更进一步的提高了持久层的开发效率。\n* [commons-hedis](https://github.com/terran4j/commons/tree/master/commons-hedis): \n 简称 Hedis，是 Happy for using Redis 之意，目标是让 Redis 使用起来更容易。\n Hedis 集成了 spring-data-redis， Jedis，Redisson 等 Redis 客户端框架，\n 并用它们解决一些具体的问题，如：分布式同步、轻量级分布式定时调度等。 \n \n\n## 适用用户\n\n适合有 Java / Kotlin + SpringBoot 开发经验的开发者们使用。\n\n如果您有 Java 开发经验但对Spring Boot 还不熟悉的话，建议先阅读笔者写过的一本书\n[《Spring Boot 快速入门》](http://www.jianshu.com/nb/14688855?order_by=seq)。\n这本书的目标是帮助有 Java 开发经验的程序员们快速掌握 Spring Boot 开发技巧，\n感受到 Spring Boot 的极简开发风格及超爽编程体验。\n\n\n## 软件版本\n\n本项目中所用到的基础软件，均基于以下版本构建：\n* Java: 1.8\n* Maven: 3.3.9\n* SpringBoot: 1.5.9.RELEASE\n\n本项目及所有子项目均在以上版本测试过，可以正常运行。\n其它版本理论上相同，应该没啥区别，若遇到问题，欢迎反馈！\n" }, { "path": "build.txt", "content": "\n## 统一修改版本号\nmvn versions:set \"-DnewVersion=1.0.2-SNAPSHOT\"\nmvn versions:commit\n\n## 当版本为 SNAPSHOT 时的测试：\nmvn clean test\n\n## 当版本为 SNAPSHOT 时的部署：\nmvn clean deploy -DskipTests\n\n## 本地构建打包。\nmvn clean install -DskipTests\n\n## 所有项目一起部署太慢了，容易失败，所有分开部署：\n## 建议在早上 10:00 以后执行（这会美国是晚上，网络稍好点）\nmvn clean deploy -DskipTests -P release -pl commons-util -am // 03:33\nmvn clean deploy -DskipTests -P release -pl commons-website // 02:27\nmvn clean deploy -DskipTests -P release -pl commons-restpack // 02:11\nmvn clean deploy -DskipTests -P release -pl commons-api2doc // 12:58\nmvn clean deploy -DskipTests -P release -pl commons-hedis // 03:05\nmvn clean deploy -DskipTests -P release -pl commons-hi // 03:12\nmvn clean deploy -DskipTests -P release -pl commons-test // 02:00\nmvn clean deploy -DskipTests -P release -pl commons-dsql // 03:14" }, { "path": "commons-api2doc/.gitignore", "content": "/target/\n/.settings/\n/.classpath\n/.project\n*.iml\n" }, { "path": "commons-api2doc/README.md", "content": "\n本文介绍一个非常好用的自动化生成 Restful API 文档的工具——Api2Doc\n它基于 SpringBoot ，原理类似于 Swagger2，但比 Swagger2 要简单好用。\n\n此项目已经放到 github 中，需要源码的朋友请点击\n[这里](https://github.com/terran4j/commons/tree/master/commons-api2doc)\n\n## 目录\n\n* 项目背景\n* Api2Doc 简介\n* 引入 Api2Doc 依赖\n* 启用 Api2Doc 服务\n* 给 Controller 类上添加文档注解\n* @Api2Doc 注解详述\n* @ApiComment 注解详述\n* @ApiError 注解详述\n* 给文档菜单项排序\n* 补充自定义文档\n* 定制文档的欢迎页\n* 定制文档的标题及图标\n* 关闭 Api2Doc 服务\n* 后续开发计划\n\n## 项目背景\n\n在互联网/移动互联网软件的研发过程中，大多数研发团队前后台分工是非常明确的，\n后台工程师负责服务端系统的开发，一般是提供 HTTP/HTTPS 的 Restful API 接口，\n前端工程师则负责 Android、iOS、H5页面的开发，需要调用 Restful API 接口。\n\n这就需要有一套 Restful API 文档，以帮助两方在 API 接口进行沟通，并达成一致意见。\n一般情况下，编写文档的工作都会落在后台工程师身上，毕竟 API 是他们提供的嘛。\n\n但问题是，编写 Restful API 文档是一件既繁琐、又费时、还对提高技术能力没啥帮助的苦差事，\n尤其在是快速迭代、需求频繁修改的项目中，改了代码还要同步改文档，\n哪点改错了或改漏了都可能产生前后端实现的不一致，导致联调时发现 BUG，\n这个锅最终还是要后台工程师来背（宝宝心里苦啊...）。\n\n因此，业界就出现了一些**根据代码自动生成 Restful API 文档**的开源项目，\n与 Spring Boot 结合比较好的是 Swagger2，Swagger2 通过读取 Controller \n代码中的注解信息，来自动生成 API 文档，可以节省大量的手工编写文档的工作量。\n\n本项目作者之前也是用的 Swagger2，但发现 Swagger2 也有好多地方用得不爽：\n\n第一，**Swagger2 的注解非常臃肿**，我们看下这段代码：\n\n```java\n\n@RestController\n@RequestMapping(value = \"/user3\")\npublic class UserController2Swagger2 {\n\n @ApiOperation(value = \"获取指定id用户详细信息\",\n notes = \"根据user的id来获取用户详细信息\",\n httpMethod = \"GET\")\n @ApiImplicitParams({\n @ApiImplicitParam(name = \"userName\", value = \"用户名\",\n paramType = \"query\", required = true, dataType = \"String\"),\n @ApiImplicitParam(name = \"password\", value = \"用户密码\",\n paramType = \"query\", required = true, dataType = \"String\")\n })\n @RequestMapping(name = \"用户注册\", value = \"/regist\",\n method = RequestMethod.GET)\n public UserInfo regist(@RequestParam(\"userName\") String userName,\n @RequestParam(\"password\") String password) {\n return new UserInfo();\n }\n}\n```\n\n@ApiOperation、@ApiImplicitParam 都是 Swagger2 提供的注解，用于定义 API 信息。\n其实，API 方法本身就包含了很多信息，如HTTP Method、参数名、参数类型等等，\n像 @ApiImplicitParam 中除了 value 属性有用外，其它都是重复描述。\n\n\n第二，Swagger2 的页面排版不太友好，它是一个垂直排列的方式，不利于信息的展示。\n并且看 API 详细信息还要一个个展开，中间还夹杂着测试的功能，反正作为文档是不易于阅读；\n至于作为测试工具嘛...，现在专业的测试工具也有很多，测试人员好像也不选它。\n\n第三，Swagger2 还有好多细节没做好，比如看这个图：\n\n![swgger2-1.png](http://upload-images.jianshu.io/upload_images/4489584-575b3f94d746d921.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n\n红框中的 API 其实对应的是同一个方法，之所以有这么多，只是因为写这个方法\n时没有指定 method：\n\n```java\n@RestController\n@RequestMapping(value = \"/user2\")\npublic class UserController2Swagger2 {\n \n @RequestMapping(value = \"/do_something\")\n public void doSomethingRequiredLogon() {\n }\n \n // 其它方法，这里省略...\n}\n``` \n\n（当没指定 method 时，Spring Boot 会默认让这个接口支持所有的 method）\n\n因此，考虑到与其长长久久忍受 Swagger2 的各种不爽，不如花些时间做一个\n更好用的“自动化文档系统”，于是就诞生了本项目： Api2Doc 。 \n\n\n## Api2Doc 简介\n\nApi2Doc 专注于 Restful API 文档的自动生成，它的原理与 Swagger2 是类似的，\n都是通过反射，分析 Controller 中的信息生成文档，但它要比 Swagger2 好很多。\n\n最大的不同是： **Api2Doc 比 Swagger2 要少写很多代码**。\n\n举个例子，使用 Swagger2 的代码是这样的：\n\n```java\n\n@RestController\n@RequestMapping(value = \"/user\")\npublic class UserController {\n\n @ApiOperation(value = \"添加用户\", httpMethod = \"POST\",\n notes = \"向用户组中添加用户，可以指定用户的类型\")\n @ApiImplicitParams({\n @ApiImplicitParam(name = \"group\", value = \"用户组名\",\n paramType = \"query\", required = true, dataType = \"String\"),\n @ApiImplicitParam(name = \"name\", value = \"用户名\",\n paramType = \"query\", required = true, dataType = \"String\"),\n @ApiImplicitParam(name = \"type\", value = \"用户类型\",\n paramType = \"query\", required = true, dataType = \"String\")\n })\n @RequestMapping(value = \"/addUser\", method = RequestMethod.POST)\n public User addUser(String group, String name, String type) {\n return null; // TODO: 还未实现。\n }\n}\n```\n\n我们看下使用 Api2Doc 注解修饰后的代码：\n\n```java\n@Api2Doc(id = \"users\")\n@ApiComment(seeClass = User.class)\n@RestController\n@RequestMapping(value = \"/api2doc/demo2\")\npublic class UserController2 {\n\n @ApiComment(\"添加一个新的用户。\")\n @RequestMapping(name = \"新增用户\",\n value = \"/user\", method = RequestMethod.POST)\n public User addUser(String group, String name, String type) {\n return null; // TODO: 还未实现。\n }\n \n // 其它方法，这里省略...\n}\n```\n\n看，Api2Doc 仅需要在方法上加上 @Api2Doc @ApiComment 注解等极少数代码，\n但它生成的文档可一点不含糊，如下图所示：\n\n![api2doc-2-1.png](http://upload-images.jianshu.io/upload_images/4489584-98f94cb360c0ccde.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n![api2doc-2-2.png](http://upload-images.jianshu.io/upload_images/4489584-fedf2897f5c217b1.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n\n有的朋友可能会觉得很奇怪：文档页面上的说明、示例值等内容，在代码中没有写啊，\n这些是哪来的呢？\n\n这里涉及到 Api2Doc 的核心设计理念，就是：它尽可能通过智能分析，自动收集\n生成文档所需的信息，从而**让用户少写代码**。\n\n说得有点抽象哈，下面我们来正面回答这个问题，请大家注意这个类上有一个注解：\n\n```\n@ApiComment(seeClass = User.class)\n```\n\n它意思是： 在 API 方法上遇到没写说明信息时，请参照 User 类中的定义的说明信息。\n\n下面是 User 类的代码：\n\n```java\npublic class User {\n\n @ApiComment(value = \"用户id\", sample = \"123\")\n private Long id;\n\n @ApiComment(value = \"用户名\", sample = \"terran4j\")\n private String name;\n\n @ApiComment(value = \"账号密码\", sample = \"sdfi23skvs\")\n private String password;\n\n @ApiComment(value = \"用户所在的组\", sample = \"研发组\")\n private String group;\n\n @ApiComment(value = \"用户类型\", sample = \"admin\")\n private UserType type;\n\n @ApiComment(value = \"是否已删除\", sample = \"true\")\n @RestPackIgnore\n private Boolean deleted;\n\n @ApiComment(value = \"创建时间\\n也是注册时间。\")\n private Date createTime;\n\n // 省略 getter / setter 方法。\n}\n```\n\n大家看明白了没？ API 方法中的参数，如果与 User 类的属性同名的话，就用类\n属性的 @ApiComment 说明信息自动填充。\n\n其实这也符合实际的业务逻辑。因为在大部分项目中，有的字段会在多个实体类、\n多个 API 方法中用到，完全没有必要重复编写其说明信息，只要有一个地方定义好了，\n然后其它地方参照就行了。\n\n当然，这只是 Api2Doc 比 Swagger2 好用的特性之一，还有不少比 Swagger2 好用的地方。\n\n下面我们就来全面讲解它的用法，希望可以帮助开发者们从文档编写的苦海中解脱出来。\n\n\n## 引入 Api2Doc 依赖\n\n如果是 maven ，请在 pom.xml 中添加依赖，如下所示：\n\n```xml\n \n com.github.terran4j\n terran4j-commons-api2doc\n ${api2doc.version}\n \n```\n\n如果是 gradle，请在 build.gradle 中添加依赖，如下所示：\n\n```groovy\ncompile \"com.github.terran4j:terran4j-commons-api2doc:${api2doc.version}\"\n```\n\n${api2doc.version} **最新稳定版，请参考 [这里](https://github.com/terran4j/commons/blob/master/version.md)**\n\n\n## 启用 Api2Doc 服务\n\n本教程的示例代码在 src/test/java 目录的 com.terran4j.demo.api2doc 中，\n您也可以从 [这里](https://github.com/terran4j/commons/tree/master/commons-api2doc/src/test/java/com/terran4j/demo/api2doc) 获取到。\n\n首先，我们需要在有 @SpringBootApplication 注解的类上，添加 @EnableApi2Doc \n注解，以启用 Api2Doc 服务，如下代码所示：\n\n```java\npackage com.terran4j.demo.api2doc;\n\nimport com.terran4j.commons.api2doc.config.EnableApi2Doc;\nimport org.springframework.boot.SpringApplication;\nimport org.springframework.boot.autoconfigure.SpringBootApplication;\n\n// 文档访问地址： http://localhost:8080/api2doc/home.html\n@EnableApi2Doc\n@SpringBootApplication\npublic class Api2DocDemoApp {\n\n public static void main(String[] args) {\n SpringApplication.run(Api2DocDemoApp.class, args);\n }\n\n}\n``` \n\n## 给 Controller 类上添加文档注解\n\n然后我们在 RestController 类添加 @Api2Doc 注解，在需要有文档说明的地方\n添加 @ApiComment 注解即可，如下所示：\n\n```java\npackage com.terran4j.demo.api2doc;\n\nimport com.terran4j.commons.api2doc.annotations.Api2Doc;\nimport com.terran4j.commons.api2doc.annotations.ApiComment;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RequestMethod;\nimport org.springframework.web.bind.annotation.RestController;\n\n@Api2Doc(id = \"demo1\", name = \"用户接口1\")\n@ApiComment(seeClass = User.class)\n@RestController\n@RequestMapping(value = \"/api2doc/demo1\")\npublic class UserController1 {\n\n @ApiComment(\"添加一个新的用户。\")\n @RequestMapping(name = \"新增用户\",\n value = \"/user\", method = RequestMethod.POST)\n public User addUser(String group, String name,\n @ApiComment(\"用户类型\") UserType type) {\n return null; // TODO: 还未实现。\n }\n}\n```\n\n这个方法的返回类型 User 类的定义为：\n\n```java\npublic class User {\n\n @ApiComment(value = \"用户id\", sample = \"123\")\n private Long id;\n\n @ApiComment(value = \"用户名\", sample = \"terran4j\")\n private String name;\n\n @ApiComment(value = \"账号密码\", sample = \"sdfi23skvs\")\n private String password;\n\n @ApiComment(value = \"用户所在的组\", sample = \"研发组\")\n private String group;\n\n @ApiComment(value = \"用户类型\", sample = \"admin\")\n private UserType type;\n\n @ApiComment(value = \"是否已删除\", sample = \"true\")\n @RestPackIgnore\n private Boolean deleted;\n\n @ApiComment(value = \"创建时间\\n也是注册时间。\")\n private Date createTime;\n\n // 省略 getter / setter 方法。\n}\n```\n\n以及 type 属性的类型，也就是 UserType 类的定义为：\n\n```java\npackage com.terran4j.demo.api2doc;\n\nimport com.terran4j.commons.api2doc.annotations.ApiComment;\n\npublic enum UserType {\n\n @ApiComment(\"管理员\")\n admin,\n\n @ApiComment(\"普通用户\")\n user\n}\n```\n\n编写好代码后，我们运行 main 函数，访问 Api2Doc 的主页面：\n\n```\nhttp://localhost:8080/api2doc/home.html\n```\n\n文档页面如下：\n\n![api2doc-3-1.png](http://upload-images.jianshu.io/upload_images/4489584-ef8f5a56917da47f.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n![api2doc-3-2.png](http://upload-images.jianshu.io/upload_images/4489584-55ea3a295a009855.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n\n说明 Api2Doc 服务起作用了，就是这么简单！\n\n\n## @Api2Doc 注解详述\n\nApi2Doc 一共有 3 个注解：@Api2Doc、@ApiComment 及 @ApiError 。\n\n@Api2Doc 用于对文档的生成进行控制。\n\n@Api2Doc 修饰在类上，表示这个类会参与到文档生成过程中，Api2Doc 服务\n会扫描 Spring 容器中所有的 Controller 类，只有类上有 @Api2Doc 的类，\n才会被生成文档，一个类对应于文档页面左侧的一级菜单项，@Api2Doc 的 \nname 属性则表示这个菜单项的名称。\n\n@Api2Doc 也可以修饰在方法，不过在方法上的 @Api2Doc 通常是可以省略，\n Api2Doc 服务会扫描这个类的所有带有 @RequestMapping 的方法，\n 每个这样的方法对应文档页面的左侧的二级菜单项， 菜单项的名称取 \n @RequestMapping 的 name 属性，当然您仍然可以在方法上用 @Api2Doc \n 的 name 属性进行重定义。\n \n \n ## @ApiComment 注解详述\n \n @ApiComment 用于对 API 进行说明，它可以修饰在很多地方：\n * 修饰在类上，表示对这组 API 接口进行说明；\n * 修饰在方法上，表示对这个 API 接口进行说明；\n * 修饰在参数上，表示对这个 API 接口的请求参数进行说明；\n * 修饰在返回类型的属性上，表示对这个 API 接口的返回字段进行说明；\n * 修饰在枚举项上，表示对枚举项进行说明；\n\n如果相同名称、相同意义的属性或参数字段，其说明已经在别的地方定义过了，\n可以用 @ApiComment 的 seeClass 属性表示采用指定类的同名字段上的说明信息，\n所以如这段代码：\n\n```java\n@Api2Doc(id = \"demo1\", name = \"用户接口1\")\n@ApiComment(seeClass = User.class)\n@RestController\n@RequestMapping(value = \"/api2doc/demo1\")\npublic class UserController1 {\n\n @ApiComment(\"添加一个新的用户。\")\n @RequestMapping(name = \"新增用户\",\n value = \"/user\", method = RequestMethod.POST)\n public User addUser(String group, String name, UserType type) {\n return null; // TODO: 还未实现。\n }\n}\n```\n\n虽然 group, name ,type 三个参数没有用 @ApiComment 进行说明，\n但由于这个类上有 @ApiComment(seeClass = User.class) ，\n因此只要 User 类中有 group, name ,type 字段并且有 @ApiComment 的说明就行了。\n\n\n## @ApiError 注解详述\n\n@ApiError 用于定义错误码，有的 API 方法在执行业务逻辑时会产生错误，\n出错后会在返回报文包含错误码，以方便客户端根据错误码作进一步的处理，\n因此也需要在 API 文档上体现错误码的说明。\n\n如下代码演示了 @ApiError 的用法：\n\n```java\n@Api2Doc(id = \"demo\", name = \"用户接口\", order = 0)\n@ApiComment(seeClass = User.class)\n@RestController\n@RequestMapping(value = \"/src/test/resources/demo\")\npublic class UserController {\n \n @Api2Doc(order = 50)\n @ApiComment(\"根据用户id，删除指定的用户\")\n @ApiError(value = \"user.not.found\", comment = \"此用户不存在！\")\n @ApiError(value = \"admin.cant.delete\", comment = \"不允许删除管理员用户！\")\n @RequestMapping(name = \"删除指定用户\",\n value = \"/user/{id}\", method = RequestMethod.DELETE)\n public void delete(@PathVariable(\"id\") Long id) {\n }\n}\n```\n\n@ApiError 的 value 属性表示错误码，comment 表示错误码的说明。\n\n错误码信息会显示在文档的最后面，效果如下所示：\n\n![api2doc-7.png](http://upload-images.jianshu.io/upload_images/4489584-44a77bbb3c1e84da.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n\n\n## 给文档菜单项排序\n\n我们可以用 @Api2Doc 中的 order 属性给菜单项排序，order 的值越小，\n该菜单项就越排在前面，比如对于这段代码：\n\n```java\npackage com.terran4j.demo.api2doc;\n\nimport com.terran4j.commons.api2doc.annotations.Api2Doc;\nimport com.terran4j.commons.api2doc.annotations.ApiComment;\nimport org.springframework.web.bind.annotation.PathVariable;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RequestMethod;\nimport org.springframework.web.bind.annotation.RestController;\n\nimport java.util.List;\n\n@Api2Doc(id = \"demo2\", name = \"用户接口2\", order = 1)\n@ApiComment(seeClass = User.class)\n@RestController\n@RequestMapping(value = \"/api2doc/demo2\")\npublic class UserController2 {\n\n @Api2Doc(order = 10)\n @ApiComment(\"添加一个新的用户。\")\n @RequestMapping(name = \"新增用户\",\n value = \"/user\", method = RequestMethod.POST)\n public User addUser(\n @ApiComment(\"用户组名称\") String group,\n @ApiComment(\"用户名称\") String name,\n @ApiComment(\"用户类型\") UserType type) {\n return null; // TODO: 还未实现。\n }\n\n @Api2Doc(order = 20)\n @ApiComment(\"根据用户id，查询此用户的信息\")\n @RequestMapping(name = \"查询单个用户\",\n value = \"/user/{id}\", method = RequestMethod.GET)\n public User getUser(@PathVariable(\"id\") Long id) {\n return null; // TODO: 还未实现。\n }\n\n @Api2Doc(order = 30)\n @ApiComment(\"查询所有用户，按注册时间进行排序。\")\n @RequestMapping(name = \"查询用户列表\",\n value = \"/users\", method = RequestMethod.GET)\n public List getUsers() {\n return null; // TODO: 还未实现。\n }\n\n @Api2Doc(order = 40)\n @ApiComment(\"根据指定的组名称，查询该组中的所有用户信息。\")\n @RequestMapping(name = \"查询用户组\",\n value = \"/group/{group}\", method = RequestMethod.GET)\n public UserGroup getGroup(@PathVariable(\"group\") String group) {\n return null; // TODO: 还未实现。\n }\n}\n```\n\n显示的结果为：\n\n![api2doc-3.png](http://upload-images.jianshu.io/upload_images/4489584-0818fdef543c8c07.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n\n在类上的 @Api2Doc 同样可以给一级菜单排序，规则是一样的，这里就不演示了。\n\n\n## 补充自定义文档\n\n有时候光有自动生成的 API 文档似乎还不太完美，或许我们想补充点别的什么东西，\n比如： 对项目的背景介绍、技术架构说明之类，那这个要怎么弄呢？\n\nApi2Doc 允许用 md 语法手工编写文档，并集成到自动生成的 API 文档之中，方法如下：\n\n首先，要在类上的 @Api2Doc 定义 id 属性，比如对下面这个类：\n\n```java\npackage com.terran4j.demo.api2doc;\n\nimport com.terran4j.commons.api2doc.annotations.Api2Doc;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RestController;\n\n@Api2Doc(id = \"demo3\", name = \"用户接口3\")\n@RestController\n@RequestMapping(value = \"/api2doc/demo3\")\npublic class UserController3 {\n\n @Api2Doc(order = 10)\n @RequestMapping(name = \"接口1\", value = \"/m1\")\n public void m1() {\n }\n\n @Api2Doc(order = 20)\n @RequestMapping(name = \"接口2\", value = \"/m2\")\n public void m2() {\n }\n}\n``` \n\n@Api2Doc(id = \"demo3\", name = \"用户接口3\") 表示：对应的一级菜单“用户接口3”\n的 id 为 demo3。\n\n然后，我们在 src/main/resources 中创建目录 api2doc/demo3，\n前面的 api2doc 是固定的，后面的 demo3 表示这个目录中的文档是添加到\nid 为 demo3 的一级文档菜单下。\n\n然后我们在 api2doc/demo3 目录中编写 md 格式的文档，如下图所示：\n\n![api2doc-4.png](http://upload-images.jianshu.io/upload_images/4489584-a76a84061f2771d3.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n\n文件名的格式为 ${order}-${文档名称}.md，即 - 号前面的数字表示这个文档的排序，\n与 @Api2Doc 中的 order 属性是一样的，而 - 号后面是文档名称，也就是二级菜单的名称。\n\n因此，最后文档的显示效果为：\n\n![api2doc-5.png](http://upload-images.jianshu.io/upload_images/4489584-73814ce5bde91b2d.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n\n看，手工编写的补充文档与自动生成的 API 文档，通过 order 进行排序组合在一起，\n看起来毫无违和感。\n\n\n## 定制文档的欢迎页\n\n每次访问文档页面 http://localhost:8080/api2doc/home.html 时，\n中间的内容是非常简单的一句：\n\n```\n欢迎使用 Api2Doc ！\n```\n\n这似乎有点不太好，不过没关系，我们可以编写自己的欢迎页。\n\n方法很简单，在 src/main/resources 目录的 api2doc 目录下，创建一个名为 \nwelcome.md 的文件（这个名称是固定的），然后用 md 语法编写内容就可以。\n\n\n## 配置文档的标题及图标\n\n可以在 application.yml 中配置文档的标题及图标，如下所示：\n\n```yaml\napi2doc:\n title: Api2Doc示例项目——接口文档\n icon: https://spring.io/img/homepage/icon-spring-framework.svg\n```\n\n图标为一个全路径 URL，或本站点相对路径 URL 都行。\n\n配置后的显示效果为： \n\n![api2doc-6.png](http://upload-images.jianshu.io/upload_images/4489584-494a0c8042aaffb3.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n\n\n## 关闭 Api2Doc 服务 \n\n您在 application.yml 中配置 api2doc.enabled 属性，以开启或关闭 Api2Doc 服务，如：\n\n```yaml\n# 本地环境\napi2doc:\n title: Api2Doc示例项目——接口文档\n icon: https://spring.io/img/homepage/icon-spring-framework.svg\n\n---\n# 线上环境\nspring:\n profiles: online\n\napi2doc:\n enabled: false\n```\n\napi2doc.enabled 为 false 表示关闭 Api2Doc 服务，不写或为 true 表示启用。\n\n由于 Api2Doc 服务没有访问权限校验，建议您在受信任的网络环境（如公司内网）\n中才启用 Api2Doc 服务。\n\n\n## 后续开发计划\n\n参见[后续开发计划](https://github.com/terran4j/commons/blob/master/commons-api2doc/doc/TODO.md)\n" }, { "path": "commons-api2doc/doc/TODO.md", "content": "\n## 后续开发计划\n\nApi2Doc 项目后续计划要开发的功能如下：\n\n* 参数为对象，参数类型object，可以指出具体类型\n* 可以导出为 html 格式的文档文件，可以离线浏览，\n 支持在页面上手工操作导出，以及程序调用 API 自定义导出两种方式。\n* 可以导出为 md 格式的文档文件，可以放到 md 运行环境中浏览，\n 支持在页面上手工操作导出，以及程序调用 API 自定义导出两种方式。\n* 对测试进行支持。\n* 文档样式设计得更漂亮。\n* 文档样式支持自定义。\n\n### 1.0.2 （已发布于 2018-04-06 ）\n\n新增了以下功能：\n1. 支持各种用 @XxxMapping 修饰的方法生成文档，包括：\n `@GetMapping`、\n `@PostMapping`、\n `@PutMapping`、\n `@DeleteMapping`、\n `@PatchMapping`；\n （之前只支持 `@RequestMapping` 。）\n2. 支持各种形式的参数，包括：\n `@PathVariable`、\n `@RequestHeader`、\n `@CookieValue`、\n `@RequestPart`；\n （之前只支持 `@RequestParam` 。）\n 并在文档页面的“请求参数”表格，加上“参数形式”这一列。\n3. 文档页面，“URL示例”改为“请求示例”，\n 请求示例为 curl 命令格式，并支持所有的 HTTP 方法 ，\n （之前是 URL 格式，并且只支持了 GET 方法）。\n \n修复了以下 BUG:\n\n1. 修复当返回类型为简单类型时未能显示在文档的 BUG。\n\n" }, { "path": "commons-api2doc/doc/aboutCurl.md", "content": "\n## 什么是 curl\ncurl 是一款很强大的 http 命令行工具，可以的向服务端发起 HTTP/HTTPS 请求，\n是一个很方便 HTTP API 测试手段。\n\n## 如何安装 curl \n - 如果是 Linux / MAC 系统，一般系统都自带了 curl （如果没有安装也很简单，请自行百度）。\n - 如果是 Windows 系统，建议先安装 Cygwin64 ，然后在 Cygwin64 中安装使用 curl 。\n \n下面就介绍下如何使用 Cygwin64 包管理器安装 curl\n\nCygwin64 包管理器下载地址：\n[http://www.cygwin.com/setup-x86_64.exe](http://www.cygwin.com/setup-x86_64.exe)\n\n下载后运行，一直下一步到以下界面：\n\n![image](http://upload-images.jianshu.io/upload_images/4489584-b4431f26c3440bd6?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)\n\nView 选择 Full，Search 后面输入：curl\n\n然后点击第一行的Skip，点击下一步，后面就按默认的设置一步步安装即可。" }, { "path": "commons-api2doc/pom.xml", "content": "\n\t4.0.0\n\n\t\n\t\tcom.github.terran4j\n\t\tterran4j-commons-parent\n\t\t1.0.4-SNAPSHOT\n\t\n\n\tterran4j-commons-api2doc\n\tjar\n\tterran4j-commons-api2doc\n\thttps://github.com/terran4j/commons\n\n\t\n\n \n\t\t\n\t\t com.vladsch.flexmark\n\t\t flexmark\n\t\t\n\t\t\n\t\t com.vladsch.flexmark\n\t\t flexmark-util\n\t\t\n\t\t\n\t\t com.vladsch.flexmark\n\t\t flexmark-ext-tables\n\t\t\n \n com.vladsch.flexmark\n flexmark-ext-spec-example\n \n\n \n\t\t\n\t\t\torg.springframework.boot\n\t\t\tspring-boot-starter-freemarker\n\t\t\n\n\t\t\n\t\t\n\t\t\tcom.github.terran4j\n\t\t\tterran4j-commons-util\n\t\t\n\t\t\n\t\t\tcom.github.terran4j\n\t\t\tterran4j-commons-website\n\t\t\n \n com.github.terran4j\n terran4j-commons-restpack\n \n\n\t\t\n\t\t\n\t\t\torg.aspectj\n\t\t\taspectjweaver\n\t\t\n\n\t\t\n\t\t\n\t\t\tcom.google.code.gson\n\t\t\tgson\n\t\t\n\t\t\n\t\t\tcom.fasterxml.jackson.core\n\t\t\tjackson-core\n\t\t\n\t\t\n\t\t\tcom.fasterxml.jackson.core\n\t\t\tjackson-annotations\n\t\t\n\t\t\n\t\t\tcom.fasterxml.jackson.core\n\t\t\tjackson-databind\n\t\t\n\t\t\n\t\t\tcom.fasterxml.jackson.module\n\t\t\tjackson-module-jsonSchema\n\t\t\n \n\n\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/Api2DocMocker.java", "content": "package com.terran4j.commons.api2doc;\n\nimport com.terran4j.commons.api2doc.impl.Api2DocObjectFactory;\n\nimport java.util.List;\n\npublic class Api2DocMocker {\n\n public static T mockBean(Class clazz) {\n return Api2DocObjectFactory.createBean(clazz);\n }\n\n public static List mockList(Class clazz, int size) {\n return Api2DocObjectFactory.createList(clazz, size);\n }\n\n public static T[] mockArray(Class clazz, int size) {\n return Api2DocObjectFactory.createArray(clazz, size);\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/annotations/Api2Doc.java", "content": "package com.terran4j.commons.api2doc.annotations;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\n\nimport org.springframework.core.annotation.AliasFor;\n\n@Documented\n@Retention(RetentionPolicy.RUNTIME)\n@Target({ ElementType.TYPE, ElementType.METHOD, ElementType.FIELD })\npublic @interface Api2Doc {\n\t\n\tint DEFAULT_ORDER = 100;\n\n\t/**\n\t * 文档的id。
\n\t * 对于一个类中的重载方法，一定要用不同的 id 区分，不然会出错。\n\t * \n\t * @return\n\t */\n\t@AliasFor(\"value\")\n\tString id() default \"\";\n\n\t/**\n\t * 文档的id。
\n\t * 对于一个类中的重载方法，一定要用不同的 id 区分，不然会出错。\n\t * \n\t * @return\n\t */\n\t@AliasFor(\"id\")\n\tString value() default \"\";\n\n\t/**\n\t * 是否忽略此文档。\n\t * \n\t * @return\n\t */\n\tboolean ignore() default false;\n\n\t/**\n\t * 设置文档的排序。
\n\t * 数字越小，排序越靠前。\n\t * \n\t * @return\n\t */\n\tint order() default DEFAULT_ORDER;\n\t\n\tString name() default \"\";\n\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/annotations/ApiComment.java", "content": "package com.terran4j.commons.api2doc.annotations;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\n\n@Documented\n@Retention(RetentionPolicy.RUNTIME)\n@Target({\n\t\tElementType.TYPE,\n\t\tElementType.METHOD,\n\t\tElementType.PARAMETER,\n\t\tElementType.FIELD,\n})\npublic @interface ApiComment {\n\n\tString value() default \"\";\n\n\tString sample() default \"\";\n\n\tClass seeClass() default Object.class;\n\n\tString seeField() default \"\";\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/annotations/ApiError.java", "content": "package com.terran4j.commons.api2doc.annotations;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Repeatable;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\n\n@Documented\n@Retention(RetentionPolicy.RUNTIME)\n@Target({ ElementType.METHOD })\n@Repeatable(ApiErrors.class)\npublic @interface ApiError {\n\n\tString value();\n\t\n\tString comment() default \"\";\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/annotations/ApiErrors.java", "content": "package com.terran4j.commons.api2doc.annotations;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\n\n@Documented\n@Retention(RetentionPolicy.RUNTIME)\n@Target({ ElementType.METHOD })\npublic @interface ApiErrors {\n\n\tApiError[] value();\n\t\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/codewriter/CodeConfig.java", "content": "package com.terran4j.commons.api2doc.codewriter;\n\nimport java.util.List;\n\nimport com.terran4j.commons.api2doc.domain.ApiDocObject;\nimport com.terran4j.commons.api2doc.domain.ApiParamObject;\n\npublic class CodeConfig {\n\n\tpublic List getExtraPrams(ApiDocObject doc) {\n\t\treturn null;\n\t}\n\n\tprivate String pkgName;\n\n\tprivate String declaredComment;\n\n\tpublic String getPkgName() {\n\t\treturn pkgName;\n\t}\n\n\tpublic void setPkgName(String pkgName) {\n\t\tthis.pkgName = pkgName;\n\t}\n\n\tpublic String getDeclaredComment() {\n\t\treturn declaredComment;\n\t}\n\n\tpublic void setDeclaredComment(String declareComment) {\n\t\tthis.declaredComment = declareComment;\n\t}\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/codewriter/CodeOutput.java", "content": "package com.terran4j.commons.api2doc.codewriter;\n\npublic interface CodeOutput {\n\n\tvoid writeCodeFile(String fileName, String fileContent);\n\t\n\tvoid setPercent(int percent);\n\t\n\tvoid log(String log, String... args);\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/codewriter/CodeUtils.java", "content": "package com.terran4j.commons.api2doc.codewriter;\n\nimport java.util.Set;\n\npublic class CodeUtils {\n\n\tpublic static final void addImport(Class clazz, Set imports) {\n\t\tif (clazz == null || clazz.getPackage() == null) {\n\t\t\treturn;\n\t\t}\n\n\t\tString paramPkgName = clazz.getPackage().getName();\n\n\t\tif (paramPkgName.equals(\"java.lang\")) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (paramPkgName.startsWith(\"java.\") || paramPkgName.startsWith(\"javax.\")) {\n\t\t\timports.add(clazz.getName());\n\t\t}\n\t}\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/codewriter/EnumCodeWriter.java", "content": "package com.terran4j.commons.api2doc.codewriter;\n\nimport java.lang.reflect.Field;\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\n\nimport javax.annotation.PostConstruct;\n\nimport com.terran4j.commons.api2doc.impl.Api2DocUtils;\nimport com.terran4j.commons.api2doc.impl.ApiCommentUtils;\nimport com.terran4j.commons.api2doc.impl.FlexibleString;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.StringUtils;\n\nimport com.terran4j.commons.api2doc.annotations.ApiComment;\nimport com.terran4j.commons.api2doc.impl.ClasspathFreeMarker;\n\nimport freemarker.template.Template;\n\n@Service\npublic class EnumCodeWriter {\n\t\n\tprivate static final Logger log = LoggerFactory.getLogger(EnumCodeWriter.class);\n\n\t@Autowired\n\tprivate ClasspathFreeMarker classpathFreeMarker;\n\n\tprivate Template enumTemplate = null;\n\n\t@PostConstruct\n\tpublic void init() {\n\t\ttry {\n\t\t\tenumTemplate = classpathFreeMarker.getTemplate(getClass(), //\n\t\t\t\t\t\"enum.java.ftl\");\n\t\t} catch (Exception e) {\n\t\t\tthrow new RuntimeException(e);\n\t\t}\n\t}\n\n\t@SuppressWarnings({\"rawtypes\", \"unchecked\"})\n\tpublic void writeCode(Class currentClass, String className, //\n\t\t\tCodeOutput out, CodeConfig config) throws Exception {\n\t\t\n\t\tif (currentClass == null || !currentClass.isEnum()) {\n\t\t\treturn;\n\t\t}\n\t\t\n\t\tMap model = new HashMap<>();\n\t\t\n\t\tmodel.put(\"class\", className);\n\n\t\tif (config == null) {\n\t\t\tconfig = new CodeConfig();\n\t\t}\n\t\tmodel.put(\"config\", config);\n\t\t\n\t\tList enumInfos = new ArrayList<>();\n\t\tClass> enumClass = (Class>) currentClass;\n\t\tEnum[] enums = enumClass.getEnumConstants();\n\t\tfor (Enum enumObject : enums) {\n\t\t\t\n\t\t\tEnumInfo enumInfo = new EnumInfo();\n\t\t\t\n\t\t\tString name = enumObject.name();\n\t\t\tenumInfo.setName(name);\n\t\t\t\n\t\t\tString comment = null;\n\t\t\tField field = null;\n\t\t\ttry {\n\t\t\t\tfield = enumClass.getDeclaredField(name);\n\t\t\t} catch (NoSuchFieldException | SecurityException e1) {\n\t\t\t\tlog.error(\"Can't get field \\\"\" + name + \"\\\" from Enum: \" //\n\t\t\t\t\t\t+ enumClass.getName(), e1);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tApiComment apiComment = field.getAnnotation(ApiComment.class);\n\t\t\tcomment = ApiCommentUtils.getComment(\n\t\t\t\t\tapiComment, null, field.getName());\n\t\t\tif (comment != null) {\n comment = new FlexibleString(comment).javadoc(1);\n }\n//\t\t\tif (apiComment != null && StringUtils.hasText(apiComment.value())) {\n// comment = new FlexibleString(apiComment.value().trim()).javadoc(1);\n//\t\t\t}\n\t\t\tenumInfo.setComment(comment);\n\t\t\t\n\t\t\tenumInfos.add(enumInfo);\n\t\t}\n\t\tmodel.put(\"enums\", enumInfos);\n\t\t\n\t\tString code = classpathFreeMarker.build(enumTemplate, model);\n\t\tout.writeCodeFile(className + \".java\", code);\n\t}\n\t\n\tpublic static final class EnumInfo {\n\t\t\n\t\tprivate String comment;\n\t\t\n\t\tprivate String name;\n\n\t\tpublic String getComment() {\n\t\t\treturn comment;\n\t\t}\n\n\t\tpublic void setComment(String comment) {\n\t\t\tthis.comment = comment;\n\t\t}\n\n\t\tpublic String getName() {\n\t\t\treturn name;\n\t\t}\n\n\t\tpublic void setName(String name) {\n\t\t\tthis.name = name;\n\t\t}\n\t\t\n\t}\n}\n\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/codewriter/FileCodeOutput.java", "content": "package com.terran4j.commons.api2doc.codewriter;\n\nimport java.io.File;\n\nimport com.terran4j.commons.util.Files;\n\npublic class FileCodeOutput implements CodeOutput {\n\t\n\tprivate final String path;\n\t\n\tpublic FileCodeOutput(String path) {\n\t\tsuper();\n\t\tthis.path = path;\n\t}\n\n\t@Override\n\tpublic void writeCodeFile(String fileName, String fileContent) {\n\t\tFile file = new File(path + \"/\" + fileName);\n\t\tFiles.writeFile(fileContent, file);\n\t}\n\n\t@Override\n\tpublic void setPercent(int percent) {\n\t}\n\n\t@Override\n\tpublic void log(String log, String... args) {\n\t}\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/codewriter/JavaBeanCodeWriter.java", "content": "package com.terran4j.commons.api2doc.codewriter;\n\nimport com.terran4j.commons.api2doc.domain.ApiDataType;\nimport com.terran4j.commons.api2doc.domain.ApiResultObject;\nimport com.terran4j.commons.api2doc.domain.DateConverter;\nimport com.terran4j.commons.api2doc.impl.ClasspathFreeMarker;\nimport freemarker.template.Template;\nimport org.apache.commons.collections4.map.HashedMap;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.StringUtils;\n\nimport javax.annotation.PostConstruct;\nimport java.util.*;\n\nimport static java.util.Locale.ENGLISH;\n\n@Service\npublic class JavaBeanCodeWriter {\n\n private static final String GET_PREFIX = \"get\";\n\n private static final String SET_PREFIX = \"set\";\n\n private static final String IS_PREFIX = \"is\";\n\n @Autowired\n private ClasspathFreeMarker classpathFreeMarker;\n\n private Template javaBeanTemplate = null;\n\n @PostConstruct\n public void init() {\n try {\n javaBeanTemplate = classpathFreeMarker.getTemplate(getClass(), //\n \"bean.java.ftl\");\n } catch (Exception e) {\n throw new RuntimeException(e);\n }\n }\n\n public void writeCode(ApiResultObject result, String className, //\n CodeOutput out, CodeConfig config) throws Exception {\n\n List children = result.getChildren();\n if (children == null || children.size() == 0) {\n return;\n }\n\n Map model = getModel(result, className, config);\n\n String code = classpathFreeMarker.build(javaBeanTemplate, model);\n\n out.writeCodeFile(className + \".java\", code);\n }\n\n public Map getModel(ApiResultObject result, String className, //\n CodeConfig config) {\n\n Map model = new HashedMap<>();\n\n model.put(\"class\", className);\n\n if (config == null) {\n config = new CodeConfig();\n }\n model.put(\"config\", config);\n\n // java 类上的注释。\n String comment = result.getComment().javadoc(0);\n if (StringUtils.hasText(comment)) {\n model.put(\"comment\", comment);\n }\n\n Set imports = new HashSet<>();\n model.put(\"imports\", imports);\n\n List fields = new ArrayList();\n List children = result.getChildren();\n for (ApiResultObject child : children) {\n FieldInfo field = new FieldInfo();\n\n String name = child.getId();\n field.setName(name);\n\n String type = toTypeName(child);\n field.setType(type);\n\n String fieldComment = child.getComment().javadoc(1);\n if (StringUtils.hasText(fieldComment)) {\n field.setComment(fieldComment);\n }\n\n // Date 自动转成 Long 类型了。\n Class sourceType = getSourceType(child);\n CodeUtils.addImport(sourceType, imports);\n\n boolean isBooleanClass = (child.getDataType() == ApiDataType.BOOLEAN);\n String getMethod = toGetMethodName(isBooleanClass, name);\n field.setGetMethod(getMethod);\n\n String setMethod = toSetMethodName(name);\n field.setSetMethod(setMethod);\n\n fields.add(field);\n }\n\n model.put(\"fields\", fields);\n\n return model;\n }\n\n private String toGetMethodName(boolean isBooleanClass, String fieldName) {\n String baseName = getBaseName(fieldName);\n String methodName = null;\n if (isBooleanClass) {\n methodName = IS_PREFIX + baseName;\n } else {\n methodName = GET_PREFIX + baseName;\n }\n return methodName;\n }\n\n private String toSetMethodName(String fieldName) {\n String baseName = getBaseName(fieldName);\n String methodName = SET_PREFIX + baseName;\n return methodName;\n }\n\n private String getBaseName(String name) {\n return name.substring(0, 1).toUpperCase(ENGLISH) + name.substring(1);\n }\n\n private Class getSourceType(ApiResultObject result) {\n Class sourceType = result.getSourceType();\n return DateConverter.dateAsLongClass(sourceType);\n }\n\n private String toTypeName(ApiResultObject result) {\n ApiDataType dataType = result.getDataType();\n Class sourceType = getSourceType(result);\n ;\n String typeName = sourceType.getSimpleName();\n if (dataType.isArrayType()) {\n typeName = typeName + \"[]\";\n }\n return typeName;\n }\n\n public static final class FieldInfo {\n\n private String type;\n\n private String name;\n\n private String comment;\n\n private String getMethod;\n\n private String setMethod;\n\n public String getType() {\n return type;\n }\n\n public void setType(String type) {\n this.type = type;\n }\n\n public String getName() {\n return name;\n }\n\n public void setName(String name) {\n this.name = name;\n }\n\n public String getComment() {\n return comment;\n }\n\n public void setComment(String comment) {\n this.comment = comment;\n }\n\n public String getGetMethod() {\n return getMethod;\n }\n\n public void setGetMethod(String getMethod) {\n this.getMethod = getMethod;\n }\n\n public String getSetMethod() {\n return setMethod;\n }\n\n public void setSetMethod(String setMethod) {\n this.setMethod = setMethod;\n }\n\n }\n}\n\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/codewriter/MemoryCodeOutput.java", "content": "package com.terran4j.commons.api2doc.codewriter;\n\nimport java.util.Map;\nimport java.util.concurrent.ConcurrentHashMap;\n\npublic class MemoryCodeOutput implements CodeOutput {\n\n\tprivate final Map codes = new ConcurrentHashMap<>();\n\n\t@Override\n\tpublic void writeCodeFile(String fileName, String fileContent) {\n\t\tcodes.put(fileName, fileContent);\n\t}\n\n\t@Override\n\tpublic void setPercent(int percent) {\n\t}\n\n\t@Override\n\tpublic void log(String log, String... args) {\n\t}\n\t\n\tpublic String getCode(String fileName) {\n\t\treturn codes.get(fileName);\n\t}\n\t\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/codewriter/RetrofitCodeWriter.java", "content": "package com.terran4j.commons.api2doc.codewriter;\n\nimport com.terran4j.commons.api2doc.domain.*;\nimport com.terran4j.commons.api2doc.impl.ClasspathFreeMarker;\nimport com.terran4j.commons.util.Classes;\nimport com.terran4j.commons.util.value.KeyedList;\nimport freemarker.template.Template;\nimport freemarker.template.TemplateException;\nimport org.apache.commons.collections4.map.HashedMap;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.bind.annotation.RequestMethod;\n\nimport javax.annotation.PostConstruct;\nimport java.io.IOException;\nimport java.util.*;\n\n@Service\npublic class RetrofitCodeWriter {\n\n private static final Logger log = LoggerFactory.getLogger(RetrofitCodeWriter.class);\n\n @Autowired\n private JavaBeanCodeWriter javaBeanCodeWriter;\n\n @Autowired\n private EnumCodeWriter enumCodeWriter;\n\n @Autowired\n private ClasspathFreeMarker classpathFreeMarker;\n\n private Template interfaceTemplate = null;\n\n @PostConstruct\n public void init() {\n try {\n interfaceTemplate = classpathFreeMarker.getTemplate(getClass(), //\n \"retrofit.java.ftl\");\n log.info(\"RetrofitCodeWriter inited done.\");\n } catch (Exception e) {\n throw new RuntimeException(e);\n }\n }\n\n public void writeCode(List folders, CodeOutput out, CodeConfig config) {\n if (folders == null || folders.size() == 0) {\n return;\n }\n\n if (out == null) {\n throw new NullPointerException(\"CodeWriter writer is null.\");\n }\n\n Set> enumClasses = new HashSet<>();\n KeyedList javaBeans = new KeyedList();\n for (ApiFolderObject folder : folders) {\n Map model = toModel(folder, config, javaBeans, enumClasses);\n String className = toRetrofitClassName(folder.getId());\n String fileName = className + \".java\";\n try {\n String fileContent = classpathFreeMarker.build(interfaceTemplate, model);\n out.writeCodeFile(fileName, fileContent);\n } catch (IOException | TemplateException e) {\n throw new RuntimeException(e);\n }\n }\n\n Set> writtenClasses = new HashSet<>();\n List results = javaBeans.getAll();\n for (ApiResultObject result : results) {\n Class clazz = result.getSourceType();\n if (writtenClasses.contains(clazz)) {\n continue;\n }\n\n String className = clazz.getSimpleName();\n try {\n javaBeanCodeWriter.writeCode(result, className, out, config);\n } catch (Exception e) {\n throw new RuntimeException(e);\n }\n\n writtenClasses.add(clazz);\n }\n\n for (Class currentClass : enumClasses) {\n String className = currentClass.getSimpleName();\n try {\n enumCodeWriter.writeCode(currentClass, className, out, config);\n } catch (Exception e) {\n throw new RuntimeException(e);\n }\n }\n }\n\n\n private String toRetrofitClassName(String id) {\n String name = id.substring(0, 1).toUpperCase(Locale.ENGLISH) + id.substring(1);\n if (name.endsWith(\"Controller\")) {\n name = name.replaceAll(\"Controller\", \"Retrofit\");\n } else {\n name += \"Retrofit\";\n }\n return name;\n }\n\n private Map toModel(ApiFolderObject folder, CodeConfig config, //\n KeyedList javaBeans, Set> enumClasses) {\n\n Map model = new HashedMap<>();\n\n if (config == null) {\n config = new CodeConfig();\n }\n model.put(\"config\", config);\n\n String className = toRetrofitClassName(folder.getId());\n model.put(\"class\", className);\n\n String comment = folder.getComment().javadoc(0);\n if (StringUtils.hasText(comment)) {\n model.put(\"comment\", comment);\n }\n\n Set imports = new HashSet<>();\n model.put(\"imports\", imports);\n\n List methods = new ArrayList<>();\n List docs = folder.getDocs();\n if (docs != null) {\n for (ApiDocObject doc : docs) {\n MethodInfo method = toMethodInfo(doc, config, imports);\n methods.add(method);\n\n List results = doc.getResults();\n if (results == null || results.size() == 0) {\n continue;\n }\n\n for (ApiResultObject result : results) {\n String groupId = result.getGroupId();\n if (StringUtils.hasText(groupId)\n && !javaBeans.containsKey(groupId)) {\n javaBeans.add(groupId, result);\n }\n\n Class clazz = result.getSourceType();\n if (clazz != null && clazz.isEnum()) {\n enumClasses.add(clazz);\n }\n List children = result.getChildren();\n if (children != null) {\n for (ApiResultObject child : children) {\n clazz = child.getSourceType();\n if (clazz != null && clazz.isEnum()) {\n enumClasses.add(clazz);\n }\n }\n }\n }\n }\n }\n model.put(\"methods\", methods);\n\n return model;\n }\n\n private MethodInfo toMethodInfo(ApiDocObject doc, CodeConfig config, Set imports) {\n MethodInfo method = new MethodInfo();\n method.setName(doc.getId());\n\n String comment = doc.getComment().javadoc(1);\n method.setComment(comment);\n\n List annos = new ArrayList<>();\n RequestMethod type = doc.getMethods()[0];\n if (type == RequestMethod.POST) {\n annos.add(\"@FormUrlEncoded\");\n }\n String path = doc.getPaths()[0];\n if (!path.endsWith(\"/\")) {\n path = path + \"/\";\n }\n String anno = \"@\" + type.name() + \"(\\\"\" + path + \"\\\")\";\n annos.add(anno);\n method.setAnnos(annos);\n\n List srcParams = new ArrayList<>();\n List extraPrams = config.getExtraPrams(doc);\n if (extraPrams != null) {\n srcParams.addAll(extraPrams);\n }\n if (doc.getParams() != null) {\n srcParams.addAll(doc.getParams());\n }\n\n List params = new ArrayList<>();\n for (int i = 0; i < srcParams.size(); i++) {\n ApiParamObject srcParam = srcParams.get(i);\n ParamInfo param = toParam(srcParam, doc, imports);\n if (i < srcParams.size() - 1) {\n param.setExpression(param.getExpression() + \", \");\n }\n params.add(param);\n }\n method.setParams(params);\n\n // 确定返回类型的描述。\n String returnClass = null;\n List results = doc.getResults();\n if (results != null && results.size() > 0) {\n ApiResultObject result = results.get(0);\n ApiDataType dataType = result.getDataType();\n if (dataType != null) {\n if (dataType == ApiDataType.ARRAY) {\n returnClass = \"List<\" + result.getSourceType().getSimpleName() + \">\";\n } else {\n returnClass = result.getSourceType().getSimpleName();\n }\n }\n }\n if (returnClass == null) {\n Class returnType = doc.getSourceMethod().getReturnType();\n if (returnType != null && returnType != void.class) {\n returnClass = returnType.getSimpleName();\n }\n }\n method.setReturnClass(returnClass);\n\n return method;\n }\n\n private ParamInfo toParam(ApiParamObject srcParam, ApiDocObject doc, Set imports) {\n ParamInfo param = new ParamInfo();\n\n String id = srcParam.getId();\n param.setId(id);\n\n String comment = srcParam.getComment().javadoc(1);\n param.setComment(comment);\n\n StringBuffer expression = new StringBuffer();\n\n RequestMethod requestMethod = doc.getMethods()[0];\n ApiParamLocation location = srcParam.getLocation();\n String annoName = toParamAnnoName(location, requestMethod);\n expression.append(\"@\").append(annoName) //\n .append(\"(\\\"\").append(id).append(\"\\\")\");\n\n Class paramClass = Classes.toWrapType(srcParam.getSourceType());\n CodeUtils.addImport(paramClass, imports);\n expression.append(\" \").append(paramClass.getSimpleName());\n expression.append(\" \").append(id);\n\n param.setExpression(expression.toString());\n\n return param;\n }\n\n private String toParamAnnoName(ApiParamLocation location, RequestMethod requestMethod) {\n if (location == ApiParamLocation.RequestHeader) {\n return \"Header\";\n } else if (location == ApiParamLocation.PathVariable) {\n return \"Path\";\n } else if (location == ApiParamLocation.RequestParam) {\n if (requestMethod == RequestMethod.POST) {\n return \"Field\";\n } else {\n return \"Query\";\n }\n } else if (location == ApiParamLocation.CookieValue) {\n return \"Header\";\n } else if (location == ApiParamLocation.RequestPart) {\n return \"Part\";\n } else {\n throw new RuntimeException(\"ApiParamLocation\" +\n \" location unsupported: \" + location);\n }\n }\n\n public static final class ParamInfo {\n\n private String id;\n\n private String comment;\n\n private String expression;\n\n public String getId() {\n return id;\n }\n\n public void setId(String id) {\n this.id = id;\n }\n\n public String getComment() {\n return comment;\n }\n\n public void setComment(String comment) {\n this.comment = comment;\n }\n\n public String getExpression() {\n return expression;\n }\n\n public void setExpression(String expression) {\n this.expression = expression;\n }\n\n }\n\n public static final class MethodInfo {\n\n private List params;\n\n private List annos;\n\n private String comment;\n\n private String name;\n\n private String returnClass;\n\n public String getReturnClass() {\n return returnClass;\n }\n\n public void setReturnClass(String returnClass) {\n this.returnClass = returnClass;\n }\n\n public List getParams() {\n return params;\n }\n\n public void setParams(List params) {\n this.params = params;\n }\n\n public List getAnnos() {\n return annos;\n }\n\n public void setAnnos(List annos) {\n this.annos = annos;\n }\n\n public String getComment() {\n return comment;\n }\n\n public void setComment(String comment) {\n this.comment = comment;\n }\n\n public String getName() {\n return name;\n }\n\n public void setName(String name) {\n this.name = name;\n }\n\n }\n}\n\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/config/Api2DocConfiguration.java", "content": "package com.terran4j.commons.api2doc.config;\n\nimport com.terran4j.commons.api2doc.codewriter.RetrofitCodeWriter;\nimport com.terran4j.commons.api2doc.controller.Api2DocController;\nimport com.terran4j.commons.api2doc.impl.Api2DocCollector;\nimport com.terran4j.commons.api2doc.meta.ApiMetaService;\nimport org.springframework.boot.autoconfigure.condition.ConditionalOnExpression;\nimport org.springframework.context.annotation.ComponentScan;\nimport org.springframework.context.annotation.Configuration;\n\n/**\n * 可以通过配置 terran4j.api2doc.enabled 来\n * 启用或禁用文档服务。\n */\n@ConditionalOnExpression(\"${api2doc.enabled:true}\")\n@ComponentScan(basePackageClasses = {\n Api2DocController.class,\n Api2DocCollector.class,\n RetrofitCodeWriter.class,\n ApiMetaService.class\n})\n@Configuration\npublic class Api2DocConfiguration {\n\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/config/EnableApi2Doc.java", "content": "package com.terran4j.commons.api2doc.config;\n\nimport java.lang.annotation.Documented;\nimport java.lang.annotation.ElementType;\nimport java.lang.annotation.Retention;\nimport java.lang.annotation.RetentionPolicy;\nimport java.lang.annotation.Target;\n\nimport org.springframework.context.annotation.Import;\n\n\n@Target(ElementType.TYPE)\n@Retention(RetentionPolicy.RUNTIME)\n@Documented\n@Import(Api2DocConfiguration.class)\npublic @interface EnableApi2Doc {\n\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/controller/Api2DocController.java", "content": "package com.terran4j.commons.api2doc.controller;\n\nimport com.terran4j.commons.api2doc.domain.ApiDocObject;\nimport com.terran4j.commons.api2doc.impl.Api2DocProperties;\nimport com.terran4j.commons.api2doc.impl.Api2DocService;\nimport com.terran4j.commons.api2doc.impl.DocMenuBuilder;\nimport com.terran4j.commons.api2doc.impl.DocPageBuilder;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Controller;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.bind.annotation.PathVariable;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RequestMethod;\nimport org.springframework.web.bind.annotation.RequestParam;\n\nimport java.util.List;\nimport java.util.Map;\n\n@Controller\n@RequestMapping(value = \"/api2doc\")\npublic class Api2DocController {\n\n private static final Logger log = LoggerFactory.getLogger(Api2DocController.class);\n\n @Autowired\n private DocMenuBuilder docMenuBuilder;\n\n @Autowired\n private DocPageBuilder docPageBuilder;\n\n @Autowired\n private Api2DocService apiDocService;\n\n @Autowired\n private Api2DocProperties api2DocProperties;\n\n /**\n * http://localhost:8080/api2doc/home.html\n * 整个文档页面，包含顶部标题栏、左侧菜单栏、右侧用 iframe 嵌入的内容区。\n */\n @RequestMapping(value = \"/home.html\", method = RequestMethod.GET)\n public String home(@RequestParam(value = \"p\", required = false) String p,\n Map model) throws Exception {\n\n String title = api2DocProperties.getApi2docTitle();\n if (StringUtils.isEmpty(title)) {\n String serviceName = api2DocProperties.getServiceName();\n if (StringUtils.hasText(serviceName)) {\n title = serviceName.trim() + \"——接口文档\";\n }\n }\n if (StringUtils.isEmpty(title)) {\n title = \"Api2Doc 接口文档\";\n }\n model.put(\"title\", title);\n\n String icon = api2DocProperties.getApi2docIcon();\n if (StringUtils.hasText(icon)) {\n model.put(\"icon\", icon);\n }\n\n List menus = docMenuBuilder.getMenuGroups();\n model.put(\"menus\", menus);\n\n // 当前要显示的内容。\n String docPath = getDocPath(p);\n model.put(\"docPath\", docPath);\n model.put(\"v\", apiDocService.getComponentVersion());\n\n p = p == null ? \"\" : p;\n model.put(\"p\", p);\n\n if (log.isInfoEnabled()) {\n log.info(\"request home.html, model:\\n{}\", model);\n }\n return \"api2doc/home\";\n }\n\n private String getDocPath(String p) {\n String docPath = null;\n if (StringUtils.hasText(p)) {\n String[] strs = p.split(\"-\");\n if (strs.length >= 3) {\n String docType = strs[0];\n String docGroup = strs[1];\n String docId = strs[2];\n docPath = String.format(\"/api2doc/%s/%s/%s.html\",\n docType, docGroup, docId);\n }\n }\n\n if (docPath == null) {\n docPath = \"/api2doc/welcome.html\";\n }\n\n return apiDocService.addAppDocVersion(docPath);\n }\n\n /**\n * http://localhost:8080/api2doc/welcome.html\n * 文档首页内容。\n */\n @RequestMapping(value = \"/welcome.html\", method = RequestMethod.GET)\n public String welcome(Map model) throws Exception {\n String md = docPageBuilder.loadMdFromResource(\"welcome.md\");\n return md2HtmlPage(md, null, model);\n }\n\n /**\n * http://localhost:8080/api2doc/overview.html\n */\n @RequestMapping(value = \"/md/{folderId}/{docId}.html\", method = RequestMethod.GET)\n public String md(@PathVariable(\"folderId\") String folderId,\n @PathVariable(\"docId\") String docId,\n Map model) throws Exception {\n String md = docPageBuilder.loadMdFromResource(folderId, docId);\n return md2HtmlPage(md, null, model);\n }\n\n @RequestMapping(value = \"/api/{fid}/{id}.html\", method = RequestMethod.GET)\n public String api2doc(\n @PathVariable(\"fid\") String folderId, @PathVariable(\"id\") String id,\n Map model) throws Exception {\n ApiDocObject doc = apiDocService.getDocObject(folderId, id);\n String md = docPageBuilder.doc2Md(doc);\n String title = doc.getName();\n return md2HtmlPage(md, title, model);\n }\n\n @RequestMapping(value = \"/test/{fid}/{id}.html\", method = RequestMethod.GET)\n public String api2test(\n @PathVariable(\"fid\") String folderId, @PathVariable(\"id\") String id,\n Map model) throws Exception {\n ApiDocObject doc = apiDocService.getDocObject(folderId, id);\n model.put(\"doc\", doc);\n model.put(\"v\", apiDocService.getComponentVersion());\n// String md = docPageBuilder.doc2Md(doc);\n// String title = doc.getName();\n return \"api2doc/test\";\n }\n\n public String md2HtmlPage(String md, String title,\n Map model) throws Exception {\n if (title != null) {\n model.put(\"title\", title);\n }\n String html = docPageBuilder.md2Html(md);\n model.put(\"content\", html);\n\n model.put(\"v\", apiDocService.getComponentVersion());\n\n return \"api2doc/doc\";\n }\n\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/controller/ApiEntry.java", "content": "package com.terran4j.commons.api2doc.controller;\n\npublic class ApiEntry {\n\n private String key;\n\n private String value;\n\n public String getKey() {\n return key;\n }\n\n public void setKey(String key) {\n this.key = key;\n }\n\n public String getValue() {\n return value;\n }\n\n public void setValue(String value) {\n this.value = value;\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) return true;\n if (o == null || getClass() != o.getClass()) return false;\n\n ApiEntry apiEntry = (ApiEntry) o;\n\n if (key != null ? !key.equals(apiEntry.key) : apiEntry.key != null) return false;\n return value != null ? value.equals(apiEntry.value) : apiEntry.value == null;\n }\n\n @Override\n public int hashCode() {\n int result = key != null ? key.hashCode() : 0;\n result = 31 * result + (value != null ? value.hashCode() : 0);\n return result;\n }\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/controller/ApiInfo.java", "content": "package com.terran4j.commons.api2doc.controller;\n\nimport java.util.Arrays;\nimport java.util.List;\n\npublic class ApiInfo {\n\n String[] methods;\n\n String defaultMethod;\n\n String url;\n\n List params;\n\n List headers;\n\n public String[] getMethods() {\n return methods;\n }\n\n public void setMethods(String[] methods) {\n this.methods = methods;\n }\n\n public String getDefaultMethod() {\n return defaultMethod;\n }\n\n public void setDefaultMethod(String defaultMethod) {\n this.defaultMethod = defaultMethod;\n }\n\n public String getUrl() {\n return url;\n }\n\n public void setUrl(String url) {\n this.url = url;\n }\n\n public List getParams() {\n return params;\n }\n\n public void setParams(List params) {\n this.params = params;\n }\n\n public List getHeaders() {\n return headers;\n }\n\n public void setHeaders(List headers) {\n this.headers = headers;\n }\n\n @Override\n public boolean equals(Object o) {\n if (this == o) return true;\n if (o == null || getClass() != o.getClass()) return false;\n\n ApiInfo apiInfo = (ApiInfo) o;\n\n // Probably incorrect - comparing Object[] arrays with Arrays.equals\n if (!Arrays.equals(methods, apiInfo.methods)) return false;\n if (defaultMethod != null ? !defaultMethod.equals(apiInfo.defaultMethod) : apiInfo.defaultMethod != null)\n return false;\n if (url != null ? !url.equals(apiInfo.url) : apiInfo.url != null) return false;\n if (params != null ? !params.equals(apiInfo.params) : apiInfo.params != null) return false;\n return headers != null ? headers.equals(apiInfo.headers) : apiInfo.headers == null;\n }\n\n @Override\n public int hashCode() {\n int result = Arrays.hashCode(methods);\n result = 31 * result + (defaultMethod != null ? defaultMethod.hashCode() : 0);\n result = 31 * result + (url != null ? url.hashCode() : 0);\n result = 31 * result + (params != null ? params.hashCode() : 0);\n result = 31 * result + (headers != null ? headers.hashCode() : 0);\n return result;\n }\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/controller/ApiMetaController.java", "content": "package com.terran4j.commons.api2doc.controller;\n\nimport com.terran4j.commons.api2doc.meta.ApiMetaService;\nimport com.terran4j.commons.api2doc.meta.ClassMeta;\nimport com.terran4j.commons.restpack.RestPackController;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.web.bind.annotation.PathVariable;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RequestMethod;\n\nimport java.util.List;\n\n@RestPackController\n@RequestMapping(value = \"/api2doc/meta\")\npublic class ApiMetaController {\n\n @Autowired\n private ApiMetaService apiMetaService;\n\n @RequestMapping(value = \"/classes\", method = RequestMethod.GET)\n public List getClassMetaList() throws Exception {\n return apiMetaService.toClassMetaList();\n }\n\n @RequestMapping(value = \"/apiInfo/{fid}/{id}\", method = RequestMethod.GET)\n public ApiInfo getApiInfo(@PathVariable String fid, @PathVariable String id) throws Exception {\n return apiMetaService.toApiInfo(fid, id);\n }\n\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/controller/MenuData.java", "content": "package com.terran4j.commons.api2doc.controller;\n\nimport com.terran4j.commons.api2doc.annotations.Api2Doc;\nimport com.terran4j.commons.util.Strings;\n\nimport java.util.List;\n\npublic class MenuData implements Comparable{\n\n private boolean folder;\n\n private int order = Api2Doc.DEFAULT_ORDER;\n\n private String id;\n\n private String index;\n\n private String name;\n\n private String url;\n\n private List children;\n\n public int getOrder() {\n return order;\n }\n\n public void setOrder(int order) {\n this.order = order;\n }\n\n public final boolean isFolder() {\n return folder;\n }\n\n public final void setFolder(boolean folder) {\n this.folder = folder;\n }\n\n public final String getId() {\n return id;\n }\n\n public final void setId(String id) {\n this.id = id;\n }\n\n public final String getIndex() {\n return index;\n }\n\n public final void setIndex(String index) {\n this.index = index;\n }\n\n public final String getName() {\n return name;\n }\n\n public final void setName(String name) {\n this.name = name;\n }\n\n public final List getChildren() {\n return children;\n }\n\n public final void setChildren(List children) {\n this.children = children;\n }\n\n public final String getUrl() {\n return url;\n }\n\n public final void setUrl(String url) {\n this.url = url;\n }\n\n public final String toString() {\n return Strings.toString(this);\n }\n\n @Override\n public int compareTo( MenuData other) {\n MenuData o1 = this;\n MenuData o2 = other;\n\n if (o1.getOrder() < o2.getOrder()) {\n return -1;\n }\n if (o1.getOrder() > o2.getOrder()) {\n return 1;\n }\n return 0;\n }\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/ApiDataType.java", "content": "package com.terran4j.commons.api2doc.domain;\n\nimport com.fasterxml.jackson.databind.JsonMappingException;\nimport com.fasterxml.jackson.module.jsonSchema.JsonSchema;\nimport com.fasterxml.jackson.module.jsonSchema.JsonSchemaGenerator;\nimport com.terran4j.commons.util.Jsons;\n\n/**\n * api的基本数据类型。\n *\n * @author jiangwei\n */\npublic enum ApiDataType {\n\n BOOLEAN(\"boolean\") {\n @Override\n public String getDefault() {\n return \"false\";\n }\n\n @Override\n public Object parseValue(String text) {\n return Boolean.parseBoolean(text);\n }\n\n @Override\n public boolean isSimpleType() {\n return true;\n }\n\n @Override\n public boolean isArrayType() {\n return false;\n }\n\n @Override\n public boolean isObjectType() {\n return false;\n }\n },\n\n INT(\"int\") {\n @Override\n public String getDefault() {\n return \"0\";\n }\n\n @Override\n public Object parseValue(String text) {\n return Integer.parseInt(text);\n }\n\n @Override\n public boolean isSimpleType() {\n return true;\n }\n\n @Override\n public boolean isArrayType() {\n return false;\n }\n\n @Override\n public boolean isObjectType() {\n return false;\n }\n },\n\n LONG(\"long\") {\n @Override\n public String getDefault() {\n return \"0\";\n }\n\n @Override\n public Object parseValue(String text) {\n return Long.parseLong(text);\n }\n\n @Override\n public boolean isSimpleType() {\n return true;\n }\n\n @Override\n public boolean isArrayType() {\n return false;\n }\n\n @Override\n public boolean isObjectType() {\n return false;\n }\n },\n\n NUMBER(\"number\") {\n @Override\n public String getDefault() {\n return \"0.1\";\n }\n\n @Override\n public Object parseValue(String text) {\n return Double.parseDouble(text);\n }\n\n @Override\n public boolean isSimpleType() {\n return true;\n }\n\n @Override\n public boolean isArrayType() {\n return false;\n }\n\n @Override\n public boolean isObjectType() {\n return false;\n }\n },\n\n STRING(\"string\") {\n @Override\n public String getDefault() {\n return \"my-string\";\n }\n\n @Override\n public Object parseValue(String text) {\n return text;\n }\n\n @Override\n public boolean isSimpleType() {\n return true;\n }\n\n @Override\n public boolean isArrayType() {\n return false;\n }\n\n @Override\n public boolean isObjectType() {\n return false;\n }\n },\n\n ARRAY(\"array\") {\n @Override\n public String getDefault() {\n return \"[]\";\n }\n\n @Override\n public Object parseValue(String text) {\n throw new UnsupportedOperationException(\"array can't parse from text: \" + text);\n }\n\n @Override\n public boolean isSimpleType() {\n return false;\n }\n\n @Override\n public boolean isArrayType() {\n return true;\n }\n\n @Override\n public boolean isObjectType() {\n return false;\n }\n },\n\n OBJECT(\"object\") {\n @Override\n public String getDefault() {\n return \"{}\";\n }\n\n @Override\n public Object parseValue(String text) {\n throw new UnsupportedOperationException(\"object can't parse from text: \" + text);\n }\n\n @Override\n public boolean isSimpleType() {\n return false;\n }\n\n @Override\n public boolean isArrayType() {\n return false;\n }\n\n @Override\n public boolean isObjectType() {\n return true;\n }\n };\n\n private final String name;\n\n ApiDataType(String name) {\n this.name = name;\n }\n\n public String getName() {\n return name;\n }\n\n public abstract String getDefault();\n\n public abstract Object parseValue(String text);\n\n public abstract boolean isSimpleType();\n\n public abstract boolean isArrayType();\n\n public abstract boolean isObjectType();\n\n private static JsonSchemaGenerator schemaGen = null;\n\n public static final JsonSchemaGenerator getJsonSchemaGenerator() {\n if (schemaGen != null) {\n return schemaGen;\n }\n synchronized (ApiDataType.class) {\n if (schemaGen != null) {\n return schemaGen;\n }\n try {\n schemaGen = new JsonSchemaGenerator(Jsons.getObjectMapper());\n return schemaGen;\n } catch (Exception e) {\n throw new RuntimeException(e);\n }\n }\n }\n\n public static ApiDataType toDataType(Class clazz) {\n\n // 日期类型，按 long 返回。\n ApiDataType dataType = DateConverter.dateAsLongType(clazz);\n if (dataType != null) {\n return dataType;\n }\n\n try {\n JsonSchema schema = getJsonSchemaGenerator().generateSchema(clazz);\n return toDataType(schema);\n } catch (JsonMappingException e) {\n String msg = \"generate schema by class failed, class = \" + clazz.getName();\n throw new RuntimeException(msg, e);\n }\n }\n\n public static ApiDataType toDataType(JsonSchema schema) {\n if (schema == null) {\n return null;\n }\n if (schema.isBooleanSchema()) {\n return ApiDataType.BOOLEAN;\n }\n if (schema.isIntegerSchema()) {\n return ApiDataType.INT;\n }\n if (schema.isStringSchema()) {\n return ApiDataType.STRING;\n }\n if (schema.isNumberSchema()) {\n return ApiDataType.NUMBER;\n }\n if (schema.isObjectSchema()) {\n return ApiDataType.OBJECT;\n }\n if (schema.isArraySchema()) {\n return ApiDataType.ARRAY;\n }\n return null;\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/ApiDocObject.java", "content": "package com.terran4j.commons.api2doc.domain;\n\nimport com.terran4j.commons.api2doc.impl.Api2DocObjectFactory;\nimport com.terran4j.commons.util.value.KeyedList;\nimport org.springframework.web.bind.annotation.RequestMethod;\n\nimport java.lang.reflect.Method;\nimport java.util.List;\n\npublic class ApiDocObject extends ApiObject {\n\n private ApiFolderObject folder;\n\n private String[] paths;\n\n private Method sourceMethod;\n\n private RequestMethod[] methods;\n\n private String returnTypeDesc;\n\n private List results;\n\n private ApiResultObject resultType;\n\n private final KeyedList params = new KeyedList<>();\n\n private final KeyedList errors = new KeyedList<>();\n\n public ApiResultObject getResultType() {\n return resultType;\n }\n\n public void setResultType(ApiResultObject resultType) {\n this.resultType = resultType;\n }\n\n public Method getSourceMethod() {\n return sourceMethod;\n }\n\n public void setSourceMethod(Method sourceMethod) {\n this.sourceMethod = sourceMethod;\n }\n\n public String[] getPaths() {\n return paths;\n }\n\n public void setPaths(String[] paths) {\n this.paths = paths;\n }\n\n public RequestMethod[] getMethods() {\n return methods;\n }\n\n public void setMethods(RequestMethod[] methods) {\n this.methods = methods;\n }\n\n public final List getParams() {\n return params.getAll();\n }\n\n public final ApiParamObject getParam(String id) {\n return params.get(id);\n }\n\n public final void addParam(ApiParamObject param) {\n this.params.add(param.getId(), param);\n }\n\n public List getResults() {\n return results;\n }\n\n public void setResults(List results) {\n this.results = results;\n }\n\n public List getErrors() {\n return errors.getAll();\n }\n\n public void addError(ApiErrorObject error) {\n this.errors.add(error.getId(), error);\n }\n\n public ApiFolderObject getFolder() {\n return folder;\n }\n\n public void setFolder(ApiFolderObject folder) {\n this.folder = folder;\n }\n\n public String getReturnTypeDesc() {\n return returnTypeDesc;\n }\n\n public void setReturnTypeDesc(String returnTypeDesc) {\n this.returnTypeDesc = returnTypeDesc;\n }\n\n public final Object toMockResult() {\n List results = getResults();\n if (results != null && results.size() > 0) {\n ApiResultObject result = results.get(0);\n return Api2DocObjectFactory.createObject(result.getDataType(),\n result.getSourceType(), result.getSample().getValue());\n }\n if (resultType != null) {\n return Api2DocObjectFactory.createObject(resultType.getDataType(),\n resultType.getSourceType(), resultType.getSample().getValue());\n }\n return null;\n }\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/ApiDocUtils.java", "content": "package com.terran4j.commons.api2doc.domain;\n\nimport org.springframework.util.StringUtils;\n\nimport com.terran4j.commons.api2doc.annotations.Api2Doc;\n\npublic class ApiDocUtils {\n\n\tpublic static final String getId(Class clazz) {\n\t\tif (clazz == null) {\n\t\t\tthrow new NullPointerException();\n\t\t}\n\n\t\tApi2Doc api2doc = clazz.getAnnotation(Api2Doc.class);\n\n\t\tif (api2doc != null) {\n\t\t\tString id = api2doc.id();\n\t\t\tif (StringUtils.hasText(id)) {\n\t\t\t\treturn id;\n\t\t\t}\n\n\t\t\tString value = api2doc.value();\n\t\t\tif (StringUtils.hasText(value)) {\n\t\t\t\treturn value;\n\t\t\t}\n\t\t}\n\n\t\treturn clazz.getName();\n\t}\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/ApiErrorObject.java", "content": "package com.terran4j.commons.api2doc.domain;\n\npublic class ApiErrorObject extends ApiObject {\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/ApiFolderObject.java", "content": "package com.terran4j.commons.api2doc.domain;\n\nimport com.terran4j.commons.util.value.KeyedList;\nimport org.springframework.util.StringUtils;\n\nimport java.util.List;\nimport java.util.Map;\n\npublic class ApiFolderObject extends ApiObject {\n\n private boolean restPack = false;\n\n private Map mds;\n\n private Class sourceClass;\n\n private final KeyedList docs = new KeyedList<>();\n\n public boolean isRestPack() {\n return restPack;\n }\n\n public void setRestPack(boolean restPack) {\n this.restPack = restPack;\n }\n\n public Map getMds() {\n return mds;\n }\n\n public void setMds(Map mds) {\n this.mds = mds;\n }\n\n public Class getSourceClass() {\n return sourceClass;\n }\n\n public void setSourceClass(Class sourceClass) {\n this.sourceClass = sourceClass;\n }\n\n public final List getDocs() {\n return docs.getAll();\n }\n\n public final ApiDocObject getDoc(String id) {\n return docs.get(id);\n }\n\n public final void addDocs(List docList) {\n if (docList == null) {\n return;\n }\n for (ApiDocObject doc : docList) {\n addDoc(doc);\n }\n }\n\n public final void addDoc(ApiDocObject doc) {\n if (doc == null) {\n throw new NullPointerException();\n }\n String id = doc.getId();\n if (StringUtils.isEmpty(id)) {\n throw new NullPointerException(\"doc id is empty.\");\n }\n\n this.docs.add(id, doc);\n }\n\n public static final String name2Id(String name) {\n int hash = name.hashCode();\n String id;\n if (hash < 0) {\n id = \"n\" + Math.abs(hash);\n } else {\n id = String.valueOf(hash);\n }\n return id;\n }\n\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/ApiObject.java", "content": "package com.terran4j.commons.api2doc.domain;\n\nimport com.terran4j.commons.api2doc.annotations.Api2Doc;\nimport com.terran4j.commons.api2doc.impl.FlexibleString;\nimport com.terran4j.commons.util.Strings;\n\npublic class ApiObject implements Comparable{\n\n private String id;\n\n private String name;\n\n private final FlexibleString comment = new FlexibleString();\n\n private final FlexibleString sample = new FlexibleString();\n\n private int order = Api2Doc.DEFAULT_ORDER;\n\n public String getId() {\n return id;\n }\n\n public void setId(String id) {\n this.id = id;\n }\n\n public String getName() {\n return name;\n }\n\n public void setName(String name) {\n this.name = name;\n }\n\n public final int getOrder() {\n return order;\n }\n\n public final void setOrder(int order) {\n this.order = order;\n }\n\n public void insertComment(String comment) {\n this.comment.insertLine(comment);\n }\n\n public FlexibleString getComment() {\n return comment;\n }\n\n public void setComment(String comment) {\n this.comment.setValue(comment);\n }\n\n public FlexibleString getSample() {\n return sample;\n }\n\n public void setSample(String sample) {\n this.sample.setValue(sample);\n }\n\n @Override\n public final String toString() {\n return Strings.toString(this);\n }\n\n @Override\n public int compareTo(ApiObject other) {\n ApiObject o1 = this;\n ApiObject o2 = other;\n\n // 优先按用户指定排序。\n if (o1.getOrder() < o2.getOrder()) {\n return -1;\n }\n if (o1.getOrder() > o2.getOrder()) {\n return 1;\n }\n\n // 其次按 id 字符串排序。\n return o1.getId().compareTo(o2.getId());\n }\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/ApiParamLocation.java", "content": "package com.terran4j.commons.api2doc.domain;\n\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.bind.annotation.*;\n\nimport java.lang.reflect.AnnotatedElement;\n\n/**\n * API 参数在 HTTP 协议中的位置。\n *\n * @author jiangwei\n */\npublic enum ApiParamLocation {\n\n RequestHeader {\n @Override\n boolean doCollect(ApiParamObject apiParamObject, AnnotatedElement element) {\n RequestHeader requestHeader = element.getAnnotation(RequestHeader.class);\n if (requestHeader == null) {\n return false;\n }\n\n String name = null;\n if (StringUtils.hasText(requestHeader.value())) {\n name = requestHeader.value();\n }\n if (StringUtils.hasText(requestHeader.name())) {\n name = requestHeader.name();\n }\n apiParamObject.setName(name);\n\n boolean required = requestHeader.required();\n apiParamObject.setRequired(required);\n\n String paramSample = requestHeader.defaultValue();\n if (StringUtils.hasText(paramSample)) {\n if (ValueConstants.DEFAULT_NONE.equals(paramSample)) {\n paramSample = \"\";\n }\n apiParamObject.setSample(paramSample);\n }\n\n return true;\n }\n },\n\n RequestParam {\n @Override\n boolean doCollect(ApiParamObject apiParamObject, AnnotatedElement element) {\n RequestParam requestParam = element.getAnnotation(RequestParam.class);\n if (requestParam == null) {\n return false;\n }\n\n String name = null;\n if (StringUtils.hasText(requestParam.value())) {\n name = requestParam.value();\n }\n if (StringUtils.hasText(requestParam.name())) {\n name = requestParam.name();\n }\n apiParamObject.setName(name);\n\n boolean required = requestParam.required();\n apiParamObject.setRequired(required);\n\n String paramSample = requestParam.defaultValue();\n if (StringUtils.hasText(paramSample)) {\n if (ValueConstants.DEFAULT_NONE.equals(paramSample)) {\n paramSample = \"\";\n }\n apiParamObject.setSample(paramSample);\n }\n\n return true;\n }\n },\n\n RequestPart {\n @Override\n boolean doCollect(ApiParamObject apiParamObject, AnnotatedElement element) {\n RequestPart requestPart = element.getAnnotation(RequestPart.class);\n if (requestPart == null) {\n return false;\n }\n\n String name = null;\n if (StringUtils.hasText(requestPart.value())) {\n name = requestPart.value();\n }\n if (StringUtils.hasText(requestPart.name())) {\n name = requestPart.name();\n }\n apiParamObject.setName(name);\n\n boolean required = requestPart.required();\n apiParamObject.setRequired(required);\n\n return true;\n }\n },\n\n CookieValue {\n @Override\n boolean doCollect(ApiParamObject apiParamObject, AnnotatedElement element) {\n CookieValue cookieValue = element.getAnnotation(CookieValue.class);\n if (cookieValue == null) {\n return false;\n }\n\n String name = null;\n if (StringUtils.hasText(cookieValue.value())) {\n name = cookieValue.value();\n }\n if (StringUtils.hasText(cookieValue.name())) {\n name = cookieValue.name();\n }\n apiParamObject.setName(name);\n\n boolean required = cookieValue.required();\n apiParamObject.setRequired(required);\n\n String paramSample = cookieValue.defaultValue();\n if (StringUtils.hasText(paramSample)) {\n if (ValueConstants.DEFAULT_NONE.equals(paramSample)) {\n paramSample = \"\";\n }\n apiParamObject.setSample(paramSample);\n }\n\n return true;\n }\n },\n\n PathVariable {\n @Override\n boolean doCollect(ApiParamObject apiParamObject, AnnotatedElement element) {\n PathVariable pathVariable = element.getAnnotation(PathVariable.class);\n if (pathVariable == null) {\n return false;\n }\n\n String name = null;\n if (StringUtils.hasText(pathVariable.value())) {\n name = pathVariable.value();\n }\n if (StringUtils.hasText(pathVariable.name())) {\n name = pathVariable.name();\n }\n apiParamObject.setName(name);\n\n boolean required = pathVariable.required();\n apiParamObject.setRequired(required);\n\n return true;\n }\n };\n\n public static final ApiParamLocation[] API_PARAM_LOCATIONS = new ApiParamLocation[]{\n RequestParam, PathVariable, RequestHeader, CookieValue, RequestPart\n };\n\n abstract boolean doCollect(ApiParamObject apiParamObject, AnnotatedElement param);\n\n public static final void collects(ApiParamObject apiParamObject, AnnotatedElement element) {\n ApiParamLocation currentLocation = ApiParamLocation.RequestParam;\n for (ApiParamLocation location : API_PARAM_LOCATIONS) {\n if (location.doCollect(apiParamObject, element)) {\n currentLocation = location;\n break;\n }\n }\n apiParamObject.setLocation(currentLocation);\n\n String sample = apiParamObject.getSample().getValue();\n if (ValueConstants.DEFAULT_NONE.equals(sample)) {\n apiParamObject.setSample(\"\");\n }\n }\n\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/ApiParamObject.java", "content": "package com.terran4j.commons.api2doc.domain;\n\npublic class ApiParamObject extends ApiObject {\n\t\n\tprivate boolean required;\n\n\tprivate ApiDataType dataType;\n\t\n\tprivate ApiParamLocation location;\n\t\n\tprivate Class sourceType;\n\t\n\tpublic ApiParamObject() {\n\t\tsuper();\n\t\tthis.setComment(\"\");\n\t}\n\t\n\tpublic Class getSourceType() {\n\t\treturn sourceType;\n\t}\n\n\tpublic void setSourceType(Class sourceType) {\n\t\tthis.sourceType = sourceType;\n\t}\n\n\tpublic String getTypeName() {\n\t\tif (dataType == null) {\n\t\t\treturn \"\";\n\t\t}\n\t\tif (dataType.isArrayType()) {\n\t\t\treturn dataType.name().toLowerCase() + \"[]\";\n\t\t}\n\t\treturn dataType.name().toLowerCase();\n\t}\n\n\tpublic ApiDataType getDataType() {\n\t\treturn dataType;\n\t}\n\n\tpublic void setDataType(ApiDataType type) {\n\t\tthis.dataType = type;\n\t}\n\n\tpublic boolean isRequired() {\n\t\treturn required;\n\t}\n\n\tpublic void setRequired(boolean required) {\n\t\tthis.required = required;\n\t}\n\t\n\tpublic final String getRequiredName() {\n\t\treturn required ? \"是\" : \"否\";\n\t}\n\n\tpublic ApiParamLocation getLocation() {\n\t\treturn location;\n\t}\n\n\tpublic void setLocation(ApiParamLocation location) {\n\t\tthis.location = location;\n\t}\n\t\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/ApiResultObject.java", "content": "package com.terran4j.commons.api2doc.domain;\n\nimport com.terran4j.commons.api2doc.annotations.Api2Doc;\nimport com.terran4j.commons.api2doc.annotations.ApiComment;\nimport com.terran4j.commons.api2doc.impl.Api2DocUtils;\nimport com.terran4j.commons.api2doc.impl.ApiCommentUtils;\nimport com.terran4j.commons.util.Classes;\nimport com.terran4j.commons.util.value.KeyedList;\nimport org.apache.commons.beanutils.PropertyUtils;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.springframework.util.StringUtils;\n\nimport java.beans.PropertyDescriptor;\nimport java.lang.reflect.Field;\nimport java.lang.reflect.Method;\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.Map;\n\n/**\n * 记录所有的结果字段，它是一个复合型\n */\npublic class ApiResultObject extends ApiObject {\n\n private static final Logger log = LoggerFactory.getLogger(ApiResultObject.class);\n\n private ApiDataType dataType;\n\n /**\n * 如果类型是数组类型，此类是里面元素的类型\n * 否则是这个类型本身。\n */\n private Class sourceType;\n\n private String typeName = \"\";\n\n private String refGroupId = null;\n\n private String groupId = null;\n\n private String groupName = null;\n\n private final List children = new ArrayList<>();\n\n public Class getSourceType() {\n return sourceType;\n }\n\n public void setSourceType(Class sourceType) {\n this.sourceType = sourceType;\n }\n\n public String getRefGroupId() {\n return refGroupId;\n }\n\n public void setRefGroupId(String refGroupId) {\n this.refGroupId = refGroupId;\n }\n\n public final ApiDataType getDataType() {\n return dataType;\n }\n\n public final void setDataType(ApiDataType dataType) {\n this.dataType = dataType;\n }\n\n public String getTypeName() {\n return typeName;\n }\n\n public void setTypeName(String typeName) {\n this.typeName = typeName;\n }\n\n public final List getChildren() {\n return children;\n }\n\n public final ApiResultObject getChild(String fieldName) {\n if (children == null || StringUtils.isEmpty(fieldName)) {\n return null;\n }\n\n for (ApiResultObject child : children) {\n if (fieldName.equals(child.getId())) {\n return child;\n }\n }\n\n return null;\n }\n\n public final void addChild(ApiResultObject child) {\n this.children.add(child);\n }\n\n public String getGroupId() {\n return groupId;\n }\n\n public void setGroupId(String groupId) {\n this.groupId = groupId;\n }\n\n public String getGroupName() {\n return groupName;\n }\n\n public void setGroupName(String groupName) {\n this.groupName = groupName;\n }\n\n @SuppressWarnings({\"unchecked\", \"rawtypes\"})\n public static final String getEnumComment(Class clazz) {\n if (clazz == null) {\n return null;\n }\n if (!clazz.isEnum()) {\n return null;\n }\n\n StringBuffer sb = new StringBuffer(\"\\n可选值为：\");\n Class> enumClass = (Class>) clazz;\n Enum[] enums = enumClass.getEnumConstants();\n for (Enum e : enums) {\n String name = e.name();\n Field field = null;\n try {\n field = enumClass.getDeclaredField(name);\n } catch (NoSuchFieldException | SecurityException e1) {\n log.error(\"Can't get field \\\"\" + name + \"\\\" from Enum: \" + clazz.getName(), e1);\n continue;\n }\n ApiComment comment = field.getAnnotation(ApiComment.class);\n String value = ApiCommentUtils.getComment(\n comment, null, field.getName());\n if (value == null) {\n value = \"\";\n }\n\n if (sb.length() > 0) {\n sb.append(\"\\n\");\n }\n sb.append(name).append(\": \").append(value).append(\"; \");\n }\n\n return sb.toString();\n }\n\n private static final String getTypeName(Class clazz, ApiDataType dataType) {\n if (clazz.isEnum()) {\n return ApiDataType.STRING.name().toLowerCase() + \"(枚举值)\";\n } else if (dataType != null && dataType.isSimpleType()) {\n return dataType.name().toLowerCase();\n } else {\n return clazz.getSimpleName();\n }\n }\n\n /**\n * 找到一个方法返回类型中字段，收集它的 Api2Doc 信息。\n *\n * @param method\n * @param totalResults\n * @return\n */\n public static final ApiResultObject parseResultType(\n Method method, KeyedList totalResults) {\n\n if (method == null) {\n return null;\n }\n\n if (totalResults == null) {\n totalResults = new KeyedList<>();\n }\n\n final Class clazz = method.getReturnType();\n final ApiDataType dataType = ApiDataType.toDataType(clazz);\n if (dataType == null) {\n return null;\n }\n String typeName = getTypeName(clazz, dataType);\n\n // 基本类型，直接处理。\n if (dataType.isSimpleType()) {\n return createSimple(clazz, clazz, dataType, typeName);\n }\n\n // 子类型。\n Class elementType = null;\n\n // 数组类型，找到它的元素的具体类型，然后处理具体类型。\n if (dataType.isArrayType()) {\n elementType = Api2DocUtils.getArrayElementClass(method);\n if (elementType == null) {\n log.warn(\"Can't find element class by method: {}\", method);\n return null;\n }\n\n ApiDataType elementDataType = ApiDataType.toDataType(elementType);\n typeName = getTypeName(elementType, elementDataType) + \"[]\";\n\n // 数组类型，但元素是基本类型的，也直接处理。\n if (elementDataType != null && elementDataType.isSimpleType()) {\n return createSimple(elementType, clazz,\n dataType, typeName);\n }\n }\n\n // 复杂类型的情况。\n ApiResultObject result = new ApiResultObject();\n result.setDataType(dataType);\n result.setSourceType(clazz);\n result.setTypeName(typeName);\n result.setId(\"\");\n\n if (dataType.isObjectType()) {\n elementType = method.getReturnType();\n }\n\n // 没有子类型，直接返回。\n // TODO: 暂时不解析 Map 内部的类型。\n if (elementType == null || Map.class.equals(elementType)) {\n return result;\n }\n\n result.setSourceType(elementType);\n\n // 没有子类型，直接返回。\n PropertyDescriptor[] props = PropertyUtils.getPropertyDescriptors(elementType);\n if (props == null || props.length == 0) {\n return result;\n }\n\n // 根据类型生成字段集的 id 和 name 。\n String groupId = getGroupId(elementType);\n result.setGroupId(groupId);\n String groupName = elementType.getSimpleName();\n result.setGroupName(groupName);\n\n // 加入到结果字段集中。\n if (totalResults.containsKey(groupId)) {\n return result;\n } else {\n totalResults.add(groupId, result);\n }\n\n // 有子类型，补充子类型信息。\n for (PropertyDescriptor prop : props) {\n if (Api2DocUtils.isFilter(prop, elementType)) {\n continue;\n }\n\n String fieldName = prop.getName();\n Method subMethod = prop.getReadMethod();\n\n // 处理子类型。\n ApiResultObject childPropResult;\n try {\n childPropResult = parseResultType(subMethod, totalResults);\n } catch (Exception e) {\n String msg = String.format(\"解析类[ %s ]的属性[ %s ]出错： %s\",\n elementType.getName(), fieldName, e.getMessage());\n throw new RuntimeException(msg);\n }\n\n // 补充子类型信息。\n if (childPropResult != null) {\n\n // 补充到当前节点中。\n result.addChild(childPropResult);\n\n String id = prop.getName();\n childPropResult.setId(id);\n childPropResult.setName(id);\n\n Class childPropClass = subMethod.getReturnType();\n ApiDataType childPropDataType = ApiDataType.toDataType(childPropClass);\n childPropResult.setDataType(childPropDataType);\n\n Api2Doc childApi2Doc;\n ApiComment childApiComment;\n String childName;\n Field field = Classes.getField(id, elementType);\n if (field != null) {\n childApiComment = field.getAnnotation(ApiComment.class);\n childApi2Doc = field.getAnnotation(Api2Doc.class);\n childName = field.getName();\n } else {\n childApiComment = subMethod.getAnnotation(ApiComment.class);\n childApi2Doc = subMethod.getAnnotation(Api2Doc.class);\n childName = subMethod.getName();\n }\n\n ApiComment elementApiComment = elementType\n .getAnnotation(ApiComment.class);\n Class defaultSeeClass = ApiCommentUtils\n .getDefaultSeeClass(elementApiComment, null);\n\n String comment = ApiCommentUtils.getComment(\n childApiComment, defaultSeeClass, childName);\n if (comment == null) {\n comment = \"\";\n }\n childPropResult.insertComment(comment);\n\n String sample = ApiCommentUtils.getSample(\n childApiComment, defaultSeeClass, childName);\n if (sample == null) {\n sample = \"\";\n }\n childPropResult.setSample(sample);\n\n if (childApi2Doc != null) {\n childPropResult.setOrder(childApi2Doc.order());\n }\n\n // 记录所引用的类型。\n Class childSubType = null;\n if (childPropDataType != null) {\n if (childPropDataType.isArrayType()) {\n childSubType = Api2DocUtils.getArrayElementClass(subMethod);\n } else if (childPropDataType.isObjectType()) {\n childSubType = subMethod.getReturnType();\n }\n }\n if (childSubType != null) {\n String refGroupId = getGroupId(childSubType);\n childPropResult.setRefGroupId(refGroupId);\n }\n }\n }\n\n Collections.sort(result.getChildren());\n\n return result;\n }\n\n public static final String getGroupId(Class clazz) {\n if (clazz == null) {\n throw new NullPointerException();\n }\n String groupId = ApiDocUtils.getId(clazz);\n return groupId;\n }\n\n private static ApiResultObject createSimple(Class sourceType,\n Class clazz, ApiDataType dataType,\n String typeName) {\n ApiResultObject result = new ApiResultObject();\n result.setSourceType(sourceType);\n result.setDataType(dataType);\n result.setTypeName(typeName);\n result.insertComment(getEnumComment(clazz));\n result.setId(\"\");\n return result;\n }\n\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/domain/DateConverter.java", "content": "package com.terran4j.commons.api2doc.domain;\n\nimport java.util.Date;\n\npublic class DateConverter {\n\n public static boolean isDateType(Class clazz) {\n return clazz == Date.class || clazz == java.sql.Date.class;\n }\n\n public static Object dateAsLongValue(Class clazz) {\n if (isDateType(clazz)) {\n // 这里不能用 Long 类型，因为赋值会失败。\n return new Date();\n }\n return null;\n }\n\n public static ApiDataType dateAsLongType(Class clazz) {\n if (isDateType(clazz)) {\n return ApiDataType.LONG;\n }\n return null;\n }\n\n public static Class dateAsLongClass(Class clazz) {\n if (isDateType(clazz)) {\n return Long.class;\n }\n return clazz;\n }\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/Api2DocCollector.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport com.terran4j.commons.api2doc.annotations.Api2Doc;\nimport com.terran4j.commons.api2doc.annotations.ApiComment;\nimport com.terran4j.commons.api2doc.annotations.ApiError;\nimport com.terran4j.commons.api2doc.annotations.ApiErrors;\nimport com.terran4j.commons.api2doc.domain.*;\nimport com.terran4j.commons.restpack.RestPackController;\nimport com.terran4j.commons.util.Classes;\nimport com.terran4j.commons.util.error.BusinessException;\nimport com.terran4j.commons.util.value.KeyedList;\nimport org.apache.commons.beanutils.PropertyUtils;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.springframework.beans.BeansException;\nimport org.springframework.beans.factory.BeanDefinitionStoreException;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.beans.factory.config.BeanPostProcessor;\nimport org.springframework.core.LocalVariableTableParameterNameDiscoverer;\nimport org.springframework.core.annotation.AnnotationUtils;\nimport org.springframework.core.io.Resource;\nimport org.springframework.stereotype.Controller;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.bind.annotation.RequestMapping;\n\nimport java.beans.PropertyDescriptor;\nimport java.io.IOException;\nimport java.lang.reflect.AnnotatedElement;\nimport java.lang.reflect.Field;\nimport java.lang.reflect.Method;\nimport java.lang.reflect.Parameter;\nimport java.util.*;\n\n\n@Service\npublic class Api2DocCollector implements BeanPostProcessor {\n\n private static final Logger log = LoggerFactory.getLogger(Api2DocCollector.class);\n\n private final LocalVariableTableParameterNameDiscoverer parameterNameDiscoverer\n = new LocalVariableTableParameterNameDiscoverer();\n\n @Autowired\n private Api2DocService apiDocService;\n\n @Override\n public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {\n\n ApiFolderObject folder;\n try {\n folder = toApiFolder(bean, beanName);\n } catch (BusinessException e) {\n throw new BeanDefinitionStoreException(\n \"bean上的文档信息定义出错：\" + e.getMessage());\n }\n if (folder == null) {\n return bean;\n }\n\n String id = folder.getId();\n ApiFolderObject existApiFolder = apiDocService.getFolder(id);\n if (existApiFolder != null) {\n String msg = \"@Api2Doc id值重复： \" + id;\n throw new BeanDefinitionStoreException(msg);\n }\n\n if (folder != null) {\n apiDocService.addFolder(folder);\n }\n return bean;\n }\n\n @Override\n public Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {\n return bean;\n }\n\n /**\n * 解析 API 组，一组 API 对应一个 Controller 类， 其中每个 method 对应一个 api 。
\n * 只要有 @ApiDoc 注解，有会生成文档，没有这个注解就不会。\n *\n * @param bean\n * @param beanName\n * @return\n */\n public ApiFolderObject toApiFolder(Object bean, String beanName) throws BusinessException {\n\n Class clazz = Classes.getTargetClass(bean);\n Controller controller = AnnotationUtils.findAnnotation(clazz, Controller.class);\n if (controller == null) {\n // 不是 Controller 类，不用收集。\n return null;\n }\n if (log.isInfoEnabled()) {\n log.info(\"prepare to get API Info by bean: {}\", beanName);\n }\n\n List methods = MappingMethod.getMappingMethods(clazz);\n // Classes.getMethods(RequestMapping.class, clazz);\n if (methods == null || methods.size() == 0) {\n // 整个类中都没有任何 RequestMapping 的方法，不用收集。\n// if (log.isInfoEnabled()) {\n// log.info(\"No any @RequestMapping / method, no need to get, \" +\n// \"beanName = {}\", beanName);\n// }\n return null;\n }\n\n Api2Doc classApi2Doc = clazz.getAnnotation(Api2Doc.class);\n if (classApi2Doc != null && classApi2Doc.ignore()) {\n // 整个类的文档被忽略。\n if (log.isInfoEnabled()) {\n log.info(\"@Api2Doc ignore = true, no need to get, \" +\n \"beanName = {}\", beanName);\n }\n return null;\n }\n\n List ali2DocMethods = new ArrayList<>();\n for (MappingMethod mappingMethod : methods) {\n Method method = mappingMethod.getMethod();\n Api2Doc api2Doc = method.getAnnotation(Api2Doc.class);\n if (classApi2Doc == null && api2Doc == null) {\n // 本方法的文档被忽略。\n continue;\n }\n if (api2Doc != null && api2Doc.ignore()) {\n // 本方法的文档被忽略。\n continue;\n }\n ali2DocMethods.add(mappingMethod);\n }\n if (classApi2Doc == null && ali2DocMethods.size() == 0) {\n // 整个类中的方法，都忽略从 API 生成文档，不用收集。\n if (log.isInfoEnabled()) {\n log.info(\"all method were ignored, no need to get, beanName = {}\", beanName);\n }\n return null;\n }\n\n ApiFolderObject folder = new ApiFolderObject();\n\n folder.setSourceClass(clazz);\n\n String id = beanName;\n if (classApi2Doc != null && StringUtils.hasText(classApi2Doc.value())) {\n id = classApi2Doc.value();\n }\n if (classApi2Doc != null && StringUtils.hasText(classApi2Doc.id())) {\n id = classApi2Doc.id();\n }\n folder.setId(id);\n checkId(id);\n\n String pathPattern = \"api2doc/\" + id + \"/*.md\";\n try {\n Resource[] resources = Classes.scanResources(pathPattern);\n if (resources != null && resources.length > 0) {\n Map mds = new HashMap<>();\n for (Resource resource : resources) {\n String md = resource.getFilename();\n mds.put(ApiFolderObject.name2Id(md), md);\n }\n folder.setMds(mds);\n }\n } catch (IOException e) {\n String msg = \"scan classpath[\" + pathPattern + \"] failed: \" + e.getMessage();\n throw new BeanDefinitionStoreException(msg);\n }\n\n if (classApi2Doc != null) {\n folder.setOrder(classApi2Doc.order());\n }\n\n // API 组的名称。\n String name = beanName;\n RequestMapping classMapping = clazz.getAnnotation(RequestMapping.class);\n if (classMapping != null && StringUtils.hasText(classMapping.name())) {\n name = classMapping.name();\n }\n if (classApi2Doc != null && StringUtils.hasText(classApi2Doc.name())) {\n name = classApi2Doc.name();\n }\n folder.setName(name);\n\n // 这组 API 是否用了 RestPack\n RestPackController restPackController = clazz.getAnnotation(RestPackController.class);\n folder.setRestPack(restPackController != null);\n\n // API 组的注释。\n ApiComment apiComment = clazz.getAnnotation(ApiComment.class);\n folder.setComment(ApiCommentUtils.getComment(\n apiComment, null, null));\n\n // 在类上的 seeClass ，是默认的。\n Class defaultSeeClass = ApiCommentUtils.getDefaultSeeClass(\n apiComment, null);\n\n // API 组的路径前缀。\n String[] basePaths = getPath(classMapping);\n\n // 根据方法生成 API 文档。\n List docs = new ArrayList<>();\n for (MappingMethod method : ali2DocMethods) {\n ApiDocObject doc = getApiDoc(method, basePaths, beanName,\n classApi2Doc, defaultSeeClass);\n if (doc == null) {\n continue;\n }\n\n String docId = doc.getId();\n ApiDocObject existDoc = folder.getDoc(docId);\n if (existDoc != null) {\n String msg = \"文档id值重复： \" + docId + \"\\n\"\n + \"如果方法上没有用 @Api2Doc(id = \\\"xxx\\\") 来指定文档id，则重载方法会出现此问题。\\n\"\n + \"请在重载的方法上用 @Api2Doc(id = \\\"xxx\\\") 来指定一个不同的文档id\";\n throw new BeanDefinitionStoreException(msg);\n }\n\n doc.setFolder(folder);\n docs.add(doc);\n if (log.isInfoEnabled()) {\n log.info(\"add doc: {}/{}\", folder.getId(), docId);\n }\n }\n Collections.sort(docs);\n folder.addDocs(docs);\n\n return folder;\n }\n\n ApiDocObject getApiDoc(\n MappingMethod mappingMethod, String[] basePaths,\n String beanName, Api2Doc classApi2Doc,\n Class defaultSeeClass) throws BusinessException {\n\n Method method = mappingMethod.getMethod();\n\n // 只要有 @ApiDoc 注解（无论是本方法上，还是类上），有会生成文档，没有这个注解就不会。\n Api2Doc api2Doc = method.getAnnotation(Api2Doc.class);\n if (api2Doc == null && classApi2Doc == null) {\n return null;\n }\n\n ApiDocObject doc = new ApiDocObject();\n\n doc.setSourceMethod(method);\n\n // 获取文档的 id，以 @Api2Doc、方法名 为顺序获取。\n String id = method.getName();\n if (api2Doc != null && StringUtils.hasText(api2Doc.value())) {\n id = api2Doc.value();\n }\n if (api2Doc != null && StringUtils.hasText(api2Doc.id())) {\n id = api2Doc.id();\n }\n doc.setId(id);\n checkId(id);\n\n // 获取文档的排序。\n if (api2Doc != null) {\n doc.setOrder(api2Doc.order());\n }\n\n // 获取文档名称，按 @Api2Doc 、@Mapping、方法名的顺序获取。\n String name = method.getName();\n String mappingName = mappingMethod.getName();\n if (StringUtils.hasText(mappingName)) {\n name = mappingName;\n }\n if (api2Doc != null && StringUtils.hasText(api2Doc.name())) {\n name = api2Doc.name();\n }\n doc.setName(name);\n\n // 获取 API 的注释信息。\n ApiComment apiComment = method.getAnnotation(ApiComment.class);\n defaultSeeClass = ApiCommentUtils.getDefaultSeeClass(apiComment, defaultSeeClass);\n String docComment = ApiCommentUtils.getComment(apiComment, defaultSeeClass, name);\n doc.setComment(docComment);\n String docSample = ApiCommentUtils.getSample(apiComment, defaultSeeClass, name);\n doc.setSample(docSample);\n\n // 获取 API 的访问路径。\n String[] paths = mappingMethod.getPath();\n paths = combine(basePaths, paths);\n doc.setPaths(paths);\n\n // 获取 HTTP 方法。\n doc.setMethods(mappingMethod.getRequestMethod());\n\n // 收集参数信息。\n List apiParams = toApiParams(method, defaultSeeClass);\n if (apiParams != null && apiParams.size() > 0) {\n for (ApiParamObject apiParam : apiParams) {\n doc.addParam(apiParam);\n }\n }\n\n // 收集返回值信息。\n KeyedList totalResults = new KeyedList<>();\n ApiResultObject resultObject = ApiResultObject.parseResultType(method, totalResults);\n if (resultObject != null) {\n resultObject.setComment(docComment);\n resultObject.setSample(docSample);\n }\n doc.setResultType(resultObject);\n doc.setResults(totalResults.getAll());\n\n\n // 确定返回类型的描述。\n String returnTypeDesc = null;\n List results = doc.getResults();\n if (results != null && results.size() > 0) {\n ApiResultObject result = results.get(0);\n ApiDataType dataType = result.getDataType();\n if (dataType != null) {\n if (dataType == ApiDataType.ARRAY) {\n returnTypeDesc = result.getSourceType().getSimpleName() + \"[]\";\n } else {\n returnTypeDesc = result.getSourceType().getSimpleName();\n }\n }\n }\n if (returnTypeDesc == null) {\n Class returnType = doc.getSourceMethod().getReturnType();\n if (returnType != null && returnType != void.class) {\n returnTypeDesc = returnType.getSimpleName();\n }\n }\n doc.setReturnTypeDesc(returnTypeDesc);\n\n // 收集错误码信息。\n ApiErrors errorCodes = method.getAnnotation(ApiErrors.class);\n if (errorCodes != null && errorCodes.value() != null\n && errorCodes.value().length > 0) {\n for (ApiError errorCode : errorCodes.value()) {\n ApiErrorObject error = getError(errorCode);\n if (error == null) {\n continue;\n }\n doc.addError(error);\n }\n } else {\n ApiError errorCode = method.getAnnotation(ApiError.class);\n ApiErrorObject error = getError(errorCode);\n if (error != null) {\n doc.addError(error);\n }\n }\n\n return doc;\n }\n\n\n public List toApiParams(Method method, Class defaultSeeClass) {\n List result = new ArrayList<>();\n Set paramIds = new HashSet<>();\n\n Parameter[] params = method.getParameters();\n if (params != null && params.length > 0) {\n String[] paramNames = parameterNameDiscoverer.getParameterNames(method);\n for (int i = 0; i < params.length; i++) {\n Parameter param = params[i];\n\n Class paramClass = param.getType();\n ApiComment paramClassComment = paramClass.getAnnotation(ApiComment.class);\n if (paramClassComment != null) {\n // 从参数的类的属性中获取注释信息。\n List paramsFromClass = toApiParams(\n paramClass, defaultSeeClass);\n for (ApiParamObject paramFromClass : paramsFromClass) {\n if (paramIds.contains(paramFromClass.getId())) {\n continue;\n }\n paramIds.add(paramFromClass.getId());\n result.add(paramFromClass);\n }\n } else {\n // 从参数本身中获取注释信息。\n String paramName;\n if (paramNames != null) {\n paramName = paramNames[i];\n } else {\n paramName = param.getName();\n }\n\n ApiParamObject apiParamObject = toApiParam(param,\n paramName, param.getType(), defaultSeeClass);\n if (apiParamObject == null) {\n continue;\n }\n\n String paramId = apiParamObject.getId();\n if (paramIds.contains(paramId)) {\n String msg = \"参数id值重复： \" + paramId + \"，所在方法： \" + method;\n throw new BeanDefinitionStoreException(msg);\n }\n\n paramIds.add(paramId);\n result.add(apiParamObject);\n }\n }\n }\n return result;\n }\n\n /**\n * 从类的属性中获取注释信息。\n *\n * @param beanClass\n * @param defaultSeeClass\n * @return\n */\n public List toApiParams(Class beanClass, Class defaultSeeClass) {\n List result = new ArrayList<>();\n\n PropertyDescriptor[] props = PropertyUtils.getPropertyDescriptors(beanClass);\n if (props == null || props.length == 0) {\n return result;\n }\n\n for (PropertyDescriptor prop : props) {\n if (Api2DocUtils.isFilter(prop, beanClass)) {\n continue;\n }\n\n String fieldName = prop.getName();\n\n Method readMethod = prop.getReadMethod();\n if (readMethod == null) {\n continue;\n }\n Class fieldType = readMethod.getReturnType();\n\n Field field = Classes.getField(fieldName, beanClass);\n if (field == null) {\n continue;\n }\n\n ApiParamObject param = toApiParam(field, fieldName, fieldType,\n defaultSeeClass);\n if (param == null) {\n continue;\n }\n\n result.add(param);\n }\n\n Collections.sort(result);\n\n return result;\n }\n\n ApiErrorObject getError(ApiError errorCode) {\n if (errorCode == null) {\n return null;\n }\n\n ApiErrorObject error = new ApiErrorObject();\n String code = errorCode.value();\n error.setId(code);\n error.setName(code);\n\n checkId(code);\n\n String comment = errorCode.comment();\n if (comment == null) {\n comment = BusinessException.getMessage(code);\n }\n if (comment == null) {\n comment = \"\";\n }\n error.setComment(comment);\n return error;\n }\n\n ApiParamObject toApiParam(\n AnnotatedElement element, String elementName,\n Class elementType, Class defaultSeeClass) {\n\n ApiParamObject apiParamObject = new ApiParamObject();\n\n ApiParamLocation.collects(apiParamObject, element);\n\n String id = apiParamObject.getId();\n checkId(id);\n\n String name = apiParamObject.getName();\n if (StringUtils.isEmpty(name)) {\n name = elementName;\n }\n apiParamObject.setName(name);\n\n apiParamObject.setId(name);\n\n ApiComment apiComment = element.getAnnotation(ApiComment.class);\n ApiCommentUtils.setApiComment(apiComment, defaultSeeClass, apiParamObject);\n\n apiParamObject.setSourceType(elementType);\n\n ApiDataType dataType = convertType(elementType);\n apiParamObject.setDataType(dataType);\n\n return apiParamObject;\n }\n\n String[] combine(String[] classPaths, String[] methodPaths) {\n if (classPaths == null || classPaths.length == 0) {\n return methodPaths;\n }\n\n List paths = new ArrayList<>();\n for (String basePath : classPaths) {\n for (String srcPath : methodPaths) {\n String path = basePath + srcPath;\n if (paths.contains(path)) {\n continue;\n }\n paths.add(path);\n }\n }\n return paths.toArray(new String[paths.size()]);\n }\n\n ApiDataType convertType(Class paramType) {\n if (paramType == null) {\n return null;\n }\n paramType = Classes.toWrapType(paramType);\n\n if (paramType.equals(Boolean.class)) {\n return ApiDataType.BOOLEAN;\n }\n\n if (paramType.equals(Integer.class)\n || paramType.equals(Short.class)\n || paramType.equals(Byte.class)) {\n return ApiDataType.INT;\n }\n\n // Date 类型返回为 long 格式。\n ApiDataType dataType = DateConverter.dateAsLongType(paramType);\n if (dataType != null) {\n return dataType;\n }\n\n if (paramType.equals(Long.class)) {\n return ApiDataType.LONG;\n }\n\n if (paramType.equals(Float.class)\n || paramType.equals(Double.class)) {\n return ApiDataType.NUMBER;\n }\n\n if (paramType.equals(String.class)\n || paramType.equals(Character.class)\n || paramType.equals(StringBuffer.class)\n || paramType.equals(StringBuilder.class)) {\n return ApiDataType.STRING;\n }\n\n if (Classes.isInterface(paramType, Collection.class)) {\n return ApiDataType.ARRAY;\n }\n\n return ApiDataType.OBJECT;\n }\n\n private String[] getPath(RequestMapping mapping) {\n Set allPaths = new HashSet<>();\n\n if (mapping != null) {\n String[] paths = mapping.path();\n if (paths != null && paths.length > 0) {\n allPaths.addAll(Arrays.asList(paths));\n }\n\n paths = mapping.value();\n if (paths != null && paths.length > 0) {\n allPaths.addAll(Arrays.asList(paths));\n }\n }\n\n return allPaths.toArray(new String[allPaths.size()]);\n }\n\n\n private void checkId(String id) {\n // TODO: CHECK id.\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/Api2DocObjectFactory.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport com.terran4j.commons.api2doc.Api2DocMocker;\nimport com.terran4j.commons.api2doc.annotations.ApiComment;\nimport com.terran4j.commons.api2doc.domain.ApiDataType;\nimport com.terran4j.commons.api2doc.domain.DateConverter;\nimport com.terran4j.commons.util.Classes;\nimport com.terran4j.commons.util.Enums;\nimport org.apache.commons.beanutils.PropertyUtils;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.springframework.util.StringUtils;\n\nimport java.beans.PropertyDescriptor;\nimport java.lang.reflect.*;\nimport java.util.*;\n\n/**\n * 根据类上的 Api2Doc 注解信息，创建 JavaBean、数组、列表等对象。\n */\npublic class Api2DocObjectFactory {\n\n private static final Logger log = LoggerFactory.getLogger(Api2DocObjectFactory.class);\n\n public static Object createObject(ApiDataType dataType,\n Class elementType, String defaultValue) {\n if (dataType.isArrayType()) {\n int size = getArraySize(defaultValue, 1);\n return createList(elementType, size);\n } else if (dataType.isObjectType()) {\n return createBean(elementType);\n } else {\n if (DateConverter.isDateType(elementType)) {\n return DateConverter.dateAsLongValue(elementType);\n }\n if (StringUtils.hasText(defaultValue)) {\n return defaultValue;\n } else {\n return dataType.getDefault();\n }\n }\n }\n\n public static T createBean(Class clazz) {\n Stack> classStack = new Stack>();\n return createBean(clazz, null, classStack);\n }\n\n public static List createList(Class clazz, int size) {\n Stack> classStack = new Stack>();\n return doCreateList(clazz, size, classStack);\n }\n\n public static T[] createArray(Class clazz, int size) {\n Stack> classStack = new Stack>();\n return doCreateArray(clazz, size, classStack);\n }\n\n private static List doCreateList(Class clazz, int size, Stack> classStack) {\n List list = new ArrayList<>();\n\n if (classStack.contains(clazz)) {\n return list;\n }\n\n for (int i = 0; i < size; i++) {\n E element = createBean(clazz, null, classStack);\n list.add(element);\n }\n return list;\n }\n\n private static T[] doCreateArray(Class clazz, int size, Stack> classStack) {\n if (size < 0) {\n return null;\n }\n T[] array = (T[]) Array.newInstance(clazz, size);\n\n if (classStack.contains(clazz)) {\n return array;\n }\n\n for (int i = 0; i < size; i++) {\n Object element = createBean(clazz, null, classStack);\n Array.set(array, i, element);\n }\n return array;\n }\n\n\n /**\n * 如果是 JavaBean 类，就创建这个 JavaBean 对象；
\n * 如果是 List / Array 对象，则什么都不做；
\n * 如果是 简单类型 对象，就创建符合这个类型的值。\n *\n * @param clazz 数据对象的类型。\n * @return 填充后的数据对象。\n */\n private static T createBean(Class clazz, String defaultValue, Stack> classStack) {\n if (clazz == null) {\n return null;\n }\n\n final ApiDataType dataType = ApiDataType.toDataType(clazz);\n if (dataType == null) {\n log.warn(\"无法识别的类型, class = {}\", clazz);\n return null;\n }\n\n if (dataType.isArrayType()) {\n if (log.isInfoEnabled()) {\n log.info(\"数组类型，createBean 不处理, class = {}\", clazz);\n }\n return null;\n }\n\n if (dataType.isSimpleType()) {\n if (defaultValue == null) {\n defaultValue = dataType.getDefault();\n }\n Object result = dataType.parseValue(defaultValue);\n result = adaptSimpleType(result, clazz);\n return (T) result;\n }\n\n // 处理 JavaBean 对象的情况。\n if (dataType.isObjectType()) {\n\n T object = null;\n try {\n object = clazz.newInstance();\n } catch (InstantiationException e) {\n log.warn(\"不能根据类创建对象，class = {}, 原因：{}\", clazz, e.getMessage());\n return null;\n } catch (IllegalAccessException e) {\n log.warn(\"不能根据类创建对象，class = {}, 原因：{}\", clazz, e.getMessage());\n return null;\n }\n if (object == null) {\n log.warn(\"不能根据类创建对象，class = {}\", clazz);\n return null;\n }\n\n // 获取 JavaBean 的属性。\n PropertyDescriptor[] props = PropertyUtils.getPropertyDescriptors(clazz);\n if (props == null || props.length == 0) { // 没有属性就不用处理。\n return object;\n }\n\n // 之前有过此类的信息，不用再次输出。\n if (classStack.contains(clazz)) {\n return object;\n }\n\n // 有属性，设置属性值。\n classStack.push(clazz);\n for (PropertyDescriptor prop : props) {\n String fieldName = prop.getName();\n try {\n fillField(fieldName, object, classStack);\n } catch (Exception e) {\n log.warn(\"给字段设值出错， class = {}, fieldName = {}\", clazz, fieldName);\n }\n }\n classStack.pop();\n\n return object;\n }\n\n log.warn(\"无法识别的类型，class = {}\", clazz);\n return null;\n }\n\n private static void fillField(String name, Object bean, Stack> classStack) {\n Class clazz = Classes.getTargetClass(bean);\n\n PropertyDescriptor fieldProp = null;\n try {\n fieldProp = PropertyUtils.getPropertyDescriptor(bean, name);\n } catch (IllegalAccessException e) {\n throw new RuntimeException(e);\n } catch (InvocationTargetException e) {\n throw new RuntimeException(e);\n } catch (NoSuchMethodException e) {\n throw new RuntimeException(e);\n }\n if (fieldProp == null) {\n throw new RuntimeException(\"field[\" + name + \"] NOT found in class: \" + clazz);\n }\n if (Api2DocUtils.isFilter(fieldProp, clazz)) {\n return;\n }\n\n ApiComment classApiComment = clazz.getAnnotation(ApiComment.class);\n Class defaultSeeClass = ApiCommentUtils.getDefaultSeeClass(\n classApiComment, null);\n\n String fieldName = fieldProp.getName();\n\n Method getMethod = fieldProp.getReadMethod();\n if (getMethod == null) {\n log.warn(\"没有 getter 方法, class = {}, fieldName = {}\", clazz, fieldName);\n return;\n }\n\n Method setMethod = fieldProp.getWriteMethod();\n if (setMethod == null) {\n log.warn(\"没有 setter 方法, class = {}, fieldName = {}\", clazz, fieldName);\n return;\n }\n\n Class fieldClass = getMethod.getReturnType();\n Field field = Classes.getField(fieldName, clazz);\n if (field == null) {\n log.warn(\"找不到字段定义， class = {}, fieldName = {}\", clazz, fieldName);\n return;\n }\n\n ApiDataType fieldDataType = ApiDataType.toDataType(fieldClass);\n if (fieldDataType == null) {\n log.warn(\"未知字段类型\");\n return;\n }\n\n Object fieldValue = null;\n if (fieldDataType.isSimpleType()) {\n\n ApiComment apiComment = field.getAnnotation(ApiComment.class);\n String defaultValue = ApiCommentUtils.getSample(\n apiComment, defaultSeeClass, fieldName);\n fieldValue = createBean(fieldClass, defaultValue, classStack);\n\n Class paramType = setMethod.getParameterTypes()[0];\n fieldValue = adaptSimpleType(fieldValue, paramType);\n } else if (fieldDataType.isObjectType()) {\n fieldValue = createBean(fieldClass, null, classStack);\n } else if (fieldDataType.isArrayType()) {\n int size = 1;\n ApiComment apiComment = field.getAnnotation(ApiComment.class);\n if (apiComment != null) {\n String sizeText = ApiCommentUtils.getSample(\n apiComment, defaultSeeClass, field.getName());\n size = getArraySize(sizeText, size);\n }\n Class elementClass = getArrayElementClass(field);\n if (fieldClass.isArray()) {\n fieldValue = doCreateArray(elementClass, size, classStack);\n } else if (List.class.equals(fieldClass)) {\n fieldValue = doCreateList(elementClass, size, classStack);\n } else {\n log.warn(\"不支持的集合类型，目前只支持 Array OR List， class = {}, fieldName = {}\" +\n \", fieldClass = {}\", clazz, fieldName, fieldClass);\n }\n }\n\n try {\n setMethod.invoke(bean, fieldValue);\n } catch (Exception e) {\n log.warn(\"调用 setter 方法失败, \\n\" +\n \"clazz = {}, \\n\" +\n \"setMethod = {}, \\n\" +\n \"fieldValue = {}, \\n\" +\n \"失败原因： {}\", clazz, setMethod, fieldValue, e.getMessage());\n }\n }\n\n private static int getArraySize(String sizeText, int defaultValue) {\n if (StringUtils.hasText(sizeText)) {\n try {\n return Integer.parseInt(sizeText);\n } catch (Exception e) {\n log.warn(\"List 或 Array 类型的字段上，\" +\n \"@ApiComment 注解的 sample 属性应该是数字\" +\n \"（代表它在 mock 时元素的个数）, sample = {}\", sizeText);\n }\n }\n return defaultValue;\n }\n\n private static Object adaptSimpleType(Object sourceValue, Class targetType) {\n if (Long.class.equals(targetType) || long.class.equals(targetType)) {\n return Long.parseLong(sourceValue.toString());\n }\n if (Byte.class.equals(targetType) || byte.class.equals(targetType)) {\n return Byte.parseByte(sourceValue.toString());\n }\n if (Short.class.equals(targetType) || short.class.equals(targetType)) {\n return Short.parseShort(sourceValue.toString());\n }\n if (Float.class.equals(targetType) || float.class.equals(targetType)) {\n return Float.parseFloat(sourceValue.toString());\n }\n if (DateConverter.isDateType(targetType)) {\n return DateConverter.dateAsLongValue(targetType);\n }\n\n if (targetType.isEnum()) {\n return Enums.getEnumObject(targetType, sourceValue.toString());\n }\n\n return sourceValue;\n }\n\n private static final Class getArrayElementClass(Field field) {\n\n Class returnType = field.getType();\n if (returnType.isArray()) {\n Class elementClass = returnType.getComponentType();\n return elementClass;\n }\n\n if (Classes.isInterface(returnType, Collection.class)) {\n Type type = field.getGenericType();\n Type elementType = Api2DocUtils.getGenericType(type);\n if (elementType instanceof Class) {\n Class elementClass = (Class) elementType;\n return elementClass;\n }\n }\n\n log.warn(\"不支持的数组类型\");\n return null;\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/Api2DocProperties.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport org.springframework.beans.factory.annotation.Value;\nimport org.springframework.stereotype.Service;\n\n@Service\npublic class Api2DocProperties {\n\n @Value(\"${server.url:http://localhost:8080}\")\n private String serverURL;\n\n @Value(\"${api2doc.showCurl:true}\")\n private boolean showCurl = true;\n\n @Value(\"${service.name:}\")\n private String serviceName;\n\n @Value(\"${api2doc.title:}\")\n private String api2docTitle;\n\n @Value(\"${api2doc.icon:}\")\n private String api2docIcon;\n\n public String getServerURL() {\n return serverURL;\n }\n\n public boolean isShowCurl() {\n return showCurl;\n }\n\n public String getServiceName() {\n return serviceName;\n }\n\n public String getApi2docTitle() {\n return api2docTitle;\n }\n\n public String getApi2docIcon() {\n return api2docIcon;\n }\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/Api2DocService.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport com.terran4j.commons.api2doc.domain.ApiDocObject;\nimport com.terran4j.commons.api2doc.domain.ApiFolderObject;\nimport com.terran4j.commons.util.value.KeyedList;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.springframework.stereotype.Service;\n\nimport java.util.List;\n\n@Service\npublic class Api2DocService {\n\n private static final Logger log = LoggerFactory.getLogger(Api2DocService.class);\n\n private static final String v = String.valueOf(System.currentTimeMillis());\n\t\n\tprivate final KeyedList folders = new KeyedList<>();\n\t\n\tpublic boolean hasFolder(String id) {\n\t\treturn folders.containsKey(id);\n\t}\n\t\n\tpublic ApiFolderObject getFolder(String id) {\n\t\treturn folders.get(id);\n\t}\n\t\n\tpublic void addFolder(ApiFolderObject folder) {\n\t\tif (folder == null) {\n\t\t\tthrow new NullPointerException(\"ApiFolderObject is null\");\n\t\t}\n\t\tfolders.add(folder.getId(), folder);\n\t}\n\t\n\tpublic List getFolders() {\n\t\treturn folders.getAll();\n\t}\n\n public String addAppDocVersion(String path) {\n\t if (path.indexOf(\"?\") > 0) {\n\t return path + \"&v=\" + getAppDocVersion();\n } else {\n return path + \"?v=\" + getAppDocVersion();\n }\n }\n\n public String getAppDocVersion() {\n return v;\n }\n\n public String getComponentVersion() {\n\t return v;\n }\n\n public ApiDocObject getDocObject(String folderId, String docId) throws Exception {\n ApiFolderObject folder = getFolder(folderId);\n if (folder == null) {\n log.warn(\"ApiFolder NOT Found: {}\", folderId);\n return null;\n }\n\n ApiDocObject doc = folder.getDoc(docId);\n if (doc == null) {\n if (log.isWarnEnabled()) {\n log.warn(\"ApiDoc NOT Found: {}\", folderId);\n }\n return null;\n }\n\n return doc;\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/Api2DocUtils.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport com.fasterxml.jackson.annotation.JsonIgnore;\nimport com.terran4j.commons.api2doc.annotations.ApiComment;\nimport com.terran4j.commons.api2doc.domain.ApiDocObject;\nimport com.terran4j.commons.api2doc.domain.ApiObject;\nimport com.terran4j.commons.api2doc.domain.ApiParamLocation;\nimport com.terran4j.commons.api2doc.domain.ApiParamObject;\nimport com.terran4j.commons.restpack.RestPackIgnore;\nimport com.terran4j.commons.util.Classes;\nimport com.terran4j.commons.util.Encoding;\nimport com.terran4j.commons.util.Strings;\nimport com.terran4j.commons.util.error.BusinessException;\nimport com.terran4j.commons.util.value.ValueSource;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.bind.annotation.RequestMethod;\n\nimport java.beans.PropertyDescriptor;\nimport java.io.UnsupportedEncodingException;\nimport java.lang.reflect.Field;\nimport java.lang.reflect.Method;\nimport java.lang.reflect.ParameterizedType;\nimport java.lang.reflect.Type;\nimport java.net.URLEncoder;\nimport java.util.*;\n\npublic class Api2DocUtils {\n\n public static String toURL(ApiDocObject doc, String serverURL) {\n if (doc == null) {\n throw new NullPointerException(\"doc is null.\");\n }\n\n boolean hasGetMethod = false;\n RequestMethod[] methods = doc.getMethods();\n if (methods != null) {\n for (RequestMethod method : methods) {\n if (method == RequestMethod.GET) {\n hasGetMethod = true;\n }\n }\n } else {\n hasGetMethod = true;\n }\n if (!hasGetMethod) {\n // TODO: 暂时不支持非 GET 的请求。\n return null;\n }\n\n String docURL = serverURL + doc.getPaths()[0];\n List params = doc.getParams();\n Map pathParams = new HashMap<>();\n Map getParams = new HashMap<>();\n if (params != null) {\n for (ApiParamObject param : params) {\n if (param.getLocation() == ApiParamLocation.PathVariable) {\n String value = param.getSample().getValue();\n if (StringUtils.isEmpty(value)) {\n value = param.getDataType().getDefault();\n }\n pathParams.put(param.getId(), value);\n }\n if (param.getLocation() == ApiParamLocation.RequestParam) {\n String value = param.getSample().getValue();\n if (StringUtils.isEmpty(value)) {\n continue;\n }\n getParams.put(param.getId(), value);\n }\n }\n }\n\n if (pathParams.size() > 0) {\n docURL = Strings.format(docURL, new ValueSource() {\n\n @Override\n public String get(String key) {\n String value = pathParams.get(key);\n if (value == null) {\n return null;\n }\n return encode(value);\n }\n }, \"{\", \"}\", null);\n }\n\n if (getParams.size() > 0) {\n\n List keys = new ArrayList<>();\n keys.addAll(getParams.keySet());\n keys.sort(new Comparator() {\n @Override\n public int compare(String o1, String o2) {\n return o1.compareTo(o2);\n }\n });\n\n StringBuffer sb = new StringBuffer();\n for (String key : keys) {\n String value = getParams.get(key);\n if (sb.length() > 0) {\n sb.append(\"&\");\n }\n sb.append(key).append(\"=\").append(encode(value));\n }\n docURL = docURL + \"?\" + sb.toString();\n }\n\n return docURL;\n }\n\n private static String encode(String text) {\n try {\n return URLEncoder.encode(text, Encoding.UTF8.getName());\n } catch (UnsupportedEncodingException e) {\n throw new RuntimeException(e);\n }\n }\n\n// public static final void setApiComment(ApiComment apiComment, ApiObject apiObject) {\n// if (apiComment != null && StringUtils.hasText(apiComment.value())) {\n// String commentText = getComment(apiComment);\n// apiObject.setComment(commentText);\n// }\n// if (apiComment != null && StringUtils.hasText(apiComment.sample())) {\n// if (StringUtils.hasText(apiComment.sample())) {\n// apiObject.setSample(apiComment.sample());\n// }\n// }\n// }\n//\n// public static final String getComment(ApiComment apiComment) {\n// String comment = apiComment.value();\n// if (StringUtils.isEmpty(comment)) {\n// return null;\n// }\n// return comment.trim();\n// }\n//\n// public static final String getSample(ApiComment apiComment, Class clazz) throws BusinessException {\n// String sample = apiComment.sample();\n// if (StringUtils.isEmpty(sample)) {\n// return null;\n// }\n// return sample.trim();\n//\n//// if (!(sample.startsWith(\"@\") && sample.endsWith(\"@\"))) {\n//// return sample.replaceAll(\"\\n\", \"
\");\n//// }\n////\n//// String fileName = sample.substring(1, sample.length() - 1);\n//// String json = Strings.getString(clazz, fileName);\n//// if (StringUtils.isEmpty(json)) {\n//// throw new BusinessException(ErrorCodes.CONFIG_ERROR)\n//// .put(\"package\", clazz.getPackage().getName())\n//// .put(\"fileName\", fileName)\n//// .setMessage(\"在包 ${package} 中找不到文件： ${fileName}\");\n//// }\n//// return json;\n// }\n\n public static final Class getArrayElementClass(Method method) {\n\n Class returnType = method.getReturnType();\n if (returnType.isArray()) {\n Class elementClass = returnType.getComponentType();\n return elementClass;\n }\n\n if (Classes.isInterface(returnType, Collection.class)) {\n Type gType = method.getGenericReturnType();\n Type elementType = getGenericType(gType);\n if (elementType instanceof Class) {\n Class elementClass = (Class) elementType;\n return elementClass;\n }\n }\n\n return null;\n }\n\n public static final Type getGenericType(Type gType) {\n // 如果gType是泛型类型对像。\n if (gType instanceof ParameterizedType) {\n ParameterizedType pType = (ParameterizedType) gType;\n // 获得泛型类型的泛型参数\n Type[] gArgs = pType.getActualTypeArguments();\n return gArgs[gArgs.length - 1];\n } else {\n System.out.println(\"获取泛型信息失败\");\n return null;\n }\n }\n\n public static final boolean isFilter(\n PropertyDescriptor prop, Class clazz) {\n\n String fieldName = prop.getName();\n\n // class 只是 Java 对象自带的 Object.getClass() 方法，忽略掉。\n if (\"class\".equals(fieldName)) {\n return true;\n }\n\n // 忽略掉需要忽略的字段。\n Field field = Classes.getField(fieldName, clazz);\n if (field != null) {\n if (field.getAnnotation(RestPackIgnore.class) != null) {\n return true;\n }\n if (field.getAnnotation(JsonIgnore.class) != null) {\n return true;\n }\n }\n\n return false;\n }\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/ApiCommentUtils.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport com.terran4j.commons.api2doc.annotations.ApiComment;\nimport com.terran4j.commons.api2doc.domain.ApiObject;\nimport com.terran4j.commons.util.Classes;\nimport org.springframework.util.StringUtils;\n\nimport java.lang.reflect.Field;\nimport java.util.ArrayList;\nimport java.util.List;\nimport java.util.Stack;\n\npublic class ApiCommentUtils {\n\n\n public static Class getDefaultSeeClass(ApiComment apiComment,\n Class previousSeeClass) {\n if (apiComment == null) {\n return previousSeeClass;\n }\n\n Class defaultSeeClass = apiComment.seeClass();\n if (defaultSeeClass == Object.class) {\n return previousSeeClass;\n }\n\n return defaultSeeClass;\n }\n\n public static final void setApiComment(ApiComment apiComment,\n Class defaultSeeClass, ApiObject apiObject) {\n String comment = getComment(apiComment, defaultSeeClass, apiObject.getId());\n if (comment != null) {\n apiObject.setComment(comment);\n }\n String sample = getSample(apiComment, defaultSeeClass, apiObject.getId());\n if (sample != null) {\n apiObject.setSample(sample);\n }\n }\n\n// public static final ApiComment getComment(Field field, Class defaultSeeClass) {\n// ApiComment apiComment = field.getAnnotation(ApiComment.class);\n// if (apiComment !)\n// }\n\n public static final String getComment(ApiComment apiComment,\n Class defaultSeeClass, String defaultName) {\n\n if (apiComment != null) {\n String comment = apiComment.value();\n if (StringUtils.hasText(comment)) {\n return comment.trim();\n }\n }\n\n ApiComment seeComment = getSeeApiComment(\n apiComment, defaultSeeClass, defaultName);\n if (seeComment == null) {\n return null;\n }\n\n String comment = seeComment.value();\n if (StringUtils.hasText(comment)) {\n return comment.trim();\n }\n\n return null;\n }\n\n public static final String getSample(ApiComment apiComment,\n Class defaultSeeClass, String defaultName) {\n if (apiComment != null) {\n String sample = apiComment.sample();\n if (StringUtils.hasText(sample)) {\n return sample.trim();\n }\n }\n\n ApiComment seeComment = getSeeApiComment(\n apiComment, defaultSeeClass, defaultName);\n if (seeComment == null) {\n return null;\n }\n\n String sample = seeComment.sample();\n if (StringUtils.hasText(sample)) {\n return sample.trim();\n }\n\n return null;\n }\n\n /**\n * 获取可参照的 @ApiComment 注解对象。\n * @param apiComment\n * @param defaultSeeClass\n * @param defaultSeeField\n * @return\n */\n private static ApiComment getSeeApiComment(\n ApiComment apiComment, Class defaultSeeClass, String defaultSeeField) {\n\n Class seeClass = null;\n if (apiComment != null ) {\n seeClass = apiComment.seeClass();\n }\n if (seeClass == null || seeClass == Object.class) {\n seeClass = defaultSeeClass;\n }\n if (seeClass == null || seeClass == Object.class) {\n return null;\n }\n\n String seeField = null;\n if (apiComment != null) {\n seeField = apiComment.seeField();\n }\n if (StringUtils.isEmpty(seeField)) {\n seeField = defaultSeeField;\n }\n if (StringUtils.isEmpty(seeField)) {\n return null;\n }\n\n // 记录引用过的 seeClass， 用于循环引用检测。\n List> path = new ArrayList<>();\n Field field = null;\n ApiComment seeComment = null;\n while (seeClass != null) {\n\n // 循环引用检测。\n if (path.contains(seeClass)) {\n StringBuffer sb = new StringBuffer();\n sb.append(\"@ApiComment 中的 seeClass 不允许循环引用：\");\n for (int i = 0; i < path.size(); i++) {\n if (i > 0) {\n sb.append(\" --> \");\n }\n sb.append(seeClass.getSimpleName());\n }\n throw new RuntimeException(sb.toString());\n }\n path.add(seeClass);\n\n // 寻找匹配字段中的 ApiComment 。\n field = Classes.getField(seeField, seeClass);\n if (field != null) {\n seeComment = field.getAnnotation(ApiComment.class);\n if (seeComment != null) {\n return seeComment;\n }\n }\n\n ApiComment parentApiComment = seeClass.getAnnotation(ApiComment.class);\n if (parentApiComment == null) {\n break;\n }\n seeClass = parentApiComment.seeClass();\n }\n\n return null;\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/ClasspathFreeMarker.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport java.io.IOException;\nimport java.util.HashMap;\nimport java.util.Map;\n\nimport org.springframework.stereotype.Service;\nimport org.springframework.ui.freemarker.FreeMarkerTemplateUtils;\n\nimport com.terran4j.commons.util.Encoding;\n\nimport freemarker.cache.ClassTemplateLoader;\nimport freemarker.cache.TemplateLoader;\nimport freemarker.template.Configuration;\nimport freemarker.template.Template;\nimport freemarker.template.TemplateException;\n\n@Service\npublic class ClasspathFreeMarker {\n\n\tprivate final Map templates = new HashMap();\n\n\tprivate final Configuration freeMarker;\n\n\tpublic ClasspathFreeMarker() {\n\t\tsuper();\n\n\t\ttry {\n\t\t\tfreeMarker = new Configuration(Configuration.VERSION_2_3_25);\n\t\t\tfreeMarker.setDefaultEncoding(Encoding.UTF8.getName());\n\t\t\tTemplateLoader ctl = new ClassTemplateLoader(getClass(), \"/\");\n\t\t\tfreeMarker.setTemplateLoader(ctl);\n\t\t} catch (Exception e) {\n\t\t\tthrow new RuntimeException(e);\n\t\t}\n\t}\n\n\tprivate String getPath(Class clazz, String fileName) {\n\t\tString path = clazz.getPackage().getName().replace('.', '/') + \"/\" + fileName;\n\t\treturn path;\n\t}\n\n\tpublic final Template getTemplate(Class clazz, String fileName) {\n\t\tString path = getPath(clazz, fileName);\n\n\t\tTemplate template = templates.get(path);\n\t\tif (template != null) {\n\t\t\treturn template;\n\t\t}\n\n\t\tsynchronized (ClasspathFreeMarker.class) {\n\t\t\ttemplate = templates.get(path);\n\t\t\tif (template != null) {\n\t\t\t\treturn template;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\ttemplate = freeMarker.getTemplate(path);\n\t\t\t\ttemplates.put(path, template);\n\t\t\t\treturn template;\n\t\t\t} catch (IOException e) {\n\t\t\t\tthrow new RuntimeException(e);\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic final String build(Template template, Map model) //\n\t\t\tthrows IOException, TemplateException {\n\t\tif (!templates.containsValue(template)) {\n\t\t\tString msg = \"Can't build from the tempate which NOT get by calling this method:\\n\"\n\t\t\t\t\t+ \"ClasspathFreeMarker.getTemplate(Class clazz, String fileName)\";\n\t\t\tthrow new UnsupportedOperationException(msg);\n\t\t}\n\t\tString html = FreeMarkerTemplateUtils.processTemplateIntoString( //\n\t\t\t\ttemplate, model);\n\t\treturn html;\n\t}\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/CurlBuilder.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport com.terran4j.commons.api2doc.domain.ApiDocObject;\nimport com.terran4j.commons.api2doc.domain.ApiParamLocation;\nimport com.terran4j.commons.api2doc.domain.ApiParamObject;\nimport com.terran4j.commons.util.Encoding;\nimport com.terran4j.commons.util.Strings;\nimport com.terran4j.commons.util.value.KeyedList;\nimport com.terran4j.commons.util.value.ValueSource;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.springframework.util.StringUtils;\nimport org.springframework.web.bind.annotation.RequestMethod;\n\nimport java.io.UnsupportedEncodingException;\nimport java.net.URLDecoder;\nimport java.net.URLEncoder;\nimport java.util.HashMap;\nimport java.util.Iterator;\nimport java.util.List;\nimport java.util.Map;\n\npublic class CurlBuilder {\n\n private static final Logger log = LoggerFactory.getLogger(CurlBuilder.class);\n\n private static final String enter = \" \\\\\\n\";\n\n public static String toCurl(ApiDocObject docObject, String serverURL) {\n\n final List allParams = docObject.getParams();\n final KeyedList headers = new KeyedList<>();\n final KeyedList params = new KeyedList<>();\n final KeyedList cookies = new KeyedList<>();\n final Map pathVars = new HashMap<>();\n final KeyedList parts = new KeyedList<>();\n\n if (allParams.size() > 0) {\n for (ApiParamObject param : allParams) {\n String key = param.getId();\n\n String value = param.getSample().getValue();\n if (StringUtils.isEmpty(value)) {\n Class paramType = param.getSourceType();\n if (paramType == String.class) {\n value = key;\n } else {\n value = param.getDataType().getDefault();\n }\n }\n\n if (param.getLocation() == ApiParamLocation.RequestParam) {\n params.add(key, value);\n }\n if (param.getLocation() == ApiParamLocation.PathVariable) {\n pathVars.put(key, value);\n }\n if (param.getLocation() == ApiParamLocation.RequestHeader) {\n headers.add(key, value);\n }\n if (param.getLocation() == ApiParamLocation.CookieValue) {\n cookies.add(key, value);\n }\n if (param.getLocation() == ApiParamLocation.RequestPart) {\n parts.add(key, value);\n }\n }\n }\n\n RequestMethod[] requestMethods = docObject.getMethods();\n RequestMethod requestMethod = requestMethods[0];\n StringBuilder sb = new StringBuilder(\"curl\");\n if (parts.size() == 0) {\n // 没有上传文件，才指定方法。\n sb.append(\" -X \").append(requestMethod.name());\n }\n sb.append(enter);\n\n // 将 Header 参数拼接起来。\n if (headers.size() > 0) {\n for (int i = 0; i < headers.size(); i++) {\n String key = headers.getKey(i);\n String value = headers.get(i);\n sb.append(\" -H \\\"\").append(key).append(\": \").append(value)\n .append(\"\\\"\").append(enter);\n }\n }\n\n if (cookies.size() > 0) {\n sb.append(\" -b \\\"\");\n sb.append(joinText(cookies, \";\", \"=\"));\n sb.append(\"\\\"\").append(enter);\n }\n\n // 将 URL 中的 {xx} 变量用参数的示例值代替。\n String url = serverURL + docObject.getPaths()[0];\n if (pathVars.size() > 0) {\n ValueSource vars = new ValueSource() {\n @Override\n public String get(String key) {\n return encode(pathVars.get(key));\n }\n };\n url = Strings.format(url, vars, \"{\", \"}\", null);\n }\n\n // 将“参数”拼起来。\n if (params.size() > 0) {\n if (parts.size() > 0) {\n // 参数按 multipart 的方法传。\n for (int i = 0; i < params.size(); i++) {\n String key = params.getKey(i);\n String value = params.get(i);\n sb.append(\" -F \\\"\").append(key).append(\"=\").append(value)\n .append(\"\\\"\").append(enter);\n }\n } else if (requestMethod == RequestMethod.POST) {\n // 参数按 post 的方法传。\n sb.append(\" -d \\\"\").append(joinText(params, \"&\", \"=\"))\n .append(\"\\\"\").append(enter);\n } else {\n // 参数附加到 URL 后面。\n url += (\"?\" + joinText(params, \"&\", \"=\"));\n }\n }\n\n // 追加 multipart 参数。\n if (parts.size() > 0) {\n for (int i = 0; i < parts.size(); i++) {\n String key = parts.getKey(i);\n String value = parts.get(i);\n sb.append(\" -F \\\"\").append(key).append(\"=@\").append(value)\n .append(\"\\\"\").append(enter);\n }\n }\n\n // 将 URL 拼接起来。\n sb.append(\" \\\"\").append(url).append(\"\\\"\");\n\n String curl = sb.toString();\n if (log.isInfoEnabled()) {\n log.info(\"doc[{}]'s curl:\\n{}\", docObject.getId(), curl);\n }\n return curl;\n }\n\n /**\n * 连接成字符串，并将 value 值进行 URL 编码。\n */\n public static final String joinText(KeyedList params,\n String joiner, String splitter) {\n StringBuffer sb = new StringBuffer();\n boolean first = true;\n Iterator it = params.keySet().iterator();\n while (it.hasNext()) {\n String key = it.next();\n String value = params.get(key);\n if (!first) {\n sb.append(joiner);\n }\n sb.append(key).append(splitter).append(encode(value));\n first = false;\n }\n return sb.toString();\n }\n\n private static String encode(String value) {\n try {\n // 对于空格的编码，有的地方不认 + ，所以统一转成： %20\n String str = URLEncoder.encode(value, Encoding.UTF8.getName());\n return str.replaceAll(\"\\\\+\", \"%20\");\n } catch (UnsupportedEncodingException e) {\n throw new RuntimeException(e);\n }\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/DocMenuBuilder.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport com.terran4j.commons.api2doc.controller.MenuData;\nimport com.terran4j.commons.api2doc.domain.ApiDocObject;\nimport com.terran4j.commons.api2doc.domain.ApiFolderObject;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\n\nimport java.io.UnsupportedEncodingException;\nimport java.net.URLEncoder;\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.Map;\n\n@Service\npublic class DocMenuBuilder {\n\n @Autowired\n private Api2DocService apiDocService;\n\n public List getMenuGroups() {\n List menuGroups = new ArrayList<>();\n\n List folders = apiDocService.getFolders();\n if (folders == null || folders.size() == 0) {\n return menuGroups;\n }\n\n for (ApiFolderObject folder : folders) {\n MenuData menuGroup = getMenuGroup(folder);\n menuGroups.add(menuGroup);\n }\n\n Collections.sort(menuGroups);\n\n return menuGroups;\n }\n\n public MenuData getMenuGroup(ApiFolderObject folder) {\n String folderId = folder.getId();\n String folderName = folder.getName();\n\n MenuData menuGroup = new MenuData();\n menuGroup.setId(folderId);\n menuGroup.setIndex(folderId);\n menuGroup.setName(folderName);\n menuGroup.setFolder(true);\n menuGroup.setOrder(folder.getOrder());\n\n List children = new ArrayList<>();\n\n Map mds = folder.getMds();\n if (mds != null && mds.size() > 0) {\n for (String md : mds.values()) {\n MenuData menu = getMenu(md, folderId);\n children.add(menu);\n }\n }\n\n List docs = folder.getDocs();\n if (docs != null) {\n for (ApiDocObject doc : docs) {\n MenuData menu = getMenu(doc, folderId);\n children.add(menu);\n }\n }\n\n Collections.sort(children);\n menuGroup.setChildren(children);\n return menuGroup;\n }\n\n public MenuData getMenu(String mdFileName, String folderId) {\n int offset = mdFileName.indexOf(\"-\");\n String orderText = mdFileName.substring(0, offset);\n int order = Integer.parseInt(orderText);\n String docName = mdFileName.substring(offset + 1,\n mdFileName.length() - \".md\".length());\n String docId = ApiFolderObject.name2Id(mdFileName);\n MenuData menu = new MenuData();\n\n String pageId = \"md-\" + folderId + \"-\" + docId;\n menu.setId(pageId);\n menu.setIndex(pageId);\n String url = getPageURL(pageId);\n menu.setUrl(url);\n\n menu.setFolder(false);\n menu.setName(docName);\n menu.setOrder(order);\n\n return menu;\n }\n\n public MenuData getMenu(ApiDocObject doc, String folderId) {\n MenuData menu = new MenuData();\n\n String pageId = \"api-\" + folderId + \"-\" + doc.getId();\n menu.setId(pageId);\n menu.setIndex(pageId);\n String url = getPageURL(pageId);\n menu.setUrl(url);\n\n menu.setFolder(false);\n menu.setName(doc.getName());\n menu.setOrder(doc.getOrder());\n\n return menu;\n }\n\n private String getPageURL(String pageId) {\n try {\n String p = URLEncoder.encode(pageId, \"UTF-8\");\n String path = \"/api2doc/home.html?p=\" + p;\n return apiDocService.addAppDocVersion(path);\n } catch (UnsupportedEncodingException e) {\n throw new RuntimeException(\"Can't encoding: \" + pageId, e);\n }\n }\n}" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/DocPageBuilder.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport com.terran4j.commons.api2doc.domain.ApiDocObject;\nimport com.terran4j.commons.api2doc.domain.ApiFolderObject;\nimport com.terran4j.commons.restpack.HttpResult;\nimport com.terran4j.commons.restpack.config.RestPackConfiguration;\nimport com.terran4j.commons.util.Strings;\nimport com.vladsch.flexmark.ast.Node;\nimport com.vladsch.flexmark.ext.spec.example.SpecExampleExtension;\nimport com.vladsch.flexmark.ext.tables.TablesExtension;\nimport com.vladsch.flexmark.html.HtmlRenderer;\nimport com.vladsch.flexmark.parser.Parser;\nimport com.vladsch.flexmark.parser.ParserEmulationProfile;\nimport com.vladsch.flexmark.util.KeepType;\nimport com.vladsch.flexmark.util.options.MutableDataSet;\nimport freemarker.template.Template;\nimport freemarker.template.TemplateException;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\nimport org.springframework.util.StringUtils;\n\nimport javax.annotation.PostConstruct;\nimport java.io.IOException;\nimport java.util.Arrays;\nimport java.util.HashMap;\nimport java.util.Map;\n\n@Service\npublic class DocPageBuilder {\n\n private static final Logger log = LoggerFactory.getLogger(DocPageBuilder.class);\n\n private static final String FILE_DOC_MD = \"doc.md.ftl\";\n\n @Autowired\n private Api2DocProperties api2DocProperties;\n\n @Autowired\n private Api2DocService apiDocService;\n\n @Autowired\n private ClasspathFreeMarker freeMarker;\n\n private Template mdTemplate = null;\n\n private Parser parser = null;\n\n private HtmlRenderer renderer = null;\n\n @PostConstruct\n public void init() {\n try {\n mdTemplate = freeMarker.getTemplate(DocPageBuilder.class, FILE_DOC_MD);\n\n MutableDataSet options = new MutableDataSet();\n options.setFrom(ParserEmulationProfile.GITHUB_DOC);\n options.set(Parser.EXTENSIONS, Arrays.asList(\n TablesExtension.create(), // 表格渲染插件。\n SpecExampleExtension.create() // 代码渲染插件。\n ));\n\n // References compatibility\n options.set(Parser.REFERENCES_KEEP, KeepType.LAST);\n\n // Set GFM table parsing options\n options.set(TablesExtension.COLUMN_SPANS, false) //\n .set(TablesExtension.MIN_HEADER_ROWS, 1) //\n .set(TablesExtension.MAX_HEADER_ROWS, 1) //\n .set(TablesExtension.APPEND_MISSING_COLUMNS, true) //\n .set(TablesExtension.DISCARD_EXTRA_COLUMNS, true) //\n .set(TablesExtension.WITH_CAPTION, false) //\n .set(TablesExtension.HEADER_SEPARATOR_COLUMN_MATCH, true);\n\n // Setup List Options for GitHub profile which is kramdown for documents\n options.setFrom(ParserEmulationProfile.GITHUB_DOC);\n\n // You can re-use parser and renderer instances\n parser = Parser.builder(options).build();\n renderer = HtmlRenderer.builder(options).build();\n } catch (Exception e) {\n throw new RuntimeException(e);\n }\n }\n\n public String md2Html(String md) throws Exception {\n Node document = parser.parse(md);\n String html = renderer.render(document);\n return html;\n }\n\n// public String md2HtmlPage(String md, String title) throws Exception {\n// String content = md2Html(md);\n//\n// Map model = new HashMap();\n// if (title != null) {\n// model.put(\"title\", title);\n// }\n// model.put(\"content\", content);\n// model.put(\"v\", apiDocService.getComponentVersion());\n//\n// String html = freeMarker.build(docTemplate, model);\n// return html;\n// }\n//\n// public ApiDocObject getDocObject(String folderId, String docId) throws Exception {\n// ApiFolderObject folder = apiDocService.getFolder(folderId);\n// if (folder == null) {\n// log.warn(\"ApiFolder NOT Found: {}\", folderId);\n// return null;\n// }\n//\n// ApiDocObject doc = folder.getDoc(docId);\n// if (doc == null) {\n// if (log.isWarnEnabled()) {\n// log.warn(\"ApiDoc NOT Found: {}\", folderId);\n// }\n// return null;\n// }\n//\n// return doc;\n// }\n\n public String doc2Md(ApiDocObject doc) {\n if (doc == null) {\n return null;\n }\n ApiFolderObject folder = doc.getFolder();\n\n try {\n Map model = new HashMap<>();\n model.put(\"folder\", folder);\n model.put(\"doc\", doc);\n\n if (api2DocProperties.isShowCurl()) {\n String serverURL = api2DocProperties.getServerURL();\n String curl = CurlBuilder.toCurl(doc, serverURL);\n if (StringUtils.hasText(curl)) {\n model.put(\"curl\", curl);\n }\n }\n\n Object mockResult = doc.toMockResult();\n if (folder.isRestPack()) {\n mockResult = HttpResult.successFully(mockResult);\n }\n if (mockResult != null) {\n String resultJson = RestPackConfiguration.getObjectMapper()\n .writeValueAsString(mockResult);\n if (StringUtils.hasText(resultJson)) {\n model.put(\"resultJson\", resultJson);\n }\n }\n\n String folderId = folder.getId();\n String upFirst = folderId.substring(0, 1).toUpperCase() + folderId.substring(1);\n String folderClasses = upFirst + \"Service / \" + upFirst + \"Retrofit\";\n model.put(\"folderClasses\", folderClasses);\n\n String content = freeMarker.build(mdTemplate, model);\n if (log.isInfoEnabled()) {\n log.info(\"\\n{}\", content);\n }\n return content;\n } catch (IOException | TemplateException e) {\n throw new RuntimeException(e);\n }\n }\n\n public String loadMdFromResource(String path) throws Exception {\n if (StringUtils.isEmpty(path)) {\n throw new NullPointerException(\"path is null.\");\n }\n path = path.trim();\n if (!path.startsWith(\"/\")) {\n path = \"/\" + path;\n }\n path = \"api2doc\" + path;\n\n ClassLoader loader = Thread.currentThread().getContextClassLoader();\n String md = Strings.getResourceByPath(path, loader);\n return md;\n }\n\n public String loadMdFromResource(String folderId, String docId) throws Exception {\n ApiFolderObject folder = apiDocService.getFolder(folderId);\n if (folder == null) {\n log.warn(\"ApiFolder NOT Found: {}\", folderId);\n return null;\n }\n\n Map mds = folder.getMds();\n if (mds == null || !mds.containsKey(docId)) {\n log.warn(\"Markdown doc {} NOT Found in Folder: {}\", docId, folderId);\n return null;\n }\n\n String fileName = mds.get(docId);\n String path = folderId + \"/\" + fileName;\n String md = loadMdFromResource(path);\n return md;\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/FlexibleString.java", "content": "package com.terran4j.commons.api2doc.impl;\n\n/**\n * 将空串视为 null\n * 能转成 html 格式。\n */\npublic class FlexibleString {\n\n private StringBuilder value = new StringBuilder();\n\n public FlexibleString() {\n }\n\n public FlexibleString(String value) {\n if (value != null) {\n this.value.append(value);\n }\n }\n\n public String getValue() {\n if (value.length() == 0) {\n return null;\n }\n return value.toString();\n }\n\n public void setValue(String value) {\n if (value == null) {\n this.value = new StringBuilder();\n } else {\n this.value = new StringBuilder(value);\n }\n }\n\n public FlexibleString append(String appendValue) {\n if (appendValue != null) {\n value.append(appendValue);\n }\n return this;\n }\n\n public FlexibleString insertLine(String insertValue) {\n if (insertValue != null) {\n if (this.value.length() > 0) {\n this.value.insert(0, insertValue + \"\\n\");\n } else {\n this.value.insert(0, insertValue);\n }\n }\n return this;\n }\n\n public String html() {\n if (value.length() == 0) {\n return null;\n }\n String replacement = \"
\";\n return value.toString().replaceAll(\"\\n\", replacement);\n }\n\n public String javadoc(int indent) {\n if (value.length() == 0) {\n return null;\n }\n String replacement = \"\";\n for (int i = 0; i < indent; i++) {\n replacement += \" \";\n }\n replacement = \"
\\n\" + replacement + (\" * \");\n return value.toString().replaceAll(\"\\n\", replacement);\n }\n\n @Override\n public String toString() {\n if (value.length() == 0) {\n return \"\";\n }\n return value.toString();\n }\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/impl/MappingMethod.java", "content": "package com.terran4j.commons.api2doc.impl;\n\nimport org.springframework.web.bind.annotation.*;\n\nimport java.lang.annotation.Annotation;\nimport java.lang.reflect.Method;\nimport java.util.*;\n\npublic class MappingMethod {\n\n /**\n * 目前只支持这 5 种方法，其它的都用得太少，暂时不支持。\n */\n static final RequestMethod[] SUPPORT_METHODS = new RequestMethod[] {\n RequestMethod.GET, RequestMethod.POST,\n RequestMethod.PUT, RequestMethod.DELETE,\n RequestMethod.PATCH\n };\n\n private final Method method;\n\n private MappingMethod(Method method) {\n this.method = method;\n }\n\n public Method getMethod() {\n return method;\n }\n\n public String getName() {\n RequestMapping requestMapping = method.getAnnotation(RequestMapping.class);\n if (requestMapping != null) {\n return requestMapping.name();\n }\n\n GetMapping getMapping = method.getAnnotation(GetMapping.class);\n if (getMapping != null) {\n return getMapping.name();\n }\n\n PostMapping postMapping = method.getAnnotation(PostMapping.class);\n if (postMapping != null) {\n return postMapping.name();\n }\n\n PutMapping putMapping = method.getAnnotation(PutMapping.class);\n if (putMapping != null) {\n return putMapping.name();\n }\n\n PatchMapping patchMapping = method.getAnnotation(PatchMapping.class);\n if (patchMapping != null) {\n return patchMapping.name();\n }\n\n DeleteMapping deleteMapping = method.getAnnotation(DeleteMapping.class);\n if (deleteMapping != null) {\n return deleteMapping.name();\n }\n\n return null;\n }\n\n RequestMethod[] getRequestMethod() {\n RequestMapping requestMapping = method.getAnnotation(RequestMapping.class);\n if (requestMapping != null) {\n RequestMethod[] methods = requestMapping.method();\n if (methods == null || methods.length == 0) {\n return SUPPORT_METHODS;\n }\n return methods;\n }\n\n GetMapping getMapping = method.getAnnotation(GetMapping.class);\n if (getMapping != null) {\n return new RequestMethod[]{RequestMethod.GET};\n }\n\n PostMapping postMapping = method.getAnnotation(PostMapping.class);\n if (postMapping != null) {\n return new RequestMethod[]{RequestMethod.POST};\n }\n\n PutMapping putMapping = method.getAnnotation(PutMapping.class);\n if (putMapping != null) {\n return new RequestMethod[]{RequestMethod.PUT};\n }\n\n PatchMapping patchMapping = method.getAnnotation(PatchMapping.class);\n if (patchMapping != null) {\n return new RequestMethod[]{RequestMethod.PATCH};\n }\n\n DeleteMapping deleteMapping = method.getAnnotation(DeleteMapping.class);\n if (deleteMapping != null) {\n return new RequestMethod[]{RequestMethod.DELETE};\n }\n\n return SUPPORT_METHODS;\n }\n\n public String[] getPath() {\n RequestMapping requestMapping = method.getAnnotation(RequestMapping.class);\n if (requestMapping != null) {\n return merge(requestMapping.path(), requestMapping.value());\n }\n\n GetMapping getMapping = method.getAnnotation(GetMapping.class);\n if (getMapping != null) {\n return merge(getMapping.path(), getMapping.value());\n }\n\n PostMapping postMapping = method.getAnnotation(PostMapping.class);\n if (postMapping != null) {\n return merge(postMapping.path(), postMapping.value());\n }\n\n PutMapping putMapping = method.getAnnotation(PutMapping.class);\n if (putMapping != null) {\n return merge(putMapping.path(), putMapping.value());\n }\n\n PatchMapping patchMapping = method.getAnnotation(PatchMapping.class);\n if (patchMapping != null) {\n return merge(patchMapping.path(), patchMapping.value());\n }\n\n DeleteMapping deleteMapping = method.getAnnotation(DeleteMapping.class);\n if (deleteMapping != null) {\n return merge(deleteMapping.path(), deleteMapping.value());\n }\n\n return null;\n }\n\n private String[] merge(String[] strs1, String[] strs2) {\n Set strSet = new HashSet<>();\n if (strs1 != null) {\n strSet.addAll(Arrays.asList(strs1));\n }\n if (strs2 != null) {\n strSet.addAll(Arrays.asList(strs2));\n }\n\n List list = new ArrayList<>(strSet);\n Collections.sort(list);\n return list.toArray(new String[list.size()]);\n }\n\n public static List getMappingMethods(Class clazz) {\n List mappingMethods = new ArrayList<>();\n\n Method[] methods = clazz.getDeclaredMethods();\n if (methods == null || methods.length == 0) {\n return mappingMethods;\n }\n\n for (Method method : methods) {\n if (isMappingMethod(method)) {\n MappingMethod mappingMethod = new MappingMethod(method);\n mappingMethods.add(mappingMethod);\n }\n }\n\n return mappingMethods;\n }\n\n public static boolean isMappingMethod(Method method) {\n Annotation mapping = method.getAnnotation(RequestMapping.class);\n if (mapping != null) {\n return true;\n }\n\n mapping = method.getAnnotation(GetMapping.class);\n if (mapping != null) {\n return true;\n }\n\n mapping = method.getAnnotation(PostMapping.class);\n if (mapping != null) {\n return true;\n }\n\n mapping = method.getAnnotation(PutMapping.class);\n if (mapping != null) {\n return true;\n }\n\n mapping = method.getAnnotation(PatchMapping.class);\n if (mapping != null) {\n return true;\n }\n\n mapping = method.getAnnotation(DeleteMapping.class);\n if (mapping != null) {\n return true;\n }\n\n return false;\n }\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/meta/ApiMetaService.java", "content": "package com.terran4j.commons.api2doc.meta;\n\nimport com.terran4j.commons.api2doc.controller.ApiEntry;\nimport com.terran4j.commons.api2doc.controller.ApiInfo;\nimport com.terran4j.commons.api2doc.domain.ApiDocObject;\nimport com.terran4j.commons.api2doc.domain.ApiFolderObject;\nimport com.terran4j.commons.api2doc.domain.ApiParamLocation;\nimport com.terran4j.commons.api2doc.domain.ApiParamObject;\nimport com.terran4j.commons.api2doc.impl.Api2DocService;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\nimport org.springframework.web.bind.annotation.RequestMethod;\n\nimport java.util.ArrayList;\nimport java.util.List;\n\n@Service\npublic class ApiMetaService {\n\n @Autowired\n private Api2DocService api2DocService;\n\n public ApiInfo toApiInfo(String folderId, String docId) throws Exception {\n ApiDocObject doc = api2DocService.getDocObject(folderId, docId);\n ApiInfo apiInfo = new ApiInfo();\n apiInfo.setUrl(doc.getPaths()[0]);\n apiInfo.setDefaultMethod(doc.getMethods()[0].name());\n\n List apiParamObjects = doc.getParams();\n if (apiParamObjects != null && apiParamObjects.size() > 0) {\n List params = new ArrayList<>();\n List headers = new ArrayList<>();\n for (ApiParamObject apiParamObject : apiParamObjects) {\n ApiEntry entry = new ApiEntry();\n entry.setKey(apiParamObject.getId());\n entry.setValue(apiParamObject.getSample().getValue());\n ApiParamLocation paramLocation = apiParamObject.getLocation();\n if (paramLocation == ApiParamLocation.RequestParam) {\n params.add(entry);\n } else if (paramLocation == ApiParamLocation.RequestHeader) {\n headers.add(entry);\n }\n }\n apiInfo.setParams(params);\n apiInfo.setHeaders(headers);\n }\n\n return apiInfo;\n }\n\n public List toClassMetaList() {\n List classes = new ArrayList<>();\n List folderList = api2DocService.getFolders();\n if (folderList == null || folderList.isEmpty()) {\n return classes;\n }\n\n for(ApiFolderObject folder : folderList) {\n ClassMeta classMeta = toClassMeta(folder);\n classes.add(classMeta);\n }\n\n return classes;\n }\n\n public ClassMeta toClassMeta(ApiFolderObject folder) {\n ClassMeta classMeta = new ClassMeta();\n classMeta.setId(folder.getId());\n classMeta.setName(folder.getName());\n classMeta.setComment(folder.getComment().getValue());\n\n List docs = folder.getDocs();\n if (docs != null && docs.size() > 0) {\n for(ApiDocObject doc : docs) {\n MethodMeta methodMeta = toMethodMeta(doc);\n classMeta.addMethod(methodMeta);\n }\n }\n\n return classMeta;\n }\n\n public MethodMeta toMethodMeta(ApiDocObject doc) {\n MethodMeta methodMeta = new MethodMeta();\n methodMeta.setId(doc.getId());\n methodMeta.setComment(doc.getComment().getValue());\n methodMeta.setName(doc.getName());\n methodMeta.setPaths(doc.getPaths());\n methodMeta.setRequestMethods(toRequestMethods(doc.getMethods()));\n\n List params = doc.getParams();\n if (params != null && params.size() > 0) {\n for (ApiParamObject param : params) {\n ParamMeta paramMeta = toParamMeta(param);\n methodMeta.addParam(paramMeta);\n }\n }\n\n return methodMeta;\n }\n\n public ParamMeta toParamMeta(ApiParamObject param) {\n ParamMeta paramMeta = new ParamMeta();\n paramMeta.setId(param.getId());\n paramMeta.setComment(param.getComment().getValue());\n paramMeta.setDataType(param.getDataType().getName());\n paramMeta.setLocation(param.getLocation().name());\n paramMeta.setName(param.getName());\n paramMeta.setRequired(param.isRequired());\n return paramMeta;\n }\n\n private String[] toRequestMethods(RequestMethod[] methods) {\n if (methods == null || methods.length == 0) {\n return new String[]{};\n }\n\n String[] results = new String[methods.length];\n for (int i = 0; i < methods.length; i++) {\n RequestMethod method = methods[i];\n results[i] = method.name();\n }\n return results;\n }\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/meta/ClassMeta.java", "content": "package com.terran4j.commons.api2doc.meta;\n\nimport java.util.ArrayList;\nimport java.util.List;\n\npublic class ClassMeta {\n\n private String id;\n\n private String name;\n\n private String comment;\n\n private final List methods = new ArrayList<>();\n\n public String getId() {\n return id;\n }\n\n public void setId(String id) {\n this.id = id;\n }\n\n public String getName() {\n return name;\n }\n\n public void setName(String name) {\n this.name = name;\n }\n\n public String getComment() {\n return comment;\n }\n\n public void setComment(String comment) {\n this.comment = comment;\n }\n\n public List getMethods() {\n return methods;\n }\n\n public void addMethod(MethodMeta method) {\n this.methods.add(method);\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/meta/MethodMeta.java", "content": "package com.terran4j.commons.api2doc.meta;\n\nimport java.util.ArrayList;\nimport java.util.List;\n\npublic class MethodMeta {\n\n private String id;\n\n private String name;\n\n private String comment;\n\n private String[] paths;\n\n private String[] requestMethods;\n\n private final List params = new ArrayList<>();\n\n public String getId() {\n return id;\n }\n\n public void setId(String id) {\n this.id = id;\n }\n\n public String getName() {\n return name;\n }\n\n public void setName(String name) {\n this.name = name;\n }\n\n public String getComment() {\n return comment;\n }\n\n public void setComment(String comment) {\n this.comment = comment;\n }\n\n public String[] getPaths() {\n return paths;\n }\n\n public void setPaths(String[] paths) {\n this.paths = paths;\n }\n\n public String[] getRequestMethods() {\n return requestMethods;\n }\n\n public void setRequestMethods(String[] requestMethods) {\n this.requestMethods = requestMethods;\n }\n\n public List getParams() {\n return params;\n }\n\n public void addParam(ParamMeta param) {\n this.params.add(param);\n }\n\n}\n" }, { "path": "commons-api2doc/src/main/java/com/terran4j/commons/api2doc/meta/ParamMeta.java", "content": "package com.terran4j.commons.api2doc.meta;\n\nimport com.terran4j.commons.api2doc.domain.ApiDataType;\nimport com.terran4j.commons.api2doc.domain.ApiParamLocation;\n\npublic class ParamMeta {\n\n private String id;\n\n private String name;\n\n private String comment;\n\n private boolean required;\n\n private String dataType;\n\n private String location;\n\n public String getId() {\n return id;\n }\n\n public void setId(String id) {\n this.id = id;\n }\n\n public String getName() {\n return name;\n }\n\n public void setName(String name) {\n this.name = name;\n }\n\n public String getComment() {\n return comment;\n }\n\n public void setComment(String comment) {\n this.comment = comment;\n }\n\n public boolean isRequired() {\n return required;\n }\n\n public void setRequired(boolean required) {\n this.required = required;\n }\n\n public String getDataType() {\n return dataType;\n }\n\n public void setDataType(String dataType) {\n this.dataType = dataType;\n }\n\n public String getLocation() {\n return location;\n }\n\n public void setLocation(String location) {\n this.location = location;\n }\n}\n" }, { "path": "commons-api2doc/src/main/resources/api2doc/welcome.md", "content": "\n欢迎使用 Api2Doc ！\n" }, { "path": "commons-api2doc/src/main/resources/com/terran4j/commons/api2doc/codewriter/bean.java.ftl", "content": "<#if config.pkgName??>\npackage ${config.pkgName};\n\n\n<#list imports as import>\nimport ${import};\n\n\n/**\n<#if comment??>\n * ${comment}
\n\n * \n<#if config.declaredComment??>\n * ${config.declaredComment}\n\n */\npublic class ${class} {\n\n<#list fields as field>\n <#if field.comment ??>\n /**\n * ${field.comment}\n */\n \n private ${field.type} ${field.name};\n\n\n\n<#list fields as field>\n <#if field.comment ??>\n /**\n * @return ${field.comment}\n */\n \n\tpublic ${field.type} ${field.getMethod}() {\n\t\treturn ${field.name};\n\t}\n\n\tpublic void ${field.setMethod}(${field.type} ${field.name}) {\n\t\tthis.${field.name} = ${field.name};\n\t}\n\n\n}" }, { "path": "commons-api2doc/src/main/resources/com/terran4j/commons/api2doc/codewriter/enum.java.ftl", "content": "<#if config.pkgName??>\npackage ${config.pkgName};\n\n\n/**\n<#if config.declaredComment??>\n * ${config.declaredComment}\n\n */\npublic enum ${class} {\n\n<#list enums as enum>\n<#if enum.comment??>\n\t/**\n\t * ${enum.comment}\n\t */\n\n\t${enum.name},\n\n\n\n}" }, { "path": "commons-api2doc/src/main/resources/com/terran4j/commons/api2doc/codewriter/retrofit.java.ftl", "content": "<#if config.pkgName??>\npackage ${config.pkgName};\n\n\nimport retrofit2.Call;\nimport retrofit2.http.*;\n\n<#list imports as import>\nimport ${import};\n\n\n/**\n<#if comment??>\n * ${comment!}\n\n * \n<#if config.declaredComment??>\n * ${config.declaredComment}\n\n */\npublic interface ${class} {\n\n<#list methods as method>\n /**\n<#if method.comment??>\n * ${method.comment}\n\n<#if method.params??>\n<#list method.params as param>\n * @param ${param.id} ${param.comment!}\n\n\n<#if method.returnClass ??>\n * @return 返回由 ${method.returnClass} 对象序列化而成的 json 串。\n\n */\n<#if method.annos??>\n<#list method.annos as anno>\n ${anno}\n\n\n Call ${method.name}(<#list method.params as param>${param.expression});\n\n\n}" }, { "path": "commons-api2doc/src/main/resources/com/terran4j/commons/api2doc/impl/doc.md.ftl", "content": "**API标识**\n- ${folder.id}-${doc.id}\n\n<#if doc.comment?? && doc.comment!=\"\">\n**API简介** \n- ${doc.comment}\n\n\n
\n\n<#--**客户端API类**-->\n<#--- ${folderClasses}-->\n\n<#--**客户端API方法**-->\n<#--- ${doc.id}-->\n\n<#--
-->\n\n**请求URI**\n<#list doc.paths as path>\n- `${path}`\n\n\n**请求方法**\n<#list doc.methods as method>\n- `${method}`\n\n\n<#if doc.params?? && (doc.params?size > 0) >\n**请求参数**\n\n| 参数名 | 是否必须 | 参数形式 | 数据类型 | 说明 | 示例值 |\n|:----- |----- |----- |----- |------ |----- |\n<#list doc.params as param>\n| ${param.id} | ${param.requiredName} | ${param.location} | ${param.typeName} | ${param.comment.html()!} | ${param.sample.html()!} |\n\n\n\n<#if curl??>\n**请求示例（curl 命令格式）**\n\n```\n${curl}\n```\n\n\n
\n\n<#if resultJson??>\n\n**返回数据示例**\n\n```json\n${resultJson}\n```\n\n\n<#if doc.results?? && (doc.results?size > 0) >\n\n\n**返回数据说明**\n- [${doc.returnTypeDesc}](#${doc.results[0].groupId}) （参见下面的类型说明）\n\n\n<#list doc.results as result>\n\n\n<#if result.groupId??>\n
\n\n\n**${result.groupName!}类型说明：**\n\n| 字段名 | 类型 | 说明 | 示例值 |\n|:---- |----- |----- |----- |\n<#list result.children as item>\n| ${item.id} | <#if item.refGroupId??>[${item.typeName}](#${item.refGroupId})<#else>${item.typeName} | ${item.comment.html()!} | ${item.sample.html()!} |\n\n\n\n<#elseif doc.resultType?? >\n\n\n**返回数据说明**\n\n| 类型 | 说明 | 示例值 |\n|:---- |----- |----- |\n| ${doc.resultType.typeName} | ${doc.resultType.comment.html()!} | ${doc.resultType.sample.html()!} |\n\n\n
\n\n<#if doc.errors?? && (doc.errors?size > 0) >\n**错误码**\n\n| 错误码 | 说明 |\n|:---- |----- |\n<#list doc.errors as error>\n| ${error.id} | ${error.comment.html()!} |\n\n\n" }, { "path": "commons-api2doc/src/main/resources/static/api2doc/css/doc.less", "content": "////////////////////////// 整个 html、 body 及公共的样式 /////////////////\nhtml {\n overflow-y: scroll;\n}\n\n@media only screen and (min-width: 48rem) {\n body {\n font-size: 1.4rem;\n }\n}\n\n@media only screen and (min-width: 76.8rem) {\n body {\n font-size: 1.6rem;\n }\n}\n\n//////////////////////////// 文档标题及内容块的样式 ///////////////////////\n\n.title {\n color: rgb(51, 51, 51);\n font-family: \"Microsoft Yahei, 微软雅黑, Tahoma, Arial, Helvetica, STHeiti\";\n font-size: 2.4rem;\n font-weight: bold;\n text-align: left;\n text-rendering: optimizeLegibility;\n text-size-adjust: 100%;\n height: 4rem;\n line-height: 4rem;\n margin-left: 3rem;\n padding-bottom: 0.5rem;\n padding-top: 1rem;\n}\n\n.content {\n padding-top: 1rem;\n word-break: break-all;\n overflow-x: hidden;\n overflow-y: hidden;\n font-size: 1.6rem;\n line-height: 1.7rem;\n margin-left: 3rem;\n}\n\n.test-entry {\n float: right;\n margin-top: 1rem;\n margin-right: 3rem;\n}\n\n.clear {\n clear: both;\n}\n\n////////////////////////////// 自定义滚动条样式 /////////////////\n::-webkit-scrollbar { /* 整个滚条背景 */\n width: 0.5rem;\n height: 0.5rem;\n}\n\n::-webkit-scrollbar-thumb { // 滚动条滑块（是主要部分）\n background-color: #c2c2c2; /* 滚条内嵌颜色 */\n background-clip: padding-box;\n min-height: 3rem;\n}\n\n::-webkit-scrollbar-track { // 外层轨道。\n background-color: #FFF;\n}\n\n::-webkit-scrollbar-button { // 不要两端的按钮。\n display: none;\n}" }, { "path": "commons-api2doc/src/main/resources/static/api2doc/css/home.less", "content": "\n// 菜单栏背景的颜色。\n@menu-color: white;\n\n// 分隔线的颜色：\n@split-color: rgba(0,0,0,.07);\n\nhtml {\n overflow: hidden;\n}\n\n.doc-app {\n width: 99.52%;\n margin: 0px;\n padding: 0px;\n}\n\n.doc-top {\n width: 100%;\n height: 5rem;\n border-bottom: 1px solid rgba(0,0,0,.07);\n}\n\n.doc-icon {\n float: left;\n position: relative;\n text-align: center;\n margin-left: 2rem;\n margin-top: 0.7rem;\n background-position: center center;\n}\n\n.doc-icon-img {\n width: 3rem;\n height: 3rem;\n cursor: pointer;\n}\n\n.doc-title {\n float: left;\n position: relative;\n font-size: 2rem;\n font-weight: bold;\n line-height: 4rem;\n height: 4rem;\n margin-left: 2rem;\n text-align: center;\n vertical-align: middle;\n overflow: hidden;\n}\n\n.doc-body, .doc-left, .doc-middle {\n}\n\n.doc-body {\n width: 100%;\n position: absolute;\n top: 5rem;\n bottom: 0px;\n left: 0px;\n margin-top: 0.673rem;\n}\n\n.doc-left {\n width: 20%;\n height: 100%;\n overflow-x: hidden;\n overflow-y: auto;\n float: left;\n position: relative;\n display: block;\n background-color: @menu-color;\n}\n\n#doc-menus {\n width: 100%;\n margin-top: 1rem;\n}\n\n.doc-content {\n width: 79%;\n height: 100%;\n float: left;\n overflow: hidden;\n border-left: 1px solid @split-color;\n}\n\n.doc-frame {\n width: 100%;\n height: 100%;\n}\n\n.doc-end {\n clear: both;\n display: none;\n}\n\n////////////////////// 重新定义菜单栏的颜色 ////////////////////\n\n.el-menu {\n background-color: @menu-color;\n}\n\n.el-submenu .el-menu {\n background-color: @menu-color;\n}\n\n////////////////////////////// 自定义滚动条样式 /////////////////\n::-webkit-scrollbar { /* 整个滚条背景 */\n width: 0.5rem;\n height: 0.5rem;\n}\n\n::-webkit-scrollbar-thumb { // 滚动条滑块（是主要部分）\n background-color: #c2c2c2; /* 滚条内嵌颜色 */\n background-clip: padding-box;\n min-height: 3rem;\n}\n\n::-webkit-scrollbar-track { // 外层轨道。\n background-color: #FFF;\n}\n\n::-webkit-scrollbar-button { // 不要两端的按钮。\n display: none;\n}" }, { "path": "commons-api2doc/src/main/resources/static/api2doc/css/md.less", "content": "\n//////////////////////////////// 通用样式 //////////////////////\n\np, blockquote, ul, ol, dl, li, table, pre {\n margin: 1.5rem 0;\n}\n\n//////////////////////////////// 各种型号的标题的样式 ////////////////////\n\nh1, h2, h3, h4, h5, h6 {\n font-weight: bold;\n padding-bottom: 1rem;\n}\n\nh1 {\n color: #000000;\n font-size: 2.8rem;\n}\n\nh2 {\n color: #000000;\n font-size: 2.4rem;\n}\n\nh3 {\n font-size: 1.8rem;\n}\n\nh4 {\n font-size: 1.6rem;\n}\n\nh5 {\n font-size: 1.4rem;\n}\n\nh6 {\n color: #777777;\n background-color: inherit;\n font-size: 1.4rem;\n}\n\nhr {\n height: 0.2em;\n border: 0;\n color: #CCCCCC;\n background-color: #CCCCCC;\n}\n\n////////////////////////////// 段落的样式 //////////////////////\np {\n margin: 1rem 0;\n}\n\n////////////////////////////// 代码块的样式 //////////////////////\npre {\n overflow: auto;\n width: 94.5%;\n padding: 0.5rem;\n white-space: pre-wrap; /*css-3*/\n white-space: -moz-pre-wrap; /*Mozilla,since1999*/\n white-space: -o-pre-wrap; /*Opera7*/\n word-wrap: break-word; /*InternetExplorer5.5+*/\n}\n\ncode {\n font-family: Consolas, Monaco, Andale Mono, monospace;\n background-color: #F8F8F8;\n border: 1px solid #CCCCCC;\n border-radius: 0.3rem;\n padding: 0 0.2em;\n line-height: 1;\n color: #d14;\n white-space: pre-wrap;\n}\n\n/////////////////////////// 链接的样式 ////////////////////////////////////\na {\n color: #0645ad;\n text-decoration: none;\n}\n\na:visited {\n color: #0b0080;\n}\n\na:hover {\n color: #06e;\n}\n\na:active {\n color: #faa700;\n}\n\na:focus {\n outline: thin dotted;\n}\n\na:hover, a:active {\n outline: 0;\n}\n\n///////////////////////////// 被选中的文本的样式 ///////////////////////\n::-moz-selection {\n background: rgba(255, 255, 0, 0.3);\n color: #000\n}\n\n::selection {\n background: rgba(255, 255, 0, 0.3);\n color: #000\n}\n\na::-moz-selection {\n background: rgba(255, 255, 0, 0.3);\n color: #0645ad\n}\n\na::selection {\n background: rgba(255, 255, 0, 0.3);\n color: #0645ad\n}\n\n/////////////////////////////// 条目的样式 /////////////////////\nblockquote {\n color: #666666;\n margin: 0;\n padding-left: 3em;\n border-left: 0.5em #EEE solid;\n}\n\nul, ol {\n margin: 1em 0;\n padding: 0 0 0 2em;\n}\n\nli p:last-child {\n margin: 0\n}\n\ndd {\n margin: 0 0 0 2em;\n}\n\n///////////////////////// 图片的样式 ////////////////////////\nimg {\n border: 0;\n -ms-interpolation-mode: bicubic;\n vertical-align: middle;\n max-width: 100%;\n}\n\n///////////////////////// 表格的样式 ////////////////////////\ntable {\n border-collapse: collapse;\n border-spacing: 0;\n width: 95%;\n}\n\ntr {\n color: rgb(255, 255, 255);\n}\n\nth, td {\n vertical-align: top;\n display: table-cell;\n padding: 0.8rem;\n line-height: 2rem;\n text-align: left;\n vertical-align: top;\n color: rgb(51, 51, 51);\n border-top: 1px solid #ddd;\n border-left: 1px solid #ddd;\n}\n\nthead tr {\n background-color: rgb(0, 136, 204);\n}\n\nthead tr th {\n text-align: left;\n min-width: 7.7rem;\n vertical-align: bottom;\n font-weight: bold;\n}\n\ntbody {\n display: table-row-group;\n vertical-align: middle;\n border-color: inherit;\n border-bottom: 1px solid #ddd;\n border-right: 1px solid #ddd;\n}\n\ntbody tr th {\n text-align: left;\n border-bottom-left-radius: 0.4rem;\n color: #333;\n}" }, { "path": "commons-api2doc/src/main/resources/static/api2doc/css/test.less", "content": "@left-space: 1rem;\n@font-base-size: 1rem;\n\nh2 {\n margin-left: @left-space;\n}\n\n//h3 {\n// margin-left: @left-space;\n//}\n\n.clear {\n clear: both;\n}\n\n//////////////////////////////////////////////////////////////////\n\n.items {\n margin-top: 2rem;\n margin-left: @left-space;\n}\n\n.items-desc {\n font-size: @font-base-size;\n margin-left: @left-space;\n margin-bottom: 0.5rem;\n}\n\n.item-list {\n float: left;\n width: 95%;\n}\n\n.item {\n margin-bottom: 0.5rem;\n margin-right: 2rem;\n width: 45%;\n float: left;\n}\n\n.item-key {\n width: 25%;\n margin-left: @left-space;\n float: left;\n}\n\n.item-split {\n margin-top: 0.7rem;\n margin-left: 0.3rem;\n font-size: @font-base-size;\n float: left;\n}\n\n.item-value {\n width: 65%;\n margin-left: 0.1rem;\n float: left;\n}\n\n.item-new {\n margin-left: @left-space;\n float: left;\n clear: both;\n}\n\n////////////////////////////////////////////////////////////////////////\n\n.request {\n width: 95%;\n margin-left: @left-space;\n}\n\n.request-method {\n width: 10%;\n margin-left: @left-space;\n float: left;\n}\n\n.request-url {\n width: 77.5%;\n margin-left: 1rem;\n float: left;\n}\n\n//////////////////////////////////////////////////////////////////\n\n.send {\n margin-left: @left-space;\n width: 95%;\n}\n\n.send-button {\n float: right;\n}\n\n/////////////////////////////////////////////////////////////////////////\n\n.headers {\n margin-top: 2rem;\n margin-left: @left-space;\n}\n\n//////////////////////////////////////////////////////////////////////////\n\n.response {\n margin-left: @left-space;\n margin-top: 4rem;\n width: 95%;\n}\n\n.response-code {\n margin-left: @left-space;\n}\n\n///////////////////////////////////////////////////////////////////////\n\n.output {\n margin-left: @left-space;\n width: 95%;\n}\n\npre.output-logs {\n margin-left: @left-space;\n white-space: pre-wrap;\n word-wrap: break-word;\n background-color: #F0F0F0;\n}" }, { "path": "commons-api2doc/src/main/resources/static/api2doc/flexible-lite/flexible-lite-1.0.js", "content": "/**\n * @param designWidth: 设计稿的实际宽度值，需要根据实际设置\n */\nfunction flex(designWidth) {\n var doc = document,\n win = window,\n docEl = doc.documentElement,\n remStyle = document.createElement(\"style\"),\n tid; // setTimeout 的句柄。\n\n function refreshRem() {\n var width = docEl.getBoundingClientRect().width;\n var rem = width * 10 / designWidth;\n remStyle.innerHTML = 'html{font-size:' + rem + 'px;}';\n }\n\n if (docEl.firstElementChild) {\n docEl.firstElementChild.appendChild(remStyle);\n } else {\n var wrap = doc.createElement(\"div\");\n wrap.appendChild(remStyle);\n doc.write(wrap.innerHTML);\n wrap = null;\n }\n //要等 viewport 设置好后才能执行 refreshRem，不然 refreshRem 会执行2次；\n refreshRem();\n\n win.addEventListener(\"resize\", function () {\n clearTimeout(tid); //防止执行两次\n tid = setTimeout(refreshRem, 300);\n }, false);\n\n win.addEventListener(\"pageshow\", function (e) {\n if (e.persisted) { // 浏览器后退的时候重新计算\n clearTimeout(tid);\n tid = setTimeout(refreshRem, 300);\n }\n }, false);\n\n if (doc.readyState === \"complete\") {\n doc.body.style.fontSize = \"16px\";\n } else {\n doc.addEventListener(\"DOMContentLoaded\", function (e) {\n doc.body.style.fontSize = \"16px\";\n }, false);\n }\n}" }, { "path": "commons-api2doc/src/main/resources/static/api2doc/less/less-1.7.0.js", "content": "/*! \n * LESS - Leaner CSS v1.7.0 \n * http://lesscss.org \n * \n * Copyright (c) 2009-2014, Alexis Sellier \n * Licensed under the Apache v2 License. \n * \n */ \n\n /** * @license Apache v2\n */ \n\n\n\n(function (window, undefined) {//\n// Stub out `require` in the browser\n//\nfunction require(arg) {\n return window.less[arg.split('/')[1]];\n};\n\n\nif (typeof(window.less) === 'undefined' || typeof(window.less.nodeType) !== 'undefined') { window.less = {}; }\nless = window.less;\ntree = window.less.tree = {};\nless.mode = 'browser';\n\nvar less, tree;\n\n// Node.js does not have a header file added which defines less\nif (less === undefined) {\n less = exports;\n tree = require('./tree');\n less.mode = 'node';\n}\n//\n// less.js - parser\n//\n// A relatively straight-forward predictive parser.\n// There is no tokenization/lexing stage, the input is parsed\n// in one sweep.\n//\n// To make the parser fast enough to run in the browser, several\n// optimization had to be made:\n//\n// - Matching and slicing on a huge input is often cause of slowdowns.\n// The solution is to chunkify the input into smaller strings.\n// The chunks are stored in the `chunks` var,\n// `j` holds the current chunk index, and `currentPos` holds\n// the index of the current chunk in relation to `input`.\n// This gives us an almost 4x speed-up.\n//\n// - In many cases, we don't need to match individual tokens;\n// for example, if a value doesn't hold any variables, operations\n// or dynamic references, the parser can effectively 'skip' it,\n// treating it as a literal.\n// An example would be '1px solid #000' - which evaluates to itself,\n// we don't need to know what the individual components are.\n// The drawback, of course is that you don't get the benefits of\n// syntax-checking on the CSS. This gives us a 50% speed-up in the parser,\n// and a smaller speed-up in the code-gen.\n//\n//\n// Token matching is done with the `$` function, which either takes\n// a terminal string or regexp, or a non-terminal function to call.\n// It also takes care of moving all the indices forwards.\n//\n//\nless.Parser = function Parser(env) {\n var input, // LeSS input string\n i, // current index in `input`\n j, // current chunk\n saveStack = [], // holds state for backtracking\n furthest, // furthest index the parser has gone to\n chunks, // chunkified input\n current, // current chunk\n currentPos, // index of current chunk, in `input`\n parser,\n parsers,\n rootFilename = env && env.filename;\n\n // Top parser on an import tree must be sure there is one \"env\"\n // which will then be passed around by reference.\n if (!(env instanceof tree.parseEnv)) {\n env = new tree.parseEnv(env);\n }\n\n var imports = this.imports = {\n paths: env.paths || [], // Search paths, when importing\n queue: [], // Files which haven't been imported yet\n files: env.files, // Holds the imported parse trees\n contents: env.contents, // Holds the imported file contents\n contentsIgnoredChars: env.contentsIgnoredChars, // lines inserted, not in the original less\n mime: env.mime, // MIME type of .less files\n error: null, // Error in parsing/evaluating an import\n push: function (path, currentFileInfo, importOptions, callback) {\n var parserImports = this;\n this.queue.push(path);\n\n var fileParsedFunc = function (e, root, fullPath) {\n parserImports.queue.splice(parserImports.queue.indexOf(path), 1); // Remove the path from the queue\n\n var importedPreviously = fullPath === rootFilename;\n\n parserImports.files[fullPath] = root; // Store the root\n\n if (e && !parserImports.error) { parserImports.error = e; }\n\n callback(e, root, importedPreviously, fullPath);\n };\n\n if (less.Parser.importer) {\n less.Parser.importer(path, currentFileInfo, fileParsedFunc, env);\n } else {\n less.Parser.fileLoader(path, currentFileInfo, function(e, contents, fullPath, newFileInfo) {\n if (e) {fileParsedFunc(e); return;}\n\n var newEnv = new tree.parseEnv(env);\n\n newEnv.currentFileInfo = newFileInfo;\n newEnv.processImports = false;\n newEnv.contents[fullPath] = contents;\n\n if (currentFileInfo.reference || importOptions.reference) {\n newFileInfo.reference = true;\n }\n\n if (importOptions.inline) {\n fileParsedFunc(null, contents, fullPath);\n } else {\n new(less.Parser)(newEnv).parse(contents, function (e, root) {\n fileParsedFunc(e, root, fullPath);\n });\n }\n }, env);\n }\n }\n };\n\n function save() { currentPos = i; saveStack.push( { current: current, i: i, j: j }); }\n function restore() { var state = saveStack.pop(); current = state.current; currentPos = i = state.i; j = state.j; }\n function forget() { saveStack.pop(); }\n\n function sync() {\n if (i > currentPos) {\n current = current.slice(i - currentPos);\n currentPos = i;\n }\n }\n function isWhitespace(str, pos) {\n var code = str.charCodeAt(pos | 0);\n return (code <= 32) && (code === 32 || code === 10 || code === 9);\n }\n //\n // Parse from a token, regexp or string, and move forward if match\n //\n function $(tok) {\n var tokType = typeof tok,\n match, length;\n\n // Either match a single character in the input,\n // or match a regexp in the current chunk (`current`).\n //\n if (tokType === \"string\") {\n if (input.charAt(i) !== tok) {\n return null;\n }\n skipWhitespace(1);\n return tok;\n }\n\n // regexp\n sync ();\n if (! (match = tok.exec(current))) {\n return null;\n }\n\n length = match[0].length;\n\n // The match is confirmed, add the match length to `i`,\n // and consume any extra white-space characters (' ' || '\\n')\n // which come after that. The reason for this is that LeSS's\n // grammar is mostly white-space insensitive.\n //\n skipWhitespace(length);\n\n if(typeof(match) === 'string') {\n return match;\n } else {\n return match.length === 1 ? match[0] : match;\n }\n }\n\n // Specialization of $(tok)\n function $re(tok) {\n if (i > currentPos) {\n current = current.slice(i - currentPos);\n currentPos = i;\n }\n var m = tok.exec(current);\n if (!m) {\n return null;\n }\n\n skipWhitespace(m[0].length);\n if(typeof m === \"string\") {\n return m;\n }\n\n return m.length === 1 ? m[0] : m;\n }\n\n var _$re = $re;\n\n // Specialization of $(tok)\n function $char(tok) {\n if (input.charAt(i) !== tok) {\n return null;\n }\n skipWhitespace(1);\n return tok;\n }\n\n function skipWhitespace(length) {\n var oldi = i, oldj = j,\n curr = i - currentPos,\n endIndex = i + current.length - curr,\n mem = (i += length),\n inp = input,\n c;\n\n for (; i < endIndex; i++) {\n c = inp.charCodeAt(i);\n if (c > 32) {\n break;\n }\n\n if ((c !== 32) && (c !== 10) && (c !== 9) && (c !== 13)) {\n break;\n }\n }\n\n current = current.slice(length + i - mem + curr);\n currentPos = i;\n\n if (!current.length && (j < chunks.length - 1)) {\n current = chunks[++j];\n skipWhitespace(0); // skip space at the beginning of a chunk\n return true; // things changed\n }\n\n return oldi !== i || oldj !== j;\n }\n\n function expect(arg, msg) {\n // some older browsers return typeof 'function' for RegExp\n var result = (Object.prototype.toString.call(arg) === '[object Function]') ? arg.call(parsers) : $(arg);\n if (result) {\n return result;\n }\n error(msg || (typeof(arg) === 'string' ? \"expected '\" + arg + \"' got '\" + input.charAt(i) + \"'\"\n : \"unexpected token\"));\n }\n\n // Specialization of expect()\n function expectChar(arg, msg) {\n if (input.charAt(i) === arg) {\n skipWhitespace(1);\n return arg;\n }\n error(msg || \"expected '\" + arg + \"' got '\" + input.charAt(i) + \"'\");\n }\n\n function error(msg, type) {\n var e = new Error(msg);\n e.index = i;\n e.type = type || 'Syntax';\n throw e;\n }\n\n // Same as $(), but don't change the state of the parser,\n // just return the match.\n function peek(tok) {\n if (typeof(tok) === 'string') {\n return input.charAt(i) === tok;\n } else {\n return tok.test(current);\n }\n }\n\n // Specialization of peek()\n function peekChar(tok) {\n return input.charAt(i) === tok;\n }\n\n\n function getInput(e, env) {\n if (e.filename && env.currentFileInfo.filename && (e.filename !== env.currentFileInfo.filename)) {\n return parser.imports.contents[e.filename];\n } else {\n return input;\n }\n }\n\n function getLocation(index, inputStream) {\n var n = index + 1,\n line = null,\n column = -1;\n\n while (--n >= 0 && inputStream.charAt(n) !== '\\n') {\n column++;\n }\n\n if (typeof index === 'number') {\n line = (inputStream.slice(0, index).match(/\\n/g) || \"\").length;\n }\n\n return {\n line: line,\n column: column\n };\n }\n\n function getDebugInfo(index, inputStream, env) {\n var filename = env.currentFileInfo.filename;\n if(less.mode !== 'browser' && less.mode !== 'rhino') {\n filename = require('path').resolve(filename);\n }\n\n return {\n lineNumber: getLocation(index, inputStream).line + 1,\n fileName: filename\n };\n }\n\n function LessError(e, env) {\n var input = getInput(e, env),\n loc = getLocation(e.index, input),\n line = loc.line,\n col = loc.column,\n callLine = e.call && getLocation(e.call, input).line,\n lines = input.split('\\n');\n\n this.type = e.type || 'Syntax';\n this.message = e.message;\n this.filename = e.filename || env.currentFileInfo.filename;\n this.index = e.index;\n this.line = typeof(line) === 'number' ? line + 1 : null;\n this.callLine = callLine + 1;\n this.callExtract = lines[callLine];\n this.stack = e.stack;\n this.column = col;\n this.extract = [\n lines[line - 1],\n lines[line],\n lines[line + 1]\n ];\n }\n\n LessError.prototype = new Error();\n LessError.prototype.constructor = LessError;\n\n this.env = env = env || {};\n\n // The optimization level dictates the thoroughness of the parser,\n // the lower the number, the less nodes it will create in the tree.\n // This could matter for debugging, or if you want to access\n // the individual nodes in the tree.\n this.optimization = ('optimization' in this.env) ? this.env.optimization : 1;\n\n //\n // The Parser\n //\n parser = {\n\n imports: imports,\n //\n // Parse an input string into an abstract syntax tree,\n // @param str A string containing 'less' markup\n // @param callback call `callback` when done.\n // @param [additionalData] An optional map which can contains vars - a map (key, value) of variables to apply\n //\n parse: function (str, callback, additionalData) {\n var root, line, lines, error = null, globalVars, modifyVars, preText = \"\";\n\n i = j = currentPos = furthest = 0;\n\n globalVars = (additionalData && additionalData.globalVars) ? less.Parser.serializeVars(additionalData.globalVars) + '\\n' : '';\n modifyVars = (additionalData && additionalData.modifyVars) ? '\\n' + less.Parser.serializeVars(additionalData.modifyVars) : '';\n\n if (globalVars || (additionalData && additionalData.banner)) {\n preText = ((additionalData && additionalData.banner) ? additionalData.banner : \"\") + globalVars;\n parser.imports.contentsIgnoredChars[env.currentFileInfo.filename] = preText.length;\n }\n\n str = str.replace(/\\r\\n/g, '\\n');\n // Remove potential UTF Byte Order Mark\n input = str = preText + str.replace(/^\\uFEFF/, '') + modifyVars;\n parser.imports.contents[env.currentFileInfo.filename] = str;\n\n // Split the input into chunks.\n chunks = (function (input) {\n var len = input.length, level = 0, parenLevel = 0,\n lastOpening, lastOpeningParen, lastMultiComment, lastMultiCommentEndBrace,\n chunks = [], emitFrom = 0,\n parserCurrentIndex, currentChunkStartIndex, cc, cc2, matched;\n\n function fail(msg, index) {\n error = new(LessError)({\n index: index || parserCurrentIndex,\n type: 'Parse',\n message: msg,\n filename: env.currentFileInfo.filename\n }, env);\n }\n\n function emitChunk(force) {\n var len = parserCurrentIndex - emitFrom;\n if (((len < 512) && !force) || !len) {\n return;\n }\n chunks.push(input.slice(emitFrom, parserCurrentIndex + 1));\n emitFrom = parserCurrentIndex + 1;\n }\n\n for (parserCurrentIndex = 0; parserCurrentIndex < len; parserCurrentIndex++) {\n cc = input.charCodeAt(parserCurrentIndex);\n if (((cc >= 97) && (cc <= 122)) || (cc < 34)) {\n // a-z or whitespace\n continue;\n }\n\n switch (cc) {\n case 40: // (\n parenLevel++; \n lastOpeningParen = parserCurrentIndex; \n continue;\n case 41: // )\n if (--parenLevel < 0) {\n return fail(\"missing opening `(`\");\n }\n continue;\n case 59: // ;\n if (!parenLevel) { emitChunk(); }\n continue;\n case 123: // {\n level++; \n lastOpening = parserCurrentIndex; \n continue;\n case 125: // }\n if (--level < 0) {\n return fail(\"missing opening `{`\");\n }\n if (!level && !parenLevel) { emitChunk(); }\n continue;\n case 92: // \\\n if (parserCurrentIndex < len - 1) { parserCurrentIndex++; continue; }\n return fail(\"unescaped `\\\\`\");\n case 34:\n case 39:\n case 96: // \", ' and `\n matched = 0;\n currentChunkStartIndex = parserCurrentIndex;\n for (parserCurrentIndex = parserCurrentIndex + 1; parserCurrentIndex < len; parserCurrentIndex++) {\n cc2 = input.charCodeAt(parserCurrentIndex);\n if (cc2 > 96) { continue; }\n if (cc2 == cc) { matched = 1; break; }\n if (cc2 == 92) { // \\\n if (parserCurrentIndex == len - 1) {\n return fail(\"unescaped `\\\\`\");\n }\n parserCurrentIndex++;\n }\n }\n if (matched) { continue; }\n return fail(\"unmatched `\" + String.fromCharCode(cc) + \"`\", currentChunkStartIndex);\n case 47: // /, check for comment\n if (parenLevel || (parserCurrentIndex == len - 1)) { continue; }\n cc2 = input.charCodeAt(parserCurrentIndex + 1);\n if (cc2 == 47) {\n // //, find lnfeed\n for (parserCurrentIndex = parserCurrentIndex + 2; parserCurrentIndex < len; parserCurrentIndex++) {\n cc2 = input.charCodeAt(parserCurrentIndex);\n if ((cc2 <= 13) && ((cc2 == 10) || (cc2 == 13))) { break; }\n }\n } else if (cc2 == 42) {\n // /*, find */\n lastMultiComment = currentChunkStartIndex = parserCurrentIndex;\n for (parserCurrentIndex = parserCurrentIndex + 2; parserCurrentIndex < len - 1; parserCurrentIndex++) {\n cc2 = input.charCodeAt(parserCurrentIndex);\n if (cc2 == 125) { lastMultiCommentEndBrace = parserCurrentIndex; }\n if (cc2 != 42) { continue; }\n if (input.charCodeAt(parserCurrentIndex + 1) == 47) { break; }\n }\n if (parserCurrentIndex == len - 1) {\n return fail(\"missing closing `*/`\", currentChunkStartIndex);\n }\n parserCurrentIndex++;\n }\n continue;\n case 42: // *, check for unmatched */\n if ((parserCurrentIndex < len - 1) && (input.charCodeAt(parserCurrentIndex + 1) == 47)) {\n return fail(\"unmatched `/*`\");\n }\n continue;\n }\n }\n\n if (level !== 0) {\n if ((lastMultiComment > lastOpening) && (lastMultiCommentEndBrace > lastMultiComment)) {\n return fail(\"missing closing `}` or `*/`\", lastOpening);\n } else {\n return fail(\"missing closing `}`\", lastOpening);\n }\n } else if (parenLevel !== 0) {\n return fail(\"missing closing `)`\", lastOpeningParen);\n }\n\n emitChunk(true);\n return chunks;\n })(str);\n\n if (error) {\n return callback(new(LessError)(error, env));\n }\n\n current = chunks[0];\n\n // Start with the primary rule.\n // The whole syntax tree is held under a Ruleset node,\n // with the `root` property set to true, so no `{}` are\n // output. The callback is called when the input is parsed.\n try {\n root = new(tree.Ruleset)(null, this.parsers.primary());\n root.root = true;\n root.firstRoot = true;\n } catch (e) {\n return callback(new(LessError)(e, env));\n }\n\n root.toCSS = (function (evaluate) {\n return function (options, variables) {\n options = options || {};\n var evaldRoot,\n css,\n evalEnv = new tree.evalEnv(options);\n \n //\n // Allows setting variables with a hash, so:\n //\n // `{ color: new(tree.Color)('#f01') }` will become:\n //\n // new(tree.Rule)('@color',\n // new(tree.Value)([\n // new(tree.Expression)([\n // new(tree.Color)('#f01')\n // ])\n // ])\n // )\n //\n if (typeof(variables) === 'object' && !Array.isArray(variables)) {\n variables = Object.keys(variables).map(function (k) {\n var value = variables[k];\n\n if (! (value instanceof tree.Value)) {\n if (! (value instanceof tree.Expression)) {\n value = new(tree.Expression)([value]);\n }\n value = new(tree.Value)([value]);\n }\n return new(tree.Rule)('@' + k, value, false, null, 0);\n });\n evalEnv.frames = [new(tree.Ruleset)(null, variables)];\n }\n\n try {\n var preEvalVisitors = [],\n visitors = [\n new(tree.joinSelectorVisitor)(),\n new(tree.processExtendsVisitor)(),\n new(tree.toCSSVisitor)({compress: Boolean(options.compress)})\n ], i, root = this;\n\n if (options.plugins) {\n for(i =0; i < options.plugins.length; i++) {\n if (options.plugins[i].isPreEvalVisitor) {\n preEvalVisitors.push(options.plugins[i]);\n } else {\n if (options.plugins[i].isPreVisitor) {\n visitors.splice(0, 0, options.plugins[i]);\n } else {\n visitors.push(options.plugins[i]);\n }\n }\n }\n }\n\n for(i = 0; i < preEvalVisitors.length; i++) {\n preEvalVisitors[i].run(root);\n }\n\n evaldRoot = evaluate.call(root, evalEnv);\n\n for(i = 0; i < visitors.length; i++) {\n visitors[i].run(evaldRoot);\n }\n\n if (options.sourceMap) {\n evaldRoot = new tree.sourceMapOutput(\n {\n contentsIgnoredCharsMap: parser.imports.contentsIgnoredChars,\n writeSourceMap: options.writeSourceMap,\n rootNode: evaldRoot,\n contentsMap: parser.imports.contents,\n sourceMapFilename: options.sourceMapFilename,\n sourceMapURL: options.sourceMapURL,\n outputFilename: options.sourceMapOutputFilename,\n sourceMapBasepath: options.sourceMapBasepath,\n sourceMapRootpath: options.sourceMapRootpath,\n outputSourceFiles: options.outputSourceFiles,\n sourceMapGenerator: options.sourceMapGenerator\n });\n }\n\n css = evaldRoot.toCSS({\n compress: Boolean(options.compress),\n dumpLineNumbers: env.dumpLineNumbers,\n strictUnits: Boolean(options.strictUnits),\n numPrecision: 8});\n } catch (e) {\n throw new(LessError)(e, env);\n }\n\n if (options.cleancss && less.mode === 'node') {\n var CleanCSS = require('clean-css'),\n cleancssOptions = options.cleancssOptions || {};\n\n if (cleancssOptions.keepSpecialComments === undefined) {\n cleancssOptions.keepSpecialComments = \"*\";\n }\n cleancssOptions.processImport = false;\n cleancssOptions.noRebase = true;\n if (cleancssOptions.noAdvanced === undefined) {\n cleancssOptions.noAdvanced = true;\n }\n\n return new CleanCSS(cleancssOptions).minify(css);\n } else if (options.compress) {\n return css.replace(/(^(\\s)+)|((\\s)+$)/g, \"\");\n } else {\n return css;\n }\n };\n })(root.eval);\n\n // If `i` is smaller than the `input.length - 1`,\n // it means the parser wasn't able to parse the whole\n // string, so we've got a parsing error.\n //\n // We try to extract a \\n delimited string,\n // showing the line where the parse error occured.\n // We split it up into two parts (the part which parsed,\n // and the part which didn't), so we can color them differently.\n if (i < input.length - 1) {\n i = furthest;\n var loc = getLocation(i, input);\n lines = input.split('\\n');\n line = loc.line + 1;\n\n error = {\n type: \"Parse\",\n message: \"Unrecognised input\",\n index: i,\n filename: env.currentFileInfo.filename,\n line: line,\n column: loc.column,\n extract: [\n lines[line - 2],\n lines[line - 1],\n lines[line]\n ]\n };\n }\n\n var finish = function (e) {\n e = error || e || parser.imports.error;\n\n if (e) {\n if (!(e instanceof LessError)) {\n e = new(LessError)(e, env);\n }\n\n return callback(e);\n }\n else {\n return callback(null, root);\n }\n };\n\n if (env.processImports !== false) {\n new tree.importVisitor(this.imports, finish)\n .run(root);\n } else {\n return finish();\n }\n },\n\n //\n // Here in, the parsing rules/functions\n //\n // The basic structure of the syntax tree generated is as follows:\n //\n // Ruleset -> Rule -> Value -> Expression -> Entity\n //\n // Here's some LESS code:\n //\n // .class {\n // color: #fff;\n // border: 1px solid #000;\n // width: @w + 4px;\n // > .child {...}\n // }\n //\n // And here's what the parse tree might look like:\n //\n // Ruleset (Selector '.class', [\n // Rule (\"color\", Value ([Expression [Color #fff]]))\n // Rule (\"border\", Value ([Expression [Dimension 1px][Keyword \"solid\"][Color #000]]))\n // Rule (\"width\", Value ([Expression [Operation \"+\" [Variable \"@w\"][Dimension 4px]]]))\n // Ruleset (Selector [Element '>', '.child'], [...])\n // ])\n //\n // In general, most rules will try to parse a token with the `$()` function, and if the return\n // value is truly, will return a new node, of the relevant type. Sometimes, we need to check\n // first, before parsing, that's when we use `peek()`.\n //\n parsers: parsers = {\n //\n // The `primary` rule is the *entry* and *exit* point of the parser.\n // The rules here can appear at any level of the parse tree.\n //\n // The recursive nature of the grammar is an interplay between the `block`\n // rule, which represents `{ ... }`, the `ruleset` rule, and this `primary` rule,\n // as represented by this simplified grammar:\n //\n // primary → (ruleset | rule)+\n // ruleset → selector+ block\n // block → '{' primary '}'\n //\n // Only at one point is the primary rule not called from the\n // block rule: at the root level.\n //\n primary: function () {\n var mixin = this.mixin, $re = _$re, root = [], node;\n\n while (current)\n {\n node = this.extendRule() || mixin.definition() || this.rule() || this.ruleset() ||\n mixin.call() || this.comment() || this.rulesetCall() || this.directive();\n if (node) {\n root.push(node);\n } else {\n if (!($re(/^[\\s\\n]+/) || $re(/^;+/))) {\n break;\n }\n }\n if (peekChar('}')) {\n break;\n }\n }\n\n return root;\n },\n\n // We create a Comment node for CSS comments `/* */`,\n // but keep the LeSS comments `//` silent, by just skipping\n // over them.\n comment: function () {\n var comment;\n\n if (input.charAt(i) !== '/') { return; }\n\n if (input.charAt(i + 1) === '/') {\n return new(tree.Comment)($re(/^\\/\\/.*/), true, i, env.currentFileInfo);\n }\n comment = $re(/^\\/\\*(?:[^*]|\\*+[^\\/*])*\\*+\\/\\n?/);\n if (comment) {\n return new(tree.Comment)(comment, false, i, env.currentFileInfo);\n }\n },\n\n comments: function () {\n var comment, comments = [];\n\n while(true) {\n comment = this.comment();\n if (!comment) {\n break;\n }\n comments.push(comment);\n }\n\n return comments;\n },\n\n //\n // Entities are tokens which can be found inside an Expression\n //\n entities: {\n //\n // A string, which supports escaping \" and '\n //\n // \"milky way\" 'he\\'s the one!'\n //\n quoted: function () {\n var str, j = i, e, index = i;\n\n if (input.charAt(j) === '~') { j++; e = true; } // Escaped strings\n if (input.charAt(j) !== '\"' && input.charAt(j) !== \"'\") { return; }\n\n if (e) { $char('~'); }\n\n str = $re(/^\"((?:[^\"\\\\\\r\\n]|\\\\.)*)\"|'((?:[^'\\\\\\r\\n]|\\\\.)*)'/);\n if (str) {\n return new(tree.Quoted)(str[0], str[1] || str[2], e, index, env.currentFileInfo);\n }\n },\n\n //\n // A catch-all word, such as:\n //\n // black border-collapse\n //\n keyword: function () {\n var k;\n\n k = $re(/^%|^[_A-Za-z-][_A-Za-z0-9-]*/);\n if (k) {\n var color = tree.Color.fromKeyword(k);\n if (color) {\n return color;\n }\n return new(tree.Keyword)(k);\n }\n },\n\n //\n // A function call\n //\n // rgb(255, 0, 255)\n //\n // We also try to catch IE's `alpha()`, but let the `alpha` parser\n // deal with the details.\n //\n // The arguments are parsed with the `entities.arguments` parser.\n //\n call: function () {\n var name, nameLC, args, alpha_ret, index = i;\n\n name = /^([\\w-]+|%|progid:[\\w\\.]+)\\(/.exec(current);\n if (!name) { return; }\n\n name = name[1];\n nameLC = name.toLowerCase();\n if (nameLC === 'url') {\n return null;\n }\n\n i += name.length;\n\n if (nameLC === 'alpha') {\n alpha_ret = parsers.alpha();\n if(typeof alpha_ret !== 'undefined') {\n return alpha_ret;\n }\n }\n\n $char('('); // Parse the '(' and consume whitespace.\n\n args = this.arguments();\n\n if (! $char(')')) {\n return;\n }\n\n if (name) { return new(tree.Call)(name, args, index, env.currentFileInfo); }\n },\n arguments: function () {\n var args = [], arg;\n\n while (true) {\n arg = this.assignment() || parsers.expression();\n if (!arg) {\n break;\n }\n args.push(arg);\n if (! $char(',')) {\n break;\n }\n }\n return args;\n },\n literal: function () {\n return this.dimension() ||\n this.color() ||\n this.quoted() ||\n this.unicodeDescriptor();\n },\n\n // Assignments are argument entities for calls.\n // They are present in ie filter properties as shown below.\n //\n // filter: progid:DXImageTransform.Microsoft.Alpha( *opacity=50* )\n //\n\n assignment: function () {\n var key, value;\n key = $re(/^\\w+(?=\\s?=)/i);\n if (!key) {\n return;\n }\n if (!$char('=')) {\n return;\n }\n value = parsers.entity();\n if (value) {\n return new(tree.Assignment)(key, value);\n }\n },\n\n //\n // Parse url() tokens\n //\n // We use a specific rule for urls, because they don't really behave like\n // standard function calls. The difference is that the argument doesn't have\n // to be enclosed within a string, so it can't be parsed as an Expression.\n //\n url: function () {\n var value;\n\n if (input.charAt(i) !== 'u' || !$re(/^url\\(/)) {\n return;\n }\n\n value = this.quoted() || this.variable() ||\n $re(/^(?:(?:\\\\[\\(\\)'\"])|[^\\(\\)'\"])+/) || \"\";\n\n expectChar(')');\n\n return new(tree.URL)((value.value != null || value instanceof tree.Variable)\n ? value : new(tree.Anonymous)(value), env.currentFileInfo);\n },\n\n //\n // A Variable entity, such as `@fink`, in\n //\n // width: @fink + 2px\n //\n // We use a different parser for variable definitions,\n // see `parsers.variable`.\n //\n variable: function () {\n var name, index = i;\n\n if (input.charAt(i) === '@' && (name = $re(/^@@?[\\w-]+/))) {\n return new(tree.Variable)(name, index, env.currentFileInfo);\n }\n },\n\n // A variable entity useing the protective {} e.g. @{var}\n variableCurly: function () {\n var curly, index = i;\n\n if (input.charAt(i) === '@' && (curly = $re(/^@\\{([\\w-]+)\\}/))) {\n return new(tree.Variable)(\"@\" + curly[1], index, env.currentFileInfo);\n }\n },\n\n //\n // A Hexadecimal color\n //\n // #4F3C2F\n //\n // `rgb` and `hsl` colors are parsed through the `entities.call` parser.\n //\n color: function () {\n var rgb;\n\n if (input.charAt(i) === '#' && (rgb = $re(/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})/))) {\n return new(tree.Color)(rgb[1]);\n }\n },\n\n //\n // A Dimension, that is, a number and a unit\n //\n // 0.5em 95%\n //\n dimension: function () {\n var value, c = input.charCodeAt(i);\n //Is the first char of the dimension 0-9, '.', '+' or '-'\n if ((c > 57 || c < 43) || c === 47 || c == 44) {\n return;\n }\n\n value = $re(/^([+-]?\\d*\\.?\\d+)(%|[a-z]+)?/);\n if (value) {\n return new(tree.Dimension)(value[1], value[2]);\n }\n },\n\n //\n // A unicode descriptor, as is used in unicode-range\n //\n // U+0?? or U+00A1-00A9\n //\n unicodeDescriptor: function () {\n var ud;\n\n ud = $re(/^U\\+[0-9a-fA-F?]+(\\-[0-9a-fA-F?]+)?/);\n if (ud) {\n return new(tree.UnicodeDescriptor)(ud[0]);\n }\n },\n\n //\n // JavaScript code to be evaluated\n //\n // `window.location.href`\n //\n javascript: function () {\n var str, j = i, e;\n\n if (input.charAt(j) === '~') { j++; e = true; } // Escaped strings\n if (input.charAt(j) !== '`') { return; }\n if (env.javascriptEnabled !== undefined && !env.javascriptEnabled) {\n error(\"You are using JavaScript, which has been disabled.\");\n }\n\n if (e) { $char('~'); }\n\n str = $re(/^`([^`]*)`/);\n if (str) {\n return new(tree.JavaScript)(str[1], i, e);\n }\n }\n },\n\n //\n // The variable part of a variable definition. Used in the `rule` parser\n //\n // @fink:\n //\n variable: function () {\n var name;\n\n if (input.charAt(i) === '@' && (name = $re(/^(@[\\w-]+)\\s*:/))) { return name[1]; }\n },\n\n //\n // The variable part of a variable definition. Used in the `rule` parser\n //\n // @fink();\n //\n rulesetCall: function () {\n var name;\n\n if (input.charAt(i) === '@' && (name = $re(/^(@[\\w-]+)\\s*\\(\\s*\\)\\s*;/))) { \n return new tree.RulesetCall(name[1]); \n }\n },\n\n //\n // extend syntax - used to extend selectors\n //\n extend: function(isRule) {\n var elements, e, index = i, option, extendList, extend;\n\n if (!(isRule ? $re(/^&:extend\\(/) : $re(/^:extend\\(/))) { return; }\n\n do {\n option = null;\n elements = null;\n while (! (option = $re(/^(all)(?=\\s*(\\)|,))/))) {\n e = this.element();\n if (!e) { break; }\n if (elements) { elements.push(e); } else { elements = [ e ]; }\n }\n\n option = option && option[1];\n\n extend = new(tree.Extend)(new(tree.Selector)(elements), option, index);\n if (extendList) { extendList.push(extend); } else { extendList = [ extend ]; }\n\n } while($char(\",\"));\n \n expect(/^\\)/);\n\n if (isRule) {\n expect(/^;/);\n }\n\n return extendList;\n },\n\n //\n // extendRule - used in a rule to extend all the parent selectors\n //\n extendRule: function() {\n return this.extend(true);\n },\n \n //\n // Mixins\n //\n mixin: {\n //\n // A Mixin call, with an optional argument list\n //\n // #mixins > .square(#fff);\n // .rounded(4px, black);\n // .button;\n //\n // The `while` loop is there because mixins can be\n // namespaced, but we only support the child and descendant\n // selector for now.\n //\n call: function () {\n var s = input.charAt(i), important = false, index = i, elemIndex,\n elements, elem, e, c, args;\n\n if (s !== '.' && s !== '#') { return; }\n\n save(); // stop us absorbing part of an invalid selector\n\n while (true) {\n elemIndex = i;\n e = $re(/^[#.](?:[\\w-]|\\\\(?:[A-Fa-f0-9]{1,6} ?|[^A-Fa-f0-9]))+/);\n if (!e) {\n break;\n }\n elem = new(tree.Element)(c, e, elemIndex, env.currentFileInfo);\n if (elements) { elements.push(elem); } else { elements = [ elem ]; }\n c = $char('>');\n }\n\n if (elements) {\n if ($char('(')) {\n args = this.args(true).args;\n expectChar(')');\n }\n\n if (parsers.important()) {\n important = true;\n }\n\n if (parsers.end()) {\n forget();\n return new(tree.mixin.Call)(elements, args, index, env.currentFileInfo, important);\n }\n }\n\n restore();\n },\n args: function (isCall) {\n var parsers = parser.parsers, entities = parsers.entities,\n returner = { args:null, variadic: false },\n expressions = [], argsSemiColon = [], argsComma = [],\n isSemiColonSeperated, expressionContainsNamed, name, nameLoop, value, arg;\n\n save();\n\n while (true) {\n if (isCall) {\n arg = parsers.detachedRuleset() || parsers.expression();\n } else {\n parsers.comments();\n if (input.charAt(i) === '.' && $re(/^\\.{3}/)) {\n returner.variadic = true;\n if ($char(\";\") && !isSemiColonSeperated) {\n isSemiColonSeperated = true;\n }\n (isSemiColonSeperated ? argsSemiColon : argsComma)\n .push({ variadic: true });\n break;\n }\n arg = entities.variable() || entities.literal() || entities.keyword();\n }\n\n if (!arg) {\n break;\n }\n\n nameLoop = null;\n if (arg.throwAwayComments) {\n arg.throwAwayComments();\n }\n value = arg;\n var val = null;\n\n if (isCall) {\n // Variable\n if (arg.value && arg.value.length == 1) {\n val = arg.value[0];\n }\n } else {\n val = arg;\n }\n\n if (val && val instanceof tree.Variable) {\n if ($char(':')) {\n if (expressions.length > 0) {\n if (isSemiColonSeperated) {\n error(\"Cannot mix ; and , as delimiter types\");\n }\n expressionContainsNamed = true;\n }\n\n // we do not support setting a ruleset as a default variable - it doesn't make sense\n // However if we do want to add it, there is nothing blocking it, just don't error\n // and remove isCall dependency below\n value = (isCall && parsers.detachedRuleset()) || parsers.expression();\n\n if (!value) {\n if (isCall) {\n error(\"could not understand value for named argument\");\n } else {\n restore();\n returner.args = [];\n return returner;\n }\n }\n nameLoop = (name = val.name);\n } else if (!isCall && $re(/^\\.{3}/)) {\n returner.variadic = true;\n if ($char(\";\") && !isSemiColonSeperated) {\n isSemiColonSeperated = true;\n }\n (isSemiColonSeperated ? argsSemiColon : argsComma)\n .push({ name: arg.name, variadic: true });\n break;\n } else if (!isCall) {\n name = nameLoop = val.name;\n value = null;\n }\n }\n\n if (value) {\n expressions.push(value);\n }\n\n argsComma.push({ name:nameLoop, value:value });\n\n if ($char(',')) {\n continue;\n }\n\n if ($char(';') || isSemiColonSeperated) {\n\n if (expressionContainsNamed) {\n error(\"Cannot mix ; and , as delimiter types\");\n }\n\n isSemiColonSeperated = true;\n\n if (expressions.length > 1) {\n value = new(tree.Value)(expressions);\n }\n argsSemiColon.push({ name:name, value:value });\n\n name = null;\n expressions = [];\n expressionContainsNamed = false;\n }\n }\n\n forget();\n returner.args = isSemiColonSeperated ? argsSemiColon : argsComma;\n return returner;\n },\n //\n // A Mixin definition, with a list of parameters\n //\n // .rounded (@radius: 2px, @color) {\n // ...\n // }\n //\n // Until we have a finer grained state-machine, we have to\n // do a look-ahead, to make sure we don't have a mixin call.\n // See the `rule` function for more information.\n //\n // We start by matching `.rounded (`, and then proceed on to\n // the argument list, which has optional default values.\n // We store the parameters in `params`, with a `value` key,\n // if there is a value, such as in the case of `@radius`.\n //\n // Once we've got our params list, and a closing `)`, we parse\n // the `{...}` block.\n //\n definition: function () {\n var name, params = [], match, ruleset, cond, variadic = false;\n if ((input.charAt(i) !== '.' && input.charAt(i) !== '#') ||\n peek(/^[^{]*\\}/)) {\n return;\n }\n\n save();\n\n match = $re(/^([#.](?:[\\w-]|\\\\(?:[A-Fa-f0-9]{1,6} ?|[^A-Fa-f0-9]))+)\\s*\\(/);\n if (match) {\n name = match[1];\n\n var argInfo = this.args(false);\n params = argInfo.args;\n variadic = argInfo.variadic;\n\n // .mixincall(\"@{a}\");\n // looks a bit like a mixin definition.. \n // also\n // .mixincall(@a: {rule: set;});\n // so we have to be nice and restore\n if (!$char(')')) {\n furthest = i;\n restore();\n return;\n }\n \n parsers.comments();\n\n if ($re(/^when/)) { // Guard\n cond = expect(parsers.conditions, 'expected condition');\n }\n\n ruleset = parsers.block();\n\n if (ruleset) {\n forget();\n return new(tree.mixin.Definition)(name, params, ruleset, cond, variadic);\n } else {\n restore();\n }\n } else {\n forget();\n }\n }\n },\n\n //\n // Entities are the smallest recognized token,\n // and can be found inside a rule's value.\n //\n entity: function () {\n var entities = this.entities;\n\n return entities.literal() || entities.variable() || entities.url() ||\n entities.call() || entities.keyword() || entities.javascript() ||\n this.comment();\n },\n\n //\n // A Rule terminator. Note that we use `peek()` to check for '}',\n // because the `block` rule will be expecting it, but we still need to make sure\n // it's there, if ';' was ommitted.\n //\n end: function () {\n return $char(';') || peekChar('}');\n },\n\n //\n // IE's alpha function\n //\n // alpha(opacity=88)\n //\n alpha: function () {\n var value;\n\n if (! $re(/^\\(opacity=/i)) { return; }\n value = $re(/^\\d+/) || this.entities.variable();\n if (value) {\n expectChar(')');\n return new(tree.Alpha)(value);\n }\n },\n\n //\n // A Selector Element\n //\n // div\n // + h1\n // #socks\n // input[type=\"text\"]\n //\n // Elements are the building blocks for Selectors,\n // they are made out of a `Combinator` (see combinator rule),\n // and an element name, such as a tag a class, or `*`.\n //\n element: function () {\n var e, c, v, index = i;\n\n c = this.combinator();\n\n e = $re(/^(?:\\d+\\.\\d+|\\d+)%/) || $re(/^(?:[.#]?|:*)(?:[\\w-]|[^\\x00-\\x9f]|\\\\(?:[A-Fa-f0-9]{1,6} ?|[^A-Fa-f0-9]))+/) ||\n $char('*') || $char('&') || this.attribute() || $re(/^\\([^()@]+\\)/) || $re(/^[\\.#](?=@)/) ||\n this.entities.variableCurly();\n\n if (! e) {\n save();\n if ($char('(')) {\n if ((v = this.selector()) && $char(')')) {\n e = new(tree.Paren)(v);\n forget();\n } else {\n restore();\n }\n } else {\n forget();\n }\n }\n\n if (e) { return new(tree.Element)(c, e, index, env.currentFileInfo); }\n },\n\n //\n // Combinators combine elements together, in a Selector.\n //\n // Because our parser isn't white-space sensitive, special care\n // has to be taken, when parsing the descendant combinator, ` `,\n // as it's an empty space. We have to check the previous character\n // in the input, to see if it's a ` ` character. More info on how\n // we deal with this in *combinator.js*.\n //\n combinator: function () {\n var c = input.charAt(i);\n \n if (c === '>' || c === '+' || c === '~' || c === '|' || c === '^') {\n i++;\n if (input.charAt(i) === '^') {\n c = '^^';\n i++;\n }\n while (isWhitespace(input, i)) { i++; }\n return new(tree.Combinator)(c);\n } else if (isWhitespace(input, i - 1)) {\n return new(tree.Combinator)(\" \");\n } else {\n return new(tree.Combinator)(null);\n }\n },\n //\n // A CSS selector (see selector below)\n // with less extensions e.g. the ability to extend and guard\n //\n lessSelector: function () {\n return this.selector(true);\n },\n //\n // A CSS Selector\n //\n // .class > div + h1\n // li a:hover\n //\n // Selectors are made out of one or more Elements, see above.\n //\n selector: function (isLess) {\n var index = i, $re = _$re, elements, extendList, c, e, extend, when, condition;\n\n while ((isLess && (extend = this.extend())) || (isLess && (when = $re(/^when/))) || (e = this.element())) {\n if (when) {\n condition = expect(this.conditions, 'expected condition');\n } else if (condition) {\n error(\"CSS guard can only be used at the end of selector\");\n } else if (extend) {\n if (extendList) { extendList.push(extend); } else { extendList = [ extend ]; }\n } else {\n if (extendList) { error(\"Extend can only be used at the end of selector\"); }\n c = input.charAt(i);\n if (elements) { elements.push(e); } else { elements = [ e ]; }\n e = null;\n }\n if (c === '{' || c === '}' || c === ';' || c === ',' || c === ')') {\n break;\n }\n }\n\n if (elements) { return new(tree.Selector)(elements, extendList, condition, index, env.currentFileInfo); }\n if (extendList) { error(\"Extend must be used to extend a selector, it cannot be used on its own\"); }\n },\n attribute: function () {\n if (! $char('[')) { return; }\n\n var entities = this.entities,\n key, val, op;\n\n if (!(key = entities.variableCurly())) {\n key = expect(/^(?:[_A-Za-z0-9-\\*]*\\|)?(?:[_A-Za-z0-9-]|\\\\.)+/);\n }\n\n op = $re(/^[|~*$^]?=/);\n if (op) {\n val = entities.quoted() || $re(/^[0-9]+%/) || $re(/^[\\w-]+/) || entities.variableCurly();\n }\n\n expectChar(']');\n\n return new(tree.Attribute)(key, op, val);\n },\n\n //\n // The `block` rule is used by `ruleset` and `mixin.definition`.\n // It's a wrapper around the `primary` rule, with added `{}`.\n //\n block: function () {\n var content;\n if ($char('{') && (content = this.primary()) && $char('}')) {\n return content;\n }\n },\n\n blockRuleset: function() {\n var block = this.block();\n\n if (block) {\n block = new tree.Ruleset(null, block);\n }\n return block;\n },\n \n detachedRuleset: function() {\n var blockRuleset = this.blockRuleset();\n if (blockRuleset) {\n return new tree.DetachedRuleset(blockRuleset);\n }\n },\n\n //\n // div, .class, body > p {...}\n //\n ruleset: function () {\n var selectors, s, rules, debugInfo;\n \n save();\n\n if (env.dumpLineNumbers) {\n debugInfo = getDebugInfo(i, input, env);\n }\n\n while (true) {\n s = this.lessSelector();\n if (!s) {\n break;\n }\n if (selectors) { selectors.push(s); } else { selectors = [ s ]; }\n this.comments();\n if (s.condition && selectors.length > 1) {\n error(\"Guards are only currently allowed on a single selector.\");\n }\n if (! $char(',')) { break; }\n if (s.condition) {\n error(\"Guards are only currently allowed on a single selector.\");\n }\n this.comments();\n }\n\n if (selectors && (rules = this.block())) {\n forget();\n var ruleset = new(tree.Ruleset)(selectors, rules, env.strictImports);\n if (env.dumpLineNumbers) {\n ruleset.debugInfo = debugInfo;\n }\n return ruleset;\n } else {\n // Backtrack\n furthest = i;\n restore();\n }\n },\n rule: function (tryAnonymous) {\n var name, value, startOfRule = i, c = input.charAt(startOfRule), important, merge, isVariable;\n\n if (c === '.' || c === '#' || c === '&') { return; }\n\n save();\n\n name = this.variable() || this.ruleProperty();\n if (name) {\n isVariable = typeof name === \"string\";\n \n if (isVariable) {\n value = this.detachedRuleset();\n }\n \n if (!value) {\n // prefer to try to parse first if its a variable or we are compressing\n // but always fallback on the other one\n value = !tryAnonymous && (env.compress || isVariable) ?\n (this.value() || this.anonymousValue()) :\n (this.anonymousValue() || this.value());\n \n important = this.important();\n \n // a name returned by this.ruleProperty() is always an array of the form:\n // [string-1, ..., string-n, \"\"] or [string-1, ..., string-n, \"+\"]\n // where each item is a tree.Keyword or tree.Variable\n merge = !isVariable && name.pop().value;\n }\n\n if (value && this.end()) {\n forget();\n return new (tree.Rule)(name, value, important, merge, startOfRule, env.currentFileInfo);\n } else {\n furthest = i;\n restore();\n if (value && !tryAnonymous) {\n return this.rule(true);\n }\n }\n } else {\n forget();\n }\n },\n anonymousValue: function () {\n var match;\n match = /^([^@+\\/'\"*`(;{}-]*);/.exec(current);\n if (match) {\n i += match[0].length - 1;\n return new(tree.Anonymous)(match[1]);\n }\n },\n\n //\n // An @import directive\n //\n // @import \"lib\";\n //\n // Depending on our environemnt, importing is done differently:\n // In the browser, it's an XHR request, in Node, it would be a\n // file-system operation. The function used for importing is\n // stored in `import`, which we pass to the Import constructor.\n //\n \"import\": function () {\n var path, features, index = i;\n\n save();\n\n var dir = $re(/^@import?\\s+/);\n\n var options = (dir ? this.importOptions() : null) || {};\n\n if (dir && (path = this.entities.quoted() || this.entities.url())) {\n features = this.mediaFeatures();\n if ($char(';')) {\n forget();\n features = features && new(tree.Value)(features);\n return new(tree.Import)(path, features, options, index, env.currentFileInfo);\n }\n }\n\n restore();\n },\n\n importOptions: function() {\n var o, options = {}, optionName, value;\n\n // list of options, surrounded by parens\n if (! $char('(')) { return null; }\n do {\n o = this.importOption();\n if (o) {\n optionName = o;\n value = true;\n switch(optionName) {\n case \"css\":\n optionName = \"less\";\n value = false;\n break;\n case \"once\":\n optionName = \"multiple\";\n value = false;\n break;\n }\n options[optionName] = value;\n if (! $char(',')) { break; }\n }\n } while (o);\n expectChar(')');\n return options;\n },\n\n importOption: function() {\n var opt = $re(/^(less|css|multiple|once|inline|reference)/);\n if (opt) {\n return opt[1];\n }\n },\n\n mediaFeature: function () {\n var entities = this.entities, nodes = [], e, p;\n do {\n e = entities.keyword() || entities.variable();\n if (e) {\n nodes.push(e);\n } else if ($char('(')) {\n p = this.property();\n e = this.value();\n if ($char(')')) {\n if (p && e) {\n nodes.push(new(tree.Paren)(new(tree.Rule)(p, e, null, null, i, env.currentFileInfo, true)));\n } else if (e) {\n nodes.push(new(tree.Paren)(e));\n } else {\n return null;\n }\n } else { return null; }\n }\n } while (e);\n\n if (nodes.length > 0) {\n return new(tree.Expression)(nodes);\n }\n },\n\n mediaFeatures: function () {\n var entities = this.entities, features = [], e;\n do {\n e = this.mediaFeature();\n if (e) {\n features.push(e);\n if (! $char(',')) { break; }\n } else {\n e = entities.variable();\n if (e) {\n features.push(e);\n if (! $char(',')) { break; }\n }\n }\n } while (e);\n\n return features.length > 0 ? features : null;\n },\n\n media: function () {\n var features, rules, media, debugInfo;\n\n if (env.dumpLineNumbers) {\n debugInfo = getDebugInfo(i, input, env);\n }\n\n if ($re(/^@media/)) {\n features = this.mediaFeatures();\n\n rules = this.block();\n if (rules) {\n media = new(tree.Media)(rules, features, i, env.currentFileInfo);\n if (env.dumpLineNumbers) {\n media.debugInfo = debugInfo;\n }\n return media;\n }\n }\n },\n\n //\n // A CSS Directive\n //\n // @charset \"utf-8\";\n //\n directive: function () {\n var index = i, name, value, rules, nonVendorSpecificName,\n hasIdentifier, hasExpression, hasUnknown, hasBlock = true;\n\n if (input.charAt(i) !== '@') { return; }\n\n value = this['import']() || this.media();\n if (value) {\n return value;\n }\n\n save();\n\n name = $re(/^@[a-z-]+/);\n \n if (!name) { return; }\n\n nonVendorSpecificName = name;\n if (name.charAt(1) == '-' && name.indexOf('-', 2) > 0) {\n nonVendorSpecificName = \"@\" + name.slice(name.indexOf('-', 2) + 1);\n }\n\n switch(nonVendorSpecificName) {\n /*\n case \"@font-face\":\n case \"@viewport\":\n case \"@top-left\":\n case \"@top-left-corner\":\n case \"@top-center\":\n case \"@top-right\":\n case \"@top-right-corner\":\n case \"@bottom-left\":\n case \"@bottom-left-corner\":\n case \"@bottom-center\":\n case \"@bottom-right\":\n case \"@bottom-right-corner\":\n case \"@left-top\":\n case \"@left-middle\":\n case \"@left-bottom\":\n case \"@right-top\":\n case \"@right-middle\":\n case \"@right-bottom\":\n hasBlock = true;\n break;\n */\n case \"@charset\":\n hasIdentifier = true;\n hasBlock = false;\n break;\n case \"@namespace\":\n hasExpression = true;\n hasBlock = false;\n break;\n case \"@keyframes\":\n hasIdentifier = true;\n break;\n case \"@host\":\n case \"@page\":\n case \"@document\":\n case \"@supports\":\n hasUnknown = true;\n break;\n }\n\n if (hasIdentifier) {\n value = this.entity();\n if (!value) {\n error(\"expected \" + name + \" identifier\");\n }\n } else if (hasExpression) {\n value = this.expression();\n if (!value) {\n error(\"expected \" + name + \" expression\");\n }\n } else if (hasUnknown) {\n value = ($re(/^[^{;]+/) || '').trim();\n if (value) {\n value = new(tree.Anonymous)(value);\n }\n }\n\n if (hasBlock) {\n rules = this.blockRuleset();\n }\n\n if (rules || (!hasBlock && value && $char(';'))) {\n forget();\n return new(tree.Directive)(name, value, rules, index, env.currentFileInfo, \n env.dumpLineNumbers ? getDebugInfo(index, input, env) : null);\n }\n\n restore();\n },\n\n //\n // A Value is a comma-delimited list of Expressions\n //\n // font-family: Baskerville, Georgia, serif;\n //\n // In a Rule, a Value represents everything after the `:`,\n // and before the `;`.\n //\n value: function () {\n var e, expressions = [];\n\n do {\n e = this.expression();\n if (e) {\n expressions.push(e);\n if (! $char(',')) { break; }\n }\n } while(e);\n\n if (expressions.length > 0) {\n return new(tree.Value)(expressions);\n }\n },\n important: function () {\n if (input.charAt(i) === '!') {\n return $re(/^! *important/);\n }\n },\n sub: function () {\n var a, e;\n\n if ($char('(')) {\n a = this.addition();\n if (a) {\n e = new(tree.Expression)([a]);\n expectChar(')');\n e.parens = true;\n return e;\n }\n }\n },\n multiplication: function () {\n var m, a, op, operation, isSpaced;\n m = this.operand();\n if (m) {\n isSpaced = isWhitespace(input, i - 1);\n while (true) {\n if (peek(/^\\/[*\\/]/)) {\n break;\n }\n op = $char('/') || $char('*');\n\n if (!op) { break; }\n\n a = this.operand();\n\n if (!a) { break; }\n\n m.parensInOp = true;\n a.parensInOp = true;\n operation = new(tree.Operation)(op, [operation || m, a], isSpaced);\n isSpaced = isWhitespace(input, i - 1);\n }\n return operation || m;\n }\n },\n addition: function () {\n var m, a, op, operation, isSpaced;\n m = this.multiplication();\n if (m) {\n isSpaced = isWhitespace(input, i - 1);\n while (true) {\n op = $re(/^[-+]\\s+/) || (!isSpaced && ($char('+') || $char('-')));\n if (!op) {\n break;\n }\n a = this.multiplication();\n if (!a) {\n break;\n }\n \n m.parensInOp = true;\n a.parensInOp = true;\n operation = new(tree.Operation)(op, [operation || m, a], isSpaced);\n isSpaced = isWhitespace(input, i - 1);\n }\n return operation || m;\n }\n },\n conditions: function () {\n var a, b, index = i, condition;\n\n a = this.condition();\n if (a) {\n while (true) {\n if (!peek(/^,\\s*(not\\s*)?\\(/) || !$char(',')) {\n break;\n }\n b = this.condition();\n if (!b) {\n break;\n }\n condition = new(tree.Condition)('or', condition || a, b, index);\n }\n return condition || a;\n }\n },\n condition: function () {\n var entities = this.entities, index = i, negate = false,\n a, b, c, op;\n\n if ($re(/^not/)) { negate = true; }\n expectChar('(');\n a = this.addition() || entities.keyword() || entities.quoted();\n if (a) {\n op = $re(/^(?:>=|<=|=<|[<=>])/);\n if (op) {\n b = this.addition() || entities.keyword() || entities.quoted();\n if (b) {\n c = new(tree.Condition)(op, a, b, index, negate);\n } else {\n error('expected expression');\n }\n } else {\n c = new(tree.Condition)('=', a, new(tree.Keyword)('true'), index, negate);\n }\n expectChar(')');\n return $re(/^and/) ? new(tree.Condition)('and', c, this.condition()) : c;\n }\n },\n\n //\n // An operand is anything that can be part of an operation,\n // such as a Color, or a Variable\n //\n operand: function () {\n var entities = this.entities,\n p = input.charAt(i + 1), negate;\n\n if (input.charAt(i) === '-' && (p === '@' || p === '(')) { negate = $char('-'); }\n var o = this.sub() || entities.dimension() ||\n entities.color() || entities.variable() ||\n entities.call();\n\n if (negate) {\n o.parensInOp = true;\n o = new(tree.Negative)(o);\n }\n\n return o;\n },\n\n //\n // Expressions either represent mathematical operations,\n // or white-space delimited Entities.\n //\n // 1px solid black\n // @var * 2\n //\n expression: function () {\n var entities = [], e, delim;\n\n do {\n e = this.addition() || this.entity();\n if (e) {\n entities.push(e);\n // operations do not allow keyword \"/\" dimension (e.g. small/20px) so we support that here\n if (!peek(/^\\/[\\/*]/)) {\n delim = $char('/');\n if (delim) {\n entities.push(new(tree.Anonymous)(delim));\n }\n }\n }\n } while (e);\n if (entities.length > 0) {\n return new(tree.Expression)(entities);\n }\n },\n property: function () {\n var name = $re(/^(\\*?-?[_a-zA-Z0-9-]+)\\s*:/);\n if (name) {\n return name[1];\n }\n },\n ruleProperty: function () {\n var c = current, name = [], index = [], length = 0, s, k;\n \n function match(re) {\n var a = re.exec(c);\n if (a) {\n index.push(i + length);\n length += a[0].length;\n c = c.slice(a[1].length);\n return name.push(a[1]);\n }\n }\n\n match(/^(\\*?)/);\n while (match(/^((?:[\\w-]+)|(?:@\\{[\\w-]+\\}))/)); // !\n if ((name.length > 1) && match(/^\\s*((?:\\+_|\\+)?)\\s*:/)) {\n // at last, we have the complete match now. move forward, \n // convert name particles to tree objects and return:\n skipWhitespace(length);\n if (name[0] === '') {\n name.shift();\n index.shift();\n }\n for (k = 0; k < name.length; k++) {\n s = name[k];\n name[k] = (s.charAt(0) !== '@')\n ? new(tree.Keyword)(s)\n : new(tree.Variable)('@' + s.slice(2, -1), \n index[k], env.currentFileInfo);\n }\n return name;\n }\n }\n }\n };\n return parser;\n};\nless.Parser.serializeVars = function(vars) {\n var s = '';\n\n for (var name in vars) {\n if (Object.hasOwnProperty.call(vars, name)) {\n var value = vars[name];\n s += ((name[0] === '@') ? '' : '@') + name +': '+ value +\n ((('' + value).slice(-1) === ';') ? '' : ';');\n }\n }\n\n return s;\n};\n\n(function (tree) {\n\ntree.functions = {\n rgb: function (r, g, b) {\n return this.rgba(r, g, b, 1.0);\n },\n rgba: function (r, g, b, a) {\n var rgb = [r, g, b].map(function (c) { return scaled(c, 255); });\n a = number(a);\n return new(tree.Color)(rgb, a);\n },\n hsl: function (h, s, l) {\n return this.hsla(h, s, l, 1.0);\n },\n hsla: function (h, s, l, a) {\n function hue(h) {\n h = h < 0 ? h + 1 : (h > 1 ? h - 1 : h);\n if (h * 6 < 1) { return m1 + (m2 - m1) * h * 6; }\n else if (h * 2 < 1) { return m2; }\n else if (h * 3 < 2) { return m1 + (m2 - m1) * (2/3 - h) * 6; }\n else { return m1; }\n }\n\n h = (number(h) % 360) / 360;\n s = clamp(number(s)); l = clamp(number(l)); a = clamp(number(a));\n\n var m2 = l <= 0.5 ? l * (s + 1) : l + s - l * s;\n var m1 = l * 2 - m2;\n\n return this.rgba(hue(h + 1/3) * 255,\n hue(h) * 255,\n hue(h - 1/3) * 255,\n a);\n },\n\n hsv: function(h, s, v) {\n return this.hsva(h, s, v, 1.0);\n },\n\n hsva: function(h, s, v, a) {\n h = ((number(h) % 360) / 360) * 360;\n s = number(s); v = number(v); a = number(a);\n\n var i, f;\n i = Math.floor((h / 60) % 6);\n f = (h / 60) - i;\n\n var vs = [v,\n v * (1 - s),\n v * (1 - f * s),\n v * (1 - (1 - f) * s)];\n var perm = [[0, 3, 1],\n [2, 0, 1],\n [1, 0, 3],\n [1, 2, 0],\n [3, 1, 0],\n [0, 1, 2]];\n\n return this.rgba(vs[perm[i][0]] * 255,\n vs[perm[i][1]] * 255,\n vs[perm[i][2]] * 255,\n a);\n },\n\n hue: function (color) {\n return new(tree.Dimension)(Math.round(color.toHSL().h));\n },\n saturation: function (color) {\n return new(tree.Dimension)(Math.round(color.toHSL().s * 100), '%');\n },\n lightness: function (color) {\n return new(tree.Dimension)(Math.round(color.toHSL().l * 100), '%');\n },\n hsvhue: function(color) {\n return new(tree.Dimension)(Math.round(color.toHSV().h));\n },\n hsvsaturation: function (color) {\n return new(tree.Dimension)(Math.round(color.toHSV().s * 100), '%');\n },\n hsvvalue: function (color) {\n return new(tree.Dimension)(Math.round(color.toHSV().v * 100), '%');\n },\n red: function (color) {\n return new(tree.Dimension)(color.rgb[0]);\n },\n green: function (color) {\n return new(tree.Dimension)(color.rgb[1]);\n },\n blue: function (color) {\n return new(tree.Dimension)(color.rgb[2]);\n },\n alpha: function (color) {\n return new(tree.Dimension)(color.toHSL().a);\n },\n luma: function (color) {\n return new(tree.Dimension)(Math.round(color.luma() * color.alpha * 100), '%');\n },\n luminance: function (color) {\n var luminance =\n (0.2126 * color.rgb[0] / 255)\n + (0.7152 * color.rgb[1] / 255)\n + (0.0722 * color.rgb[2] / 255);\n\n return new(tree.Dimension)(Math.round(luminance * color.alpha * 100), '%');\n },\n saturate: function (color, amount) {\n // filter: saturate(3.2);\n // should be kept as is, so check for color\n if (!color.rgb) {\n return null;\n }\n var hsl = color.toHSL();\n\n hsl.s += amount.value / 100;\n hsl.s = clamp(hsl.s);\n return hsla(hsl);\n },\n desaturate: function (color, amount) {\n var hsl = color.toHSL();\n\n hsl.s -= amount.value / 100;\n hsl.s = clamp(hsl.s);\n return hsla(hsl);\n },\n lighten: function (color, amount) {\n var hsl = color.toHSL();\n\n hsl.l += amount.value / 100;\n hsl.l = clamp(hsl.l);\n return hsla(hsl);\n },\n darken: function (color, amount) {\n var hsl = color.toHSL();\n\n hsl.l -= amount.value / 100;\n hsl.l = clamp(hsl.l);\n return hsla(hsl);\n },\n fadein: function (color, amount) {\n var hsl = color.toHSL();\n\n hsl.a += amount.value / 100;\n hsl.a = clamp(hsl.a);\n return hsla(hsl);\n },\n fadeout: function (color, amount) {\n var hsl = color.toHSL();\n\n hsl.a -= amount.value / 100;\n hsl.a = clamp(hsl.a);\n return hsla(hsl);\n },\n fade: function (color, amount) {\n var hsl = color.toHSL();\n\n hsl.a = amount.value / 100;\n hsl.a = clamp(hsl.a);\n return hsla(hsl);\n },\n spin: function (color, amount) {\n var hsl = color.toHSL();\n var hue = (hsl.h + amount.value) % 360;\n\n hsl.h = hue < 0 ? 360 + hue : hue;\n\n return hsla(hsl);\n },\n //\n // Copyright (c) 2006-2009 Hampton Catlin, Nathan Weizenbaum, and Chris Eppstein\n // http://sass-lang.com\n //\n mix: function (color1, color2, weight) {\n if (!weight) {\n weight = new(tree.Dimension)(50);\n }\n var p = weight.value / 100.0;\n var w = p * 2 - 1;\n var a = color1.toHSL().a - color2.toHSL().a;\n\n var w1 = (((w * a == -1) ? w : (w + a) / (1 + w * a)) + 1) / 2.0;\n var w2 = 1 - w1;\n\n var rgb = [color1.rgb[0] * w1 + color2.rgb[0] * w2,\n color1.rgb[1] * w1 + color2.rgb[1] * w2,\n color1.rgb[2] * w1 + color2.rgb[2] * w2];\n\n var alpha = color1.alpha * p + color2.alpha * (1 - p);\n\n return new(tree.Color)(rgb, alpha);\n },\n greyscale: function (color) {\n return this.desaturate(color, new(tree.Dimension)(100));\n },\n contrast: function (color, dark, light, threshold) {\n // filter: contrast(3.2);\n // should be kept as is, so check for color\n if (!color.rgb) {\n return null;\n }\n if (typeof light === 'undefined') {\n light = this.rgba(255, 255, 255, 1.0);\n }\n if (typeof dark === 'undefined') {\n dark = this.rgba(0, 0, 0, 1.0);\n }\n //Figure out which is actually light and dark!\n if (dark.luma() > light.luma()) {\n var t = light;\n light = dark;\n dark = t;\n }\n if (typeof threshold === 'undefined') {\n threshold = 0.43;\n } else {\n threshold = number(threshold);\n }\n if (color.luma() < threshold) {\n return light;\n } else {\n return dark;\n }\n },\n e: function (str) {\n return new(tree.Anonymous)(str instanceof tree.JavaScript ? str.evaluated : str);\n },\n escape: function (str) {\n return new(tree.Anonymous)(encodeURI(str.value).replace(/=/g, \"%3D\").replace(/:/g, \"%3A\").replace(/#/g, \"%23\").replace(/;/g, \"%3B\").replace(/\\(/g, \"%28\").replace(/\\)/g, \"%29\"));\n },\n replace: function (string, pattern, replacement, flags) {\n var result = string.value;\n\n result = result.replace(new RegExp(pattern.value, flags ? flags.value : ''), replacement.value);\n return new(tree.Quoted)(string.quote || '', result, string.escaped);\n },\n '%': function (string /* arg, arg, ...*/) {\n var args = Array.prototype.slice.call(arguments, 1),\n result = string.value;\n\n for (var i = 0; i < args.length; i++) {\n /*jshint loopfunc:true */\n result = result.replace(/%[sda]/i, function(token) {\n var value = token.match(/s/i) ? args[i].value : args[i].toCSS();\n return token.match(/[A-Z]$/) ? encodeURIComponent(value) : value;\n });\n }\n result = result.replace(/%%/g, '%');\n return new(tree.Quoted)(string.quote || '', result, string.escaped);\n },\n unit: function (val, unit) {\n if(!(val instanceof tree.Dimension)) {\n throw { type: \"Argument\", message: \"the first argument to unit must be a number\" + (val instanceof tree.Operation ? \". Have you forgotten parenthesis?\" : \"\") };\n }\n if (unit) {\n if (unit instanceof tree.Keyword) {\n unit = unit.value;\n } else {\n unit = unit.toCSS();\n }\n } else {\n unit = \"\";\n }\n return new(tree.Dimension)(val.value, unit);\n },\n convert: function (val, unit) {\n return val.convertTo(unit.value);\n },\n round: function (n, f) {\n var fraction = typeof(f) === \"undefined\" ? 0 : f.value;\n return _math(function(num) { return num.toFixed(fraction); }, null, n);\n },\n pi: function () {\n return new(tree.Dimension)(Math.PI);\n },\n mod: function(a, b) {\n return new(tree.Dimension)(a.value % b.value, a.unit);\n },\n pow: function(x, y) {\n if (typeof x === \"number\" && typeof y === \"number\") {\n x = new(tree.Dimension)(x);\n y = new(tree.Dimension)(y);\n } else if (!(x instanceof tree.Dimension) || !(y instanceof tree.Dimension)) {\n throw { type: \"Argument\", message: \"arguments must be numbers\" };\n }\n\n return new(tree.Dimension)(Math.pow(x.value, y.value), x.unit);\n },\n _minmax: function (isMin, args) {\n args = Array.prototype.slice.call(args);\n switch(args.length) {\n case 0: throw { type: \"Argument\", message: \"one or more arguments required\" };\n }\n var i, j, current, currentUnified, referenceUnified, unit, unitStatic, unitClone,\n order = [], // elems only contains original argument values.\n values = {}; // key is the unit.toString() for unified tree.Dimension values,\n // value is the index into the order array.\n for (i = 0; i < args.length; i++) {\n current = args[i];\n if (!(current instanceof tree.Dimension)) {\n if(Array.isArray(args[i].value)) {\n Array.prototype.push.apply(args, Array.prototype.slice.call(args[i].value));\n }\n continue;\n }\n currentUnified = current.unit.toString() === \"\" && unitClone !== undefined ? new(tree.Dimension)(current.value, unitClone).unify() : current.unify();\n unit = currentUnified.unit.toString() === \"\" && unitStatic !== undefined ? unitStatic : currentUnified.unit.toString();\t\t\t\n unitStatic = unit !== \"\" && unitStatic === undefined || unit !== \"\" && order[0].unify().unit.toString() === \"\" ? unit : unitStatic;\n unitClone = unit !== \"\" && unitClone === undefined ? current.unit.toString() : unitClone;\n j = values[\"\"] !== undefined && unit !== \"\" && unit === unitStatic ? values[\"\"] : values[unit];\n if (j === undefined) {\n if(unitStatic !== undefined && unit !== unitStatic) {\n throw{ type: \"Argument\", message: \"incompatible types\" };\n }\n values[unit] = order.length;\n order.push(current);\n continue;\n }\n referenceUnified = order[j].unit.toString() === \"\" && unitClone !== undefined ? new(tree.Dimension)(order[j].value, unitClone).unify() : order[j].unify();\n if ( isMin && currentUnified.value < referenceUnified.value ||\n !isMin && currentUnified.value > referenceUnified.value) {\n order[j] = current;\n }\n }\n if (order.length == 1) {\n return order[0];\n }\n args = order.map(function (a) { return a.toCSS(this.env); }).join(this.env.compress ? \",\" : \", \");\n return new(tree.Anonymous)((isMin ? \"min\" : \"max\") + \"(\" + args + \")\");\n },\n min: function () {\n return this._minmax(true, arguments);\n },\n max: function () {\n return this._minmax(false, arguments);\n },\n \"get-unit\": function (n) {\n return new(tree.Anonymous)(n.unit);\n },\n argb: function (color) {\n return new(tree.Anonymous)(color.toARGB());\n },\n percentage: function (n) {\n return new(tree.Dimension)(n.value * 100, '%');\n },\n color: function (n) {\n if (n instanceof tree.Quoted) {\n var colorCandidate = n.value,\n returnColor;\n returnColor = tree.Color.fromKeyword(colorCandidate);\n if (returnColor) {\n return returnColor;\n }\n if (/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})/.test(colorCandidate)) {\n return new(tree.Color)(colorCandidate.slice(1));\n }\n throw { type: \"Argument\", message: \"argument must be a color keyword or 3/6 digit hex e.g. #FFF\" };\n } else {\n throw { type: \"Argument\", message: \"argument must be a string\" };\n }\n },\n iscolor: function (n) {\n return this._isa(n, tree.Color);\n },\n isnumber: function (n) {\n return this._isa(n, tree.Dimension);\n },\n isstring: function (n) {\n return this._isa(n, tree.Quoted);\n },\n iskeyword: function (n) {\n return this._isa(n, tree.Keyword);\n },\n isurl: function (n) {\n return this._isa(n, tree.URL);\n },\n ispixel: function (n) {\n return this.isunit(n, 'px');\n },\n ispercentage: function (n) {\n return this.isunit(n, '%');\n },\n isem: function (n) {\n return this.isunit(n, 'em');\n },\n isunit: function (n, unit) {\n return (n instanceof tree.Dimension) && n.unit.is(unit.value || unit) ? tree.True : tree.False;\n },\n _isa: function (n, Type) {\n return (n instanceof Type) ? tree.True : tree.False;\n },\n tint: function(color, amount) {\n return this.mix(this.rgb(255,255,255), color, amount);\n },\n shade: function(color, amount) {\n return this.mix(this.rgb(0, 0, 0), color, amount);\n }, \n extract: function(values, index) {\n index = index.value - 1; // (1-based index) \n // handle non-array values as an array of length 1\n // return 'undefined' if index is invalid\n return Array.isArray(values.value) \n ? values.value[index] : Array(values)[index];\n },\n length: function(values) {\n var n = Array.isArray(values.value) ? values.value.length : 1;\n return new tree.Dimension(n);\n },\n\n \"data-uri\": function(mimetypeNode, filePathNode) {\n\n if (typeof window !== 'undefined') {\n return new tree.URL(filePathNode || mimetypeNode, this.currentFileInfo).eval(this.env);\n }\n\n var mimetype = mimetypeNode.value;\n var filePath = (filePathNode && filePathNode.value);\n\n var fs = require('fs'),\n path = require('path'),\n useBase64 = false;\n\n if (arguments.length < 2) {\n filePath = mimetype;\n }\n\n if (this.env.isPathRelative(filePath)) {\n if (this.currentFileInfo.relativeUrls) {\n filePath = path.join(this.currentFileInfo.currentDirectory, filePath);\n } else {\n filePath = path.join(this.currentFileInfo.entryPath, filePath);\n }\n }\n\n // detect the mimetype if not given\n if (arguments.length < 2) {\n var mime;\n try {\n mime = require('mime');\n } catch (ex) {\n mime = tree._mime;\n }\n\n mimetype = mime.lookup(filePath);\n\n // use base 64 unless it's an ASCII or UTF-8 format\n var charset = mime.charsets.lookup(mimetype);\n useBase64 = ['US-ASCII', 'UTF-8'].indexOf(charset) < 0;\n if (useBase64) { mimetype += ';base64'; }\n }\n else {\n useBase64 = /;base64$/.test(mimetype);\n }\n\n var buf = fs.readFileSync(filePath);\n\n // IE8 cannot handle a data-uri larger than 32KB. If this is exceeded\n // and the --ieCompat flag is enabled, return a normal url() instead.\n var DATA_URI_MAX_KB = 32,\n fileSizeInKB = parseInt((buf.length / 1024), 10);\n if (fileSizeInKB >= DATA_URI_MAX_KB) {\n\n if (this.env.ieCompat !== false) {\n if (!this.env.silent) {\n console.warn(\"Skipped data-uri embedding of %s because its size (%dKB) exceeds IE8-safe %dKB!\", filePath, fileSizeInKB, DATA_URI_MAX_KB);\n }\n\n return new tree.URL(filePathNode || mimetypeNode, this.currentFileInfo).eval(this.env);\n }\n }\n\n buf = useBase64 ? buf.toString('base64')\n : encodeURIComponent(buf);\n\n var uri = \"\\\"data:\" + mimetype + ',' + buf + \"\\\"\";\n return new(tree.URL)(new(tree.Anonymous)(uri));\n },\n\n \"svg-gradient\": function(direction) {\n\n function throwArgumentDescriptor() {\n throw { type: \"Argument\", message: \"svg-gradient expects direction, start_color [start_position], [color position,]..., end_color [end_position]\" };\n }\n\n if (arguments.length < 3) {\n throwArgumentDescriptor();\n }\n var stops = Array.prototype.slice.call(arguments, 1),\n gradientDirectionSvg,\n gradientType = \"linear\",\n rectangleDimension = 'x=\"0\" y=\"0\" width=\"1\" height=\"1\"',\n useBase64 = true,\n renderEnv = {compress: false},\n returner,\n directionValue = direction.toCSS(renderEnv),\n i, color, position, positionValue, alpha;\n\n switch (directionValue) {\n case \"to bottom\":\n gradientDirectionSvg = 'x1=\"0%\" y1=\"0%\" x2=\"0%\" y2=\"100%\"';\n break;\n case \"to right\":\n gradientDirectionSvg = 'x1=\"0%\" y1=\"0%\" x2=\"100%\" y2=\"0%\"';\n break;\n case \"to bottom right\":\n gradientDirectionSvg = 'x1=\"0%\" y1=\"0%\" x2=\"100%\" y2=\"100%\"';\n break;\n case \"to top right\":\n gradientDirectionSvg = 'x1=\"0%\" y1=\"100%\" x2=\"100%\" y2=\"0%\"';\n break;\n case \"ellipse\":\n case \"ellipse at center\":\n gradientType = \"radial\";\n gradientDirectionSvg = 'cx=\"50%\" cy=\"50%\" r=\"75%\"';\n rectangleDimension = 'x=\"-50\" y=\"-50\" width=\"101\" height=\"101\"';\n break;\n default:\n throw { type: \"Argument\", message: \"svg-gradient direction must be 'to bottom', 'to right', 'to bottom right', 'to top right' or 'ellipse at center'\" };\n }\n returner = '' +\n '' +\n '<' + gradientType + 'Gradient id=\"gradient\" gradientUnits=\"userSpaceOnUse\" ' + gradientDirectionSvg + '>';\n\n for (i = 0; i < stops.length; i+= 1) {\n if (stops[i].value) {\n color = stops[i].value[0];\n position = stops[i].value[1];\n } else {\n color = stops[i];\n position = undefined;\n }\n\n if (!(color instanceof tree.Color) || (!((i === 0 || i+1 === stops.length) && position === undefined) && !(position instanceof tree.Dimension))) {\n throwArgumentDescriptor();\n }\n positionValue = position ? position.toCSS(renderEnv) : i === 0 ? \"0%\" : \"100%\";\n alpha = color.alpha;\n returner += '';\n }\n returner += '' +\n '';\n\n if (useBase64) {\n try {\n returner = require('./encoder').encodeBase64(returner); // TODO browser implementation\n } catch(e) {\n useBase64 = false;\n }\n }\n\n returner = \"'data:image/svg+xml\" + (useBase64 ? \";base64\" : \"\") + \",\" + returner + \"'\";\n return new(tree.URL)(new(tree.Anonymous)(returner));\n }\n};\n\n// these static methods are used as a fallback when the optional 'mime' dependency is missing\ntree._mime = {\n // this map is intentionally incomplete\n // if you want more, install 'mime' dep\n _types: {\n '.htm' : 'text/html',\n '.html': 'text/html',\n '.gif' : 'image/gif',\n '.jpg' : 'image/jpeg',\n '.jpeg': 'image/jpeg',\n '.png' : 'image/png'\n },\n lookup: function (filepath) {\n var ext = require('path').extname(filepath),\n type = tree._mime._types[ext];\n if (type === undefined) {\n throw new Error('Optional dependency \"mime\" is required for ' + ext);\n }\n return type;\n },\n charsets: {\n lookup: function (type) {\n // assumes all text types are UTF-8\n return type && (/^text\\//).test(type) ? 'UTF-8' : '';\n }\n }\n};\n\n// Math\n\nvar mathFunctions = {\n // name, unit\n ceil: null, \n floor: null, \n sqrt: null, \n abs: null,\n tan: \"\", \n sin: \"\", \n cos: \"\",\n atan: \"rad\", \n asin: \"rad\", \n acos: \"rad\"\n};\n\nfunction _math(fn, unit, n) {\n if (!(n instanceof tree.Dimension)) {\n throw { type: \"Argument\", message: \"argument must be a number\" };\n }\n if (unit == null) {\n unit = n.unit;\n } else {\n n = n.unify();\n }\n return new(tree.Dimension)(fn(parseFloat(n.value)), unit);\n}\n\n// ~ End of Math\n\n// Color Blending\n// ref: http://www.w3.org/TR/compositing-1\n\nfunction colorBlend(mode, color1, color2) {\n var ab = color1.alpha, cb, // backdrop\n as = color2.alpha, cs, // source\n ar, cr, r = []; // result\n \n ar = as + ab * (1 - as);\n for (var i = 0; i < 3; i++) {\n cb = color1.rgb[i] / 255;\n cs = color2.rgb[i] / 255;\n cr = mode(cb, cs);\n if (ar) {\n cr = (as * cs + ab * (cb \n - as * (cb + cs - cr))) / ar;\n }\n r[i] = cr * 255;\n }\n \n return new(tree.Color)(r, ar);\n}\n\nvar colorBlendMode = {\n multiply: function(cb, cs) {\n return cb * cs;\n },\n screen: function(cb, cs) {\n return cb + cs - cb * cs;\n }, \n overlay: function(cb, cs) {\n cb *= 2;\n return (cb <= 1)\n ? colorBlendMode.multiply(cb, cs)\n : colorBlendMode.screen(cb - 1, cs);\n },\n softlight: function(cb, cs) {\n var d = 1, e = cb;\n if (cs > 0.5) {\n e = 1;\n d = (cb > 0.25) ? Math.sqrt(cb)\n : ((16 * cb - 12) * cb + 4) * cb;\n } \n return cb - (1 - 2 * cs) * e * (d - cb);\n },\n hardlight: function(cb, cs) {\n return colorBlendMode.overlay(cs, cb);\n },\n difference: function(cb, cs) {\n return Math.abs(cb - cs);\n },\n exclusion: function(cb, cs) {\n return cb + cs - 2 * cb * cs;\n },\n\n // non-w3c functions:\n average: function(cb, cs) {\n return (cb + cs) / 2;\n },\n negation: function(cb, cs) {\n return 1 - Math.abs(cb + cs - 1);\n }\n};\n\n// ~ End of Color Blending\n\ntree.defaultFunc = {\n eval: function () {\n var v = this.value_, e = this.error_;\n if (e) {\n throw e;\n }\n if (v != null) {\n return v ? tree.True : tree.False;\n }\n },\n value: function (v) {\n this.value_ = v;\n },\n error: function (e) {\n this.error_ = e;\n },\n reset: function () {\n this.value_ = this.error_ = null;\n }\n};\n\nfunction initFunctions() {\n var f, tf = tree.functions;\n \n // math\n for (f in mathFunctions) {\n if (mathFunctions.hasOwnProperty(f)) {\n tf[f] = _math.bind(null, Math[f], mathFunctions[f]);\n }\n }\n \n // color blending\n for (f in colorBlendMode) {\n if (colorBlendMode.hasOwnProperty(f)) {\n tf[f] = colorBlend.bind(null, colorBlendMode[f]);\n }\n }\n \n // default\n f = tree.defaultFunc;\n tf[\"default\"] = f.eval.bind(f);\n \n} initFunctions();\n\nfunction hsla(color) {\n return tree.functions.hsla(color.h, color.s, color.l, color.a);\n}\n\nfunction scaled(n, size) {\n if (n instanceof tree.Dimension && n.unit.is('%')) {\n return parseFloat(n.value * size / 100);\n } else {\n return number(n);\n }\n}\n\nfunction number(n) {\n if (n instanceof tree.Dimension) {\n return parseFloat(n.unit.is('%') ? n.value / 100 : n.value);\n } else if (typeof(n) === 'number') {\n return n;\n } else {\n throw {\n error: \"RuntimeError\",\n message: \"color functions take numbers as parameters\"\n };\n }\n}\n\nfunction clamp(val) {\n return Math.min(1, Math.max(0, val));\n}\n\ntree.fround = function(env, value) {\n var p;\n if (env && (env.numPrecision != null)) {\n p = Math.pow(10, env.numPrecision);\n return Math.round(value * p) / p;\n } else {\n return value;\n }\n};\n\ntree.functionCall = function(env, currentFileInfo) {\n this.env = env;\n this.currentFileInfo = currentFileInfo;\n};\n\ntree.functionCall.prototype = tree.functions;\n\n})(require('./tree'));\n\n(function (tree) {\n tree.colors = {\n 'aliceblue':'#f0f8ff',\n 'antiquewhite':'#faebd7',\n 'aqua':'#00ffff',\n 'aquamarine':'#7fffd4',\n 'azure':'#f0ffff',\n 'beige':'#f5f5dc',\n 'bisque':'#ffe4c4',\n 'black':'#000000',\n 'blanchedalmond':'#ffebcd',\n 'blue':'#0000ff',\n 'blueviolet':'#8a2be2',\n 'brown':'#a52a2a',\n 'burlywood':'#deb887',\n 'cadetblue':'#5f9ea0',\n 'chartreuse':'#7fff00',\n 'chocolate':'#d2691e',\n 'coral':'#ff7f50',\n 'cornflowerblue':'#6495ed',\n 'cornsilk':'#fff8dc',\n 'crimson':'#dc143c',\n 'cyan':'#00ffff',\n 'darkblue':'#00008b',\n 'darkcyan':'#008b8b',\n 'darkgoldenrod':'#b8860b',\n 'darkgray':'#a9a9a9',\n 'darkgrey':'#a9a9a9',\n 'darkgreen':'#006400',\n 'darkkhaki':'#bdb76b',\n 'darkmagenta':'#8b008b',\n 'darkolivegreen':'#556b2f',\n 'darkorange':'#ff8c00',\n 'darkorchid':'#9932cc',\n 'darkred':'#8b0000',\n 'darksalmon':'#e9967a',\n 'darkseagreen':'#8fbc8f',\n 'darkslateblue':'#483d8b',\n 'darkslategray':'#2f4f4f',\n 'darkslategrey':'#2f4f4f',\n 'darkturquoise':'#00ced1',\n 'darkviolet':'#9400d3',\n 'deeppink':'#ff1493',\n 'deepskyblue':'#00bfff',\n 'dimgray':'#696969',\n 'dimgrey':'#696969',\n 'dodgerblue':'#1e90ff',\n 'firebrick':'#b22222',\n 'floralwhite':'#fffaf0',\n 'forestgreen':'#228b22',\n 'fuchsia':'#ff00ff',\n 'gainsboro':'#dcdcdc',\n 'ghostwhite':'#f8f8ff',\n 'gold':'#ffd700',\n 'goldenrod':'#daa520',\n 'gray':'#808080',\n 'grey':'#808080',\n 'green':'#008000',\n 'greenyellow':'#adff2f',\n 'honeydew':'#f0fff0',\n 'hotpink':'#ff69b4',\n 'indianred':'#cd5c5c',\n 'indigo':'#4b0082',\n 'ivory':'#fffff0',\n 'khaki':'#f0e68c',\n 'lavender':'#e6e6fa',\n 'lavenderblush':'#fff0f5',\n 'lawngreen':'#7cfc00',\n 'lemonchiffon':'#fffacd',\n 'lightblue':'#add8e6',\n 'lightcoral':'#f08080',\n 'lightcyan':'#e0ffff',\n 'lightgoldenrodyellow':'#fafad2',\n 'lightgray':'#d3d3d3',\n 'lightgrey':'#d3d3d3',\n 'lightgreen':'#90ee90',\n 'lightpink':'#ffb6c1',\n 'lightsalmon':'#ffa07a',\n 'lightseagreen':'#20b2aa',\n 'lightskyblue':'#87cefa',\n 'lightslategray':'#778899',\n 'lightslategrey':'#778899',\n 'lightsteelblue':'#b0c4de',\n 'lightyellow':'#ffffe0',\n 'lime':'#00ff00',\n 'limegreen':'#32cd32',\n 'linen':'#faf0e6',\n 'magenta':'#ff00ff',\n 'maroon':'#800000',\n 'mediumaquamarine':'#66cdaa',\n 'mediumblue':'#0000cd',\n 'mediumorchid':'#ba55d3',\n 'mediumpurple':'#9370d8',\n 'mediumseagreen':'#3cb371',\n 'mediumslateblue':'#7b68ee',\n 'mediumspringgreen':'#00fa9a',\n 'mediumturquoise':'#48d1cc',\n 'mediumvioletred':'#c71585',\n 'midnightblue':'#191970',\n 'mintcream':'#f5fffa',\n 'mistyrose':'#ffe4e1',\n 'moccasin':'#ffe4b5',\n 'navajowhite':'#ffdead',\n 'navy':'#000080',\n 'oldlace':'#fdf5e6',\n 'olive':'#808000',\n 'olivedrab':'#6b8e23',\n 'orange':'#ffa500',\n 'orangered':'#ff4500',\n 'orchid':'#da70d6',\n 'palegoldenrod':'#eee8aa',\n 'palegreen':'#98fb98',\n 'paleturquoise':'#afeeee',\n 'palevioletred':'#d87093',\n 'papayawhip':'#ffefd5',\n 'peachpuff':'#ffdab9',\n 'peru':'#cd853f',\n 'pink':'#ffc0cb',\n 'plum':'#dda0dd',\n 'powderblue':'#b0e0e6',\n 'purple':'#800080',\n 'red':'#ff0000',\n 'rosybrown':'#bc8f8f',\n 'royalblue':'#4169e1',\n 'saddlebrown':'#8b4513',\n 'salmon':'#fa8072',\n 'sandybrown':'#f4a460',\n 'seagreen':'#2e8b57',\n 'seashell':'#fff5ee',\n 'sienna':'#a0522d',\n 'silver':'#c0c0c0',\n 'skyblue':'#87ceeb',\n 'slateblue':'#6a5acd',\n 'slategray':'#708090',\n 'slategrey':'#708090',\n 'snow':'#fffafa',\n 'springgreen':'#00ff7f',\n 'steelblue':'#4682b4',\n 'tan':'#d2b48c',\n 'teal':'#008080',\n 'thistle':'#d8bfd8',\n 'tomato':'#ff6347',\n 'turquoise':'#40e0d0',\n 'violet':'#ee82ee',\n 'wheat':'#f5deb3',\n 'white':'#ffffff',\n 'whitesmoke':'#f5f5f5',\n 'yellow':'#ffff00',\n 'yellowgreen':'#9acd32'\n };\n})(require('./tree'));\n\n(function (tree) {\n\ntree.debugInfo = function(env, ctx, lineSeperator) {\n var result=\"\";\n if (env.dumpLineNumbers && !env.compress) {\n switch(env.dumpLineNumbers) {\n case 'comments':\n result = tree.debugInfo.asComment(ctx);\n break;\n case 'mediaquery':\n result = tree.debugInfo.asMediaQuery(ctx);\n break;\n case 'all':\n result = tree.debugInfo.asComment(ctx) + (lineSeperator || \"\") + tree.debugInfo.asMediaQuery(ctx);\n break;\n }\n }\n return result;\n};\n\ntree.debugInfo.asComment = function(ctx) {\n return '/* line ' + ctx.debugInfo.lineNumber + ', ' + ctx.debugInfo.fileName + ' */\\n';\n};\n\ntree.debugInfo.asMediaQuery = function(ctx) {\n return '@media -sass-debug-info{filename{font-family:' +\n ('file://' + ctx.debugInfo.fileName).replace(/([.:\\/\\\\])/g, function (a) {\n if (a == '\\\\') {\n a = '\\/';\n }\n return '\\\\' + a;\n }) +\n '}line{font-family:\\\\00003' + ctx.debugInfo.lineNumber + '}}\\n';\n};\n\ntree.find = function (obj, fun) {\n for (var i = 0, r; i < obj.length; i++) {\n r = fun.call(obj, obj[i]);\n if (r) { return r; }\n }\n return null;\n};\n\ntree.jsify = function (obj) {\n if (Array.isArray(obj.value) && (obj.value.length > 1)) {\n return '[' + obj.value.map(function (v) { return v.toCSS(false); }).join(', ') + ']';\n } else {\n return obj.toCSS(false);\n }\n};\n\ntree.toCSS = function (env) {\n var strs = [];\n this.genCSS(env, {\n add: function(chunk, fileInfo, index) {\n strs.push(chunk);\n },\n isEmpty: function () {\n return strs.length === 0;\n }\n });\n return strs.join('');\n};\n\ntree.outputRuleset = function (env, output, rules) {\n var ruleCnt = rules.length, i;\n env.tabLevel = (env.tabLevel | 0) + 1;\n\n // Compressed\n if (env.compress) {\n output.add('{');\n for (i = 0; i < ruleCnt; i++) {\n rules[i].genCSS(env, output);\n }\n output.add('}');\n env.tabLevel--;\n return;\n }\n\n // Non-compressed\n var tabSetStr = '\\n' + Array(env.tabLevel).join(\" \"), tabRuleStr = tabSetStr + \" \";\n if (!ruleCnt) {\n output.add(\" {\" + tabSetStr + '}');\n } else {\n output.add(\" {\" + tabRuleStr);\n rules[0].genCSS(env, output);\n for (i = 1; i < ruleCnt; i++) {\n output.add(tabRuleStr);\n rules[i].genCSS(env, output);\n }\n output.add(tabSetStr + '}');\n }\n\n env.tabLevel--;\n};\n\n})(require('./tree'));\n\n(function (tree) {\n\ntree.Alpha = function (val) {\n this.value = val;\n};\ntree.Alpha.prototype = {\n type: \"Alpha\",\n accept: function (visitor) {\n this.value = visitor.visit(this.value);\n },\n eval: function (env) {\n if (this.value.eval) { return new tree.Alpha(this.value.eval(env)); }\n return this;\n },\n genCSS: function (env, output) {\n output.add(\"alpha(opacity=\");\n\n if (this.value.genCSS) {\n this.value.genCSS(env, output);\n } else {\n output.add(this.value);\n }\n\n output.add(\")\");\n },\n toCSS: tree.toCSS\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Anonymous = function (string, index, currentFileInfo, mapLines) {\n this.value = string.value || string;\n this.index = index;\n this.mapLines = mapLines;\n this.currentFileInfo = currentFileInfo;\n};\ntree.Anonymous.prototype = {\n type: \"Anonymous\",\n eval: function () { \n return new tree.Anonymous(this.value, this.index, this.currentFileInfo, this.mapLines);\n },\n compare: function (x) {\n if (!x.toCSS) {\n return -1;\n }\n \n var left = this.toCSS(),\n right = x.toCSS();\n \n if (left === right) {\n return 0;\n }\n \n return left < right ? -1 : 1;\n },\n genCSS: function (env, output) {\n output.add(this.value, this.currentFileInfo, this.index, this.mapLines);\n },\n toCSS: tree.toCSS\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Assignment = function (key, val) {\n this.key = key;\n this.value = val;\n};\ntree.Assignment.prototype = {\n type: \"Assignment\",\n accept: function (visitor) {\n this.value = visitor.visit(this.value);\n },\n eval: function (env) {\n if (this.value.eval) {\n return new(tree.Assignment)(this.key, this.value.eval(env));\n }\n return this;\n },\n genCSS: function (env, output) {\n output.add(this.key + '=');\n if (this.value.genCSS) {\n this.value.genCSS(env, output);\n } else {\n output.add(this.value);\n }\n },\n toCSS: tree.toCSS\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\n//\n// A function call node.\n//\ntree.Call = function (name, args, index, currentFileInfo) {\n this.name = name;\n this.args = args;\n this.index = index;\n this.currentFileInfo = currentFileInfo;\n};\ntree.Call.prototype = {\n type: \"Call\",\n accept: function (visitor) {\n if (this.args) {\n this.args = visitor.visitArray(this.args);\n }\n },\n //\n // When evaluating a function call,\n // we either find the function in `tree.functions` [1],\n // in which case we call it, passing the evaluated arguments,\n // if this returns null or we cannot find the function, we \n // simply print it out as it appeared originally [2].\n //\n // The *functions.js* file contains the built-in functions.\n //\n // The reason why we evaluate the arguments, is in the case where\n // we try to pass a variable to a function, like: `saturate(@color)`.\n // The function should receive the value, not the variable.\n //\n eval: function (env) {\n var args = this.args.map(function (a) { return a.eval(env); }),\n nameLC = this.name.toLowerCase(),\n result, func;\n\n if (nameLC in tree.functions) { // 1.\n try {\n func = new tree.functionCall(env, this.currentFileInfo);\n result = func[nameLC].apply(func, args);\n if (result != null) {\n return result;\n }\n } catch (e) {\n throw { type: e.type || \"Runtime\",\n message: \"error evaluating function `\" + this.name + \"`\" +\n (e.message ? ': ' + e.message : ''),\n index: this.index, filename: this.currentFileInfo.filename };\n }\n }\n\n return new tree.Call(this.name, args, this.index, this.currentFileInfo);\n },\n\n genCSS: function (env, output) {\n output.add(this.name + \"(\", this.currentFileInfo, this.index);\n\n for(var i = 0; i < this.args.length; i++) {\n this.args[i].genCSS(env, output);\n if (i + 1 < this.args.length) {\n output.add(\", \");\n }\n }\n\n output.add(\")\");\n },\n\n toCSS: tree.toCSS\n};\n\n})(require('../tree'));\n\n(function (tree) {\n//\n// RGB Colors - #ff0014, #eee\n//\ntree.Color = function (rgb, a) {\n //\n // The end goal here, is to parse the arguments\n // into an integer triplet, such as `128, 255, 0`\n //\n // This facilitates operations and conversions.\n //\n if (Array.isArray(rgb)) {\n this.rgb = rgb;\n } else if (rgb.length == 6) {\n this.rgb = rgb.match(/.{2}/g).map(function (c) {\n return parseInt(c, 16);\n });\n } else {\n this.rgb = rgb.split('').map(function (c) {\n return parseInt(c + c, 16);\n });\n }\n this.alpha = typeof(a) === 'number' ? a : 1;\n};\n\nvar transparentKeyword = \"transparent\";\n\ntree.Color.prototype = {\n type: \"Color\",\n eval: function () { return this; },\n luma: function () {\n var r = this.rgb[0] / 255,\n g = this.rgb[1] / 255,\n b = this.rgb[2] / 255;\n\n r = (r <= 0.03928) ? r / 12.92 : Math.pow(((r + 0.055) / 1.055), 2.4);\n g = (g <= 0.03928) ? g / 12.92 : Math.pow(((g + 0.055) / 1.055), 2.4);\n b = (b <= 0.03928) ? b / 12.92 : Math.pow(((b + 0.055) / 1.055), 2.4);\n\n return 0.2126 * r + 0.7152 * g + 0.0722 * b;\n },\n\n genCSS: function (env, output) {\n output.add(this.toCSS(env));\n },\n toCSS: function (env, doNotCompress) {\n var compress = env && env.compress && !doNotCompress,\n alpha = tree.fround(env, this.alpha);\n\n // If we have some transparency, the only way to represent it\n // is via `rgba`. Otherwise, we use the hex representation,\n // which has better compatibility with older browsers.\n // Values are capped between `0` and `255`, rounded and zero-padded.\n if (alpha < 1) {\n if (alpha === 0 && this.isTransparentKeyword) {\n return transparentKeyword;\n }\n return \"rgba(\" + this.rgb.map(function (c) {\n return clamp(Math.round(c), 255);\n }).concat(clamp(alpha, 1))\n .join(',' + (compress ? '' : ' ')) + \")\";\n } else {\n var color = this.toRGB();\n\n if (compress) {\n var splitcolor = color.split('');\n\n // Convert color to short format\n if (splitcolor[1] === splitcolor[2] && splitcolor[3] === splitcolor[4] && splitcolor[5] === splitcolor[6]) {\n color = '#' + splitcolor[1] + splitcolor[3] + splitcolor[5];\n }\n }\n\n return color;\n }\n },\n\n //\n // Operations have to be done per-channel, if not,\n // channels will spill onto each other. Once we have\n // our result, in the form of an integer triplet,\n // we create a new Color node to hold the result.\n //\n operate: function (env, op, other) {\n var rgb = [];\n var alpha = this.alpha * (1 - other.alpha) + other.alpha;\n for (var c = 0; c < 3; c++) {\n rgb[c] = tree.operate(env, op, this.rgb[c], other.rgb[c]);\n }\n return new(tree.Color)(rgb, alpha);\n },\n\n toRGB: function () {\n return toHex(this.rgb);\n },\n\n toHSL: function () {\n var r = this.rgb[0] / 255,\n g = this.rgb[1] / 255,\n b = this.rgb[2] / 255,\n a = this.alpha;\n\n var max = Math.max(r, g, b), min = Math.min(r, g, b);\n var h, s, l = (max + min) / 2, d = max - min;\n\n if (max === min) {\n h = s = 0;\n } else {\n s = l > 0.5 ? d / (2 - max - min) : d / (max + min);\n\n switch (max) {\n case r: h = (g - b) / d + (g < b ? 6 : 0); break;\n case g: h = (b - r) / d + 2; break;\n case b: h = (r - g) / d + 4; break;\n }\n h /= 6;\n }\n return { h: h * 360, s: s, l: l, a: a };\n },\n //Adapted from http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript\n toHSV: function () {\n var r = this.rgb[0] / 255,\n g = this.rgb[1] / 255,\n b = this.rgb[2] / 255,\n a = this.alpha;\n\n var max = Math.max(r, g, b), min = Math.min(r, g, b);\n var h, s, v = max;\n\n var d = max - min;\n if (max === 0) {\n s = 0;\n } else {\n s = d / max;\n }\n\n if (max === min) {\n h = 0;\n } else {\n switch(max){\n case r: h = (g - b) / d + (g < b ? 6 : 0); break;\n case g: h = (b - r) / d + 2; break;\n case b: h = (r - g) / d + 4; break;\n }\n h /= 6;\n }\n return { h: h * 360, s: s, v: v, a: a };\n },\n toARGB: function () {\n return toHex([this.alpha * 255].concat(this.rgb));\n },\n compare: function (x) {\n if (!x.rgb) {\n return -1;\n }\n \n return (x.rgb[0] === this.rgb[0] &&\n x.rgb[1] === this.rgb[1] &&\n x.rgb[2] === this.rgb[2] &&\n x.alpha === this.alpha) ? 0 : -1;\n }\n};\n\ntree.Color.fromKeyword = function(keyword) {\n keyword = keyword.toLowerCase();\n\n if (tree.colors.hasOwnProperty(keyword)) {\n // detect named color\n return new(tree.Color)(tree.colors[keyword].slice(1));\n }\n if (keyword === transparentKeyword) {\n var transparent = new(tree.Color)([0, 0, 0], 0);\n transparent.isTransparentKeyword = true;\n return transparent;\n }\n};\n\nfunction toHex(v) {\n return '#' + v.map(function (c) {\n c = clamp(Math.round(c), 255);\n return (c < 16 ? '0' : '') + c.toString(16);\n }).join('');\n}\n\nfunction clamp(v, max) {\n return Math.min(Math.max(v, 0), max); \n}\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Comment = function (value, silent, index, currentFileInfo) {\n this.value = value;\n this.silent = !!silent;\n this.currentFileInfo = currentFileInfo;\n};\ntree.Comment.prototype = {\n type: \"Comment\",\n genCSS: function (env, output) {\n if (this.debugInfo) {\n output.add(tree.debugInfo(env, this), this.currentFileInfo, this.index);\n }\n output.add(this.value.trim()); //TODO shouldn't need to trim, we shouldn't grab the \\n\n },\n toCSS: tree.toCSS,\n isSilent: function(env) {\n var isReference = (this.currentFileInfo && this.currentFileInfo.reference && !this.isReferenced),\n isCompressed = env.compress && !this.value.match(/^\\/\\*!/);\n return this.silent || isReference || isCompressed;\n },\n eval: function () { return this; },\n markReferenced: function () {\n this.isReferenced = true;\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Condition = function (op, l, r, i, negate) {\n this.op = op.trim();\n this.lvalue = l;\n this.rvalue = r;\n this.index = i;\n this.negate = negate;\n};\ntree.Condition.prototype = {\n type: \"Condition\",\n accept: function (visitor) {\n this.lvalue = visitor.visit(this.lvalue);\n this.rvalue = visitor.visit(this.rvalue);\n },\n eval: function (env) {\n var a = this.lvalue.eval(env),\n b = this.rvalue.eval(env);\n\n var i = this.index, result;\n\n result = (function (op) {\n switch (op) {\n case 'and':\n return a && b;\n case 'or':\n return a || b;\n default:\n if (a.compare) {\n result = a.compare(b);\n } else if (b.compare) {\n result = b.compare(a);\n } else {\n throw { type: \"Type\",\n message: \"Unable to perform comparison\",\n index: i };\n }\n switch (result) {\n case -1: return op === '<' || op === '=<' || op === '<=';\n case 0: return op === '=' || op === '>=' || op === '=<' || op === '<=';\n case 1: return op === '>' || op === '>=';\n }\n }\n })(this.op);\n return this.negate ? !result : result;\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.DetachedRuleset = function (ruleset, frames) {\n this.ruleset = ruleset;\n this.frames = frames;\n};\ntree.DetachedRuleset.prototype = {\n type: \"DetachedRuleset\",\n accept: function (visitor) {\n this.ruleset = visitor.visit(this.ruleset);\n },\n eval: function (env) {\n var frames = this.frames || env.frames.slice(0);\n return new tree.DetachedRuleset(this.ruleset, frames);\n },\n callEval: function (env) {\n return this.ruleset.eval(this.frames ? new(tree.evalEnv)(env, this.frames.concat(env.frames)) : env);\n }\n};\n})(require('../tree'));\n\n(function (tree) {\n\n//\n// A number with a unit\n//\ntree.Dimension = function (value, unit) {\n this.value = parseFloat(value);\n this.unit = (unit && unit instanceof tree.Unit) ? unit :\n new(tree.Unit)(unit ? [unit] : undefined);\n};\n\ntree.Dimension.prototype = {\n type: \"Dimension\",\n accept: function (visitor) {\n this.unit = visitor.visit(this.unit);\n },\n eval: function (env) {\n return this;\n },\n toColor: function () {\n return new(tree.Color)([this.value, this.value, this.value]);\n },\n genCSS: function (env, output) {\n if ((env && env.strictUnits) && !this.unit.isSingular()) {\n throw new Error(\"Multiple units in dimension. Correct the units or use the unit function. Bad unit: \"+this.unit.toString());\n }\n\n var value = tree.fround(env, this.value),\n strValue = String(value);\n\n if (value !== 0 && value < 0.000001 && value > -0.000001) {\n // would be output 1e-6 etc.\n strValue = value.toFixed(20).replace(/0+$/, \"\");\n }\n\n if (env && env.compress) {\n // Zero values doesn't need a unit\n if (value === 0 && this.unit.isLength()) {\n output.add(strValue);\n return;\n }\n\n // Float values doesn't need a leading zero\n if (value > 0 && value < 1) {\n strValue = (strValue).substr(1);\n }\n }\n\n output.add(strValue);\n this.unit.genCSS(env, output);\n },\n toCSS: tree.toCSS,\n\n // In an operation between two Dimensions,\n // we default to the first Dimension's unit,\n // so `1px + 2` will yield `3px`.\n operate: function (env, op, other) {\n /*jshint noempty:false */\n var value = tree.operate(env, op, this.value, other.value),\n unit = this.unit.clone();\n\n if (op === '+' || op === '-') {\n if (unit.numerator.length === 0 && unit.denominator.length === 0) {\n unit.numerator = other.unit.numerator.slice(0);\n unit.denominator = other.unit.denominator.slice(0);\n } else if (other.unit.numerator.length === 0 && unit.denominator.length === 0) {\n // do nothing\n } else {\n other = other.convertTo(this.unit.usedUnits());\n\n if(env.strictUnits && other.unit.toString() !== unit.toString()) {\n throw new Error(\"Incompatible units. Change the units or use the unit function. Bad units: '\" + unit.toString() +\n \"' and '\" + other.unit.toString() + \"'.\");\n }\n\n value = tree.operate(env, op, this.value, other.value);\n }\n } else if (op === '*') {\n unit.numerator = unit.numerator.concat(other.unit.numerator).sort();\n unit.denominator = unit.denominator.concat(other.unit.denominator).sort();\n unit.cancel();\n } else if (op === '/') {\n unit.numerator = unit.numerator.concat(other.unit.denominator).sort();\n unit.denominator = unit.denominator.concat(other.unit.numerator).sort();\n unit.cancel();\n }\n return new(tree.Dimension)(value, unit);\n },\n\n compare: function (other) {\n if (other instanceof tree.Dimension) {\n var a, b,\n aValue, bValue;\n \n if (this.unit.isEmpty() || other.unit.isEmpty()) {\n a = this;\n b = other;\n } else {\n a = this.unify();\n b = other.unify();\n if (a.unit.compare(b.unit) !== 0) {\n return -1;\n } \n }\n aValue = a.value;\n bValue = b.value;\n\n if (bValue > aValue) {\n return -1;\n } else if (bValue < aValue) {\n return 1;\n } else {\n return 0;\n }\n } else {\n return -1;\n }\n },\n\n unify: function () {\n return this.convertTo({ length: 'px', duration: 's', angle: 'rad' });\n },\n\n convertTo: function (conversions) {\n var value = this.value, unit = this.unit.clone(),\n i, groupName, group, targetUnit, derivedConversions = {}, applyUnit;\n\n if (typeof conversions === 'string') {\n for(i in tree.UnitConversions) {\n if (tree.UnitConversions[i].hasOwnProperty(conversions)) {\n derivedConversions = {};\n derivedConversions[i] = conversions;\n }\n }\n conversions = derivedConversions;\n }\n applyUnit = function (atomicUnit, denominator) {\n /*jshint loopfunc:true */\n if (group.hasOwnProperty(atomicUnit)) {\n if (denominator) {\n value = value / (group[atomicUnit] / group[targetUnit]);\n } else {\n value = value * (group[atomicUnit] / group[targetUnit]);\n }\n\n return targetUnit;\n }\n\n return atomicUnit;\n };\n\n for (groupName in conversions) {\n if (conversions.hasOwnProperty(groupName)) {\n targetUnit = conversions[groupName];\n group = tree.UnitConversions[groupName];\n\n unit.map(applyUnit);\n }\n }\n\n unit.cancel();\n\n return new(tree.Dimension)(value, unit);\n }\n};\n\n// http://www.w3.org/TR/css3-values/#absolute-lengths\ntree.UnitConversions = {\n length: {\n 'm': 1,\n 'cm': 0.01,\n 'mm': 0.001,\n 'in': 0.0254,\n 'px': 0.0254 / 96,\n 'pt': 0.0254 / 72,\n 'pc': 0.0254 / 72 * 12\n },\n duration: {\n 's': 1,\n 'ms': 0.001\n },\n angle: {\n 'rad': 1/(2*Math.PI),\n 'deg': 1/360,\n 'grad': 1/400,\n 'turn': 1\n }\n};\n\ntree.Unit = function (numerator, denominator, backupUnit) {\n this.numerator = numerator ? numerator.slice(0).sort() : [];\n this.denominator = denominator ? denominator.slice(0).sort() : [];\n this.backupUnit = backupUnit;\n};\n\ntree.Unit.prototype = {\n type: \"Unit\",\n clone: function () {\n return new tree.Unit(this.numerator.slice(0), this.denominator.slice(0), this.backupUnit);\n },\n genCSS: function (env, output) {\n if (this.numerator.length >= 1) {\n output.add(this.numerator[0]);\n } else\n if (this.denominator.length >= 1) {\n output.add(this.denominator[0]);\n } else\n if ((!env || !env.strictUnits) && this.backupUnit) {\n output.add(this.backupUnit);\n }\n },\n toCSS: tree.toCSS,\n\n toString: function () {\n var i, returnStr = this.numerator.join(\"*\");\n for (i = 0; i < this.denominator.length; i++) {\n returnStr += \"/\" + this.denominator[i];\n }\n return returnStr;\n },\n\n compare: function (other) {\n return this.is(other.toString()) ? 0 : -1;\n },\n\n is: function (unitString) {\n return this.toString() === unitString;\n },\n\n isLength: function () {\n return Boolean(this.toCSS().match(/px|em|%|in|cm|mm|pc|pt|ex/));\n },\n\n isEmpty: function () {\n return this.numerator.length === 0 && this.denominator.length === 0;\n },\n\n isSingular: function() {\n return this.numerator.length <= 1 && this.denominator.length === 0;\n },\n\n map: function(callback) {\n var i;\n\n for (i = 0; i < this.numerator.length; i++) {\n this.numerator[i] = callback(this.numerator[i], false);\n }\n\n for (i = 0; i < this.denominator.length; i++) {\n this.denominator[i] = callback(this.denominator[i], true);\n }\n },\n\n usedUnits: function() {\n var group, result = {}, mapUnit;\n\n mapUnit = function (atomicUnit) {\n /*jshint loopfunc:true */\n if (group.hasOwnProperty(atomicUnit) && !result[groupName]) {\n result[groupName] = atomicUnit;\n }\n\n return atomicUnit;\n };\n\n for (var groupName in tree.UnitConversions) {\n if (tree.UnitConversions.hasOwnProperty(groupName)) {\n group = tree.UnitConversions[groupName];\n\n this.map(mapUnit);\n }\n }\n\n return result;\n },\n\n cancel: function () {\n var counter = {}, atomicUnit, i, backup;\n\n for (i = 0; i < this.numerator.length; i++) {\n atomicUnit = this.numerator[i];\n if (!backup) {\n backup = atomicUnit;\n }\n counter[atomicUnit] = (counter[atomicUnit] || 0) + 1;\n }\n\n for (i = 0; i < this.denominator.length; i++) {\n atomicUnit = this.denominator[i];\n if (!backup) {\n backup = atomicUnit;\n }\n counter[atomicUnit] = (counter[atomicUnit] || 0) - 1;\n }\n\n this.numerator = [];\n this.denominator = [];\n\n for (atomicUnit in counter) {\n if (counter.hasOwnProperty(atomicUnit)) {\n var count = counter[atomicUnit];\n\n if (count > 0) {\n for (i = 0; i < count; i++) {\n this.numerator.push(atomicUnit);\n }\n } else if (count < 0) {\n for (i = 0; i < -count; i++) {\n this.denominator.push(atomicUnit);\n }\n }\n }\n }\n\n if (this.numerator.length === 0 && this.denominator.length === 0 && backup) {\n this.backupUnit = backup;\n }\n\n this.numerator.sort();\n this.denominator.sort();\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Directive = function (name, value, rules, index, currentFileInfo, debugInfo) {\n this.name = name;\n this.value = value;\n if (rules) {\n this.rules = rules;\n this.rules.allowImports = true;\n }\n this.index = index;\n this.currentFileInfo = currentFileInfo;\n this.debugInfo = debugInfo;\n};\n\ntree.Directive.prototype = {\n type: \"Directive\",\n accept: function (visitor) {\n var value = this.value, rules = this.rules;\n if (rules) {\n rules = visitor.visit(rules);\n }\n if (value) {\n value = visitor.visit(value);\n }\n },\n genCSS: function (env, output) {\n var value = this.value, rules = this.rules;\n output.add(this.name, this.currentFileInfo, this.index);\n if (value) {\n output.add(' ');\n value.genCSS(env, output);\n }\n if (rules) {\n tree.outputRuleset(env, output, [rules]);\n } else {\n output.add(';');\n }\n },\n toCSS: tree.toCSS,\n eval: function (env) {\n var value = this.value, rules = this.rules;\n if (value) {\n value = value.eval(env);\n }\n if (rules) {\n rules = rules.eval(env);\n rules.root = true;\n }\n return new(tree.Directive)(this.name, value, rules,\n this.index, this.currentFileInfo, this.debugInfo);\n },\n variable: function (name) { if (this.rules) return tree.Ruleset.prototype.variable.call(this.rules, name); },\n find: function () { if (this.rules) return tree.Ruleset.prototype.find.apply(this.rules, arguments); },\n rulesets: function () { if (this.rules) return tree.Ruleset.prototype.rulesets.apply(this.rules); },\n markReferenced: function () {\n var i, rules;\n this.isReferenced = true;\n if (this.rules) {\n rules = this.rules.rules;\n for (i = 0; i < rules.length; i++) {\n if (rules[i].markReferenced) {\n rules[i].markReferenced();\n }\n }\n }\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Element = function (combinator, value, index, currentFileInfo) {\n this.combinator = combinator instanceof tree.Combinator ?\n combinator : new(tree.Combinator)(combinator);\n\n if (typeof(value) === 'string') {\n this.value = value.trim();\n } else if (value) {\n this.value = value;\n } else {\n this.value = \"\";\n }\n this.index = index;\n this.currentFileInfo = currentFileInfo;\n};\ntree.Element.prototype = {\n type: \"Element\",\n accept: function (visitor) {\n var value = this.value;\n this.combinator = visitor.visit(this.combinator);\n if (typeof value === \"object\") {\n this.value = visitor.visit(value);\n }\n },\n eval: function (env) {\n return new(tree.Element)(this.combinator,\n this.value.eval ? this.value.eval(env) : this.value,\n this.index,\n this.currentFileInfo);\n },\n genCSS: function (env, output) {\n output.add(this.toCSS(env), this.currentFileInfo, this.index);\n },\n toCSS: function (env) {\n var value = (this.value.toCSS ? this.value.toCSS(env) : this.value);\n if (value === '' && this.combinator.value.charAt(0) === '&') {\n return '';\n } else {\n return this.combinator.toCSS(env || {}) + value;\n }\n }\n};\n\ntree.Attribute = function (key, op, value) {\n this.key = key;\n this.op = op;\n this.value = value;\n};\ntree.Attribute.prototype = {\n type: \"Attribute\",\n eval: function (env) {\n return new(tree.Attribute)(this.key.eval ? this.key.eval(env) : this.key,\n this.op, (this.value && this.value.eval) ? this.value.eval(env) : this.value);\n },\n genCSS: function (env, output) {\n output.add(this.toCSS(env));\n },\n toCSS: function (env) {\n var value = this.key.toCSS ? this.key.toCSS(env) : this.key;\n\n if (this.op) {\n value += this.op;\n value += (this.value.toCSS ? this.value.toCSS(env) : this.value);\n }\n\n return '[' + value + ']';\n }\n};\n\ntree.Combinator = function (value) {\n if (value === ' ') {\n this.value = ' ';\n } else {\n this.value = value ? value.trim() : \"\";\n }\n};\ntree.Combinator.prototype = {\n type: \"Combinator\",\n _outputMap: {\n '' : '',\n ' ' : ' ',\n ':' : ' :',\n '+' : ' + ',\n '~' : ' ~ ',\n '>' : ' > ',\n '|' : '|',\n '^' : ' ^ ',\n '^^' : ' ^^ '\n },\n _outputMapCompressed: {\n '' : '',\n ' ' : ' ',\n ':' : ' :',\n '+' : '+',\n '~' : '~',\n '>' : '>',\n '|' : '|',\n '^' : '^',\n '^^' : '^^'\n },\n genCSS: function (env, output) {\n output.add((env.compress ? this._outputMapCompressed : this._outputMap)[this.value]);\n },\n toCSS: tree.toCSS\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Expression = function (value) { this.value = value; };\ntree.Expression.prototype = {\n type: \"Expression\",\n accept: function (visitor) {\n if (this.value) {\n this.value = visitor.visitArray(this.value);\n }\n },\n eval: function (env) {\n var returnValue,\n inParenthesis = this.parens && !this.parensInOp,\n doubleParen = false;\n if (inParenthesis) {\n env.inParenthesis();\n }\n if (this.value.length > 1) {\n returnValue = new(tree.Expression)(this.value.map(function (e) {\n return e.eval(env);\n }));\n } else if (this.value.length === 1) {\n if (this.value[0].parens && !this.value[0].parensInOp) {\n doubleParen = true;\n }\n returnValue = this.value[0].eval(env);\n } else {\n returnValue = this;\n }\n if (inParenthesis) {\n env.outOfParenthesis();\n }\n if (this.parens && this.parensInOp && !(env.isMathOn()) && !doubleParen) {\n returnValue = new(tree.Paren)(returnValue);\n }\n return returnValue;\n },\n genCSS: function (env, output) {\n for(var i = 0; i < this.value.length; i++) {\n this.value[i].genCSS(env, output);\n if (i + 1 < this.value.length) {\n output.add(\" \");\n }\n }\n },\n toCSS: tree.toCSS,\n throwAwayComments: function () {\n this.value = this.value.filter(function(v) {\n return !(v instanceof tree.Comment);\n });\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Extend = function Extend(selector, option, index) {\n this.selector = selector;\n this.option = option;\n this.index = index;\n this.object_id = tree.Extend.next_id++;\n this.parent_ids = [this.object_id];\n\n switch(option) {\n case \"all\":\n this.allowBefore = true;\n this.allowAfter = true;\n break;\n default:\n this.allowBefore = false;\n this.allowAfter = false;\n break;\n }\n};\ntree.Extend.next_id = 0;\n\ntree.Extend.prototype = {\n type: \"Extend\",\n accept: function (visitor) {\n this.selector = visitor.visit(this.selector);\n },\n eval: function (env) {\n return new(tree.Extend)(this.selector.eval(env), this.option, this.index);\n },\n clone: function (env) {\n return new(tree.Extend)(this.selector, this.option, this.index);\n },\n findSelfSelectors: function (selectors) {\n var selfElements = [],\n i,\n selectorElements;\n\n for(i = 0; i < selectors.length; i++) {\n selectorElements = selectors[i].elements;\n // duplicate the logic in genCSS function inside the selector node.\n // future TODO - move both logics into the selector joiner visitor\n if (i > 0 && selectorElements.length && selectorElements[0].combinator.value === \"\") {\n selectorElements[0].combinator.value = ' ';\n }\n selfElements = selfElements.concat(selectors[i].elements);\n }\n\n this.selfSelectors = [{ elements: selfElements }];\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n//\n// CSS @import node\n//\n// The general strategy here is that we don't want to wait\n// for the parsing to be completed, before we start importing\n// the file. That's because in the context of a browser,\n// most of the time will be spent waiting for the server to respond.\n//\n// On creation, we push the import path to our import queue, though\n// `import,push`, we also pass it a callback, which it'll call once\n// the file has been fetched, and parsed.\n//\ntree.Import = function (path, features, options, index, currentFileInfo) {\n this.options = options;\n this.index = index;\n this.path = path;\n this.features = features;\n this.currentFileInfo = currentFileInfo;\n\n if (this.options.less !== undefined || this.options.inline) {\n this.css = !this.options.less || this.options.inline;\n } else {\n var pathValue = this.getPath();\n if (pathValue && /css([\\?;].*)?$/.test(pathValue)) {\n this.css = true;\n }\n }\n};\n\n//\n// The actual import node doesn't return anything, when converted to CSS.\n// The reason is that it's used at the evaluation stage, so that the rules\n// it imports can be treated like any other rules.\n//\n// In `eval`, we make sure all Import nodes get evaluated, recursively, so\n// we end up with a flat structure, which can easily be imported in the parent\n// ruleset.\n//\ntree.Import.prototype = {\n type: \"Import\",\n accept: function (visitor) {\n if (this.features) {\n this.features = visitor.visit(this.features);\n }\n this.path = visitor.visit(this.path);\n if (!this.options.inline && this.root) {\n this.root = visitor.visit(this.root);\n }\n },\n genCSS: function (env, output) {\n if (this.css) {\n output.add(\"@import \", this.currentFileInfo, this.index);\n this.path.genCSS(env, output);\n if (this.features) {\n output.add(\" \");\n this.features.genCSS(env, output);\n }\n output.add(';');\n }\n },\n toCSS: tree.toCSS,\n getPath: function () {\n if (this.path instanceof tree.Quoted) {\n var path = this.path.value;\n return (this.css !== undefined || /(\\.[a-z]*$)|([\\?;].*)$/.test(path)) ? path : path + '.less';\n } else if (this.path instanceof tree.URL) {\n return this.path.value.value;\n }\n return null;\n },\n evalForImport: function (env) {\n return new(tree.Import)(this.path.eval(env), this.features, this.options, this.index, this.currentFileInfo);\n },\n evalPath: function (env) {\n var path = this.path.eval(env);\n var rootpath = this.currentFileInfo && this.currentFileInfo.rootpath;\n\n if (!(path instanceof tree.URL)) {\n if (rootpath) {\n var pathValue = path.value;\n // Add the base path if the import is relative\n if (pathValue && env.isPathRelative(pathValue)) {\n path.value = rootpath +pathValue;\n }\n }\n path.value = env.normalizePath(path.value);\n }\n\n return path;\n },\n eval: function (env) {\n var ruleset, features = this.features && this.features.eval(env);\n\n if (this.skip) {\n if (typeof this.skip === \"function\") {\n this.skip = this.skip();\n }\n if (this.skip) {\n return []; \n }\n }\n \n if (this.options.inline) {\n //todo needs to reference css file not import\n var contents = new(tree.Anonymous)(this.root, 0, {filename: this.importedFilename}, true);\n return this.features ? new(tree.Media)([contents], this.features.value) : [contents];\n } else if (this.css) {\n var newImport = new(tree.Import)(this.evalPath(env), features, this.options, this.index);\n if (!newImport.css && this.error) {\n throw this.error;\n }\n return newImport;\n } else {\n ruleset = new(tree.Ruleset)(null, this.root.rules.slice(0));\n\n ruleset.evalImports(env);\n\n return this.features ? new(tree.Media)(ruleset.rules, this.features.value) : ruleset.rules;\n }\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.JavaScript = function (string, index, escaped) {\n this.escaped = escaped;\n this.expression = string;\n this.index = index;\n};\ntree.JavaScript.prototype = {\n type: \"JavaScript\",\n eval: function (env) {\n var result,\n that = this,\n context = {};\n\n var expression = this.expression.replace(/@\\{([\\w-]+)\\}/g, function (_, name) {\n return tree.jsify(new(tree.Variable)('@' + name, that.index).eval(env));\n });\n\n try {\n expression = new(Function)('return (' + expression + ')');\n } catch (e) {\n throw { message: \"JavaScript evaluation error: \" + e.message + \" from `\" + expression + \"`\" ,\n index: this.index };\n }\n\n var variables = env.frames[0].variables();\n for (var k in variables) {\n if (variables.hasOwnProperty(k)) {\n /*jshint loopfunc:true */\n context[k.slice(1)] = {\n value: variables[k].value,\n toJS: function () {\n return this.value.eval(env).toCSS();\n }\n };\n }\n }\n\n try {\n result = expression.call(context);\n } catch (e) {\n throw { message: \"JavaScript evaluation error: '\" + e.name + ': ' + e.message.replace(/[\"]/g, \"'\") + \"'\" ,\n index: this.index };\n }\n if (typeof(result) === 'number') {\n return new(tree.Dimension)(result);\n } else if (typeof(result) === 'string') {\n return new(tree.Quoted)('\"' + result + '\"', result, this.escaped, this.index);\n } else if (Array.isArray(result)) {\n return new(tree.Anonymous)(result.join(', '));\n } else {\n return new(tree.Anonymous)(result);\n }\n }\n};\n\n})(require('../tree'));\n\n\n(function (tree) {\n\ntree.Keyword = function (value) { this.value = value; };\ntree.Keyword.prototype = {\n type: \"Keyword\",\n eval: function () { return this; },\n genCSS: function (env, output) {\n if (this.value === '%') { throw { type: \"Syntax\", message: \"Invalid % without number\" }; }\n output.add(this.value);\n },\n toCSS: tree.toCSS,\n compare: function (other) {\n if (other instanceof tree.Keyword) {\n return other.value === this.value ? 0 : 1;\n } else {\n return -1;\n }\n }\n};\n\ntree.True = new(tree.Keyword)('true');\ntree.False = new(tree.Keyword)('false');\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Media = function (value, features, index, currentFileInfo) {\n this.index = index;\n this.currentFileInfo = currentFileInfo;\n\n var selectors = this.emptySelectors();\n\n this.features = new(tree.Value)(features);\n this.rules = [new(tree.Ruleset)(selectors, value)];\n this.rules[0].allowImports = true;\n};\ntree.Media.prototype = {\n type: \"Media\",\n accept: function (visitor) {\n if (this.features) {\n this.features = visitor.visit(this.features);\n }\n if (this.rules) {\n this.rules = visitor.visitArray(this.rules);\n }\n },\n genCSS: function (env, output) {\n output.add('@media ', this.currentFileInfo, this.index);\n this.features.genCSS(env, output);\n tree.outputRuleset(env, output, this.rules);\n },\n toCSS: tree.toCSS,\n eval: function (env) {\n if (!env.mediaBlocks) {\n env.mediaBlocks = [];\n env.mediaPath = [];\n }\n \n var media = new(tree.Media)(null, [], this.index, this.currentFileInfo);\n if(this.debugInfo) {\n this.rules[0].debugInfo = this.debugInfo;\n media.debugInfo = this.debugInfo;\n }\n var strictMathBypass = false;\n if (!env.strictMath) {\n strictMathBypass = true;\n env.strictMath = true;\n }\n try {\n media.features = this.features.eval(env);\n }\n finally {\n if (strictMathBypass) {\n env.strictMath = false;\n }\n }\n \n env.mediaPath.push(media);\n env.mediaBlocks.push(media);\n \n env.frames.unshift(this.rules[0]);\n media.rules = [this.rules[0].eval(env)];\n env.frames.shift();\n \n env.mediaPath.pop();\n\n return env.mediaPath.length === 0 ? media.evalTop(env) :\n media.evalNested(env);\n },\n variable: function (name) { return tree.Ruleset.prototype.variable.call(this.rules[0], name); },\n find: function () { return tree.Ruleset.prototype.find.apply(this.rules[0], arguments); },\n rulesets: function () { return tree.Ruleset.prototype.rulesets.apply(this.rules[0]); },\n emptySelectors: function() { \n var el = new(tree.Element)('', '&', this.index, this.currentFileInfo),\n sels = [new(tree.Selector)([el], null, null, this.index, this.currentFileInfo)];\n sels[0].mediaEmpty = true;\n return sels;\n },\n markReferenced: function () {\n var i, rules = this.rules[0].rules;\n this.rules[0].markReferenced();\n this.isReferenced = true;\n for (i = 0; i < rules.length; i++) {\n if (rules[i].markReferenced) {\n rules[i].markReferenced();\n }\n }\n },\n\n evalTop: function (env) {\n var result = this;\n\n // Render all dependent Media blocks.\n if (env.mediaBlocks.length > 1) {\n var selectors = this.emptySelectors();\n result = new(tree.Ruleset)(selectors, env.mediaBlocks);\n result.multiMedia = true;\n }\n\n delete env.mediaBlocks;\n delete env.mediaPath;\n\n return result;\n },\n evalNested: function (env) {\n var i, value,\n path = env.mediaPath.concat([this]);\n\n // Extract the media-query conditions separated with `,` (OR).\n for (i = 0; i < path.length; i++) {\n value = path[i].features instanceof tree.Value ?\n path[i].features.value : path[i].features;\n path[i] = Array.isArray(value) ? value : [value];\n }\n\n // Trace all permutations to generate the resulting media-query.\n //\n // (a, b and c) with nested (d, e) ->\n // a and d\n // a and e\n // b and c and d\n // b and c and e\n this.features = new(tree.Value)(this.permute(path).map(function (path) {\n path = path.map(function (fragment) {\n return fragment.toCSS ? fragment : new(tree.Anonymous)(fragment);\n });\n\n for(i = path.length - 1; i > 0; i--) {\n path.splice(i, 0, new(tree.Anonymous)(\"and\"));\n }\n\n return new(tree.Expression)(path);\n }));\n\n // Fake a tree-node that doesn't output anything.\n return new(tree.Ruleset)([], []);\n },\n permute: function (arr) {\n if (arr.length === 0) {\n return [];\n } else if (arr.length === 1) {\n return arr[0];\n } else {\n var result = [];\n var rest = this.permute(arr.slice(1));\n for (var i = 0; i < rest.length; i++) {\n for (var j = 0; j < arr[0].length; j++) {\n result.push([arr[0][j]].concat(rest[i]));\n }\n }\n return result;\n }\n },\n bubbleSelectors: function (selectors) {\n if (!selectors)\n return;\n this.rules = [new(tree.Ruleset)(selectors.slice(0), [this.rules[0]])];\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.mixin = {};\ntree.mixin.Call = function (elements, args, index, currentFileInfo, important) {\n this.selector = new(tree.Selector)(elements);\n this.arguments = (args && args.length) ? args : null;\n this.index = index;\n this.currentFileInfo = currentFileInfo;\n this.important = important;\n};\ntree.mixin.Call.prototype = {\n type: \"MixinCall\",\n accept: function (visitor) {\n if (this.selector) {\n this.selector = visitor.visit(this.selector);\n }\n if (this.arguments) {\n this.arguments = visitor.visitArray(this.arguments);\n }\n },\n eval: function (env) {\n var mixins, mixin, args, rules = [], match = false, i, m, f, isRecursive, isOneFound, rule,\n candidates = [], candidate, conditionResult = [], defaultFunc = tree.defaultFunc,\n defaultResult, defNone = 0, defTrue = 1, defFalse = 2, count; \n\n args = this.arguments && this.arguments.map(function (a) {\n return { name: a.name, value: a.value.eval(env) };\n });\n\n for (i = 0; i < env.frames.length; i++) {\n if ((mixins = env.frames[i].find(this.selector)).length > 0) {\n isOneFound = true;\n \n // To make `default()` function independent of definition order we have two \"subpasses\" here.\n // At first we evaluate each guard *twice* (with `default() == true` and `default() == false`),\n // and build candidate list with corresponding flags. Then, when we know all possible matches,\n // we make a final decision.\n \n for (m = 0; m < mixins.length; m++) {\n mixin = mixins[m];\n isRecursive = false;\n for(f = 0; f < env.frames.length; f++) {\n if ((!(mixin instanceof tree.mixin.Definition)) && mixin === (env.frames[f].originalRuleset || env.frames[f])) {\n isRecursive = true;\n break;\n }\n }\n if (isRecursive) {\n continue;\n }\n \n if (mixin.matchArgs(args, env)) { \n candidate = {mixin: mixin, group: defNone};\n \n if (mixin.matchCondition) { \n for (f = 0; f < 2; f++) {\n defaultFunc.value(f);\n conditionResult[f] = mixin.matchCondition(args, env);\n }\n if (conditionResult[0] || conditionResult[1]) {\n if (conditionResult[0] != conditionResult[1]) {\n candidate.group = conditionResult[1] ?\n defTrue : defFalse;\n }\n\n candidates.push(candidate);\n } \n }\n else {\n candidates.push(candidate);\n }\n \n match = true;\n }\n }\n \n defaultFunc.reset();\n\n count = [0, 0, 0];\n for (m = 0; m < candidates.length; m++) {\n count[candidates[m].group]++;\n }\n\n if (count[defNone] > 0) {\n defaultResult = defFalse;\n } else {\n defaultResult = defTrue;\n if ((count[defTrue] + count[defFalse]) > 1) {\n throw { type: 'Runtime',\n message: 'Ambiguous use of `default()` found when matching for `'\n + this.format(args) + '`',\n index: this.index, filename: this.currentFileInfo.filename };\n }\n }\n \n for (m = 0; m < candidates.length; m++) {\n candidate = candidates[m].group;\n if ((candidate === defNone) || (candidate === defaultResult)) {\n try {\n mixin = candidates[m].mixin;\n if (!(mixin instanceof tree.mixin.Definition)) {\n mixin = new tree.mixin.Definition(\"\", [], mixin.rules, null, false);\n mixin.originalRuleset = mixins[m].originalRuleset || mixins[m];\n }\n Array.prototype.push.apply(\n rules, mixin.evalCall(env, args, this.important).rules);\n } catch (e) {\n throw { message: e.message, index: this.index, filename: this.currentFileInfo.filename, stack: e.stack };\n }\n }\n }\n \n if (match) {\n if (!this.currentFileInfo || !this.currentFileInfo.reference) {\n for (i = 0; i < rules.length; i++) {\n rule = rules[i];\n if (rule.markReferenced) {\n rule.markReferenced();\n }\n }\n }\n return rules;\n }\n }\n }\n if (isOneFound) {\n throw { type: 'Runtime',\n message: 'No matching definition was found for `' + this.format(args) + '`',\n index: this.index, filename: this.currentFileInfo.filename };\n } else {\n throw { type: 'Name',\n message: this.selector.toCSS().trim() + \" is undefined\",\n index: this.index, filename: this.currentFileInfo.filename };\n }\n },\n format: function (args) {\n return this.selector.toCSS().trim() + '(' +\n (args ? args.map(function (a) {\n var argValue = \"\";\n if (a.name) {\n argValue += a.name + \":\";\n }\n if (a.value.toCSS) {\n argValue += a.value.toCSS();\n } else {\n argValue += \"???\";\n }\n return argValue;\n }).join(', ') : \"\") + \")\";\n }\n};\n\ntree.mixin.Definition = function (name, params, rules, condition, variadic, frames) {\n this.name = name;\n this.selectors = [new(tree.Selector)([new(tree.Element)(null, name, this.index, this.currentFileInfo)])];\n this.params = params;\n this.condition = condition;\n this.variadic = variadic;\n this.arity = params.length;\n this.rules = rules;\n this._lookups = {};\n this.required = params.reduce(function (count, p) {\n if (!p.name || (p.name && !p.value)) { return count + 1; }\n else { return count; }\n }, 0);\n this.parent = tree.Ruleset.prototype;\n this.frames = frames;\n};\ntree.mixin.Definition.prototype = {\n type: \"MixinDefinition\",\n accept: function (visitor) {\n if (this.params && this.params.length) {\n this.params = visitor.visitArray(this.params);\n }\n this.rules = visitor.visitArray(this.rules);\n if (this.condition) {\n this.condition = visitor.visit(this.condition);\n }\n },\n variable: function (name) { return this.parent.variable.call(this, name); },\n variables: function () { return this.parent.variables.call(this); },\n find: function () { return this.parent.find.apply(this, arguments); },\n rulesets: function () { return this.parent.rulesets.apply(this); },\n\n evalParams: function (env, mixinEnv, args, evaldArguments) {\n /*jshint boss:true */\n var frame = new(tree.Ruleset)(null, null),\n varargs, arg,\n params = this.params.slice(0),\n i, j, val, name, isNamedFound, argIndex, argsLength = 0;\n\n mixinEnv = new tree.evalEnv(mixinEnv, [frame].concat(mixinEnv.frames));\n\n if (args) {\n args = args.slice(0);\n argsLength = args.length;\n\n for(i = 0; i < argsLength; i++) {\n arg = args[i];\n if (name = (arg && arg.name)) {\n isNamedFound = false;\n for(j = 0; j < params.length; j++) {\n if (!evaldArguments[j] && name === params[j].name) {\n evaldArguments[j] = arg.value.eval(env);\n frame.prependRule(new(tree.Rule)(name, arg.value.eval(env)));\n isNamedFound = true;\n break;\n }\n }\n if (isNamedFound) {\n args.splice(i, 1);\n i--;\n continue;\n } else {\n throw { type: 'Runtime', message: \"Named argument for \" + this.name +\n ' ' + args[i].name + ' not found' };\n }\n }\n }\n }\n argIndex = 0;\n for (i = 0; i < params.length; i++) {\n if (evaldArguments[i]) { continue; }\n\n arg = args && args[argIndex];\n\n if (name = params[i].name) {\n if (params[i].variadic) {\n varargs = [];\n for (j = argIndex; j < argsLength; j++) {\n varargs.push(args[j].value.eval(env));\n }\n frame.prependRule(new(tree.Rule)(name, new(tree.Expression)(varargs).eval(env)));\n } else {\n val = arg && arg.value;\n if (val) {\n val = val.eval(env);\n } else if (params[i].value) {\n val = params[i].value.eval(mixinEnv);\n frame.resetCache();\n } else {\n throw { type: 'Runtime', message: \"wrong number of arguments for \" + this.name +\n ' (' + argsLength + ' for ' + this.arity + ')' };\n }\n \n frame.prependRule(new(tree.Rule)(name, val));\n evaldArguments[i] = val;\n }\n }\n\n if (params[i].variadic && args) {\n for (j = argIndex; j < argsLength; j++) {\n evaldArguments[j] = args[j].value.eval(env);\n }\n }\n argIndex++;\n }\n\n return frame;\n },\n eval: function (env) {\n return new tree.mixin.Definition(this.name, this.params, this.rules, this.condition, this.variadic, this.frames || env.frames.slice(0));\n },\n evalCall: function (env, args, important) {\n var _arguments = [],\n mixinFrames = this.frames ? this.frames.concat(env.frames) : env.frames,\n frame = this.evalParams(env, new(tree.evalEnv)(env, mixinFrames), args, _arguments),\n rules, ruleset;\n\n frame.prependRule(new(tree.Rule)('@arguments', new(tree.Expression)(_arguments).eval(env)));\n\n rules = this.rules.slice(0);\n\n ruleset = new(tree.Ruleset)(null, rules);\n ruleset.originalRuleset = this;\n ruleset = ruleset.eval(new(tree.evalEnv)(env, [this, frame].concat(mixinFrames)));\n if (important) {\n ruleset = this.parent.makeImportant.apply(ruleset);\n }\n return ruleset;\n },\n matchCondition: function (args, env) {\n if (this.condition && !this.condition.eval(\n new(tree.evalEnv)(env,\n [this.evalParams(env, new(tree.evalEnv)(env, this.frames.concat(env.frames)), args, [])] // the parameter variables\n .concat(this.frames) // the parent namespace/mixin frames\n .concat(env.frames)))) { // the current environment frames\n return false;\n }\n return true;\n },\n matchArgs: function (args, env) {\n var argsLength = (args && args.length) || 0, len;\n\n if (! this.variadic) {\n if (argsLength < this.required) { return false; }\n if (argsLength > this.params.length) { return false; }\n } else {\n if (argsLength < (this.required - 1)) { return false; }\n }\n\n len = Math.min(argsLength, this.arity);\n\n for (var i = 0; i < len; i++) {\n if (!this.params[i].name && !this.params[i].variadic) {\n if (args[i].value.eval(env).toCSS() != this.params[i].value.eval(env).toCSS()) {\n return false;\n }\n }\n }\n return true;\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Negative = function (node) {\n this.value = node;\n};\ntree.Negative.prototype = {\n type: \"Negative\",\n accept: function (visitor) {\n this.value = visitor.visit(this.value);\n },\n genCSS: function (env, output) {\n output.add('-');\n this.value.genCSS(env, output);\n },\n toCSS: tree.toCSS,\n eval: function (env) {\n if (env.isMathOn()) {\n return (new(tree.Operation)('*', [new(tree.Dimension)(-1), this.value])).eval(env);\n }\n return new(tree.Negative)(this.value.eval(env));\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Operation = function (op, operands, isSpaced) {\n this.op = op.trim();\n this.operands = operands;\n this.isSpaced = isSpaced;\n};\ntree.Operation.prototype = {\n type: \"Operation\",\n accept: function (visitor) {\n this.operands = visitor.visit(this.operands);\n },\n eval: function (env) {\n var a = this.operands[0].eval(env),\n b = this.operands[1].eval(env);\n\n if (env.isMathOn()) {\n if (a instanceof tree.Dimension && b instanceof tree.Color) {\n a = a.toColor();\n }\n if (b instanceof tree.Dimension && a instanceof tree.Color) {\n b = b.toColor();\n }\n if (!a.operate) {\n throw { type: \"Operation\",\n message: \"Operation on an invalid type\" };\n }\n\n return a.operate(env, this.op, b);\n } else {\n return new(tree.Operation)(this.op, [a, b], this.isSpaced);\n }\n },\n genCSS: function (env, output) {\n this.operands[0].genCSS(env, output);\n if (this.isSpaced) {\n output.add(\" \");\n }\n output.add(this.op);\n if (this.isSpaced) {\n output.add(\" \");\n }\n this.operands[1].genCSS(env, output);\n },\n toCSS: tree.toCSS\n};\n\ntree.operate = function (env, op, a, b) {\n switch (op) {\n case '+': return a + b;\n case '-': return a - b;\n case '*': return a * b;\n case '/': return a / b;\n }\n};\n\n})(require('../tree'));\n\n\n(function (tree) {\n\ntree.Paren = function (node) {\n this.value = node;\n};\ntree.Paren.prototype = {\n type: \"Paren\",\n accept: function (visitor) {\n this.value = visitor.visit(this.value);\n },\n genCSS: function (env, output) {\n output.add('(');\n this.value.genCSS(env, output);\n output.add(')');\n },\n toCSS: tree.toCSS,\n eval: function (env) {\n return new(tree.Paren)(this.value.eval(env));\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Quoted = function (str, content, escaped, index, currentFileInfo) {\n this.escaped = escaped;\n this.value = content || '';\n this.quote = str.charAt(0);\n this.index = index;\n this.currentFileInfo = currentFileInfo;\n};\ntree.Quoted.prototype = {\n type: \"Quoted\",\n genCSS: function (env, output) {\n if (!this.escaped) {\n output.add(this.quote, this.currentFileInfo, this.index);\n }\n output.add(this.value);\n if (!this.escaped) {\n output.add(this.quote);\n }\n },\n toCSS: tree.toCSS,\n eval: function (env) {\n var that = this;\n var value = this.value.replace(/`([^`]+)`/g, function (_, exp) {\n return new(tree.JavaScript)(exp, that.index, true).eval(env).value;\n }).replace(/@\\{([\\w-]+)\\}/g, function (_, name) {\n var v = new(tree.Variable)('@' + name, that.index, that.currentFileInfo).eval(env, true);\n return (v instanceof tree.Quoted) ? v.value : v.toCSS();\n });\n return new(tree.Quoted)(this.quote + value + this.quote, value, this.escaped, this.index, this.currentFileInfo);\n },\n compare: function (x) {\n if (!x.toCSS) {\n return -1;\n }\n \n var left = this.toCSS(),\n right = x.toCSS();\n \n if (left === right) {\n return 0;\n }\n \n return left < right ? -1 : 1;\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Rule = function (name, value, important, merge, index, currentFileInfo, inline) {\n this.name = name;\n this.value = (value instanceof tree.Value || value instanceof tree.Ruleset) ? value : new(tree.Value)([value]);\n this.important = important ? ' ' + important.trim() : '';\n this.merge = merge;\n this.index = index;\n this.currentFileInfo = currentFileInfo;\n this.inline = inline || false;\n this.variable = name.charAt && (name.charAt(0) === '@');\n};\n\ntree.Rule.prototype = {\n type: \"Rule\",\n accept: function (visitor) {\n this.value = visitor.visit(this.value);\n },\n genCSS: function (env, output) {\n output.add(this.name + (env.compress ? ':' : ': '), this.currentFileInfo, this.index);\n try {\n this.value.genCSS(env, output);\n }\n catch(e) {\n e.index = this.index;\n e.filename = this.currentFileInfo.filename;\n throw e;\n }\n output.add(this.important + ((this.inline || (env.lastRule && env.compress)) ? \"\" : \";\"), this.currentFileInfo, this.index);\n },\n toCSS: tree.toCSS,\n eval: function (env) {\n var strictMathBypass = false, name = this.name, evaldValue;\n if (typeof name !== \"string\") {\n // expand 'primitive' name directly to get\n // things faster (~10% for benchmark.less):\n name = (name.length === 1) \n && (name[0] instanceof tree.Keyword)\n ? name[0].value : evalName(env, name);\n }\n if (name === \"font\" && !env.strictMath) {\n strictMathBypass = true;\n env.strictMath = true;\n }\n try {\n evaldValue = this.value.eval(env);\n \n if (!this.variable && evaldValue.type === \"DetachedRuleset\") {\n throw { message: \"Rulesets cannot be evaluated on a property.\",\n index: this.index, filename: this.currentFileInfo.filename };\n }\n\n return new(tree.Rule)(name,\n evaldValue,\n this.important,\n this.merge,\n this.index, this.currentFileInfo, this.inline);\n }\n catch(e) {\n if (typeof e.index !== 'number') {\n e.index = this.index;\n e.filename = this.currentFileInfo.filename;\n }\n throw e;\n }\n finally {\n if (strictMathBypass) {\n env.strictMath = false;\n }\n }\n },\n makeImportant: function () {\n return new(tree.Rule)(this.name,\n this.value,\n \"!important\",\n this.merge,\n this.index, this.currentFileInfo, this.inline);\n }\n};\n\nfunction evalName(env, name) {\n var value = \"\", i, n = name.length,\n output = {add: function (s) {value += s;}};\n for (i = 0; i < n; i++) {\n name[i].eval(env).genCSS(env, output);\n }\n return value;\n}\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.RulesetCall = function (variable) {\n this.variable = variable;\n};\ntree.RulesetCall.prototype = {\n type: \"RulesetCall\",\n accept: function (visitor) {\n },\n eval: function (env) {\n var detachedRuleset = new(tree.Variable)(this.variable).eval(env);\n return detachedRuleset.callEval(env);\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Ruleset = function (selectors, rules, strictImports) {\n this.selectors = selectors;\n this.rules = rules;\n this._lookups = {};\n this.strictImports = strictImports;\n};\ntree.Ruleset.prototype = {\n type: \"Ruleset\",\n accept: function (visitor) {\n if (this.paths) {\n visitor.visitArray(this.paths, true);\n } else if (this.selectors) {\n this.selectors = visitor.visitArray(this.selectors);\n }\n if (this.rules && this.rules.length) {\n this.rules = visitor.visitArray(this.rules);\n }\n },\n eval: function (env) {\n var thisSelectors = this.selectors, selectors, \n selCnt, selector, i, defaultFunc = tree.defaultFunc, hasOnePassingSelector = false;\n\n if (thisSelectors && (selCnt = thisSelectors.length)) {\n selectors = [];\n defaultFunc.error({\n type: \"Syntax\", \n message: \"it is currently only allowed in parametric mixin guards,\" \n });\n for (i = 0; i < selCnt; i++) {\n selector = thisSelectors[i].eval(env);\n selectors.push(selector);\n if (selector.evaldCondition) {\n hasOnePassingSelector = true;\n }\n }\n defaultFunc.reset(); \n } else {\n hasOnePassingSelector = true;\n }\n\n var rules = this.rules ? this.rules.slice(0) : null,\n ruleset = new(tree.Ruleset)(selectors, rules, this.strictImports),\n rule, subRule;\n\n ruleset.originalRuleset = this;\n ruleset.root = this.root;\n ruleset.firstRoot = this.firstRoot;\n ruleset.allowImports = this.allowImports;\n\n if(this.debugInfo) {\n ruleset.debugInfo = this.debugInfo;\n }\n \n if (!hasOnePassingSelector) {\n rules.length = 0;\n }\n\n // push the current ruleset to the frames stack\n var envFrames = env.frames;\n envFrames.unshift(ruleset);\n\n // currrent selectors\n var envSelectors = env.selectors;\n if (!envSelectors) {\n env.selectors = envSelectors = [];\n }\n envSelectors.unshift(this.selectors);\n\n // Evaluate imports\n if (ruleset.root || ruleset.allowImports || !ruleset.strictImports) {\n ruleset.evalImports(env);\n }\n\n // Store the frames around mixin definitions,\n // so they can be evaluated like closures when the time comes.\n var rsRules = ruleset.rules, rsRuleCnt = rsRules ? rsRules.length : 0;\n for (i = 0; i < rsRuleCnt; i++) {\n if (rsRules[i] instanceof tree.mixin.Definition || rsRules[i] instanceof tree.DetachedRuleset) {\n rsRules[i] = rsRules[i].eval(env);\n }\n }\n\n var mediaBlockCount = (env.mediaBlocks && env.mediaBlocks.length) || 0;\n\n // Evaluate mixin calls.\n for (i = 0; i < rsRuleCnt; i++) {\n if (rsRules[i] instanceof tree.mixin.Call) {\n /*jshint loopfunc:true */\n rules = rsRules[i].eval(env).filter(function(r) {\n if ((r instanceof tree.Rule) && r.variable) {\n // do not pollute the scope if the variable is\n // already there. consider returning false here\n // but we need a way to \"return\" variable from mixins\n return !(ruleset.variable(r.name));\n }\n return true;\n });\n rsRules.splice.apply(rsRules, [i, 1].concat(rules));\n rsRuleCnt += rules.length - 1;\n i += rules.length-1;\n ruleset.resetCache();\n } else if (rsRules[i] instanceof tree.RulesetCall) {\n /*jshint loopfunc:true */\n rules = rsRules[i].eval(env).rules.filter(function(r) {\n if ((r instanceof tree.Rule) && r.variable) {\n // do not pollute the scope at all\n return false;\n }\n return true;\n });\n rsRules.splice.apply(rsRules, [i, 1].concat(rules));\n rsRuleCnt += rules.length - 1;\n i += rules.length-1;\n ruleset.resetCache();\n }\n }\n\n // Evaluate everything else\n for (i = 0; i < rsRules.length; i++) {\n rule = rsRules[i];\n if (! (rule instanceof tree.mixin.Definition || rule instanceof tree.DetachedRuleset)) {\n rsRules[i] = rule = rule.eval ? rule.eval(env) : rule;\n }\n }\n \n // Evaluate everything else\n for (i = 0; i < rsRules.length; i++) {\n rule = rsRules[i];\n // for rulesets, check if it is a css guard and can be removed\n if (rule instanceof tree.Ruleset && rule.selectors && rule.selectors.length === 1) {\n // check if it can be folded in (e.g. & where)\n if (rule.selectors[0].isJustParentSelector()) {\n rsRules.splice(i--, 1);\n\n for(var j = 0; j < rule.rules.length; j++) {\n subRule = rule.rules[j];\n if (!(subRule instanceof tree.Rule) || !subRule.variable) {\n rsRules.splice(++i, 0, subRule);\n }\n }\n }\n }\n }\n\n // Pop the stack\n envFrames.shift();\n envSelectors.shift();\n \n if (env.mediaBlocks) {\n for (i = mediaBlockCount; i < env.mediaBlocks.length; i++) {\n env.mediaBlocks[i].bubbleSelectors(selectors);\n }\n }\n\n return ruleset;\n },\n evalImports: function(env) {\n var rules = this.rules, i, importRules;\n if (!rules) { return; }\n\n for (i = 0; i < rules.length; i++) {\n if (rules[i] instanceof tree.Import) {\n importRules = rules[i].eval(env);\n if (importRules && importRules.length) {\n rules.splice.apply(rules, [i, 1].concat(importRules));\n i+= importRules.length-1;\n } else {\n rules.splice(i, 1, importRules);\n }\n this.resetCache();\n }\n }\n },\n makeImportant: function() {\n return new tree.Ruleset(this.selectors, this.rules.map(function (r) {\n if (r.makeImportant) {\n return r.makeImportant();\n } else {\n return r;\n }\n }), this.strictImports);\n },\n matchArgs: function (args) {\n return !args || args.length === 0;\n },\n // lets you call a css selector with a guard\n matchCondition: function (args, env) {\n var lastSelector = this.selectors[this.selectors.length-1];\n if (!lastSelector.evaldCondition) {\n return false;\n }\n if (lastSelector.condition &&\n !lastSelector.condition.eval(\n new(tree.evalEnv)(env,\n env.frames))) {\n return false;\n }\n return true;\n },\n resetCache: function () {\n this._rulesets = null;\n this._variables = null;\n this._lookups = {};\n },\n variables: function () {\n if (!this._variables) {\n this._variables = !this.rules ? {} : this.rules.reduce(function (hash, r) {\n if (r instanceof tree.Rule && r.variable === true) {\n hash[r.name] = r;\n }\n return hash;\n }, {});\n }\n return this._variables;\n },\n variable: function (name) {\n return this.variables()[name];\n },\n rulesets: function () {\n if (!this.rules) { return null; }\n\n var _Ruleset = tree.Ruleset, _MixinDefinition = tree.mixin.Definition,\n filtRules = [], rules = this.rules, cnt = rules.length,\n i, rule;\n\n for (i = 0; i < cnt; i++) {\n rule = rules[i];\n if ((rule instanceof _Ruleset) || (rule instanceof _MixinDefinition)) {\n filtRules.push(rule);\n }\n }\n\n return filtRules;\n },\n prependRule: function (rule) {\n var rules = this.rules;\n if (rules) { rules.unshift(rule); } else { this.rules = [ rule ]; }\n },\n find: function (selector, self) {\n self = self || this;\n var rules = [], match,\n key = selector.toCSS();\n\n if (key in this._lookups) { return this._lookups[key]; }\n\n this.rulesets().forEach(function (rule) {\n if (rule !== self) {\n for (var j = 0; j < rule.selectors.length; j++) {\n match = selector.match(rule.selectors[j]);\n if (match) {\n if (selector.elements.length > match) {\n Array.prototype.push.apply(rules, rule.find(\n new(tree.Selector)(selector.elements.slice(match)), self));\n } else {\n rules.push(rule);\n }\n break;\n }\n }\n }\n });\n this._lookups[key] = rules;\n return rules;\n },\n genCSS: function (env, output) {\n var i, j,\n ruleNodes = [],\n rulesetNodes = [],\n rulesetNodeCnt,\n debugInfo, // Line number debugging\n rule,\n path;\n\n env.tabLevel = (env.tabLevel || 0);\n\n if (!this.root) {\n env.tabLevel++;\n }\n\n var tabRuleStr = env.compress ? '' : Array(env.tabLevel + 1).join(\" \"),\n tabSetStr = env.compress ? '' : Array(env.tabLevel).join(\" \"),\n sep;\n\n for (i = 0; i < this.rules.length; i++) {\n rule = this.rules[i];\n if (rule.rules || (rule instanceof tree.Media) || rule instanceof tree.Directive || (this.root && rule instanceof tree.Comment)) {\n rulesetNodes.push(rule);\n } else {\n ruleNodes.push(rule);\n }\n }\n\n // If this is the root node, we don't render\n // a selector, or {}.\n if (!this.root) {\n debugInfo = tree.debugInfo(env, this, tabSetStr);\n\n if (debugInfo) {\n output.add(debugInfo);\n output.add(tabSetStr);\n }\n\n var paths = this.paths, pathCnt = paths.length,\n pathSubCnt;\n\n sep = env.compress ? ',' : (',\\n' + tabSetStr);\n\n for (i = 0; i < pathCnt; i++) {\n path = paths[i];\n if (!(pathSubCnt = path.length)) { continue; }\n if (i > 0) { output.add(sep); }\n\n env.firstSelector = true;\n path[0].genCSS(env, output);\n\n env.firstSelector = false;\n for (j = 1; j < pathSubCnt; j++) {\n path[j].genCSS(env, output);\n }\n }\n\n output.add((env.compress ? '{' : ' {\\n') + tabRuleStr);\n }\n\n // Compile rules and rulesets\n for (i = 0; i < ruleNodes.length; i++) {\n rule = ruleNodes[i];\n\n // @page{ directive ends up with root elements inside it, a mix of rules and rulesets\n // In this instance we do not know whether it is the last property\n if (i + 1 === ruleNodes.length && (!this.root || rulesetNodes.length === 0 || this.firstRoot)) {\n env.lastRule = true;\n }\n\n if (rule.genCSS) {\n rule.genCSS(env, output);\n } else if (rule.value) {\n output.add(rule.value.toString());\n }\n\n if (!env.lastRule) {\n output.add(env.compress ? '' : ('\\n' + tabRuleStr));\n } else {\n env.lastRule = false;\n }\n }\n\n if (!this.root) {\n output.add((env.compress ? '}' : '\\n' + tabSetStr + '}'));\n env.tabLevel--;\n }\n\n sep = (env.compress ? \"\" : \"\\n\") + (this.root ? tabRuleStr : tabSetStr);\n rulesetNodeCnt = rulesetNodes.length;\n if (rulesetNodeCnt) {\n if (ruleNodes.length && sep) { output.add(sep); }\n rulesetNodes[0].genCSS(env, output);\n for (i = 1; i < rulesetNodeCnt; i++) {\n if (sep) { output.add(sep); }\n rulesetNodes[i].genCSS(env, output);\n }\n }\n\n if (!output.isEmpty() && !env.compress && this.firstRoot) {\n output.add('\\n');\n }\n },\n\n toCSS: tree.toCSS,\n\n markReferenced: function () {\n if (!this.selectors) {\n return;\n }\n for (var s = 0; s < this.selectors.length; s++) {\n this.selectors[s].markReferenced();\n }\n },\n\n joinSelectors: function (paths, context, selectors) {\n for (var s = 0; s < selectors.length; s++) {\n this.joinSelector(paths, context, selectors[s]);\n }\n },\n\n joinSelector: function (paths, context, selector) {\n\n var i, j, k, \n hasParentSelector, newSelectors, el, sel, parentSel, \n newSelectorPath, afterParentJoin, newJoinedSelector, \n newJoinedSelectorEmpty, lastSelector, currentElements,\n selectorsMultiplied;\n \n for (i = 0; i < selector.elements.length; i++) {\n el = selector.elements[i];\n if (el.value === '&') {\n hasParentSelector = true;\n }\n }\n \n if (!hasParentSelector) {\n if (context.length > 0) {\n for (i = 0; i < context.length; i++) {\n paths.push(context[i].concat(selector));\n }\n }\n else {\n paths.push([selector]);\n }\n return;\n }\n\n // The paths are [[Selector]]\n // The first list is a list of comma seperated selectors\n // The inner list is a list of inheritance seperated selectors\n // e.g.\n // .a, .b {\n // .c {\n // }\n // }\n // == [[.a] [.c]] [[.b] [.c]]\n //\n\n // the elements from the current selector so far\n currentElements = [];\n // the current list of new selectors to add to the path.\n // We will build it up. We initiate it with one empty selector as we \"multiply\" the new selectors\n // by the parents\n newSelectors = [[]];\n\n for (i = 0; i < selector.elements.length; i++) {\n el = selector.elements[i];\n // non parent reference elements just get added\n if (el.value !== \"&\") {\n currentElements.push(el);\n } else {\n // the new list of selectors to add\n selectorsMultiplied = [];\n\n // merge the current list of non parent selector elements\n // on to the current list of selectors to add\n if (currentElements.length > 0) {\n this.mergeElementsOnToSelectors(currentElements, newSelectors);\n }\n\n // loop through our current selectors\n for (j = 0; j < newSelectors.length; j++) {\n sel = newSelectors[j];\n // if we don't have any parent paths, the & might be in a mixin so that it can be used\n // whether there are parents or not\n if (context.length === 0) {\n // the combinator used on el should now be applied to the next element instead so that\n // it is not lost\n if (sel.length > 0) {\n sel[0].elements = sel[0].elements.slice(0);\n sel[0].elements.push(new(tree.Element)(el.combinator, '', el.index, el.currentFileInfo));\n }\n selectorsMultiplied.push(sel);\n }\n else {\n // and the parent selectors\n for (k = 0; k < context.length; k++) {\n parentSel = context[k];\n // We need to put the current selectors\n // then join the last selector's elements on to the parents selectors\n\n // our new selector path\n newSelectorPath = [];\n // selectors from the parent after the join\n afterParentJoin = [];\n newJoinedSelectorEmpty = true;\n\n //construct the joined selector - if & is the first thing this will be empty,\n // if not newJoinedSelector will be the last set of elements in the selector\n if (sel.length > 0) {\n newSelectorPath = sel.slice(0);\n lastSelector = newSelectorPath.pop();\n newJoinedSelector = selector.createDerived(lastSelector.elements.slice(0));\n newJoinedSelectorEmpty = false;\n }\n else {\n newJoinedSelector = selector.createDerived([]);\n }\n\n //put together the parent selectors after the join\n if (parentSel.length > 1) {\n afterParentJoin = afterParentJoin.concat(parentSel.slice(1));\n }\n\n if (parentSel.length > 0) {\n newJoinedSelectorEmpty = false;\n\n // join the elements so far with the first part of the parent\n newJoinedSelector.elements.push(new(tree.Element)(el.combinator, parentSel[0].elements[0].value, el.index, el.currentFileInfo));\n newJoinedSelector.elements = newJoinedSelector.elements.concat(parentSel[0].elements.slice(1));\n }\n\n if (!newJoinedSelectorEmpty) {\n // now add the joined selector\n newSelectorPath.push(newJoinedSelector);\n }\n\n // and the rest of the parent\n newSelectorPath = newSelectorPath.concat(afterParentJoin);\n\n // add that to our new set of selectors\n selectorsMultiplied.push(newSelectorPath);\n }\n }\n }\n\n // our new selectors has been multiplied, so reset the state\n newSelectors = selectorsMultiplied;\n currentElements = [];\n }\n }\n\n // if we have any elements left over (e.g. .a& .b == .b)\n // add them on to all the current selectors\n if (currentElements.length > 0) {\n this.mergeElementsOnToSelectors(currentElements, newSelectors);\n }\n\n for (i = 0; i < newSelectors.length; i++) {\n if (newSelectors[i].length > 0) {\n paths.push(newSelectors[i]);\n }\n }\n },\n \n mergeElementsOnToSelectors: function(elements, selectors) {\n var i, sel;\n\n if (selectors.length === 0) {\n selectors.push([ new(tree.Selector)(elements) ]);\n return;\n }\n\n for (i = 0; i < selectors.length; i++) {\n sel = selectors[i];\n\n // if the previous thing in sel is a parent this needs to join on to it\n if (sel.length > 0) {\n sel[sel.length - 1] = sel[sel.length - 1].createDerived(sel[sel.length - 1].elements.concat(elements));\n }\n else {\n sel.push(new(tree.Selector)(elements));\n }\n }\n }\n};\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Selector = function (elements, extendList, condition, index, currentFileInfo, isReferenced) {\n this.elements = elements;\n this.extendList = extendList;\n this.condition = condition;\n this.currentFileInfo = currentFileInfo || {};\n this.isReferenced = isReferenced;\n if (!condition) {\n this.evaldCondition = true;\n }\n};\ntree.Selector.prototype = {\n type: \"Selector\",\n accept: function (visitor) {\n if (this.elements) {\n this.elements = visitor.visitArray(this.elements);\n }\n if (this.extendList) {\n this.extendList = visitor.visitArray(this.extendList);\n }\n if (this.condition) {\n this.condition = visitor.visit(this.condition);\n }\n },\n createDerived: function(elements, extendList, evaldCondition) {\n evaldCondition = (evaldCondition != null) ? evaldCondition : this.evaldCondition;\n var newSelector = new(tree.Selector)(elements, extendList || this.extendList, null, this.index, this.currentFileInfo, this.isReferenced);\n newSelector.evaldCondition = evaldCondition;\n newSelector.mediaEmpty = this.mediaEmpty;\n return newSelector;\n },\n match: function (other) {\n var elements = this.elements,\n len = elements.length,\n olen, i;\n\n other.CacheElements();\n\n olen = other._elements.length;\n if (olen === 0 || len < olen) {\n return 0;\n } else {\n for (i = 0; i < olen; i++) {\n if (elements[i].value !== other._elements[i]) {\n return 0;\n }\n }\n }\n\n return olen; // return number of matched elements\n },\n CacheElements: function(){\n var css = '', len, v, i;\n\n if( !this._elements ){\n\n len = this.elements.length;\n for(i = 0; i < len; i++){\n\n v = this.elements[i];\n css += v.combinator.value;\n\n if( !v.value.value ){\n css += v.value;\n continue;\n }\n\n if( typeof v.value.value !== \"string\" ){\n css = '';\n break;\n }\n css += v.value.value;\n }\n\n this._elements = css.match(/[,&#\\.\\w-]([\\w-]|(\\\\.))*/g);\n\n if (this._elements) {\n if (this._elements[0] === \"&\") {\n this._elements.shift();\n }\n\n } else {\n this._elements = [];\n }\n\n }\n },\n isJustParentSelector: function() {\n return !this.mediaEmpty && \n this.elements.length === 1 && \n this.elements[0].value === '&' && \n (this.elements[0].combinator.value === ' ' || this.elements[0].combinator.value === '');\n },\n eval: function (env) {\n var evaldCondition = this.condition && this.condition.eval(env),\n elements = this.elements, extendList = this.extendList;\n\n elements = elements && elements.map(function (e) { return e.eval(env); });\n extendList = extendList && extendList.map(function(extend) { return extend.eval(env); });\n\n return this.createDerived(elements, extendList, evaldCondition);\n },\n genCSS: function (env, output) {\n var i, element;\n if ((!env || !env.firstSelector) && this.elements[0].combinator.value === \"\") {\n output.add(' ', this.currentFileInfo, this.index);\n }\n if (!this._css) {\n //TODO caching? speed comparison?\n for(i = 0; i < this.elements.length; i++) {\n element = this.elements[i];\n element.genCSS(env, output);\n }\n }\n },\n toCSS: tree.toCSS,\n markReferenced: function () {\n this.isReferenced = true;\n },\n getIsReferenced: function() {\n return !this.currentFileInfo.reference || this.isReferenced;\n },\n getIsOutput: function() {\n return this.evaldCondition;\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.UnicodeDescriptor = function (value) {\n this.value = value;\n};\ntree.UnicodeDescriptor.prototype = {\n type: \"UnicodeDescriptor\",\n genCSS: function (env, output) {\n output.add(this.value);\n },\n toCSS: tree.toCSS,\n eval: function () { return this; }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.URL = function (val, currentFileInfo, isEvald) {\n this.value = val;\n this.currentFileInfo = currentFileInfo;\n this.isEvald = isEvald;\n};\ntree.URL.prototype = {\n type: \"Url\",\n accept: function (visitor) {\n this.value = visitor.visit(this.value);\n },\n genCSS: function (env, output) {\n output.add(\"url(\");\n this.value.genCSS(env, output);\n output.add(\")\");\n },\n toCSS: tree.toCSS,\n eval: function (ctx) {\n var val = this.value.eval(ctx),\n rootpath;\n\n if (!this.isEvald) {\n // Add the base path if the URL is relative\n rootpath = this.currentFileInfo && this.currentFileInfo.rootpath;\n if (rootpath && typeof val.value === \"string\" && ctx.isPathRelative(val.value)) {\n if (!val.quote) {\n rootpath = rootpath.replace(/[\\(\\)'\"\\s]/g, function(match) { return \"\\\\\"+match; });\n }\n val.value = rootpath + val.value;\n }\n \n val.value = ctx.normalizePath(val.value);\n\n // Add url args if enabled\n if (ctx.urlArgs) {\n if (!val.value.match(/^\\s*data:/)) {\n var delimiter = val.value.indexOf('?') === -1 ? '?' : '&';\n var urlArgs = delimiter + ctx.urlArgs;\n if (val.value.indexOf('#') !== -1) {\n val.value = val.value.replace('#', urlArgs + '#');\n } else {\n val.value += urlArgs;\n }\n }\n }\n }\n\n return new(tree.URL)(val, this.currentFileInfo, true);\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Value = function (value) {\n this.value = value;\n};\ntree.Value.prototype = {\n type: \"Value\",\n accept: function (visitor) {\n if (this.value) {\n this.value = visitor.visitArray(this.value);\n }\n },\n eval: function (env) {\n if (this.value.length === 1) {\n return this.value[0].eval(env);\n } else {\n return new(tree.Value)(this.value.map(function (v) {\n return v.eval(env);\n }));\n }\n },\n genCSS: function (env, output) {\n var i;\n for(i = 0; i < this.value.length; i++) {\n this.value[i].genCSS(env, output);\n if (i+1 < this.value.length) {\n output.add((env && env.compress) ? ',' : ', ');\n }\n }\n },\n toCSS: tree.toCSS\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\ntree.Variable = function (name, index, currentFileInfo) {\n this.name = name;\n this.index = index;\n this.currentFileInfo = currentFileInfo || {};\n};\ntree.Variable.prototype = {\n type: \"Variable\",\n eval: function (env) {\n var variable, name = this.name;\n\n if (name.indexOf('@@') === 0) {\n name = '@' + new(tree.Variable)(name.slice(1)).eval(env).value;\n }\n \n if (this.evaluating) {\n throw { type: 'Name',\n message: \"Recursive variable definition for \" + name,\n filename: this.currentFileInfo.file,\n index: this.index };\n }\n \n this.evaluating = true;\n\n variable = tree.find(env.frames, function (frame) {\n var v = frame.variable(name);\n if (v) {\n return v.value.eval(env);\n }\n });\n if (variable) { \n this.evaluating = false;\n return variable;\n } else {\n throw { type: 'Name',\n message: \"variable \" + name + \" is undefined\",\n filename: this.currentFileInfo.filename,\n index: this.index };\n }\n }\n};\n\n})(require('../tree'));\n\n(function (tree) {\n\n var parseCopyProperties = [\n 'paths', // option - unmodified - paths to search for imports on\n 'optimization', // option - optimization level (for the chunker)\n 'files', // list of files that have been imported, used for import-once\n 'contents', // map - filename to contents of all the files\n 'contentsIgnoredChars', // map - filename to lines at the begining of each file to ignore\n 'relativeUrls', // option - whether to adjust URL's to be relative\n 'rootpath', // option - rootpath to append to URL's\n 'strictImports', // option -\n 'insecure', // option - whether to allow imports from insecure ssl hosts\n 'dumpLineNumbers', // option - whether to dump line numbers\n 'compress', // option - whether to compress\n 'processImports', // option - whether to process imports. if false then imports will not be imported\n 'syncImport', // option - whether to import synchronously\n 'javascriptEnabled',// option - whether JavaScript is enabled. if undefined, defaults to true\n 'mime', // browser only - mime type for sheet import\n 'useFileCache', // browser only - whether to use the per file session cache\n 'currentFileInfo' // information about the current file - for error reporting and importing and making urls relative etc.\n ];\n\n //currentFileInfo = {\n // 'relativeUrls' - option - whether to adjust URL's to be relative\n // 'filename' - full resolved filename of current file\n // 'rootpath' - path to append to normal URLs for this node\n // 'currentDirectory' - path to the current file, absolute\n // 'rootFilename' - filename of the base file\n // 'entryPath' - absolute path to the entry file\n // 'reference' - whether the file should not be output and only output parts that are referenced\n\n tree.parseEnv = function(options) {\n copyFromOriginal(options, this, parseCopyProperties);\n\n if (!this.contents) { this.contents = {}; }\n if (!this.contentsIgnoredChars) { this.contentsIgnoredChars = {}; }\n if (!this.files) { this.files = {}; }\n\n if (!this.currentFileInfo) {\n var filename = (options && options.filename) || \"input\";\n var entryPath = filename.replace(/[^\\/\\\\]*$/, \"\");\n if (options) {\n options.filename = null;\n }\n this.currentFileInfo = {\n filename: filename,\n relativeUrls: this.relativeUrls,\n rootpath: (options && options.rootpath) || \"\",\n currentDirectory: entryPath,\n entryPath: entryPath,\n rootFilename: filename\n };\n }\n };\n\n var evalCopyProperties = [\n 'silent', // whether to swallow errors and warnings\n 'verbose', // whether to log more activity\n 'compress', // whether to compress\n 'yuicompress', // whether to compress with the outside tool yui compressor\n 'ieCompat', // whether to enforce IE compatibility (IE8 data-uri)\n 'strictMath', // whether math has to be within parenthesis\n 'strictUnits', // whether units need to evaluate correctly\n 'cleancss', // whether to compress with clean-css\n 'sourceMap', // whether to output a source map\n 'importMultiple', // whether we are currently importing multiple copies\n 'urlArgs' // whether to add args into url tokens\n ];\n\n tree.evalEnv = function(options, frames) {\n copyFromOriginal(options, this, evalCopyProperties);\n\n this.frames = frames || [];\n };\n\n tree.evalEnv.prototype.inParenthesis = function () {\n if (!this.parensStack) {\n this.parensStack = [];\n }\n this.parensStack.push(true);\n };\n\n tree.evalEnv.prototype.outOfParenthesis = function () {\n this.parensStack.pop();\n };\n\n tree.evalEnv.prototype.isMathOn = function () {\n return this.strictMath ? (this.parensStack && this.parensStack.length) : true;\n };\n\n tree.evalEnv.prototype.isPathRelative = function (path) {\n return !/^(?:[a-z-]+:|\\/)/.test(path);\n };\n\n tree.evalEnv.prototype.normalizePath = function( path ) {\n var\n segments = path.split(\"/\").reverse(),\n segment;\n\n path = [];\n while (segments.length !== 0 ) {\n segment = segments.pop();\n switch( segment ) {\n case \".\":\n break;\n case \"..\":\n if ((path.length === 0) || (path[path.length - 1] === \"..\")) {\n path.push( segment );\n } else {\n path.pop();\n }\n break;\n default:\n path.push( segment );\n break;\n }\n }\n\n return path.join(\"/\");\n };\n\n //todo - do the same for the toCSS env\n //tree.toCSSEnv = function (options) {\n //};\n\n var copyFromOriginal = function(original, destination, propertiesToCopy) {\n if (!original) { return; }\n\n for(var i = 0; i < propertiesToCopy.length; i++) {\n if (original.hasOwnProperty(propertiesToCopy[i])) {\n destination[propertiesToCopy[i]] = original[propertiesToCopy[i]];\n }\n }\n };\n\n})(require('./tree'));\n\n(function (tree) {\n\n var _visitArgs = { visitDeeper: true },\n _hasIndexed = false;\n\n function _noop(node) {\n return node;\n }\n\n function indexNodeTypes(parent, ticker) {\n // add .typeIndex to tree node types for lookup table\n var key, child;\n for (key in parent) {\n if (parent.hasOwnProperty(key)) {\n child = parent[key];\n switch (typeof child) {\n case \"function\":\n // ignore bound functions directly on tree which do not have a prototype\n // or aren't nodes\n if (child.prototype && child.prototype.type) {\n child.prototype.typeIndex = ticker++;\n }\n break;\n case \"object\":\n ticker = indexNodeTypes(child, ticker);\n break;\n }\n }\n }\n return ticker;\n }\n\n tree.visitor = function(implementation) {\n this._implementation = implementation;\n this._visitFnCache = [];\n\n if (!_hasIndexed) {\n indexNodeTypes(tree, 1);\n _hasIndexed = true;\n }\n };\n\n tree.visitor.prototype = {\n visit: function(node) {\n if (!node) {\n return node;\n }\n\n var nodeTypeIndex = node.typeIndex;\n if (!nodeTypeIndex) {\n return node;\n }\n\n var visitFnCache = this._visitFnCache,\n impl = this._implementation,\n aryIndx = nodeTypeIndex << 1,\n outAryIndex = aryIndx | 1,\n func = visitFnCache[aryIndx],\n funcOut = visitFnCache[outAryIndex],\n visitArgs = _visitArgs,\n fnName;\n\n visitArgs.visitDeeper = true;\n\n if (!func) {\n fnName = \"visit\" + node.type;\n func = impl[fnName] || _noop;\n funcOut = impl[fnName + \"Out\"] || _noop;\n visitFnCache[aryIndx] = func;\n visitFnCache[outAryIndex] = funcOut;\n }\n\n if (func !== _noop) {\n var newNode = func.call(impl, node, visitArgs);\n if (impl.isReplacing) {\n node = newNode;\n }\n }\n\n if (visitArgs.visitDeeper && node && node.accept) {\n node.accept(this);\n }\n\n if (funcOut != _noop) {\n funcOut.call(impl, node);\n }\n\n return node;\n },\n visitArray: function(nodes, nonReplacing) {\n if (!nodes) {\n return nodes;\n }\n\n var cnt = nodes.length, i;\n\n // Non-replacing\n if (nonReplacing || !this._implementation.isReplacing) {\n for (i = 0; i < cnt; i++) {\n this.visit(nodes[i]);\n }\n return nodes;\n }\n\n // Replacing\n var out = [];\n for (i = 0; i < cnt; i++) {\n var evald = this.visit(nodes[i]);\n if (!evald.splice) {\n out.push(evald);\n } else if (evald.length) {\n this.flatten(evald, out);\n }\n }\n return out;\n },\n flatten: function(arr, out) {\n if (!out) {\n out = [];\n }\n\n var cnt, i, item,\n nestedCnt, j, nestedItem;\n\n for (i = 0, cnt = arr.length; i < cnt; i++) {\n item = arr[i];\n if (!item.splice) {\n out.push(item);\n continue;\n }\n\n for (j = 0, nestedCnt = item.length; j < nestedCnt; j++) {\n nestedItem = item[j];\n if (!nestedItem.splice) {\n out.push(nestedItem);\n } else if (nestedItem.length) {\n this.flatten(nestedItem, out);\n }\n }\n }\n\n return out;\n }\n };\n\n})(require('./tree'));\n(function (tree) {\n tree.importVisitor = function(importer, finish, evalEnv, onceFileDetectionMap, recursionDetector) {\n this._visitor = new tree.visitor(this);\n this._importer = importer;\n this._finish = finish;\n this.env = evalEnv || new tree.evalEnv();\n this.importCount = 0;\n this.onceFileDetectionMap = onceFileDetectionMap || {};\n this.recursionDetector = {};\n if (recursionDetector) {\n for(var fullFilename in recursionDetector) {\n if (recursionDetector.hasOwnProperty(fullFilename)) {\n this.recursionDetector[fullFilename] = true;\n }\n }\n }\n };\n\n tree.importVisitor.prototype = {\n isReplacing: true,\n run: function (root) {\n var error;\n try {\n // process the contents\n this._visitor.visit(root);\n }\n catch(e) {\n error = e;\n }\n\n this.isFinished = true;\n\n if (this.importCount === 0) {\n this._finish(error);\n }\n },\n visitImport: function (importNode, visitArgs) {\n var importVisitor = this,\n evaldImportNode,\n inlineCSS = importNode.options.inline;\n \n if (!importNode.css || inlineCSS) {\n\n try {\n evaldImportNode = importNode.evalForImport(this.env);\n } catch(e){\n if (!e.filename) { e.index = importNode.index; e.filename = importNode.currentFileInfo.filename; }\n // attempt to eval properly and treat as css\n importNode.css = true;\n // if that fails, this error will be thrown\n importNode.error = e;\n }\n\n if (evaldImportNode && (!evaldImportNode.css || inlineCSS)) {\n importNode = evaldImportNode;\n this.importCount++;\n var env = new tree.evalEnv(this.env, this.env.frames.slice(0));\n\n if (importNode.options.multiple) {\n env.importMultiple = true;\n }\n\n this._importer.push(importNode.getPath(), importNode.currentFileInfo, importNode.options, function (e, root, importedAtRoot, fullPath) {\n if (e && !e.filename) { e.index = importNode.index; e.filename = importNode.currentFileInfo.filename; }\n\n if (!env.importMultiple) { \n if (importedAtRoot) {\n importNode.skip = true;\n } else {\n importNode.skip = function() {\n if (fullPath in importVisitor.onceFileDetectionMap) {\n return true;\n }\n importVisitor.onceFileDetectionMap[fullPath] = true;\n return false;\n }; \n }\n }\n\n var subFinish = function(e) {\n importVisitor.importCount--;\n\n if (importVisitor.importCount === 0 && importVisitor.isFinished) {\n importVisitor._finish(e);\n }\n };\n\n if (root) {\n importNode.root = root;\n importNode.importedFilename = fullPath;\n var duplicateImport = importedAtRoot || fullPath in importVisitor.recursionDetector;\n\n if (!inlineCSS && (env.importMultiple || !duplicateImport)) {\n importVisitor.recursionDetector[fullPath] = true;\n new(tree.importVisitor)(importVisitor._importer, subFinish, env, importVisitor.onceFileDetectionMap, importVisitor.recursionDetector)\n .run(root);\n return;\n }\n }\n\n subFinish();\n });\n }\n }\n visitArgs.visitDeeper = false;\n return importNode;\n },\n visitRule: function (ruleNode, visitArgs) {\n visitArgs.visitDeeper = false;\n return ruleNode;\n },\n visitDirective: function (directiveNode, visitArgs) {\n this.env.frames.unshift(directiveNode);\n return directiveNode;\n },\n visitDirectiveOut: function (directiveNode) {\n this.env.frames.shift();\n },\n visitMixinDefinition: function (mixinDefinitionNode, visitArgs) {\n this.env.frames.unshift(mixinDefinitionNode);\n return mixinDefinitionNode;\n },\n visitMixinDefinitionOut: function (mixinDefinitionNode) {\n this.env.frames.shift();\n },\n visitRuleset: function (rulesetNode, visitArgs) {\n this.env.frames.unshift(rulesetNode);\n return rulesetNode;\n },\n visitRulesetOut: function (rulesetNode) {\n this.env.frames.shift();\n },\n visitMedia: function (mediaNode, visitArgs) {\n this.env.frames.unshift(mediaNode.ruleset);\n return mediaNode;\n },\n visitMediaOut: function (mediaNode) {\n this.env.frames.shift();\n }\n };\n\n})(require('./tree'));\n(function (tree) {\n tree.joinSelectorVisitor = function() {\n this.contexts = [[]];\n this._visitor = new tree.visitor(this);\n };\n\n tree.joinSelectorVisitor.prototype = {\n run: function (root) {\n return this._visitor.visit(root);\n },\n visitRule: function (ruleNode, visitArgs) {\n visitArgs.visitDeeper = false;\n },\n visitMixinDefinition: function (mixinDefinitionNode, visitArgs) {\n visitArgs.visitDeeper = false;\n },\n\n visitRuleset: function (rulesetNode, visitArgs) {\n var context = this.contexts[this.contexts.length - 1],\n paths = [], selectors;\n\n this.contexts.push(paths);\n\n if (! rulesetNode.root) {\n selectors = rulesetNode.selectors;\n if (selectors) {\n selectors = selectors.filter(function(selector) { return selector.getIsOutput(); });\n rulesetNode.selectors = selectors.length ? selectors : (selectors = null);\n if (selectors) { rulesetNode.joinSelectors(paths, context, selectors); }\n }\n if (!selectors) { rulesetNode.rules = null; }\n rulesetNode.paths = paths;\n }\n },\n visitRulesetOut: function (rulesetNode) {\n this.contexts.length = this.contexts.length - 1;\n },\n visitMedia: function (mediaNode, visitArgs) {\n var context = this.contexts[this.contexts.length - 1];\n mediaNode.rules[0].root = (context.length === 0 || context[0].multiMedia);\n }\n };\n\n})(require('./tree'));\n(function (tree) {\n tree.toCSSVisitor = function(env) {\n this._visitor = new tree.visitor(this);\n this._env = env;\n };\n\n tree.toCSSVisitor.prototype = {\n isReplacing: true,\n run: function (root) {\n return this._visitor.visit(root);\n },\n\n visitRule: function (ruleNode, visitArgs) {\n if (ruleNode.variable) {\n return [];\n }\n return ruleNode;\n },\n\n visitMixinDefinition: function (mixinNode, visitArgs) {\n // mixin definitions do not get eval'd - this means they keep state\n // so we have to clear that state here so it isn't used if toCSS is called twice\n mixinNode.frames = [];\n return [];\n },\n\n visitExtend: function (extendNode, visitArgs) {\n return [];\n },\n\n visitComment: function (commentNode, visitArgs) {\n if (commentNode.isSilent(this._env)) {\n return [];\n }\n return commentNode;\n },\n\n visitMedia: function(mediaNode, visitArgs) {\n mediaNode.accept(this._visitor);\n visitArgs.visitDeeper = false;\n\n if (!mediaNode.rules.length) {\n return [];\n }\n return mediaNode;\n },\n\n visitDirective: function(directiveNode, visitArgs) {\n if (directiveNode.currentFileInfo.reference && !directiveNode.isReferenced) {\n return [];\n }\n if (directiveNode.name === \"@charset\") {\n // Only output the debug info together with subsequent @charset definitions\n // a comment (or @media statement) before the actual @charset directive would\n // be considered illegal css as it has to be on the first line\n if (this.charset) {\n if (directiveNode.debugInfo) {\n var comment = new tree.Comment(\"/* \" + directiveNode.toCSS(this._env).replace(/\\n/g, \"\")+\" */\\n\");\n comment.debugInfo = directiveNode.debugInfo;\n return this._visitor.visit(comment);\n }\n return [];\n }\n this.charset = true;\n }\n return directiveNode;\n },\n\n checkPropertiesInRoot: function(rules) {\n var ruleNode;\n for(var i = 0; i < rules.length; i++) {\n ruleNode = rules[i];\n if (ruleNode instanceof tree.Rule && !ruleNode.variable) {\n throw { message: \"properties must be inside selector blocks, they cannot be in the root.\",\n index: ruleNode.index, filename: ruleNode.currentFileInfo ? ruleNode.currentFileInfo.filename : null};\n }\n }\n },\n\n visitRuleset: function (rulesetNode, visitArgs) {\n var rule, rulesets = [];\n if (rulesetNode.firstRoot) {\n this.checkPropertiesInRoot(rulesetNode.rules);\n }\n if (! rulesetNode.root) {\n if (rulesetNode.paths) {\n rulesetNode.paths = rulesetNode.paths\n .filter(function(p) {\n var i;\n if (p[0].elements[0].combinator.value === ' ') {\n p[0].elements[0].combinator = new(tree.Combinator)('');\n }\n for(i = 0; i < p.length; i++) {\n if (p[i].getIsReferenced() && p[i].getIsOutput()) {\n return true;\n }\n }\n return false;\n });\n }\n\n // Compile rules and rulesets\n var nodeRules = rulesetNode.rules, nodeRuleCnt = nodeRules ? nodeRules.length : 0;\n for (var i = 0; i < nodeRuleCnt; ) {\n rule = nodeRules[i];\n if (rule && rule.rules) {\n // visit because we are moving them out from being a child\n rulesets.push(this._visitor.visit(rule));\n nodeRules.splice(i, 1);\n nodeRuleCnt--;\n continue;\n }\n i++;\n }\n // accept the visitor to remove rules and refactor itself\n // then we can decide now whether we want it or not\n if (nodeRuleCnt > 0) {\n rulesetNode.accept(this._visitor);\n } else {\n rulesetNode.rules = null;\n }\n visitArgs.visitDeeper = false;\n\n nodeRules = rulesetNode.rules;\n if (nodeRules) {\n this._mergeRules(nodeRules);\n nodeRules = rulesetNode.rules;\n }\n if (nodeRules) {\n this._removeDuplicateRules(nodeRules);\n nodeRules = rulesetNode.rules;\n }\n\n // now decide whether we keep the ruleset\n if (nodeRules && nodeRules.length > 0 && rulesetNode.paths.length > 0) {\n rulesets.splice(0, 0, rulesetNode);\n }\n } else {\n rulesetNode.accept(this._visitor);\n visitArgs.visitDeeper = false;\n if (rulesetNode.firstRoot || (rulesetNode.rules && rulesetNode.rules.length > 0)) {\n rulesets.splice(0, 0, rulesetNode);\n }\n }\n if (rulesets.length === 1) {\n return rulesets[0];\n }\n return rulesets;\n },\n\n _removeDuplicateRules: function(rules) {\n if (!rules) { return; }\n\n // remove duplicates\n var ruleCache = {},\n ruleList, rule, i;\n\n for(i = rules.length - 1; i >= 0 ; i--) {\n rule = rules[i];\n if (rule instanceof tree.Rule) {\n if (!ruleCache[rule.name]) {\n ruleCache[rule.name] = rule;\n } else {\n ruleList = ruleCache[rule.name];\n if (ruleList instanceof tree.Rule) {\n ruleList = ruleCache[rule.name] = [ruleCache[rule.name].toCSS(this._env)];\n }\n var ruleCSS = rule.toCSS(this._env);\n if (ruleList.indexOf(ruleCSS) !== -1) {\n rules.splice(i, 1);\n } else {\n ruleList.push(ruleCSS);\n }\n }\n }\n }\n },\n\n _mergeRules: function (rules) {\n if (!rules) { return; }\n\n var groups = {},\n parts,\n rule,\n key;\n\n for (var i = 0; i < rules.length; i++) {\n rule = rules[i];\n\n if ((rule instanceof tree.Rule) && rule.merge) {\n key = [rule.name,\n rule.important ? \"!\" : \"\"].join(\",\");\n\n if (!groups[key]) {\n groups[key] = [];\n } else {\n rules.splice(i--, 1);\n }\n\n groups[key].push(rule);\n }\n }\n\n Object.keys(groups).map(function (k) {\n\n function toExpression(values) {\n return new (tree.Expression)(values.map(function (p) {\n return p.value;\n }));\n }\n\n function toValue(values) {\n return new (tree.Value)(values.map(function (p) {\n return p;\n }));\n }\n\n parts = groups[k];\n\n if (parts.length > 1) {\n rule = parts[0];\n var spacedGroups = [];\n var lastSpacedGroup = [];\n parts.map(function (p) {\n if (p.merge===\"+\") {\n if (lastSpacedGroup.length > 0) {\n spacedGroups.push(toExpression(lastSpacedGroup));\n }\n lastSpacedGroup = [];\n }\n lastSpacedGroup.push(p);\n });\n spacedGroups.push(toExpression(lastSpacedGroup));\n rule.value = toValue(spacedGroups);\n }\n });\n }\n };\n\n})(require('./tree'));\n(function (tree) {\n /*jshint loopfunc:true */\n\n tree.extendFinderVisitor = function() {\n this._visitor = new tree.visitor(this);\n this.contexts = [];\n this.allExtendsStack = [[]];\n };\n\n tree.extendFinderVisitor.prototype = {\n run: function (root) {\n root = this._visitor.visit(root);\n root.allExtends = this.allExtendsStack[0];\n return root;\n },\n visitRule: function (ruleNode, visitArgs) {\n visitArgs.visitDeeper = false;\n },\n visitMixinDefinition: function (mixinDefinitionNode, visitArgs) {\n visitArgs.visitDeeper = false;\n },\n visitRuleset: function (rulesetNode, visitArgs) {\n if (rulesetNode.root) {\n return;\n }\n\n var i, j, extend, allSelectorsExtendList = [], extendList;\n\n // get &:extend(.a); rules which apply to all selectors in this ruleset\n var rules = rulesetNode.rules, ruleCnt = rules ? rules.length : 0;\n for(i = 0; i < ruleCnt; i++) {\n if (rulesetNode.rules[i] instanceof tree.Extend) {\n allSelectorsExtendList.push(rules[i]);\n rulesetNode.extendOnEveryPath = true;\n }\n }\n\n // now find every selector and apply the extends that apply to all extends\n // and the ones which apply to an individual extend\n var paths = rulesetNode.paths;\n for(i = 0; i < paths.length; i++) {\n var selectorPath = paths[i],\n selector = selectorPath[selectorPath.length - 1],\n selExtendList = selector.extendList;\n\n extendList = selExtendList ? selExtendList.slice(0).concat(allSelectorsExtendList)\n : allSelectorsExtendList;\n\n if (extendList) {\n extendList = extendList.map(function(allSelectorsExtend) {\n return allSelectorsExtend.clone();\n });\n }\n\n for(j = 0; j < extendList.length; j++) {\n this.foundExtends = true;\n extend = extendList[j];\n extend.findSelfSelectors(selectorPath);\n extend.ruleset = rulesetNode;\n if (j === 0) { extend.firstExtendOnThisSelectorPath = true; }\n this.allExtendsStack[this.allExtendsStack.length-1].push(extend);\n }\n }\n\n this.contexts.push(rulesetNode.selectors);\n },\n visitRulesetOut: function (rulesetNode) {\n if (!rulesetNode.root) {\n this.contexts.length = this.contexts.length - 1;\n }\n },\n visitMedia: function (mediaNode, visitArgs) {\n mediaNode.allExtends = [];\n this.allExtendsStack.push(mediaNode.allExtends);\n },\n visitMediaOut: function (mediaNode) {\n this.allExtendsStack.length = this.allExtendsStack.length - 1;\n },\n visitDirective: function (directiveNode, visitArgs) {\n directiveNode.allExtends = [];\n this.allExtendsStack.push(directiveNode.allExtends);\n },\n visitDirectiveOut: function (directiveNode) {\n this.allExtendsStack.length = this.allExtendsStack.length - 1;\n }\n };\n\n tree.processExtendsVisitor = function() {\n this._visitor = new tree.visitor(this);\n };\n\n tree.processExtendsVisitor.prototype = {\n run: function(root) {\n var extendFinder = new tree.extendFinderVisitor();\n extendFinder.run(root);\n if (!extendFinder.foundExtends) { return root; }\n root.allExtends = root.allExtends.concat(this.doExtendChaining(root.allExtends, root.allExtends));\n this.allExtendsStack = [root.allExtends];\n return this._visitor.visit(root);\n },\n doExtendChaining: function (extendsList, extendsListTarget, iterationCount) {\n //\n // chaining is different from normal extension.. if we extend an extend then we are not just copying, altering and pasting\n // the selector we would do normally, but we are also adding an extend with the same target selector\n // this means this new extend can then go and alter other extends\n //\n // this method deals with all the chaining work - without it, extend is flat and doesn't work on other extend selectors\n // this is also the most expensive.. and a match on one selector can cause an extension of a selector we had already processed if\n // we look at each selector at a time, as is done in visitRuleset\n\n var extendIndex, targetExtendIndex, matches, extendsToAdd = [], newSelector, extendVisitor = this, selectorPath, extend, targetExtend, newExtend;\n\n iterationCount = iterationCount || 0;\n\n //loop through comparing every extend with every target extend.\n // a target extend is the one on the ruleset we are looking at copy/edit/pasting in place\n // e.g. .a:extend(.b) {} and .b:extend(.c) {} then the first extend extends the second one\n // and the second is the target.\n // the seperation into two lists allows us to process a subset of chains with a bigger set, as is the\n // case when processing media queries\n for(extendIndex = 0; extendIndex < extendsList.length; extendIndex++){\n for(targetExtendIndex = 0; targetExtendIndex < extendsListTarget.length; targetExtendIndex++){\n\n extend = extendsList[extendIndex];\n targetExtend = extendsListTarget[targetExtendIndex];\n\n // look for circular references\n if( extend.parent_ids.indexOf( targetExtend.object_id ) >= 0 ){ continue; }\n\n // find a match in the target extends self selector (the bit before :extend)\n selectorPath = [targetExtend.selfSelectors[0]];\n matches = extendVisitor.findMatch(extend, selectorPath);\n\n if (matches.length) {\n\n // we found a match, so for each self selector..\n extend.selfSelectors.forEach(function(selfSelector) {\n\n // process the extend as usual\n newSelector = extendVisitor.extendSelector(matches, selectorPath, selfSelector);\n\n // but now we create a new extend from it\n newExtend = new(tree.Extend)(targetExtend.selector, targetExtend.option, 0);\n newExtend.selfSelectors = newSelector;\n\n // add the extend onto the list of extends for that selector\n newSelector[newSelector.length-1].extendList = [newExtend];\n\n // record that we need to add it.\n extendsToAdd.push(newExtend);\n newExtend.ruleset = targetExtend.ruleset;\n\n //remember its parents for circular references\n newExtend.parent_ids = newExtend.parent_ids.concat(targetExtend.parent_ids, extend.parent_ids);\n\n // only process the selector once.. if we have :extend(.a,.b) then multiple\n // extends will look at the same selector path, so when extending\n // we know that any others will be duplicates in terms of what is added to the css\n if (targetExtend.firstExtendOnThisSelectorPath) {\n newExtend.firstExtendOnThisSelectorPath = true;\n targetExtend.ruleset.paths.push(newSelector);\n }\n });\n }\n }\n }\n\n if (extendsToAdd.length) {\n // try to detect circular references to stop a stack overflow.\n // may no longer be needed.\n this.extendChainCount++;\n if (iterationCount > 100) {\n var selectorOne = \"{unable to calculate}\";\n var selectorTwo = \"{unable to calculate}\";\n try\n {\n selectorOne = extendsToAdd[0].selfSelectors[0].toCSS();\n selectorTwo = extendsToAdd[0].selector.toCSS();\n }\n catch(e) {}\n throw {message: \"extend circular reference detected. One of the circular extends is currently:\"+selectorOne+\":extend(\" + selectorTwo+\")\"};\n }\n\n // now process the new extends on the existing rules so that we can handle a extending b extending c ectending d extending e...\n return extendsToAdd.concat(extendVisitor.doExtendChaining(extendsToAdd, extendsListTarget, iterationCount+1));\n } else {\n return extendsToAdd;\n }\n },\n visitRule: function (ruleNode, visitArgs) {\n visitArgs.visitDeeper = false;\n },\n visitMixinDefinition: function (mixinDefinitionNode, visitArgs) {\n visitArgs.visitDeeper = false;\n },\n visitSelector: function (selectorNode, visitArgs) {\n visitArgs.visitDeeper = false;\n },\n visitRuleset: function (rulesetNode, visitArgs) {\n if (rulesetNode.root) {\n return;\n }\n var matches, pathIndex, extendIndex, allExtends = this.allExtendsStack[this.allExtendsStack.length-1], selectorsToAdd = [], extendVisitor = this, selectorPath;\n\n // look at each selector path in the ruleset, find any extend matches and then copy, find and replace\n\n for(extendIndex = 0; extendIndex < allExtends.length; extendIndex++) {\n for(pathIndex = 0; pathIndex < rulesetNode.paths.length; pathIndex++) {\n selectorPath = rulesetNode.paths[pathIndex];\n\n // extending extends happens initially, before the main pass\n if (rulesetNode.extendOnEveryPath) { continue; }\n var extendList = selectorPath[selectorPath.length-1].extendList;\n if (extendList && extendList.length) { continue; }\n\n matches = this.findMatch(allExtends[extendIndex], selectorPath);\n\n if (matches.length) {\n\n allExtends[extendIndex].selfSelectors.forEach(function(selfSelector) {\n selectorsToAdd.push(extendVisitor.extendSelector(matches, selectorPath, selfSelector));\n });\n }\n }\n }\n rulesetNode.paths = rulesetNode.paths.concat(selectorsToAdd);\n },\n findMatch: function (extend, haystackSelectorPath) {\n //\n // look through the haystack selector path to try and find the needle - extend.selector\n // returns an array of selector matches that can then be replaced\n //\n var haystackSelectorIndex, hackstackSelector, hackstackElementIndex, haystackElement,\n targetCombinator, i,\n extendVisitor = this,\n needleElements = extend.selector.elements,\n potentialMatches = [], potentialMatch, matches = [];\n\n // loop through the haystack elements\n for(haystackSelectorIndex = 0; haystackSelectorIndex < haystackSelectorPath.length; haystackSelectorIndex++) {\n hackstackSelector = haystackSelectorPath[haystackSelectorIndex];\n\n for(hackstackElementIndex = 0; hackstackElementIndex < hackstackSelector.elements.length; hackstackElementIndex++) {\n\n haystackElement = hackstackSelector.elements[hackstackElementIndex];\n\n // if we allow elements before our match we can add a potential match every time. otherwise only at the first element.\n if (extend.allowBefore || (haystackSelectorIndex === 0 && hackstackElementIndex === 0)) {\n potentialMatches.push({pathIndex: haystackSelectorIndex, index: hackstackElementIndex, matched: 0, initialCombinator: haystackElement.combinator});\n }\n\n for(i = 0; i < potentialMatches.length; i++) {\n potentialMatch = potentialMatches[i];\n\n // selectors add \" \" onto the first element. When we use & it joins the selectors together, but if we don't\n // then each selector in haystackSelectorPath has a space before it added in the toCSS phase. so we need to work out\n // what the resulting combinator will be\n targetCombinator = haystackElement.combinator.value;\n if (targetCombinator === '' && hackstackElementIndex === 0) {\n targetCombinator = ' ';\n }\n\n // if we don't match, null our match to indicate failure\n if (!extendVisitor.isElementValuesEqual(needleElements[potentialMatch.matched].value, haystackElement.value) ||\n (potentialMatch.matched > 0 && needleElements[potentialMatch.matched].combinator.value !== targetCombinator)) {\n potentialMatch = null;\n } else {\n potentialMatch.matched++;\n }\n\n // if we are still valid and have finished, test whether we have elements after and whether these are allowed\n if (potentialMatch) {\n potentialMatch.finished = potentialMatch.matched === needleElements.length;\n if (potentialMatch.finished &&\n (!extend.allowAfter && (hackstackElementIndex+1 < hackstackSelector.elements.length || haystackSelectorIndex+1 < haystackSelectorPath.length))) {\n potentialMatch = null;\n }\n }\n // if null we remove, if not, we are still valid, so either push as a valid match or continue\n if (potentialMatch) {\n if (potentialMatch.finished) {\n potentialMatch.length = needleElements.length;\n potentialMatch.endPathIndex = haystackSelectorIndex;\n potentialMatch.endPathElementIndex = hackstackElementIndex + 1; // index after end of match\n potentialMatches.length = 0; // we don't allow matches to overlap, so start matching again\n matches.push(potentialMatch);\n }\n } else {\n potentialMatches.splice(i, 1);\n i--;\n }\n }\n }\n }\n return matches;\n },\n isElementValuesEqual: function(elementValue1, elementValue2) {\n if (typeof elementValue1 === \"string\" || typeof elementValue2 === \"string\") {\n return elementValue1 === elementValue2;\n }\n if (elementValue1 instanceof tree.Attribute) {\n if (elementValue1.op !== elementValue2.op || elementValue1.key !== elementValue2.key) {\n return false;\n }\n if (!elementValue1.value || !elementValue2.value) {\n if (elementValue1.value || elementValue2.value) {\n return false;\n }\n return true;\n }\n elementValue1 = elementValue1.value.value || elementValue1.value;\n elementValue2 = elementValue2.value.value || elementValue2.value;\n return elementValue1 === elementValue2;\n }\n elementValue1 = elementValue1.value;\n elementValue2 = elementValue2.value;\n if (elementValue1 instanceof tree.Selector) {\n if (!(elementValue2 instanceof tree.Selector) || elementValue1.elements.length !== elementValue2.elements.length) {\n return false;\n }\n for(var i = 0; i currentSelectorPathIndex && currentSelectorPathElementIndex > 0) {\n path[path.length - 1].elements = path[path.length - 1].elements.concat(selectorPath[currentSelectorPathIndex].elements.slice(currentSelectorPathElementIndex));\n currentSelectorPathElementIndex = 0;\n currentSelectorPathIndex++;\n }\n\n newElements = selector.elements\n .slice(currentSelectorPathElementIndex, match.index)\n .concat([firstElement])\n .concat(replacementSelector.elements.slice(1));\n\n if (currentSelectorPathIndex === match.pathIndex && matchIndex > 0) {\n path[path.length - 1].elements =\n path[path.length - 1].elements.concat(newElements);\n } else {\n path = path.concat(selectorPath.slice(currentSelectorPathIndex, match.pathIndex));\n\n path.push(new tree.Selector(\n newElements\n ));\n }\n currentSelectorPathIndex = match.endPathIndex;\n currentSelectorPathElementIndex = match.endPathElementIndex;\n if (currentSelectorPathElementIndex >= selectorPath[currentSelectorPathIndex].elements.length) {\n currentSelectorPathElementIndex = 0;\n currentSelectorPathIndex++;\n }\n }\n\n if (currentSelectorPathIndex < selectorPath.length && currentSelectorPathElementIndex > 0) {\n path[path.length - 1].elements = path[path.length - 1].elements.concat(selectorPath[currentSelectorPathIndex].elements.slice(currentSelectorPathElementIndex));\n currentSelectorPathIndex++;\n }\n\n path = path.concat(selectorPath.slice(currentSelectorPathIndex, selectorPath.length));\n\n return path;\n },\n visitRulesetOut: function (rulesetNode) {\n },\n visitMedia: function (mediaNode, visitArgs) {\n var newAllExtends = mediaNode.allExtends.concat(this.allExtendsStack[this.allExtendsStack.length-1]);\n newAllExtends = newAllExtends.concat(this.doExtendChaining(newAllExtends, mediaNode.allExtends));\n this.allExtendsStack.push(newAllExtends);\n },\n visitMediaOut: function (mediaNode) {\n this.allExtendsStack.length = this.allExtendsStack.length - 1;\n },\n visitDirective: function (directiveNode, visitArgs) {\n var newAllExtends = directiveNode.allExtends.concat(this.allExtendsStack[this.allExtendsStack.length-1]);\n newAllExtends = newAllExtends.concat(this.doExtendChaining(newAllExtends, directiveNode.allExtends));\n this.allExtendsStack.push(newAllExtends);\n },\n visitDirectiveOut: function (directiveNode) {\n this.allExtendsStack.length = this.allExtendsStack.length - 1;\n }\n };\n\n})(require('./tree'));\n\n(function (tree) {\n\n tree.sourceMapOutput = function (options) {\n this._css = [];\n this._rootNode = options.rootNode;\n this._writeSourceMap = options.writeSourceMap;\n this._contentsMap = options.contentsMap;\n this._contentsIgnoredCharsMap = options.contentsIgnoredCharsMap;\n this._sourceMapFilename = options.sourceMapFilename;\n this._outputFilename = options.outputFilename;\n this._sourceMapURL = options.sourceMapURL;\n if (options.sourceMapBasepath) {\n this._sourceMapBasepath = options.sourceMapBasepath.replace(/\\\\/g, '/');\n }\n this._sourceMapRootpath = options.sourceMapRootpath;\n this._outputSourceFiles = options.outputSourceFiles;\n this._sourceMapGeneratorConstructor = options.sourceMapGenerator || require(\"source-map\").SourceMapGenerator;\n\n if (this._sourceMapRootpath && this._sourceMapRootpath.charAt(this._sourceMapRootpath.length-1) !== '/') {\n this._sourceMapRootpath += '/';\n }\n\n this._lineNumber = 0;\n this._column = 0;\n };\n\n tree.sourceMapOutput.prototype.normalizeFilename = function(filename) {\n filename = filename.replace(/\\\\/g, '/');\n\n if (this._sourceMapBasepath && filename.indexOf(this._sourceMapBasepath) === 0) {\n filename = filename.substring(this._sourceMapBasepath.length);\n if (filename.charAt(0) === '\\\\' || filename.charAt(0) === '/') {\n filename = filename.substring(1);\n }\n }\n return (this._sourceMapRootpath || \"\") + filename;\n };\n\n tree.sourceMapOutput.prototype.add = function(chunk, fileInfo, index, mapLines) {\n\n //ignore adding empty strings\n if (!chunk) {\n return;\n }\n\n var lines,\n sourceLines,\n columns,\n sourceColumns,\n i;\n\n if (fileInfo) {\n var inputSource = this._contentsMap[fileInfo.filename];\n \n // remove vars/banner added to the top of the file\n if (this._contentsIgnoredCharsMap[fileInfo.filename]) {\n // adjust the index\n index -= this._contentsIgnoredCharsMap[fileInfo.filename];\n if (index < 0) { index = 0; }\n // adjust the source\n inputSource = inputSource.slice(this._contentsIgnoredCharsMap[fileInfo.filename]);\n }\n inputSource = inputSource.substring(0, index);\n sourceLines = inputSource.split(\"\\n\");\n sourceColumns = sourceLines[sourceLines.length-1];\n }\n\n lines = chunk.split(\"\\n\");\n columns = lines[lines.length-1];\n\n if (fileInfo) {\n if (!mapLines) {\n this._sourceMapGenerator.addMapping({ generated: { line: this._lineNumber + 1, column: this._column},\n original: { line: sourceLines.length, column: sourceColumns.length},\n source: this.normalizeFilename(fileInfo.filename)});\n } else {\n for(i = 0; i < lines.length; i++) {\n this._sourceMapGenerator.addMapping({ generated: { line: this._lineNumber + i + 1, column: i === 0 ? this._column : 0},\n original: { line: sourceLines.length + i, column: i === 0 ? sourceColumns.length : 0},\n source: this.normalizeFilename(fileInfo.filename)});\n }\n }\n }\n\n if (lines.length === 1) {\n this._column += columns.length;\n } else {\n this._lineNumber += lines.length - 1;\n this._column = columns.length;\n }\n\n this._css.push(chunk);\n };\n\n tree.sourceMapOutput.prototype.isEmpty = function() {\n return this._css.length === 0;\n };\n\n tree.sourceMapOutput.prototype.toCSS = function(env) {\n this._sourceMapGenerator = new this._sourceMapGeneratorConstructor({ file: this._outputFilename, sourceRoot: null });\n\n if (this._outputSourceFiles) {\n for(var filename in this._contentsMap) {\n if (this._contentsMap.hasOwnProperty(filename))\n {\n var source = this._contentsMap[filename];\n if (this._contentsIgnoredCharsMap[filename]) {\n source = source.slice(this._contentsIgnoredCharsMap[filename]);\n }\n this._sourceMapGenerator.setSourceContent(this.normalizeFilename(filename), source);\n }\n }\n }\n\n this._rootNode.genCSS(env, this);\n\n if (this._css.length > 0) {\n var sourceMapURL,\n sourceMapContent = JSON.stringify(this._sourceMapGenerator.toJSON());\n\n if (this._sourceMapURL) {\n sourceMapURL = this._sourceMapURL;\n } else if (this._sourceMapFilename) {\n sourceMapURL = this.normalizeFilename(this._sourceMapFilename);\n }\n\n if (this._writeSourceMap) {\n this._writeSourceMap(sourceMapContent);\n } else {\n sourceMapURL = \"data:application/json,\" + encodeURIComponent(sourceMapContent);\n }\n\n if (sourceMapURL) {\n this._css.push(\"/*# sourceMappingURL=\" + sourceMapURL + \" */\");\n }\n }\n\n return this._css.join('');\n };\n\n})(require('./tree'));\n\n//\n// browser.js - client-side engine\n//\n/*global less, window, document, XMLHttpRequest, location */\n\nvar isFileProtocol = /^(file|chrome(-extension)?|resource|qrc|app):/.test(location.protocol);\n\nless.env = less.env || (location.hostname == '127.0.0.1' ||\n location.hostname == '0.0.0.0' ||\n location.hostname == 'localhost' ||\n (location.port &&\n location.port.length > 0) ||\n isFileProtocol ? 'development'\n : 'production');\n\nvar logLevel = {\n debug: 3,\n info: 2,\n errors: 1,\n none: 0\n};\n\n// The amount of logging in the javascript console.\n// 3 - Debug, information and errors\n// 2 - Information and errors\n// 1 - Errors\n// 0 - None\n// Defaults to 2\nless.logLevel = typeof(less.logLevel) != 'undefined' ? less.logLevel : (less.env === 'development' ? logLevel.debug : logLevel.errors);\n\n// Load styles asynchronously (default: false)\n//\n// This is set to `false` by default, so that the body\n// doesn't start loading before the stylesheets are parsed.\n// Setting this to `true` can result in flickering.\n//\nless.async = less.async || false;\nless.fileAsync = less.fileAsync || false;\n\n// Interval between watch polls\nless.poll = less.poll || (isFileProtocol ? 1000 : 1500);\n\n//Setup user functions\nif (less.functions) {\n for(var func in less.functions) {\n if (less.functions.hasOwnProperty(func)) {\n less.tree.functions[func] = less.functions[func];\n }\n }\n}\n\nvar dumpLineNumbers = /!dumpLineNumbers:(comments|mediaquery|all)/.exec(location.hash);\nif (dumpLineNumbers) {\n less.dumpLineNumbers = dumpLineNumbers[1];\n}\n\nvar typePattern = /^text\\/(x-)?less$/;\nvar cache = null;\nvar fileCache = {};\n\nfunction log(str, level) {\n if (typeof(console) !== 'undefined' && less.logLevel >= level) {\n console.log('less: ' + str);\n }\n}\n\nfunction extractId(href) {\n return href.replace(/^[a-z-]+:\\/+?[^\\/]+/, '' ) // Remove protocol & domain\n .replace(/^\\//, '' ) // Remove root /\n .replace(/\\.[a-zA-Z]+$/, '' ) // Remove simple extension\n .replace(/[^\\.\\w-]+/g, '-') // Replace illegal characters\n .replace(/\\./g, ':'); // Replace dots with colons(for valid id)\n}\n\nfunction errorConsole(e, rootHref) {\n var template = '{line} {content}';\n var filename = e.filename || rootHref;\n var errors = [];\n var content = (e.type || \"Syntax\") + \"Error: \" + (e.message || 'There is an error in your .less file') +\n \" in \" + filename + \" \";\n\n var errorline = function (e, i, classname) {\n if (e.extract[i] !== undefined) {\n errors.push(template.replace(/\\{line\\}/, (parseInt(e.line, 10) || 0) + (i - 1))\n .replace(/\\{class\\}/, classname)\n .replace(/\\{content\\}/, e.extract[i]));\n }\n };\n\n if (e.extract) {\n errorline(e, 0, '');\n errorline(e, 1, 'line');\n errorline(e, 2, '');\n content += 'on line ' + e.line + ', column ' + (e.column + 1) + ':\\n' +\n errors.join('\\n');\n } else if (e.stack) {\n content += e.stack;\n }\n log(content, logLevel.errors);\n}\n\nfunction createCSS(styles, sheet, lastModified) {\n // Strip the query-string\n var href = sheet.href || '';\n\n // If there is no title set, use the filename, minus the extension\n var id = 'less:' + (sheet.title || extractId(href));\n\n // If this has already been inserted into the DOM, we may need to replace it\n var oldCss = document.getElementById(id);\n var keepOldCss = false;\n\n // Create a new stylesheet node for insertion or (if necessary) replacement\n var css = document.createElement('style');\n css.setAttribute('type', 'text/css');\n if (sheet.media) {\n css.setAttribute('media', sheet.media);\n }\n css.id = id;\n\n if (css.styleSheet) { // IE\n try {\n css.styleSheet.cssText = styles;\n } catch (e) {\n throw new(Error)(\"Couldn't reassign styleSheet.cssText.\");\n }\n } else {\n css.appendChild(document.createTextNode(styles));\n\n // If new contents match contents of oldCss, don't replace oldCss\n keepOldCss = (oldCss !== null && oldCss.childNodes.length > 0 && css.childNodes.length > 0 &&\n oldCss.firstChild.nodeValue === css.firstChild.nodeValue);\n }\n\n var head = document.getElementsByTagName('head')[0];\n\n // If there is no oldCss, just append; otherwise, only append if we need\n // to replace oldCss with an updated stylesheet\n if (oldCss === null || keepOldCss === false) {\n var nextEl = sheet && sheet.nextSibling || null;\n if (nextEl) {\n nextEl.parentNode.insertBefore(css, nextEl);\n } else {\n head.appendChild(css);\n }\n }\n if (oldCss && keepOldCss === false) {\n oldCss.parentNode.removeChild(oldCss);\n }\n\n // Don't update the local store if the file wasn't modified\n if (lastModified && cache) {\n log('saving ' + href + ' to cache.', logLevel.info);\n try {\n cache.setItem(href, styles);\n cache.setItem(href + ':timestamp', lastModified);\n } catch(e) {\n //TODO - could do with adding more robust error handling\n log('failed to save', logLevel.errors);\n }\n }\n}\n\nfunction postProcessCSS(styles) {\n if (less.postProcessor && typeof less.postProcessor === 'function') {\n styles = less.postProcessor.call(styles, styles) || styles;\n }\n return styles;\n}\n\nfunction errorHTML(e, rootHref) {\n var id = 'less-error-message:' + extractId(rootHref || \"\");\n var template = '
  • {content}
    • ';\n var elem = document.createElement('div'), timer, content, errors = [];\n var filename = e.filename || rootHref;\n var filenameNoPath = filename.match(/([^\\/]+(\\?.*)?)$/)[1];\n\n elem.id = id;\n elem.className = \"less-error-message\";\n\n content = '

    ' + (e.type || \"Syntax\") + \"Error: \" + (e.message || 'There is an error in your .less file') +\n '

    ' + '

    in ' + filenameNoPath + \" \";\n\n var errorline = function (e, i, classname) {\n if (e.extract[i] !== undefined) {\n errors.push(template.replace(/\\{line\\}/, (parseInt(e.line, 10) || 0) + (i - 1))\n .replace(/\\{class\\}/, classname)\n .replace(/\\{content\\}/, e.extract[i]));\n }\n };\n\n if (e.extract) {\n errorline(e, 0, '');\n errorline(e, 1, 'line');\n errorline(e, 2, '');\n content += 'on line ' + e.line + ', column ' + (e.column + 1) + ':

    ' +\n '
      ' + errors.join('') + '
    ';\n } else if (e.stack) {\n content += '
    ' + e.stack.split('\\n').slice(1).join('
    ');\n }\n elem.innerHTML = content;\n\n // CSS for error messages\n createCSS([\n '.less-error-message ul, .less-error-message li {',\n 'list-style-type: none;',\n 'margin-right: 15px;',\n 'padding: 4px 0;',\n 'margin: 0;',\n '}',\n '.less-error-message label {',\n 'font-size: 12px;',\n 'margin-right: 15px;',\n 'padding: 4px 0;',\n 'color: #cc7777;',\n '}',\n '.less-error-message pre {',\n 'color: #dd6666;',\n 'padding: 4px 0;',\n 'margin: 0;',\n 'display: inline-block;',\n '}',\n '.less-error-message pre.line {',\n 'color: #ff0000;',\n '}',\n '.less-error-message h3 {',\n 'font-size: 20px;',\n 'font-weight: bold;',\n 'padding: 15px 0 5px 0;',\n 'margin: 0;',\n '}',\n '.less-error-message a {',\n 'color: #10a',\n '}',\n '.less-error-message .error {',\n 'color: red;',\n 'font-weight: bold;',\n 'padding-bottom: 2px;',\n 'border-bottom: 1px dashed red;',\n '}'\n ].join('\\n'), { title: 'error-message' });\n\n elem.style.cssText = [\n \"font-family: Arial, sans-serif\",\n \"border: 1px solid #e00\",\n \"background-color: #eee\",\n \"border-radius: 5px\",\n \"-webkit-border-radius: 5px\",\n \"-moz-border-radius: 5px\",\n \"color: #e00\",\n \"padding: 15px\",\n \"margin-bottom: 15px\"\n ].join(';');\n\n if (less.env == 'development') {\n timer = setInterval(function () {\n if (document.body) {\n if (document.getElementById(id)) {\n document.body.replaceChild(elem, document.getElementById(id));\n } else {\n document.body.insertBefore(elem, document.body.firstChild);\n }\n clearInterval(timer);\n }\n }, 10);\n }\n}\n\nfunction error(e, rootHref) {\n if (!less.errorReporting || less.errorReporting === \"html\") {\n errorHTML(e, rootHref);\n } else if (less.errorReporting === \"console\") {\n errorConsole(e, rootHref);\n } else if (typeof less.errorReporting === 'function') {\n less.errorReporting(\"add\", e, rootHref);\n }\n}\n\nfunction removeErrorHTML(path) {\n var node = document.getElementById('less-error-message:' + extractId(path));\n if (node) {\n node.parentNode.removeChild(node);\n }\n}\n\nfunction removeErrorConsole(path) {\n //no action\n}\n\nfunction removeError(path) {\n if (!less.errorReporting || less.errorReporting === \"html\") {\n removeErrorHTML(path);\n } else if (less.errorReporting === \"console\") {\n removeErrorConsole(path);\n } else if (typeof less.errorReporting === 'function') {\n less.errorReporting(\"remove\", path);\n }\n}\n\nfunction loadStyles(modifyVars) {\n var styles = document.getElementsByTagName('style'),\n style;\n for (var i = 0; i < styles.length; i++) {\n style = styles[i];\n if (style.type.match(typePattern)) {\n var env = new less.tree.parseEnv(less),\n lessText = style.innerHTML || '';\n env.filename = document.location.href.replace(/#.*$/, '');\n\n if (modifyVars || less.globalVars) {\n env.useFileCache = true;\n }\n\n /*jshint loopfunc:true */\n // use closure to store current value of i\n var callback = (function(style) {\n return function (e, cssAST) {\n if (e) {\n return error(e, \"inline\");\n }\n var css = cssAST.toCSS(less);\n style.type = 'text/css';\n if (style.styleSheet) {\n style.styleSheet.cssText = css;\n } else {\n style.innerHTML = css;\n }\n };\n })(style);\n new(less.Parser)(env).parse(lessText, callback, {globalVars: less.globalVars, modifyVars: modifyVars});\n }\n }\n}\n\nfunction extractUrlParts(url, baseUrl) {\n // urlParts[1] = protocol&hostname || /\n // urlParts[2] = / if path relative to host base\n // urlParts[3] = directories\n // urlParts[4] = filename\n // urlParts[5] = parameters\n\n var urlPartsRegex = /^((?:[a-z-]+:)?\\/+?(?:[^\\/\\?#]*\\/)|([\\/\\\\]))?((?:[^\\/\\\\\\?#]*[\\/\\\\])*)([^\\/\\\\\\?#]*)([#\\?].*)?$/i,\n urlParts = url.match(urlPartsRegex),\n returner = {}, directories = [], i, baseUrlParts;\n\n if (!urlParts) {\n throw new Error(\"Could not parse sheet href - '\"+url+\"'\");\n }\n\n // Stylesheets in IE don't always return the full path\n if (!urlParts[1] || urlParts[2]) {\n baseUrlParts = baseUrl.match(urlPartsRegex);\n if (!baseUrlParts) {\n throw new Error(\"Could not parse page url - '\"+baseUrl+\"'\");\n }\n urlParts[1] = urlParts[1] || baseUrlParts[1] || \"\";\n if (!urlParts[2]) {\n urlParts[3] = baseUrlParts[3] + urlParts[3];\n }\n }\n\n if (urlParts[3]) {\n directories = urlParts[3].replace(/\\\\/g, \"/\").split(\"/\");\n\n // extract out . before .. so .. doesn't absorb a non-directory\n for(i = 0; i < directories.length; i++) {\n if (directories[i] === \".\") {\n directories.splice(i, 1);\n i -= 1;\n }\n }\n\n for(i = 0; i < directories.length; i++) {\n if (directories[i] === \"..\" && i > 0) {\n directories.splice(i-1, 2);\n i -= 2;\n }\n }\n }\n\n returner.hostPart = urlParts[1];\n returner.directories = directories;\n returner.path = urlParts[1] + directories.join(\"/\");\n returner.fileUrl = returner.path + (urlParts[4] || \"\");\n returner.url = returner.fileUrl + (urlParts[5] || \"\");\n return returner;\n}\n\nfunction pathDiff(url, baseUrl) {\n // diff between two paths to create a relative path\n\n var urlParts = extractUrlParts(url),\n baseUrlParts = extractUrlParts(baseUrl),\n i, max, urlDirectories, baseUrlDirectories, diff = \"\";\n if (urlParts.hostPart !== baseUrlParts.hostPart) {\n return \"\";\n }\n max = Math.max(baseUrlParts.directories.length, urlParts.directories.length);\n for(i = 0; i < max; i++) {\n if (baseUrlParts.directories[i] !== urlParts.directories[i]) { break; }\n }\n baseUrlDirectories = baseUrlParts.directories.slice(i);\n urlDirectories = urlParts.directories.slice(i);\n for(i = 0; i < baseUrlDirectories.length-1; i++) {\n diff += \"../\";\n }\n for(i = 0; i < urlDirectories.length-1; i++) {\n diff += urlDirectories[i] + \"/\";\n }\n return diff;\n}\n\nfunction getXMLHttpRequest() {\n if (window.XMLHttpRequest && (window.location.protocol !== \"file:\" || !window.ActiveXObject)) {\n return new XMLHttpRequest();\n } else {\n try {\n /*global ActiveXObject */\n return new ActiveXObject(\"Microsoft.XMLHTTP\");\n } catch (e) {\n log(\"browser doesn't support AJAX.\", logLevel.errors);\n return null;\n }\n }\n}\n\nfunction doXHR(url, type, callback, errback) {\n var xhr = getXMLHttpRequest();\n var async = isFileProtocol ? less.fileAsync : less.async;\n\n if (typeof(xhr.overrideMimeType) === 'function') {\n xhr.overrideMimeType('text/css');\n }\n log(\"XHR: Getting '\" + url + \"'\", logLevel.debug);\n xhr.open('GET', url, async);\n xhr.setRequestHeader('Accept', type || 'text/x-less, text/css; q=0.9, */*; q=0.5');\n xhr.send(null);\n\n function handleResponse(xhr, callback, errback) {\n if (xhr.status >= 200 && xhr.status < 300) {\n callback(xhr.responseText,\n xhr.getResponseHeader(\"Last-Modified\"));\n } else if (typeof(errback) === 'function') {\n errback(xhr.status, url);\n }\n }\n\n if (isFileProtocol && !less.fileAsync) {\n if (xhr.status === 0 || (xhr.status >= 200 && xhr.status < 300)) {\n callback(xhr.responseText);\n } else {\n errback(xhr.status, url);\n }\n } else if (async) {\n xhr.onreadystatechange = function () {\n if (xhr.readyState == 4) {\n handleResponse(xhr, callback, errback);\n }\n };\n } else {\n handleResponse(xhr, callback, errback);\n }\n}\n\nfunction loadFile(originalHref, currentFileInfo, callback, env, modifyVars) {\n\n if (currentFileInfo && currentFileInfo.currentDirectory && !/^([a-z-]+:)?\\//.test(originalHref)) {\n originalHref = currentFileInfo.currentDirectory + originalHref;\n }\n\n // sheet may be set to the stylesheet for the initial load or a collection of properties including\n // some env variables for imports\n var hrefParts = extractUrlParts(originalHref, window.location.href);\n var href = hrefParts.url;\n var newFileInfo = {\n currentDirectory: hrefParts.path,\n filename: href\n };\n\n if (currentFileInfo) {\n newFileInfo.entryPath = currentFileInfo.entryPath;\n newFileInfo.rootpath = currentFileInfo.rootpath;\n newFileInfo.rootFilename = currentFileInfo.rootFilename;\n newFileInfo.relativeUrls = currentFileInfo.relativeUrls;\n } else {\n newFileInfo.entryPath = hrefParts.path;\n newFileInfo.rootpath = less.rootpath || hrefParts.path;\n newFileInfo.rootFilename = href;\n newFileInfo.relativeUrls = env.relativeUrls;\n }\n\n if (newFileInfo.relativeUrls) {\n if (env.rootpath) {\n newFileInfo.rootpath = extractUrlParts(env.rootpath + pathDiff(hrefParts.path, newFileInfo.entryPath)).path;\n } else {\n newFileInfo.rootpath = hrefParts.path;\n }\n }\n\n if (env.useFileCache && fileCache[href]) {\n try {\n var lessText = fileCache[href];\n callback(null, lessText, href, newFileInfo, { lastModified: new Date() });\n } catch (e) {\n callback(e, null, href);\n }\n return;\n }\n\n doXHR(href, env.mime, function (data, lastModified) {\n // per file cache\n fileCache[href] = data;\n\n // Use remote copy (re-parse)\n try {\n callback(null, data, href, newFileInfo, { lastModified: lastModified });\n } catch (e) {\n callback(e, null, href);\n }\n }, function (status, url) {\n callback({ type: 'File', message: \"'\" + url + \"' wasn't found (\" + status + \")\" }, null, href);\n });\n}\n\nfunction loadStyleSheet(sheet, callback, reload, remaining, modifyVars) {\n\n var env = new less.tree.parseEnv(less);\n env.mime = sheet.type;\n\n if (modifyVars || less.globalVars) {\n env.useFileCache = true;\n }\n\n loadFile(sheet.href, null, function(e, data, path, newFileInfo, webInfo) {\n\n if (webInfo) {\n webInfo.remaining = remaining;\n\n var css = cache && cache.getItem(path),\n timestamp = cache && cache.getItem(path + ':timestamp');\n\n if (!reload && timestamp && webInfo.lastModified &&\n (new(Date)(webInfo.lastModified).valueOf() ===\n new(Date)(timestamp).valueOf())) {\n // Use local copy\n createCSS(css, sheet);\n webInfo.local = true;\n callback(null, null, data, sheet, webInfo, path);\n return;\n }\n }\n\n //TODO add tests around how this behaves when reloading\n removeError(path);\n\n if (data) {\n env.currentFileInfo = newFileInfo;\n new(less.Parser)(env).parse(data, function (e, root) {\n if (e) { return callback(e, null, null, sheet); }\n try {\n callback(e, root, data, sheet, webInfo, path);\n } catch (e) {\n callback(e, null, null, sheet);\n }\n }, {modifyVars: modifyVars, globalVars: less.globalVars});\n } else {\n callback(e, null, null, sheet, webInfo, path);\n }\n }, env, modifyVars);\n}\n\nfunction loadStyleSheets(callback, reload, modifyVars) {\n for (var i = 0; i < less.sheets.length; i++) {\n loadStyleSheet(less.sheets[i], callback, reload, less.sheets.length - (i + 1), modifyVars);\n }\n}\n\nfunction initRunningMode(){\n if (less.env === 'development') {\n less.optimization = 0;\n less.watchTimer = setInterval(function () {\n if (less.watchMode) {\n loadStyleSheets(function (e, root, _, sheet, env) {\n if (e) {\n error(e, sheet.href);\n } else if (root) {\n var styles = root.toCSS(less);\n styles = postProcessCSS(styles);\n createCSS(styles, sheet, env.lastModified);\n }\n });\n }\n }, less.poll);\n } else {\n less.optimization = 3;\n }\n}\n\n\n\n//\n// Watch mode\n//\nless.watch = function () {\n if (!less.watchMode ){\n less.env = 'development';\n initRunningMode();\n }\n this.watchMode = true;\n return true;\n};\n\nless.unwatch = function () {clearInterval(less.watchTimer); this.watchMode = false; return false; };\n\nif (/!watch/.test(location.hash)) {\n less.watch();\n}\n\nif (less.env != 'development') {\n try {\n cache = (typeof(window.localStorage) === 'undefined') ? null : window.localStorage;\n } catch (_) {}\n}\n\n//\n// Get all tags with the 'rel' attribute set to \"stylesheet/less\"\n//\nvar links = document.getElementsByTagName('link');\n\nless.sheets = [];\n\nfor (var i = 0; i < links.length; i++) {\n if (links[i].rel === 'stylesheet/less' || (links[i].rel.match(/stylesheet/) &&\n (links[i].type.match(typePattern)))) {\n less.sheets.push(links[i]);\n }\n}\n\n//\n// With this function, it's possible to alter variables and re-render\n// CSS without reloading less-files\n//\nless.modifyVars = function(record) {\n less.refresh(false, record);\n};\n\nless.refresh = function (reload, modifyVars) {\n var startTime, endTime;\n startTime = endTime = new Date();\n\n loadStyleSheets(function (e, root, _, sheet, env) {\n if (e) {\n return error(e, sheet.href);\n }\n if (env.local) {\n log(\"loading \" + sheet.href + \" from cache.\", logLevel.info);\n } else {\n log(\"parsed \" + sheet.href + \" successfully.\", logLevel.debug);\n var styles = root.toCSS(less);\n styles = postProcessCSS(styles);\n createCSS(styles, sheet, env.lastModified);\n }\n log(\"css for \" + sheet.href + \" generated in \" + (new Date() - endTime) + 'ms', logLevel.info);\n if (env.remaining === 0) {\n log(\"less has finished. css generated in \" + (new Date() - startTime) + 'ms', logLevel.info);\n }\n endTime = new Date();\n }, reload, modifyVars);\n\n loadStyles(modifyVars);\n};\n\nless.refreshStyles = loadStyles;\n\nless.Parser.fileLoader = loadFile;\n\nless.refresh(less.env === 'development');\n\n// amd.js\n//\n// Define Less as an AMD module.\nif (typeof define === \"function\" && define.amd) {\n define(function () { return less; } );\n}\n\n})(window);" }, { "path": "commons-api2doc/src/main/resources/static/api2doc/test.html", "content": "\n\n\n Api2Doc 接口测试\n\n \n \n \n \n\n \n \n \n \n\n \n \n\n \n \n \n\n \n \n \n \n\n\n\n\n
    \n\n

    XXX接口测试

    \n\n
    \n
    \n \n \n \n \n
    \n
    \n \n
    \n
    \n
    \n\n
    \n

    请求参数

    \n
    \n 如果是 POST 方法，这些请求参数会放在 Body 中；\n 如果是其它方法（如：GET / PUT / DELETE / PATCH 等），则会放在 URL 的 Query 串中。\n
    \n
    \n
    \n
    \n \n
    \n
    ：
    \n
    \n \n
    \n
    \n
    \n
    \n
    \n +\n
    \n
    \n
    \n\n
    \n

    请求Header

    \n
    \n
    \n
    \n \n
    \n
    ：
    \n
    \n \n
    \n
    \n
    \n
    \n
    \n +\n
    \n
    \n
    \n\n
    \n
    \n 发送\n
    \n
    \n
    \n\n
    \n

    返回结果

    \n 
    \n{\n  \"requestId\" : \"a22c721867984258846686b89dbf82db\",\n  \"serverTime\" : 1524039750370,\n  \"spendTime\" : 5,\n  \"resultCode\" : \"success\"\n}\n
    \n
    \n\n
    \n

    输出日志

    \n 
    \n\n  .   ____          _            __ _ _\n /\\\\ / ___'_ __ _ _(_)_ __  __ _ \\ \\ \\ \\\n( ( )\\___ | '_ | '_| | '_ \\/ _` | \\ \\ \\ \\\n \\\\/  ___)| |_)| | | | | || (_| |  ) ) ) )\n  '  |____| .__|_| |_|_| |_\\__, | / / / /\n =========|_|==============|___/=/_/_/_/\n :: Spring Boot ::        (v1.5.9.RELEASE)\n\n2018-04-26 10:42:19.193  INFO 2328 --- [           main] c.terran4j.demo.api2doc.Api2DocDemoApp   : Starting Api2DocDemoApp on DESKTOP-32DF0L3 with PID 2328 (C:\\Users\\jiangwei\\IdeaProjects\\commons\\commons-api2doc\\target\\test-classes started by jiangwei in C:\\Users\\jiangwei\\IdeaProjects\\commons)\n2018-04-26 10:42:19.200  INFO 2328 --- [           main] c.terran4j.demo.api2doc.Api2DocDemoApp   : No active profile set, falling back to default profiles: default\n2018-04-26 10:42:19.479  INFO 2328 --- [           main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@4a22f9e2: startup date [Thu Apr 26 10:42:19 CST 2018]; root of context hierarchy\n2018-04-26 10:42:24.188  INFO 2328 --- [           main] trationDelegate$BeanPostProcessorChecker : Bean 'api2DocService' of type [com.terran4j.commons.api2doc.impl.Api2DocService] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying)\n2018-04-26 10:42:26.506  INFO 2328 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat initialized with port(s): 8080 (http)\n2018-04-26 10:42:26.529  INFO 2328 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]\n2018-04-26 10:42:26.531  INFO 2328 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet Engine: Apache Tomcat/8.5.23\n2018-04-26 10:42:27.034  INFO 2328 --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext\n
    \n
    \n\n
    \n\n\n\n" }, { "path": "commons-api2doc/src/main/resources/static/api2doc/vue/vue-2.5.10.js", "content": "/*!\n * Vue.js v2.5.10\n * (c) 2014-2017 Evan You\n * Released under the MIT License.\n */\n(function (global, factory) {\n\ttypeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :\n\ttypeof define === 'function' && define.amd ? define(factory) :\n\t(global.Vue = factory());\n}(this, (function () { 'use strict';\n\n/* */\n\nvar emptyObject = Object.freeze({});\n\n// these helpers produces better vm code in JS engines due to their\n// explicitness and function inlining\nfunction isUndef (v) {\n return v === undefined || v === null\n}\n\nfunction isDef (v) {\n return v !== undefined && v !== null\n}\n\nfunction isTrue (v) {\n return v === true\n}\n\nfunction isFalse (v) {\n return v === false\n}\n\n/**\n * Check if value is primitive\n */\nfunction isPrimitive (value) {\n return (\n typeof value === 'string' ||\n typeof value === 'number' ||\n typeof value === 'boolean'\n )\n}\n\n/**\n * Quick object check - this is primarily used to tell\n * Objects from primitive values when we know the value\n * is a JSON-compliant type.\n */\nfunction isObject (obj) {\n return obj !== null && typeof obj === 'object'\n}\n\n/**\n * Get the raw type string of a value e.g. [object Object]\n */\nvar _toString = Object.prototype.toString;\n\nfunction toRawType (value) {\n return _toString.call(value).slice(8, -1)\n}\n\n/**\n * Strict object type check. Only returns true\n * for plain JavaScript objects.\n */\nfunction isPlainObject (obj) {\n return _toString.call(obj) === '[object Object]'\n}\n\nfunction isRegExp (v) {\n return _toString.call(v) === '[object RegExp]'\n}\n\n/**\n * Check if val is a valid array index.\n */\nfunction isValidArrayIndex (val) {\n var n = parseFloat(String(val));\n return n >= 0 && Math.floor(n) === n && isFinite(val)\n}\n\n/**\n * Convert a value to a string that is actually rendered.\n */\nfunction toString (val) {\n return val == null\n ? ''\n : typeof val === 'object'\n ? JSON.stringify(val, null, 2)\n : String(val)\n}\n\n/**\n * Convert a input value to a number for persistence.\n * If the conversion fails, return original string.\n */\nfunction toNumber (val) {\n var n = parseFloat(val);\n return isNaN(n) ? val : n\n}\n\n/**\n * Make a map and return a function for checking if a key\n * is in that map.\n */\nfunction makeMap (\n str,\n expectsLowerCase\n) {\n var map = Object.create(null);\n var list = str.split(',');\n for (var i = 0; i < list.length; i++) {\n map[list[i]] = true;\n }\n return expectsLowerCase\n ? function (val) { return map[val.toLowerCase()]; }\n : function (val) { return map[val]; }\n}\n\n/**\n * Check if a tag is a built-in tag.\n */\nvar isBuiltInTag = makeMap('slot,component', true);\n\n/**\n * Check if a attribute is a reserved attribute.\n */\nvar isReservedAttribute = makeMap('key,ref,slot,slot-scope,is');\n\n/**\n * Remove an item from an array\n */\nfunction remove (arr, item) {\n if (arr.length) {\n var index = arr.indexOf(item);\n if (index > -1) {\n return arr.splice(index, 1)\n }\n }\n}\n\n/**\n * Check whether the object has the property.\n */\nvar hasOwnProperty = Object.prototype.hasOwnProperty;\nfunction hasOwn (obj, key) {\n return hasOwnProperty.call(obj, key)\n}\n\n/**\n * Create a cached version of a pure function.\n */\nfunction cached (fn) {\n var cache = Object.create(null);\n return (function cachedFn (str) {\n var hit = cache[str];\n return hit || (cache[str] = fn(str))\n })\n}\n\n/**\n * Camelize a hyphen-delimited string.\n */\nvar camelizeRE = /-(\\w)/g;\nvar camelize = cached(function (str) {\n return str.replace(camelizeRE, function (_, c) { return c ? c.toUpperCase() : ''; })\n});\n\n/**\n * Capitalize a string.\n */\nvar capitalize = cached(function (str) {\n return str.charAt(0).toUpperCase() + str.slice(1)\n});\n\n/**\n * Hyphenate a camelCase string.\n */\nvar hyphenateRE = /\\B([A-Z])/g;\nvar hyphenate = cached(function (str) {\n return str.replace(hyphenateRE, '-$1').toLowerCase()\n});\n\n/**\n * Simple bind, faster than native\n */\nfunction bind (fn, ctx) {\n function boundFn (a) {\n var l = arguments.length;\n return l\n ? l > 1\n ? fn.apply(ctx, arguments)\n : fn.call(ctx, a)\n : fn.call(ctx)\n }\n // record original fn length\n boundFn._length = fn.length;\n return boundFn\n}\n\n/**\n * Convert an Array-like object to a real Array.\n */\nfunction toArray (list, start) {\n start = start || 0;\n var i = list.length - start;\n var ret = new Array(i);\n while (i--) {\n ret[i] = list[i + start];\n }\n return ret\n}\n\n/**\n * Mix properties into target object.\n */\nfunction extend (to, _from) {\n for (var key in _from) {\n to[key] = _from[key];\n }\n return to\n}\n\n/**\n * Merge an Array of Objects into a single Object.\n */\nfunction toObject (arr) {\n var res = {};\n for (var i = 0; i < arr.length; i++) {\n if (arr[i]) {\n extend(res, arr[i]);\n }\n }\n return res\n}\n\n/**\n * Perform no operation.\n * Stubbing args to make Flow happy without leaving useless transpiled code\n * with ...rest (https://flow.org/blog/2017/05/07/Strict-Function-Call-Arity/)\n */\nfunction noop (a, b, c) {}\n\n/**\n * Always return false.\n */\nvar no = function (a, b, c) { return false; };\n\n/**\n * Return same value\n */\nvar identity = function (_) { return _; };\n\n/**\n * Generate a static keys string from compiler modules.\n */\nfunction genStaticKeys (modules) {\n return modules.reduce(function (keys, m) {\n return keys.concat(m.staticKeys || [])\n }, []).join(',')\n}\n\n/**\n * Check if two values are loosely equal - that is,\n * if they are plain objects, do they have the same shape?\n */\nfunction looseEqual (a, b) {\n if (a === b) { return true }\n var isObjectA = isObject(a);\n var isObjectB = isObject(b);\n if (isObjectA && isObjectB) {\n try {\n var isArrayA = Array.isArray(a);\n var isArrayB = Array.isArray(b);\n if (isArrayA && isArrayB) {\n return a.length === b.length && a.every(function (e, i) {\n return looseEqual(e, b[i])\n })\n } else if (!isArrayA && !isArrayB) {\n var keysA = Object.keys(a);\n var keysB = Object.keys(b);\n return keysA.length === keysB.length && keysA.every(function (key) {\n return looseEqual(a[key], b[key])\n })\n } else {\n /* istanbul ignore next */\n return false\n }\n } catch (e) {\n /* istanbul ignore next */\n return false\n }\n } else if (!isObjectA && !isObjectB) {\n return String(a) === String(b)\n } else {\n return false\n }\n}\n\nfunction looseIndexOf (arr, val) {\n for (var i = 0; i < arr.length; i++) {\n if (looseEqual(arr[i], val)) { return i }\n }\n return -1\n}\n\n/**\n * Ensure a function is called only once.\n */\nfunction once (fn) {\n var called = false;\n return function () {\n if (!called) {\n called = true;\n fn.apply(this, arguments);\n }\n }\n}\n\nvar SSR_ATTR = 'data-server-rendered';\n\nvar ASSET_TYPES = [\n 'component',\n 'directive',\n 'filter'\n];\n\nvar LIFECYCLE_HOOKS = [\n 'beforeCreate',\n 'created',\n 'beforeMount',\n 'mounted',\n 'beforeUpdate',\n 'updated',\n 'beforeDestroy',\n 'destroyed',\n 'activated',\n 'deactivated',\n 'errorCaptured'\n];\n\n/* */\n\nvar config = ({\n /**\n * Option merge strategies (used in core/util/options)\n */\n optionMergeStrategies: Object.create(null),\n\n /**\n * Whether to suppress warnings.\n */\n silent: false,\n\n /**\n * Show production mode tip message on boot?\n */\n productionTip: \"development\" !== 'production',\n\n /**\n * Whether to enable devtools\n */\n devtools: \"development\" !== 'production',\n\n /**\n * Whether to record perf\n */\n performance: false,\n\n /**\n * Error handler for watcher errors\n */\n errorHandler: null,\n\n /**\n * Warn handler for watcher warns\n */\n warnHandler: null,\n\n /**\n * Ignore certain custom elements\n */\n ignoredElements: [],\n\n /**\n * Custom user key aliases for v-on\n */\n keyCodes: Object.create(null),\n\n /**\n * Check if a tag is reserved so that it cannot be registered as a\n * component. This is platform-dependent and may be overwritten.\n */\n isReservedTag: no,\n\n /**\n * Check if an attribute is reserved so that it cannot be used as a component\n * prop. This is platform-dependent and may be overwritten.\n */\n isReservedAttr: no,\n\n /**\n * Check if a tag is an unknown element.\n * Platform-dependent.\n */\n isUnknownElement: no,\n\n /**\n * Get the namespace of an element\n */\n getTagNamespace: noop,\n\n /**\n * Parse the real tag name for the specific platform.\n */\n parsePlatformTagName: identity,\n\n /**\n * Check if an attribute must be bound using property, e.g. value\n * Platform-dependent.\n */\n mustUseProp: no,\n\n /**\n * Exposed for legacy reasons\n */\n _lifecycleHooks: LIFECYCLE_HOOKS\n});\n\n/* */\n\n/**\n * Check if a string starts with $ or _\n */\nfunction isReserved (str) {\n var c = (str + '').charCodeAt(0);\n return c === 0x24 || c === 0x5F\n}\n\n/**\n * Define a property.\n */\nfunction def (obj, key, val, enumerable) {\n Object.defineProperty(obj, key, {\n value: val,\n enumerable: !!enumerable,\n writable: true,\n configurable: true\n });\n}\n\n/**\n * Parse simple path.\n */\nvar bailRE = /[^\\w.$]/;\nfunction parsePath (path) {\n if (bailRE.test(path)) {\n return\n }\n var segments = path.split('.');\n return function (obj) {\n for (var i = 0; i < segments.length; i++) {\n if (!obj) { return }\n obj = obj[segments[i]];\n }\n return obj\n }\n}\n\n/* */\n\n\n// can we use __proto__?\nvar hasProto = '__proto__' in {};\n\n// Browser environment sniffing\nvar inBrowser = typeof window !== 'undefined';\nvar inWeex = typeof WXEnvironment !== 'undefined' && !!WXEnvironment.platform;\nvar weexPlatform = inWeex && WXEnvironment.platform.toLowerCase();\nvar UA = inBrowser && window.navigator.userAgent.toLowerCase();\nvar isIE = UA && /msie|trident/.test(UA);\nvar isIE9 = UA && UA.indexOf('msie 9.0') > 0;\nvar isEdge = UA && UA.indexOf('edge/') > 0;\nvar isAndroid = (UA && UA.indexOf('android') > 0) || (weexPlatform === 'android');\nvar isIOS = (UA && /iphone|ipad|ipod|ios/.test(UA)) || (weexPlatform === 'ios');\nvar isChrome = UA && /chrome\\/\\d+/.test(UA) && !isEdge;\n\n// Firefox has a \"watch\" function on Object.prototype...\nvar nativeWatch = ({}).watch;\n\nvar supportsPassive = false;\nif (inBrowser) {\n try {\n var opts = {};\n Object.defineProperty(opts, 'passive', ({\n get: function get () {\n /* istanbul ignore next */\n supportsPassive = true;\n }\n })); // https://github.com/facebook/flow/issues/285\n window.addEventListener('test-passive', null, opts);\n } catch (e) {}\n}\n\n// this needs to be lazy-evaled because vue may be required before\n// vue-server-renderer can set VUE_ENV\nvar _isServer;\nvar isServerRendering = function () {\n if (_isServer === undefined) {\n /* istanbul ignore if */\n if (!inBrowser && typeof global !== 'undefined') {\n // detect presence of vue-server-renderer and avoid\n // Webpack shimming the process\n _isServer = global['process'].env.VUE_ENV === 'server';\n } else {\n _isServer = false;\n }\n }\n return _isServer\n};\n\n// detect devtools\nvar devtools = inBrowser && window.__VUE_DEVTOOLS_GLOBAL_HOOK__;\n\n/* istanbul ignore next */\nfunction isNative (Ctor) {\n return typeof Ctor === 'function' && /native code/.test(Ctor.toString())\n}\n\nvar hasSymbol =\n typeof Symbol !== 'undefined' && isNative(Symbol) &&\n typeof Reflect !== 'undefined' && isNative(Reflect.ownKeys);\n\nvar _Set;\n/* istanbul ignore if */ // $flow-disable-line\nif (typeof Set !== 'undefined' && isNative(Set)) {\n // use native Set when available.\n _Set = Set;\n} else {\n // a non-standard Set polyfill that only works with primitive keys.\n _Set = (function () {\n function Set () {\n this.set = Object.create(null);\n }\n Set.prototype.has = function has (key) {\n return this.set[key] === true\n };\n Set.prototype.add = function add (key) {\n this.set[key] = true;\n };\n Set.prototype.clear = function clear () {\n this.set = Object.create(null);\n };\n\n return Set;\n }());\n}\n\n/* */\n\nvar warn = noop;\nvar tip = noop;\nvar generateComponentTrace = (noop); // work around flow check\nvar formatComponentName = (noop);\n\n{\n var hasConsole = typeof console !== 'undefined';\n var classifyRE = /(?:^|[-_])(\\w)/g;\n var classify = function (str) { return str\n .replace(classifyRE, function (c) { return c.toUpperCase(); })\n .replace(/[-_]/g, ''); };\n\n warn = function (msg, vm) {\n var trace = vm ? generateComponentTrace(vm) : '';\n\n if (config.warnHandler) {\n config.warnHandler.call(null, msg, vm, trace);\n } else if (hasConsole && (!config.silent)) {\n console.error((\"[Vue warn]: \" + msg + trace));\n }\n };\n\n tip = function (msg, vm) {\n if (hasConsole && (!config.silent)) {\n console.warn(\"[Vue tip]: \" + msg + (\n vm ? generateComponentTrace(vm) : ''\n ));\n }\n };\n\n formatComponentName = function (vm, includeFile) {\n if (vm.$root === vm) {\n return ''\n }\n var options = typeof vm === 'function' && vm.cid != null\n ? vm.options\n : vm._isVue\n ? vm.$options || vm.constructor.options\n : vm || {};\n var name = options.name || options._componentTag;\n var file = options.__file;\n if (!name && file) {\n var match = file.match(/([^/\\\\]+)\\.vue$/);\n name = match && match[1];\n }\n\n return (\n (name ? (\"<\" + (classify(name)) + \">\") : \"\") +\n (file && includeFile !== false ? (\" at \" + file) : '')\n )\n };\n\n var repeat = function (str, n) {\n var res = '';\n while (n) {\n if (n % 2 === 1) { res += str; }\n if (n > 1) { str += str; }\n n >>= 1;\n }\n return res\n };\n\n generateComponentTrace = function (vm) {\n if (vm._isVue && vm.$parent) {\n var tree = [];\n var currentRecursiveSequence = 0;\n while (vm) {\n if (tree.length > 0) {\n var last = tree[tree.length - 1];\n if (last.constructor === vm.constructor) {\n currentRecursiveSequence++;\n vm = vm.$parent;\n continue\n } else if (currentRecursiveSequence > 0) {\n tree[tree.length - 1] = [last, currentRecursiveSequence];\n currentRecursiveSequence = 0;\n }\n }\n tree.push(vm);\n vm = vm.$parent;\n }\n return '\\n\\nfound in\\n\\n' + tree\n .map(function (vm, i) { return (\"\" + (i === 0 ? '---> ' : repeat(' ', 5 + i * 2)) + (Array.isArray(vm)\n ? ((formatComponentName(vm[0])) + \"... (\" + (vm[1]) + \" recursive calls)\")\n : formatComponentName(vm))); })\n .join('\\n')\n } else {\n return (\"\\n\\n(found in \" + (formatComponentName(vm)) + \")\")\n }\n };\n}\n\n/* */\n\n\nvar uid = 0;\n\n/**\n * A dep is an observable that can have multiple\n * directives subscribing to it.\n */\nvar Dep = function Dep () {\n this.id = uid++;\n this.subs = [];\n};\n\nDep.prototype.addSub = function addSub (sub) {\n this.subs.push(sub);\n};\n\nDep.prototype.removeSub = function removeSub (sub) {\n remove(this.subs, sub);\n};\n\nDep.prototype.depend = function depend () {\n if (Dep.target) {\n Dep.target.addDep(this);\n }\n};\n\nDep.prototype.notify = function notify () {\n // stabilize the subscriber list first\n var subs = this.subs.slice();\n for (var i = 0, l = subs.length; i < l; i++) {\n subs[i].update();\n }\n};\n\n// the current target watcher being evaluated.\n// this is globally unique because there could be only one\n// watcher being evaluated at any time.\nDep.target = null;\nvar targetStack = [];\n\nfunction pushTarget (_target) {\n if (Dep.target) { targetStack.push(Dep.target); }\n Dep.target = _target;\n}\n\nfunction popTarget () {\n Dep.target = targetStack.pop();\n}\n\n/* */\n\nvar VNode = function VNode (\n tag,\n data,\n children,\n text,\n elm,\n context,\n componentOptions,\n asyncFactory\n) {\n this.tag = tag;\n this.data = data;\n this.children = children;\n this.text = text;\n this.elm = elm;\n this.ns = undefined;\n this.context = context;\n this.fnContext = undefined;\n this.fnOptions = undefined;\n this.fnScopeId = undefined;\n this.key = data && data.key;\n this.componentOptions = componentOptions;\n this.componentInstance = undefined;\n this.parent = undefined;\n this.raw = false;\n this.isStatic = false;\n this.isRootInsert = true;\n this.isComment = false;\n this.isCloned = false;\n this.isOnce = false;\n this.asyncFactory = asyncFactory;\n this.asyncMeta = undefined;\n this.isAsyncPlaceholder = false;\n};\n\nvar prototypeAccessors = { child: { configurable: true } };\n\n// DEPRECATED: alias for componentInstance for backwards compat.\n/* istanbul ignore next */\nprototypeAccessors.child.get = function () {\n return this.componentInstance\n};\n\nObject.defineProperties( VNode.prototype, prototypeAccessors );\n\nvar createEmptyVNode = function (text) {\n if ( text === void 0 ) text = '';\n\n var node = new VNode();\n node.text = text;\n node.isComment = true;\n return node\n};\n\nfunction createTextVNode (val) {\n return new VNode(undefined, undefined, undefined, String(val))\n}\n\n// optimized shallow clone\n// used for static nodes and slot nodes because they may be reused across\n// multiple renders, cloning them avoids errors when DOM manipulations rely\n// on their elm reference.\nfunction cloneVNode (vnode, deep) {\n var componentOptions = vnode.componentOptions;\n var cloned = new VNode(\n vnode.tag,\n vnode.data,\n vnode.children,\n vnode.text,\n vnode.elm,\n vnode.context,\n componentOptions,\n vnode.asyncFactory\n );\n cloned.ns = vnode.ns;\n cloned.isStatic = vnode.isStatic;\n cloned.key = vnode.key;\n cloned.isComment = vnode.isComment;\n cloned.fnContext = vnode.fnContext;\n cloned.fnOptions = vnode.fnOptions;\n cloned.fnScopeId = vnode.fnScopeId;\n cloned.isCloned = true;\n if (deep) {\n if (vnode.children) {\n cloned.children = cloneVNodes(vnode.children, true);\n }\n if (componentOptions && componentOptions.children) {\n componentOptions.children = cloneVNodes(componentOptions.children, true);\n }\n }\n return cloned\n}\n\nfunction cloneVNodes (vnodes, deep) {\n var len = vnodes.length;\n var res = new Array(len);\n for (var i = 0; i < len; i++) {\n res[i] = cloneVNode(vnodes[i], deep);\n }\n return res\n}\n\n/*\n * not type checking this file because flow doesn't play well with\n * dynamically accessing methods on Array prototype\n */\n\nvar arrayProto = Array.prototype;\nvar arrayMethods = Object.create(arrayProto);[\n 'push',\n 'pop',\n 'shift',\n 'unshift',\n 'splice',\n 'sort',\n 'reverse'\n]\n.forEach(function (method) {\n // cache original method\n var original = arrayProto[method];\n def(arrayMethods, method, function mutator () {\n var args = [], len = arguments.length;\n while ( len-- ) args[ len ] = arguments[ len ];\n\n var result = original.apply(this, args);\n var ob = this.__ob__;\n var inserted;\n switch (method) {\n case 'push':\n case 'unshift':\n inserted = args;\n break\n case 'splice':\n inserted = args.slice(2);\n break\n }\n if (inserted) { ob.observeArray(inserted); }\n // notify change\n ob.dep.notify();\n return result\n });\n});\n\n/* */\n\nvar arrayKeys = Object.getOwnPropertyNames(arrayMethods);\n\n/**\n * By default, when a reactive property is set, the new value is\n * also converted to become reactive. However when passing down props,\n * we don't want to force conversion because the value may be a nested value\n * under a frozen data structure. Converting it would defeat the optimization.\n */\nvar observerState = {\n shouldConvert: true\n};\n\n/**\n * Observer class that are attached to each observed\n * object. Once attached, the observer converts target\n * object's property keys into getter/setters that\n * collect dependencies and dispatches updates.\n */\nvar Observer = function Observer (value) {\n this.value = value;\n this.dep = new Dep();\n this.vmCount = 0;\n def(value, '__ob__', this);\n if (Array.isArray(value)) {\n var augment = hasProto\n ? protoAugment\n : copyAugment;\n augment(value, arrayMethods, arrayKeys);\n this.observeArray(value);\n } else {\n this.walk(value);\n }\n};\n\n/**\n * Walk through each property and convert them into\n * getter/setters. This method should only be called when\n * value type is Object.\n */\nObserver.prototype.walk = function walk (obj) {\n var keys = Object.keys(obj);\n for (var i = 0; i < keys.length; i++) {\n defineReactive(obj, keys[i], obj[keys[i]]);\n }\n};\n\n/**\n * Observe a list of Array items.\n */\nObserver.prototype.observeArray = function observeArray (items) {\n for (var i = 0, l = items.length; i < l; i++) {\n observe(items[i]);\n }\n};\n\n// helpers\n\n/**\n * Augment an target Object or Array by intercepting\n * the prototype chain using __proto__\n */\nfunction protoAugment (target, src, keys) {\n /* eslint-disable no-proto */\n target.__proto__ = src;\n /* eslint-enable no-proto */\n}\n\n/**\n * Augment an target Object or Array by defining\n * hidden properties.\n */\n/* istanbul ignore next */\nfunction copyAugment (target, src, keys) {\n for (var i = 0, l = keys.length; i < l; i++) {\n var key = keys[i];\n def(target, key, src[key]);\n }\n}\n\n/**\n * Attempt to create an observer instance for a value,\n * returns the new observer if successfully observed,\n * or the existing observer if the value already has one.\n */\nfunction observe (value, asRootData) {\n if (!isObject(value) || value instanceof VNode) {\n return\n }\n var ob;\n if (hasOwn(value, '__ob__') && value.__ob__ instanceof Observer) {\n ob = value.__ob__;\n } else if (\n observerState.shouldConvert &&\n !isServerRendering() &&\n (Array.isArray(value) || isPlainObject(value)) &&\n Object.isExtensible(value) &&\n !value._isVue\n ) {\n ob = new Observer(value);\n }\n if (asRootData && ob) {\n ob.vmCount++;\n }\n return ob\n}\n\n/**\n * Define a reactive property on an Object.\n */\nfunction defineReactive (\n obj,\n key,\n val,\n customSetter,\n shallow\n) {\n var dep = new Dep();\n\n var property = Object.getOwnPropertyDescriptor(obj, key);\n if (property && property.configurable === false) {\n return\n }\n\n // cater for pre-defined getter/setters\n var getter = property && property.get;\n var setter = property && property.set;\n\n var childOb = !shallow && observe(val);\n Object.defineProperty(obj, key, {\n enumerable: true,\n configurable: true,\n get: function reactiveGetter () {\n var value = getter ? getter.call(obj) : val;\n if (Dep.target) {\n dep.depend();\n if (childOb) {\n childOb.dep.depend();\n if (Array.isArray(value)) {\n dependArray(value);\n }\n }\n }\n return value\n },\n set: function reactiveSetter (newVal) {\n var value = getter ? getter.call(obj) : val;\n /* eslint-disable no-self-compare */\n if (newVal === value || (newVal !== newVal && value !== value)) {\n return\n }\n /* eslint-enable no-self-compare */\n if (\"development\" !== 'production' && customSetter) {\n customSetter();\n }\n if (setter) {\n setter.call(obj, newVal);\n } else {\n val = newVal;\n }\n childOb = !shallow && observe(newVal);\n dep.notify();\n }\n });\n}\n\n/**\n * Set a property on an object. Adds the new property and\n * triggers change notification if the property doesn't\n * already exist.\n */\nfunction set (target, key, val) {\n if (Array.isArray(target) && isValidArrayIndex(key)) {\n target.length = Math.max(target.length, key);\n target.splice(key, 1, val);\n return val\n }\n if (key in target && !(key in Object.prototype)) {\n target[key] = val;\n return val\n }\n var ob = (target).__ob__;\n if (target._isVue || (ob && ob.vmCount)) {\n \"development\" !== 'production' && warn(\n 'Avoid adding reactive properties to a Vue instance or its root $data ' +\n 'at runtime - declare it upfront in the data option.'\n );\n return val\n }\n if (!ob) {\n target[key] = val;\n return val\n }\n defineReactive(ob.value, key, val);\n ob.dep.notify();\n return val\n}\n\n/**\n * Delete a property and trigger change if necessary.\n */\nfunction del (target, key) {\n if (Array.isArray(target) && isValidArrayIndex(key)) {\n target.splice(key, 1);\n return\n }\n var ob = (target).__ob__;\n if (target._isVue || (ob && ob.vmCount)) {\n \"development\" !== 'production' && warn(\n 'Avoid deleting properties on a Vue instance or its root $data ' +\n '- just set it to null.'\n );\n return\n }\n if (!hasOwn(target, key)) {\n return\n }\n delete target[key];\n if (!ob) {\n return\n }\n ob.dep.notify();\n}\n\n/**\n * Collect dependencies on array elements when the array is touched, since\n * we cannot intercept array element access like property getters.\n */\nfunction dependArray (value) {\n for (var e = (void 0), i = 0, l = value.length; i < l; i++) {\n e = value[i];\n e && e.__ob__ && e.__ob__.dep.depend();\n if (Array.isArray(e)) {\n dependArray(e);\n }\n }\n}\n\n/* */\n\n/**\n * Option overwriting strategies are functions that handle\n * how to merge a parent option value and a child option\n * value into the final value.\n */\nvar strats = config.optionMergeStrategies;\n\n/**\n * Options with restrictions\n */\n{\n strats.el = strats.propsData = function (parent, child, vm, key) {\n if (!vm) {\n warn(\n \"option \\\"\" + key + \"\\\" can only be used during instance \" +\n 'creation with the `new` keyword.'\n );\n }\n return defaultStrat(parent, child)\n };\n}\n\n/**\n * Helper that recursively merges two data objects together.\n */\nfunction mergeData (to, from) {\n if (!from) { return to }\n var key, toVal, fromVal;\n var keys = Object.keys(from);\n for (var i = 0; i < keys.length; i++) {\n key = keys[i];\n toVal = to[key];\n fromVal = from[key];\n if (!hasOwn(to, key)) {\n set(to, key, fromVal);\n } else if (isPlainObject(toVal) && isPlainObject(fromVal)) {\n mergeData(toVal, fromVal);\n }\n }\n return to\n}\n\n/**\n * Data\n */\nfunction mergeDataOrFn (\n parentVal,\n childVal,\n vm\n) {\n if (!vm) {\n // in a Vue.extend merge, both should be functions\n if (!childVal) {\n return parentVal\n }\n if (!parentVal) {\n return childVal\n }\n // when parentVal & childVal are both present,\n // we need to return a function that returns the\n // merged result of both functions... no need to\n // check if parentVal is a function here because\n // it has to be a function to pass previous merges.\n return function mergedDataFn () {\n return mergeData(\n typeof childVal === 'function' ? childVal.call(this, this) : childVal,\n typeof parentVal === 'function' ? parentVal.call(this, this) : parentVal\n )\n }\n } else {\n return function mergedInstanceDataFn () {\n // instance merge\n var instanceData = typeof childVal === 'function'\n ? childVal.call(vm, vm)\n : childVal;\n var defaultData = typeof parentVal === 'function'\n ? parentVal.call(vm, vm)\n : parentVal;\n if (instanceData) {\n return mergeData(instanceData, defaultData)\n } else {\n return defaultData\n }\n }\n }\n}\n\nstrats.data = function (\n parentVal,\n childVal,\n vm\n) {\n if (!vm) {\n if (childVal && typeof childVal !== 'function') {\n \"development\" !== 'production' && warn(\n 'The \"data\" option should be a function ' +\n 'that returns a per-instance value in component ' +\n 'definitions.',\n vm\n );\n\n return parentVal\n }\n return mergeDataOrFn(parentVal, childVal)\n }\n\n return mergeDataOrFn(parentVal, childVal, vm)\n};\n\n/**\n * Hooks and props are merged as arrays.\n */\nfunction mergeHook (\n parentVal,\n childVal\n) {\n return childVal\n ? parentVal\n ? parentVal.concat(childVal)\n : Array.isArray(childVal)\n ? childVal\n : [childVal]\n : parentVal\n}\n\nLIFECYCLE_HOOKS.forEach(function (hook) {\n strats[hook] = mergeHook;\n});\n\n/**\n * Assets\n *\n * When a vm is present (instance creation), we need to do\n * a three-way merge between constructor options, instance\n * options and parent options.\n */\nfunction mergeAssets (\n parentVal,\n childVal,\n vm,\n key\n) {\n var res = Object.create(parentVal || null);\n if (childVal) {\n \"development\" !== 'production' && assertObjectType(key, childVal, vm);\n return extend(res, childVal)\n } else {\n return res\n }\n}\n\nASSET_TYPES.forEach(function (type) {\n strats[type + 's'] = mergeAssets;\n});\n\n/**\n * Watchers.\n *\n * Watchers hashes should not overwrite one\n * another, so we merge them as arrays.\n */\nstrats.watch = function (\n parentVal,\n childVal,\n vm,\n key\n) {\n // work around Firefox's Object.prototype.watch...\n if (parentVal === nativeWatch) { parentVal = undefined; }\n if (childVal === nativeWatch) { childVal = undefined; }\n /* istanbul ignore if */\n if (!childVal) { return Object.create(parentVal || null) }\n {\n assertObjectType(key, childVal, vm);\n }\n if (!parentVal) { return childVal }\n var ret = {};\n extend(ret, parentVal);\n for (var key$1 in childVal) {\n var parent = ret[key$1];\n var child = childVal[key$1];\n if (parent && !Array.isArray(parent)) {\n parent = [parent];\n }\n ret[key$1] = parent\n ? parent.concat(child)\n : Array.isArray(child) ? child : [child];\n }\n return ret\n};\n\n/**\n * Other object hashes.\n */\nstrats.props =\nstrats.methods =\nstrats.inject =\nstrats.computed = function (\n parentVal,\n childVal,\n vm,\n key\n) {\n if (childVal && \"development\" !== 'production') {\n assertObjectType(key, childVal, vm);\n }\n if (!parentVal) { return childVal }\n var ret = Object.create(null);\n extend(ret, parentVal);\n if (childVal) { extend(ret, childVal); }\n return ret\n};\nstrats.provide = mergeDataOrFn;\n\n/**\n * Default strategy.\n */\nvar defaultStrat = function (parentVal, childVal) {\n return childVal === undefined\n ? parentVal\n : childVal\n};\n\n/**\n * Validate component names\n */\nfunction checkComponents (options) {\n for (var key in options.components) {\n validateComponentName(key);\n }\n}\n\nfunction validateComponentName (name) {\n if (!/^[a-zA-Z][\\w-]*$/.test(name)) {\n warn(\n 'Invalid component name: \"' + name + '\". Component names ' +\n 'can only contain alphanumeric characters and the hyphen, ' +\n 'and must start with a letter.'\n );\n }\n var lower = name.toLowerCase();\n if (isBuiltInTag(lower) || config.isReservedTag(lower)) {\n warn(\n 'Do not use built-in or reserved HTML elements as component ' +\n 'id: ' + name\n );\n }\n}\n\n/**\n * Ensure all props option syntax are normalized into the\n * Object-based format.\n */\nfunction normalizeProps (options, vm) {\n var props = options.props;\n if (!props) { return }\n var res = {};\n var i, val, name;\n if (Array.isArray(props)) {\n i = props.length;\n while (i--) {\n val = props[i];\n if (typeof val === 'string') {\n name = camelize(val);\n res[name] = { type: null };\n } else {\n warn('props must be strings when using array syntax.');\n }\n }\n } else if (isPlainObject(props)) {\n for (var key in props) {\n val = props[key];\n name = camelize(key);\n res[name] = isPlainObject(val)\n ? val\n : { type: val };\n }\n } else {\n warn(\n \"Invalid value for option \\\"props\\\": expected an Array or an Object, \" +\n \"but got \" + (toRawType(props)) + \".\",\n vm\n );\n }\n options.props = res;\n}\n\n/**\n * Normalize all injections into Object-based format\n */\nfunction normalizeInject (options, vm) {\n var inject = options.inject;\n var normalized = options.inject = {};\n if (Array.isArray(inject)) {\n for (var i = 0; i < inject.length; i++) {\n normalized[inject[i]] = { from: inject[i] };\n }\n } else if (isPlainObject(inject)) {\n for (var key in inject) {\n var val = inject[key];\n normalized[key] = isPlainObject(val)\n ? extend({ from: key }, val)\n : { from: val };\n }\n } else if (\"development\" !== 'production' && inject) {\n warn(\n \"Invalid value for option \\\"inject\\\": expected an Array or an Object, \" +\n \"but got \" + (toRawType(inject)) + \".\",\n vm\n );\n }\n}\n\n/**\n * Normalize raw function directives into object format.\n */\nfunction normalizeDirectives (options) {\n var dirs = options.directives;\n if (dirs) {\n for (var key in dirs) {\n var def = dirs[key];\n if (typeof def === 'function') {\n dirs[key] = { bind: def, update: def };\n }\n }\n }\n}\n\nfunction assertObjectType (name, value, vm) {\n if (!isPlainObject(value)) {\n warn(\n \"Invalid value for option \\\"\" + name + \"\\\": expected an Object, \" +\n \"but got \" + (toRawType(value)) + \".\",\n vm\n );\n }\n}\n\n/**\n * Merge two option objects into a new one.\n * Core utility used in both instantiation and inheritance.\n */\nfunction mergeOptions (\n parent,\n child,\n vm\n) {\n {\n checkComponents(child);\n }\n\n if (typeof child === 'function') {\n child = child.options;\n }\n\n normalizeProps(child, vm);\n normalizeInject(child, vm);\n normalizeDirectives(child);\n var extendsFrom = child.extends;\n if (extendsFrom) {\n parent = mergeOptions(parent, extendsFrom, vm);\n }\n if (child.mixins) {\n for (var i = 0, l = child.mixins.length; i < l; i++) {\n parent = mergeOptions(parent, child.mixins[i], vm);\n }\n }\n var options = {};\n var key;\n for (key in parent) {\n mergeField(key);\n }\n for (key in child) {\n if (!hasOwn(parent, key)) {\n mergeField(key);\n }\n }\n function mergeField (key) {\n var strat = strats[key] || defaultStrat;\n options[key] = strat(parent[key], child[key], vm, key);\n }\n return options\n}\n\n/**\n * Resolve an asset.\n * This function is used because child instances need access\n * to assets defined in its ancestor chain.\n */\nfunction resolveAsset (\n options,\n type,\n id,\n warnMissing\n) {\n /* istanbul ignore if */\n if (typeof id !== 'string') {\n return\n }\n var assets = options[type];\n // check local registration variations first\n if (hasOwn(assets, id)) { return assets[id] }\n var camelizedId = camelize(id);\n if (hasOwn(assets, camelizedId)) { return assets[camelizedId] }\n var PascalCaseId = capitalize(camelizedId);\n if (hasOwn(assets, PascalCaseId)) { return assets[PascalCaseId] }\n // fallback to prototype chain\n var res = assets[id] || assets[camelizedId] || assets[PascalCaseId];\n if (\"development\" !== 'production' && warnMissing && !res) {\n warn(\n 'Failed to resolve ' + type.slice(0, -1) + ': ' + id,\n options\n );\n }\n return res\n}\n\n/* */\n\nfunction validateProp (\n key,\n propOptions,\n propsData,\n vm\n) {\n var prop = propOptions[key];\n var absent = !hasOwn(propsData, key);\n var value = propsData[key];\n // handle boolean props\n if (isType(Boolean, prop.type)) {\n if (absent && !hasOwn(prop, 'default')) {\n value = false;\n } else if (!isType(String, prop.type) && (value === '' || value === hyphenate(key))) {\n value = true;\n }\n }\n // check default value\n if (value === undefined) {\n value = getPropDefaultValue(vm, prop, key);\n // since the default value is a fresh copy,\n // make sure to observe it.\n var prevShouldConvert = observerState.shouldConvert;\n observerState.shouldConvert = true;\n observe(value);\n observerState.shouldConvert = prevShouldConvert;\n }\n {\n assertProp(prop, key, value, vm, absent);\n }\n return value\n}\n\n/**\n * Get the default value of a prop.\n */\nfunction getPropDefaultValue (vm, prop, key) {\n // no default, return undefined\n if (!hasOwn(prop, 'default')) {\n return undefined\n }\n var def = prop.default;\n // warn against non-factory defaults for Object & Array\n if (\"development\" !== 'production' && isObject(def)) {\n warn(\n 'Invalid default value for prop \"' + key + '\": ' +\n 'Props with type Object/Array must use a factory function ' +\n 'to return the default value.',\n vm\n );\n }\n // the raw prop value was also undefined from previous render,\n // return previous default value to avoid unnecessary watcher trigger\n if (vm && vm.$options.propsData &&\n vm.$options.propsData[key] === undefined &&\n vm._props[key] !== undefined\n ) {\n return vm._props[key]\n }\n // call factory function for non-Function types\n // a value is Function if its prototype is function even across different execution context\n return typeof def === 'function' && getType(prop.type) !== 'Function'\n ? def.call(vm)\n : def\n}\n\n/**\n * Assert whether a prop is valid.\n */\nfunction assertProp (\n prop,\n name,\n value,\n vm,\n absent\n) {\n if (prop.required && absent) {\n warn(\n 'Missing required prop: \"' + name + '\"',\n vm\n );\n return\n }\n if (value == null && !prop.required) {\n return\n }\n var type = prop.type;\n var valid = !type || type === true;\n var expectedTypes = [];\n if (type) {\n if (!Array.isArray(type)) {\n type = [type];\n }\n for (var i = 0; i < type.length && !valid; i++) {\n var assertedType = assertType(value, type[i]);\n expectedTypes.push(assertedType.expectedType || '');\n valid = assertedType.valid;\n }\n }\n if (!valid) {\n warn(\n \"Invalid prop: type check failed for prop \\\"\" + name + \"\\\".\" +\n \" Expected \" + (expectedTypes.map(capitalize).join(', ')) +\n \", got \" + (toRawType(value)) + \".\",\n vm\n );\n return\n }\n var validator = prop.validator;\n if (validator) {\n if (!validator(value)) {\n warn(\n 'Invalid prop: custom validator check failed for prop \"' + name + '\".',\n vm\n );\n }\n }\n}\n\nvar simpleCheckRE = /^(String|Number|Boolean|Function|Symbol)$/;\n\nfunction assertType (value, type) {\n var valid;\n var expectedType = getType(type);\n if (simpleCheckRE.test(expectedType)) {\n var t = typeof value;\n valid = t === expectedType.toLowerCase();\n // for primitive wrapper objects\n if (!valid && t === 'object') {\n valid = value instanceof type;\n }\n } else if (expectedType === 'Object') {\n valid = isPlainObject(value);\n } else if (expectedType === 'Array') {\n valid = Array.isArray(value);\n } else {\n valid = value instanceof type;\n }\n return {\n valid: valid,\n expectedType: expectedType\n }\n}\n\n/**\n * Use function string name to check built-in types,\n * because a simple equality check will fail when running\n * across different vms / iframes.\n */\nfunction getType (fn) {\n var match = fn && fn.toString().match(/^\\s*function (\\w+)/);\n return match ? match[1] : ''\n}\n\nfunction isType (type, fn) {\n if (!Array.isArray(fn)) {\n return getType(fn) === getType(type)\n }\n for (var i = 0, len = fn.length; i < len; i++) {\n if (getType(fn[i]) === getType(type)) {\n return true\n }\n }\n /* istanbul ignore next */\n return false\n}\n\n/* */\n\nfunction handleError (err, vm, info) {\n if (vm) {\n var cur = vm;\n while ((cur = cur.$parent)) {\n var hooks = cur.$options.errorCaptured;\n if (hooks) {\n for (var i = 0; i < hooks.length; i++) {\n try {\n var capture = hooks[i].call(cur, err, vm, info) === false;\n if (capture) { return }\n } catch (e) {\n globalHandleError(e, cur, 'errorCaptured hook');\n }\n }\n }\n }\n }\n globalHandleError(err, vm, info);\n}\n\nfunction globalHandleError (err, vm, info) {\n if (config.errorHandler) {\n try {\n return config.errorHandler.call(null, err, vm, info)\n } catch (e) {\n logError(e, null, 'config.errorHandler');\n }\n }\n logError(err, vm, info);\n}\n\nfunction logError (err, vm, info) {\n {\n warn((\"Error in \" + info + \": \\\"\" + (err.toString()) + \"\\\"\"), vm);\n }\n /* istanbul ignore else */\n if ((inBrowser || inWeex) && typeof console !== 'undefined') {\n console.error(err);\n } else {\n throw err\n }\n}\n\n/* */\n/* globals MessageChannel */\n\nvar callbacks = [];\nvar pending = false;\n\nfunction flushCallbacks () {\n pending = false;\n var copies = callbacks.slice(0);\n callbacks.length = 0;\n for (var i = 0; i < copies.length; i++) {\n copies[i]();\n }\n}\n\n// Here we have async deferring wrappers using both micro and macro tasks.\n// In < 2.4 we used micro tasks everywhere, but there are some scenarios where\n// micro tasks have too high a priority and fires in between supposedly\n// sequential events (e.g. #4521, #6690) or even between bubbling of the same\n// event (#6566). However, using macro tasks everywhere also has subtle problems\n// when state is changed right before repaint (e.g. #6813, out-in transitions).\n// Here we use micro task by default, but expose a way to force macro task when\n// needed (e.g. in event handlers attached by v-on).\nvar microTimerFunc;\nvar macroTimerFunc;\nvar useMacroTask = false;\n\n// Determine (macro) Task defer implementation.\n// Technically setImmediate should be the ideal choice, but it's only available\n// in IE. The only polyfill that consistently queues the callback after all DOM\n// events triggered in the same loop is by using MessageChannel.\n/* istanbul ignore if */\nif (typeof setImmediate !== 'undefined' && isNative(setImmediate)) {\n macroTimerFunc = function () {\n setImmediate(flushCallbacks);\n };\n} else if (typeof MessageChannel !== 'undefined' && (\n isNative(MessageChannel) ||\n // PhantomJS\n MessageChannel.toString() === '[object MessageChannelConstructor]'\n)) {\n var channel = new MessageChannel();\n var port = channel.port2;\n channel.port1.onmessage = flushCallbacks;\n macroTimerFunc = function () {\n port.postMessage(1);\n };\n} else {\n /* istanbul ignore next */\n macroTimerFunc = function () {\n setTimeout(flushCallbacks, 0);\n };\n}\n\n// Determine MicroTask defer implementation.\n/* istanbul ignore next, $flow-disable-line */\nif (typeof Promise !== 'undefined' && isNative(Promise)) {\n var p = Promise.resolve();\n microTimerFunc = function () {\n p.then(flushCallbacks);\n // in problematic UIWebViews, Promise.then doesn't completely break, but\n // it can get stuck in a weird state where callbacks are pushed into the\n // microtask queue but the queue isn't being flushed, until the browser\n // needs to do some other work, e.g. handle a timer. Therefore we can\n // \"force\" the microtask queue to be flushed by adding an empty timer.\n if (isIOS) { setTimeout(noop); }\n };\n} else {\n // fallback to macro\n microTimerFunc = macroTimerFunc;\n}\n\n/**\n * Wrap a function so that if any code inside triggers state change,\n * the changes are queued using a Task instead of a MicroTask.\n */\nfunction withMacroTask (fn) {\n return fn._withTask || (fn._withTask = function () {\n useMacroTask = true;\n var res = fn.apply(null, arguments);\n useMacroTask = false;\n return res\n })\n}\n\nfunction nextTick (cb, ctx) {\n var _resolve;\n callbacks.push(function () {\n if (cb) {\n try {\n cb.call(ctx);\n } catch (e) {\n handleError(e, ctx, 'nextTick');\n }\n } else if (_resolve) {\n _resolve(ctx);\n }\n });\n if (!pending) {\n pending = true;\n if (useMacroTask) {\n macroTimerFunc();\n } else {\n microTimerFunc();\n }\n }\n // $flow-disable-line\n if (!cb && typeof Promise !== 'undefined') {\n return new Promise(function (resolve) {\n _resolve = resolve;\n })\n }\n}\n\n/* */\n\nvar mark;\nvar measure;\n\n{\n var perf = inBrowser && window.performance;\n /* istanbul ignore if */\n if (\n perf &&\n perf.mark &&\n perf.measure &&\n perf.clearMarks &&\n perf.clearMeasures\n ) {\n mark = function (tag) { return perf.mark(tag); };\n measure = function (name, startTag, endTag) {\n perf.measure(name, startTag, endTag);\n perf.clearMarks(startTag);\n perf.clearMarks(endTag);\n perf.clearMeasures(name);\n };\n }\n}\n\n/* not type checking this file because flow doesn't play well with Proxy */\n\nvar initProxy;\n\n{\n var allowedGlobals = makeMap(\n 'Infinity,undefined,NaN,isFinite,isNaN,' +\n 'parseFloat,parseInt,decodeURI,decodeURIComponent,encodeURI,encodeURIComponent,' +\n 'Math,Number,Date,Array,Object,Boolean,String,RegExp,Map,Set,JSON,Intl,' +\n 'require' // for Webpack/Browserify\n );\n\n var warnNonPresent = function (target, key) {\n warn(\n \"Property or method \\\"\" + key + \"\\\" is not defined on the instance but \" +\n 'referenced during render. Make sure that this property is reactive, ' +\n 'either in the data option, or for class-based components, by ' +\n 'initializing the property. ' +\n 'See: https://vuejs.org/v2/guide/reactivity.html#Declaring-Reactive-Properties.',\n target\n );\n };\n\n var hasProxy =\n typeof Proxy !== 'undefined' &&\n Proxy.toString().match(/native code/);\n\n if (hasProxy) {\n var isBuiltInModifier = makeMap('stop,prevent,self,ctrl,shift,alt,meta,exact');\n config.keyCodes = new Proxy(config.keyCodes, {\n set: function set (target, key, value) {\n if (isBuiltInModifier(key)) {\n warn((\"Avoid overwriting built-in modifier in config.keyCodes: .\" + key));\n return false\n } else {\n target[key] = value;\n return true\n }\n }\n });\n }\n\n var hasHandler = {\n has: function has (target, key) {\n var has = key in target;\n var isAllowed = allowedGlobals(key) || key.charAt(0) === '_';\n if (!has && !isAllowed) {\n warnNonPresent(target, key);\n }\n return has || !isAllowed\n }\n };\n\n var getHandler = {\n get: function get (target, key) {\n if (typeof key === 'string' && !(key in target)) {\n warnNonPresent(target, key);\n }\n return target[key]\n }\n };\n\n initProxy = function initProxy (vm) {\n if (hasProxy) {\n // determine which proxy handler to use\n var options = vm.$options;\n var handlers = options.render && options.render._withStripped\n ? getHandler\n : hasHandler;\n vm._renderProxy = new Proxy(vm, handlers);\n } else {\n vm._renderProxy = vm;\n }\n };\n}\n\n/* */\n\nvar seenObjects = new _Set();\n\n/**\n * Recursively traverse an object to evoke all converted\n * getters, so that every nested property inside the object\n * is collected as a \"deep\" dependency.\n */\nfunction traverse (val) {\n _traverse(val, seenObjects);\n seenObjects.clear();\n}\n\nfunction _traverse (val, seen) {\n var i, keys;\n var isA = Array.isArray(val);\n if ((!isA && !isObject(val)) || Object.isFrozen(val)) {\n return\n }\n if (val.__ob__) {\n var depId = val.__ob__.dep.id;\n if (seen.has(depId)) {\n return\n }\n seen.add(depId);\n }\n if (isA) {\n i = val.length;\n while (i--) { _traverse(val[i], seen); }\n } else {\n keys = Object.keys(val);\n i = keys.length;\n while (i--) { _traverse(val[keys[i]], seen); }\n }\n}\n\n/* */\n\nvar normalizeEvent = cached(function (name) {\n var passive = name.charAt(0) === '&';\n name = passive ? name.slice(1) : name;\n var once$$1 = name.charAt(0) === '~'; // Prefixed last, checked first\n name = once$$1 ? name.slice(1) : name;\n var capture = name.charAt(0) === '!';\n name = capture ? name.slice(1) : name;\n return {\n name: name,\n once: once$$1,\n capture: capture,\n passive: passive\n }\n});\n\nfunction createFnInvoker (fns) {\n function invoker () {\n var arguments$1 = arguments;\n\n var fns = invoker.fns;\n if (Array.isArray(fns)) {\n var cloned = fns.slice();\n for (var i = 0; i < cloned.length; i++) {\n cloned[i].apply(null, arguments$1);\n }\n } else {\n // return handler return value for single handlers\n return fns.apply(null, arguments)\n }\n }\n invoker.fns = fns;\n return invoker\n}\n\nfunction updateListeners (\n on,\n oldOn,\n add,\n remove$$1,\n vm\n) {\n var name, cur, old, event;\n for (name in on) {\n cur = on[name];\n old = oldOn[name];\n event = normalizeEvent(name);\n if (isUndef(cur)) {\n \"development\" !== 'production' && warn(\n \"Invalid handler for event \\\"\" + (event.name) + \"\\\": got \" + String(cur),\n vm\n );\n } else if (isUndef(old)) {\n if (isUndef(cur.fns)) {\n cur = on[name] = createFnInvoker(cur);\n }\n add(event.name, cur, event.once, event.capture, event.passive);\n } else if (cur !== old) {\n old.fns = cur;\n on[name] = old;\n }\n }\n for (name in oldOn) {\n if (isUndef(on[name])) {\n event = normalizeEvent(name);\n remove$$1(event.name, oldOn[name], event.capture);\n }\n }\n}\n\n/* */\n\nfunction mergeVNodeHook (def, hookKey, hook) {\n if (def instanceof VNode) {\n def = def.data.hook || (def.data.hook = {});\n }\n var invoker;\n var oldHook = def[hookKey];\n\n function wrappedHook () {\n hook.apply(this, arguments);\n // important: remove merged hook to ensure it's called only once\n // and prevent memory leak\n remove(invoker.fns, wrappedHook);\n }\n\n if (isUndef(oldHook)) {\n // no existing hook\n invoker = createFnInvoker([wrappedHook]);\n } else {\n /* istanbul ignore if */\n if (isDef(oldHook.fns) && isTrue(oldHook.merged)) {\n // already a merged invoker\n invoker = oldHook;\n invoker.fns.push(wrappedHook);\n } else {\n // existing plain hook\n invoker = createFnInvoker([oldHook, wrappedHook]);\n }\n }\n\n invoker.merged = true;\n def[hookKey] = invoker;\n}\n\n/* */\n\nfunction extractPropsFromVNodeData (\n data,\n Ctor,\n tag\n) {\n // we are only extracting raw values here.\n // validation and default values are handled in the child\n // component itself.\n var propOptions = Ctor.options.props;\n if (isUndef(propOptions)) {\n return\n }\n var res = {};\n var attrs = data.attrs;\n var props = data.props;\n if (isDef(attrs) || isDef(props)) {\n for (var key in propOptions) {\n var altKey = hyphenate(key);\n {\n var keyInLowerCase = key.toLowerCase();\n if (\n key !== keyInLowerCase &&\n attrs && hasOwn(attrs, keyInLowerCase)\n ) {\n tip(\n \"Prop \\\"\" + keyInLowerCase + \"\\\" is passed to component \" +\n (formatComponentName(tag || Ctor)) + \", but the declared prop name is\" +\n \" \\\"\" + key + \"\\\". \" +\n \"Note that HTML attributes are case-insensitive and camelCased \" +\n \"props need to use their kebab-case equivalents when using in-DOM \" +\n \"templates. You should probably use \\\"\" + altKey + \"\\\" instead of \\\"\" + key + \"\\\".\"\n );\n }\n }\n checkProp(res, props, key, altKey, true) ||\n checkProp(res, attrs, key, altKey, false);\n }\n }\n return res\n}\n\nfunction checkProp (\n res,\n hash,\n key,\n altKey,\n preserve\n) {\n if (isDef(hash)) {\n if (hasOwn(hash, key)) {\n res[key] = hash[key];\n if (!preserve) {\n delete hash[key];\n }\n return true\n } else if (hasOwn(hash, altKey)) {\n res[key] = hash[altKey];\n if (!preserve) {\n delete hash[altKey];\n }\n return true\n }\n }\n return false\n}\n\n/* */\n\n// The template compiler attempts to minimize the need for normalization by\n// statically analyzing the template at compile time.\n//\n// For plain HTML markup, normalization can be completely skipped because the\n// generated render function is guaranteed to return Array. There are\n// two cases where extra normalization is needed:\n\n// 1. When the children contains components - because a functional component\n// may return an Array instead of a single root. In this case, just a simple\n// normalization is needed - if any child is an Array, we flatten the whole\n// thing with Array.prototype.concat. It is guaranteed to be only 1-level deep\n// because functional components already normalize their own children.\nfunction simpleNormalizeChildren (children) {\n for (var i = 0; i < children.length; i++) {\n if (Array.isArray(children[i])) {\n return Array.prototype.concat.apply([], children)\n }\n }\n return children\n}\n\n// 2. When the children contains constructs that always generated nested Arrays,\n// e.g.