@meteo28093/equinox-ui 0.0.1

package/LICENCE.md

@@ -0,0 +1,99 @@
+# Equinox UI Commons License
+
+Copyright (c) meteo28093
+
+This software is licensed under a [Fair-Code license](https://faircode.io). By using the software, you agree 
+to all of the terms and conditions below.
+
+For all third party components incorporated into the Software, those components are licensed under the 
+original license provided by the owner of the applicable component.
+
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license
+to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+
+## Limitations
+
+1. You may use or modify the software only for your own internal business purposes or for non-commercial or
+   personal use. 
+
+2. You may distribute the software or provide it to others only if you do so free of charge for
+   non-commercial purposes. 
+
+3. You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the
+   software. Any use of the licensor's trademarks is subject to applicable law.
+
+
+## Disallowed Uses
+
+The software maybe not be used for the following purposes:
+
+1. Projects that contain misinformation, hate speech or discriminating content based on age, gender, gender 
+   identity, race, sexuality, religion, nationality, serious illnesses or disabilities, no matter who authored 
+   this content. Misinformation is defined as content that is false or misleading and may lead to significant 
+   risk of physical or societal harm.
+
+2. Use by companies or individuals who:
+	- lobby for, promote, derive a majority of income from, or are significantly invested in:
+		+ the production of tobacco or weapons,
+		+ any prison or jail operated for profit,
+		+ any action or facility that supports or contributes to gambling, adversely addictive behaviors, 
+			or deforestation.
+	- lobby against or derive a majority of income from actions that discourage or frustrate:
+		+ peace,
+		+ access to the rights set out in the Universal Declaration of Human Rights and the 
+			Convention on the Rights of the Child,
+		+ peaceful assembly and association (including worker associations),
+		+ a safe environment or action to curtail the use of fossil fuels or to prevent climate change or
+		+ democratic processes.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these
+terms. If you modify the software, you must include in any modified copies of the software a prominent notice
+stating that you have modified the software.
+
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in these terms.
+
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed, and your license will
+automatically terminate. If the licensor provides you with a notice of your violation, and you cease all
+violation of this license no later than 30 days after you receive that notice, your license will be reinstated
+retroactively. However, if you violate these terms after such reinstatement, any additional violation of these
+terms will cause your license to terminate automatically and permanently.
+
+
+## No Liability
+
+As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will
+not be liable to you for any damages arising out of these terms or the use or nature of the software, under
+any kind of legal claim.
+
+
+## Definitions
+
+The "licensor" is the entity offering these terms.
+
+The "software" is the software the licensor makes available under these terms, including any portion of it.
+
+"You" refers to the individual or entity agreeing to these terms.
+
+"Your company" is any legal entity, sole proprietorship, or other kind of organization that you work for, plus
+all organizations that have control over, are under the control of, or are under common control with that
+organization. Control means ownership of substantially all the assets of an entity, or the power to direct its
+management and policies by vote, contract, or otherwise. Control can be direct or indirect.
+
+"Your license" is the license granted to you for the software under these terms.
+
+"Use" means anything you do with the software requiring your license.
+
+"Trademark" means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,92 @@
+# Equinox UI
+
+Equinox UI is a no-build web component library for blogs and small web projects.
+
+## Scope and acceptance criteria
+
+### Classless CSS compatibility
+
+Components stay readable and usable in all of:
+
+- No CSS framework (browser defaults + component fallbacks)
+- Water.css
+- Pico.css
+- Sakura.css
+
+You can use the bundled `equinox.css`
+
+## Use with a CDN
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/equinox-ui@<version>/dist/equinox-ui.global.js"></script>
+```
+
+This registers components globally.
+
+## Use with classless CSS frameworks
+
+Example (Pico.css):
+
+```html
+<link
+  rel="stylesheet"
+  href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css"
+/>
+<script type="module">
+  import "https://cdn.jsdelivr.net/npm/equinox-ui@1.0.0/dist/equinox-ui.esm.js";
+</script>
+```
+
+Example (Water.css):
+
+```html
+<link
+  rel="stylesheet"
+  href="https://cdn.jsdelivr.net/npm/water.css@2/out/water.css"
+/>
+```
+
+## Use without any CSS framework
+
+No additional CSS is required. Components include fallback tokens so they remain readable out of the box.
+
+## Component capabilities
+
+- `ee-nav` - Navigation component with mobile menu
+- `ee-code-block` - Syntax-highlighted code display
+- `ee-lorem-ipsum` - Lorem Ipsum generator
+- `ee-card` - Content card component
+- `ee-bar-chart`, `ee-line-chart`, `ee-sparkline`, `ee-gauge` - Data visualization
+- `ee-faq-accordion` - FAQ accordion
+- `ee-slide-show` - Image carousel
+- `ee-repl` - In-browser HTML/CSS/JS REPL
+- And many more
+
+A demo is here: [https://equinox-ui.up.railway.app](https://equinox-ui.up.railway.app)
+
+## macOS status bar preview
+
+This repo includes a local macOS status bar helper for showing components in the menu bar. This is not included in the NPM package and CDN.
+
+Launch format:
+
+```bash
+node statusbar.js <component-tag> '<params-json>' --icon <icon-spec>
+```
+
+Examples:
+
+```bash
+node test.js ee-moon-card '{"city": "Berlin"}' --icon lucide:moon-star
+node test.js ee-geo-storm '{}' --icon lucide:cloud-lightning
+```
+
+Notes:
+
+- `<component-tag>` must match a file in `src/components`, for example `ee-card` or `ee-geo-storm`.
+- `<params-json>` is optional and must be a JSON object. Values are applied to the element as attributes and properties before it mounts.
+- `--icon` is optional. `lucide:<name>` uses a Lucide icon from `src/vendor/lucide.js`. `sf:<name>` uses an Apple SF Symbol.
+- Only one live helper is kept per component tag. Launching `ee-zodiac` again replaces the existing `ee-zodiac` helper, but `ee-zodiac` and `ee-card` can run at the same time.
+- The popover includes a `Quit` button that closes that helper instance.
+
+The helper compiles `mac/StatusBarApp.swift`, serves `mac/StatusPopover.html` over `http://127.0.0.1`, and loads the selected component into a `WKWebView`.