diff --git a/LICENSE b/LICENSE index 9a2e96a..80cc5d9 100644 --- a/LICENSE +++ b/LICENSE @@ -1,179 +1,179 @@ GNU AFFERO GENERAL PUBLIC LICENSE Version 3, 19 November 2007 -Copyright (C) 2007 Free Software Foundation, Inc. -Everyone is permitted to copy and distribute verbatim copies -of this license document, but changing it is not allowed. + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. Preamble -The GNU Affero General Public License is a free, copyleft license for + The GNU Affero General Public License is a free, copyleft license for software and other kinds of works, specifically designed to ensure cooperation with the community in the case of network server software. -The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. -When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. -Developers that use the GNU GPL protect your rights with two steps: + Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License which gives you legal permission to copy, distribute and/or modify the software. -A secondary benefit of defending all users' freedom is that + A secondary benefit of defending all users' freedom is that improvements made in alternate versions of the program, if they receive widespread use, become available for other developers to -incorporate. Many developers of free software are heartened and -encouraged by the resulting cooperation. However, in the case of +incorporate. Many developers of free software are heartened and +encouraged by the resulting cooperation. However, in the case of software used on network servers, this result may fail to come about. The GNU General Public License permits making a modified version and letting the public access it on a server without ever releasing its source code to the public. -The GNU Affero General Public License is designed specifically to + The GNU Affero General Public License is designed specifically to ensure that, in such cases, the modified source code becomes available -to the community. It requires the operator of a network server to +to the community. It requires the operator of a network server to provide the source code of the modified version running there to the -users of that server. Therefore, public use of a modified version, on +users of that server. Therefore, public use of a modified version, on a publicly accessible server, gives the public access to the source code of the modified version. -An older license, called the Affero General Public License and -published by Affero, was designed to accomplish similar goals. This + An older license, called the Affero General Public License and +published by Affero, was designed to accomplish similar goals. This is a different license, not a version of the Affero GPL, but Affero has released a new version of the Affero GPL which permits relicensing under this license. -The precise terms and conditions for copying, distribution and + The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS -0. Definitions. + 0. Definitions. -"This License" refers to version 3 of the GNU Affero General Public + "This License" refers to version 3 of the GNU Affero General Public License. -"Copyright" also means copyright-like laws that apply to other kinds + "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. -"The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. -To "modify" a work means to copy from or adapt all or part of the + To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making -of an exact copy. The resulting work is called a "modified version" +of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. -A "covered work" means either the unmodified Program or a work based + A "covered work" means either the unmodified Program or a work based on the Program. -To "propagate" a work means to do anything with it that, without + To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, +computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. -To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. -An interactive user interface displays "Appropriate Legal Notices" + An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If +work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. -1. Source Code. + 1. Source Code. -The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source form of a work. -A "Standard Interface" means an interface that either is an official + A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. -The "System Libraries" of an executable work include anything, other + The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A +implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. -The "Corresponding Source" for a work in object code form means all + The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's +control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source +which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. -The Corresponding Source need not include anything that users + The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. -The Corresponding Source for a work in source code form is that + The Corresponding Source for a work in source code form is that same work. -2. Basic Permissions. + 2. Basic Permissions. -All rights granted under this License are granted for the term of + All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your +content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. -You may make, run and propagate covered works that you do not + You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose +in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works +not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. -Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. -3. Protecting Users' Legal Rights From Anti-Circumvention Law. + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. -No covered work shall be deemed part of an effective technological + No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. -When you convey a covered work, you waive any legal power to forbid + When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or @@ -181,9 +181,9 @@ modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. -4. Conveying Verbatim Copies. + 4. Conveying Verbatim Copies. -You may convey verbatim copies of the Program's source code as you + You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any @@ -191,12 +191,12 @@ non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. -You may charge any price or no price for each copy that you convey, + You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. -5. Conveying Modified Source Versions. + 5. Conveying Modified Source Versions. -You may convey a work based on the Program, or the modifications to + You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: @@ -221,19 +221,19 @@ terms of section 4, provided that you also meet all of these conditions: interfaces that do not display Appropriate Legal Notices, your work need not make them do so. -A compilation of a covered work with other separate and independent + A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work +beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. -6. Conveying Non-Source Forms. + 6. Conveying Non-Source Forms. -You may convey a covered work in object code form under the terms + You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: @@ -279,75 +279,75 @@ in one of these ways: Source of the work are being offered to the general public at no charge under subsection 6d. -A separable portion of the object code, whose source code is excluded + A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. -A "User Product" is either (1) a "consumer product", which means any + A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product +actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. -"Installation Information" for a User Product means any methods, + "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must +a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. -If you convey an object code work under this section in, or with, or + If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply +by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). -The requirement to provide Installation Information does not include a + The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to +the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. -Corresponding Source conveyed, and Installation Information provided, + Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. -7. Additional Terms. + 7. Additional Terms. -"Additional permissions" are terms that supplement the terms of this + "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions +that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. -When you convey a copy of a covered work, you may at your option + When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. -Notwithstanding any other provision of this License, for material you + Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: @@ -374,74 +374,74 @@ of that material) supplement the terms of this License with terms: any liability that these contractual assumptions directly impose on those licensors and authors. -All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains +restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. -If you add terms to a covered work in accord with this section, you + If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. -Additional terms, permissive or non-permissive, may be stated in the + Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. -8. Termination. + 8. Termination. -You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). -However, if you cease all violation of this License, then your + However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. -Moreover, your license from a particular copyright holder is + Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. -Termination of your rights under this section does not terminate the + Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently +this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. -9. Acceptance Not Required for Having Copies. + 9. Acceptance Not Required for Having Copies. -You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, +to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. -10. Automatic Licensing of Downstream Recipients. + 10. Automatic Licensing of Downstream Recipients. -Each time you convey a covered work, the recipient automatically + Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible +propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. -An "entity transaction" is a transaction transferring control of an + An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered +organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could @@ -449,43 +449,43 @@ give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. -You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. -11. Patents. + 11. Patents. -A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". -A contributor's "essential patent claims" are all patent claims + A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For +consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. -Each contributor grants you a non-exclusive, worldwide, royalty-free + Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. -In the following three paragraphs, a "patent license" is any express + In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a +sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. -If you convey a covered work, knowingly relying on a patent license, + If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, @@ -493,13 +493,13 @@ then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have +license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. -If, pursuant to or in connection with a single transaction or + If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify @@ -507,10 +507,10 @@ or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. -A patent license is "discriminatory" if it does not include within + A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered +specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying @@ -522,74 +522,74 @@ for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. -Nothing in this License shall be construed as excluding or limiting + Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. -12. No Surrender of Others' Freedom. + 12. No Surrender of Others' Freedom. -If conditions are imposed on you (whether by court order, agreement or + If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a +excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you -may not convey it at all. For example, if you agree to terms that +may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. -13. Use with the GNU General Public License. + 13. Use with the GNU General Public License. -Notwithstanding any other provision of this License, you have + Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU General Public License into a single -combined work, and to convey the resulting work. The terms of this +combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. -14. Revised Versions of this License. + 14. Revised Versions of this License. -The Free Software Foundation may publish revised and/or new versions -of the GNU Affero General Public License from time to time. Such new + The Free Software Foundation may publish revised and/or new versions +of the GNU Affero General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. -Each version is given a distinguishing version number. If the + Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU Affero General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free -Software Foundation. If the Program does not specify a version number +Software Foundation. If the Program does not specify a version number of the GNU Affero General Public License, you may choose any version ever published by the Free Software Foundation. -If the Program specifies that a proxy can decide which future + If the Program specifies that a proxy can decide which future versions of the GNU Affero General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. -Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. -15. Disclaimer of Warranty. + 15. Disclaimer of Warranty. -THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE -PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE +PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. -16. Limitation of Liability. + 16. Limitation of Liability. -IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF @@ -599,9 +599,9 @@ YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. -17. Interpretation of Sections 15 and 16. + 17. Interpretation of Sections 15 and 16. -If the disclaimer of warranty and limitation of liability provided + If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the diff --git a/README.md b/README.md index 405ed02..deebf54 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,8 @@ [![Docker Pulls](https://img.shields.io/docker/pulls/convertx/convertx-cn?style=flat&logo=docker)](https://hub.docker.com/r/convertx/convertx-cn) [![GitHub Release](https://img.shields.io/github/v/release/pi-docket/ConvertX-CN)](https://github.com/pi-docket/ConvertX-CN/releases) -[![License AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue)](LICENSE) +![License AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue) +![Source Available](https://img.shields.io/badge/source-available-green) --- @@ -25,14 +26,14 @@ ## 📚 文件 -完整文件請參閱 **[文件中心](docs/說明文件.md)** +完整文件請參閱 **[文件中心](docs/README.md)** | 分類 | 連結 | | ----------- | -------------------------------------------------------------------------------------------------------- | | 🚀 快速入門 | [概覽](docs/快速入門/概覽.md) · [快速開始](docs/快速入門/快速開始.md) · [FAQ](docs/快速入門/常見問題.md) | | 🐳 部署指南 | [Docker](docs/部署指南/Docker.md) · [反向代理](docs/部署指南/反向代理.md) | | ⚙️ 配置設定 | [環境變數](docs/配置設定/環境變數.md) · [安全性](docs/配置設定/安全性.md) | -| 🔌 功能說明 | [轉換器](docs/功能說明/轉換器.md) · [OCR](docs/功能說明/OCR.md) · [翻譯](docs/功能說明/翻譯功能.md) | +| 🔌 功能說明 | [轉換器](docs/功能說明/轉換器.md) · [OCR](docs/功能說明/OCR.md) · [翻譯](docs/功能說明/翻譯.md) | | 🔗 API | [API 總覽](docs/API/總覽.md) · [端點說明](docs/API/端點.md) | | 👩‍💻 開發 | [專案結構](docs/開發指南/專案結構.md) · [貢獻指南](docs/開發指南/貢獻指南.md) | @@ -148,8 +149,23 @@ docker compose up -d --- -## 📄 License +## 📄 License Overview -This project is licensed under the **[GNU Affero General Public License v3.0 (AGPL-3.0)](LICENSE)**. +**This is a Mixed License / Source-Available Project.** -Based on [C4illin/ConvertX](https://github.com/C4illin/ConvertX). +### 1. Upstream Components + +Core components derived from [C4illin/ConvertX](https://github.com/C4illin/ConvertX) are licensed under **[GNU AGPL v3.0](LICENSE)**. + +- Any modifications to these files are open source under AGPL-3.0. + +### 2. Author Original Components + +Original modules, UI, i18n, and new features created by the ConvertX-CN author are licensed under **[Custom Non-Commercial License](LICENSE-AUTHOR)**. + +- **Commercial Use / SaaS**: ❌ Prohibited without written permission. +- **Personal / Research Use**: ✅ Allowed. + +> ⚠️ **Commercial Usage**: If you plan to use this project in a commercial product, SaaS, or revenue-generating service, you **must contact the author** for a license exception regarding the custom components. The AGPL obligations (sharing source code) still apply to the upstream portions. + +Check [LICENSE-OVERVIEW.md](LICENSE-OVERVIEW.md) for full details. diff --git a/docs/功能說明/OCR.md b/docs/功能說明/OCR.md index aac0db5..a770e7f 100644 --- a/docs/功能說明/OCR.md +++ b/docs/功能說明/OCR.md @@ -32,25 +32,44 @@ ConvertX-CN 完整版內建以下 OCR 語言： 1. 上傳 PDF 檔案 2. 選擇 Converter: `OCRmyPDF` -3. 選擇目標語言： - | 格式 | 說明 | - | ---- | ---- | - | `pdf-en` | English | - | `pdf-zh-TW` | 繁體中文 | - | `pdf-zh` | 簡體中文 | - | `pdf-ja` | 日本語 | - | `pdf-ko` | 한국어 | - | `pdf-de` | Deutsch | - | `pdf-fr` | Français | +3. 選擇目標格式： + + | 格式 | 說明 | 推薦場景 | + | ----------- | ------------------------------ | ---------------- | + | `pdf-ocr` | **自動檢測（多語言）** ⭐ 推薦 | 通用、多語言文件 | + | `pdf-en` | 僅英文 | 純英文文件 | + | `pdf-zh-TW` | 僅繁體中文 | 純繁體中文文件 | + | `pdf-zh` | 僅簡體中文 | 純簡體中文文件 | + | `pdf-ja` | 僅日文 | 純日文文件 | + | `pdf-ko` | 僅韓文 | 純韓文文件 | + | `pdf-de` | 僅德文 | 純德文文件 | + | `pdf-fr` | 僅法文 | 純法文文件 | + 4. 進行轉換 > 💡 **功能特點**： > +> - **自動多語言檢測**：`pdf-ocr` 模式可處理中英混排、多語言文件 > - 自動偵測頁面方向並旋轉 > - 自動校正傾斜 > - 跳過已有文字層的頁面 > - 詳細的處理進度輸出 +### 🆕 自動多語言檢測模式 + +選擇 `pdf-ocr` 時，系統會使用所有已安裝的語言包進行辨識： + +``` +eng + chi_tra + chi_sim + jpn + kor + deu + fra +``` + +**適用場景：** + +- ✅ 中英混排文件（如學術論文） +- ✅ 日英混排文件 +- ✅ 不確定文件語言時 +- ✅ 包含多種語言的文件 + ### 圖片 → 文字 1. 上傳圖片（PNG, JPG, TIFF 等） @@ -96,12 +115,17 @@ ConvertX-CN 完整版內建以下 OCR 語言： ### 處理多語言文件 -Tesseract 可同時辨識多種語言，但準確度可能下降。 +#### 方法一：使用自動檢測模式（推薦） -建議： +選擇 `pdf-ocr` 格式，系統會自動使用所有語言包進行辨識，無需手動指定語言。 -- 單一語言文件使用單一語言包 -- 中英混合使用 `chi_tra+eng` +- ✅ 無需猜測文件語言 +- ✅ 支援中英混排、多語言文件 +- ✅ 一鍵處理所有情況 + +#### 方法二：指定單一語言 + +如果確定文件只包含單一語言，可選擇對應的語言格式（如 `pdf-en`），可能獲得更高的辨識準確度。 --- diff --git a/docs/功能說明/轉換器.md b/docs/功能說明/轉換器.md index 2494ada..de9dc55 100644 --- a/docs/功能說明/轉換器.md +++ b/docs/功能說明/轉換器.md @@ -31,7 +31,7 @@ ConvertX-CN 完整版已內建 24 種轉換器，支援 1000+ 種格式。 | MinerU | PDF → MD | 7 | 2 | | PDFMathTranslate | PDF 翻譯 | 1 | 15 | | BabelDOC | PDF 翻譯 | 1 | 45 | -| OCRmyPDF | PDF OCR | 1 | 7 | +| OCRmyPDF | PDF OCR | 1 | 8 | --- @@ -435,16 +435,20 @@ PDF 翻譯引擎，支援多種輸出格式。 **輸入格式：** `pdf` -**輸出格式（7 種）：** -| OCR 語言 | 格式代碼 | -| -------- | -------- | -| 英文 | `pdf-en` | -| 繁體中文 | `pdf-zh-TW` | -| 簡體中文 | `pdf-zh` | -| 日文 | `pdf-ja` | -| 韓文 | `pdf-ko` | -| 德文 | `pdf-de` | -| 法文 | `pdf-fr` | +**輸出格式（8 種）：** + +| 格式代碼 | 說明 | 推薦場景 | +| ----------- | ------------------------------ | ---------------- | +| `pdf-ocr` | **自動檢測（多語言）** ⭐ 推薦 | 通用、多語言文件 | +| `pdf-en` | 僅英文 | 純英文文件 | +| `pdf-zh-TW` | 僅繁體中文 | 純繁體中文文件 | +| `pdf-zh` | 僅簡體中文 | 純簡體中文文件 | +| `pdf-ja` | 僅日文 | 純日文文件 | +| `pdf-ko` | 僅韓文 | 純韓文文件 | +| `pdf-de` | 僅德文 | 純德文文件 | +| `pdf-fr` | 僅法文 | 純法文文件 | + +> 💡 **自動多語言檢測**：選擇 `pdf-ocr` 可處理中英混排等多語言文件，無需手動指定語言。 --- diff --git a/src/converters/mineru.ts b/src/converters/mineru.ts index 31db52b..b11c1fb 100644 --- a/src/converters/mineru.ts +++ b/src/converters/mineru.ts @@ -87,8 +87,9 @@ export async function convert( const runMinerU = (useTableMode: boolean): Promise => { return new Promise((resolve, reject) => { // Build MinerU command arguments - // MinerU CLI: mineru -p -o -m auto - const args = ["-p", filePath, "-o", mineruOutputDir, "-m", "auto"]; + // MinerU CLI: mineru -p -o -m pipeline + // 注意：使用 pipeline 模式而非 auto，避免 VLM 模型未配置的問題 + const args = ["-p", filePath, "-o", mineruOutputDir, "-m", "pipeline"]; // 表格模式支援（可能與某些 vLLM 版本不相容） if (useTableMode) { diff --git a/src/converters/ocrmypdf.ts b/src/converters/ocrmypdf.ts index 1117aa0..5567cda 100644 --- a/src/converters/ocrmypdf.ts +++ b/src/converters/ocrmypdf.ts @@ -18,12 +18,18 @@ import type { ExecFileFn } from "./types"; * - deu: 德文 * - fra: 法文 * - * UI 顯示格式（與 PDFMathTranslate 風格一致）： - * pdf-en, pdf-zh-TW, pdf-ja 等 + * UI 顯示格式： + * - pdf-ocr: 自動檢測語言（推薦，支援多語言文件） + * - pdf-en, pdf-zh-TW, pdf-ja 等：指定單一語言 + * + * 多語言自動檢測模式： + * 使用 Tesseract 的多語言組合 eng+chi_tra+chi_sim+jpn+kor+deu+fra + * 可處理包含多種語言的文件（如中英混排） */ -// 內建支援的 OCR 語言（與 PDFMathTranslate 風格一致） +// 內建支援的 OCR 語言 const SUPPORTED_LANGUAGES = [ + "ocr", // 自動檢測（多語言）- 推薦 "en", // English "zh-TW", // 繁體中文 "zh", // 簡體中文 @@ -35,6 +41,10 @@ const SUPPORTED_LANGUAGES = [ // Tesseract 語言代碼映射（UI 代碼 → Tesseract 代碼） const LANG_MAP: Record = { + // 自動檢測模式：使用所有已安裝的語言包 + // 順序：英文優先（最常見），然後是 CJK 語言，最後是歐洲語言 + ocr: "eng+chi_tra+chi_sim+jpn+kor+deu+fra", + auto: "eng+chi_tra+chi_sim+jpn+kor+deu+fra", en: "eng", "zh-TW": "chi_tra", zh: "chi_sim", @@ -53,6 +63,11 @@ export const properties = { }, }; +// 建立大小寫不敏感的語言映射查找表 +const LANG_MAP_LOWER: Record = Object.fromEntries( + Object.entries(LANG_MAP).map(([k, v]) => [k.toLowerCase(), v]), +); + /** * 從 convertTo 格式中提取 OCR 語言 * @param convertTo 格式如 "pdf-en" 或 "pdf-zh-TW" @@ -60,14 +75,14 @@ export const properties = { */ function extractOcrLanguage(convertTo: string): string { // convertTo 格式: pdf- - const match = convertTo.match(/^pdf-(.+)$/); + const match = convertTo.match(/^pdf-(.+)$/i); if (!match || !match[1]) { throw new Error(`Invalid convertTo format: ${convertTo}. Expected pdf-`); } const uiLang = match[1]; - // 轉換為 Tesseract 語言代碼 - const tessLang = LANG_MAP[uiLang] || uiLang.replace(/-/g, "_"); + // 轉換為 Tesseract 語言代碼（大小寫不敏感查找） + const tessLang = LANG_MAP_LOWER[uiLang.toLowerCase()] || uiLang.replace(/-/g, "_"); return tessLang; } @@ -111,7 +126,13 @@ function runOcrMyPdf( // 階段 2：準備 OCR 參數 console.log(`[OCRmyPDF] 📋 階段 2/5：準備 OCR 參數`); - console.log(`[OCRmyPDF] ✅ OCR 語言: ${lang}`); + const isMultiLang = lang.includes("+"); + if (isMultiLang) { + console.log(`[OCRmyPDF] ✅ OCR 模式: 多語言自動檢測`); + console.log(`[OCRmyPDF] ✅ 語言包: ${lang.split("+").join(", ")}`); + } else { + console.log(`[OCRmyPDF] ✅ OCR 語言: ${lang}`); + } const args = [ "-l", diff --git a/src/helpers/printVersions.ts b/src/helpers/printVersions.ts index 463384b..ff578e9 100644 --- a/src/helpers/printVersions.ts +++ b/src/helpers/printVersions.ts @@ -44,7 +44,7 @@ const tools = [ formatter: (s: string) => s.split("\n")[0], }, { - cmd: "magick --version", + cmd: "convert --version", name: "ImageMagick", errorMsg: "ImageMagick is not installed.", formatter: (s: string) => s.split("\n")[0]?.replace("Version: ", ""), @@ -98,10 +98,10 @@ const tools = [ formatter: (s: string) => s.split("\n")[0], }, { - cmd: "heif-info -v", + cmd: "dpkg -l libheif1 | tail -1 | awk '{print $3}'", name: "libheif", errorMsg: "libheif is not installed", - formatter: (s: string) => `libheif v${s.split("\n")[0]}`, + formatter: (s: string) => `libheif v${s.trim()}`, }, { cmd: "potrace -v", @@ -116,10 +116,13 @@ const tools = [ formatter: (s: string) => s.split("\n")[0], }, { - cmd: "msgconvert --version", + cmd: "which msgconvert && dpkg -l libemail-outlook-message-perl | tail -1 | awk '{print $3}'", name: "msgconvert", errorMsg: "msgconvert (libemail-outlook-message-perl) is not installed", - formatter: (s: string) => s.split("\n")[0], + formatter: (s: string) => { + const lines = s.split("\n").filter((l) => l.trim()); + return `msgconvert v${lines[lines.length - 1] || "unknown"}`; + }, }, { cmd: "bun -v", diff --git a/tests/converters/formats.test.ts b/tests/converters/formats.test.ts new file mode 100644 index 0000000..00b6dd5 --- /dev/null +++ b/tests/converters/formats.test.ts @@ -0,0 +1,1123 @@ +/** + * 格式完整性測試 + * + * 此測試驗證所有轉換器的格式宣告是否完整且正確。 + * 確保文件中列出的格式與程式碼中宣告的格式一致。 + */ + +import { describe, expect, test } from "bun:test"; + +// 匯入所有轉換器的 properties +import { properties as ffmpegProps } from "../../src/converters/ffmpeg"; +import { properties as imagemagickProps } from "../../src/converters/imagemagick"; +import { properties as graphicsmagickProps } from "../../src/converters/graphicsmagick"; +import { properties as vipsProps } from "../../src/converters/vips"; +import { properties as libreofficeProps } from "../../src/converters/libreoffice"; +import { properties as pandocProps } from "../../src/converters/pandoc"; +import { properties as calibreProps } from "../../src/converters/calibre"; +import { properties as inkscapeProps } from "../../src/converters/inkscape"; +import { properties as libjxlProps } from "../../src/converters/libjxl"; +import { properties as libheifProps } from "../../src/converters/libheif"; +import { properties as assimpProps } from "../../src/converters/assimp"; +import { properties as potraceProps } from "../../src/converters/potrace"; +import { properties as vtracerProps } from "../../src/converters/vtracer"; +import { properties as resvgProps } from "../../src/converters/resvg"; +import { properties as xelatexProps } from "../../src/converters/xelatex"; +import { properties as dvisvgmProps } from "../../src/converters/dvisvgm"; +import { properties as daselProps } from "../../src/converters/dasel"; +import { properties as msgconvertProps } from "../../src/converters/msgconvert"; +import { properties as vcfProps } from "../../src/converters/vcf"; +import { properties as markitdownProps } from "../../src/converters/markitdown"; +import { properties as mineruProps } from "../../src/converters/mineru"; +import { properties as pdfmathtranslateProps } from "../../src/converters/pdfmathtranslate"; +import { properties as babeldocProps } from "../../src/converters/babeldoc"; +import { properties as ocrmypdfProps } from "../../src/converters/ocrmypdf"; + +// ============================================================================ +// FFmpeg 格式測試 +// ============================================================================ +describe("FFmpeg 格式", () => { + const fromFormats = ffmpegProps.from.muxer; + const toFormats = ffmpegProps.to.muxer; + + // 關鍵影片格式（wmv 由 asf 處理） + const keyVideoFormats = ["264", "265", "3g2", "3gp", "asf", "av1", "avi", "flv", "h264", "h265", "hevc", "mkv", "mov", "mp4", "mpeg", "mpg", "webm"]; + // 關鍵音訊格式 + const keyAudioFormats = ["aac", "ac3", "aiff", "flac", "m4a", "mp3", "ogg", "opus", "wav", "wma"]; + // 關鍵字幕格式 + const keySubtitleFormats = ["ass", "srt", "ssa", "sub", "vtt"]; + // 關鍵圖片格式 + const keyImageFormats = ["apng", "avif", "bmp", "gif", "jpeg", "jxl", "png", "webp"]; + + test("應包含關鍵影片輸入格式", () => { + for (const format of keyVideoFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵音訊輸入格式", () => { + for (const format of keyAudioFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵字幕輸入格式", () => { + for (const format of keySubtitleFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵圖片輸入格式", () => { + for (const format of keyImageFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 450 種", () => { + expect(fromFormats.length).toBeGreaterThan(450); + console.log(`FFmpeg 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 180 種", () => { + expect(toFormats.length).toBeGreaterThan(180); + console.log(`FFmpeg 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + // 驗證所有格式都是字串 + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + // 驗證所有格式都是字串 + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// ImageMagick 格式測試 +// ============================================================================ +describe("ImageMagick 格式", () => { + const fromFormats = imagemagickProps.from.images; + const toFormats = imagemagickProps.to.images; + + // 關鍵 RAW 相機格式 + const keyRawFormats = ["arw", "cr2", "cr3", "dng", "nef", "orf", "raf"]; + // 關鍵常見圖片格式 + const keyImageFormats = ["apng", "avif", "bmp", "gif", "heic", "heif", "ico", "jpeg", "jpg", "jxl", "png", "tiff", "webp"]; + // 關鍵向量格式 + const keyVectorFormats = ["eps", "pdf", "ps", "psd", "svg"]; + + test("應包含關鍵 RAW 相機格式", () => { + for (const format of keyRawFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵常見圖片格式", () => { + for (const format of keyImageFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵向量格式", () => { + for (const format of keyVectorFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 200 種", () => { + expect(fromFormats.length).toBeGreaterThan(200); + console.log(`ImageMagick 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 150 種", () => { + expect(toFormats.length).toBeGreaterThan(150); + console.log(`ImageMagick 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// GraphicsMagick 格式測試 +// ============================================================================ +describe("GraphicsMagick 格式", () => { + // GraphicsMagick 使用 'image' 而非 'images' + const fromFormats = graphicsmagickProps.from.image; + const toFormats = graphicsmagickProps.to.image; + + const keyFormats = ["bmp", "gif", "jpeg", "jpg", "png", "tiff", "webp"]; + + test("應包含關鍵圖片格式", () => { + for (const format of keyFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 100 種", () => { + expect(fromFormats.length).toBeGreaterThan(100); + console.log(`GraphicsMagick 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 80 種", () => { + expect(toFormats.length).toBeGreaterThan(80); + console.log(`GraphicsMagick 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// Vips 格式測試 +// ============================================================================ +describe("Vips 格式", () => { + const fromFormats = vipsProps.from.images; + const toFormats = vipsProps.to.images; + + const keyFormats = ["avif", "gif", "heic", "heif", "jpeg", "jxl", "png", "tiff", "webp"]; + + test("應包含關鍵圖片格式", () => { + for (const format of keyFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 30 種", () => { + expect(fromFormats.length).toBeGreaterThan(30); + console.log(`Vips 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 15 種", () => { + expect(toFormats.length).toBeGreaterThan(15); + console.log(`Vips 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// LibreOffice 格式測試 +// ============================================================================ +describe("LibreOffice 格式", () => { + // LibreOffice 使用 'text' 而非 'document' + const fromFormats = libreofficeProps.from.text; + const toFormats = libreofficeProps.to.text; + + const keyFormats = ["doc", "docx", "html", "odt", "pdf", "rtf", "txt"]; + + test("應包含關鍵文件格式", () => { + for (const format of keyFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 30 種", () => { + expect(fromFormats.length).toBeGreaterThan(30); + console.log(`LibreOffice 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 15 種", () => { + expect(toFormats.length).toBeGreaterThan(15); + console.log(`LibreOffice 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// Pandoc 格式測試 +// ============================================================================ +describe("Pandoc 格式", () => { + // Pandoc 使用 'text' 而非 'document' + const fromFormats = pandocProps.from.text; + const toFormats = pandocProps.to.text; + + const keyInputFormats = ["docx", "epub", "html", "latex", "markdown", "org", "rst", "rtf"]; + const keyOutputFormats = ["docx", "epub", "html", "latex", "markdown", "odt", "pdf", "pptx"]; + + test("應包含關鍵輸入格式", () => { + for (const format of keyInputFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵輸出格式", () => { + for (const format of keyOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 35 種", () => { + expect(fromFormats.length).toBeGreaterThan(35); + console.log(`Pandoc 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 55 種", () => { + expect(toFormats.length).toBeGreaterThan(55); + console.log(`Pandoc 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// Calibre 格式測試 +// ============================================================================ +describe("Calibre 格式", () => { + // Calibre 使用 'document' 而非 'ebook' + const fromFormats = calibreProps.from.document; + const toFormats = calibreProps.to.document; + + const keyFormats = ["cbz", "epub", "mobi", "pdf"]; + + test("應包含關鍵電子書格式", () => { + for (const format of keyFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 20 種", () => { + expect(fromFormats.length).toBeGreaterThan(20); + console.log(`Calibre 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 15 種", () => { + expect(toFormats.length).toBeGreaterThan(15); + console.log(`Calibre 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// Inkscape 格式測試 +// ============================================================================ +describe("Inkscape 格式", () => { + const fromFormats = inkscapeProps.from.images; + const toFormats = inkscapeProps.to.images; + + const keyInputFormats = ["svg", "pdf", "eps", "png"]; + const keyOutputFormats = ["svg", "pdf", "eps", "png", "dxf"]; + + test("應包含關鍵輸入格式", () => { + for (const format of keyInputFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵輸出格式", () => { + for (const format of keyOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 5 種", () => { + expect(fromFormats.length).toBeGreaterThan(5); + console.log(`Inkscape 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 10 種", () => { + expect(toFormats.length).toBeGreaterThan(10); + console.log(`Inkscape 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// libjxl 格式測試 +// ============================================================================ +describe("libjxl 格式", () => { + const jxlFromFormats = libjxlProps.from.jxl; + const imagesFromFormats = libjxlProps.from.images; + const jxlToFormats = libjxlProps.to.jxl; + const imagesToFormats = libjxlProps.to.images; + + test("應包含 jxl 輸入格式", () => { + expect(jxlFromFormats).toContain("jxl"); + }); + + test("應包含常見圖片輸入格式", () => { + const keyFormats = ["jpeg", "png"]; + for (const format of keyFormats) { + expect(imagesFromFormats).toContain(format); + } + }); + + test("輸入格式總數應大於 8 種", () => { + const total = jxlFromFormats.length + imagesFromFormats.length; + expect(total).toBeGreaterThan(8); + console.log(`libjxl 輸入格式：${total} 種`); + }); + + test("輸出格式總數應大於 8 種", () => { + const total = jxlToFormats.length + imagesToFormats.length; + expect(total).toBeGreaterThan(8); + console.log(`libjxl 輸出格式：${total} 種`); + }); +}); + +// ============================================================================ +// libheif 格式測試 +// ============================================================================ +describe("libheif 格式", () => { + const fromFormats = libheifProps.from.images; + const toFormats = libheifProps.to.images; + + const keyInputFormats = ["avif", "heic", "heif"]; + const keyOutputFormats = ["jpeg", "png"]; + + test("應包含關鍵輸入格式", () => { + for (const format of keyInputFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵輸出格式", () => { + for (const format of keyOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 8 種", () => { + expect(fromFormats.length).toBeGreaterThan(8); + console.log(`libheif 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 3 種", () => { + expect(toFormats.length).toBe(3); + console.log(`libheif 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// Assimp 格式測試 +// ============================================================================ +describe("Assimp 格式", () => { + // Assimp 使用 'object' 而非 'model' + const fromFormats = assimpProps.from.object; + const toFormats = assimpProps.to.object; + + const keyInputFormats = ["3ds", "blend", "dae", "fbx", "glb", "gltf", "obj", "stl"]; + const keyOutputFormats = ["3ds", "dae", "fbx", "glb", "gltf", "obj", "stl"]; + + test("應包含關鍵 3D 輸入格式", () => { + for (const format of keyInputFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵 3D 輸出格式", () => { + for (const format of keyOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應大於 60 種", () => { + expect(fromFormats.length).toBeGreaterThan(60); + console.log(`Assimp 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 18 種", () => { + expect(toFormats.length).toBeGreaterThan(18); + console.log(`Assimp 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// Potrace 格式測試 +// ============================================================================ +describe("Potrace 格式", () => { + const fromFormats = potraceProps.from.images; + const toFormats = potraceProps.to.images; + + const keyInputFormats = ["bmp", "pbm", "pgm", "pnm"]; + const keyOutputFormats = ["svg", "pdf", "eps", "dxf"]; + + test("應包含關鍵輸入格式", () => { + for (const format of keyInputFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵輸出格式", () => { + for (const format of keyOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應等於 4 種", () => { + expect(fromFormats.length).toBe(4); + console.log(`Potrace 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應大於 8 種", () => { + expect(toFormats.length).toBeGreaterThan(8); + console.log(`Potrace 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// VTracer 格式測試 +// ============================================================================ +describe("VTracer 格式", () => { + const fromFormats = vtracerProps.from.images; + const toFormats = vtracerProps.to.images; + + const keyInputFormats = ["jpg", "jpeg", "png", "bmp", "gif", "webp"]; + + test("應包含關鍵輸入格式", () => { + for (const format of keyInputFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("輸出格式應為 svg", () => { + expect(toFormats).toContain("svg"); + }); + + test("輸入格式數量應等於 8 種", () => { + expect(fromFormats.length).toBe(8); + console.log(`VTracer 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 1 種", () => { + expect(toFormats.length).toBe(1); + console.log(`VTracer 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// resvg 格式測試 +// ============================================================================ +describe("resvg 格式", () => { + const fromFormats = resvgProps.from.images; + const toFormats = resvgProps.to.images; + + test("輸入格式應為 svg", () => { + expect(fromFormats).toContain("svg"); + }); + + test("輸出格式應為 png", () => { + expect(toFormats).toContain("png"); + }); + + test("輸入格式數量應等於 1 種", () => { + expect(fromFormats.length).toBe(1); + console.log(`resvg 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 1 種", () => { + expect(toFormats.length).toBe(1); + console.log(`resvg 輸出格式：${toFormats.length} 種`); + }); +}); + +// ============================================================================ +// XeLaTeX 格式測試 +// ============================================================================ +describe("XeLaTeX 格式", () => { + // XeLaTeX 使用 'text' 而非 'latex' + const fromFormats = xelatexProps.from.text; + const toFormats = xelatexProps.to.text; + + test("輸入格式應包含 tex 和 latex", () => { + expect(fromFormats).toContain("tex"); + expect(fromFormats).toContain("latex"); + }); + + test("輸出格式應為 pdf", () => { + expect(toFormats).toContain("pdf"); + }); + + test("輸入格式數量應等於 2 種", () => { + expect(fromFormats.length).toBe(2); + console.log(`XeLaTeX 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 1 種", () => { + expect(toFormats.length).toBe(1); + console.log(`XeLaTeX 輸出格式：${toFormats.length} 種`); + }); +}); + +// ============================================================================ +// dvisvgm 格式測試 +// ============================================================================ +describe("dvisvgm 格式", () => { + const fromFormats = dvisvgmProps.from.images; + const toFormats = dvisvgmProps.to.images; + + const keyInputFormats = ["dvi", "pdf", "eps"]; + const keyOutputFormats = ["svg", "svgz"]; + + test("應包含關鍵輸入格式", () => { + for (const format of keyInputFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵輸出格式", () => { + for (const format of keyOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應等於 4 種", () => { + expect(fromFormats.length).toBe(4); + console.log(`dvisvgm 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 2 種", () => { + expect(toFormats.length).toBe(2); + console.log(`dvisvgm 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// Dasel 格式測試 +// ============================================================================ +describe("Dasel 格式", () => { + // Dasel 使用 'document' 而非 'data' + const fromFormats = daselProps.from.document; + const toFormats = daselProps.to.document; + + const keyFormats = ["json", "yaml", "toml", "xml", "csv"]; + + test("應包含關鍵資料格式", () => { + for (const format of keyFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("輸入格式數量應等於 5 種", () => { + expect(fromFormats.length).toBe(5); + console.log(`Dasel 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 4 種", () => { + expect(toFormats.length).toBe(4); + console.log(`Dasel 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// msgconvert 格式測試 +// ============================================================================ +describe("msgconvert 格式", () => { + const fromFormats = msgconvertProps.from.email; + const toFormats = msgconvertProps.to.email; + + test("輸入格式應為 msg", () => { + expect(fromFormats).toContain("msg"); + }); + + test("輸出格式應為 eml", () => { + expect(toFormats).toContain("eml"); + }); + + test("輸入格式數量應等於 1 種", () => { + expect(fromFormats.length).toBe(1); + console.log(`msgconvert 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 1 種", () => { + expect(toFormats.length).toBe(1); + console.log(`msgconvert 輸出格式：${toFormats.length} 種`); + }); +}); + +// ============================================================================ +// VCF 格式測試 +// ============================================================================ +describe("VCF 格式", () => { + const fromFormats = vcfProps.from.contacts; + const toFormats = vcfProps.to.contacts; + + test("輸入格式應為 vcf", () => { + expect(fromFormats).toContain("vcf"); + }); + + test("輸出格式應為 csv", () => { + expect(toFormats).toContain("csv"); + }); + + test("輸入格式數量應等於 1 種", () => { + expect(fromFormats.length).toBe(1); + console.log(`VCF 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 1 種", () => { + expect(toFormats.length).toBe(1); + console.log(`VCF 輸出格式：${toFormats.length} 種`); + }); +}); + +// ============================================================================ +// Markitdown 格式測試 +// ============================================================================ +describe("Markitdown 格式", () => { + const fromFormats = markitdownProps.from.document; + const toFormats = markitdownProps.to.document; + + const keyInputFormats = ["pdf", "docx", "pptx", "html"]; + + test("應包含關鍵輸入格式", () => { + for (const format of keyInputFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("輸出格式應為 md", () => { + expect(toFormats).toContain("md"); + }); + + test("輸入格式數量應等於 6 種", () => { + expect(fromFormats.length).toBe(6); + console.log(`Markitdown 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 1 種", () => { + expect(toFormats.length).toBe(1); + console.log(`Markitdown 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// MinerU 格式測試 +// ============================================================================ +describe("MinerU 格式", () => { + const fromFormats = mineruProps.from.document; + const toFormats = mineruProps.to.document; + + const keyInputFormats = ["pdf", "ppt", "pptx", "doc", "docx"]; + const keyOutputFormats = ["md-t", "md-i"]; + + test("應包含關鍵輸入格式", () => { + for (const format of keyInputFormats) { + expect(fromFormats).toContain(format); + } + }); + + test("應包含關鍵輸出格式", () => { + for (const format of keyOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應等於 7 種", () => { + expect(fromFormats.length).toBe(7); + console.log(`MinerU 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 2 種", () => { + expect(toFormats.length).toBe(2); + console.log(`MinerU 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸入格式（完整驗證）", () => { + for (const format of fromFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + } + }); +}); + +// ============================================================================ +// PDFMathTranslate 格式測試 +// ============================================================================ +describe("PDFMathTranslate 格式", () => { + const fromFormats = pdfmathtranslateProps.from.document; + const toFormats = pdfmathtranslateProps.to.document; + + const keyOutputFormats = [ + "pdf-en", "pdf-zh", "pdf-zh-TW", "pdf-ja", "pdf-ko", + "pdf-de", "pdf-fr", "pdf-es", "pdf-it", "pdf-ru" + ]; + + test("輸入格式應為 pdf", () => { + expect(fromFormats).toContain("pdf"); + }); + + test("應包含關鍵輸出格式", () => { + for (const format of keyOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應等於 1 種", () => { + expect(fromFormats.length).toBe(1); + console.log(`PDFMathTranslate 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 15 種", () => { + expect(toFormats.length).toBe(15); + console.log(`PDFMathTranslate 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + // 驗證格式為 pdf- + expect(format).toMatch(/^pdf-.+$/); + } + }); +}); + +// ============================================================================ +// BabelDOC 格式測試 +// ============================================================================ +describe("BabelDOC 格式", () => { + const fromFormats = babeldocProps.from.document; + const toFormats = babeldocProps.to.document; + + // PDF 輸出格式 + const pdfOutputFormats = ["pdf-en", "pdf-zh", "pdf-zh-TW", "pdf-ja", "pdf-ko"]; + // Markdown 輸出格式 + const mdOutputFormats = ["md-en", "md-zh", "md-zh-TW", "md-ja", "md-ko"]; + // HTML 輸出格式 + const htmlOutputFormats = ["html-en", "html-zh", "html-zh-TW", "html-ja", "html-ko"]; + + test("輸入格式應為 pdf", () => { + expect(fromFormats).toContain("pdf"); + }); + + test("應包含 PDF 輸出格式", () => { + for (const format of pdfOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("應包含 Markdown 輸出格式", () => { + for (const format of mdOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("應包含 HTML 輸出格式", () => { + for (const format of htmlOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應等於 1 種", () => { + expect(fromFormats.length).toBe(1); + console.log(`BabelDOC 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 45 種（3 格式 x 15 語言）", () => { + expect(toFormats.length).toBe(45); + console.log(`BabelDOC 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + // 驗證格式為 - + expect(format).toMatch(/^(pdf|md|html)-.+$/); + } + }); +}); + +// ============================================================================ +// OCRmyPDF 格式測試 +// ============================================================================ +describe("OCRmyPDF 格式", () => { + const fromFormats = ocrmypdfProps.from.document; + const toFormats = ocrmypdfProps.to.document; + + const keyOutputFormats = [ + "pdf-en", "pdf-zh-TW", "pdf-zh", "pdf-ja", "pdf-ko", "pdf-de", "pdf-fr" + ]; + + test("輸入格式應為 pdf", () => { + expect(fromFormats).toContain("pdf"); + }); + + test("應包含關鍵輸出格式", () => { + for (const format of keyOutputFormats) { + expect(toFormats).toContain(format); + } + }); + + test("輸入格式數量應等於 1 種", () => { + expect(fromFormats.length).toBe(1); + console.log(`OCRmyPDF 輸入格式：${fromFormats.length} 種`); + }); + + test("輸出格式數量應等於 7 種", () => { + expect(toFormats.length).toBe(7); + console.log(`OCRmyPDF 輸出格式：${toFormats.length} 種`); + }); + + test("應包含所有實際輸出格式（完整驗證）", () => { + for (const format of toFormats) { + expect(typeof format).toBe("string"); + expect(format.length).toBeGreaterThan(0); + // 驗證格式為 pdf- + expect(format).toMatch(/^pdf-.+$/); + } + }); +}); + +// ============================================================================ +// 格式總覽測試 +// ============================================================================ +describe("格式總覽", () => { + test("所有 24 個轉換器都有定義格式", () => { + // 驗證所有轉換器的 properties 都存在 + expect(ffmpegProps).toBeDefined(); + expect(imagemagickProps).toBeDefined(); + expect(graphicsmagickProps).toBeDefined(); + expect(vipsProps).toBeDefined(); + expect(libreofficeProps).toBeDefined(); + expect(pandocProps).toBeDefined(); + expect(calibreProps).toBeDefined(); + expect(inkscapeProps).toBeDefined(); + expect(libjxlProps).toBeDefined(); + expect(libheifProps).toBeDefined(); + expect(assimpProps).toBeDefined(); + expect(potraceProps).toBeDefined(); + expect(vtracerProps).toBeDefined(); + expect(resvgProps).toBeDefined(); + expect(xelatexProps).toBeDefined(); + expect(dvisvgmProps).toBeDefined(); + expect(daselProps).toBeDefined(); + expect(msgconvertProps).toBeDefined(); + expect(vcfProps).toBeDefined(); + expect(markitdownProps).toBeDefined(); + expect(mineruProps).toBeDefined(); + expect(pdfmathtranslateProps).toBeDefined(); + expect(babeldocProps).toBeDefined(); + expect(ocrmypdfProps).toBeDefined(); + }); + + test("輸出格式總覽", () => { + console.log("\n=== 轉換器格式總覽 ===\n"); + + const summary = [ + { name: "FFmpeg", from: ffmpegProps.from.muxer.length, to: ffmpegProps.to.muxer.length }, + { name: "ImageMagick", from: imagemagickProps.from.images.length, to: imagemagickProps.to.images.length }, + { name: "GraphicsMagick", from: graphicsmagickProps.from.image.length, to: graphicsmagickProps.to.image.length }, + { name: "Vips", from: vipsProps.from.images.length, to: vipsProps.to.images.length }, + { name: "LibreOffice", from: libreofficeProps.from.text.length, to: libreofficeProps.to.text.length }, + { name: "Pandoc", from: pandocProps.from.text.length, to: pandocProps.to.text.length }, + { name: "Calibre", from: calibreProps.from.document.length, to: calibreProps.to.document.length }, + { name: "Inkscape", from: inkscapeProps.from.images.length, to: inkscapeProps.to.images.length }, + { name: "libjxl", from: libjxlProps.from.jxl.length + libjxlProps.from.images.length, to: libjxlProps.to.jxl.length + libjxlProps.to.images.length }, + { name: "libheif", from: libheifProps.from.images.length, to: libheifProps.to.images.length }, + { name: "Assimp", from: assimpProps.from.object.length, to: assimpProps.to.object.length }, + { name: "Potrace", from: potraceProps.from.images.length, to: potraceProps.to.images.length }, + { name: "VTracer", from: vtracerProps.from.images.length, to: vtracerProps.to.images.length }, + { name: "resvg", from: resvgProps.from.images.length, to: resvgProps.to.images.length }, + { name: "XeLaTeX", from: xelatexProps.from.text.length, to: xelatexProps.to.text.length }, + { name: "dvisvgm", from: dvisvgmProps.from.images.length, to: dvisvgmProps.to.images.length }, + { name: "Dasel", from: daselProps.from.document.length, to: daselProps.to.document.length }, + { name: "msgconvert", from: msgconvertProps.from.email.length, to: msgconvertProps.to.email.length }, + { name: "VCF", from: vcfProps.from.contacts.length, to: vcfProps.to.contacts.length }, + { name: "Markitdown", from: markitdownProps.from.document.length, to: markitdownProps.to.document.length }, + { name: "MinerU", from: mineruProps.from.document.length, to: mineruProps.to.document.length }, + { name: "PDFMathTranslate", from: pdfmathtranslateProps.from.document.length, to: pdfmathtranslateProps.to.document.length }, + { name: "BabelDOC", from: babeldocProps.from.document.length, to: babeldocProps.to.document.length }, + { name: "OCRmyPDF", from: ocrmypdfProps.from.document.length, to: ocrmypdfProps.to.document.length }, + ]; + + let totalFrom = 0; + let totalTo = 0; + + for (const item of summary) { + console.log(`${item.name}: ${item.from} 輸入 / ${item.to} 輸出`); + totalFrom += item.from; + totalTo += item.to; + } + + console.log(`\n總計：${totalFrom} 輸入格式 / ${totalTo} 輸出格式`); + console.log(`（注意：部分格式在不同轉換器中重複）`); + + expect(true).toBe(true); + }); +});