diff --git a/LICENSE b/LICENSE
index cb069f5..4fdaf2a 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,662 +1,21 @@
- GNU AFFERO GENERAL PUBLIC LICENSE
- Version 3, 19 November 2007
-
- Copyright (C) 2026-present metamorphosis-dev
-
- 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
-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,
-our General Public Licenses are 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
-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 our General Public Licenses 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
-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
-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
-ensure that, in such cases, the modified source code becomes available
-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
-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 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
-modification follow.
-
- TERMS AND CONDITIONS
-
- 0. Definitions.
-
- "This License" refers to version 3 of the GNU Affero General Public License.
-
- "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
-"recipients" may be individuals or organizations.
-
- 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 the
-earlier work or a work "based on" the earlier work.
-
- 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
-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,
-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
-a computer network, with no transfer of a copy, is not conveying.
-
- 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
-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.
-
- 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
-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
-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
-"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 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
-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
-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
-can regenerate automatically from other parts of the Corresponding
-Source.
-
- The Corresponding Source for a work in source code form is that
-same work.
-
- 2. Basic Permissions.
-
- 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
-covered work is covered by this License only if the output, given its
-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
-convey, without conditions so long as your license otherwise remains
-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
-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
-makes it unnecessary.
-
- 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
-
- 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
-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
-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.
-
- 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
-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,
-and you may offer support or warranty protection for a fee.
-
- 5. Conveying Modified Source Versions.
-
- 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:
-
- a) The work must carry prominent notices stating that you modified
- it, and giving a relevant date.
-
- b) The work must carry prominent notices stating that it is
- released under this License and any conditions added under section
- 7. This requirement modifies the requirement in section 4 to
- "keep intact all notices".
-
- c) You must license the entire work, as a whole, under this
- License to anyone who comes into possession of a copy. This
- License will therefore apply, along with any applicable section 7
- additional terms, to the whole of the work, and all its parts,
- regardless of how they are packaged. This License gives no
- permission to license the work in any other way, but it does not
- invalidate such permission if you have separately received it.
-
- d) If the work has interactive user interfaces, each must display
- Appropriate Legal Notices; however, if the Program has interactive
- 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
-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
-in an aggregate does not cause this License to apply to the other
-parts of the aggregate.
-
- 6. Conveying Non-Source Forms.
-
- 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:
-
- a) Convey the object code in, or embodied in, a physical product
- (including a physical distribution medium), accompanied by the
- Corresponding Source fixed on a durable physical medium
- customarily used for software interchange.
-
- b) Convey the object code in, or embodied in, a physical product
- (including a physical distribution medium), accompanied by a
- written offer, valid for at least three years and valid for as
- long as you offer spare parts or customer support for that product
- model, to give anyone who possesses the object code either (1) a
- copy of the Corresponding Source for all the software in the
- product that is covered by this License, on a durable physical
- medium customarily used for software interchange, for a price no
- more than your reasonable cost of physically performing this
- conveying of source, or (2) access to copy the Corresponding
- Source from a network server at no charge.
-
- c) Convey individual copies of the object code with a copy of the
- written offer to provide the Corresponding Source. This
- alternative is allowed only occasionally and noncommercially, and
- only if you received the object code with such an offer, in accord
- with subsection 6b.
-
- d) Convey the object code by offering access from a designated
- place (gratis or for a charge), and offer equivalent access to the
- Corresponding Source in the same way through the same place at no
- further charge. You need not require recipients to copy the
- Corresponding Source along with the object code. If the place to
- copy the object code is a network server, the Corresponding Source
- may be on a different server (operated by you or a third party)
- that supports equivalent copying facilities, provided you maintain
- clear directions next to the object code saying where to find the
- Corresponding Source. Regardless of what server hosts the
- Corresponding Source, you remain obligated to ensure that it is
- available for as long as needed to satisfy these requirements.
-
- e) Convey the object code using peer-to-peer transmission, provided
- you inform other peers where the object code and Corresponding
- 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
-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
-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
-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
-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,
-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
-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
-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
-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
-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 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,
-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.
-
- "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
-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
-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
-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
-add to a covered work, you may (if authorized by the copyright holders of
-that material) supplement the terms of this License with terms:
-
- a) Disclaiming warranty or limiting liability differently from the
- terms of sections 15 and 16 of this License; or
-
- b) Requiring preservation of specified reasonable legal notices or
- author attributions in that material or in the Appropriate Legal
- Notices displayed by works containing it; or
-
- c) Prohibiting misrepresentation of the origin of that material, or
- requiring that modified versions of such material be marked in
- reasonable ways as different from the original version; or
-
- d) Limiting the use for publicity purposes of names of licensors or
- authors of the material; or
-
- e) Declining to grant rights under trademark law for use of some
- trade names, trademarks, or service marks; or
-
- f) Requiring indemnification of licensors and authors of that
- material by anyone who conveys the material (or modified versions of
- it) with contractual assumptions of liability to the recipient, for
- 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
-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
-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
-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
-form of a separately written license, or stated as exceptions;
-the above requirements apply either way.
-
- 8. Termination.
-
- 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
-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
-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
-licenses of parties who have received copies or rights from you under
-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.
-
- 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,
-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
-covered work, you indicate your acceptance of this License to do so.
-
- 10. Automatic Licensing of Downstream Recipients.
-
- 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
-for enforcing compliance by third parties with this License.
-
- 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
-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
-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
-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.
-
- 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
-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
-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
-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
-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
-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,
-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,
-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
-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
-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
-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
-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
-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
-the work, and under which the third party grants, to any of the
-parties who would receive the covered work from you, a discriminatory
-patent license (a) in connection with copies of the covered work
-conveyed by you (or copies made from those copies), or (b) primarily
-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
-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.
-
- 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
-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 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. Remote Network Interaction; Use with the GNU General Public License.
-
- Notwithstanding any other provision of this License, if you modify the
-Program, your modified version must prominently offer all users
-interacting with it remotely through a computer network (if your version
-supports such interaction) an opportunity to receive the Corresponding
-Source of your version by providing access to the Corresponding Source
-from a network server at no charge, through some standard or customary
-means of facilitating copying of software. This Corresponding Source
-shall include the Corresponding Source for any work covered by version 3
-of the GNU General Public License that is incorporated pursuant to the
-following paragraph.
-
- 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
-License will continue to apply to the part which is the covered work,
-but the work with which it is combined will remain governed by version
-3 of the GNU General Public 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 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
-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 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
-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
-author or copyright holder as a result of your choosing to follow a
-later version.
-
- 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
-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 THE COST OF
-ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
-
- 16. Limitation of Liability.
-
- 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 THE
-USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
-DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY 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.
-
- 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
-Program, unless a warranty or assumption of liability accompanies a
-copy of the Program in return for a fee.
-
- END OF TERMS AND CONDITIONS
-
- How to Apply These Terms to Your New Programs
-
- If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
- To do so, attach the following notices to the program. It is safest
-to attach them to the start of each source file to most effectively
-state the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
- kafka — a privacy-respecting metasearch engine
- Copyright (C) 2026-present metamorphosis-dev
-
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU Affero General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU Affero General Public License for more details.
-
- You should have received a copy of the GNU Affero General Public License
- along with this program. If not, see .
-
- Also add information on how to contact you by electronic and paper mail.
-
- If your software can interact with users remotely through a computer
-network, you should also make sure that it provides a way for users to
-get its source. For example, if your program is a web application, its
-interface could display a "Source" link that leads users to an archive
-of the code. There are many ways you could offer source, and different
-solutions will be better for different programs; see section 13 for the
-specific requirements.
-
- You should also get your employer (if you work as a programmer) or school,
-if any, to sign a "copyright disclaimer" for the program, if necessary.
-For more information on this, and how to apply and follow the GNU AGPL, see
-.
+MIT License
+
+Copyright (c) 2026-present metamorphosis-dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/cmd/kafka/main.go b/cmd/kafka/main.go
index cdc81b5..90c750d 100644
--- a/cmd/kafka/main.go
+++ b/cmd/kafka/main.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package main
import (
@@ -77,7 +61,7 @@ func main() {
acSvc := autocomplete.NewService(cfg.Upstream.URL, cfg.HTTPTimeout())
- h := httpapi.NewHandler(svc, acSvc.Suggestions, cfg.Server.SourceURL)
+ h := httpapi.NewHandler(svc, acSvc.Suggestions)
mux := http.NewServeMux()
mux.HandleFunc("/", h.Index)
diff --git a/config.example.toml b/config.example.toml
index 042bb63..34f60a6 100644
--- a/config.example.toml
+++ b/config.example.toml
@@ -14,11 +14,6 @@ http_timeout = "10s"
# Example: "https://search.example.com"
base_url = ""
-# Link to the source code (shown in footer as "Source" link)
-# Defaults to the upstream kafka repo if not set.
-# Example: "https://git.example.com/my-kafka-fork"
-source_url = ""
-
[upstream]
# URL of an upstream metasearch instance for unported engines (env: UPSTREAM_SEARXNG_URL)
# Leave empty to run without an upstream proxy.
diff --git a/internal/autocomplete/service.go b/internal/autocomplete/service.go
index 23473d5..99d963a 100644
--- a/internal/autocomplete/service.go
+++ b/internal/autocomplete/service.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package autocomplete
import (
@@ -27,7 +11,8 @@ import (
"time"
)
-// Service fetches search suggestions from upstream or Wikipedia OpenSearch.
+// Service fetches search suggestions from an upstream metasearch instance
+// or falls back to Wikipedia's OpenSearch API.
type Service struct {
upstreamURL string
http *http.Client
@@ -43,6 +28,7 @@ func NewService(upstreamURL string, timeout time.Duration) *Service {
}
}
+// Suggestions returns search suggestions for the given query.
func (s *Service) Suggestions(ctx context.Context, query string) ([]string, error) {
if strings.TrimSpace(query) == "" {
return nil, nil
@@ -54,6 +40,7 @@ func (s *Service) Suggestions(ctx context.Context, query string) ([]string, erro
return s.wikipediaSuggestions(ctx, query)
}
+// upstreamSuggestions proxies to an upstream /autocompleter endpoint.
func (s *Service) upstreamSuggestions(ctx context.Context, query string) ([]string, error) {
u := s.upstreamURL + "/autocompleter?" + url.Values{"q": {query}}.Encode()
req, err := http.NewRequestWithContext(ctx, http.MethodGet, u, nil)
diff --git a/internal/cache/cache.go b/internal/cache/cache.go
index 78bd0ea..b0099f9 100644
--- a/internal/cache/cache.go
+++ b/internal/cache/cache.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package cache
import (
diff --git a/internal/config/config.go b/internal/config/config.go
index e5d1fbb..7f8b06a 100644
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package config
import (
@@ -40,8 +24,7 @@ type Config struct {
type ServerConfig struct {
Port int `toml:"port"`
HTTPTimeout string `toml:"http_timeout"`
- BaseURL string `toml:"base_url"` // Public URL for OpenSearch XML (e.g. "https://search.example.com")
- SourceURL string `toml:"source_url"` // Link to the source code (e.g. "https://git.example.com/fork/kafka")
+ BaseURL string `toml:"base_url"` // Public URL for OpenSearch XML (e.g. "https://search.example.com")
}
type UpstreamConfig struct {
diff --git a/internal/contracts/main_result.go b/internal/contracts/main_result.go
index 02fb29c..b5b568a 100644
--- a/internal/contracts/main_result.go
+++ b/internal/contracts/main_result.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package contracts
import (
@@ -22,10 +6,14 @@ import (
)
// MainResult represents one element of the `results` array.
-// Unknown keys are preserved in `raw` and re-emitted via MarshalJSON.
+//
+// The API returns many additional keys beyond what templates use. To keep the
+// contract stable for proxying/merging, we preserve all unknown keys in
+// `raw` and re-emit them via MarshalJSON.
type MainResult struct {
raw map[string]any
+ // Common fields used by templates (RSS uses: title, url, content, pubdate).
Template string `json:"template"`
Title string `json:"title"`
Content string `json:"content"`
@@ -41,13 +29,17 @@ type MainResult struct {
Positions []int `json:"positions"`
Engines []string `json:"engines"`
+ // These fields exist in the MainResult base; keep them so downstream
+ // callers can generate richer output later.
OpenGroup bool `json:"open_group"`
CloseGroup bool `json:"close_group"`
+ // parsed_url is emitted as a tuple; we preserve it as-is.
ParsedURL any `json:"parsed_url"`
}
func (mr *MainResult) UnmarshalJSON(data []byte) error {
+ // Preserve the full object.
dec := json.NewDecoder(bytes.NewReader(data))
dec.UseNumber()
@@ -58,6 +50,7 @@ func (mr *MainResult) UnmarshalJSON(data []byte) error {
mr.raw = m
+ // Fill the typed/common fields (best-effort; don't fail if types differ).
mr.Template = stringOrEmpty(m["template"])
mr.Title = stringOrEmpty(m["title"])
mr.Content = stringOrEmpty(m["content"])
@@ -95,10 +88,12 @@ func (mr *MainResult) UnmarshalJSON(data []byte) error {
}
func (mr MainResult) MarshalJSON() ([]byte, error) {
+ // If we came from upstream JSON, preserve all keys exactly.
if mr.raw != nil {
return json.Marshal(mr.raw)
}
+ // Otherwise, marshal the known fields.
m := map[string]any{
"template": mr.Template,
"title": mr.Title,
diff --git a/internal/contracts/types.go b/internal/contracts/types.go
index 40ed6bc..81103ce 100644
--- a/internal/contracts/types.go
+++ b/internal/contracts/types.go
@@ -1,34 +1,21 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package contracts
// OutputFormat matches the `/search?format=...` values.
type OutputFormat string
const (
- FormatHTML OutputFormat = "html" // accepted for compatibility
+ FormatHTML OutputFormat = "html" // accepted for compatibility (not yet implemented)
FormatJSON OutputFormat = "json"
FormatCSV OutputFormat = "csv"
FormatRSS OutputFormat = "rss"
)
type SearchRequest struct {
- Format OutputFormat
- Query string
+ // Format is what the client requested via `format=...`.
+ Format OutputFormat
+
+ Query string
+
Pageno int
Safesearch int
TimeRange *string
@@ -36,14 +23,16 @@ type SearchRequest struct {
TimeoutLimit *float64
Language string
- // Engines and categories decide which engines run locally vs proxy to upstream.
+ // Engines and categories are used for deciding which engines run locally vs are proxied.
+ // For now, engines can be supplied directly via the `engines` form parameter.
Engines []string
Categories []string
// EngineData matches the `engine_data--=` parameters.
EngineData map[string]map[string]string
- // AccessToken gates paid/limited engines. Not part of upstream JSON schema.
+ // AccessToken is an optional request token used to gate paid/limited engines.
+ // It is not part of the upstream JSON schema; it only influences local engines.
AccessToken string
}
diff --git a/internal/engines/arxiv.go b/internal/engines/arxiv.go
index 1347562..5565f7f 100644
--- a/internal/engines/arxiv.go
+++ b/internal/engines/arxiv.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/bing.go b/internal/engines/bing.go
index 85c3f65..ff1a5da 100644
--- a/internal/engines/bing.go
+++ b/internal/engines/bing.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/braveapi.go b/internal/engines/braveapi.go
index 81d1f3b..77c7abe 100644
--- a/internal/engines/braveapi.go
+++ b/internal/engines/braveapi.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
@@ -30,9 +14,13 @@ import (
"github.com/metamorphosis-dev/kafka/internal/contracts"
)
-// BraveEngine implements the Brave Web Search API.
-// Required: BRAVE_API_KEY env var or config.
-// Optional: BRAVE_ACCESS_TOKEN to gate requests.
+// BraveEngine implements the `braveapi` engine (Brave Web Search API).
+//
+// Config / gating:
+// - BRAVE_API_KEY: required to call Brave
+// - BRAVE_ACCESS_TOKEN (optional): if set, the request must include a token
+// that matches the env var (via Authorization Bearer, X-Search-Token,
+// X-Brave-Access-Token, or form field `token`).
type BraveEngine struct {
client *http.Client
apiKey string
@@ -47,6 +35,8 @@ func (e *BraveEngine) Search(ctx context.Context, req contracts.SearchRequest) (
return contracts.SearchResponse{}, errors.New("brave engine not initialized")
}
+ // Gate / config checks should not be treated as fatal errors; the reference
+ // implementation treats misconfigured engines as unresponsive.
if strings.TrimSpace(e.apiKey) == "" {
return contracts.SearchResponse{
Query: req.Query,
@@ -103,6 +93,8 @@ func (e *BraveEngine) Search(ctx context.Context, req contracts.SearchRequest) (
}
}
+ // The reference implementation checks `if params["safesearch"]:` which treats any
+ // non-zero (moderate/strict) as strict.
if req.Safesearch > 0 {
args.Set("safesearch", "strict")
}
diff --git a/internal/engines/crossref.go b/internal/engines/crossref.go
index cc33759..cdcc0b4 100644
--- a/internal/engines/crossref.go
+++ b/internal/engines/crossref.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/duckduckgo.go b/internal/engines/duckduckgo.go
index 158d483..28b4972 100644
--- a/internal/engines/duckduckgo.go
+++ b/internal/engines/duckduckgo.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/duckduckgo_parse.go b/internal/engines/duckduckgo_parse.go
index 407029c..b3935e4 100644
--- a/internal/engines/duckduckgo_parse.go
+++ b/internal/engines/duckduckgo_parse.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/engine.go b/internal/engines/engine.go
index 729af2b..ee87cfd 100644
--- a/internal/engines/engine.go
+++ b/internal/engines/engine.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/factory.go b/internal/engines/factory.go
index 528dcb7..b7f3c00 100644
--- a/internal/engines/factory.go
+++ b/internal/engines/factory.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
@@ -24,8 +8,9 @@ import (
"github.com/metamorphosis-dev/kafka/internal/config"
)
-// NewDefaultPortedEngines returns the Go-native engine registry.
-// If cfg is nil, API keys fall back to environment variables.
+// NewDefaultPortedEngines returns the starter set of Go-native engines.
+// The service can swap/extend this registry later as more engines are ported.
+// If cfg is nil, falls back to reading API keys from environment variables.
func NewDefaultPortedEngines(client *http.Client, cfg *config.Config) map[string]Engine {
if client == nil {
client = &http.Client{Timeout: 10 * time.Second}
diff --git a/internal/engines/github.go b/internal/engines/github.go
index f37cddc..44102f0 100644
--- a/internal/engines/github.go
+++ b/internal/engines/github.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/google.go b/internal/engines/google.go
index 8563829..71b50d1 100644
--- a/internal/engines/google.go
+++ b/internal/engines/google.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
@@ -57,6 +41,7 @@ func (e *GoogleEngine) Search(ctx context.Context, req contracts.SearchRequest)
start := (req.Pageno - 1) * 10
query := url.QueryEscape(req.Query)
+ // Build URL like SearXNG does.
u := fmt.Sprintf(
"https://www.google.com/search?q=%s&filter=0&start=%d&hl=%s&lr=%s&safe=%s",
query,
@@ -117,6 +102,7 @@ func (e *GoogleEngine) Search(ctx context.Context, req contracts.SearchRequest)
}, nil
}
+// detectGoogleSorry returns true if the response is a Google block/CAPTCHA page.
func detectGoogleSorry(resp *http.Response) bool {
if resp.Request != nil {
if resp.Request.URL.Host == "sorry.google.com" || strings.HasPrefix(resp.Request.URL.Path, "/sorry") {
@@ -126,9 +112,16 @@ func detectGoogleSorry(resp *http.Response) bool {
return false
}
+// parseGoogleResults extracts search results from Google's HTML.
+// Uses the same selectors as SearXNG: div.MjjYud for result containers.
func parseGoogleResults(body, query string) []contracts.MainResult {
var results []contracts.MainResult
+ // SearXNG selector: .//div[contains(@class, "MjjYud")]
+ // Each result block contains a title link and snippet.
+ // We simulate the XPath matching with regex-based extraction.
+
+ // Find all MjjYud div blocks.
mjjPattern := regexp.MustCompile(`]*class="[^"]*MjjYud[^"]*"[^>]*>(.*?)\s*(?=]*class="[^"]*MjjYud|$)`)
matches := mjjPattern.FindAllStringSubmatch(body, -1)
@@ -138,12 +131,15 @@ func parseGoogleResults(body, query string) []contracts.MainResult {
}
block := match[1]
+ // Extract title and URL from the result link.
+ // Pattern: TITLE
urlPattern := regexp.MustCompile(`]+href="(/url\?q=[^"&]+)`)
urlMatch := urlPattern.FindStringSubmatch(block)
if len(urlMatch) < 2 {
continue
}
rawURL := urlMatch[1]
+ // Remove /url?q= prefix and decode.
actualURL := strings.TrimPrefix(rawURL, "/url?q=")
if amp := strings.Index(actualURL, "&"); amp != -1 {
actualURL = actualURL[:amp]
@@ -156,12 +152,14 @@ func parseGoogleResults(body, query string) []contracts.MainResult {
continue
}
+ // Extract title from the title tag.
titlePattern := regexp.MustCompile(`]*class="[^"]*qrStP[^"]*"[^>]*>([^<]+)`)
titleMatch := titlePattern.FindStringSubmatch(block)
title := query
if len(titleMatch) >= 2 {
title = stripTags(titleMatch[1])
} else {
+ // Fallback: extract visible text from an with data-title or role="link"
linkTitlePattern := regexp.MustCompile(`]+role="link"[^>]*>([^<]+)<`)
ltMatch := linkTitlePattern.FindStringSubmatch(block)
if len(ltMatch) >= 2 {
@@ -169,6 +167,7 @@ func parseGoogleResults(body, query string) []contracts.MainResult {
}
}
+ // Extract snippet from data-sncf divs (SearXNG's approach).
snippet := extractGoogleSnippet(block)
urlPtr := actualURL
@@ -187,7 +186,10 @@ func parseGoogleResults(body, query string) []contracts.MainResult {
return results
}
+// extractGoogleSnippet extracts the snippet text from a Google result block.
func extractGoogleSnippet(block string) string {
+ // Google's snippets live in divs with data-sncf attribute.
+ // SearXNG looks for: .//div[contains(@data-sncf, "1")]
snippetPattern := regexp.MustCompile(`]+data-sncf="1"[^>]*>(.*?)`)
matches := snippetPattern.FindAllStringSubmatch(block, -1)
var parts []string
@@ -203,8 +205,10 @@ func extractGoogleSnippet(block string) string {
return strings.Join(parts, " ")
}
+// extractGoogleSuggestions extracts search suggestions from Google result cards.
func extractGoogleSuggestions(body string) []string {
var suggestions []string
+ // SearXNG xpath: //div[contains(@class, "ouy7Mc")]//a
suggestionPattern := regexp.MustCompile(`(?s)]*class="[^"]*ouy7Mc[^"]*"[^>]*>.*?]*>([^<]+)`)
matches := suggestionPattern.FindAllStringSubmatch(body, -1)
seen := map[string]bool{}
@@ -221,6 +225,8 @@ func extractGoogleSuggestions(body string) []string {
return suggestions
}
+// googleHL maps SearXNG locale to Google hl (host language) parameter.
+// e.g. "en-US" -> "en-US"
func googleHL(lang string) string {
lang = strings.ToLower(strings.TrimSpace(lang))
if lang == "" || lang == "auto" {
@@ -229,6 +235,8 @@ func googleHL(lang string) string {
return lang
}
+// googleUILanguage maps SearXNG language to Google lr (language restrict) parameter.
+// e.g. "en" -> "lang_en", "de" -> "lang_de"
func googleUILanguage(lang string) string {
lang = strings.ToLower(strings.Split(lang, "-")[0])
if lang == "" || lang == "auto" {
@@ -237,6 +245,7 @@ func googleUILanguage(lang string) string {
return "lang_" + lang
}
+// googleSafeSearchLevel maps safesearch (0-2) to Google's safe parameter.
func googleSafeSearchLevel(safesearch int) string {
switch safesearch {
case 0:
@@ -250,6 +259,7 @@ func googleSafeSearchLevel(safesearch int) string {
}
}
+// stripTags removes HTML tags from a string.
func stripTags(s string) string {
stripper := regexp.MustCompile(`<[^>]*>`)
s = stripper.ReplaceAllString(s, "")
diff --git a/internal/engines/html_helpers.go b/internal/engines/html_helpers.go
index 66690c3..fd94730 100644
--- a/internal/engines/html_helpers.go
+++ b/internal/engines/html_helpers.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/planner.go b/internal/engines/planner.go
index 9616a4b..b180f7e 100644
--- a/internal/engines/planner.go
+++ b/internal/engines/planner.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
@@ -95,6 +79,9 @@ func (p *Planner) Plan(req contracts.SearchRequest) (localEngines, upstreamEngin
}
func inferFromCategories(categories []string) []string {
+ // Minimal mapping for the initial porting subset.
+ // This mirrors the idea of selecting from engine categories without
+ // embedding the whole engine registry.
set := map[string]bool{}
for _, c := range categories {
switch strings.TrimSpace(strings.ToLower(c)) {
@@ -128,6 +115,7 @@ func inferFromCategories(categories []string) []string {
}
func sortByOrder(list []string, order map[string]int) {
+ // simple insertion sort (list is tiny)
for i := 1; i < len(list); i++ {
j := i
for j > 0 && order[list[j-1]] > order[list[j]] {
diff --git a/internal/engines/qwant.go b/internal/engines/qwant.go
index e15d4f2..8221781 100644
--- a/internal/engines/qwant.go
+++ b/internal/engines/qwant.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
@@ -30,7 +14,11 @@ import (
"github.com/PuerkitoBio/goquery"
)
-// QwantEngine implements the Qwant v3 API (web and web-lite modes).
+// QwantEngine implements a `qwant` (web) adapter using
+// Qwant v3 endpoint: https://api.qwant.com/v3/search/web.
+//
+// Qwant's API is not fully documented; this implements parsing logic
+// for the `web` category.
type QwantEngine struct {
client *http.Client
category string // "web" (JSON API) or "web-lite" (HTML fallback)
@@ -49,6 +37,8 @@ func (e *QwantEngine) Search(ctx context.Context, req contracts.SearchRequest) (
return contracts.SearchResponse{Query: req.Query}, nil
}
+ // For API parity we use web defaults: count=10, offset=(pageno-1)*count.
+ // The engine's config field exists so we can expand to news/images/videos later.
count := e.resultsPerPage
if count <= 0 {
count = 10
@@ -265,7 +255,9 @@ func (e *QwantEngine) searchWebLite(ctx context.Context, req contracts.SearchReq
results := make([]contracts.MainResult, 0)
seen := map[string]bool{}
+ // Pattern 1: legacy/known qwant-lite structure.
doc.Find("section article").Each(func(_ int, item *goquery.Selection) {
+ // ignore randomly interspersed advertising adds
if item.Find("span.tooltip").Length() > 0 {
return
}
@@ -299,14 +291,19 @@ func (e *QwantEngine) searchWebLite(ctx context.Context, req contracts.SearchReq
})
})
+ // Pattern 2: broader fallback for updated lite markup:
+ // any article/list item/div block containing an external anchor.
+ // We keep this conservative by requiring non-empty title + URL.
doc.Find("article, li, div").Each(func(_ int, item *goquery.Selection) {
if len(results) >= 20 {
return
}
+ // Skip ad-like blocks in fallback pass too.
if item.Find("span.tooltip").Length() > 0 {
return
}
+ // Skip obvious nav/footer blocks.
classAttr, _ := item.Attr("class")
classLower := strings.ToLower(classAttr)
if strings.Contains(classLower, "nav") || strings.Contains(classLower, "footer") {
@@ -355,10 +352,13 @@ func (e *QwantEngine) searchWebLite(ctx context.Context, req contracts.SearchReq
}
seen[href] = true
+ // Best-effort snippet extraction from nearby paragraph/span text.
content := strings.TrimSpace(item.Find("p").First().Text())
if content == "" {
content = strings.TrimSpace(item.Find("span").First().Text())
}
+ // If there is no snippet, still keep clearly external result links.
+ // Qwant-lite frequently omits rich snippets for some entries.
u := href
results = append(results, contracts.MainResult{
diff --git a/internal/engines/reddit.go b/internal/engines/reddit.go
index 788f52a..6ba98e4 100644
--- a/internal/engines/reddit.go
+++ b/internal/engines/reddit.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/wikipedia.go b/internal/engines/wikipedia.go
index bbf1222..bff708e 100644
--- a/internal/engines/wikipedia.go
+++ b/internal/engines/wikipedia.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/engines/youtube.go b/internal/engines/youtube.go
index 5946aa4..a18abd8 100644
--- a/internal/engines/youtube.go
+++ b/internal/engines/youtube.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package engines
import (
diff --git a/internal/httpapi/handlers.go b/internal/httpapi/handlers.go
index cc19b4b..837a336 100644
--- a/internal/httpapi/handlers.go
+++ b/internal/httpapi/handlers.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package httpapi
import (
@@ -30,14 +14,12 @@ import (
type Handler struct {
searchSvc *search.Service
autocompleteSvc func(ctx context.Context, query string) ([]string, error)
- sourceURL string
}
-func NewHandler(searchSvc *search.Service, autocompleteSuggestions func(ctx context.Context, query string) ([]string, error), sourceURL string) *Handler {
+func NewHandler(searchSvc *search.Service, autocompleteSuggestions func(ctx context.Context, query string) ([]string, error)) *Handler {
return &Handler{
searchSvc: searchSvc,
autocompleteSvc: autocompleteSuggestions,
- sourceURL: sourceURL,
}
}
@@ -53,7 +35,7 @@ func (h *Handler) Index(w http.ResponseWriter, r *http.Request) {
http.NotFound(w, r)
return
}
- if err := views.RenderIndex(w, h.sourceURL); err != nil {
+ if err := views.RenderIndex(w); err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
}
}
@@ -82,7 +64,7 @@ func (h *Handler) Search(w http.ResponseWriter, r *http.Request) {
if err != nil {
// For HTML, render error on the results page.
if req.Format == contracts.FormatHTML || r.FormValue("format") == "html" {
- pd := views.PageData{SourceURL: h.sourceURL, Query: r.FormValue("q")}
+ pd := views.PageData{Query: r.FormValue("q")}
if views.IsHTMXRequest(r) {
views.RenderSearchFragment(w, pd)
} else {
@@ -97,7 +79,7 @@ func (h *Handler) Search(w http.ResponseWriter, r *http.Request) {
resp, err := h.searchSvc.Search(r.Context(), req)
if err != nil {
if req.Format == contracts.FormatHTML {
- pd := views.PageData{SourceURL: h.sourceURL, Query: req.Query}
+ pd := views.PageData{Query: req.Query}
if views.IsHTMXRequest(r) {
views.RenderSearchFragment(w, pd)
} else {
diff --git a/internal/middleware/cors.go b/internal/middleware/cors.go
index ee90ab0..7b4000e 100644
--- a/internal/middleware/cors.go
+++ b/internal/middleware/cors.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package middleware
import (
diff --git a/internal/middleware/ratelimit.go b/internal/middleware/ratelimit.go
index 78774f2..5102f9a 100644
--- a/internal/middleware/ratelimit.go
+++ b/internal/middleware/ratelimit.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package middleware
import (
@@ -27,12 +11,19 @@ import (
"log/slog"
)
+// RateLimitConfig controls per-IP rate limiting using a sliding window counter.
type RateLimitConfig struct {
- Requests int
- Window time.Duration
+ // Requests is the max number of requests allowed per window.
+ Requests int
+ // Window is the time window duration (e.g. "1m").
+ Window time.Duration
+ // CleanupInterval is how often stale entries are purged (default: 5m).
CleanupInterval time.Duration
}
+// RateLimit returns a middleware that limits requests per IP address.
+// Uses an in-memory sliding window counter. When the limit is exceeded,
+// responds with HTTP 429 and a Retry-After header.
func RateLimit(cfg RateLimitConfig, logger *slog.Logger) func(http.Handler) http.Handler {
requests := cfg.Requests
if requests <= 0 {
diff --git a/internal/middleware/ratelimit_global.go b/internal/middleware/ratelimit_global.go
index 538c435..1f94dc9 100644
--- a/internal/middleware/ratelimit_global.go
+++ b/internal/middleware/ratelimit_global.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package middleware
import (
diff --git a/internal/search/merge.go b/internal/search/merge.go
index 0e8a15a..64ebd6e 100644
--- a/internal/search/merge.go
+++ b/internal/search/merge.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package search
import (
@@ -25,6 +9,11 @@ import (
)
// MergeResponses merges multiple compatible JSON responses.
+//
+// MVP merge semantics:
+// - results are concatenated with a simple de-dup key (engine|title|url)
+// - suggestions/corrections are de-duplicated as sets
+// - answers/infoboxes/unresponsive_engines are concatenated (best-effort)
func MergeResponses(responses []contracts.SearchResponse) contracts.SearchResponse {
var merged contracts.SearchResponse
diff --git a/internal/search/request_params.go b/internal/search/request_params.go
index baad193..9fdd799 100644
--- a/internal/search/request_params.go
+++ b/internal/search/request_params.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package search
import (
diff --git a/internal/search/response.go b/internal/search/response.go
index 1279a07..1a9ce26 100644
--- a/internal/search/response.go
+++ b/internal/search/response.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package search
import (
diff --git a/internal/search/service.go b/internal/search/service.go
index 2ac9718..47d2895 100644
--- a/internal/search/service.go
+++ b/internal/search/service.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package search
import (
diff --git a/internal/search/types.go b/internal/search/types.go
index 89b323d..b4694bb 100644
--- a/internal/search/types.go
+++ b/internal/search/types.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package search
import "github.com/metamorphosis-dev/kafka/internal/contracts"
@@ -23,7 +7,7 @@ import "github.com/metamorphosis-dev/kafka/internal/contracts"
type OutputFormat = contracts.OutputFormat
const (
- FormatHTML = contracts.FormatHTML // accepted for compatibility
+ FormatHTML = contracts.FormatHTML // accepted for compatibility (not yet implemented)
FormatJSON = contracts.FormatJSON
FormatCSV = contracts.FormatCSV
FormatRSS = contracts.FormatRSS
diff --git a/internal/upstream/client.go b/internal/upstream/client.go
index 2bff509..64ddec4 100644
--- a/internal/upstream/client.go
+++ b/internal/upstream/client.go
@@ -1,19 +1,3 @@
-// kafka — a privacy-respecting metasearch engine
-// Copyright (C) 2026-present metamorphosis-dev
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU Affero General Public License for more details.
-//
-// You should have received a copy of the GNU Affero General Public License
-// along with this program. If not, see .
-
package upstream
import (
diff --git a/internal/views/static/css/kafka.css b/internal/views/static/css/kafka.css
index 8ae97ea..b637860 100644
--- a/internal/views/static/css/kafka.css
+++ b/internal/views/static/css/kafka.css
@@ -1,49 +1,71 @@
-/* ============================================================
- kafka — modern, clean search UI
- ============================================================ */
+/* kafka — clean, minimal search engine CSS */
:root {
- /* Light theme */
- --bg: #ffffff;
- --bg-secondary: #f8f9fa;
- --bg-tertiary: #f1f3f5;
- --border: #e9ecef;
- --border-focus: #cad1d8;
- --text-primary: #1a1a1a;
- --text-secondary: #5c6370;
- --text-muted: #8b929e;
- --accent: #2563eb;
- --accent-hover: #1d4ed8;
- --accent-soft: #eff6ff;
- --accent-glow: rgba(37, 99, 235, 0.15);
- --shadow-sm: 0 1px 3px rgba(0,0,0,0.06), 0 1px 2px rgba(0,0,0,0.04);
- --shadow-md: 0 4px 12px rgba(0,0,0,0.08), 0 2px 4px rgba(0,0,0,0.04);
- --shadow-lg: 0 12px 32px rgba(0,0,0,0.12), 0 4px 8px rgba(0,0,0,0.06);
- --radius-sm: 8px;
- --radius-md: 12px;
- --radius-lg: 16px;
- --radius-full: 9999px;
- --font: -apple-system, BlinkMacSystemFont, "SF Pro Display", "Segoe UI", Roboto, sans-serif;
- --max-width: 880px;
- --header-height: 56px;
+ --color-base: #f5f5f5;
+ --color-base-font: #444;
+ --color-base-background: #fff;
+ --color-header-background: #f7f7f7;
+ --color-header-border: #ddd;
+ --color-search-border: #bbb;
+ --color-search-focus: #3498db;
+ --color-result-url: #1a0dab;
+ --color-result-url-visited: #609;
+ --color-result-content: #545454;
+ --color-result-title: #1a0dab;
+ --color-result-title-visited: #609;
+ --color-result-engine: #666;
+ --color-result-border: #eee;
+ --color-link: #3498db;
+ --color-link-visited: #609;
+ --color-sidebar-background: #f7f7f7;
+ --color-sidebar-border: #ddd;
+ --color-infobox-background: #f9f9f9;
+ --color-infobox-border: #ddd;
+ --color-pagination-current: #3498db;
+ --color-pagination-border: #ddd;
+ --color-error: #c0392b;
+ --color-error-background: #fdecea;
+ --color-suggestion: #666;
+ --color-footer: #888;
+ --color-btn-background: #fff;
+ --color-btn-border: #ddd;
+ --color-btn-hover: #eee;
+ --radius: 4px;
+ --max-width: 800px;
}
-[data-theme="dark"] {
- --bg: #0f0f0f;
- --bg-secondary: #1a1a1a;
- --bg-tertiary: #242424;
- --border: #2e2e2e;
- --border-focus: #404040;
- --text-primary: #e8eaed;
- --text-secondary: #9aa0a6;
- --text-muted: #6b7280;
- --accent: #60a5fa;
- --accent-hover: #93c5fd;
- --accent-soft: #1e3a5f;
- --accent-glow: rgba(96, 165, 250, 0.2);
- --shadow-sm: 0 1px 3px rgba(0,0,0,0.3);
- --shadow-md: 0 4px 12px rgba(0,0,0,0.4);
- --shadow-lg: 0 12px 32px rgba(0,0,0,0.5);
+@media (prefers-color-scheme: dark) {
+ :root {
+ --color-base: #222;
+ --color-base-font: #dcdcdc;
+ --color-base-background: #2b2b2b;
+ --color-header-background: #333;
+ --color-header-border: #444;
+ --color-search-border: #555;
+ --color-search-focus: #5dade2;
+ --color-result-url: #8ab4f8;
+ --color-result-url-visited: #b39ddb;
+ --color-result-content: #b0b0b0;
+ --color-result-title: #8ab4f8;
+ --color-result-title-visited: #b39ddb;
+ --color-result-engine: #999;
+ --color-result-border: #3a3a3a;
+ --color-link: #5dade2;
+ --color-link-visited: #b39ddb;
+ --color-sidebar-background: #333;
+ --color-sidebar-border: #444;
+ --color-infobox-background: #333;
+ --color-infobox-border: #444;
+ --color-pagination-current: #5dade2;
+ --color-pagination-border: #444;
+ --color-error: #e74c3c;
+ --color-error-background: #3b1a1a;
+ --color-suggestion: #999;
+ --color-footer: #666;
+ --color-btn-background: #333;
+ --color-btn-border: #555;
+ --color-btn-hover: #444;
+ }
}
*, *::before, *::after {
@@ -54,491 +76,35 @@
html {
font-size: 16px;
- scroll-behavior: smooth;
}
body {
- font-family: var(--font);
- background: var(--bg);
- color: var(--text-primary);
- line-height: 1.5;
+ font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+ color: var(--color-base-font);
+ background: var(--color-base);
+ line-height: 1.6;
min-height: 100vh;
- -webkit-font-smoothing: antialiased;
- -moz-osx-font-smoothing: grayscale;
-}
-
-/* ============================================================
- Header
- ============================================================ */
-
-.site-header {
- position: sticky;
- top: 0;
- z-index: 100;
- height: var(--header-height);
- display: flex;
- align-items: center;
- justify-content: space-between;
- padding: 0 1.5rem;
- background: var(--bg);
- border-bottom: 1px solid var(--border);
- backdrop-filter: blur(12px);
- background: color-mix(in srgb, var(--bg) 90%, transparent);
-}
-
-.site-logo {
- display: flex;
- align-items: center;
- gap: 0.5rem;
- text-decoration: none;
- color: var(--text-primary);
-}
-
-.site-logo-mark {
- width: 28px;
- height: 28px;
- color: var(--accent);
-}
-
-.site-name {
- font-size: 1.1rem;
- font-weight: 600;
- letter-spacing: -0.01em;
-}
-
-.settings-trigger {
- background: none;
- border: none;
- width: 36px;
- height: 36px;
- border-radius: var(--radius-sm);
- display: flex;
- align-items: center;
- justify-content: center;
- cursor: pointer;
- color: var(--text-secondary);
- transition: background 0.15s, color 0.15s;
-}
-.settings-trigger:hover {
- background: var(--bg-tertiary);
- color: var(--text-primary);
-}
-
-/* ============================================================
- Main Layout
- ============================================================ */
-
-main {
- max-width: var(--max-width);
- margin: 0 auto;
- padding: 0 1.5rem;
-}
-
-/* ============================================================
- Homepage — Hero Search
- ============================================================ */
-
-.page-home {
- min-height: calc(100vh - var(--header-height));
display: flex;
flex-direction: column;
- align-items: center;
- justify-content: center;
- padding: 4rem 1.5rem;
- text-align: center;
}
-.hero-logo {
- margin-bottom: 2rem;
-}
-
-.hero-logo svg {
- width: 64px;
- height: 64px;
- color: var(--accent);
-}
-
-.hero-tagline {
- font-size: 1rem;
- color: var(--text-muted);
- margin-bottom: 2.5rem;
- max-width: 400px;
-}
-
-.search-hero {
+main {
+ flex: 1;
+ max-width: var(--max-width);
width: 100%;
- max-width: 640px;
-}
-
-.search-box {
- position: relative;
- width: 100%;
-}
-
-.search-box input[type="text"],
-#q {
- width: 100%;
- padding: 1rem 3.5rem 1rem 1.25rem;
- font-size: 1.1rem;
- font-family: inherit;
- border: 2px solid var(--border);
- border-radius: var(--radius-full);
- background: var(--bg);
- color: var(--text-primary);
- outline: none;
- transition: border-color 0.2s, box-shadow 0.2s;
-}
-
-.search-box input[type="text"]:focus,
-#q:focus {
- border-color: var(--accent);
- box-shadow: var(--shadow-lg), 0 0 0 4px var(--accent-glow);
-}
-
-.search-box input[type="text"]::placeholder,
-#q::placeholder {
- color: var(--text-muted);
-}
-
-.search-box-submit {
- position: absolute;
- right: 6px;
- top: 50%;
- transform: translateY(-50%);
- width: 40px;
- height: 40px;
- border: none;
- border-radius: var(--radius-full);
- background: var(--accent);
- color: #fff;
- cursor: pointer;
- display: flex;
- align-items: center;
- justify-content: center;
- transition: background 0.15s, transform 0.15s;
-}
-
-.search-box-submit:hover {
- background: var(--accent-hover);
- transform: translateY(-50%) scale(1.05);
-}
-
-.search-box-submit:active {
- transform: translateY(-50%) scale(0.97);
-}
-
-/* ============================================================
- Results Page
- ============================================================ */
-
-.page-results {
- padding-top: 1.5rem;
-}
-
-.results-layout {
- display: grid;
- grid-template-columns: 1fr 220px;
- gap: 2rem;
- align-items: start;
-}
-
-@media (max-width: 700px) {
- .results-layout {
- grid-template-columns: 1fr;
- gap: 1rem;
- }
-}
-
-/* Compact search bar on results page */
-.search-compact {
- grid-column: 1 / -1;
-}
-
-.search-compact .search-box {
- max-width: 100%;
-}
-
-.search-compact input {
- font-size: 1rem;
- padding: 0.75rem 2.75rem 0.75rem 1rem;
-}
-
-.search-compact .search-box-submit {
- width: 34px;
- height: 34px;
-}
-
-/* ============================================================
- Results Column
- ============================================================ */
-
-.results-column {
- min-width: 0;
-}
-
-/* Result count + meta */
-.results-meta {
- display: flex;
- align-items: center;
- gap: 0.75rem;
- margin-bottom: 1rem;
- font-size: 0.85rem;
- color: var(--text-muted);
-}
-
-/* Individual result card */
-.result {
- background: var(--bg);
- border: 1px solid var(--border);
- border-radius: var(--radius-md);
- padding: 1rem 1.1rem;
- margin-bottom: 0.75rem;
- transition: border-color 0.15s, box-shadow 0.15s, transform 0.15s;
-}
-
-.result:hover {
- border-color: var(--border-focus);
- box-shadow: var(--shadow-sm);
- transform: translateY(-1px);
-}
-
-.result_header {
- margin-bottom: 0.25rem;
-}
-
-.result-favicon {
- display: inline-block;
- width: 16px;
- height: 16px;
- border-radius: 3px;
- vertical-align: middle;
- margin-right: 0.4rem;
- background: var(--bg-tertiary);
- flex-shrink: 0;
-}
-
-.result_url {
- display: flex;
- align-items: center;
- gap: 0.4rem;
- font-size: 0.8rem;
- color: var(--text-muted);
- margin-bottom: 0.35rem;
- overflow: hidden;
-}
-
-.result_url a {
- color: var(--text-muted);
- text-decoration: none;
- white-space: nowrap;
- overflow: hidden;
- text-overflow: ellipsis;
-}
-
-.result_url a:hover {
- color: var(--accent);
-}
-
-.result_url .engine-badge {
- flex-shrink: 0;
- display: inline-flex;
- align-items: center;
- gap: 0.25rem;
- padding: 0.1rem 0.4rem;
- background: var(--bg-tertiary);
- border-radius: var(--radius-sm);
- font-size: 0.7rem;
- color: var(--text-muted);
- margin-left: auto;
-}
-
-.result_header a {
- font-size: 1rem;
- font-weight: 500;
- color: var(--text-primary);
- text-decoration: none;
- line-height: 1.4;
- display: block;
-}
-
-.result_header a:hover {
- color: var(--accent);
-}
-
-.result_header a:visited {
- color: var(--text-secondary);
-}
-
-.result_content {
- font-size: 0.9rem;
- color: var(--text-secondary);
- line-height: 1.55;
- display: -webkit-box;
- -webkit-line-clamp: 2;
- -webkit-box-orient: vertical;
- overflow: hidden;
-}
-
-/* ============================================================
- Sidebar
- ============================================================ */
-
-.sidebar {
- position: sticky;
- top: calc(var(--header-height) + 1.5rem);
-}
-
-.sidebar-card {
- background: var(--bg);
- border: 1px solid var(--border);
- border-radius: var(--radius-md);
+ margin: 0 auto;
padding: 1rem;
- margin-bottom: 1rem;
}
-.sidebar-title {
- font-size: 0.75rem;
- font-weight: 600;
- text-transform: uppercase;
- letter-spacing: 0.05em;
- color: var(--text-muted);
- margin-bottom: 0.75rem;
-}
-
-/* Suggestions in sidebar */
-.suggestion-list {
- display: flex;
- flex-wrap: wrap;
- gap: 0.4rem;
-}
-
-.suggestion a {
- display: inline-block;
- padding: 0.3rem 0.65rem;
- font-size: 0.8rem;
- border: 1px solid var(--border);
- border-radius: var(--radius-full);
- color: var(--accent);
- text-decoration: none;
- background: var(--accent-soft);
- transition: background 0.15s, border-color 0.15s;
-}
-
-.suggestion a:hover {
- background: color-mix(in srgb, var(--accent-soft) 70%, var(--bg-tertiary));
- border-color: var(--accent);
-}
-
-/* Unresponsive engines warning */
-.unresponsive-engines {
- font-size: 0.8rem;
- color: var(--text-muted);
-}
-
-.unresponsive-engines li {
- margin: 0.3rem 0;
-}
-
-/* Corrections */
-.correction {
- font-size: 0.85rem;
- color: var(--text-muted);
- margin-bottom: 0.5rem;
-}
-
-/* ============================================================
- No Results
- ============================================================ */
-
-.no-results {
- text-align: center;
- padding: 4rem 2rem;
-}
-
-.no-results-icon {
- font-size: 3rem;
- margin-bottom: 1rem;
- opacity: 0.3;
-}
-
-.no-results h2 {
- font-size: 1.25rem;
- font-weight: 500;
- margin-bottom: 0.5rem;
-}
-
-.no-results p {
- color: var(--text-muted);
- font-size: 0.95rem;
-}
-
-/* ============================================================
- Pagination
- ============================================================ */
-
-.pagination {
- display: flex;
- align-items: center;
- justify-content: center;
- gap: 0.4rem;
- padding: 2rem 0;
- flex-wrap: wrap;
-}
-
-.pagination button,
-.pagination .page-link {
- min-width: 40px;
- height: 40px;
- padding: 0 0.75rem;
- border: 1px solid var(--border);
- border-radius: var(--radius-sm);
- background: var(--bg);
- color: var(--text-primary);
- font-size: 0.9rem;
- font-family: inherit;
- cursor: pointer;
- text-decoration: none;
- display: inline-flex;
- align-items: center;
- justify-content: center;
- transition: background 0.15s, border-color 0.15s, color 0.15s;
-}
-
-.pagination button:hover,
-.pagination .page-link:hover {
- background: var(--bg-tertiary);
- border-color: var(--border-focus);
-}
-
-.pagination .page-current {
- background: var(--accent);
- border-color: var(--accent);
- color: #fff;
-}
-
-.pagination .page-current:hover {
- background: var(--accent-hover);
- border-color: var(--accent-hover);
-}
-
-.pagination .prev-next {
- font-weight: 500;
-}
-
-/* ============================================================
- Footer
- ============================================================ */
-
footer {
text-align: center;
- padding: 3rem 1.5rem 2rem;
- color: var(--text-muted);
+ padding: 1.5rem;
+ color: var(--color-footer);
font-size: 0.85rem;
- margin-top: auto;
}
footer a {
- color: var(--accent);
+ color: var(--color-link);
text-decoration: none;
}
@@ -546,21 +112,331 @@ footer a:hover {
text-decoration: underline;
}
-/* ============================================================
- Autocomplete Dropdown
- ============================================================ */
+/* Index / Homepage */
+.index {
+ display: flex;
+ flex-direction: column;
+ align-items: center;
+ justify-content: center;
+ min-height: 60vh;
+ text-align: center;
+}
+
+.index .title h1 {
+ font-size: 2rem;
+ font-weight: 300;
+ margin-bottom: 2rem;
+ letter-spacing: 0.05em;
+}
+
+/* Search form */
+#search {
+ width: 100%;
+ max-width: 600px;
+ margin-bottom: 2rem;
+}
+
+#search form {
+ display: flex;
+ gap: 0.5rem;
+}
+
+#search input[type="text"],
+#q {
+ flex: 1;
+ padding: 0.7rem 1rem;
+ font-size: 1rem;
+ border: 1px solid var(--color-search-border);
+ border-radius: var(--radius);
+ background: var(--color-base-background);
+ color: var(--color-base-font);
+ outline: none;
+ transition: border-color 0.2s;
+}
+
+#search input[type="text"]:focus,
+#q:focus {
+ border-color: var(--color-search-focus);
+ box-shadow: 0 0 0 2px rgba(52, 152, 219, 0.15);
+}
+
+#search button[type="submit"] {
+ padding: 0.7rem 1.2rem;
+ font-size: 1rem;
+ border: 1px solid var(--color-search-border);
+ border-radius: var(--radius);
+ background: var(--color-btn-background);
+ color: var(--color-base-font);
+ cursor: pointer;
+ transition: background 0.2s;
+}
+
+#search button[type="submit"]:hover {
+ background: var(--color-btn-hover);
+}
+
+/* Results page search bar (compact) */
+.search_on_results #search {
+ max-width: 100%;
+ margin-bottom: 1rem;
+}
+
+/* Results area */
+#results {
+ display: flex;
+ gap: 1.5rem;
+}
+
+#sidebar {
+ flex: 0 0 200px;
+ font-size: 0.85rem;
+}
+
+#sidebar p {
+ margin-bottom: 0.5rem;
+}
+
+#urls {
+ flex: 1;
+ min-width: 0;
+}
+
+/* Result count */
+#result_count {
+ margin-bottom: 1rem;
+}
+
+/* Individual result */
+.result {
+ padding: 0.8rem 0;
+ border-bottom: 1px solid var(--color-result-border);
+ word-wrap: break-word;
+}
+
+.result:last-child {
+ border-bottom: none;
+}
+
+.result_header {
+ margin-bottom: 0.2rem;
+}
+
+.result_header a {
+ font-size: 1.1rem;
+ font-weight: 400;
+ color: var(--color-result-title);
+ text-decoration: none;
+}
+
+.result_header a:visited {
+ color: var(--color-result-title-visited);
+}
+
+.result_header a:hover {
+ text-decoration: underline;
+}
+
+.result_url {
+ font-size: 0.85rem;
+ color: var(--color-result-url);
+ margin-bottom: 0.2rem;
+}
+
+.result_url a {
+ color: var(--color-result-url);
+ text-decoration: none;
+}
+
+.result_url a:visited {
+ color: var(--color-result-url-visited);
+}
+
+.result_content {
+ font-size: 0.9rem;
+ color: var(--color-result-content);
+ max-width: 600px;
+}
+
+.result_content p {
+ margin: 0;
+}
+
+.result_engine {
+ font-size: 0.75rem;
+ color: var(--color-result-engine);
+ margin-top: 0.3rem;
+}
+
+.engine {
+ display: inline-block;
+ padding: 0.1rem 0.4rem;
+ background: var(--color-sidebar-background);
+ border: 1px solid var(--color-sidebar-border);
+ border-radius: 2px;
+ font-size: 0.7rem;
+ color: var(--color-result-engine);
+}
+
+/* No results */
+.no_results {
+ text-align: center;
+ padding: 3rem 1rem;
+ color: var(--color-suggestion);
+}
+
+/* Suggestions */
+#suggestions {
+ margin-bottom: 1rem;
+}
+
+.suggestion {
+ display: inline-block;
+ margin: 0.2rem;
+}
+
+.suggestion a {
+ display: inline-block;
+ padding: 0.3rem 0.6rem;
+ font-size: 0.85rem;
+ border: 1px solid var(--color-pagination-border);
+ border-radius: var(--radius);
+ color: var(--color-link);
+ text-decoration: none;
+ background: var(--color-btn-background);
+ transition: background 0.2s;
+}
+
+.suggestion a:hover {
+ background: var(--color-btn-hover);
+}
+
+/* Infoboxes */
+#infoboxes {
+ margin-bottom: 1rem;
+}
+
+.infobox {
+ background: var(--color-infobox-background);
+ border: 1px solid var(--color-infobox-border);
+ border-radius: var(--radius);
+ padding: 0.8rem;
+ margin-bottom: 0.5rem;
+}
+
+.infobox .title {
+ font-weight: 600;
+ margin-bottom: 0.5rem;
+}
+
+/* Errors */
+.dialog-error {
+ background: var(--color-error-background);
+ color: var(--color-error);
+ border: 1px solid var(--color-error);
+ border-radius: var(--radius);
+ padding: 0.8rem 1rem;
+ margin-bottom: 1rem;
+}
+
+/* Unresponsive engines */
+.unresponsive_engines {
+ font-size: 0.8rem;
+ color: var(--color-suggestion);
+ margin-top: 0.5rem;
+}
+
+.unresponsive_engines li {
+ margin: 0.1rem 0;
+}
+
+/* Corrections */
+.correction {
+ font-size: 0.9rem;
+ margin-bottom: 0.5rem;
+}
+
+/* Pagination */
+#pagination {
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ gap: 0.3rem;
+ padding: 1.5rem 0;
+ flex-wrap: wrap;
+}
+
+#pagination button,
+#pagination .page_number,
+#pagination .page_number_current {
+ padding: 0.4rem 0.8rem;
+ font-size: 0.9rem;
+ border: 1px solid var(--color-pagination-border);
+ border-radius: var(--radius);
+ background: var(--color-btn-background);
+ color: var(--color-base-font);
+ cursor: pointer;
+ text-decoration: none;
+ transition: background 0.2s;
+}
+
+#pagination button:hover,
+#pagination .page_number:hover {
+ background: var(--color-btn-hover);
+}
+
+#pagination .page_number_current {
+ background: var(--color-pagination-current);
+ color: #fff;
+ border-color: var(--color-pagination-current);
+ cursor: default;
+}
+
+.previous_page, .next_page {
+ font-weight: 500;
+}
+
+/* Back to top */
+#backToTop {
+ text-align: center;
+ margin: 1rem 0;
+}
+
+#backToTop a {
+ color: var(--color-link);
+ text-decoration: none;
+ font-size: 0.85rem;
+}
+
+/* HTMX loading indicator */
+.htmx-indicator {
+ display: none;
+ text-align: center;
+ padding: 2rem;
+ color: var(--color-suggestion);
+}
+
+.htmx-request .htmx-indicator,
+.htmx-request.htmx-indicator {
+ display: block;
+}
+
+/* Autocomplete dropdown */
+#search {
+ position: relative;
+}
#autocomplete-dropdown {
position: absolute;
- top: calc(100% + 6px);
+ top: 100%;
left: 0;
right: 0;
- background: var(--bg);
- border: 1px solid var(--border);
- border-radius: var(--radius-md);
- box-shadow: var(--shadow-lg);
- z-index: 200;
- max-height: 360px;
+ background: var(--color-base-background);
+ border: 1px solid var(--color-search-border);
+ border-top: none;
+ border-radius: 0 0 var(--radius) var(--radius);
+ box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+ z-index: 100;
+ max-height: 320px;
overflow-y: auto;
display: none;
}
@@ -570,12 +446,12 @@ footer a:hover {
}
.autocomplete-suggestion {
- padding: 0.7rem 1rem;
+ padding: 0.6rem 1rem;
cursor: pointer;
font-size: 0.95rem;
- color: var(--text-primary);
- border-bottom: 1px solid var(--border);
- transition: background 0.1s;
+ color: var(--color-base-font);
+ border-bottom: 1px solid var(--color-result-border);
+ transition: background 0.15s;
}
.autocomplete-suggestion:last-child {
@@ -584,101 +460,159 @@ footer a:hover {
.autocomplete-suggestion:hover,
.autocomplete-suggestion.active {
- background: var(--bg-tertiary);
+ background: var(--color-header-background);
}
.autocomplete-suggestion mark {
background: none;
- color: var(--accent);
+ color: var(--color-link);
font-weight: 600;
}
.autocomplete-footer {
- padding: 0.5rem 1rem;
+ padding: 0.4rem 1rem;
font-size: 0.75rem;
- color: var(--text-muted);
- background: var(--bg-secondary);
- border-radius: 0 0 var(--radius-md) var(--radius-md);
- border-top: 1px solid var(--border);
+ color: var(--color-suggestion);
+ border-top: 1px solid var(--color-result-border);
+ background: var(--color-header-background);
}
-/* ============================================================
+/* Responsive */
+@media (max-width: 768px) {
+ #results {
+ flex-direction: column-reverse;
+ }
+
+ #sidebar {
+ flex: none;
+ border-top: 1px solid var(--color-sidebar-border);
+ padding-top: 0.5rem;
+ }
+
+ .index .title h1 {
+ font-size: 1.5rem;
+ }
+
+ main {
+ padding: 0.5rem;
+ }
+}
+
+/* Print */
+@media print {
+ footer, #pagination, #search button, #backToTop, .htmx-indicator {
+ display: none;
+ }
+
+ body {
+ background: #fff;
+ color: #000;
+ }
+
+ .result a {
+ color: #000;
+ }
+}
+
+/* ============================================
Settings Panel
- ============================================================ */
+ ============================================ */
+/* Header */
+.site-header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 0.6rem 1rem;
+ background: var(--color-header-background);
+ border-bottom: 1px solid var(--color-header-border);
+}
+.site-title {
+ font-size: 1rem;
+ font-weight: 600;
+ color: var(--color-base-font);
+}
+
+/* Gear trigger button */
+.settings-trigger {
+ background: none;
+ border: none;
+ font-size: 1.1rem;
+ cursor: pointer;
+ padding: 0.3rem 0.5rem;
+ border-radius: var(--radius);
+ color: var(--color-base-font);
+ opacity: 0.7;
+ transition: opacity 0.2s, background 0.2s;
+ line-height: 1;
+}
+.settings-trigger:hover,
+.settings-trigger[aria-expanded="true"] {
+ opacity: 1;
+ background: var(--color-sidebar-background);
+}
+
+/* Popover panel */
.settings-popover {
- position: fixed;
- top: calc(var(--header-height) + 8px);
- right: 1rem;
- width: 300px;
- max-height: calc(100vh - var(--header-height) - 2rem);
+ position: absolute;
+ top: 100%;
+ right: 0;
+ width: 280px;
+ max-height: 420px;
overflow-y: auto;
- background: var(--bg);
- border: 1px solid var(--border);
- border-radius: var(--radius-lg);
- box-shadow: var(--shadow-lg);
- z-index: 300;
+ background: var(--color-base-background);
+ border: 1px solid var(--color-sidebar-border);
+ border-radius: var(--radius);
+ box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
+ z-index: 200;
display: none;
+ flex-direction: column;
}
-
.settings-popover[data-open="true"] {
- display: block;
- animation: pop-in 0.2s ease;
+ display: flex;
+ animation: settings-slide-in 0.2s ease;
}
-
-@keyframes pop-in {
- from { opacity: 0; transform: translateY(-8px) scale(0.97); }
- to { opacity: 1; transform: translateY(0) scale(1); }
+@keyframes settings-slide-in {
+ from { opacity: 0; transform: translateY(-8px); }
+ to { opacity: 1; transform: translateY(0); }
}
.settings-popover-header {
display: flex;
justify-content: space-between;
align-items: center;
- padding: 1rem 1.25rem;
- border-bottom: 1px solid var(--border);
+ padding: 0.75rem 1rem;
+ border-bottom: 1px solid var(--color-sidebar-border);
font-weight: 600;
- font-size: 0.95rem;
- position: sticky;
- top: 0;
- background: var(--bg);
- z-index: 1;
+ font-size: 0.9rem;
+ flex-shrink: 0;
}
-
.settings-popover-close {
background: none;
border: none;
- width: 28px;
- height: 28px;
- border-radius: var(--radius-sm);
- cursor: pointer;
- color: var(--text-secondary);
- display: flex;
- align-items: center;
- justify-content: center;
font-size: 1.2rem;
- transition: background 0.15s, color 0.15s;
-}
-
-.settings-popover-close:hover {
- background: var(--bg-tertiary);
- color: var(--text-primary);
+ cursor: pointer;
+ color: var(--color-base-font);
+ opacity: 0.6;
+ padding: 0 0.25rem;
+ line-height: 1;
}
+.settings-popover-close:hover { opacity: 1; }
.settings-popover-body {
- padding: 1rem 1.25rem;
+ padding: 0.8rem;
display: flex;
flex-direction: column;
- gap: 1.25rem;
+ gap: 1rem;
}
.settings-section-title {
font-size: 0.7rem;
font-weight: 600;
text-transform: uppercase;
- letter-spacing: 0.06em;
- color: var(--text-muted);
- margin-bottom: 0.6rem;
+ letter-spacing: 0.05em;
+ color: var(--color-suggestion);
+ margin-bottom: 0.5rem;
}
/* Theme buttons */
@@ -686,109 +620,162 @@ footer a:hover {
display: flex;
gap: 0.4rem;
}
-
.theme-btn {
flex: 1;
- padding: 0.45rem;
- border: 1px solid var(--border);
- border-radius: var(--radius-sm);
- background: var(--bg);
- color: var(--text-secondary);
+ padding: 0.35rem 0.5rem;
+ border: 1px solid var(--color-sidebar-border);
+ border-radius: var(--radius);
+ background: var(--color-btn-background);
+ color: var(--color-base-font);
cursor: pointer;
- font-size: 0.8rem;
- font-family: inherit;
- transition: background 0.15s, border-color 0.15s, color 0.15s;
+ font-size: 0.75rem;
+ text-align: center;
+ transition: background 0.15s, border-color 0.15s;
}
-
-.theme-btn:hover {
- background: var(--bg-tertiary);
-}
-
+.theme-btn:hover { background: var(--color-btn-hover); }
.theme-btn.active {
- background: var(--accent-soft);
- border-color: var(--accent);
- color: var(--accent);
- font-weight: 500;
+ background: var(--color-link);
+ color: #fff;
+ border-color: var(--color-link);
}
-/* Engine toggles */
+/* Engine toggles — 2-column grid */
.engine-grid {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 0.4rem;
}
-
.engine-toggle {
display: flex;
align-items: center;
gap: 0.4rem;
- padding: 0.4rem 0.5rem;
- border-radius: var(--radius-sm);
- background: var(--bg-tertiary);
- font-size: 0.8rem;
+ padding: 0.3rem 0.5rem;
+ border-radius: var(--radius);
+ background: var(--color-sidebar-background);
+ font-size: 0.78rem;
cursor: pointer;
- transition: background 0.1s;
}
-
-.engine-toggle:hover {
- background: var(--border);
-}
-
.engine-toggle input[type="checkbox"] {
width: 15px;
height: 15px;
margin: 0;
cursor: pointer;
- accent-color: var(--accent);
- flex-shrink: 0;
+ accent-color: var(--color-link);
}
-
.engine-toggle span {
- color: var(--text-secondary);
- white-space: nowrap;
+ flex: 1;
+ min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
+ white-space: nowrap;
}
-/* Select dropdowns */
+/* Search defaults */
.setting-row {
display: flex;
align-items: center;
justify-content: space-between;
- gap: 0.75rem;
+ gap: 0.5rem;
+ margin-top: 0.4rem;
}
-
.setting-row label {
font-size: 0.85rem;
- color: var(--text-secondary);
+ flex: 1;
}
-
.setting-row select {
- padding: 0.35rem 0.6rem;
+ width: 110px;
+ padding: 0.3rem 0.4rem;
font-size: 0.8rem;
- font-family: inherit;
- border: 1px solid var(--border);
- border-radius: var(--radius-sm);
- background: var(--bg);
- color: var(--text-primary);
+ border: 1px solid var(--color-sidebar-border);
+ border-radius: var(--radius);
+ background: var(--color-base-background);
+ color: var(--color-base-font);
cursor: pointer;
- min-width: 100px;
-}
-
-.setting-row select:focus {
- outline: none;
- border-color: var(--accent);
}
+/* Mid-search notice */
.settings-notice {
- font-size: 0.75rem;
- color: var(--text-muted);
+ font-size: 0.72rem;
+ color: var(--color-suggestion);
+ margin-top: 0.3rem;
font-style: italic;
- margin-top: 0.25rem;
}
-/* Mobile settings: bottom sheet */
-@media (max-width: 480px) {
+/* Dark theme via data-theme attribute */
+html[data-theme="dark"] {
+ --color-base: #222;
+ --color-base-font: #dcdcdc;
+ --color-base-background: #2b2b2b;
+ --color-header-background: #333;
+ --color-header-border: #444;
+ --color-search-border: #555;
+ --color-search-focus: #5dade2;
+ --color-result-url: #8ab4f8;
+ --color-result-url-visited: #b39ddb;
+ --color-result-content: #b0b0b0;
+ --color-result-title: #8ab4f8;
+ --color-result-title-visited: #b39ddb;
+ --color-result-engine: #999;
+ --color-result-border: #3a3a3a;
+ --color-link: #5dade2;
+ --color-link-visited: #b39ddb;
+ --color-sidebar-background: #333;
+ --color-sidebar-border: #444;
+ --color-infobox-background: #333;
+ --color-infobox-border: #444;
+ --color-pagination-current: #5dade2;
+ --color-pagination-border: #444;
+ --color-error: #e74c3c;
+ --color-error-background: #3b1a1a;
+ --color-suggestion: #999;
+ --color-footer: #666;
+ --color-btn-background: #333;
+ --color-btn-border: #555;
+ --color-btn-hover: #444;
+}
+
+/* Light theme via data-theme attribute - explicit reset */
+html[data-theme="light"] {
+ --color-base: #f5f5f5;
+ --color-base-font: #444;
+ --color-base-background: #fff;
+ --color-header-background: #f7f7f7;
+ --color-header-border: #ddd;
+ --color-search-border: #bbb;
+ --color-search-focus: #3498db;
+ --color-result-url: #1a0dab;
+ --color-result-url-visited: #609;
+ --color-result-content: #545454;
+ --color-result-title: #1a0dab;
+ --color-result-title-visited: #609;
+ --color-result-engine: #666;
+ --color-result-border: #eee;
+ --color-link: #3498db;
+ --color-link-visited: #609;
+ --color-sidebar-background: #f7f7f7;
+ --color-sidebar-border: #ddd;
+ --color-infobox-background: #f9f9f9;
+ --color-infobox-border: #ddd;
+ --color-pagination-current: #3498db;
+ --color-pagination-border: #ddd;
+ --color-error: #c0392b;
+ --color-error-background: #fdecea;
+ --color-suggestion: #666;
+ --color-footer: #888;
+ --color-btn-background: #fff;
+ --color-btn-border: #ddd;
+ --color-btn-hover: #eee;
+}
+
+/* Mobile: Bottom sheet + FAB trigger */
+@media (max-width: 768px) {
+ /* Hide desktop trigger, show FAB */
+ .settings-trigger-desktop {
+ display: none;
+ }
+ .settings-trigger-mobile {
+ display: block;
+ }
.settings-popover {
position: fixed;
top: auto;
@@ -797,64 +784,29 @@ footer a:hover {
right: 0;
width: 100%;
max-height: 70vh;
- border-radius: var(--radius-lg) var(--radius-lg) 0 0;
+ border-radius: var(--radius) var(--radius) 0 0;
border-bottom: none;
}
-
+ /* FAB: fixed bottom-right button visible only on mobile */
.settings-trigger-mobile {
- display: flex;
+ display: block;
+ position: fixed;
+ bottom: 1.5rem;
+ right: 1.5rem;
+ width: 48px;
+ height: 48px;
+ border-radius: 50%;
+ background: var(--color-link);
+ color: #fff;
+ border: none;
+ box-shadow: 0 4px 12px rgba(0,0,0,0.2);
+ font-size: 1.2rem;
+ z-index: 199;
+ opacity: 1;
}
}
-@media (min-width: 481px) {
- .settings-trigger-mobile {
- display: none;
- }
-}
-
-/* ============================================================
- HTMX Loading State
- ============================================================ */
-
-.htmx-indicator {
- display: none;
- text-align: center;
- padding: 2rem;
- color: var(--text-muted);
-}
-
-.htmx-request .htmx-indicator {
- display: block;
-}
-
-.htmx-request .results-column {
- opacity: 0.5;
- transition: opacity 0.2s;
-}
-
-/* ============================================================
- Back to Top
- ============================================================ */
-
-.back-to-top {
- text-align: center;
- padding: 1rem;
-}
-
-.back-to-top a {
- color: var(--accent);
- text-decoration: none;
- font-size: 0.85rem;
-}
-
-.back-to-top a:hover {
- text-decoration: underline;
-}
-
-/* ============================================================
- Video Results
- ============================================================ */
-
+/* Video result cards */
.video-result {
display: flex;
gap: 1rem;
@@ -864,134 +816,15 @@ footer a:hover {
.video-result .result_thumbnail {
flex-shrink: 0;
width: 180px;
- border-radius: var(--radius-sm);
- overflow: hidden;
- background: var(--bg-tertiary);
}
.video-result .result_thumbnail img {
width: 100%;
height: auto;
- display: block;
- object-fit: cover;
+ border-radius: var(--radius);
}
.video-result .result_content_wrapper {
flex: 1;
min-width: 0;
}
-
-@media (max-width: 480px) {
- .video-result {
- flex-direction: column;
- }
-
- .video-result .result_thumbnail {
- width: 100%;
- }
-}
-
-/* ============================================================
- Infoboxes
- ============================================================ */
-
-.infobox {
- background: var(--bg-secondary);
- border: 1px solid var(--border);
- border-radius: var(--radius-md);
- padding: 1rem;
- margin-bottom: 0.75rem;
-}
-
-.infobox .title {
- font-weight: 600;
- margin-bottom: 0.5rem;
- font-size: 0.95rem;
-}
-
-.infobox img {
- max-width: 100%;
- border-radius: var(--radius-sm);
- margin-top: 0.5rem;
-}
-
-/* ============================================================
- Errors
- ============================================================ */
-
-.dialog-error {
- background: color-mix(in srgb, var(--accent) 8%, var(--bg));
- border: 1px solid color-mix(in srgb, var(--accent) 30%, transparent);
- color: var(--accent);
- border-radius: var(--radius-md);
- padding: 0.8rem 1rem;
- margin-bottom: 1rem;
- font-size: 0.9rem;
-}
-
-/* ============================================================
- Focus visible — keyboard navigation
- ============================================================ */
-
-:focus-visible {
- outline: 2px solid var(--accent);
- outline-offset: 2px;
-}
-
-button:focus-visible,
-a:focus-visible {
- outline: 2px solid var(--accent);
- outline-offset: 2px;
-}
-
-/* ============================================================
- Selection color
- ============================================================ */
-
-::selection {
- background: var(--accent-soft);
- color: var(--accent);
-}
-
-/* ============================================================
- Scrollbar
- ============================================================ */
-
-::-webkit-scrollbar {
- width: 8px;
- height: 8px;
-}
-
-::-webkit-scrollbar-track {
- background: var(--bg-secondary);
-}
-
-::-webkit-scrollbar-thumb {
- background: var(--border);
- border-radius: 4px;
-}
-
-::-webkit-scrollbar-thumb:hover {
- background: var(--border-focus);
-}
-
-/* ============================================================
- Print
- ============================================================ */
-
-@media print {
- .site-header, footer, .settings-popover, #backToTop, .htmx-indicator, .settings-trigger {
- display: none !important;
- }
-
- body {
- background: #fff;
- color: #000;
- }
-
- .result {
- break-inside: avoid;
- border: 1px solid #ddd;
- margin-bottom: 1rem;
- }
-}
diff --git a/internal/views/templates/base.html b/internal/views/templates/base.html
index d2fec79..239e886 100644
--- a/internal/views/templates/base.html
+++ b/internal/views/templates/base.html
@@ -1,6 +1,6 @@
{{define "base"}}
-
+
@@ -13,43 +13,31 @@
-
+
-
-
- kafka
-
-
+ kafka
+
+
-
-
+
+
+
{{template "content" .}}
-
-
-