metaowl 0.1.0

package/CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contributing to metaowl
+
+Thank you for considering a contribution! Here is how to get started.
+
+## Reporting Issues
+
+Before opening a new issue, please [search existing issues](https://github.com/dennisschott/metaowl/issues) to avoid duplicates. When filing a bug report, include:
+
+- metaowl version (`npm ls metaowl`)
+- Node.js version (`node --version`)
+- Minimal reproduction steps or a repository link
+- Expected vs. actual behaviour
+
+## Development Setup
+
+```bash
+git clone https://github.com/dennisschott/metaowl.git
+cd metaowl
+npm install
+```
+
+## Submitting a Pull Request
+
+1. **Open an issue first** to discuss significant changes before investing time in an implementation.
+2. Fork the repository and create a feature branch from `main`:
+   ```bash
+   git checkout -b feat/my-feature
+   ```
+3. Make your changes, keeping scope minimal and focused.
+4. Ensure the project is lint-clean:
+   ```bash
+   node bin/metaowl-lint.js
+   ```
+5. Commit using [Conventional Commits](https://www.conventionalcommits.org):
+   - `feat:` — new features
+   - `fix:` — bug fixes
+   - `docs:` — documentation only
+   - `chore:` — tooling, dependencies
+6. Push your branch and open a pull request against `main`.
+
+## Code Style
+
+- ES modules (`import`/`export`) throughout.
+- No semicolons; single quotes; no trailing commas (enforced by ESLint).
+- Keep public API surface minimal — prefer extending existing modules over adding new entry points.
+
+## License
+
+By contributing you agree that your contributions will be licensed under the [MIT License](LICENSE).

package/LICENSE

@@ -0,0 +1,147 @@
+GNU LESSER GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2026 Dennis Schott
+
+Everyone is permitted to copy and distribute verbatim copies of this license
+document, but changing it is not allowed.
+
+This version of the GNU Lesser General Public License incorporates the terms
+and conditions of version 3 of the GNU General Public License, supplemented by
+the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser General
+Public License, and the "GNU GPL" refers to version 3 of the GNU General Public
+License.
+
+  "The Library" refers to a covered work governed by this License, other than an
+Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided by the
+Library, but which is not otherwise based on the Library. Defining a subclass of
+a class defined by the Library is deemed a mode of using an interface provided
+by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an Application
+with the Library. The particular version of the Library with which the Combined
+Work was made is also called the "Linked Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the Corresponding
+Source for the Combined Work, excluding any source code for portions of the
+Combined Work that, considered in isolation, are based on the Application, and
+not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the object code
+and/or source code for the Application, including any data and utility programs
+needed for reproducing the Combined Work from the Application, but excluding the
+System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a verbatim copy of the Library's object code under the terms of
+sections 4-7 of this License 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 anyone who possesses the object code, to
+  provide the Corresponding Source for a fee no more than the cost of physically
+  performing this source distribution.
+
+  c) Convey individual copies of the object code with a copy of the written
+  offer to provide the Corresponding Source.
+
+  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.
+
+  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.
+
+  2. No Surrender of Others' Freedom.
+
+  Nothing in this License grants you permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the work.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The Corresponding Source for a Combined Work may include the Corresponding
+Source for the Application, and any portion of the Library required to link that
+Application. The object code and/or source code for the Application's interface
+to the Library need not be included.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that, taken
+together, effectively do not restrict modification of the portions of the
+Library contained in the Combined Work and reverse engineering for debugging such
+modifications, if you also do each of the following:
+
+  a) Give prominent notice with each copy of the Combined Work that the Library
+  is used in it and that the Library and its use are covered by this License.
+
+  b) Accompany the Combined Work with a copy of the GNU GPL and this license
+  document.
+
+  c) For a Combined Work that displays copyright notices during execution, include
+  the copyright notice for the Library among these notices, as well as a
+  reference directing the user to the copies of the GNU GPL and this License.
+
+  d) Do one of the following:
+    0) Convey the Minimal Corresponding Source under the terms of this License,
+    and the Corresponding Application Code in a form suitable for, and under
+    terms that permit, the user to recombine or relink the Application with a
+    modified version of the Linked Version.
+    1) Use a suitable shared library mechanism for linking with the Library.
+
+  e) Provide Installation Information, but only if you are otherwise required to
+  provide such information under section 6 of the GNU GPL, and only to the
+  extent that such information is necessary to install and execute a modified
+  version of the Combined Work.
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the Library side by
+side in a single library together with other library facilities that are not
+Applications and are not covered by this License, and convey such a combined
+library under terms of your choice, if you do both of the following:
+
+  a) Accompany the combined library with a copy of the same work based on the
+  Library, uncombined with any other library facilities, conveyed under the
+  terms of this License.
+
+  b) Give prominent notice with the combined library that part of it is a work
+  based on the Library, and explaining where to find the accompanying uncombined
+  form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions of the
+GNU Lesser 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 Library as you
+received it specifies that a certain numbered version of the GNU Lesser General
+Public License "or any later version" applies to it, you have the option of
+following the terms and conditions either of that published version or of any
+later version published by the Free Software Foundation. If the Library as you
+received it does not specify a version number, you may choose any version of
+the GNU Lesser General Public License ever published by the Free Software
+Foundation.
+
+  If the Library as you received it specifies that a proxy can decide whether
+future versions of the GNU Lesser General Public License shall apply, that
+proxy's public statement of acceptance of any version is permanent authorization
+for you to choose that version for the Library.
+
+For the full text of the GNU GPL v3, see:
+https://www.gnu.org/licenses/gpl-3.0.html