Adds main readme and license.

This commit is contained in:
lelanthran 2025-04-06 07:59:42 +02:00
parent b3e7d84f3b
commit 99618e6f0a
2 changed files with 106 additions and 6 deletions

29
LICENSE
View File

@ -1,9 +1,28 @@
MIT License MIT4H
Copyright (c) 2025 lelanthran Copyright (c) 2025 Lelanthran Manickum
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: 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. Additional restriction:
The Software, including any part thereof, shall not be used, in whole or in
part, for the purpose of training machine learning or artificial intelligence
models, whether commercial, research, or otherwise. This includes, but is not
limited to, large language models, computer vision systems, and other
data-driven model architectures.
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. 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.

View File

@ -1,2 +1,83 @@
# Zjs # ZeroJS
# Overview
Welcome to Zjs, an exciting collection of lovingly crafted web components
carelessly extracted from my proprietary codebase and hurled at an
unsuspecting public.
Zjs stands for *"ZeroJS"*, which doesnt mean *"no JavaScript"* (that would be
silly), but rather *"Just the necessary JS so you can avoid duct-taping React
to your website just to show a modal"*.
This is not a framework. There is no CLI. There is no NPM command. You dont
need to install 12 packages and a plugin just to say "hello". You can't do
that anyway even if you wanted to; there's no build step to spend billable
hours on.
You include a script and it works. It's wild, I know.
Currently, this repo contains exactly one thing: ZjsComponent. Youll find it
in its own folder, with its own README. That README has the real
documentation. This one is just for vibes.
## Philosophy
I like my deliverables like I like my cars: small, fast and easy to work on.
Zjs is for me. I want to write HTML and sprinkle in functionality without
loading the entire front-end industrial complex. I write tags, the components
do their thing and I get to spend time with my kids.
If you identify with the above self-description of my goals, then you'd
probably want to read the individual READMEs for each web component in here.
I'd advise moving on to a different library if your life is incomplete without
`$FRAMEWORK`, or your identity as a web developer is tied to NPM, or if you
are allergic to self-contained, easily debugged and above all **tiny** code
packages.
## Installing
Clone it like its 2009:
git clone https://github.com/lelanthran/Zjs.git
Then copy what you need and use it however you like. No bundling. No
compiling. No YAML. No weirdness. Just HTML and a `<script>` tag.
## Contributing
The contribution rules are possibly the easiest you've ever seen: **Just
Don't!**
Why? Because the restrictions for contributors are overwhelmingly onerous and
anyone willing to run the gauntlet below belong to such a small subset of
humanity they should really be skeptical of their own identity as a
non-machine.
#### Contributor Restrictions
*I* **WILL NOT** *accept anything* (Logical `OR` The following items):
- ... That requires NPM, Python or some other non-ubiquitous runtime.
- ... With a dependency.
- ... That requires a build-step.
- ... That can't be used from direct HTML.
- ... Without a nice visual test page.
- ... That has nothing to do with the code (one would think that this one is
obvious, but then one would be in for a surprise).
*I* **WILL** *accept* (Logical `AND` the following items):
- ... Web Components prefixed with `Zjs`/`zjs-`,
- ... That have no build-step,
- ... That have no runtime dependencies other than the browser and Javascript,
- ... That solve an widespread problem.
At some point I'll add in some way to automate the testing a little; it's
doubtful that the testing process will remain dependency-free, but we'll see.
## License
MIT. This means that when it breaks you get to keep *all* the pieces.
Good luck.