@threenine/nuxstr-comments 1.0.0

package/LICENSE

@@ -0,0 +1,611 @@
+MIT License
+
+Copyright (c) 2024 Threenine Consulting Limited
+
+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.
+  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 "Account 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 Account Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that Account 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 Account Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+Account 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 Account 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 Account 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.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    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 <https://www.gnu.org/licenses/>.
+
+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
+<https://www.gnu.org/licenses/>.

package/README.md

@@ -0,0 +1,118 @@
+<!--
+Get your module up and running quickly.
+
+Find and replace all on all files (CMD+SHIFT+F):
+- Name: Nuxstr Comments
+- Package name: @threenine/nuxstr-comments
+- Description: Nuxstr Comments
+-->
+
+# Nuxstr Comments
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![License][license-src]][license-href]
+[![Nuxt][nuxt-src]][nuxt-href]
+
+Nuxstr Comments for doing amazing things.
+
+- [✨ &nbsp;Release Notes](/CHANGELOG.md)
+<!-- - [🏀 Online playground](https://stackblitz.com/github/your-org/@threenine/nuxstr-comments?file=playground%2Fapp.vue) -->
+<!-- - [📖 &nbsp;Documentation](https://example.com) -->
+
+## Features
+
+- Nostr-powered comments for Nuxt Content blog posts
+- NIP-07 login prompt if user is not authenticated
+- Comments are written in Markdown and rendered via @nuxt/content's ContentRendererMarkdown
+- Configurable relay list and tagging strategy
+
+## Quick Setup
+
+Install the module to your Nuxt application with one command:
+
+```bash
+npx nuxi module add @threenine/nuxstr-comments
+```
+
+That's it! You can now use Nuxstr Comments in your Nuxt app ✨
+
+### Usage
+
+1. Ensure @nuxt/content is enabled and your blog post pages use ContentDoc or render content files.
+2. Add the comments component where you want comments to appear (usually below a ContentDoc):
+
+```vue
+<template>
+  <div>
+    <ContentDoc />
+    <NuxstrComments />
+  </div>
+</template>
+```
+
+By default, the component tags comments by the current route path (e.g., content:/blog/my-post) and fetches them from configured relays.
+
+3. Configuration (nuxt.config.ts):
+
+```ts
+export default defineNuxtConfig({
+  modules: [
+    '@nuxt/content',
+    '@threenine/nuxstr-comments',
+  ],
+  nuxstrComments: {
+    relays: ['wss://relay.damus.io', 'wss://relay.nostr.band'],
+    tagStrategy: 'path',
+    tagPrefix: 'content:',
+  },
+})
+```
+
+When a user attempts to post, they will be prompted to log in with their Nostr browser extension (NIP-07). Comments are published as kind:1 notes tagged with a `t` tag containing the content tag (e.g., `content:/blog/my-post`). Rendering of comment bodies uses @nuxt/content's ContentRendererMarkdown component so users can write markdown.
+
+
+## Contribution
+
+<details>
+  <summary>Local development</summary>
+  
+  ```bash
+  # Install dependencies
+  npm install
+  
+  # Generate type stubs
+  npm run dev:prepare
+  
+  # Develop with the playground
+  npm run dev
+  
+  # Build the playground
+  npm run dev:build
+  
+  # Run ESLint
+  npm run lint
+  
+  # Run Vitest
+  npm run test
+  npm run test:watch
+  
+  # Release new version
+  npm run release
+  ```
+
+</details>
+
+
+<!-- Badges -->
+[npm-version-src]: https://img.shields.io/npm/v/@threenine/nuxstr-comments/latest.svg?style=flat&colorA=020420&colorB=00DC82
+[npm-version-href]: https://npmjs.com/package/@threenine/nuxstr-comments
+
+[npm-downloads-src]: https://img.shields.io/npm/dm/@threenine/nuxstr-comments.svg?style=flat&colorA=020420&colorB=00DC82
+[npm-downloads-href]: https://npm.chart.dev/@threenine/nuxstr-comments
+
+[license-src]: https://img.shields.io/npm/l/@threenine/nuxstr-comments.svg?style=flat&colorA=020420&colorB=00DC82
+[license-href]: https://npmjs.com/package/@threenine/nuxstr-comments
+
+[nuxt-src]: https://img.shields.io/badge/Nuxt-020420?logo=nuxt.js
+[nuxt-href]: https://nuxt.com

package/dist/module.d.mts

@@ -0,0 +1,11 @@
+import * as _nuxt_schema from '@nuxt/schema';
+
+interface ModuleOptions {
+    relays?: string[];
+    tagStrategy?: 'path' | 'id' | 'custom';
+    tagPrefix?: string;
+}
+declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
+
+export { _default as default };
+export type { ModuleOptions };

package/dist/module.json

@@ -0,0 +1,9 @@
+{
+  "name": "@threenine/nuxstr-comments",
+  "configKey": "nuxstrComments",
+  "version": "1.0.0",
+  "builder": {
+    "@nuxt/module-builder": "1.0.2",
+    "unbuild": "3.6.1"
+  }
+}

package/dist/module.mjs

@@ -0,0 +1,30 @@
+import { defineNuxtModule, createResolver, addPlugin, addImports, addComponent } from '@nuxt/kit';
+import { defu } from 'defu';
+
+const module = defineNuxtModule({
+  meta: {
+    name: "@threenine/nuxstr-comments",
+    configKey: "nuxstrComments"
+  },
+  // Default configuration options of the Nuxt module
+  defaults: {
+    relays: ["wss://relay.damus.io", "wss://relay.nostr.band", "wss://nos.lol"],
+    tagStrategy: "path",
+    tagPrefix: "comment:"
+  },
+  setup(options, nuxt) {
+    const resolver = createResolver(import.meta.url);
+    nuxt.options.runtimeConfig.public.nuxstrComments = defu(nuxt.options.runtimeConfig.public.nuxstrComments || {}, options);
+    addPlugin(resolver.resolve("./runtime/plugin"));
+    addImports([
+      { name: "useNuxstr", as: "useNuxstr", from: resolver.resolve("./runtime/composables/useNuxstr") },
+      { name: "useNuxstrComments", as: "useNuxstrComments", from: resolver.resolve("./runtime/composables/useNuxstrComments") }
+    ]);
+    addComponent({
+      name: "NuxstrComments",
+      filePath: resolver.resolve("./runtime/components/NuxstrComments.vue")
+    });
+  }
+});
+
+export { module as default };

package/dist/runtime/components/NuxstrComments.vue

@@ -0,0 +1,119 @@
+<script setup>
+import { ref, onMounted } from "vue";
+import { useNuxstr } from "../composables/useNuxstr";
+import { useNuxstrComments } from "../composables/useNuxstrComments";
+const props = defineProps({
+  contentId: { type: String, required: false }
+});
+const { login, isLoggedIn } = useNuxstr();
+const { comments, fetchComments, postComment, loading } = useNuxstrComments(props.contentId);
+const comment = ref("");
+onMounted(() => {
+  fetchComments();
+});
+async function handlePost() {
+  if (!comment.value.trim()) return;
+  const ok = await postComment(comment.value);
+  if (ok) comment.value = "";
+}
+function parseContent(html) {
+  return { body: createRoot(html) };
+}
+function createRoot(html) {
+  return {
+    type: "root",
+    children: [
+      {
+        type: "element",
+        tag: "div",
+        props: { innerHTML: html }
+      }
+    ]
+  };
+}
+</script>
+
+<template>
+  <div class="nuxstr-comments space-y-4">
+    <div class="flex items-center justify-between">
+      <h3 class="text-lg font-semibold">
+        Comments
+      </h3>
+      <UButton
+        v-if="!isLoggedIn"
+        color="primary"
+        variant="solid"
+        leading-icon="game-icons:ostrich"
+        @click="login"
+      >
+        Login
+      </UButton>
+    </div>
+
+    <div
+      v-if="loading"
+      class="text-sm"
+    >
+      Loading comments…
+    </div>
+
+    <div
+      v-else
+      class="space-y-6"
+    >
+      <div
+        v-for="c in comments"
+        :key="c.id"
+        class="rounded border p-3 mt-2"
+      >
+        <div class="flex items-center gap-3 mb-3 mt-2">
+          <div
+            v-if="c.profile?.picture"
+            class="flex-shrink-0"
+          >
+            <UAvatar
+              :src="c.profile.picture"
+              :alt="c.profile.name || c.profile.display_name || 'User avatar'"
+              class="w-8 h-8 rounded-full object-cover"
+            />
+          </div>
+          <div class="flex-1 min-w-0">
+            <div class="truncate">
+              {{ c.profile?.display_name || c.profile?.name || `${c.pubkey.slice(0, 8)}\u2026` }}
+              <span class="text-xs">{{ new Date(c.created_at * 1e3).toLocaleString() }}</span>
+            </div>
+          </div>
+        </div>
+        <div class="prose prose-sm prose-invert mt-2">
+          <ContentRenderer :value="parseContent(c.content)" />
+        </div>
+      </div>
+    </div>
+
+    <div
+      v-if="isLoggedIn"
+      class="space-y-2"
+    >
+      <UTextarea
+        v-model="comment"
+        class="w-full"
+        placeholder="Write a comment ...."
+        :rows="4"
+      />
+      <div class="flex justify-end">
+        <UButton
+          color="primary"
+          variant="solid"
+          :disabled="!comment.trim()"
+          @click="handlePost"
+        >
+          Post Comment
+        </UButton>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.nuxstr-comments :deep(pre){white-space:pre-wrap}
+</style>

package/dist/runtime/components/NuxstrComments.vue.d.ts

@@ -0,0 +1,5 @@
+type __VLS_Props = {
+    contentId?: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/runtime/composables/useNuxstr.d.ts

@@ -0,0 +1,9 @@
+import NDK from '@nostr-dev-kit/ndk';
+export declare function useNuxstr(): {
+    readonly ndk: NDK;
+    connect: () => Promise<NDK>;
+    login: () => Promise<void>;
+    logout: () => void;
+    isLoggedIn: import("vue").ComputedRef<boolean>;
+    pubkey: import("vue").Ref<string | null | undefined, string | null | undefined>;
+};

package/dist/runtime/composables/useNuxstr.js

@@ -0,0 +1,74 @@
+import { computed, ref } from "vue";
+import { useRuntimeConfig } from "#imports";
+import NDK, { NDKNip07Signer } from "@nostr-dev-kit/ndk";
+import { useToast } from "#ui/composables/useToast";
+export function useNuxstr() {
+  const w = globalThis;
+  if (!w.__nuxstr) {
+    w.__nuxstr = {
+      ndk: null,
+      signer: null,
+      pubkey: ref(null),
+      isConnecting: ref(false),
+      isConnected: ref(false)
+    };
+  }
+  const state = w.__nuxstr;
+  const config = useRuntimeConfig();
+  const opts = config.public?.nuxstrComments || {};
+  function initializeNDK() {
+    if (!state.ndk) {
+      state.ndk = new NDK({ explicitRelayUrls: opts.relays || [] });
+    }
+    return state.ndk;
+  }
+  const isLoggedIn = computed(() => !!state.pubkey.value);
+  async function connect() {
+    const ndk = initializeNDK();
+    if (state.isConnected.value) return ndk;
+    if (state.isConnecting.value) return ndk;
+    state.isConnecting.value = true;
+    try {
+      await ndk.connect();
+      state.isConnected.value = true;
+      return ndk;
+    } finally {
+      state.isConnecting.value = false;
+    }
+  }
+  async function checkExtension() {
+    if ("nostr" in window) return true;
+    const toast = useToast();
+    toast.add({
+      title: "Nostr extension not found",
+      description: "NIP-07 browser extension not found. Install a Nostr extension like nos2x, Alby, or Coracle.",
+      icon: "game-icons:ostrich"
+    });
+    return false;
+  }
+  async function login() {
+    if (await checkExtension()) {
+      const ndk = initializeNDK();
+      const signer = new NDKNip07Signer();
+      ndk.signer = signer;
+      const user = await signer.user();
+      state.signer = signer;
+      state.pubkey.value = user.pubkey;
+      await connect();
+    }
+  }
+  function logout() {
+    state.signer = null;
+    state.pubkey.value = null;
+  }
+  return {
+    get ndk() {
+      return initializeNDK();
+    },
+    connect,
+    login,
+    logout,
+    isLoggedIn,
+    pubkey: state.pubkey
+  };
+}

package/dist/runtime/composables/useNuxstrComments.d.ts

@@ -0,0 +1,33 @@
+import type { NuxstrComment } from '~/src/runtime/types';
+export declare function useNuxstrComments(customContentId?: string): {
+    loading: import("vue").Ref<boolean, boolean>;
+    error: import("vue").Ref<string | null, string | null>;
+    comments: import("vue").Ref<{
+        id: string;
+        pubkey: string;
+        created_at: number;
+        content: string;
+        profile?: {
+            name?: string | undefined;
+            display_name?: string | undefined;
+            about?: string | undefined;
+            picture?: string | undefined;
+            nip05?: string | undefined;
+        } | undefined;
+    }[], NuxstrComment[] | {
+        id: string;
+        pubkey: string;
+        created_at: number;
+        content: string;
+        profile?: {
+            name?: string | undefined;
+            display_name?: string | undefined;
+            about?: string | undefined;
+            picture?: string | undefined;
+            nip05?: string | undefined;
+        } | undefined;
+    }[]>;
+    isLoggedIn: import("vue").ComputedRef<boolean>;
+    fetchComments: () => Promise<void>;
+    postComment: (comment: string) => Promise<boolean>;
+};

package/dist/runtime/composables/useNuxstrComments.js

@@ -0,0 +1,86 @@
+import { computed, ref } from "vue";
+import { useRoute, useRuntimeConfig } from "#imports";
+import { useNuxstr } from "./useNuxstr.js";
+import { NDKEvent, NDKKind } from "@nostr-dev-kit/ndk";
+export function useNuxstrComments(customContentId) {
+  const { ndk, connect, isLoggedIn } = useNuxstr();
+  const route = useRoute();
+  const config = useRuntimeConfig();
+  const opts = config.public?.nuxstrComments || {};
+  const loading = ref(false);
+  const error = ref(null);
+  const comments = ref([]);
+  const contentId = computed(() => {
+    if (customContentId) return customContentId;
+    return route.path;
+  });
+  function tagValue() {
+    const prefix = opts.tagPrefix || "comment:";
+    return `${prefix}${contentId.value}`;
+  }
+  async function fetchProfile(pubkey) {
+    try {
+      const filter = { kinds: [0], authors: [pubkey] };
+      const events = await ndk.fetchEvents(filter);
+      const latestEvent = Array.from(events).sort((a, b) => (b.created_at || 0) - (a.created_at || 0))[0];
+      if (!latestEvent?.content) return void 0;
+      const profileData = JSON.parse(latestEvent.content);
+      return {
+        name: profileData.name,
+        display_name: profileData.display_name,
+        about: profileData.about,
+        picture: profileData.picture,
+        nip05: profileData.nip05
+      };
+    } catch (error2) {
+      console.warn("Failed to fetch profile for", pubkey, error2);
+      return void 0;
+    }
+  }
+  async function fetchComments() {
+    loading.value = true;
+    error.value = null;
+    try {
+      await connect();
+      const filter = { kinds: [NDKKind.GenericReply], ["#t"]: [tagValue()] };
+      const events = await ndk.fetchEvents(filter);
+      const list = Array.from(events).sort((a, b) => (a.created_at || 0) - (b.created_at || 0));
+      const pubkeys = [...new Set(list.map((e) => e.pubkey))];
+      const profilePromises = pubkeys.map(async (pubkey) => {
+        const profile = await fetchProfile(pubkey);
+        return { pubkey, profile };
+      });
+      const profileResults = await Promise.all(profilePromises);
+      const profileMap = new Map(profileResults.map((r) => [r.pubkey, r.profile]));
+      comments.value = list.map((e) => ({
+        id: e.id,
+        pubkey: e.pubkey,
+        created_at: e.created_at || 0,
+        content: e.content,
+        profile: profileMap.get(e.pubkey)
+      }));
+    } catch (e) {
+      error.value = e?.message || String(e);
+    } finally {
+      loading.value = false;
+    }
+  }
+  async function postComment(comment) {
+    await connect();
+    const e = new NDKEvent(ndk);
+    e.kind = NDKKind.GenericReply;
+    e.content = comment;
+    e.tags = [
+      ["t", tagValue()]
+    ];
+    const ok = await e.publish().then(() => true).catch((err) => {
+      error.value = err?.message || String(err);
+      return false;
+    });
+    if (ok) {
+      await fetchComments();
+    }
+    return ok;
+  }
+  return { loading, error, comments, isLoggedIn, fetchComments, postComment };
+}

package/dist/runtime/plugin.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("#app").Plugin<Record<string, unknown>> & import("#app").ObjectPlugin<Record<string, unknown>>;
+export default _default;

package/dist/runtime/plugin.js

@@ -0,0 +1,3 @@
+import { defineNuxtPlugin } from "#app";
+export default defineNuxtPlugin(() => {
+});

package/dist/runtime/server/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "../../../.nuxt/tsconfig.server.json",
+}

package/dist/runtime/types/index.d.ts

@@ -0,0 +1,26 @@
+export type NuxstrProfile = {
+    name?: string;
+    display_name?: string;
+    about?: string;
+    picture?: string;
+    nip05?: string;
+};
+export type NuxstrComment = {
+    id: string;
+    pubkey: string;
+    created_at: number;
+    content: string;
+    profile?: NuxstrProfile;
+};
+export interface ElementNode {
+    type: 'element';
+    tag: string;
+    props?: Record<string, unknown>;
+}
+export interface RootNode {
+    type: 'root';
+    children: ElementNode[];
+}
+export interface HtmlAst {
+    body: RootNode;
+}

package/dist/types.d.mts

@@ -0,0 +1,3 @@
+export { default } from './module.mjs'
+
+export { type ModuleOptions } from './module.mjs'

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@threenine/nuxstr-comments",
+  "version": "1.0.0",
+  "description": "Nuxstr Comments",
+  "repository": "threenine/nuxstr-comments",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/module.mjs"
+    }
+  },
+  "main": "./dist/module.mjs",
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types.d.mts"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@nostr-dev-kit/ndk": "^2.14.33",
+    "@nuxt/kit": "^4.0.3",
+    "nostr-tools": "^2.16.2",
+    "defu": "^6.1.4"
+  },
+  "devDependencies": {
+    "@nuxt/content": "3.6.3",
+    "@nuxt/devtools": "^2.6.2",
+    "@nuxt/eslint": "1.9.0",
+    "@nuxt/eslint-config": "^1.9.0",
+    "@nuxt/module-builder": "^1.0.2",
+    "@nuxt/schema": "^4.0.3",
+    "@nuxt/scripts": "0.11.10",
+    "@nuxt/test-utils": "^3.19.2",
+    "@nuxt/ui": "3.3.2",
+    "@testing-library/jest-dom": "^6.8.0",
+    "@testing-library/vue": "^8.1.0",
+    "@types/node": "latest",
+    "@unhead/vue": "^2.0.14",
+    "changelogen": "^0.6.2",
+    "eslint": "^9.33.0",
+    "jsdom": "^26.1.0",
+    "nuxt": "^4.0.3",
+    "typescript": "~5.9.2",
+    "vitest": "^3.2.4",
+    "vue-tsc": "^3.0.5"
+  },
+  "scripts": {
+    "dev": "npm run dev:prepare && nuxi dev playground",
+    "dev:build": "nuxi build playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare playground",
+    "release": "npm run lint && npm run test && npm run prepack && changelogen --release && npm publish && git push --follow-tags",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit"
+  }
+}